digital-ai-testing-mcp 2.1.1 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/README.md +18 -13
  2. package/dist/api/webdriver.d.ts +61 -3
  3. package/dist/api/webdriver.d.ts.map +1 -1
  4. package/dist/api/webdriver.js +673 -33
  5. package/dist/api/webdriver.js.map +1 -1
  6. package/dist/index.js +1 -0
  7. package/dist/index.js.map +1 -1
  8. package/dist/tools/boilerplate-tools.d.ts +1 -1
  9. package/dist/tools/boilerplate-tools.d.ts.map +1 -1
  10. package/dist/tools/boilerplate-tools.js +217 -78
  11. package/dist/tools/boilerplate-tools.js.map +1 -1
  12. package/dist/tools/device-tools.d.ts +11 -0
  13. package/dist/tools/device-tools.d.ts.map +1 -1
  14. package/dist/tools/device-tools.js +25 -2
  15. package/dist/tools/device-tools.js.map +1 -1
  16. package/dist/tools/inspection-tools.d.ts.map +1 -1
  17. package/dist/tools/inspection-tools.js +219 -23
  18. package/dist/tools/inspection-tools.js.map +1 -1
  19. package/dist/tools/meta-tools.d.ts +1 -1
  20. package/dist/tools/meta-tools.d.ts.map +1 -1
  21. package/dist/tools/meta-tools.js +12 -1
  22. package/dist/tools/meta-tools.js.map +1 -1
  23. package/dist/tools/performance-tools.d.ts.map +1 -1
  24. package/dist/tools/performance-tools.js +6 -1
  25. package/dist/tools/performance-tools.js.map +1 -1
  26. package/dist/tools/reporting-tools.d.ts.map +1 -1
  27. package/dist/tools/reporting-tools.js +19 -1
  28. package/dist/tools/reporting-tools.js.map +1 -1
  29. package/dist/types/digital-ai.d.ts +10 -0
  30. package/dist/types/digital-ai.d.ts.map +1 -1
  31. package/dist/utils/test-orchestrator.d.ts +2 -0
  32. package/dist/utils/test-orchestrator.d.ts.map +1 -1
  33. package/dist/utils/test-orchestrator.js +2 -0
  34. package/dist/utils/test-orchestrator.js.map +1 -1
  35. package/package.json +3 -1
  36. package/resources/boilerplate/Android-Native/Java JUnit5/AndroidNative-oss-po.java +50 -0
  37. package/resources/boilerplate/Android-Native/Java JUnit5/AndroidNative-oss.java +23 -13
  38. package/resources/boilerplate/Android-Native/Java JUnit5/AndroidNative.java +19 -10
  39. package/resources/boilerplate/Android-Native/Java JUnit5/gradle-oss +4 -1
  40. package/resources/boilerplate/Android-Native/Java JUnit5/maven-oss +7 -1
  41. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/AndroidNative-po.js +13 -0
  42. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/AndroidNative.js +17 -11
  43. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/wdio-oss.conf.js +7 -2
  44. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/wdio.conf.js +10 -4
  45. package/resources/boilerplate/Android-Native/Python/AndroidNative-oss.py +30 -14
  46. package/resources/boilerplate/Android-Native/Python/AndroidNative.py +21 -5
  47. package/resources/boilerplate/Android-Native/Robot Framework/AndroidNative-oss.robot +28 -11
  48. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative-oss-po.java +50 -0
  49. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative-oss.java +23 -13
  50. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative.java +19 -10
  51. package/resources/boilerplate/Android-Native/java TestNG/gradle-oss +4 -1
  52. package/resources/boilerplate/Android-Native/java TestNG/maven-oss +7 -1
  53. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/iOSNative-po.js +13 -0
  54. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/iOSNative.js +17 -11
  55. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/wdio-oss.conf.js +4 -1
  56. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/wdio.conf.js +2 -0
  57. package/resources/boilerplate/iOS-Native/Python/iOSNative-oss.py +31 -14
  58. package/resources/boilerplate/iOS-Native/Python/iOSNative.py +36 -15
  59. package/resources/boilerplate/iOS-Native/Robot Framework/iOSNative-oss.robot +28 -11
  60. package/resources/boilerplate/iOS-Native/java-JUnit5/gradle-oss +4 -1
  61. package/resources/boilerplate/iOS-Native/java-JUnit5/iOSNative-oss-po.java +47 -0
  62. package/resources/boilerplate/iOS-Native/java-JUnit5/iOSNative-oss.java +24 -13
  63. package/resources/boilerplate/iOS-Native/java-JUnit5/iOSNative.java +21 -11
  64. package/resources/boilerplate/iOS-Native/java-JUnit5/maven-oss +7 -1
  65. package/resources/boilerplate/iOS-Native/java-TestNG/gradle-oss +4 -1
  66. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative-oss-po.java +47 -0
  67. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative-oss.java +24 -13
  68. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative.java +21 -11
  69. package/resources/boilerplate/iOS-Native/java-TestNG/maven-oss +7 -1
  70. package/resources/boilerplate/shared/java-screens/AppScreen.java +29 -0
  71. package/resources/boilerplate/shared/java-screens/BaseScreen.java +42 -0
  72. package/resources/boilerplate/shared/java-screens/DashboardScreen.java +18 -0
  73. package/resources/boilerplate/shared/java-screens/LoginScreen.java +23 -0
  74. package/resources/boilerplate/shared/java-screens/PaymentScreen.java +34 -0
  75. package/resources/boilerplate/shared/node-screens/AppScreen.js +27 -0
  76. package/resources/boilerplate/shared/node-screens/DashboardScreen.js +13 -0
  77. package/resources/boilerplate/shared/node-screens/LoginScreen.js +18 -0
  78. package/resources/boilerplate/shared/node-screens/PaymentScreen.js +28 -0
  79. package/resources/boilerplate/shared/node-screens/PlaceholderScreen.js +21 -0
