@testspectra/cli 1.1.7 → 1.1.8-rc.2

package/templates/default/specs/PermissionRationale/TC-0010-camera-permission-allow/spec.md

@@ -0,0 +1,22 @@
+---
+id: TC-0010-camera-permission-allow
+title: Confirm custom rationale dialog Allow triggers real permission request and grants camera access
+priority: High
+caseType: Positive
+status: ready-for-automation
+coverage:
+  web: unsupported
+  mobile: automated
+---
+
+# Confirm custom rationale dialog Allow triggers real permission request and grants camera access
+
+## Test Steps
+1. Navigate to the permission rationale demo route
+2. Assert the initial status is "Not requested"
+3. Click the request camera permission button
+4. Assert the custom rationale dialog appears
+5. Click Allow
+6. Grant the real camera permission on demand
+7. Assert the status becomes "Granted"
+8. Return to the home screen

package/templates/default/specs/PermissionRationale/TC-0011-camera-permission-deny/mobile.test.ts

@@ -0,0 +1,13 @@
+it("Confirm custom rationale dialog Deny never triggers the real permission request", async () => {
+  await Spectra.get("~nav-to-permission-demo").click();
+
+  await Spectra.get("~request-camera-permission-btn").click();
+  await Spectra.get("~rationale-deny-btn").shouldBeVisible();
+  await Spectra.get("~rationale-deny-btn").click();
+
+  // Deliberately never calls the real permission API — the status must reflect the custom
+  // dialog's own decision, not any OS-level request.
+  await Spectra.get("~permission-status-text").shouldHaveText("Declined in rationale dialog");
+
+  await Spectra.get("~back-to-home-btn").click();
+});

package/templates/default/specs/PermissionRationale/TC-0011-camera-permission-deny/spec.md

@@ -0,0 +1,20 @@
+---
+id: TC-0011-camera-permission-deny
+title: Confirm custom rationale dialog Deny never triggers the real permission request
+priority: High
+caseType: Negative
+status: ready-for-automation
+coverage:
+  web: unsupported
+  mobile: automated
+---
+
+# Confirm custom rationale dialog Deny never triggers the real permission request
+
+## Test Steps
+1. Navigate to the permission rationale demo route
+2. Click the request camera permission button
+3. Assert the custom rationale dialog appears
+4. Click Deny
+5. Assert the status reflects the dialog's own decision without any real permission request
+6. Return to the home screen

package/templates/default/specs/PermissionRationale/suite.md

@@ -0,0 +1,9 @@
+---
+id: suite-permission-rationale
+name: PermissionRationale
+description: Android runtime permission rationale dialog and on-demand Spectra.grantPermission()
+executionOrder: 2.0
+parallel: true
+---
+
+# Suite: PermissionRationale

package/templates/default/specs/Playground/TC-0001-form-controls/mobile.test.ts

@@ -1,6 +1,6 @@
-it("should verify live playground form inputs and default states (Mobile)", async () => {
-  await Step.verifyPlaygroundState();
-  await PlaygroundPage.emailInput.shouldHaveValue(Fixture.playgroundData.defaultEmail);
-  await PlaygroundPage.tokenInput.shouldContainValue("JWT_");
-  await PlaygroundPage.exactText.shouldHaveText(Fixture.playgroundData.welcomeText);
-});
+it("Verify playground form inputs and default states", async () => {
+  await Step.verifyPlaygroundState();
+  await PlaygroundPage.emailInput.shouldHaveValue(Fixture.playgroundData.defaultEmail);
+  await PlaygroundPage.tokenInput.shouldContainValue("JWT_");
+  await PlaygroundPage.exactText.shouldHaveText(Fixture.playgroundData.welcomeText);
+});

package/templates/default/specs/Playground/TC-0001-form-controls/spec.md

