@kud/soap-cli 1.0.0 → 3.0.0

package/README.md

@@ -1,53 +1,152 @@
-# Soap 🧼 - An app cleaner cli for macOS
+# soap 🧼
 
-> I was so lazy to use any GUI to clean my macOS. - @kud
+> _"I was so lazy to use any GUI to clean my macOS."_ — @kud
 
-A simple command in your shell to remove the application you want to delete and the related files as well (like preferences, logs, `.dmg`, cask formula).
+A macOS CLI that removes an app **and all its leftover files** — preferences, caches, containers, launch agents, and more.
 
-## Motivation
+Inspired by [AppCleaner](https://freemacsoft.net/appcleaner/) and [App Eraser](https://github.com/davunt/app-eraser), but open-source and terminal-native.
 
-I used to use AppCleaner and [App Eraser](https://github.com/davunt/app-eraser) but the first one is not open source (and could have trackers) and the second one is not a CLI but a GUI. Here comes _soap_.
+---
 
 ## Install
 
-```shell
+```sh
 npm install -g @kud/soap-cli
 ```
 
+Or via Homebrew:
+
+```sh
+brew install kud/tap/soap-cli
+```
+
+---
+
 ## Usage
 
-You've got two ways to uninstall an application, via its path or via its cask name.
+```
+soap <cask-name>        Clean an app installed via Homebrew cask
+soap <path-to-app>      Clean a manually installed app
+soap --help             Show this help
+```
 
-#### Application path
+**Examples:**
 
-```shell
-soap <app-path>
-# ex: soap '/Applications/Android Studio.app'
+```sh
+soap spotify
+soap android-studio
+soap '/Applications/Android Studio.app'
 ```
 
-_warning: it won't remove the cask formula even if you've installed the app via homebrew._
+---
+
+## What it does
 
-#### Cask name
+### Cask mode — `soap spotify`
+
+1. Resolves the `.app` name from `brew info`
+2. Scans ~40 macOS directories for files matching the app name or bundle identifier
+3. Fetches the cask's [zap stanza](https://docs.brew.sh/Cask-Cookbook#stanza-zap) — the maintainer-curated list of known leftover files
+4. Presents a checkbox list of everything found (all pre-selected)
+5. Moves selected files to **Trash** (recoverable from `~/.Trash`)
+6. Optionally runs `brew uninstall --zap` to unregister the cask from Homebrew
+
+### Path mode — `soap '/Applications/Spotify.app'`
+
+Same as above, but skips the Homebrew step. Use this for apps installed manually from a DMG.
+
+---
+
+## Example output
 
-```shell
-soap <cask-name>
-# ex: soap android-studio
 ```
+Welcome to soap 🧼, the app cleaner.
+
+⠋ Fetching cask info…
+⠋ Scanning for files…
+
+ℹ Cleaning: Spotify
+ℹ Mode: cask (spotify)
 
-It will delete for instance this kind of files:
+? Found 11 files. Select what to move to Trash:
+ ◉ /Users/kud/Library/Application Support/Spotify
+ ◉ /Users/kud/Library/Caches/com.spotify.client
+ ◉ /Users/kud/Library/Preferences/com.spotify.client.plist
+ ◉ /Users/kud/Library/Saved Application State/com.spotify.client.savedState
+ ◉ /Users/kud/Library/Logs/Spotify
+ ◉ ...
 
+? Run `brew uninstall --zap spotify`? Yes
+
+✔ Moved 11 file(s) to Trash.
+
+◼ Running Homebrew uninstall…
+✔ Done.
+```
+
+---
+
+## Locations scanned
+
+`soap` scans these directories, plus `<vendor>/` subdirectories derived from the bundle ID:
+
+| Location                            | What's typically there          |
+| ----------------------------------- | ------------------------------- |
+| `/Applications`                     | The app bundle                  |
+| `~/Library/Application Support`     | App data                        |
+| `~/Library/Caches`                  | Cached data                     |
+| `~/Library/Containers`              | Sandboxed app data              |
+| `~/Library/Preferences`             | `.plist` config files           |
+| `~/Library/Logs`                    | App logs                        |
+| `~/Library/LaunchAgents`            | Per-user background services    |
+| `/Library/LaunchDaemons`            | System-wide background services |
+| `~/Library/HTTPStorages`            | HTTP caches                     |
+| `~/Library/Group Containers`        | Shared app-group data           |
+| `~/Library/Saved Application State` | Window state (`.savedState`)    |
+| `~/Library/WebKit`                  | WebKit storage                  |
+| `/private/var/db/receipts`          | Package receipts                |
+| `/Library/Logs/DiagnosticReports`   | Crash reports                   |
+| `/Library/Audio/Plug-Ins/HAL`       | Audio drivers                   |
+| `~/Downloads`                       | Leftover `.dmg` files           |
+
+---
+
+## Debug mode
+
+```sh
+SOAP_DEBUG=1 soap spotify
 ```
-/Applications/Android Studio.app
-/Users/kud/Downloads/android-studio-ide-182.5314842-mac.dmg
-/Users/kud/Library/Preferences/com.google.android.studio.plist
-/Users/kud/Library/Saved Application State/com.google.android.studio.savedState
-/Users/kud/Library/Application Support/google/AndroidStudio4.2
-/Users/kud/Library/Caches/google/AndroidStudio4.2
-/Users/kud/Library/Logs/google/AndroidStudio4.2
+
+Enables verbose shell output — shows every subprocess command that runs.
+
+---
+
+## Safety
+
+- Files are **moved to Trash**, not permanently deleted.
+- You get a full checkbox list before anything is removed — deselect anything you want to keep.
+- The Homebrew uninstall is a separate confirmation step.
+- The force-uninstall fallback (for already-removed apps still registered in Homebrew) defaults to **No**.
+
+---
+
+## Contributing
+
+Built with TypeScript + ESM. Requires Node 20+.
+
+```sh
+git clone https://github.com/kud/soap-cli.git
+cd soap-cli
+npm install
+
+npm run dev        # run from source via tsx
+npm run build      # compile to dist/
+npm run typecheck  # type-check without emitting
+npm test           # vitest unit tests
 ```
 
-No worries, soap will move them into your Trash, so if something wrong has happened, you can check there your files.
+---
 
 ## Credits
 
-Inspired from [App Eraser](https://github.com/davunt/app-eraser)
+Inspired by [App Eraser](https://github.com/davunt/app-eraser) and [AppCleaner](https://freemacsoft.net/appcleaner/).

package/dist/index.js

@@ -0,0 +1,381 @@
+#!/usr/bin/env node
+
+// index.ts
+import inquirer from "inquirer";
+import signale from "signale";
+import trash from "trash";
+import chalk from "chalk";
+import { $ as $2, spinner } from "zx";
+
+// lib/index.ts
+import { $ } from "zx";
+import { execSync } from "child_process";
+import fs from "fs/promises";
+import { homedir as homedir2 } from "os";
+
+// lib/path-locations.ts
+import { homedir } from "os";
+var pathLocations = [
+  "/Applications",
+  "/private/var/db/receipts",
+  "/Library/LaunchDaemons",
+  `${homedir()}/Downloads`,
+  `${homedir()}/Library`,
+  `${homedir()}/Library/Application Support`,
+  `${homedir()}/Library/Application Scripts`,
+  `${homedir()}/Library/Application Support/CrashReporter`,
+  `${homedir()}/Library/Containers`,
+  `${homedir()}/Library/Caches`,
+  `${homedir()}/Library/HTTPStorages`,
+  `${homedir()}/Library/Group Containers`,
+  `${homedir()}/Library/Internet Plug-Ins`,
+  `${homedir()}/Library/LaunchAgents`,
+  `${homedir()}/Library/Logs`,
+  "/Library/Logs/DiagnosticReports",
+  `${homedir()}/Library/Preferences`,
+  `${homedir()}/Library/Preferences/ByHost`,
+  `${homedir()}/Library/Saved Application State`,
+  `${homedir()}/Library/WebKit`,
+  `${homedir()}/Library/Caches/com.apple.helpd/Generated`,
+  "/Library/Audio/Plug-Ins/HAL"
+];
+var commonSuffix = ["install"];
+
+// lib/file-regex.ts
+var uuidReg = /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/g;
+var dateReg = /[0-9]{4}-[0-9]{2}-[0-9]{2}-[0-9]{6}/g;
+var diagReg = /.[a-zA-Z]+_resource.diag/;
+var commonExtensions = [
+  ".dmg",
+  ".app",
+  ".bom",
+  ".plist",
+  ".XPCHelper",
+  ".beta",
+  ".extensions",
+  ".savedState",
+  ".driver",
+  ".wakeups_resource",
+  ".diag"
+];
+var fileRegex = [
+  uuidReg,
+  dateReg,
+  diagReg,
+  ...commonExtensions
+];
+
+// lib/index.ts
+$.verbose = false;
+var scoreThreshold = 0.4;
+var compNameGlob = "";
+var stripString = (file) => {
+  let transformedString = file;
+  fileRegex.forEach((regex1) => {
+    transformedString = transformedString.replace(regex1, "");
+  });
+  const normCompName = normalizeString(compNameGlob, "-").replace(/\u2019/g, "").replace(/\(/g, "").replace(/\)/g, "");
+  transformedString = transformedString.replace(normCompName, "");
+  return transformedString;
+};
+var normalizeString = (str, spacer = "") => str.toLowerCase().replace(/ /g, spacer);
+var getFilePatternArray = async (appName, bundleId) => {
+  const nameVariations = createNameVariations(appName, bundleId);
+  const appNameNorm = normalizeString(appName);
+  const bundleIdNorm = normalizeString(bundleId);
+  let patternArray = [...nameVariations];
+  const appNameComponents = appNameNorm.split(".");
+  if (appNameComponents) patternArray.push(appNameComponents[0]);
+  const bundleIdComponents = bundleIdNorm.split(".");
+  if (bundleIdComponents.length > 2 && bundleIdComponents[bundleIdComponents.length - 1].toLowerCase() === "app") {
+    patternArray.push(
+      `${bundleIdComponents.slice(0, bundleIdComponents.length - 1).join(".")}`
+    );
+  }
+  const appWithSuffix = /* @__PURE__ */ new Set([]);
+  commonSuffix.forEach(
+    (suffix) => nameVariations.forEach(
+      (nameVariation) => appWithSuffix.add(`${nameVariation}${suffix}`)
+    )
+  );
+  patternArray = [...patternArray, ...appWithSuffix];
+  return patternArray;
+};
+var isPatternInFile = (patterns, fileToCheck) => {
+  return patterns.find((filePatten) => {
+    if (typeof filePatten !== "string") return false;
+    if (fileToCheck.includes(filePatten)) {
+      const strippedFile = stripString(fileToCheck);
+      let score = 0;
+      const indexOfString = strippedFile.indexOf(filePatten);
+      for (let i = 0; i < strippedFile.length; i += 1) {
+        if (i === indexOfString) {
+          i += indexOfString + filePatten.length;
+          score += filePatten.length;
+        }
+        if (strippedFile[parseInt(i.toString(), 10)] === ".") score += 0.5;
+        if (strippedFile[parseInt(i.toString(), 10)] === "_") score += 0.5;
+      }
+      if (score / strippedFile.length > scoreThreshold) {
+        return true;
+      }
+      return false;
+    }
+    return false;
+  });
+};
+var createNameVariations = (appName, bundleId) => {
+  const appNameNorm = appName.toLowerCase().replace(/ /g, "");
+  const appNameWithoutDot = appNameNorm.replace(/\./g, "");
+  const appNameUnderscore = appName.toLowerCase().replace(/ /g, "_");
+  const appNameDash = appName.toLowerCase().replace(/ /g, "-");
+  const appNameDot = appName.toLowerCase().replace(/ /g, ".");
+  const bundleIdNorm = bundleId.toLowerCase().replace(/ /g, "");
+  return [
+    appNameNorm,
+    appNameWithoutDot,
+    appNameUnderscore,
+    appNameDash,
+    appNameDot,
+    bundleIdNorm
+  ];
+};
+var appNameFromPath = (appPath) => {
+  const pathArr = appPath.split("/");
+  const appNameWithExt = pathArr[pathArr.length - 1];
+  return appNameWithExt.replace(".app", "");
+};
+var fetchCaskData = async (caskName) => {
+  const { stdout: info } = await $`brew info ${caskName} --json=v2`;
+  const caskData = JSON.parse(info).casks?.[0];
+  if (!caskData) throw new Error(`Cask "${caskName}" not found.`);
+  return caskData;
+};
+var resolveZapPaths = async (caskData) => {
+  const zapPaths = caskData.artifacts.filter((a) => a.zap).flatMap((a) => a.zap).filter((entry) => entry?.trash).flatMap((entry) => entry?.trash ?? []).map((p) => p.replace(/^~/, homedir2()));
+  const resolved = await Promise.all(
+    zapPaths.map(async (p) => {
+      if (p.includes("*")) {
+        const matches = [];
+        for await (const f of fs.glob(p)) matches.push(f);
+        return matches;
+      }
+      try {
+        await fs.access(p);
+        return [p];
+      } catch {
+        return [];
+      }
+    })
+  );
+  return resolved.flat();
+};
+var getCaskInfo = async (caskName) => {
+  try {
+    const caskData = await fetchCaskData(caskName);
+    let appName = null;
+    for (const artifact of caskData.artifacts) {
+      if (artifact.app) {
+        appName = artifact.app[0];
+        break;
+      }
+    }
+    const zapFiles = await resolveZapPaths(caskData);
+    return { appName, zapFiles };
+  } catch (error) {
+    throw new Error(
+      `Failed to get cask info for "${caskName}": ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+};
+var getComputerName = () => {
+  return execSync("scutil --get ComputerName").toString().trimEnd();
+};
+var getBundleIdentifier = async (appName) => {
+  try {
+    const bundleId = execSync(
+      `osascript -e 'id of app "${appName}"'`
+    ).toString();
+    return bundleId.trimEnd();
+  } catch {
+    throw new Error(
+      `Could not find bundle identifier for "${appName}". Is the app installed?`
+    );
+  }
+};
+var findAppFiles = async (appName, bundleId) => {
+  try {
+    compNameGlob = getComputerName();
+    const bundleIdComponents = bundleId.split(".");
+    const companyDirs = pathLocations.map(
+      (pathLocation) => `${pathLocation}/${bundleIdComponents[1]}`
+    );
+    const pathsToSearch = [...pathLocations, ...companyDirs];
+    const directoryFilesPromiseArr = pathsToSearch.map(
+      (pathLocation) => fs.readdir(pathLocation)
+    );
+    const directoryFiles = await Promise.allSettled(directoryFilesPromiseArr);
+    const patternArray = await getFilePatternArray(appName, bundleId);
+    const filesToRemove = /* @__PURE__ */ new Set([]);
+    directoryFiles.forEach((dir, index) => {
+      if (dir.status === "fulfilled") {
+        dir.value.forEach((dirFile) => {
+          const dirFileNorm = dirFile.toLowerCase().replace(/ /g, "");
+          if (isPatternInFile(patternArray, dirFileNorm)) {
+            filesToRemove.add(
+              `${pathsToSearch[parseInt(index.toString(), 10)]}/${dirFile}`
+            );
+          }
+        });
+      }
+    });
+    return [...filesToRemove];
+  } catch (err) {
+    console.error(err);
+    throw err;
+  }
+};
+
+// index.ts
+$2.verbose = process.env.SOAP_DEBUG === "1";
+var [param] = process.argv.slice(2);
+var isFlag = param?.startsWith("-");
+if (!param || param === "--help" || param === "-h" || param === "--version" || param === "-v" || isFlag && param !== "--help" && param !== "-h") {
+  if (param === "--version" || param === "-v") {
+    const { createRequire } = await import("module");
+    const require2 = createRequire(import.meta.url);
+    const { version } = require2("./package.json");
+    console.log(`soap v${version}`);
+    process.exit(0);
+  }
+  if (param === "--help" || param === "-h") {
+    console.log(`
+  ${chalk.bold("soap")} \u{1F9FC}  ${chalk.italic("the app cleaner")}
+
+  ${chalk.bold("Usage:")}
+    soap ${chalk.cyan("<cask-name>")} | ${chalk.cyan("<path-to-app>")}
+
+  ${chalk.bold("Examples:")}
+    soap ${chalk.green("spotify")}               Uninstall Spotify (cask) + all its leftover files
+    soap ${chalk.green("android-studio")}        Uninstall Android Studio (cask)
+    soap ${chalk.green("/Applications/Slack.app")}
+                               Uninstall Slack by path (no brew step)
+
+  ${chalk.bold("What it removes:")}
+    ${chalk.dim("\xB7")} The .app bundle ${chalk.dim("(via brew uninstall --zap or manual selection)")}
+    ${chalk.dim("\xB7")} Preferences  ${chalk.dim("~/Library/Preferences/com.<vendor>.<app>.plist")}
+    ${chalk.dim("\xB7")} Caches       ${chalk.dim("~/Library/Caches/com.<vendor>.<app>")}
+    ${chalk.dim("\xB7")} App support  ${chalk.dim("~/Library/Application Support/<App>")}
+    ${chalk.dim("\xB7")} Containers   ${chalk.dim("~/Library/Containers/com.<vendor>.<app>")}
+    ${chalk.dim("\xB7")} Launch agents, logs, crash reports, DMG files, and more
+
+  ${chalk.bold("Environment:")}
+    ${chalk.yellow("SOAP_DEBUG=1")}               Enable verbose shell output
+    `);
+    process.exit(0);
+  }
+  if (isFlag) {
+    console.error(
+      chalk.red(`Unknown option: ${param}. Run \`soap --help\` for usage.`)
+    );
+  } else {
+    console.error(
+      chalk.red("No parameter specified. Run `soap --help` for usage.")
+    );
+  }
+  process.exit(1);
+}
+var isCask = !param.includes(".app");
+console.log(
+  `
+Welcome to ${chalk.bold("soap")} \u{1F9FC}, ${chalk.italic("the app cleaner")}.
+`
+);
+try {
+  const { appName, zapFiles } = isCask ? await spinner(chalk.dim("Fetching cask info\u2026"), () => getCaskInfo(param)) : { appName: appNameFromPath(param), zapFiles: [] };
+  if (!appName) {
+    signale.error(`Could not determine app name for "${param}".`);
+    process.exit(1);
+  }
+  const bundleId = await getBundleIdentifier(appName);
+  const scannedFiles = await spinner(
+    chalk.dim("Scanning for files\u2026"),
+    () => findAppFiles(appName, bundleId)
+  );
+  const appFiles = [
+    .../* @__PURE__ */ new Set([
+      ...isCask ? scannedFiles.slice(1) : scannedFiles,
+      ...zapFiles
+    ])
+  ];
+  const isAppFilesEmpty = appFiles.length === 0;
+  signale.info(`Cleaning: ${chalk.bold(appName)}`);
+  signale.info(
+    isCask ? `Mode: ${chalk.bold("cask")} (${param})` : `Mode: ${chalk.bold("path")} \u2014 no Homebrew uninstall will run`
+  );
+  console.log("");
+  const { deletedFilesWish, deletedCaskWish } = await inquirer.prompt([
+    {
+      type: "checkbox",
+      name: "deletedFilesWish",
+      when: !isAppFilesEmpty,
+      message: `Found ${chalk.bold(appFiles.length)} files. Select what to move to Trash:`,
+      choices: appFiles.map((appFile) => ({
+        name: appFile,
+        value: appFile,
+        checked: true
+      }))
+    },
+    {
+      type: "confirm",
+      when: isCask,
+      name: "deletedCaskWish",
+      message: `Run ${chalk.bold(`brew uninstall --zap ${param}`)}?`,
+      default: true
+    }
+  ]);
+  if (!isAppFilesEmpty && deletedFilesWish && deletedFilesWish.length > 0) {
+    await trash(deletedFilesWish);
+    console.log("");
+    signale.success(
+      `Moved ${chalk.bold(deletedFilesWish.length)} file(s) to Trash:`
+    );
+    deletedFilesWish.forEach(
+      (p) => console.log(`  ${chalk.dim("\xB7")} ${chalk.dim(p)}`)
+    );
+  } else if (!isAppFilesEmpty) {
+    signale.info("No files selected \u2014 nothing moved to Trash.");
+  }
+  if (isCask && deletedCaskWish) {
+    console.log("");
+    signale.pending("Running Homebrew uninstall\u2026");
+    await $2`brew uninstall --zap ${param}`;
+  }
+  console.log("");
+  signale.success("Done.");
+} catch (error) {
+  console.log("");
+  signale.error(
+    error instanceof Error ? error.message : "An unexpected error occurred."
+  );
+  if (process.env.SOAP_DEBUG === "1") {
+    console.error(error);
+  }
+  if (isCask) {
+    const { forceUninstall } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "forceUninstall",
+        message: `The app may already be removed but the cask is still registered.
+Force-run ${chalk.bold(`brew uninstall --zap --force ${param}`)}?`,
+        default: false
+      }
+    ]);
+    if (forceUninstall) {
+      console.log("");
+      signale.pending("Force-uninstalling cask\u2026");
+      await $2`brew uninstall --zap --force ${param}`;
+      signale.success("Force uninstall complete.");
+    }
+  }
+}

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "@kud/soap-cli",
-  "version": "1.0.0",
+  "version": "3.0.0",
   "description": "An app cleaner cli for macOS",
