@nodesecure/js-x-ray 9.0.0 → 9.2.0

package/dist/Deobfuscator.js

@@ -0,0 +1,154 @@
+// Import Third-party Dependencies
+import { getVariableDeclarationIdentifiers } from "@nodesecure/estree-ast-utils";
+import { Utils, Patterns } from "@nodesecure/sec-literal";
+import { match } from "ts-pattern";
+// Import Internal Dependencies
+import { NodeCounter } from "./NodeCounter.js";
+import { extractNode } from "./utils/index.js";
+import * as jjencode from "./obfuscators/jjencode.js";
+import * as jsfuck from "./obfuscators/jsfuck.js";
+import * as freejsobfuscator from "./obfuscators/freejsobfuscator.js";
+import * as obfuscatorio from "./obfuscators/obfuscator-io.js";
+// CONSTANTS
+const kIdentifierNodeExtractor = extractNode("Identifier");
+const kDictionaryStrParts = [
+    "abcdefghijklmnopqrstuvwxyz",
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
+    "0123456789"
+];
+const kMinimumIdsCount = 5;
+export class Deobfuscator {
+    deepBinaryExpression = 0;
+    encodedArrayValue = 0;
+    hasDictionaryString = false;
+    hasPrefixedIdentifiers = false;
+    morseLiterals = new Set();
+    literalScores = [];
+    identifiers = [];
+    #counters = [
+        new NodeCounter("VariableDeclaration[kind]"),
+        new NodeCounter("AssignmentExpression", {
+            match: (node, nc) => this.#extractCounterIdentifiers(nc, node.left)
+        }),
+        new NodeCounter("FunctionDeclaration", {
+            match: (node, nc) => this.#extractCounterIdentifiers(nc, node.id)
+        }),
+        new NodeCounter("MemberExpression[computed]"),
+        new NodeCounter("Property", {
+            filter: (node) => node.key.type === "Identifier",
+            match: (node, nc) => this.#extractCounterIdentifiers(nc, node.key)
+        }),
+        new NodeCounter("UnaryExpression", {
+            name: "DoubleUnaryExpression",
+            filter: ({ argument }) => argument.type === "UnaryExpression" && argument.argument.type === "ArrayExpression"
+        }),
+        new NodeCounter("VariableDeclarator", {
+            match: (node, nc) => this.#extractCounterIdentifiers(nc, node.id)
+        })
+    ];
+    #extractCounterIdentifiers(nc, node) {
+        if (node === null) {
+            return;
+        }
+        const { type } = nc;
+        switch (type) {
+            case "VariableDeclarator":
+            case "AssignmentExpression": {
+                for (const { name } of getVariableDeclarationIdentifiers(node)) {
+                    this.identifiers.push({ name, type });
+                }
+                break;
+            }
+            case "Property":
+            case "FunctionDeclaration":
+                if (node.type === "Identifier") {
+                    this.identifiers.push({ name: node.name, type });
+                }
+                break;
+        }
+    }
+    analyzeString(str) {
+        const score = Utils.stringSuspicionScore(str);
+        if (score !== 0) {
+            this.literalScores.push(score);
+        }
+        if (!this.hasDictionaryString) {
+            const isDictionaryStr = kDictionaryStrParts.every((word) => str.includes(word));
+            if (isDictionaryStr) {
+                this.hasDictionaryString = true;
+            }
+        }
+        // Searching for morse string like "--.- --.--"
+        if (Utils.isMorse(str)) {
+            this.morseLiterals.add(str);
+        }
+    }
+    walk(node) {
+        const nodesToExtract = match(node)
+            .with({ type: "ClassDeclaration" }, (node) => [node.id, node.superClass])
+            .with({ type: "FunctionDeclaration" }, (node) => node.params)
+            .with({ type: "FunctionExpression" }, (node) => node.params)
+            .with({ type: "MethodDefinition" }, (node) => [node.key])
+            .otherwise(() => []);
+        const isFunctionParams = node.type === "FunctionDeclaration" ||
+            node.type === "FunctionExpression";
+        kIdentifierNodeExtractor(({ name }) => this.identifiers.push({
+            name,
+            type: isFunctionParams ? "FunctionParams" : node.type
+        }), nodesToExtract);
+        this.#counters.forEach((counter) => counter.walk(node));
+    }
+    aggregateCounters() {
+        return this.#counters.reduce((result, counter) => {
+            result[counter.name] = counter.lookup ?
+                counter.properties :
+                counter.count;
+            return result;
+        }, {
+            Identifiers: this.identifiers.length
+        });
+    }
+    #calcAvgPrefixedIdentifiers(counters, prefix) {
+        const valuesArr = Object
+            .values(prefix)
+            .slice()
+            .sort((left, right) => left - right);
+        if (valuesArr.length === 0) {
+            return 0;
+        }
+        const nbOfPrefixedIds = valuesArr.length === 1 ?
+            valuesArr.pop() :
+            (valuesArr.pop() + valuesArr.pop());
+        const maxIds = counters.Identifiers - (counters.Property ?? 0);
+        return ((nbOfPrefixedIds / maxIds) * 100);
+    }
+    assertObfuscation() {
+        const counters = this.aggregateCounters();
+        if (jsfuck.verify(counters)) {
+            return "jsfuck";
+        }
+        if (jjencode.verify(this.identifiers, counters)) {
+            return "jjencode";
+        }
+        if (this.morseLiterals.size >= 36) {
+            return "morse";
+        }
+        const { prefix } = Patterns.commonHexadecimalPrefix(this.identifiers.flatMap(({ name }) => (typeof name === "string" ? [name] : [])));
+        const uPrefixNames = new Set(Object.keys(prefix));
+        if (this.identifiers.length > kMinimumIdsCount && uPrefixNames.size > 0) {
+            this.hasPrefixedIdentifiers = this.#calcAvgPrefixedIdentifiers(counters, prefix) > 80;
+        }
+        if (uPrefixNames.size === 1 && freejsobfuscator.verify(this.identifiers, prefix)) {
+            return "freejsobfuscator";
+        }
+        if (obfuscatorio.verify(this, counters)) {
+            return "obfuscator.io";
+        }
+        // if ((identifierLength > (kMinimumIdsCount * 3) && this.hasPrefixedIdentifiers)
+        //     && (oneTimeOccurence <= 3 || this.encodedArrayValue > 0)) {
+        //     return "unknown";
+        // }
+        return null;
+    }
+}
+//# sourceMappingURL=Deobfuscator.js.map