@@ -1,12 +1,18 @@
----
-id: TC-0001-form-controls
-title: Verify playground form inputs and default states
-priority: High
-caseType: Positive
-status: ready-for-automation
-coverage:
-  web: automated
-  mobile: automated
----
-
-# Verify playground form inputs and default states
+---
+id: TC-0001-form-controls
+title: Verify playground form inputs and default states
+priority: High
+caseType: Positive
+status: ready-for-automation
+coverage:
+  web: automated
+  mobile: automated
+---
+
+# Verify playground form inputs and default states
+
+## Test Steps
+1. @step:verifyPlaygroundState
+2. Verify playground email input has default email
+3. Verify token input contains JWT token
+4. Verify exact welcome text matches playground data

package/templates/default/specs/Playground/TC-0001-form-controls/web.test.ts

@@ -1,6 +1,6 @@
-it("should verify live playground form inputs and default states (Web)", async () => {
-  await Step.verifyPlaygroundState();
-  await PlaygroundPage.emailInput.shouldHaveValue(Fixture.playgroundData.defaultEmail);
-  await PlaygroundPage.tokenInput.shouldContainValue("JWT_");
-  await PlaygroundPage.exactText.shouldHaveText(Fixture.playgroundData.welcomeText);
-});
+it("Verify playground form inputs and default states", async () => {
+  await Step.verifyPlaygroundState();
+  await PlaygroundPage.emailInput.shouldHaveValue(Fixture.playgroundData.defaultEmail);
+  await PlaygroundPage.tokenInput.shouldContainValue("JWT_");
+  await PlaygroundPage.exactText.shouldHaveText(Fixture.playgroundData.welcomeText);
+});

package/templates/default/specs/Playground/TC-0002-toggle-elements/mobile.test.ts

@@ -1,6 +1,6 @@
-it("should update input values and verify updated state (Mobile)", async () => {
-  await PlaygroundPage.open();
-  await PlaygroundPage.fillCredentials("qa.expert@testspectra.dev", "JWT_custom_session_token");
-  await PlaygroundPage.emailInput.shouldHaveValue("qa.expert@testspectra.dev");
-  await PlaygroundPage.tokenInput.shouldContainValue("JWT_custom_session_token");
-});
+it("Verify typing credentials and updating playground inputs", async () => {
+  await PlaygroundPage.open();
+  await PlaygroundPage.fillCredentials("qa.expert@testspectra.dev", "JWT_custom_session_token");
+  await PlaygroundPage.emailInput.shouldHaveValue("qa.expert@testspectra.dev");
+  await PlaygroundPage.tokenInput.shouldContainValue("JWT_custom_session_token");
+});

package/templates/default/specs/Playground/TC-0002-toggle-elements/spec.md

@@ -1,12 +1,18 @@
----
-id: TC-0002-toggle-elements
-title: Verify typing credentials and updating playground inputs
-priority: High
-caseType: Positive
-status: ready-for-automation
-coverage:
-  web: automated
-  mobile: automated
----
-
-# Verify typing credentials and updating playground inputs
+---
+id: TC-0002-toggle-elements
+title: Verify typing credentials and updating playground inputs
+priority: High
+caseType: Positive
+status: ready-for-automation
+coverage:
+  web: automated
+  mobile: automated
+---
+
+# Verify typing credentials and updating playground inputs
+
+## Test Steps
+1. Open playground page
+2. Fill credentials into email and token input fields
+3. Verify email input contains updated email
+4. Verify token input contains updated session token

package/templates/default/specs/Playground/TC-0002-toggle-elements/web.test.ts

@@ -1,6 +1,6 @@
-it("should update input values and verify updated state (Web)", async () => {
-  await PlaygroundPage.open();
-  await PlaygroundPage.fillCredentials("qa.expert@testspectra.dev", "JWT_custom_session_token");
-  await PlaygroundPage.emailInput.shouldHaveValue("qa.expert@testspectra.dev");
-  await PlaygroundPage.tokenInput.shouldContainValue("JWT_custom_session_token");
-});
+it("Verify typing credentials and updating playground inputs", async () => {
+  await PlaygroundPage.open();
+  await PlaygroundPage.fillCredentials("qa.expert@testspectra.dev", "JWT_custom_session_token");
+  await PlaygroundPage.emailInput.shouldHaveValue("qa.expert@testspectra.dev");
+  await PlaygroundPage.tokenInput.shouldContainValue("JWT_custom_session_token");
+});