-  "main": "index.js",
+  "main": "dist/index.js",
   "bin": {
-    "soap": "index.js"
-  },
-  "directories": {
-    "lib": "lib"
+    "soap": "dist/index.js"
   },
   "scripts": {
-    "dev": "node ./index.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "dev": "tsx index.ts",
+    "build": "tsup",
+    "postbuild": "chmod +x dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",
@@ -25,13 +27,24 @@
   },
   "homepage": "https://github.com/kud/soap-cli#readme",
   "type": "module",
+  "files": [
+    "dist"
+  ],
   "dependencies": {
-    "@kud/soap-cli": "1.0.0-5",
-    "chalk": "5.3.0",
-    "del": "7.1.0",
-    "inquirer": "9.2.23",
+    "@kud/soap-cli": "1.0.0",
+    "chalk": "5.6.2",
+    "del": "8.0.1",
+    "inquirer": "13.3.2",
     "signale": "1.4.0",
-    "trash": "8.1.1",
-    "zx": "8.1.3"
+    "trash": "10.1.1",
+    "zx": "8.8.5"
+  },
+  "devDependencies": {
+    "@types/node": "25.5.0",
+    "@types/signale": "1.4.7",
+    "tsup": "8.5.1",
+    "tsx": "4.21.0",
+    "typescript": "6.0.2",
+    "vitest": "4.1.2"
   }
 }