package/dist/Deobfuscator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deobfuscator.js","sourceRoot":"","sources":["../src/Deobfuscator.ts"],"names":[],"mappings":"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"}

package/dist/EntryFilesAnalyser.d.ts

@@ -0,0 +1,20 @@
+import { DiGraph, type VertexBody, type VertexDefinition } from "digraph-js";
+import { AstAnalyser, type ReportOnFile, type RuntimeFileOptions } from "./AstAnalyser.js";
+export interface EntryFilesAnalyserOptions {
+    astAnalyzer?: AstAnalyser;
+    loadExtensions?: (defaults: string[]) => string[];
+    rootPath?: string | URL;
+    ignoreENOENT?: boolean;
+}
+export declare class EntryFilesAnalyser {
+    #private;
+    astAnalyzer: AstAnalyser;
+    allowedExtensions: Set<string>;
+    dependencies: DiGraph<VertexDefinition<VertexBody>>;
+    ignoreENOENT: boolean;
+    constructor(options?: EntryFilesAnalyserOptions);
+    analyse(entryFiles: Iterable<string | URL>, options?: RuntimeFileOptions): AsyncGenerator<ReportOnFile & {
+        file: string;
+    }>;
+}
+//# sourceMappingURL=EntryFilesAnalyser.d.ts.map