package/templates/default/spectra.config.ts

@@ -1,68 +1,52 @@
-import { defineConfig } from "@testspectra/cli";
-
-export default defineConfig({
-  webConfig: {
-    baseUrl: "http://localhost:5173",
-    maxConcurrentSessions: "1",
-    headless: true,
-    implicitWait: "5000",
-    pageLoadTimeout: "30000",
-    scriptTimeout: "30000",
-    parallelizationMode: "testcase",
-  },
-  browsers: [
-    {
-      id: "chrome-desktop",
-      type: "chrome",
-      mobileEmulation: false,
-    },
-  ],
-  androidConfig: {
-    driverServer: "tcp://127.0.0.1:8200",
-    appPackage: "dev.testspectra.demoapp",
-    appActivity: "dev.testspectra.demoapp.MainActivity",
-    autoGrantPermissions: true,
-    noReset: false,
-    implicitWait: "10000",
-    parallelizationMode: "suite",
-    devices: [
-      {
-        id: "emulator-5554",
-        name: "Pixel 8a Emulator",
-        version: "14.0",
-        systemPort: 8200,
-      },
-    ],
-  },
-  iosConfig: {
-    appiumServer: "http://127.0.0.1:4723",
-    automationName: "XCUITest",
-    bundleId: "",
-    autoAcceptAlerts: true,
-    noReset: false,
-    implicitWait: "10000",
-    parallelizationMode: "suite",
-    devices: [
-      {
-        id: "iphone-15-pro",
-        name: "iPhone 15 Pro Simulator",
-        version: "17.0",
-        udid: "auto",
-        wdaLocalPort: 8100,
-      },
-    ],
-  },
-  loadConfig: {
-    virtualUsers: "10",
-    duration: "1m",
-  },
-  loadStages: [],
-  thresholds: [],
-  executionConfig: {
-    networkMonitoringEnabled: true,
-    fastResponseTime: "200",
-    normalResponseTime: "1000",
-    monitoredDomains: [],
-    environmentVariables: [],
-  },
-});
+import { defineConfig } from "@testspectra/cli";
+
+export default defineConfig({
+  webConfig: {
+    baseUrl: "http://localhost:5173",
+    maxConcurrentSessions: "1",
+    headless: true,
+    implicitWait: "5000",
+    parallelizationMode: "testcase",
+  },
+  androidConfig: {
+    driverServer: "tcp://127.0.0.1:8200",
+    appPackage: "dev.testspectra.demoapp",
+    appActivity: "dev.testspectra.demoapp.MainActivity",
+    noReset: false,
+    implicitWait: "10000",
+    parallelizationMode: "suite",
+    devices: [
+      {
+        id: "emulator-5554",
+        name: "Pixel 8a Emulator",
+        version: "14.0",
+        systemPort: 8200,
+      },
+    ],
+  },
+  iosConfig: {
+    appiumServer: "http://127.0.0.1:4723",
+    automationName: "XCUITest",
+    bundleId: "",
+    autoAcceptAlerts: true,
+    noReset: false,
+    implicitWait: "10000",
+    parallelizationMode: "suite",
+    devices: [
+      {
+        id: "iphone-15-pro",
+        name: "iPhone 15 Pro Simulator",
+        version: "17.0",
+        udid: "auto",
+        wdaLocalPort: 8100,
+      },
+    ],
+  },
+  executionConfig: {
+    networkMonitoringEnabled: true,
+    fastResponseTime: "200",
+    normalResponseTime: "1000",
+    monitoredDomains: [],
+    environmentVariables: { DEMO_API_MODE: "sandbox" },
+  },
+});

package/templates/default/support/actions/fillCredentials/mobile.action.ts

@@ -1,4 +1,4 @@
-export default async function fillCredentials(this: any, email: string, token: string) {
-  await this.get("~email-input").type(email);
-  await this.get("~token-input").type(token);
-}
+export default async function (this: any, email: string, token: string) {
+  await this.get("~pg-email-input").type(email);
+  await this.get("~pg-token-input").type(token);
+}

package/templates/default/support/actions/fillCredentials/web.action.ts

