@salesforce-sentry/cli-shared 0.1.0

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@salesforce-sentry/cli-shared",
+  "version": "0.1.0",
+  "description": "Shared utilities for salesforce-sentry CLI tools",
+  "license": "MIT",
+  "files": [
+    "utils/"
+  ],
+  "dependencies": {
+    "diff": "^5.2.0",
+    "fast-xml-parser": "^4.3.6",
+    "picocolors": "^1.1.0",
+    "prompts": "^2.4.2"
+  }
+}

package/utils/dsn.js

@@ -0,0 +1,25 @@
+"use strict";
+
+// https://<publicKey>@<host>/<projectId>
+function parseDSN(dsn) {
+  if (!dsn || typeof dsn !== "string") return { valid: false };
+  const match = dsn.match(/^https?:\/\/([^@]+)@([^/]+)\/(\d+)$/);
+  if (!match) return { valid: false };
+  const [, publicKey, host, projectId] = match;
+  return {
+    valid: true,
+    publicKey,
+    host,
+    projectId,
+    remoteUrl: `https://${host}`
+  };
+}
+
+function validateDSN(dsn) {
+  const parsed = parseDSN(dsn);
+  if (!parsed.valid)
+    return "Invalid DSN — expected https://<key>@<host>/<projectId>";
+  return null;
+}
+
+module.exports = { parseDSN, validateDSN };

package/utils/interactive.js

@@ -0,0 +1,60 @@
+"use strict";
+
+const { createPatch } = require("diff");
+const pc = require("picocolors");
+const prompts = require("prompts");
+
+function colorDiff(patch) {
+  return patch
+    .split("\n")
+    .map((line) => {
+      if (line.startsWith("+++") || line.startsWith("---"))
+        return pc.bold(line);
+      if (line.startsWith("+")) return pc.green(line);
+      if (line.startsWith("-")) return pc.red(line);
+      if (line.startsWith("@@")) return pc.cyan(line);
+      return pc.dim(line);
+    })
+    .join("\n");
+}
+
+async function showDiffAndPrompt(transform) {
+  const relPath = transform.path.replace(process.cwd() + "/", "");
+  const divider = pc.dim("─".repeat(60));
+
+  console.log("\n" + divider);
+  console.log(pc.bold(" " + transform.label));
+  console.log(pc.dim(" " + relPath));
+  console.log(divider);
+
+  const patch = createPatch(
+    relPath,
+    transform.oldContent,
+    transform.newContent,
+    "",
+    "",
+    { context: 3 }
+  );
+  const hunks = patch.split("\n").slice(4).join("\n");
+  console.log(colorDiff(hunks));
+
+  const { decision } = await prompts(
+    {
+      type: "select",
+      name: "decision",
+      message: "Apply this change?",
+      choices: [
+        { title: pc.green("Yes"), value: "yes" },
+        { title: pc.dim("No"), value: "no" },
+        { title: pc.yellow("All remaining"), value: "all" },
+        { title: pc.red("Quit"), value: "quit" }
+      ],
+      initial: 0
+    },
+    { onCancel: () => ({ decision: "quit" }) }
+  );
+
+  return decision ?? "quit";
+}
+
+module.exports = { colorDiff, showDiffAndPrompt };

package/utils/meta-xml.js

@@ -0,0 +1,16 @@
+"use strict";
+
+const fs = require("fs");
+const { XMLParser } = require("fast-xml-parser");
+
+const parser = new XMLParser({ ignoreAttributes: false, parseTagValue: true });
+
+function readMetaXml(filePath) {
+  try {
+    return parser.parse(fs.readFileSync(filePath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+module.exports = { readMetaXml };

package/utils/sfdx.js

@@ -0,0 +1,83 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const SKIP_DIRS = new Set([
+  "node_modules",
+  "__tests__",
+  ".git",
+  ".sfdx",
+  ".sf"
+]);
+
+function readSfdxProject(projectRoot) {
+  const sfdxPath = path.join(projectRoot, "sfdx-project.json");
+  if (!fs.existsSync(sfdxPath)) {
+    throw new Error(
+      `No sfdx-project.json found in ${projectRoot}.\n` +
+        "Run this tool from the root of an SFDX project."
+    );
+  }
+  try {
+    return JSON.parse(fs.readFileSync(sfdxPath, "utf8"));
+  } catch (e) {
+    throw new Error(`Could not parse sfdx-project.json: ${e.message}`);
+  }
+}
+
+function getSourceDirs(projectRoot) {
+  const project = readSfdxProject(projectRoot);
+  const packageDirs = project.packageDirectories ?? [];
+  if (packageDirs.length === 0) {
+    throw new Error("sfdx-project.json has no packageDirectories entries.");
+  }
+  return packageDirs
+    .map((pkg) => path.resolve(projectRoot, pkg.path))
+    .filter((dir) => fs.existsSync(dir));
+}
+
+function getDefaultSourceDir(projectRoot) {
+  const project = readSfdxProject(projectRoot);
+  const entry =
+    project.packageDirectories?.find((d) => d.default) ??
+    project.packageDirectories?.[0];
+  if (!entry) {
+    throw new Error("No packageDirectories found in sfdx-project.json");
+  }
+  return path.resolve(projectRoot, entry.path);
+}
+
+function findFiles(dir, predicate, results = []) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return results;
+  }
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      if (!SKIP_DIRS.has(entry.name) && !entry.name.startsWith(".")) {
+        findFiles(path.join(dir, entry.name), predicate, results);
+      }
+    } else if (predicate(path.join(dir, entry.name))) {
+      results.push(path.join(dir, entry.name));
+    }
+  }
+  return results;
+}
+
+function findProjectFiles(projectRoot, predicate) {
+  const results = [];
+  for (const dir of getSourceDirs(projectRoot)) {
+    findFiles(dir, predicate, results);
+  }
+  return results;
+}
+
+module.exports = {
+  readSfdxProject,
+  getSourceDirs,
+  getDefaultSourceDir,
+  findProjectFiles
+};