package/dist/EntryFilesAnalyser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntryFilesAnalyser.d.ts","sourceRoot":"","sources":["../src/EntryFilesAnalyser.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,OAAO,EACP,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAK1B,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,kBAAkB;;IAE7B,WAAW,EAAE,WAAW,CAAC;IACzB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,YAAY,EAAE,OAAO,CAAC;gBAGpB,OAAO,GAAE,yBAA8B;IAoBlC,OAAO,CACZ,UAAU,EAAE,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,EAClC,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAAC,YAAY,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;KAAE,CAAC;CAyIpD"}

package/dist/EntryFilesAnalyser.js

@@ -0,0 +1,121 @@
+// Import Node.js Dependencies
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+// Import Third-party Dependencies
+import { DiGraph } from "digraph-js";
+// Import Internal Dependencies
+import { AstAnalyser } from "./AstAnalyser.js";
+// CONSTANTS
+const kDefaultExtensions = ["js", "cjs", "mjs", "node"];
+export class EntryFilesAnalyser {
+    #rootPath = null;
+    astAnalyzer;
+    allowedExtensions;
+    dependencies;
+    ignoreENOENT;
+    constructor(options = {}) {
+        const { astAnalyzer = new AstAnalyser(), loadExtensions, rootPath = null, ignoreENOENT = false } = options;
+        this.astAnalyzer = astAnalyzer;
+        const rawAllowedExtensions = loadExtensions
+            ? loadExtensions(kDefaultExtensions)
+            : kDefaultExtensions;
+        this.allowedExtensions = new Set(rawAllowedExtensions);
+        this.#rootPath = rootPath === null ?
+            null : fileURLToPathExtended(rootPath);
+        this.ignoreENOENT = ignoreENOENT;
+    }
+    async *analyse(entryFiles, options = {}) {
+        this.dependencies = new DiGraph();
+        for (const entryFile of new Set(entryFiles)) {
+            const normalizedEntryFile = this.#normalizeAndCleanEntryFile(entryFile);
+            if (this.ignoreENOENT &&
+                !await this.#fileExists(normalizedEntryFile)) {
+                return;
+            }
+            yield* this.#analyseFile(normalizedEntryFile, this.#getRelativeFilePath(normalizedEntryFile), options);
+        }
+    }
+    #normalizeAndCleanEntryFile(file) {
+        let normalizedEntryFile = path.normalize(fileURLToPathExtended(file));
+        if (this.#rootPath !== null && !path.isAbsolute(normalizedEntryFile)) {
+            normalizedEntryFile = path.join(this.#rootPath, normalizedEntryFile);
+        }
+        return normalizedEntryFile;
+    }
+    #getRelativeFilePath(file) {
+        return this.#rootPath ?
+            path.relative(this.#rootPath, file) :
+            file;
+    }
+    async *#analyseFile(file, relativeFile, options) {
+        this.dependencies.addVertex({
+            id: relativeFile,
+            adjacentTo: [],
+            body: {}
+        });
+        const report = await this.astAnalyzer.analyseFile(file, options);
+        yield { file: relativeFile, ...report };
+        if (!report.ok || typeof report.dependencies === "undefined") {
+            return;
+        }
+        for (const [name] of report.dependencies) {
+            const depFile = await this.#getInternalDepPath(path.join(path.dirname(file), name));
+            if (depFile === null) {
+                continue;
+            }
+            const depRelativeFile = this.#getRelativeFilePath(depFile);
+            if (!this.dependencies.hasVertex(depRelativeFile)) {
+                this.dependencies.addVertex({
+                    id: depRelativeFile,
+                    adjacentTo: [],
+                    body: {}
+                });
+                yield* this.#analyseFile(depFile, depRelativeFile, options);
+            }
+            this.dependencies.addEdge({
+                from: relativeFile, to: depRelativeFile
+            });
+        }
+    }
+    async #getInternalDepPath(filePath) {
+        const fileExtension = path.extname(filePath);
+        if (fileExtension === "") {
+            for (const ext of this.allowedExtensions) {
+                const depPathWithExt = `${filePath}.${ext}`;
+                const fileExist = await this.#fileExists(depPathWithExt);
+                if (fileExist) {
+                    return depPathWithExt;
+                }
+            }
+        }
+        else {
+            if (!this.allowedExtensions.has(fileExtension.slice(1))) {
+                return null;
+            }
+            const fileExist = await this.#fileExists(filePath);
+            if (fileExist) {
+                return filePath;
+            }
+        }
+        return null;
+    }
+    async #fileExists(filePath) {
+        try {
+            await fs.access(filePath, fs.constants.R_OK);
+            return true;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+            return false;
+        }
+    }
+}
+function fileURLToPathExtended(file) {
+    return file instanceof URL ?
+        fileURLToPath(file) :
+        file;
+}
+//# sourceMappingURL=EntryFilesAnalyser.js.map