@@ -0,0 +1,29 @@
1
+ package screens;
2
+
3
+ import io.appium.java_client.AppiumBy;
4
+ import io.appium.java_client.AppiumDriver;
5
+ import org.openqa.selenium.By;
6
+
7
+ /**
8
+ * ⛔ PLACEHOLDER SCREEN — the locators below are NOT real. Replace every <…> with a value captured from a live
9
+ * inspection (start_inspection_session -> get_element_tree / find_elements, or open_mobile_studio), rename the class to
10
+ * the screen it represents, and add one such class per screen. NEVER guess a resource-id or accessibility id.
11
+ */
12
+ public class AppScreen extends BaseScreen {
13
+ private final By primaryField = platform(By.id("<resource-id from get_element_tree>"), AppiumBy.accessibilityId("<accessibility id from get_element_tree>"));
14
+ private final By primaryButton = platform(By.id("<resource-id>"), AppiumBy.accessibilityId("<accessibility id>"));
15
+
16
+ public AppScreen(AppiumDriver driver) {
17
+ super(driver);
18
+ }
19
+
20
+ public AppScreen enterValue(String value) {
21
+ type(primaryField, value);
22
+ return this;
23
+ }
24
+
25
+ public AppScreen tapPrimaryButton() {
26
+ tap(primaryButton);
27
+ return this;
28
+ }
29
+ }
@@ -0,0 +1,42 @@
1
+ package screens;
2
+
3
+ import io.appium.java_client.AppiumDriver;
4
+ import org.openqa.selenium.By;
5
+ import org.openqa.selenium.WebElement;
6
+ import org.openqa.selenium.support.ui.ExpectedConditions;
7
+ import org.openqa.selenium.support.ui.WebDriverWait;
8
+
9
+ import java.time.Duration;
10
+
11
+ /**
12
+ * One class per screen. Every interaction waits explicitly for its element (no implicit wait anywhere), and each
13
+ * locator is chosen per platform at runtime, so one screen class serves the Android and the iOS build of the app.
14
+ * Screens return the next screen, so a test reads as the user flow: new LoginScreen(driver).login(..).makePayment()..
15
+ */
16
+ public abstract class BaseScreen {
17
+ protected final AppiumDriver driver;
18
+ protected final boolean android;
19
+
20
+ protected BaseScreen(AppiumDriver driver) {
21
+ this.driver = driver;
22
+ this.android = "android".equalsIgnoreCase(String.valueOf(driver.getCapabilities().getPlatformName()));
23
+ }
24
+
25
+ /** Pick the locator for the platform this session runs on. */
26
+ protected By platform(By androidLocator, By iosLocator) {
27
+ return android ? androidLocator : iosLocator;
28
+ }
29
+
30
+ /** Explicit wait (20 s) until the element is visible, then return it. Never mix with an implicit wait. */
31
+ protected WebElement find(By by) {
32
+ return new WebDriverWait(driver, Duration.ofSeconds(20)).until(ExpectedConditions.visibilityOfElementLocated(by));
33
+ }
34
+
35
+ protected void tap(By by) {
36
+ find(by).click();
37
+ }
38
+
39
+ protected void type(By by, String text) {
40
+ find(by).sendKeys(text);
41
+ }
42
+ }
@@ -0,0 +1,18 @@
1
+ package screens;
2
+
3
+ import io.appium.java_client.AppiumBy;
4
+ import io.appium.java_client.AppiumDriver;
5
+ import org.openqa.selenium.By;
6
+
7
+ public class DashboardScreen extends BaseScreen {
8
+ private final By makePaymentButton = platform(By.id("com.experitest.ExperiBank:id/makePaymentButton"), AppiumBy.accessibilityId("makePaymentButton"));
9
+
10
+ public DashboardScreen(AppiumDriver driver) {
11
+ super(driver);
12
+ }
13
+
14
+ public PaymentScreen makePayment() {
15
+ tap(makePaymentButton);
16
+ return new PaymentScreen(driver);
17
+ }
18
+ }
@@ -0,0 +1,23 @@
1
+ package screens;
2
+
3
+ import io.appium.java_client.AppiumBy;
4
+ import io.appium.java_client.AppiumDriver;
5
+ import org.openqa.selenium.By;
6
+
7
+ public class LoginScreen extends BaseScreen {
8
+ // Android: resource-id. iOS: accessibility id (= the element's name — identifier, else label).
9
+ private final By username = platform(By.id("com.experitest.ExperiBank:id/usernameTextField"), AppiumBy.accessibilityId("usernameTextField"));
10
+ private final By password = platform(By.id("com.experitest.ExperiBank:id/passwordTextField"), AppiumBy.accessibilityId("passwordTextField"));
11
+ private final By loginButton = platform(By.id("com.experitest.ExperiBank:id/loginButton"), AppiumBy.accessibilityId("loginButton"));
12
+
13
+ public LoginScreen(AppiumDriver driver) {
14
+ super(driver);
15
+ }
16
+
17
+ public DashboardScreen login(String user, String pass) {
18
+ type(username, user);
19
+ type(password, pass);
20
+ tap(loginButton);
21
+ return new DashboardScreen(driver);
22
+ }
23
+ }
@@ -0,0 +1,34 @@
1
+ package screens;
2
+
3
+ import io.appium.java_client.AppiumBy;
4
+ import io.appium.java_client.AppiumDriver;
5
+ import org.openqa.selenium.By;
6
+
7
+ public class PaymentScreen extends BaseScreen {
8
+ private final By phone = platform(By.id("com.experitest.ExperiBank:id/phoneTextField"), AppiumBy.accessibilityId("phoneTextField"));
9
+ private final By name = platform(By.id("com.experitest.ExperiBank:id/nameTextField"), AppiumBy.accessibilityId("nameTextField"));
10
+ private final By amount = platform(By.id("com.experitest.ExperiBank:id/amountTextField"), AppiumBy.accessibilityId("amountTextField"));
11
+ private final By countryButton = platform(By.id("com.experitest.ExperiBank:id/countryButton"), AppiumBy.accessibilityId("countryButton"));
12
+ private final By sendPaymentButton = platform(By.id("com.experitest.ExperiBank:id/sendPaymentButton"), AppiumBy.accessibilityId("sendPaymentButton"));
13
+ // The confirmation is a system dialog on Android (android:id/button1) and a named button on iOS.
14
+ private final By confirmYes = platform(By.id("android:id/button1"), AppiumBy.accessibilityId("Yes"));
15
+
16
+ public PaymentScreen(AppiumDriver driver) {
17
+ super(driver);
18
+ }
19
+
20
+ public PaymentScreen fillPayment(String phoneNumber, String payee, String amountValue, String country) {
21
+ type(phone, phoneNumber);
22
+ type(name, payee);
23
+ type(amount, amountValue);
24
+ tap(countryButton);
25
+ // Country list entry: visible text on Android, accessibility id (= label) on iOS.
26
+ tap(platform(By.xpath("//*[@text='" + country + "']"), AppiumBy.accessibilityId(country)));
27
+ return this;
28
+ }
29
+
30
+ public void sendAndConfirm() {
31
+ tap(sendPaymentButton);
32
+ tap(confirmYes);
33
+ }
34
+ }
@@ -0,0 +1,27 @@
1
+ // Base screen: every interaction waits explicitly (waitforTimeout in wdio.conf.js); locators are chosen per platform at
2
+ // runtime so one screen class serves the Android and the iOS build. Screens return the next screen.
3
+ class AppScreen {
4
+ constructor() {
5
+ this.isAndroid = browser.isAndroid;
6
+ }
7
+
8
+ platform(androidSelector, iosSelector) {
9
+ return this.isAndroid ? androidSelector : iosSelector;
10
+ }
11
+
12
+ async find(selector) {
13
+ const el = await $(selector);
14
+ await el.waitForDisplayed();
15
+ return el;
16
+ }
17
+
18
+ async tap(selector) {
19
+ await (await this.find(selector)).click();
20
+ }
21
+
22
+ async type(selector, text) {
23
+ await (await this.find(selector)).setValue(text);
24
+ }
25
+ }
26
+
27
+ module.exports = AppScreen;
@@ -0,0 +1,13 @@
1
+ const AppScreen = require('./AppScreen');
2
+ const PaymentScreen = require('./PaymentScreen');
3
+
4
+ class DashboardScreen extends AppScreen {
5
+ get makePaymentButton() { return this.platform('id=com.experitest.ExperiBank:id/makePaymentButton', '~makePaymentButton'); }
6
+
7
+ async makePayment() {
8
+ await this.tap(this.makePaymentButton);
9
+ return new PaymentScreen();
10
+ }
11
+ }
12
+
13
+ module.exports = DashboardScreen;
@@ -0,0 +1,18 @@
1
+ const AppScreen = require('./AppScreen');
2
+ const DashboardScreen = require('./DashboardScreen');
3
+
4
+ class LoginScreen extends AppScreen {
5
+ // Android: resource-id ("id=…"). iOS: accessibility id ("~…" = the element's name — identifier, else label).
6
+ get username() { return this.platform('id=com.experitest.ExperiBank:id/usernameTextField', '~usernameTextField'); }
7
+ get password() { return this.platform('id=com.experitest.ExperiBank:id/passwordTextField', '~passwordTextField'); }
8
+ get loginButton() { return this.platform('id=com.experitest.ExperiBank:id/loginButton', '~loginButton'); }
9
+
10
+ async login(user, pass) {
11
+ await this.type(this.username, user);
12
+ await this.type(this.password, pass);
13
+ await this.tap(this.loginButton);
14
+ return new DashboardScreen();
15
+ }
16
+ }
17
+
18
+ module.exports = LoginScreen;
@@ -0,0 +1,28 @@
1
+ const AppScreen = require('./AppScreen');
2
+
3
+ class PaymentScreen extends AppScreen {
4
+ get phone() { return this.platform('id=com.experitest.ExperiBank:id/phoneTextField', '~phoneTextField'); }
5
+ get name() { return this.platform('id=com.experitest.ExperiBank:id/nameTextField', '~nameTextField'); }
6
+ get amount() { return this.platform('id=com.experitest.ExperiBank:id/amountTextField', '~amountTextField'); }
7
+ get countryButton() { return this.platform('id=com.experitest.ExperiBank:id/countryButton', '~countryButton'); }
8
+ get sendPaymentButton() { return this.platform('id=com.experitest.ExperiBank:id/sendPaymentButton', '~sendPaymentButton'); }
9
+ // The confirmation is a system dialog on Android and a named button on iOS.
10
+ get confirmYes() { return this.platform('id=android:id/button1', '~Yes'); }
11
+
12
+ async fillPayment(phoneNumber, payee, amountValue, country) {
13
+ await this.type(this.phone, phoneNumber);
14
+ await this.type(this.name, payee);
15
+ await this.type(this.amount, amountValue);
16
+ await this.tap(this.countryButton);
17
+ // Country list entry: visible text on Android, accessibility id (= label) on iOS.
18
+ await this.tap(this.platform(`//*[@text="${country}"]`, `~${country}`));
19
+ return this;
20
+ }
21
+
22
+ async sendAndConfirm() {
23
+ await this.tap(this.sendPaymentButton);
24
+ await this.tap(this.confirmYes);
25
+ }
26
+ }
27
+
28
+ module.exports = PaymentScreen;
@@ -0,0 +1,21 @@
1
+ const AppScreen = require('./AppScreen');
2
+
3
+ // ⛔ PLACEHOLDER SCREEN — the selectors below are NOT real. Replace every <…> with a value captured from a live
4
+ // inspection (start_inspection_session -> get_element_tree / find_elements, or open_mobile_studio), rename the class to
5
+ // the screen it represents, and add one such class per screen. NEVER guess a resource-id or accessibility id.
6
+ class PlaceholderScreen extends AppScreen {
7
+ get primaryField() { return this.platform('id=<resource-id from get_element_tree>', '~<accessibility id from get_element_tree>'); }
8
+ get primaryButton() { return this.platform('id=<resource-id>', '~<accessibility id>'); }
9
+
10
+ async enterValue(value) {
11
+ await this.type(this.primaryField, value);
12
+ return this;
13
+ }
14
+
15
+ async tapPrimaryButton() {
16
+ await this.tap(this.primaryButton);
17
+ return this;
18
+ }
19
+ }
20
+
21
+ module.exports = PlaceholderScreen;