expose-kit 0.2.0 → 0.2.2

package/README.md

@@ -21,8 +21,6 @@ Expose Kit takes *a different path*.
 
 Instead of brute force, it works **step by step**.
 
-The goal is simple: **safe and universal toolkit**.
-
 Alongside deobfuscation, Expose Kit includes a collection of practical utilities.    
 
 Everything you need is documented right here in this [README](README.md).
@@ -43,13 +41,57 @@ npm i -g expose-kit
 <!-- For Highlight -->
 ```regex
 expose --help
+expose parsable sample.js
 ```
 
 ## Docs
-Coming soon...
+By default, the first argument should be the file name (alternatively, `--file` or `--input` can be used).  
+
+If no options are provided, this tool will prompt you for the required values.  
+
+To avoid memory leaks and hung processes, a reasonable timeout is set by default.  
+When long-running execution is expected, the timeout can be disabled with `--unlimited`.
+
+### Commands
+---
+
+#### `expose parsable`
+
+Check if the file is parsable  
+```js
+parsable:     const x = 810;
+not parsable: cons x; = 810;
+```
+
+##### Example
+```bash
+expose parsable path/to/file.js
+```
+
+##### Args
+- *Only default args*
+
+---
+#### `expose scope-safe`
+
+Rename bindings per scope for safer transforms  
+```js
+Before: var x = 810;((x) => console.log(x))(114514);
+After: var x = 810;((_x) => console.log(_x))(114514);
+```
+
+##### Example
+```bash
+expose scope-safe path/to/file.js --output path/to/file.scope-safe.js
+```
+
+##### Args
+- `--o, --output <file>`: Output file path  
+  If the input has no extension, `path/to/file.scope-safe.js` is used.  
+  Otherwise, `path/to/file.scope-safe.<ext>` is used (same directory).
 
 ## Authors
 - [EdamAme-x](https://github.com/EdamAme-x)
 
 Built for research, not abuse.  
-Want stronger obfuscation? Then make something this tool can’t undo.
+Want stronger obfuscation? Then make something this tool can’t reverse.

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // index.ts
 import { Command } from "commander";
-import { dirname, join } from "path";
+import { dirname as dirname2, join as join2 } from "path";
 import { fileURLToPath } from "url";
 import chalk4 from "chalk";
 
@@ -23,15 +23,29 @@ var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 // utils/common/createPrompt.ts
 import chalk from "chalk";
+import readline from "readline";
 var PREFIX = chalk.bold(chalk.gray("?"));
-var createPrompt = (...args) => {
+var _prompt = "prompt" in globalThis ? globalThis.prompt : (question, defaultValue) => {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    const q = defaultValue ? `${question} (${defaultValue}): ` : `${question}: `;
+    rl.question(q, (answer) => {
+      rl.close();
+      resolve(answer || defaultValue || "");
+    });
+  });
+};
+var createPrompt = async (...args) => {
   const question = args.shift();
   if (!question) {
     throw new Error("Question is required");
   }
   const defaultAnswer = args.shift();
-  const answer = defaultAnswer ? prompt(`${PREFIX} ${question}`, defaultAnswer) : prompt(`${PREFIX} ${question}`);
-  return answer;
+  const answer = defaultAnswer ? _prompt(`${PREFIX} ${question}`, defaultAnswer) : _prompt(`${PREFIX} ${question}`);
+  return await answer;
 };
 
 // utils/babel/createParseOptions.ts
