appium-mcp 0.0.1 → 1.1.5

package/dist/locators/source-parsing.js

@@ -0,0 +1,100 @@
+import { DOMParser, MIME_TYPE, XMLSerializer, } from '@xmldom/xmldom';
+import _ from 'lodash';
+const domParser = new DOMParser();
+const xmlSerializer = new XMLSerializer();
+export const xmlToDOM = (string) => domParser.parseFromString(string, MIME_TYPE.XML_TEXT);
+export const domToXML = (dom) => xmlSerializer.serializeToString(dom);
+/**
+ * Get the child nodes of a Node object
+ *
+ * @param {XMLNode} domNode
+ * @returns {Array<XMLNode>} list of Nodes
+ */
+export function childNodesOf(domNode) {
+    if (!domNode?.hasChildNodes()) {
+        return [];
+    }
+    return _.filter(domNode.childNodes, ['nodeType', domNode.ELEMENT_NODE]);
+}
+/**
+ * Look up an element in the Document source using the provided path
+ *
+ * @param {string} path a dot-separated string of indices
+ * @param {XMLDocument} sourceDoc app source in Document format
+ * @returns {XMLNode} element node
+ */
+export function findDOMNodeByPath(path, sourceDoc) {
+    let selectedElement = childNodesOf(sourceDoc)[0] ||
+        (sourceDoc.documentElement
+            ? childNodesOf(sourceDoc.documentElement)[0]
+            : null);
+    if (!selectedElement) {
+        throw new Error('No element found in document');
+    }
+    for (const index of path.split('.')) {
+        selectedElement = childNodesOf(selectedElement)[parseInt(index, 10)];
+    }
+    return selectedElement;
+}
+/**
+ * Look up an element in the JSON source using the provided path
+ *
+ * @param {string} path a dot-separated string of indices
+ * @param {JSONElement} sourceJSON app source in JSON format
+ * @returns {JSONElement} element details in JSON format
+ */
+export function findJSONElementByPath(path, sourceJSON) {
+    let selectedElement = sourceJSON;
+    for (const index of path.split('.')) {
+        selectedElement = selectedElement.children[parseInt(index, 10)];
+    }
+    return { ...selectedElement };
+}
+/**
+ * Translates sourceXML to JSON
+ *
+ * @param {string} sourceXML
+ * @returns {JSONElement} source in JSON format
+ */
+export function xmlToJSON(sourceXML) {
+    const translateRecursively = (domNode, parentPath = '', index = null) => {
+        const attributes = {};
+        if (domNode.attributes) {
+            const elementNode = domNode;
+            for (let attrIdx = 0; attrIdx < elementNode.attributes.length; ++attrIdx) {
+                const attr = elementNode.attributes.item(attrIdx);
+                if (attr) {
+                    // it should be show new line character(\n) in GUI
+                    attributes[attr.name] = attr.value.replace(/(\n)/gm, '\\n');
+                }
+            }
+        }
+        // Dot Separated path of indices
+        const path = _.isNil(index)
+            ? ''
+            : `${!parentPath ? '' : parentPath + '.'}${index}`;
+        return {
+            children: childNodesOf(domNode).map((childNode, childIndex) => translateRecursively(childNode, path, childIndex)),
+            tagName: domNode.nodeName,
+            attributes,
+            path,
+        };
+    };
+    const sourceDoc = xmlToDOM(sourceXML);
+    // get the first child element node in the doc. some drivers write their xml differently so we
+    // first try to find an element as a direct descended of the doc, then look for one in
+    // documentElement
+    const firstChild = childNodesOf(sourceDoc)[0] ||
+        (sourceDoc.documentElement
+            ? childNodesOf(sourceDoc.documentElement)[0]
+            : null);
+    return firstChild
+        ? translateRecursively(firstChild)
+        : {
+            children: [],
+            tagName: '',
+            attributes: {},
+            path: '',
+        };
+}
+//# sourceMappingURL=source-parsing.js.map

package/dist/locators/source-parsing.js.map

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

package/dist/resources/index.d.ts

@@ -0,0 +1 @@
+export default function registerResources(server: any): void;

package/dist/resources/index.js