package/dist/EntryFilesAnalyser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntryFilesAnalyser.js","sourceRoot":"","sources":["../src/EntryFilesAnalyser.ts"],"names":[],"mappings":"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"}

package/dist/JsSourceParser.d.ts

@@ -0,0 +1,18 @@
+import { type ESTree } from "meriyah";
+export type SourceParserSyntaxError = SyntaxError & {
+    start: number;
+    end: number;
+    range: [number, number];
+    description: string;
+    loc: ESTree.SourceLocation;
+};
+export interface SourceParser {
+    parse(source: string, options: unknown): ESTree.Statement[];
+}
+export interface JsSourceParserOptions {
+    isEcmaScriptModule?: boolean;
+}
+export declare class JsSourceParser implements SourceParser {
+    parse(source: string, options?: JsSourceParserOptions): ESTree.Program["body"];
+}
+//# sourceMappingURL=JsSourceParser.d.ts.map

package/dist/JsSourceParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsSourceParser.d.ts","sourceRoot":"","sources":["../src/JsSourceParser.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,MAAM,EAEZ,MAAM,SAAS,CAAC;AAUjB,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC;CAC5B,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,cAAe,YAAW,YAAY;IACjD,KAAK,CACH,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;CAyC1B"}

package/dist/JsSourceParser.js