@@ -71,36 +85,124 @@ var showError = (message) => {
 
 // commands/parsable/index.ts
 var parsable_default = createCommand((program2) => {
-  program2.command("parsable").description("Check if the file is parsable").argument("[file]", "The file to check").option("--file <file>", "The file to check").action(async (fileArgument, options) => {
-    await timeout(async ({ finish }) => {
-      const filename = fileArgument ?? options.file ?? createPrompt("Enter the file path:");
-      if (!filename) {
-        showError("No file provided");
-        return finish();
-      }
-      try {
-        const fileContent = readFileSync(filename, "utf8");
-        const loader = loading("Checking if the file is parsable...").start();
-        try {
-          parse(fileContent, createParseOptions(filename));
-          await sleep(500);
-          loader.succeed("File is parsable");
-          return finish();
-        } catch (error) {
-          loader.fail("File is not parsable");
-          showError(
-            `Error parsing file '${filename}': ${error instanceof Error ? error.message : "Unknown error"}`
-          );
-          return finish();
+  program2.command("parsable").description("Check if the file is parsable").argument("[file]", "The file to check").option("--input, --file <file>", "The file to check").option("--unlimited", "Unlimited timeout").action(
+    async (fileArgument, options) => {
+      await timeout(
+        async ({ finish }) => {
+          const filename = fileArgument ?? options.file ?? await createPrompt("Enter the file path:");
+          if (!filename) {
+            showError("No file provided");
+            return finish();
+          }
+          try {
+            const fileContent = readFileSync(filename, "utf8");
+            const loader = loading(
+              "Checking if the file is parsable..."
+            ).start();
+            try {
+              parse(fileContent, createParseOptions(filename));
+              await sleep(500);
+              loader.succeed("File is parsable");
+              return finish();
+            } catch (error) {
+              loader.fail("File is not parsable");
+              showError(
+                `Error parsing file '${filename}': ${error instanceof Error ? error.message : "Unknown error"}`
+              );
+              return finish();
+            }
+          } catch (error) {
+            showError(
+              `Error reading file '${filename}': ${error instanceof Error ? error.message : "Unknown error"}`
+            );
+            return finish();
+          }
+        },
+        options.unlimited ? Infinity : 30 * 1e3
+      );
+    }
+  );
+});
+
+// commands/scope-safe/index.ts
+import { readFileSync as readFileSync2, writeFileSync } from "fs";
+import { basename, dirname, extname, join } from "path";
+import { parse as parse2 } from "@babel/parser";
+import traverse from "@babel/traverse";
+import generate from "@babel/generator";
+import loading2 from "loading-cli";
+var createDefaultOutputPath = (inputPath) => {
+  const ext = extname(inputPath);
+  if (!ext) {
+    return `${inputPath}.scope-safe.js`;
+  }
+  const base = basename(inputPath, ext);
+  return join(dirname(inputPath), `${base}.scope-safe${ext}`);
+};
+var renameBindingsByScope = (code, filename) => {
+  const ast = parse2(code, createParseOptions(filename));
+  const renamedBindings = /* @__PURE__ */ new Set();
+  traverse(ast, {
+    Scopable(path) {
+      for (const [name, binding] of Object.entries(path.scope.bindings)) {
+        if (renamedBindings.has(binding)) {
+          continue;
+        }
+        const shouldRename = !!path.scope.parent?.hasBinding(name);
+        if (!shouldRename) {
+          renamedBindings.add(binding);
+          continue;
+        }
+        const newName = path.scope.generateUid(name);
+        if (newName !== name) {
+          path.scope.rename(name, newName);
         }
-      } catch (error) {
-        showError(
-          `Error reading file '${filename}': ${error instanceof Error ? error.message : "Unknown error"}`
-        );
-        return finish();
+        renamedBindings.add(binding);
       }
-    }, 30 * 1e3);
+    }
   });
+  return generate(ast).code;
+};
+var scope_safe_default = createCommand((program2) => {
+  program2.command("scope-safe").description("Rename bindings per scope for safer transforms").argument("[file]", "The file to transform").option("--input, --file <file>", "The file to transform").option("--o, --output <file>", "Output file path").option("--unlimited", "Unlimited timeout").action(
+    async (fileArgument, options) => {
+      await timeout(
+        async ({ finish }) => {
+          const filename = fileArgument ?? options.file ?? await createPrompt("Enter the file path:");
+          if (!filename) {
+            showError("No file provided");
+            return finish();
+          }
+          try {
+            const fileContent = readFileSync2(filename, "utf8");
+            const defaultOutputPath = createDefaultOutputPath(filename);
+            let outputPath = options.output ?? (await createPrompt(
+              "Enter the output file path:"
+            ) || "").trim() ?? defaultOutputPath;
+            const loader = loading2("Renaming variables by scope...").start();
+            try {
+              const output = renameBindingsByScope(fileContent, filename);
+              writeFileSync(outputPath, output, "utf8");
+              loader.succeed(`Saved scope-safe file to: ${outputPath}`);
+              return finish();
+            } catch (error) {
+              loader.fail("Failed to apply scope-safe transform");
+              showError(
+                `Error transforming file '${filename}': ${error instanceof Error ? error.message : "Unknown error"}`
+              );
+              return finish();
+            }
+          } catch (error) {
+            showError(
+              `Error reading file '${filename}': ${error instanceof Error ? error.message : "Unknown error"}`
+            );
+            return finish();
+          }
+        },
+        options.unlimited ? Infinity : 120 * 1e3
+      );
+    }
+  );
 });
 
 // utils/cli/showCredit.ts
@@ -117,7 +219,7 @@ var beautify = (strings, ...values) => {
   return result;
 };
 var isNoColor = () => {
-  return process.env.NO_COLOR !== void 0 && process.argv.includes("--no-color");
+  return Bun.env.NO_COLOR !== void 0 && Bun.argv.includes("--no-color");
 };
 var calmGradienrain = (text) => {
   if (isNoColor()) {
@@ -154,10 +256,10 @@ ${calmGradienrain(`Expose Kit v${VERSION}`)}
 `;
 
 // index.ts
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname(__filename);
-var pkg = JSON.parse(readFileSync2(join(__dirname, "package.json"), "utf8"));
+var __dirname = dirname2(__filename);
+var pkg = JSON.parse(readFileSync3(join2(__dirname, "package.json"), "utf8"));
 console.log(showCredit(pkg.version));
 console.log();
 var program = new Command();
@@ -166,7 +268,7 @@ program.name("expose").description("CLI for Deobfuscating").version(
   "-v, --version",
   "display version number"
 );
-var commands = [parsable_default];
+var commands = [parsable_default, scope_safe_default];
 for (const command of commands) {
   command(program);
 }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "expose-kit",
-	"version": "0.2.0",
+	"version": "0.2.2",
 	"type": "module",
 	"private": false,
 	"author": "EdamAmex <edame8080@gmail.com> (https://github.com/EdamAme-x)",
@@ -24,7 +24,7 @@
 		"build": "tsup",
 		"postbuild": "publint",
 		"prepublishOnly": "bun copy",
-		"release": "np"
+		"release": "bun run build && np"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.11",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "expose-kit",
-	"version": "0.2.0",
+	"version": "0.2.2",
 	"type": "module",
 	"private": false,
 	"author": "EdamAmex <edame8080@gmail.com> (https://github.com/EdamAme-x)",
@@ -24,7 +24,7 @@
 		"build": "tsup",
 		"postbuild": "publint",
 		"prepublishOnly": "bun copy",
-		"release": "np"
+		"release": "bun run build && np"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.11",