@kud/soap-cli 2.0.0 → 3.0.0

package/README.md

@@ -130,6 +130,23 @@ Enables verbose shell output — shows every subprocess command that runs.
 
 ---
 
+## 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
+```
+
+---
+
 ## Credits
 
 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": "2.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": "vitest run"
+    "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,6 +27,9 @@
   },
   "homepage": "https://github.com/kud/soap-cli#readme",
   "type": "module",
+  "files": [
+    "dist"
+  ],
   "dependencies": {
     "@kud/soap-cli": "1.0.0",
     "chalk": "5.6.2",
@@ -35,6 +40,11 @@
     "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/.claude/settings.local.json

@@ -1,14 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(node ./index.js)",
-      "Bash(node:*)",
-      "Bash(npm install:*)",
-      "Bash(npm test:*)",
-      "Bash(brew info:*)",
-      "Bash(echo \"exit: $?\")",
-      "Bash(git tag:*)",
-      "Bash(git push:*)"
-    ]
-  }
-}

package/index.js

@@ -1,159 +0,0 @@
-#!/usr/bin/env node
-import inquirer from "inquirer"
-import signale from "signale"
-import trash from "trash"
-import chalk from "chalk"
-import { $, spinner } from "zx"
-
-import {
-  appNameFromPath,
-  getCaskInfo,
-  getBundleIdentifier,
-  findAppFiles,
-} from "./lib/index.js"
-
-$.verbose = process.env.SOAP_DEBUG === "1"
-
-const [param] = process.argv.slice(2)
-
-if (!param || param === "--help" || param === "-h") {
-  if (param === "--help" || param === "-h") {
-    console.log(`
-  ${chalk.bold("soap")} 🧼  ${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("·")} The .app bundle ${chalk.dim("(via brew uninstall --zap or manual selection)")}
-    ${chalk.dim("·")} Preferences  ${chalk.dim("~/Library/Preferences/com.<vendor>.<app>.plist")}
-    ${chalk.dim("·")} Caches       ${chalk.dim("~/Library/Caches/com.<vendor>.<app>")}
-    ${chalk.dim("·")} App support  ${chalk.dim("~/Library/Application Support/<App>")}
-    ${chalk.dim("·")} Containers   ${chalk.dim("~/Library/Containers/com.<vendor>.<app>")}
-    ${chalk.dim("·")} Launch agents, logs, crash reports, DMG files, and more
-
-  ${chalk.bold("Environment:")}
-    ${chalk.yellow("SOAP_DEBUG=1")}               Enable verbose shell output
-    `)
-    process.exit(0)
-  }
-  console.error(
-    chalk.red("No parameter specified. Run `soap --help` for usage."),
-  )
-  process.exit(1)
-}
-
-const isCask = !param.includes(".app")
-
-console.log(
-  `\nWelcome to ${chalk.bold("soap")} 🧼, ${chalk.italic("the app cleaner")}.\n`,
-)
-
-try {
-  const { appName, zapFiles } = isCask
-    ? await spinner(chalk.dim("Fetching cask info…"), () => 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…"), () =>
-    findAppFiles(appName, bundleId),
-  )
-
-  const appFiles = [
-    ...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")} — 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?.length > 0) {
-    await trash(deletedFilesWish, { force: true })
-
-    console.log("")
-    signale.success(
-      `Moved ${chalk.bold(deletedFilesWish.length)} file(s) to Trash:`,
-    )
-    deletedFilesWish.forEach((p) =>
-      console.log(`  ${chalk.dim("·")} ${chalk.dim(p)}`),
-    )
-  } else if (!isAppFilesEmpty) {
-    signale.info("No files selected — nothing moved to Trash.")
-  }
-
-  if (isCask && deletedCaskWish) {
-    console.log("")
-    signale.pending("Running Homebrew uninstall…")
-    await $`brew uninstall --zap ${param}`
-  }
-
-  console.log("")
-  signale.success("Done.")
-} catch (error) {
-  console.log("")
-  signale.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.\nForce-run ${chalk.bold(`brew uninstall --zap --force ${param}`)}?`,
-        default: false,
-      },
-    ])
-
-    if (forceUninstall) {
-      console.log("")
-      signale.pending("Force-uninstalling cask…")
-      await $`brew uninstall --zap --force ${param}`
-      signale.success("Force uninstall complete.")
-    }
-  }
-}

package/lib/__tests__/app-name.test.js

@@ -1,63 +0,0 @@
-import { describe, it, expect } from "vitest"
-import {
-  appNameFromPath,
-  createNameVariations,
-  normalizeString,
-} from "../index.js"
-
-describe("appNameFromPath", () => {
-  it("extracts name from full path", () => {
-    expect(appNameFromPath("/Applications/Spotify.app")).toBe("Spotify")
-  })
-
-  it("extracts name from filename only", () => {
-    expect(appNameFromPath("Spotify.app")).toBe("Spotify")
-  })
-
-  it("handles app names with spaces", () => {
-    expect(appNameFromPath("/Applications/Affinity Designer 2.app")).toBe(
-      "Affinity Designer 2",
-    )
-  })
-
-  it("handles nested path", () => {
-    expect(appNameFromPath("/Users/kud/Downloads/MyApp.app")).toBe("MyApp")
-  })
-})
-
-describe("normalizeString", () => {
-  it("lowercases the string", () => {
-    expect(normalizeString("Spotify")).toBe("spotify")
-  })
-
-  it("replaces spaces with empty string by default", () => {
-    expect(normalizeString("Affinity Designer")).toBe("affinitydesigner")
-  })
-
-  it("replaces spaces with custom spacer", () => {
-    expect(normalizeString("Affinity Designer", "-")).toBe("affinity-designer")
-  })
-})
-
-describe("createNameVariations", () => {
-  it("returns all expected variation keys for a simple name", () => {
-    const variations = createNameVariations("Spotify", "com.spotify.client")
-    expect(variations).toContain("spotify")
-    expect(variations).toContain("com.spotify.client")
-  })
-
-  it("produces dash and underscore variants for multi-word names", () => {
-    const variations = createNameVariations(
-      "Affinity Designer",
-      "com.affinity.designer2",
-    )
-    expect(variations).toContain("affinity-designer")
-    expect(variations).toContain("affinity_designer")
-    expect(variations).toContain("affinity.designer")
-  })
-
-  it("returns 6 variations", () => {
-    const variations = createNameVariations("Spotify", "com.spotify.client")
-    expect(variations).toHaveLength(6)
-  })
-})