package/index.js

@@ -1,120 +0,0 @@
-#!/usr/bin/env node
-import inquirer from "inquirer"
-import signale from "signale"
-import trash from "trash"
-import chalk from "chalk"
-import { $ } from "zx/core"
-
-import {
-  appNameFromPath,
-  appNameFromCaskName,
-  getBundleIdentifier,
-  findAppFiles,
-} from "./lib/index.js"
-
-$.verbose = false // true for debugging
-
-const [param] = process.argv.slice(2)
-
-if (!param) {
-  console.error(`No parameter specified.`)
-
-  process.exit(0)
-}
-
-const isCask = !param.includes(".app")
-
-console.log(
-  `Welcome to ${chalk.bold("soap")} 🧼, ${chalk.italic("the app cleaner")}.\n`,
-)
-
-try {
-  const appName = isCask
-    ? await appNameFromCaskName(param)
-    : appNameFromPath(param)
-
-  const bundleId = await getBundleIdentifier(appName)
-  const _appFiles = await findAppFiles(appName, bundleId)
-  const appFiles = isCask ? _appFiles.slice(1) : _appFiles
-  const isAppFilesEmpty = appFiles.length === 0
-
-  signale.info(
-    `You want me to clean this application: ${chalk.bold(appName)} 📦.`,
-  )
-
-  signale.info(
-    isCask
-      ? `I also assume ${chalk.bold("you gave me a cask name")}.`
-      : `I also assume you gave me an application path. ${chalk.bold(
-          "No homebrew cask will be deleted then",
-        )}.`,
-  )
-
-  console.log("")
-
-  const { deletedFilesWish } = await inquirer.prompt([
-    {
-      type: "checkbox",
-      name: "deletedFilesWish",
-      when: !isAppFilesEmpty,
-      message:
-        "This is what I've found about it. Please select the files you want to delete.",
-      choices: appFiles.map((appFile) => ({
-        name: appFile,
-        value: appFile,
-        checked: true,
-      })),
-    },
-    {
-      type: "confirm",
-      when: isCask,
-      name: "deletedCaskWish",
-      message: `Do you want to uninstall "${param}" via homebrew?`,
-    },
-  ])
-
-  if (!isAppFilesEmpty) {
-    await trash(deletedFilesWish, { force: true })
-
-    console.log("")
-
-    console.log("Files deleted:")
-    deletedFilesWish.forEach((deletedPath) => console.log(`· ${deletedPath}`))
-  }
-
-  if (isCask) {
-    console.log("")
-
-    signale.pending(`Starting cask uninstallation.`)
-
-    await $`brew uninstall ${param}`
-  }
-
-  console.log("")
-
-  signale.success("Operation successful.")
-} catch (error) {
-  signale.error(`Something wrong appeared. Check the log below.\n`)
-  console.error(error)
-  console.error("")
-
-  if (isCask) {
-    inquirer
-      .prompt([
-        {
-          type: "confirm",
-          name: "forceUninstall",
-          message:
-            "An error occurred. It could happen when the app file no longer exists, but the cask is still present in Homebrew.\nWould you like to forcefully uninstall the cask by running `brew uninstall`?",
-        },
-      ])
-      .then(async (answers) => {
-        if (answers.forceUninstall) {
-          console.error("")
-          signale.pending(`Forcefully uninstalling cask.`)
-          await $`brew uninstall --force ${param}`
-          signale.success("Force uninstallation successful.")
-        }
-      })
-  }
-}

