@sungen/driver-mobile 3.2.24-beta.5 → 3.2.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sungen/driver-mobile",
-  "version": "3.2.24-beta.5",
+  "version": "3.2.24",
   "description": "Sungen mobile platform driver (Appium / WebdriverIO) — gesture vocabulary, mobile selector strategies, viewpoint gate, and the WDIO runner. Plugs into @sun-asterisk/sungen via the capability SPI.",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -13,7 +13,7 @@
   "author": "eqe team (engineer & quality) — Sun Asterisk",
   "license": "MIT",
   "dependencies": {
-    "@sun-asterisk/sungen": "3.2.24-beta.5",
+    "@sun-asterisk/sungen": "3.2.24",
     "@wdio/appium-service": "^9.0.0",
     "@wdio/cli": "^9.0.0",
     "@wdio/local-runner": "^9.0.0",

package/src/index.ts

@@ -37,6 +37,10 @@ import type {
   GenerationUnit,
 } from '@sun-asterisk/sungen';
 import { gesturePatterns } from './patterns/gesture-patterns';
+import { lifecyclePatterns } from './patterns/lifecycle-patterns';
+import { devicePatterns } from './patterns/device-patterns';
+import { timingPatterns } from './patterns/timing-patterns';
+import { logPatterns } from './patterns/log-patterns';
 
 /** Surfaces universal-viewpoint theme gaps (low-priority reminder; does not move the score). */
 const mobileViewpointGateSensor: Sensor<GateInput> = {
@@ -71,6 +75,10 @@ export function register(registry: CapabilityRegistry): void {
     annotations: [],
     patterns: [
       ...gesturePatterns, // MOB-3: tap/double-tap + swipe/long-press/pinch/pull-to-refresh/rotate/… → appium templates
+      ...lifecyclePatterns, // #600: restart/reinstall the app (persistence oracles)
+      ...devicePatterns, // #600: airplane/wifi/data + location-services toggles (Android-only at runtime)
+      ...timingPatterns, // #600: disappears-within / still-visible-after windows
+      ...logPatterns, // #603: device-log oracle (silent failures / analytics)
     ],
     discovery: mobileDiscovery,
     contextMapper: mobileContextMapper,

package/src/patterns/device-patterns.ts

@@ -0,0 +1,70 @@
+/**
+ * Device-state step patterns — connectivity + location services (issue #600).
+ *
+ * Offline/airplane behavior and the location-permission matrices pivot on toggling device
+ * state mid-scenario. Android-only at runtime (`mobile: setConnectivity`,
+ * `toggleLocationServices` — verified against uiautomator2 7.6.2); the templates throw a
+ * named error on iOS instead of silently skipping (XCUITest has no such control).
+ */
+import { StepPattern } from '@sun-asterisk/sungen';
+
+/** `on|off` from the step text; defaults to `on` only when neither word appears (explicit wins). */
+function wantsOn(text: string): boolean {
+  if (/\boff\b/i.test(text)) return false;
+  return true;
+}
+
+export const devicePatterns: StepPattern[] = [
+  {
+    // `User turn airplane mode on` / `User turns wifi off` / `User turn mobile data off`.
+    // Keyed on the device noun + turn/enable/disable so it never collides with UI toggles
+    // (`tap [Wifi Switch]` carries a selectorRef and a tap verb).
+    name: 'set-connectivity',
+    matcher: (step) =>
+      /\b(airplane(?:\s+mode)?|wi-?fi|mobile\s+data)\b/i.test(step.text) &&
+      /\b(turn(s)?|enable(s)?|disable(s)?|switch(es)?)\b/i.test(step.text) &&
+      !step.selectorRef,
+    resolver: (step) => {
+      const text = step.text;
+      const isAirplane = /\bairplane\b/i.test(text);
+      const kind = isAirplane ? 'airplane mode' : /\bwi-?fi\b/i.test(text) ? 'wifi' : 'mobile data';
+      const kindKey = kind === 'mobile data' ? 'data' : 'wifi'; // non-airplane arg name for mobile: setConnectivity
+      const on = /\bdisable(s)?\b/i.test(text) ? false : wantsOn(text);
+      return {
+        templateName: 'set-connectivity-action',
+        data: { kind, kindKey, isAirplane, on },
+        comment: `Turn ${kind} ${on ? 'on' : 'off'}`,
+      };
+    },
+    priority: 16,
+  },
+  {
+    // `User turn device location on|off` / `User disable location services`. Distinct from
+    // `set-geolocation` (set/mock/simulate coordinates) — this toggles the SERVICE.
+    name: 'location-services',
+    matcher: (step) =>
+      /\b(device\s+location|location\s+services?)\b/i.test(step.text) &&
+      /\b(turn(s)?|enable(s)?|disable(s)?|switch(es)?)\b/i.test(step.text) &&
+      !step.selectorRef,
+    resolver: (step) => {
+      const on = /\bdisable(s)?\b/i.test(step.text) ? false : wantsOn(step.text);
+      return { templateName: 'location-services-action', data: { on }, comment: `Turn device location ${on ? 'on' : 'off'}` };
+    },
+    priority: 16,
+  },
+  {
+    // `User pass|fail biometric authentication` — simulated biometric input on emulator/simulator
+    // (#603). Face wording (`face id`) selects the iOS faceId type; Android is fingerprint-only.
+    name: 'biometric-auth',
+    matcher: (step) =>
+      /\b(biometric|fingerprint|face\s?id|touch\s?id)\b/i.test(step.text) &&
+      /\b(pass(es)?|fail(s)?|match(es)?|reject(s)?)\b/i.test(step.text) &&
+      !step.selectorRef,
+    resolver: (step) => {
+      const match = !/\b(fail(s)?|reject(s)?)\b/i.test(step.text);
+      const faceId = /\bface\s?id\b/i.test(step.text);
+      return { templateName: 'biometric-action', data: { match, faceId }, comment: `${match ? 'Pass' : 'Fail'} biometric authentication` };
+    },
+    priority: 16,
+  },
+];

package/src/patterns/lifecycle-patterns.ts

@@ -0,0 +1,41 @@
+/**
+ * App-lifecycle step patterns — restart / reinstall (issue #600).
+ *
+ * Persistence oracles (pinned card, banner dismiss, tooltip show-once, recent-services
+ * migration) pivot on kill→relaunch and reinstall; both were only expressible as
+ * `@manual:M7` before. `background app for N seconds` already lives in gesture-patterns.
+ * Mobile-only: on a web project these hit the missing-template guard (SG-E020) and fail
+ * loud, same policy as every gesture.
+ */
+import { StepPattern } from '@sun-asterisk/sungen';
+
+export const lifecyclePatterns: StepPattern[] = [
+  {
+    // `User restart the app` / `User restarts the app`. Must NOT match when a selectorRef is
+    // present — `tap [Restart Button]` belongs to the tap pattern, not here.
+    name: 'restart-app',
+    matcher: (step) => /\brestart(s)?\b/i.test(step.text) && /\bapp\b/i.test(step.text) && !step.selectorRef,
+    resolver: () => ({ templateName: 'restart-app-action', data: {}, comment: 'Restart the app (kill → relaunch → settle)' }),
+    priority: 16,
+  },
+  {
+    // `User reinstall the app` — needs the session to have installed from a build file
+    // (appium:app); the template fails loud with the fix when the cap is absent.
+    name: 'reinstall-app',
+    matcher: (step) => /\bre-?install(s)?\b/i.test(step.text) && /\bapp\b/i.test(step.text) && !step.selectorRef,
+    resolver: () => ({ templateName: 'reinstall-app-action', data: {}, comment: 'Reinstall the app (remove → install → launch)' }),
+    priority: 16,
+  },
+  {
+    // `User open deep link {{url}}` (or a quoted literal) — routes the app via a VIEW intent /
+    // XCUITest deepLink. THE entry for push-param / universal-link routing matrices (#603).
+    name: 'open-deep-link',
+    matcher: (step) => /\bdeep\s?-?link\b/i.test(step.text) && (!!step.dataRef || step.value != null) && !step.selectorRef,
+    resolver: (step) => ({
+      templateName: 'deep-link-action',
+      data: { dataRef: step.dataRef, url: step.value },
+      comment: `Open deep link ${step.dataRef ? `{{${step.dataRef}}}` : step.value}`,
+    }),
+    priority: 16,
+  },
+];

package/src/patterns/log-patterns.ts

@@ -0,0 +1,27 @@
+/**
+ * Device-log assertion pattern (issue #603).
+ *
+ * Makes SILENT failure modes and analytics observable: many mobile specs define behaviors whose
+ * only trace is a log line (fetch-failure-silent rules, analytics screen names). Android reads
+ * logcat, iOS syslog. Mobile-only — web projects hit SG-E020, same policy as the gestures.
+ */
+import { StepPattern } from '@sun-asterisk/sungen';
+
+export const logPatterns: StepPattern[] = [
+  {
+    // `Then User see device log contains {{v}}` / `… contains "literal"`. No selectorRef — the
+    // element-scoped `contains` assertions all carry one, so there is no collision.
+    name: 'device-log-contains',
+    matcher: (step) =>
+      /\b(device\s+)?logs?\b/i.test(step.text) &&
+      /\bcontains?\b/i.test(step.text) &&
+      (!!step.dataRef || step.value != null) &&
+      !step.selectorRef,
+    resolver: (step) => ({
+      templateName: 'device-log-assertion',
+      data: { dataRef: step.dataRef, value: step.value },
+      comment: `Assert device log contains ${step.dataRef ? `{{${step.dataRef}}}` : step.value}`,
+    }),
+    priority: 17,
+  },
+];

package/src/patterns/timing-patterns.ts

@@ -0,0 +1,43 @@
+/**
+ * Timing-window assertion patterns (issue #600).
+ *
+ * Auto-dismiss (~5s tooltip/popup) and validity-window (60s barcode) oracles: the DSL only
+ * had appear-waits. Priority 18 — these must outrank the generic visible/hidden assertions,
+ * whose matchers would otherwise swallow the `see [X] …` prefix.
+ */
+import { StepPattern } from '@sun-asterisk/sungen';
+
+const SECONDS = /(\d+)\s*seconds?\b/i;
+
+export const timingPatterns: StepPattern[] = [
+  {
+    // `Then User see [X] disappear within 5 seconds` — the element must vanish inside the window.
+    name: 'disappears-within',
+    matcher: (step) => /\bdisappears?\b/i.test(step.text) && /\bwithin\b/i.test(step.text) && SECONDS.test(step.text) && !!step.selectorRef,
+    resolver: (step, context) => {
+      const resolved = context.selectorResolver.resolveSelector(step.selectorRef!, context.featureName, step.elementType, step.nth);
+      const seconds = parseInt(step.text.match(SECONDS)![1], 10);
+      return {
+        templateName: 'disappears-within-assertion',
+        data: { ...resolved, seconds, selectorRef: step.selectorRef },
+        comment: `Assert ${step.selectorRef} disappears within ${seconds}s`,
+      };
+    },
+    priority: 18,
+  },
+  {
+    // `Then User see [X] still visible after 3 seconds` — the element must survive the window.
+    name: 'still-visible-after',
+    matcher: (step) => /\bstill\s+visible\s+after\b/i.test(step.text) && SECONDS.test(step.text) && !!step.selectorRef,
+    resolver: (step, context) => {
+      const resolved = context.selectorResolver.resolveSelector(step.selectorRef!, context.featureName, step.elementType, step.nth);
+      const seconds = parseInt(step.text.match(SECONDS)![1], 10);
+      return {
+        templateName: 'still-visible-after-assertion',
+        data: { ...resolved, seconds, selectorRef: step.selectorRef },
+        comment: `Assert ${step.selectorRef} still visible after ${seconds}s`,
+      };
+    },
+    priority: 18,
+  },
+];