@sfdxy/mule-lint 1.4.0

package/dist/src/core/ComplexityCalculator.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComplexityCalculator = void 0;
+const XPathHelper_1 = require("./XPathHelper");
+/**
+ * Calculates cyclomatic complexity for Mule flows
+ *
+ * Complexity = 1 + (number of decision points)
+ *
+ * Decision points in Mule XML:
+ * - <choice> with N <when> clauses = N decision points
+ * - <until-successful> = 1 decision point
+ * - <foreach> = 1 decision point
+ * - <scatter-gather> = 1 decision point (parallel execution)
+ * - <try> = 1 decision point
+ */
+class ComplexityCalculator {
+    /**
+     * Calculate cyclomatic complexity for a flow element
+     */
+    static calculateFlowComplexity(flowNode) {
+        let complexity = 1; // Base complexity
+        const details = [];
+        // Count choice/when clauses
+        const whenClauses = this.selectNodes('.//mule:when', flowNode);
+        if (whenClauses.length > 0) {
+            complexity += whenClauses.length;
+            details.push({
+                type: 'choice/when',
+                count: whenClauses.length,
+                contribution: whenClauses.length
+            });
+        }
+        // Count until-successful
+        const untilSuccessful = this.selectNodes('.//mule:until-successful', flowNode);
+        if (untilSuccessful.length > 0) {
+            complexity += untilSuccessful.length;
+            details.push({
+                type: 'until-successful',
+                count: untilSuccessful.length,
+                contribution: untilSuccessful.length
+            });
+        }
+        // Count foreach
+        const foreach = this.selectNodes('.//mule:foreach', flowNode);
+        if (foreach.length > 0) {
+            complexity += foreach.length;
+            details.push({
+                type: 'foreach',
+                count: foreach.length,
+                contribution: foreach.length
+            });
+        }
+        // Count scatter-gather
+        const scatterGather = this.selectNodes('.//mule:scatter-gather', flowNode);
+        if (scatterGather.length > 0) {
+            complexity += scatterGather.length;
+            details.push({
+                type: 'scatter-gather',
+                count: scatterGather.length,
+                contribution: scatterGather.length
+            });
+        }
+        // Count try scopes
+        const tryScopes = this.selectNodes('.//mule:try', flowNode);
+        if (tryScopes.length > 0) {
+            complexity += tryScopes.length;
+            details.push({
+                type: 'try',
+                count: tryScopes.length,
+                contribution: tryScopes.length
+            });
+        }
+        // Count on-error handlers (each error type adds complexity)
+        const errorHandlers = this.selectNodes('.//mule:on-error-continue | .//mule:on-error-propagate', flowNode);
+        if (errorHandlers.length > 0) {
+            complexity += errorHandlers.length;
+            details.push({
+                type: 'error-handler',
+                count: errorHandlers.length,
+                contribution: errorHandlers.length
+            });
+        }
+        return {
+            complexity,
+            details,
+            rating: this.getRating(complexity)
+        };
+    }
+    /**
+     * Get complexity rating
+     */
+    static getRating(complexity) {
+        if (complexity <= 10)
+            return 'low';
+        if (complexity <= 20)
+            return 'moderate';
+        return 'high';
+    }
+    /**
+     * Helper to select nodes using XPath with Mule namespace
+     */
+    static selectNodes(xpath, contextNode) {
+        const select = require('xpath').useNamespaces({
+            'mule': 'http://www.mulesoft.org/schema/mule/core'
+        });
+        try {
+            const doc = contextNode.ownerDocument || contextNode;
+            return select(xpath, contextNode);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get the line number for a node
+     */
+    static getNodeLine(node) {
+        return (0, XPathHelper_1.getLineNumber)(node);
+    }
+}
+exports.ComplexityCalculator = ComplexityCalculator;
+//# sourceMappingURL=ComplexityCalculator.js.map

package/dist/src/core/ComplexityCalculator.js.map

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

package/dist/src/core/FileScanner.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Options for file scanning
+ */
+export interface ScanOptions {
+    /** Glob patterns for files to include */
+    include: string[];
+    /** Glob patterns for files to exclude */
+    exclude: string[];
+    /** Maximum depth to traverse */
+    maxDepth?: number;
+    /** Follow symbolic links */
+    followSymlinks?: boolean;
+}
+/**
+ * Default scan options for Mule projects
+ */
+export declare const DEFAULT_SCAN_OPTIONS: ScanOptions;
+/**
+ * Information about a scanned file
+ */
+export interface ScannedFile {
+    /** Absolute path to the file */
+    absolutePath: string;
+    /** Path relative to the scan root */
+    relativePath: string;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Scan a directory for XML files
+ *
+ * @param rootPath - Root directory to scan
+ * @param options - Scan options (include/exclude patterns)
+ * @returns Array of scanned file info
+ */
+export declare function scanDirectory(rootPath: string, options?: Partial<ScanOptions>): Promise<ScannedFile[]>;
+/**
+ * Synchronous version of scanDirectory
+ */
+export declare function scanDirectorySync(rootPath: string, options?: Partial<ScanOptions>): ScannedFile[];
+/**
+ * Read file content
+ */
+export declare function readFileContent(filePath: string): string;
+/**
+ * Check if file exists
+ */
+export declare function fileExists(filePath: string): boolean;
+/**
+ * Get the Mule project source directory
+ * Returns the path if it exists, null otherwise
+ */
+export declare function getMuleSourceDir(projectRoot: string): string | null;
+/**
+ * Get the resources directory
+ */
+export declare function getResourcesDir(projectRoot: string): string | null;
+//# sourceMappingURL=FileScanner.d.ts.map

package/dist/src/core/FileScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileScanner.d.ts","sourceRoot":"","sources":["../../../src/core/FileScanner.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WASlC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GACnC,OAAO,CAAC,WAAW,EAAE,CAAC,CAmCxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GACnC,WAAW,EAAE,CAmCf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE"}

package/dist/src/core/FileScanner.js

@@ -0,0 +1,161 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SCAN_OPTIONS = void 0;
+exports.scanDirectory = scanDirectory;
+exports.scanDirectorySync = scanDirectorySync;
+exports.readFileContent = readFileContent;
+exports.fileExists = fileExists;
+exports.getMuleSourceDir = getMuleSourceDir;
+exports.getResourcesDir = getResourcesDir;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+/**
+ * Default scan options for Mule projects
+ */
+exports.DEFAULT_SCAN_OPTIONS = {
+    include: ['**/*.xml'],
+    exclude: [
+        '**/target/**',
+        '**/node_modules/**',
+        '**/.git/**',
+        '**/*.munit.xml',
+    ],
+    followSymlinks: false,
+};
+/**
+ * Scan a directory for XML files
+ *
+ * @param rootPath - Root directory to scan
+ * @param options - Scan options (include/exclude patterns)
+ * @returns Array of scanned file info
+ */
+async function scanDirectory(rootPath, options = {}) {
+    const opts = { ...exports.DEFAULT_SCAN_OPTIONS, ...options };
+    const absoluteRoot = path.resolve(rootPath);
+    // Verify root exists and is a directory
+    if (!fs.existsSync(absoluteRoot)) {
+        throw new Error(`Path does not exist: ${absoluteRoot}`);
+    }
+    const stats = fs.statSync(absoluteRoot);
+    // If it's a single file, return just that file
+    if (stats.isFile()) {
+        return [{
+                absolutePath: absoluteRoot,
+                relativePath: path.basename(absoluteRoot),
+                size: stats.size,
+            }];
+    }
+    // Use fast-glob for directory scanning
+    const files = await (0, fast_glob_1.default)(opts.include, {
+        cwd: absoluteRoot,
+        absolute: true,
+        ignore: opts.exclude,
+        followSymbolicLinks: opts.followSymlinks,
+        onlyFiles: true,
+        deep: opts.maxDepth,
+    });
+    return files.map(filePath => ({
+        absolutePath: filePath,
+        relativePath: path.relative(absoluteRoot, filePath),
+        size: fs.statSync(filePath).size,
+    }));
+}
+/**
+ * Synchronous version of scanDirectory
+ */
+function scanDirectorySync(rootPath, options = {}) {
+    const opts = { ...exports.DEFAULT_SCAN_OPTIONS, ...options };
+    const absoluteRoot = path.resolve(rootPath);
+    // Verify root exists
+    if (!fs.existsSync(absoluteRoot)) {
+        throw new Error(`Path does not exist: ${absoluteRoot}`);
+    }
+    const stats = fs.statSync(absoluteRoot);
+    // If it's a single file, return just that file
+    if (stats.isFile()) {
+        return [{
+                absolutePath: absoluteRoot,
+                relativePath: path.basename(absoluteRoot),
+                size: stats.size,
+            }];
+    }
+    // Use fast-glob sync for directory scanning
+    const files = fast_glob_1.default.sync(opts.include, {
+        cwd: absoluteRoot,
+        absolute: true,
+        ignore: opts.exclude,
+        followSymbolicLinks: opts.followSymlinks,
+        onlyFiles: true,
+        deep: opts.maxDepth,
+    });
+    return files.map(filePath => ({
+        absolutePath: filePath,
+        relativePath: path.relative(absoluteRoot, filePath),
+        size: fs.statSync(filePath).size,
+    }));
+}
+/**
+ * Read file content
+ */
+function readFileContent(filePath) {
+    return fs.readFileSync(filePath, 'utf-8');
+}
+/**
+ * Check if file exists
+ */
+function fileExists(filePath) {
+    return fs.existsSync(filePath);
+}
+/**
+ * Get the Mule project source directory
+ * Returns the path if it exists, null otherwise
+ */
+function getMuleSourceDir(projectRoot) {
+    const muleDir = path.join(projectRoot, 'src', 'main', 'mule');
+    return fs.existsSync(muleDir) ? muleDir : null;
+}
+/**
+ * Get the resources directory
+ */
+function getResourcesDir(projectRoot) {
+    const resourcesDir = path.join(projectRoot, 'src', 'main', 'resources');
+    return fs.existsSync(resourcesDir) ? resourcesDir : null;
+}
+//# sourceMappingURL=FileScanner.js.map

package/dist/src/core/FileScanner.js.map

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

package/dist/src/core/XPathHelper.d.ts

@@ -0,0 +1,81 @@
+/**
+ * MuleSoft XML namespace mappings
+ * These are the standard namespaces used in Mule 4 applications
+ */
+export declare const MULE_NAMESPACES: Record<string, string>;
+/**
+ * Helper class for namespace-aware XPath queries on Mule XML documents
+ */
+export declare class XPathHelper {
+    private static instance;
+    private readonly select;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(customNamespaces?: Record<string, string>): XPathHelper;
+    /**
+     * Reset the singleton instance (useful for testing)
+     */
+    static reset(): void;
+    /**
+     * Execute XPath query and return matching nodes
+     * @param expression - XPath expression (can use namespace prefixes like mule:flow)
+     * @param context - Document or Node to query
+     * @returns Array of matching nodes
+     */
+    selectNodes(expression: string, context: Document | Node): Node[];
+    /**
+     * Execute XPath query and return first matching node
+     * @param expression - XPath expression
+     * @param context - Document or Node to query
+     * @returns First matching node or null
+     */
+    selectNode(expression: string, context: Document | Node): Node | null;
+    /**
+     * Execute XPath query and return string value
+     * @param expression - XPath expression
+     * @param context - Document or Node to query
+     * @returns String value or null
+     */
+    selectString(expression: string, context: Document | Node): string | null;
+    /**
+     * Check if any nodes match the XPath expression
+     * @param expression - XPath expression
+     * @param context - Document or Node to query
+     * @returns true if at least one node matches
+     */
+    exists(expression: string, context: Document | Node): boolean;
+    /**
+     * Count nodes matching the XPath expression
+     * @param expression - XPath expression
+     * @param context - Document or Node to query
+     * @returns Number of matching nodes
+     */
+    count(expression: string, context: Document | Node): number;
+}
+/**
+ * Utility functions for working with XML nodes
+ */
+export declare function getAttribute(node: Node, attrName: string): string | null;
+/**
+ * Get line number from a parsed node (xmldom stores this)
+ */
+export declare function getLineNumber(node: Node): number;
+/**
+ * Get column number from a parsed node
+ */
+export declare function getColumnNumber(node: Node): number | undefined;
+/**
+ * Check if a node has a specific attribute
+ */
+export declare function hasAttribute(node: Node, attrName: string): boolean;
+/**
+ * Get the local name of a node (without namespace prefix)
+ */
+export declare function getLocalName(node: Node): string;
+/**
+ * Get text content of a node
+ */
+export declare function getTextContent(node: Node): string;
+//# sourceMappingURL=XPathHelper.d.ts.map

package/dist/src/core/XPathHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XPathHelper.d.ts","sourceRoot":"","sources":["../../../src/core/XPathHelper.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6DlD,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C,OAAO;IAKP;;OAEG;WACW,WAAW,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW;IAOjF;;OAEG;WACW,KAAK,IAAI,IAAI;IAI3B;;;;;OAKG;IACI,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,EAAE;IAaxE;;;;;OAKG;IACI,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI;IAK5E;;;;;OAKG;IACI,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI;IAShF;;;;;OAKG;IACI,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO;IAIpE;;;;;OAKG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,MAAM;CAGrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAG/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEjD"}

package/dist/src/core/XPathHelper.js

@@ -0,0 +1,229 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XPathHelper = exports.MULE_NAMESPACES = void 0;
+exports.getAttribute = getAttribute;
+exports.getLineNumber = getLineNumber;
+exports.getColumnNumber = getColumnNumber;
+exports.hasAttribute = hasAttribute;
+exports.getLocalName = getLocalName;
+exports.getTextContent = getTextContent;
+const xpath = __importStar(require("xpath"));
+// DOM types from global lib.dom (used by @xmldom/xmldom)
+// Note: @xmldom/xmldom uses standard DOM interfaces
+/**
+ * MuleSoft XML namespace mappings
+ * These are the standard namespaces used in Mule 4 applications
+ */
+exports.MULE_NAMESPACES = {
+    // Core Mule
+    'mule': 'http://www.mulesoft.org/schema/mule/core',
+    // HTTP Connector
+    'http': 'http://www.mulesoft.org/schema/mule/http',
+    'https': 'http://www.mulesoft.org/schema/mule/https',
+    // DataWeave / EE
+    'ee': 'http://www.mulesoft.org/schema/mule/ee/core',
+    // Documentation
+    'doc': 'http://www.mulesoft.org/schema/mule/documentation',
+    // Security / TLS
+    'tls': 'http://www.mulesoft.org/schema/mule/tls',
+    'secure-properties': 'http://www.mulesoft.org/schema/mule/secure-properties',
+    // Database
+    'db': 'http://www.mulesoft.org/schema/mule/db',
+    // File connectors
+    'file': 'http://www.mulesoft.org/schema/mule/file',
+    'sftp': 'http://www.mulesoft.org/schema/mule/sftp',
+    'ftp': 'http://www.mulesoft.org/schema/mule/ftp',
+    // Messaging
+    'vm': 'http://www.mulesoft.org/schema/mule/vm',
+    'jms': 'http://www.mulesoft.org/schema/mule/jms',
+    'amqp': 'http://www.mulesoft.org/schema/mule/amqp',
+    // API
+    'apikit': 'http://www.mulesoft.org/schema/mule/mule-apikit',
+    'api-gateway': 'http://www.mulesoft.org/schema/mule/api-gateway',
+    // Object Store
+    'os': 'http://www.mulesoft.org/schema/mule/os',
+    // Batch
+    'batch': 'http://www.mulesoft.org/schema/mule/batch',
+    // Salesforce
+    'salesforce': 'http://www.mulesoft.org/schema/mule/salesforce',
+    // Email
+    'email': 'http://www.mulesoft.org/schema/mule/email',
+    // Validation
+    'validation': 'http://www.mulesoft.org/schema/mule/validation',
+    // Scripting
+    'scripting': 'http://www.mulesoft.org/schema/mule/scripting',
+    // Java
+    'java': 'http://www.mulesoft.org/schema/mule/java',
+    // Sockets
+    'sockets': 'http://www.mulesoft.org/schema/mule/sockets',
+    // Web Service Consumer
+    'wsc': 'http://www.mulesoft.org/schema/mule/wsc',
+};
+/**
+ * Helper class for namespace-aware XPath queries on Mule XML documents
+ */
+class XPathHelper {
+    static instance;
+    select;
+    constructor(customNamespaces) {
+        const namespaces = { ...exports.MULE_NAMESPACES, ...customNamespaces };
+        this.select = xpath.useNamespaces(namespaces);
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance(customNamespaces) {
+        if (!XPathHelper.instance) {
+            XPathHelper.instance = new XPathHelper(customNamespaces);
+        }
+        return XPathHelper.instance;
+    }
+    /**
+     * Reset the singleton instance (useful for testing)
+     */
+    static reset() {
+        XPathHelper.instance = undefined;
+    }
+    /**
+     * Execute XPath query and return matching nodes
+     * @param expression - XPath expression (can use namespace prefixes like mule:flow)
+     * @param context - Document or Node to query
+     * @returns Array of matching nodes
+     */
+    selectNodes(expression, context) {
+        try {
+            const result = this.select(expression, context);
+            if (Array.isArray(result)) {
+                return result;
+            }
+            return [];
+        }
+        catch (error) {
+            console.error(`XPath error for expression "${expression}":`, error);
+            return [];
+        }
+    }
+    /**
+     * Execute XPath query and return first matching node
+     * @param expression - XPath expression
+     * @param context - Document or Node to query
+     * @returns First matching node or null
+     */
+    selectNode(expression, context) {
+        const nodes = this.selectNodes(expression, context);
+        return nodes.length > 0 ? nodes[0] : null;
+    }
+    /**
+     * Execute XPath query and return string value
+     * @param expression - XPath expression
+     * @param context - Document or Node to query
+     * @returns String value or null
+     */
+    selectString(expression, context) {
+        try {
+            const result = this.select(`string(${expression})`, context);
+            return typeof result === 'string' && result.length > 0 ? result : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Check if any nodes match the XPath expression
+     * @param expression - XPath expression
+     * @param context - Document or Node to query
+     * @returns true if at least one node matches
+     */
+    exists(expression, context) {
+        return this.selectNodes(expression, context).length > 0;
+    }
+    /**
+     * Count nodes matching the XPath expression
+     * @param expression - XPath expression
+     * @param context - Document or Node to query
+     * @returns Number of matching nodes
+     */
+    count(expression, context) {
+        return this.selectNodes(expression, context).length;
+    }
+}
+exports.XPathHelper = XPathHelper;
+/**
+ * Utility functions for working with XML nodes
+ */
+function getAttribute(node, attrName) {
+    const element = node;
+    if (element.getAttribute) {
+        const value = element.getAttribute(attrName);
+        return value || null;
+    }
+    return null;
+}
+/**
+ * Get line number from a parsed node (xmldom stores this)
+ */
+function getLineNumber(node) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-return
+    return node.lineNumber ?? 1;
+}
+/**
+ * Get column number from a parsed node
+ */
+function getColumnNumber(node) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-return
+    return node.columnNumber;
+}
+/**
+ * Check if a node has a specific attribute
+ */
+function hasAttribute(node, attrName) {
+    const element = node;
+    return element.hasAttribute?.(attrName) ?? false;
+}
+/**
+ * Get the local name of a node (without namespace prefix)
+ */
+function getLocalName(node) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-return
+    return node.localName ?? node.nodeName;
+}
+/**
+ * Get text content of a node
+ */
+function getTextContent(node) {
+    return node.textContent ?? '';
+}
+//# sourceMappingURL=XPathHelper.js.map