package/lib/file-regex.js

@@ -1,22 +0,0 @@
-const uuidReg =
-  /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/g
-
-const dateReg = /[0-9]{4}-[0-9]{2}-[0-9]{2}-[0-9]{6}/g
-
-const diagReg = /.[a-zA-Z]+_resource.diag/
-
-const commonExtensions = [
-  ".dmg",
-  ".app",
-  ".bom",
-  ".plist",
-  ".XPCHelper",
-  ".beta",
-  ".extensions",
-  ".savedState",
-  ".driver",
-  ".wakeups_resource",
-  ".diag",
-]
-
-export const fileRegex = [uuidReg, dateReg, diagReg, ...commonExtensions]

package/lib/index.js

@@ -1,191 +0,0 @@
-import { $ } from "zx"
-$.verbose = false
-
-import { execSync } from "child_process"
-import fs from "fs/promises"
-import { pathLocations, commonSuffix } from "./path-locations.js"
-import { fileRegex } from "./file-regex.js"
-
-const scoreThreshold = 0.4
-
-let compNameGlob
-
-function stripString(file) {
-  let transformedString = file
-  fileRegex.forEach((regex1) => {
-    transformedString = transformedString.replace(regex1, "")
-  })
-
-  const normCompName = normalizeString(compNameGlob, "-")
-    .replace(/\u2019/g, "")
-    .replace(/\(/g, "")
-    .replace(/\)/g, "")
-
-  transformedString = transformedString.replace(normCompName, "")
-
-  return transformedString
-}
-
-const normalizeString = (str, spacer = "") =>
-  str.toLowerCase().replace(/ /g, spacer)
-
-async function getFilePatternArray(appName, bundleId) {
-  const nameVariations = createNameVariations(appName, bundleId)
-  const appNameNorm = normalizeString(appName)
-  const bundleIdNorm = normalizeString(bundleId)
-
-  let patternArray = [...nameVariations]
-
-  const appNameComponents = appNameNorm.split(".")
-  if (appNameComponents) patternArray.push(appNameComponents[0])
-
-  const bundleIdComponents = bundleIdNorm.split(".")
-  if (
-    bundleIdComponents.length > 2 &&
-    bundleIdComponents[bundleIdComponents.length - 1].toLowerCase() === "app"
-  ) {
-    patternArray.push(
-      `${bundleIdComponents.slice(0, bundleIdComponents.length - 1).join(".")}`,
-    )
-  }
-
-  const appWithSuffix = new Set([])
-  commonSuffix.forEach((suffix) =>
-    nameVariations.forEach((nameVariation) =>
-      appWithSuffix.add(`${nameVariation}${suffix}`),
-    ),
-  )
-
-  patternArray = [...patternArray, [...appWithSuffix]]
-
-  return patternArray
-}
-
-function isPatternInFile(patterns, fileToCheck) {
-  return patterns.find((filePatten) => {
-    if (fileToCheck.includes(filePatten)) {
-      const strippedFile = stripString(fileToCheck)
-
-      let score = 0
-      const indexOfString = strippedFile.indexOf(filePatten)
-      for (let i = 0; i < strippedFile.length; i += 1) {
-        if (i === indexOfString) {
-          i += indexOfString + filePatten.length
-          score += filePatten.length
-        }
-        if (strippedFile[parseInt(i, 10)] === ".") score += 0.5
-        if (strippedFile[parseInt(i, 10)] === "_") score += 0.5
-      }
-      if (score / strippedFile.length > scoreThreshold) {
-        return true
-      }
-      return false
-    }
-    return false
-  })
-}
-
-function createNameVariations(appName, bundleId) {
-  const appNameNorm = appName.toLowerCase().replace(" ", "")
-  const appNameWithoutDot = appNameNorm.toLowerCase().replace(".", "")
-  const appNameUnderscore = appName.toLowerCase().replace(" ", "_")
-  const appNameDash = appName.toLowerCase().replace(" ", "-")
-  const appNameDot = appName.toLowerCase().replace(" ", ".")
-
-  const bundleIdNorm = bundleId.toLowerCase().replace(" ", "")
-
-  return [
-    appNameNorm,
-    appNameWithoutDot,
-    appNameUnderscore,
-    appNameDash,
-    appNameDot,
-    bundleIdNorm,
-  ]
-}
-
-function appNameFromPath(appPath) {
-  const pathArr = appPath.split("/")
-  const appNameWithExt = pathArr[pathArr.length - 1]
-  // remove .app extension
-  return appNameWithExt.replace(".app", "")
-}
-
-export const appNameFromCaskName = async (caskName) => {
-  try {
-    const { stdout: info } = await $`brew info ${caskName} --json=v2`
-    const caskData = JSON.parse(info).casks?.[0]
-
-    if (!caskData) {
-      throw new Error("Cask data not available.")
-    }
-
-    for (const artifact of caskData.artifacts) {
-      if (artifact.app) {
-        return artifact.app[0]
-      }
-    }
-
-    return null
-  } catch (error) {
-    console.error(`Error fetching app name for cask ${caskName}:`, error)
-    return null
-  }
-}
-
-async function getComputerName() {
-  const compName = await execSync("scutil --get ComputerName").toString()
-
-  // remove empty space at end of string
-  return compName.substring(0, compName.length - 1)
-}
-
-async function getBundleIdentifier(appName) {
-  const bundleId = await execSync(
-    `osascript -e 'id of app "${appName}"'`,
-  ).toString()
-
-  // remove empty space at end of string
-  return bundleId.substring(0, bundleId.length - 1)
-}
-
-async function findAppFiles(appName, bundleId) {
-  try {
-    compNameGlob = await getComputerName()
-    const bundleIdComponents = bundleId.split(".")
-
-    const companyDirs = pathLocations.map(
-      (pathLocation) => `${pathLocation}/${bundleIdComponents[1]}`,
-    )
-    const pathsToSearch = [...pathLocations, ...companyDirs]
-    const directoryFilesPromiseArr = pathsToSearch.map((pathLocation) =>
-      fs.readdir(pathLocation),
-    )
-    const directoryFiles = await Promise.allSettled(directoryFilesPromiseArr)
-
-    const patternArray = await getFilePatternArray(appName, bundleId)
-
-    const filesToRemove = new Set([])
-
-    directoryFiles.forEach((dir, index) => {
-      if (dir.status === "fulfilled") {
-        dir.value.forEach((dirFile) => {
-          const dirFileNorm = dirFile.toLowerCase().replace(" ", "")
-          if (isPatternInFile(patternArray, dirFileNorm)) {
-            filesToRemove.add(
-              `${pathsToSearch[parseInt(index, 10)]}/${dirFile}`,
-            )
-          }
-        })
-      }
-    })
-
-    // convert set to array
-    return [...filesToRemove]
-  } catch (err) {
-    console.error(err)
-    throw err
-  }
-}
-
-export { appNameFromPath, getBundleIdentifier, findAppFiles }