package/lib/__tests__/file-regex.test.js

@@ -1,46 +0,0 @@
-import { describe, it, expect } from "vitest"
-import { fileRegex } from "../file-regex.js"
-
-const strip = (str) => {
-  let result = str
-  fileRegex.forEach((r) => (result = result.replace(r, "")))
-  return result
-}
-
-describe("fileRegex", () => {
-  it("strips UUID patterns", () => {
-    expect(
-      strip("app-550e8400-e29b-41d4-a716-446655440000.plist"),
-    ).not.toContain("550e8400-e29b-41d4-a716-446655440000")
-  })
-
-  it("strips date patterns", () => {
-    expect(strip("crash-2024-03-15-142500.log")).not.toContain(
-      "2024-03-15-142500",
-    )
-  })
-
-  it("strips .app extension", () => {
-    expect(strip("Spotify.app")).toBe("Spotify")
-  })
-
-  it("strips .plist extension", () => {
-    expect(strip("com.spotify.client.plist")).toBe("com.spotify.client")
-  })
-
-  it("strips .dmg extension", () => {
-    expect(strip("Spotify.dmg")).toBe("Spotify")
-  })
-
-  it("strips .savedState extension", () => {
-    expect(strip("Spotify.savedState")).toBe("Spotify")
-  })
-
-  it("strips diag resource pattern", () => {
-    expect(strip("Spotify_resource.diag")).not.toContain("_resource.diag")
-  })
-
-  it("leaves unrelated strings intact", () => {
-    expect(strip("spotify")).toBe("spotify")
-  })
-})

package/lib/__tests__/pattern-matching.test.js

@@ -1,39 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest"
-import { isPatternInFile } from "../index.js"
-
-// isPatternInFile relies on the module-level compNameGlob for stripString.
-// We test it with patterns and filenames where the computer name is irrelevant.
-
-describe("isPatternInFile", () => {
-  it("matches when pattern is prominent in the filename", () => {
-    const result = isPatternInFile(["spotify"], "spotify.plist")
-    expect(result).toBeTruthy()
-  })
-
-  it("matches bundle-id style filename", () => {
-    const result = isPatternInFile(
-      ["com.spotify.client"],
-      "com.spotify.client.plist",
-    )
-    expect(result).toBeTruthy()
-  })
-
-  it("does not match when pattern is a minor substring of a long unrelated filename", () => {
-    // 'it' is a substring of 'microsoft' but far too short relative to the full filename
-    const result = isPatternInFile(
-      ["it"],
-      "com.microsoft.office.reminders.plist",
-    )
-    expect(result).toBeFalsy()
-  })
-
-  it("returns falsy when no patterns match", () => {
-    const result = isPatternInFile(["spotify"], "com.apple.finder.plist")
-    expect(result).toBeFalsy()
-  })
-
-  it("returns falsy for empty patterns array", () => {
-    const result = isPatternInFile([], "spotify.plist")
-    expect(result).toBeFalsy()
-  })
-})

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,233 +0,0 @@
-import { $ } from "zx"
-$.verbose = false
-
-import { execSync } from "child_process"
-import fs from "fs/promises"
-import { homedir } from "os"
-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
-}
-
-export 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
-}
-
-export function 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, 10)] === ".") score += 0.5
-        if (strippedFile[parseInt(i, 10)] === "_") score += 0.5
-      }
-      if (score / strippedFile.length > scoreThreshold) {
-        return true
-      }
-      return false
-    }
-    return false
-  })
-}
-
-export function 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,
-  ]
-}
-
-export function appNameFromPath(appPath) {
-  const pathArr = appPath.split("/")
-  const appNameWithExt = pathArr[pathArr.length - 1]
-  return appNameWithExt.replace(".app", "")
-}
-
-async function fetchCaskData(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
-}
-
-async function resolveZapPaths(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(/^~/, homedir()))
-
-  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()
-}
-
-export const 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.message}`,
-    )
-  }
-}
-
-export const appNameFromCaskName = async (caskName) => {
-  const { appName } = await getCaskInfo(caskName)
-  return appName
-}
-
-export const getZapFiles = async (caskName) => {
-  const { zapFiles } = await getCaskInfo(caskName)
-  return zapFiles
-}
-
-function getComputerName() {
-  return execSync("scutil --get ComputerName").toString().trimEnd()
-}
-
-export async function getBundleIdentifier(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?`,
-    )
-  }
-}
-
-export async function findAppFiles(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 = 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, 10)]}/${dirFile}`,
-            )
-          }
-        })
-      }
-    })
-
-    return [...filesToRemove]
-  } catch (err) {
-    console.error(err)
-    throw err
-  }
-}

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"]