@@ -0,0 +1,38 @@
+// Import Third-party Dependencies
+import { parseScript } from "meriyah";
+// CONSTANTS
+const kParsingOptions = {
+    next: true,
+    loc: true,
+    raw: true,
+    jsx: true
+};
+export class JsSourceParser {
+    parse(source, options = {}) {
+        const { isEcmaScriptModule } = options;
+        try {
+            const { body } = parseScript(source, {
+                ...kParsingOptions,
+                module: isEcmaScriptModule,
+                globalReturn: !isEcmaScriptModule
+            });
+            return body;
+        }
+        catch (error) {
+            const syntaxError = error;
+            const isIllegalReturn = syntaxError.description.includes("Illegal return statement");
+            if (syntaxError.name === "SyntaxError" && (syntaxError.description.includes("The import keyword") ||
+                syntaxError.description.includes("The export keyword") ||
+                isIllegalReturn)) {
+                const { body } = parseScript(source, {
+                    ...kParsingOptions,
+                    module: true,
+                    globalReturn: isIllegalReturn
+                });
+                return body;
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=JsSourceParser.js.map

package/dist/JsSourceParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsSourceParser.js","sourceRoot":"","sources":["../src/JsSourceParser.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EACL,WAAW,EAGZ,MAAM,SAAS,CAAC;AAEjB,YAAY;AACZ,MAAM,eAAe,GAAqB;IACxC,IAAI,EAAE,IAAI;IACV,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;CACV,CAAC;AAkBF,MAAM,OAAO,cAAc;IACzB,KAAK,CACH,MAAc,EACd,UAAiC,EAAE;QAEnC,MAAM,EACJ,kBAAkB,EACnB,GAAG,OAAO,CAAC;QAEZ,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAC1B,MAAM,EACN;gBACE,GAAG,eAAe;gBAClB,MAAM,EAAE,kBAAkB;gBAC1B,YAAY,EAAE,CAAC,kBAAkB;aAClC,CACF,CAAC;YAEF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAc,EAAE,CAAC;YACtB,MAAM,WAAW,GAAG,KAAgC,CAAC;YACrD,MAAM,eAAe,GAAG,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;YAErF,IAAI,WAAW,CAAC,IAAI,KAAK,aAAa,IAAI,CACxC,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBACtD,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBACtD,eAAe,CAChB,EAAE,CAAC;gBACF,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAC1B,MAAM,EACN;oBACE,GAAG,eAAe;oBAClB,MAAM,EAAE,IAAI;oBACZ,YAAY,EAAE,eAAe;iBAC9B,CACF,CAAC;gBAEF,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/NodeCounter.d.ts

@@ -0,0 +1,24 @@
+import type { ESTree } from "meriyah";
+export type NodeCounterFilterCallback<T extends ESTree.Node> = (node: T) => boolean;
+export type NodeCounterMatchCallback<T extends ESTree.Node> = (node: T, nc: NodeCounter<T>) => void;
+export interface NodeCounterOptions<T extends ESTree.Node> {
+    name?: string;
+    filter?: NodeCounterFilterCallback<T>;
+    match?: NodeCounterMatchCallback<T>;
+}
+export declare class NodeCounter<T extends ESTree.Node = ESTree.Node> {
+    #private;
+    type: string;
+    name: string;
+    lookup: string | null;
+    /**
+     * @example
+     * new NodeCounter("FunctionDeclaration");
+     * new NodeCounter("VariableDeclaration[kind]");
+     */
+    constructor(type: string, options?: NodeCounterOptions<T>);
+    get count(): number;
+    get properties(): Record<string, number>;
+    walk(node: ESTree.Node): void;
+}
+//# sourceMappingURL=NodeCounter.d.ts.map

package/dist/NodeCounter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeCounter.d.ts","sourceRoot":"","sources":["../src/NodeCounter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAStC,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;AACpF,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAEpG,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC;CACrC;AAED,qBAAa,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI;;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO7B;;;;OAIG;gBAED,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM;IAqBrC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIvC;IAED,IAAI,CACF,IAAI,EAAE,MAAM,CAAC,IAAI,GAChB,IAAI;CAmBR"}

package/dist/NodeCounter.js

@@ -0,0 +1,62 @@
+// Import Third-party Dependencies
+import FrequencySet from "frequency-set";
+// Import Internal Dependencies
+import { isNode } from "./types/estree.js";
+function noop() {
+    return true;
+}
+export class NodeCounter {
+    type;
+    name;
+    lookup = null;
+    #count = 0;
+    #properties = null;
+    #filterFn = noop;
+    #matchFn = noop;
+    /**
+     * @example
+     * new NodeCounter("FunctionDeclaration");
+     * new NodeCounter("VariableDeclaration[kind]");
+     */
+    constructor(type, options = {}) {
+        if (typeof type !== "string") {
+            throw new TypeError("type must be a string");
+        }
+        const typeResult = /([A-Za-z]+)(\[[a-zA-Z]+\])?/g.exec(type);
+        if (typeResult === null) {
+            throw new Error("invalid type argument syntax");
+        }
+        this.type = typeResult[1];
+        this.lookup = typeResult[2]?.slice(1, -1) ?? null;
+        this.name = options?.name ?? this.type;
+        if (this.lookup) {
+            this.#properties = new FrequencySet();
+        }
+        this.#filterFn = options.filter ?? noop;
+        this.#matchFn = options.match ?? noop;
+    }
+    get count() {
+        return this.#count;
+    }
+    get properties() {
+        return Object.fromEntries(this.#properties?.entries() ?? []);
+    }
+    walk(node) {
+        if (!isNode(node) || node.type !== this.type) {
+            return;
+        }
+        const castedNode = node;
+        if (!this.#filterFn(castedNode)) {
+            return;
+        }
+        this.#count++;
+        if (this.lookup === null) {
+            this.#matchFn(castedNode, this);
+        }
+        else if (this.lookup in node) {
+            this.#properties?.add(node[this.lookup]);
+            this.#matchFn(castedNode, this);
+        }
+    }
+}
+//# sourceMappingURL=NodeCounter.js.map

package/dist/NodeCounter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeCounter.js","sourceRoot":"","sources":["../src/NodeCounter.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,YAAY,MAAM,eAAe,CAAC;AAGzC,+BAA+B;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,SAAS,IAAI;IACX,OAAO,IAAI,CAAC;AACd,CAAC;AAWD,MAAM,OAAO,WAAW;IACtB,IAAI,CAAS;IACb,IAAI,CAAS;IACb,MAAM,GAAkB,IAAI,CAAC;IAE7B,MAAM,GAAG,CAAC,CAAC;IACX,WAAW,GAAgC,IAAI,CAAC;IAChD,SAAS,GAAiC,IAAI,CAAC;IAC/C,QAAQ,GAAgC,IAAI,CAAC;IAE7C;;;;OAIG;IACH,YACE,IAAY,EACZ,UAAiC,EAAE;QAEnC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,UAAU,GAAG,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,WAAW,GAAG,IAAI,YAAY,EAAE,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IACxC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,MAAM,CAAC,WAAW,CACvB,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAClC,CAAC;IACJ,CAAC;IAED,IAAI,CACF,IAAiB;QAEjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAG,IAAS,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;aACI,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;CACF"}

package/dist/ProbeRunner.d.ts

@@ -0,0 +1,40 @@
+import type { ESTree } from "meriyah";
+import type { SourceFile } from "./SourceFile.js";
+import type { OptionalWarningName } from "./warnings.js";
+export type ProbeReturn = void | null | symbol;
+export type ProbeInitializeCallback = (sourceFile: SourceFile) => void;
+export type ProbeMainCallback = (node: any, options: {
+    sourceFile: SourceFile;
+    data?: any;
+}) => ProbeReturn;
+export type ProbeTeardownCallback = (options: {
+    sourceFile: SourceFile;
+}) => void;
+export type ProbeValidationCallback = (node: ESTree.Node, sourceFile: SourceFile) => [boolean, any?];
+export interface Probe {
+    name: string;
+    initialize?: ProbeInitializeCallback;
+    validateNode: ProbeValidationCallback | ProbeValidationCallback[];
+    main: ProbeMainCallback;
+    teardown?: ProbeTeardownCallback;
+    breakOnMatch?: boolean;
+    breakGroup?: string;
+}
+export declare const ProbeSignals: Readonly<{
+    Break: symbol;
+    Skip: symbol;
+}>;
+export declare class ProbeRunner {
+    #private;
+    probes: Probe[];
+    sourceFile: SourceFile;
+    /**
+     * Note:
+     * The order of the table has an importance/impact on the correct execution of the probes
+     */
+    static Defaults: Probe[];
+    static Optionals: Record<OptionalWarningName, Probe>;
+    constructor(sourceFile: SourceFile, probes?: Probe[]);
+    walk(node: ESTree.Node): null | "skip";
+}
+//# sourceMappingURL=ProbeRunner.d.ts.map

package/dist/ProbeRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProbeRunner.d.ts","sourceRoot":"","sources":["../src/ProbeRunner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAkBtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAC/C,MAAM,MAAM,uBAAuB,GAAG,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,GAAG,EACT,OAAO,EAAE;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAC;CAAE,KAC7C,WAAW,CAAC;AACjB,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,UAAU,CAAC;CAAE,KAAK,IAAI,CAAC;AACnF,MAAM,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;AAErG,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,YAAY,EAAE,uBAAuB,GAAG,uBAAuB,EAAE,CAAC;IAClE,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,YAAY;;;EAGvB,CAAC;AAEH,qBAAa,WAAW;;IACtB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IAEvB;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,CActB;IAEF,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAElD;gBAGA,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,KAAK,EAAyB;IAgDxC,IAAI,CACF,IAAI,EAAE,MAAM,CAAC,IAAI,GAChB,IAAI,GAAG,MAAM;CAqCjB"}

package/dist/ProbeRunner.js

@@ -0,0 +1,106 @@
+// Import Node.js Dependencies
+import assert from "node:assert";
+// Import Internal Dependencies
+import isUnsafeCallee from "./probes/isUnsafeCallee.js";
+import isLiteral from "./probes/isLiteral.js";
+import isLiteralRegex from "./probes/isLiteralRegex.js";
+import isRegexObject from "./probes/isRegexObject.js";
+import isRequire from "./probes/isRequire/isRequire.js";
+import isImportDeclaration from "./probes/isImportDeclaration.js";
+import isWeakCrypto from "./probes/isWeakCrypto.js";
+import isBinaryExpression from "./probes/isBinaryExpression.js";
+import isArrayExpression from "./probes/isArrayExpression.js";
+import isESMExport from "./probes/isESMExport.js";
+import isFetch from "./probes/isFetch.js";
+import isUnsafeCommand from "./probes/isUnsafeCommand.js";
+import isSyncIO from "./probes/isSyncIO.js";
+import isSerializeEnv from "./probes/isSerializeEnv.js";
+export const ProbeSignals = Object.freeze({
+    Break: Symbol.for("breakWalk"),
+    Skip: Symbol.for("skipWalk")
+});
+export class ProbeRunner {
+    probes;
+    sourceFile;
+    /**
+     * Note:
+     * The order of the table has an importance/impact on the correct execution of the probes
+     */
+    static Defaults = [
+        isFetch,
+        isRequire,
+        isESMExport,
+        isUnsafeCallee,
+        isLiteral,
+        isLiteralRegex,
+        isRegexObject,
+        isImportDeclaration,
+        isWeakCrypto,
+        isBinaryExpression,
+        isArrayExpression,
+        isUnsafeCommand,
+        isSerializeEnv
+    ];
+    static Optionals = {
+        "synchronous-io": isSyncIO
+    };
+    constructor(sourceFile, probes = ProbeRunner.Defaults) {
+        this.sourceFile = sourceFile;
+        for (const probe of probes) {
+            assert(typeof probe.validateNode === "function" || Array.isArray(probe.validateNode), `Invalid probe ${probe.name}: validateNode must be a function or an array of functions`);
+            assert(typeof probe.main === "function", `Invalid probe ${probe.name}: main must be a function`);
+            assert(typeof probe.initialize === "function" || probe.initialize === undefined, `Invalid probe ${probe.name}: initialize must be a function or undefined`);
+            if (probe.initialize) {
+                probe.initialize(sourceFile);
+            }
+        }
+        this.probes = probes;
+    }
+    #runProbe(probe, node) {
+        const validationFns = Array.isArray(probe.validateNode) ?
+            probe.validateNode : [probe.validateNode];
+        for (const validateNode of validationFns) {
+            const [isMatching, data = null] = validateNode(node, this.sourceFile);
+            if (isMatching) {
+                return probe.main(node, {
+                    sourceFile: this.sourceFile,
+                    data
+                });
+            }
+        }
+        return null;
+    }
+    walk(node) {
+        const breakGroups = new Set();
+        for (const probe of this.probes) {
+            if (probe.breakGroup && breakGroups.has(probe.breakGroup)) {
+                continue;
+            }
+            try {
+                const result = this.#runProbe(probe, node);
+                if (result === null) {
+                    continue;
+                }
+                if (result === ProbeSignals.Skip) {
+                    return "skip";
+                }
+                if (result === ProbeSignals.Break || probe.breakOnMatch) {
+                    const breakGroup = probe.breakGroup || null;
+                    if (breakGroup === null) {
+                        break;
+                    }
+                    else {
+                        breakGroups.add(breakGroup);
+                    }
+                }
+            }
+            finally {
+                if (probe.teardown) {
+                    probe.teardown({ sourceFile: this.sourceFile });
+                }
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=ProbeRunner.js.map

package/dist/ProbeRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProbeRunner.js","sourceRoot":"","sources":["../src/ProbeRunner.ts"],"names":[],"mappings":"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"}