@@ -0,0 +1,7 @@
+// Export all resources
+import javaTemplatesResource from './java/template.js';
+export default function registerResources(server) {
+    javaTemplatesResource(server);
+    console.log('All resources registered');
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,qBAAqB,MAAM,oBAAoB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAW;IACnD,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAC1C,CAAC"}

package/dist/resources/java/template.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Resource for Java template files
+ */
+export default function javaTemplatesResource(server: any): void;

package/dist/resources/java/template.js

@@ -0,0 +1,82 @@
+/**
+ * Resource for Java template files
+ */
+export default function javaTemplatesResource(server) {
+    server.addResource({
+        uri: 'generate://code-with-locators',
+        name: 'Generate Code With Locators',
+        description: `Generate code for the current page with locators which was retrieved from generate_locators tool.
+    The code should be generated in the same priorty order as the locators were generated.
+    For iOS the priority order is:
+      'id',
+      'accessibility id',
+      '-ios predicate string',
+      '-ios class chain',
+      'xpath',
+      'class name',
+    For Android the priority order is:
+       'id',
+      'accessibility id',
+      'xpath',
+      '-android uiautomator',
+      'class name',
+    which follows the page factory pattern. Dont not strictly create test cases, just generate the code for locators.`,
+        mimeType: 'text/plain',
+        async load() {
+            // Return all content directly without templates object
+            return {
+                message: 'Java templates for mobile automation, use this and generate code for the current page',
+                instruction: 'Use these templates to generate code for the current page',
+                text: `
+package templates;
+
+import io.appium.java_client.AppiumDriver;
+import io.appium.java_client.pagefactory.AndroidFindBy;
+import io.appium.java_client.pagefactory.AppiumFieldDecorator;
+import io.appium.java_client.pagefactory.iOSXCUITFindBy;
+import org.openqa.selenium.WebElement;
+import org.openqa.selenium.support.PageFactory;
+
+import java.time.Duration;
+
+/**
+ * This class demonstrates using PageFactory with Appium for cross-platform
+ * mobile app locators using @AndroidFindBy and @iOSXCUITFindBy annotations.
+ * Example: 
+ */
+public class locators {
+
+    // ========== LOGIN SCREEN ELEMENTS ==========
+
+    /**
+     * Username input field
+     * - Android: accessibility id = "username_input"
+     * - iOS: accessibility id = "username_input"
+     */
+    @AndroidFindBy(accessibility = "username_input")
+    @iOSXCUITFindBy(accessibility = "username_input")
+    
+
+    public WebElement usernameField;
+
+    @iOSXCUITFindBy(iOSNsPredicate = "name = 'IntegerB'")
+    private WebElement textField2;
+
+    @iOSXCUITFindBy(iOSClassChain = "XCUIElementTypeWindow/*/XCUIElementTypeTextField[2]")
+    private WebElement secondTextField;
+
+    /**
+     * Constructor that initializes the PageFactory
+     * 
+     * @param driver AppiumDriver instance
+     */
+    public locators(AppiumDriver driver) {
+        PageFactory.initElements(new AppiumFieldDecorator(driver, Duration.ofSeconds(10)), this);
+    }
+}
+    `,
+            };
+        },
+    });
+}
+//# sourceMappingURL=template.js.map

package/dist/resources/java/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/resources/java/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,MAAW;IACvD,MAAM,CAAC,WAAW,CAAC;QACjB,GAAG,EAAE,+BAA+B;QACpC,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE;;;;;;;;;;;;;;;sHAeqG;QAClH,QAAQ,EAAE,YAAY;QACtB,KAAK,CAAC,IAAI;YACR,uDAAuD;YACvD,OAAO;gBACL,OAAO,EACL,uFAAuF;gBACzF,WAAW,EACT,2DAA2D;gBAC7D,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA+CT;aACE,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+import { z } from 'zod';
+export declare const elementUUIDScheme: z.ZodString;

package/dist/schema.js

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export const elementUUIDScheme = z
+    .string()
+    .describe('The uuid of the element returned by appium_find_element to click');
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,QAAQ,CAAC,kEAAkE,CAAC,CAAC"}

package/dist/scripts/simple-index-documentation.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Simple Documentation Indexing Script
+ *
+ * This script is a simplified version for indexing Markdown documents into an in-memory vector store
+ * using LangChain's RecursiveCharacterTextSplitter and MemoryVectorStore.
+ *
+ * Usage:
+ * - Index a single Markdown file: npm run simple-index-docs [markdownPath] [chunkSize] [overlap]
+ * - Index all Markdown files in a directory: npm run simple-index-docs [dirPath] [chunkSize] [overlap]
+ *
+ * Examples:
+ * - npm run simple-index-docs ./my-doc.md 1000 200
+ * - npm run simple-index-docs ./src/resources 1000 200
+ *
+ * If no path is provided, it defaults to indexing all Markdown files in the src/resources directory.
+ * If a file path is provided, it will index that specific file.
+ * If a directory path is provided, it will index all Markdown files in that directory.
+ */
+export {};

package/dist/scripts/simple-index-documentation.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * Simple Documentation Indexing Script
+ *
+ * This script is a simplified version for indexing Markdown documents into an in-memory vector store
+ * using LangChain's RecursiveCharacterTextSplitter and MemoryVectorStore.
+ *
+ * Usage:
+ * - Index a single Markdown file: npm run simple-index-docs [markdownPath] [chunkSize] [overlap]
+ * - Index all Markdown files in a directory: npm run simple-index-docs [dirPath] [chunkSize] [overlap]
+ *
+ * Examples:
+ * - npm run simple-index-docs ./my-doc.md 1000 200
+ * - npm run simple-index-docs ./src/resources 1000 200
+ *
+ * If no path is provided, it defaults to indexing all Markdown files in the src/resources directory.
+ * If a file path is provided, it will index that specific file.
+ * If a directory path is provided, it will index all Markdown files in that directory.
+ */
+import * as path from 'path';
+import * as fs from 'fs';
+import { indexMarkdown, indexAllMarkdownFiles, } from '../tools/documentation/simple-pdf-indexer.js';
+/**
+ * Main function to handle the documentation indexing process
+ */
+async function main() {
+    // Parse command line arguments
+    const args = process.argv.slice(2);
+    let markdownPath;
+    let chunkSize = 1000; // Default chunk size
+    let chunkOverlap = 200; // Default overlap
+    let indexSingleFile = false;
+    if (args.length > 0 && args[0]) {
+        markdownPath = path.resolve(process.cwd(), args[0]);
+        if (fs.existsSync(markdownPath) && fs.statSync(markdownPath).isFile()) {
+            indexSingleFile = true;
+            console.log(`Using provided file path: ${markdownPath}`);
+        }
+        else {
+            console.log(`Using provided directory path: ${markdownPath}`);
+        }
+    }
+    else {
+        // Default to submodules directory which contains the git submodules
+        markdownPath = path.resolve(process.cwd(), 'src/resources/submodules');
+        console.log(`Using default submodules directory: ${markdownPath}`);
+    }
+    if (args.length > 1 && !isNaN(Number(args[1]))) {
+        chunkSize = Number(args[1]);
+        console.log(`Using chunk size: ${chunkSize}`);
+    }
+    if (args.length > 2 && !isNaN(Number(args[2]))) {
+        chunkOverlap = Number(args[2]);
+        console.log(`Using overlap: ${chunkOverlap}`);
+    }
+    console.log('Using sentence-transformers embeddings (no API key required)');
+    console.log('Starting simplified documentation indexing process with in-memory vector store...');
+    try {
+        if (indexSingleFile) {
+            console.log(`Indexing single Markdown file: ${markdownPath}`);
+            await indexMarkdown(markdownPath, chunkSize, chunkOverlap);
+            console.log('Documentation indexing completed successfully');
+        }
+        else {
+            console.log(`Indexing all Markdown files in directory: ${markdownPath}`);
+            const indexedFiles = await indexAllMarkdownFiles(markdownPath, chunkSize, chunkOverlap);
+            console.log(`Documentation indexing completed successfully for ${indexedFiles.length} Markdown files`);
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Documentation indexing failed:', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=simple-index-documentation.js.map

package/dist/scripts/simple-index-documentation.js.map

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

package/dist/scripts/simple-query-documentation.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Simple Documentation Query Script
+ *
+ * This script is used to test the answerAppiumQuery function
+ * by querying the indexed Markdown documentation in the in-memory vector store.
+ *
+ * Usage: npm run simple-query-docs "your query here"
+ *
+ * Example: npm run simple-query-docs "What is Appium?"
+ */
+export {};

package/dist/scripts/simple-query-documentation.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * Simple Documentation Query Script
+ *
+ * This script is used to test the answerAppiumQuery function
+ * by querying the indexed Markdown documentation in the in-memory vector store.
+ *
+ * Usage: npm run simple-query-docs "your query here"
+ *
+ * Example: npm run simple-query-docs "What is Appium?"
+ */
+import { answerAppiumQuery } from '../tools/documentation/index.js';
+/**
+ * Main function to handle the documentation query process
+ */
+async function main() {
+    console.log('Using sentence-transformers embeddings (no API key required)');
+    console.log('Note: This script will return relevant documentation chunks without generating responses');
+    console.log('process.argv:', process.argv);
+    const args = process.argv.slice(2);
+    console.log('args:', args);
+    let query = '';
+    if (args.length > 0) {
+        query = args.join(' ');
+        console.log(`Using provided query: "${query}"`);
+    }
+    else {
+        query = 'What is Appium and how do I get started?';
+        console.log(`No query provided, using default query: "${query}"`);
+    }
+    console.log(`Querying in-memory vector store with: "${query}"`);
+    try {
+        const result = await answerAppiumQuery({
+            query,
+        });
+        console.log('\n--- ANSWER ---\n');
+        console.log(result.answer);
+        if (result.sources && result.sources.length > 0) {
+            console.log('\n--- SOURCES ---\n');
+            result.sources.forEach((source) => {
+                console.log(`- ${source}`);
+            });
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Query failed:', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=simple-query-documentation.js.map

package/dist/scripts/simple-query-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-query-documentation.js","sourceRoot":"","sources":["../../src/scripts/simple-query-documentation.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CACT,0FAA0F,CAC3F,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3B,IAAI,KAAK,GAAG,EAAE,CAAC;IAEf,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,0CAA0C,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,4CAA4C,KAAK,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,0CAA0C,KAAK,GAAG,CAAC,CAAC;IAEhE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;YACrC,KAAK;SACN,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAW,EAAE,EAAE;gBACrC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { FastMCP } from 'fastmcp';
+declare const server: FastMCP<undefined>;
+export default server;

package/dist/server.js

@@ -0,0 +1,37 @@
+import { FastMCP } from 'fastmcp';
+import registerTools from './tools/index.js';
+import registerResources from './resources/index.js';
+import { hasActiveSession, safeDeleteSession } from './tools/session-store.js';
+import log from './locators/logger.js';
+const server = new FastMCP({
+    name: 'MCP Appium',
+    version: '1.0.0',
+    instructions: 'Intelligent MCP server providing AI assistants with powerful tools and resources for Appium mobile automation',
+});
+registerResources(server);
+registerTools(server);
+// Handle client connection and disconnection events
+server.on('connect', event => {
+    log.info('Client connected:', event.session);
+});
+server.on('disconnect', async (event) => {
+    log.info('Client disconnected:', event.session);
+    // Only try to clean up if there's an active session
+    if (hasActiveSession()) {
+        try {
+            log.info('Active session detected on disconnect, cleaning up...');
+            const deleted = await safeDeleteSession();
+            if (deleted) {
+                log.info('Session cleaned up successfully on disconnect.');
+            }
+        }
+        catch (error) {
+            log.error('Error cleaning up session on disconnect:', error);
+        }
+    }
+    else {
+        log.info('No active session to clean up on disconnect.');
+    }
+});
+export default server;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,GAAG,MAAM,sBAAsB,CAAC;AAEvC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC;IACzB,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;IAChB,YAAY,EACV,+GAA+G;CAClH,CAAC,CAAC;AAEH,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,aAAa,CAAC,MAAM,CAAC,CAAC;AAEtB,oDAAoD;AACpD,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;IAC3B,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;IACpC,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,oDAAoD;IACpD,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAC;YAC1C,IAAI,OAAO,EAAE,CAAC;gBACZ,GAAG,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/dist/tests/__mocks__/@appium/support.d.ts

@@ -0,0 +1,21 @@
+export declare const logger: {
+    getLogger: (name: string) => {
+        debug: (message: string, ...args: any[]) => void;
+        info: (message: string, ...args: any[]) => void;
+        warn: (message: string, ...args: any[]) => void;
+        error: (message: string, ...args: any[]) => void;
+        trace: (message: string, ...args: any[]) => void;
+    };
+};
+declare const _default: {
+    logger: {
+        getLogger: (name: string) => {
+            debug: (message: string, ...args: any[]) => void;
+            info: (message: string, ...args: any[]) => void;
+            warn: (message: string, ...args: any[]) => void;
+            error: (message: string, ...args: any[]) => void;
+            trace: (message: string, ...args: any[]) => void;
+        };
+    };
+};
+export default _default;

package/dist/tests/__mocks__/@appium/support.js

@@ -0,0 +1,30 @@
+// Mock @appium/support for Jest tests
+// This avoids the ESM/CommonJS mismatch with uuid dependency
+export const logger = {
+    getLogger: (name) => {
+        // Simple logger implementation for tests
+        // No-op functions that match the logger interface
+        return {
+            debug: (message, ...args) => {
+                // Silent in tests by default
+            },
+            info: (message, ...args) => {
+                // Silent in tests by default
+            },
+            warn: (message, ...args) => {
+                // Silent in tests by default
+            },
+            error: (message, ...args) => {
+                // Silent in tests by default
+            },
+            trace: (message, ...args) => {
+                // Silent in tests by default
+            },
+        };
+    },
+};
+// Export other commonly used utilities from @appium/support if needed
+export default {
+    logger,
+};
+//# sourceMappingURL=support.js.map

package/dist/tests/__mocks__/@appium/support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support.js","sourceRoot":"","sources":["../../../../src/tests/__mocks__/@appium/support.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,6DAA6D;AAE7D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE;QAC1B,yCAAyC;QACzC,kDAAkD;QAClD,OAAO;YACL,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;gBACzC,6BAA6B;YAC/B,CAAC;YACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;gBACxC,6BAA6B;YAC/B,CAAC;YACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;gBACxC,6BAA6B;YAC/B,CAAC;YACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;gBACzC,6BAA6B;YAC/B,CAAC;YACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;gBACzC,6BAA6B;YAC/B,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,sEAAsE;AACtE,eAAe;IACb,MAAM;CACP,CAAC"}

package/dist/tests/generate-all-locators.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/generate-all-locators.test.js

@@ -0,0 +1,140 @@
+import { describe, test, expect } from '@jest/globals';
+import { generateAllElementLocators, } from '../locators/generate-all-locators.js';
+describe('generateAllElementLocators', () => {
+    // Sample XML for testing
+    const sampleXML = `
+    <hierarchy>
+      <android.widget.FrameLayout resource-id="android:id/content">
+        <android.widget.LinearLayout>
+          <android.widget.TextView text="Hello World" resource-id="com.example:id/text_view" clickable="true" enabled="true" displayed="true" />
+          <android.widget.Button text="Click Me" resource-id="com.example:id/button" clickable="true" enabled="true" displayed="true" />
+          <android.widget.EditText text="" resource-id="com.example:id/edit_text" clickable="true" enabled="true" displayed="true" />
+        </android.widget.LinearLayout>
+      </android.widget.FrameLayout>
+    </hierarchy>
+  `;
+    // Sample iOS XML for testing
+    const sampleIOSXML = `
+    <hierarchy>
+      <XCUIElementTypeApplication>
+        <XCUIElementTypeWindow>
+          <XCUIElementTypeButton name="Click Me" enabled="true" visible="true" />
+          <XCUIElementTypeTextField name="Enter text" enabled="true" visible="true" />
+          <XCUIElementTypeStaticText name="Hello World" enabled="true" visible="true" />
+        </XCUIElementTypeWindow>
+      </XCUIElementTypeApplication>
+    </hierarchy>
+  `;
+    test('should return an array when given valid XML', () => {
+        // Call the function with the sample XML
+        const result = generateAllElementLocators(sampleXML, true, 'uiautomator2');
+        // Basic validation of the result
+        expect(Array.isArray(result)).toBe(true);
+        expect(result.length).toBeGreaterThan(0);
+        // Verify the structure of the returned elements
+        if (result.length > 0) {
+            const element = result[0];
+            expect(element).toHaveProperty('tagName');
+            expect(element).toHaveProperty('locators');
+            expect(element).toHaveProperty('text');
+            expect(element).toHaveProperty('contentDesc');
+            expect(element).toHaveProperty('resourceId');
+            expect(element).toHaveProperty('clickable');
+            expect(element).toHaveProperty('enabled');
+            expect(element).toHaveProperty('displayed');
+        }
+    });
+    test('should return an empty array when given invalid XML', () => {
+        // Call the function with invalid XML (just a root element with no content)
+        const result = generateAllElementLocators('<hierarchy></hierarchy>', true, 'uiautomator2');
+        // Verify the result is an empty array or at least doesn't throw an error
+        expect(Array.isArray(result)).toBe(true);
+        expect(result.length).toBe(0);
+    });
+    test('should apply includeTagNames filter correctly', () => {
+        // Call the function with filters
+        const result = generateAllElementLocators(sampleXML, true, 'uiautomator2', {
+            includeTagNames: ['android.widget.Button'],
+        });
+        // If the filter works, either the result will be empty (if no buttons found)
+        // or all elements will be buttons
+        if (result.length > 0) {
+            expect(result.every(element => element.tagName.includes('Button'))).toBe(true);
+        }
+    });
+    test('should apply excludeTagNames filter correctly', () => {
+        // Call the function with excludeTagNames filter
+        const result = generateAllElementLocators(sampleXML, true, 'uiautomator2', {
+            excludeTagNames: ['android.widget.Button'],
+        });
+        // Verify no Button elements are included
+        expect(result.every(element => !element.tagName.includes('Button'))).toBe(true);
+    });
+    test('should apply minAttributeCount filter correctly', () => {
+        // Call the function with minAttributeCount filter
+        const result = generateAllElementLocators(sampleXML, true, 'uiautomator2', {
+            minAttributeCount: 3,
+        });
+        // All elements should have at least 3 attributes
+        if (result.length > 0) {
+            // We can't directly check the attributes count since we only have the processed elements
+            // But we can verify that elements with fewer attributes are filtered out
+            expect(result.length).toBeLessThanOrEqual(generateAllElementLocators(sampleXML, true, 'uiautomator2').length);
+        }
+    });
+    test('should handle fetchableOnly filter for Android', () => {
+        // Call the function with fetchableOnly filter
+        const result = generateAllElementLocators(sampleXML, true, 'uiautomator2', {
+            fetchableOnly: true,
+        });
+        // Verify the result contains only interactable elements
+        if (result.length > 0) {
+            const interactableTags = [
+                'EditText',
+                'Button',
+                'ImageButton',
+                'CheckBox',
+                'RadioButton',
+                'Switch',
+                'ToggleButton',
+                'TextView',
+            ];
+            expect(result.every(element => {
+                return (interactableTags.some(tag => element.tagName.includes(tag)) ||
+                    element.clickable === true);
+            })).toBe(true);
+        }
+    });
+    test('should handle fetchableOnly filter for iOS', () => {
+        // Call the function with fetchableOnly filter for iOS
+        const result = generateAllElementLocators(sampleIOSXML, true, 'xcuitest', {
+            fetchableOnly: true,
+        });
+        // Verify the result contains only interactable iOS elements
+        if (result.length > 0) {
+            const interactableTags = [
+                'XCUIElementTypeTextField',
+                'XCUIElementTypeSecureTextField',
+                'XCUIElementTypeButton',
+                'XCUIElementTypeImage',
+                'XCUIElementTypeSwitch',
+                'XCUIElementTypeStaticText',
+                'XCUIElementTypeTextView',
+                'XCUIElementTypeCell',
+                'XCUIElementTypeLink',
+            ];
+            expect(result.every(element => {
+                return interactableTags.some(tag => element.tagName.includes(tag));
+            })).toBe(true);
+        }
+    });
+    test('should handle clickableOnly filter correctly', () => {
+        // Call the function with clickableOnly filter
+        const result = generateAllElementLocators(sampleXML, true, 'uiautomator2', {
+            clickableOnly: true,
+        });
+        // Verify all elements are clickable
+        expect(result.every(element => element.clickable === true)).toBe(true);
+    });
+});
+//# sourceMappingURL=generate-all-locators.test.js.map