package/lib/path-locations.js

@@ -1,28 +0,0 @@
-import { homedir } from "os"
-
-export const pathLocations = [
-  "/Applications",
-  "/private/var/db/receipts",
-  "/Library/LaunchDaemons",
-  `${homedir}/Downloads`,
-  `${homedir}/Library`,
-  `${homedir}/Library/Application Support`,
-  `${homedir}/Library/Application Scripts`,
-  `${homedir}/Library/Application Support/CrashReporter`,
-  `${homedir}/Library/Containers`,
-  `${homedir}/Library/Caches`,
-  `${homedir}/Library/HTTPStorages`,
-  `${homedir}/Library/Group Containers`,
-  `${homedir}/Library/Internet Plug-Ins`,
-  `${homedir}/Library/LaunchAgents`,
-  `${homedir}/Library/Logs`,
-  "/Library/Logs/DiagnosticReports",
-  `${homedir}/Library/Preferences`,
-  `${homedir}/Library/Preferences/ByHost`,
-  `${homedir}/Library/Saved Application State`,
-  `${homedir}/Library/WebKit`,
-  `${homedir}/Library/Caches/com.apple.helpd/Generated`,
-  "/Library/Audio/Plug-Ins/HAL",
-]
-
-export const commonSuffix = ["install"]