@@ -1,4 +1,4 @@
-export default async function fillCredentials(this: any, email: string, token: string) {
-  await this.get("#demo-email-input-pg").type(email);
-  await this.get("#demo-token-input-pg").type(token);
-}
+export default async function (this: any, email: string, token: string) {
+  await this.get("#demo-email-input-pg").type(email);
+  await this.get("#demo-token-input-pg").type(token);
+}

package/templates/default/support/actions/seedSession/mobile.action.ts

@@ -0,0 +1,9 @@
+export default async function (this: any) {
+  // Android has no cookie jar to write into — the deep link asks the app to log itself in
+  // (a known, sanctioned test account, server-side) and persist the result through its own
+  // secure storage (e.g. react-native-keychain), the same way a real login would. See
+  // docs/v2/features/authentication-and-session-seeding.md for why this doesn't accept an
+  // externally-supplied session value the way the web action does.
+  await this.navigate("testspectra-demo://seed-session");
+  await this.get("~auth-status-badge").waitForElement(10000);
+}

package/templates/default/support/actions/seedSession/web.action.ts

@@ -0,0 +1,13 @@
+export default async function (this: any) {
+  // Host-side (Bun) fetch — not the browser's — so there's no CORS/credentials restriction on
+  // reading the raw Set-Cookie header, HttpOnly included.
+  const res = await fetch("http://localhost:5200/api/login", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ email: "demo@testspectra.dev", password: "demo-password" }),
+  });
+  if (!res.ok) {
+    throw new Error(`seedSession: login failed (${res.status})`);
+  }
+  await this.browser.setCookies(res.headers.getSetCookie(), res.url);
+}

package/templates/default/support/steps/togglePlaygroundStates/mobile.step.ts

@@ -1,5 +1,5 @@
-export default async function togglePlaygroundStates() {
-  await PlaygroundPage.open();
-  await PlaygroundPage.hiddenElement.shouldBeVisible();
-  await PlaygroundPage.existingElement.shouldExist();
-}
+export default async function () {
+  await PlaygroundPage.open();
+  await PlaygroundPage.hiddenElement.shouldBeVisible();
+  await PlaygroundPage.existingElement.shouldExist();
+}

package/templates/default/support/steps/togglePlaygroundStates/web.step.ts

@@ -1,5 +1,5 @@
-export default async function togglePlaygroundStates() {
-  await PlaygroundPage.open();
-  await PlaygroundPage.hiddenElement.shouldBeVisible();
-  await PlaygroundPage.existingElement.shouldExist();
-}
+export default async function () {
+  await PlaygroundPage.open();
+  await PlaygroundPage.hiddenElement.shouldBeVisible();
+  await PlaygroundPage.existingElement.shouldExist();
+}

package/templates/default/support/steps/verifyPlaygroundState/mobile.step.ts

@@ -1,6 +1,6 @@
-export default async function verifyPlaygroundState() {
-  await PlaygroundPage.open();
-  await PlaygroundPage.visibleElement.shouldBeVisible();
-  await PlaygroundPage.enabledButton.shouldBeEnabled();
-  await PlaygroundPage.termsCheckbox.shouldBeChecked();
-}
+export default async function () {
+  await PlaygroundPage.open();
+  await PlaygroundPage.visibleElement.shouldBeVisible();
+  await PlaygroundPage.enabledButton.shouldBeEnabled();
+  await PlaygroundPage.termsCheckbox.shouldBeChecked();
+}

package/templates/default/support/steps/verifyPlaygroundState/web.step.ts

@@ -1,6 +1,6 @@
-export default async function verifyPlaygroundState() {
-  await PlaygroundPage.open();
-  await PlaygroundPage.visibleElement.shouldBeVisible();
-  await PlaygroundPage.enabledButton.shouldBeEnabled();
-  await PlaygroundPage.termsCheckbox.shouldBeChecked();
-}
+export default async function () {
+  await PlaygroundPage.open();
+  await PlaygroundPage.visibleElement.shouldBeVisible();
+  await PlaygroundPage.enabledButton.shouldBeEnabled();
+  await PlaygroundPage.termsCheckbox.shouldBeChecked();
+}