@purchasely/cordova-plugin-purchasely 6.0.0-rc.3 → 6.0.0

package/example/IOS_8_1_1_TEST_MATRIX.md

@@ -0,0 +1,25 @@
+# cordova-ios 8.1.1 Manual Test Matrix
+
+Run this matrix on a physical iOS device or a StoreKit-configured simulator after:
+
+```bash
+cd purchasely/example
+./ios.sh
+cordova run ios --device
+```
+
+Use a Purchasely project with a presentation, a purchasable product, and a restorable
+purchase. Capture the app logs and the callback payloads for every row.
+
+| Scenario | Steps | Expected result |
+| --- | --- | --- |
+| Presentation | Trigger the sample presentation. | The configured presentation is displayed using the requested transition. |
+| Purchase | Select a product and complete the StoreKit purchase. | The StoreKit sheet completes, the purchase callback receives the Purchasely outcome, and the active entitlement is updated. |
+| Restore | Use the sample restore action with a previously purchased account. | The restore callback completes and the restored entitlement is available. |
+| Close | Dismiss the presentation through its close control and, separately, through the system back/dismiss gesture when enabled. | The close callback fires once per dismissal with the matching close reason; the final presentation outcome is delivered. |
+| JavaScript callbacks | Repeat presentation, purchase, restore, and close while logging every success, failure, presented, and close-requested callback. | Each callback is received on the JavaScript bridge with its expected payload and no duplicate terminal callback. |
+| Background and foreground | Show a presentation or StoreKit sheet, send the app to the background, then return it to the foreground. | The app remains responsive, the visible flow resumes or completes according to StoreKit, and no callback is lost or duplicated. |
+
+This matrix is runtime validation only. The CI job verifies deterministic installation,
+CocoaPods workspace build, and an unsigned archive; it cannot validate StoreKit or
+backend-configured presentation behavior.

package/example/e2e/README.md

@@ -16,8 +16,8 @@ Cordova imperative API. They are **not** part of the PR-gating `ci.yml`; they ru
 
 | Suite | File | Gate | Notes |
 |-------|------|------|-------|
-| bridge | `specs/bridge.e2e.js` | **hard** | anonymous id, allProducts, fetchPresentationForPlacement, synchronize completion, user-attribute round-trip |
-| dismiss | `specs/dismiss.e2e.js` | best-effort | present placement + programmatic close → dismiss outcome + `closeReason` (needs a paywall to render) |
+| bridge | `specs/bridge.e2e.js` | **hard** | anonymous id, allProducts, fetchPresentationForPlacement, synchronize completion, user-attribute round-trip (string/int/boolean), userSubscriptions |
+| dismiss | `specs/dismiss.e2e.js` | best-effort | present placement or default presentation + programmatic close → dismiss outcome + `closeReason` (needs a paywall to render) |
 
 Best-effort suites emit `::warning::` on failure and do not fail the job (native/paywall
 rendering is flaky in CI — same policy as the Flutter suite). Each suite retries up to 3×.

package/example/e2e/helpers/driver.js

@@ -32,24 +32,40 @@ async function waitForPurchaselyReady() {
   );
 }
 
+// Poll a window global until a native callback has populated it, then return it.
+// Resolves { ok:false, error:'timeout' } if nothing arrives in time. We poll a SYNC
+// execute rather than use executeAsync because the iOS WKWebView aborts async-script
+// results almost immediately ("Timed out waiting for asynchronous script result"),
+// which would fail every bridge call on iOS.
+async function pollGlobal(name, timeoutMs) {
+  let value;
+  try {
+    await browser.waitUntil(
+      async () => {
+        value = await browser.execute(function (n) { return window[n]; }, name);
+        return value !== undefined && value !== null;
+      },
+      { timeout: timeoutMs, interval: 250, timeoutMsg: name + ' never settled' }
+    );
+  } catch (e) {
+    return { ok: false, error: 'timeout' };
+  }
+  return value;
+}
+
 // Invoke a Purchasely method that takes trailing (success, error) callbacks and resolve
 // with { ok, value } on success or { ok:false, error } on error. `args` are the leading
-// positional arguments before the callbacks.
+// positional arguments before the callbacks. Fires via a sync execute that stashes the
+// settled result on window.__plyResult, then polls for it (see pollGlobal).
 async function callBridge(method, args = [], timeoutMs = 30000) {
-  return browser.executeAsync(
-    function (method, args, timeoutMs, done) {
+  await browser.execute(
+    function (method, args) {
+      window.__plyResult = undefined;
       var settled = false;
-      var finish = function (payload) {
-        if (settled) return;
-        settled = true;
-        done(payload);
-      };
-      setTimeout(function () { finish({ ok: false, error: 'timeout' }); }, timeoutMs);
+      var finish = function (payload) { if (!settled) { settled = true; window.__plyResult = payload; } };
       try {
         var fn = window.Purchasely[method];
-        if (typeof fn !== 'function') {
-          return finish({ ok: false, error: 'no such method: ' + method });
-        }
+        if (typeof fn !== 'function') { finish({ ok: false, error: 'no such method: ' + method }); return; }
         fn.apply(
           window.Purchasely,
           args.concat([
@@ -57,14 +73,115 @@ async function callBridge(method, args = [], timeoutMs = 30000) {
             function (error) { finish({ ok: false, error: String(error) }); },
           ])
         );
-      } catch (e) {
-        finish({ ok: false, error: String(e) });
-      }
+      } catch (e) { finish({ ok: false, error: String(e) }); }
     },
     method,
-    args,
-    timeoutMs
+    args
+  );
+  return pollGlobal('__plyResult', timeoutMs);
+}
+
+// Fire a void Purchasely method that takes NO success callback — the
+// setUserAttributeWith* setters are fire-and-forget on the Cordova bridge
+// (exec(() => {}, defaultError, ...)). callBridge would hang waiting for a success
+// callback these never invoke, so dispatch the call and resolve immediately.
+async function fireBridge(method, args = []) {
+  await browser.execute(
+    function (method, args) {
+      var fn = window.Purchasely[method];
+      if (typeof fn === 'function') fn.apply(window.Purchasely, args);
+    },
+    method,
+    args
+  );
+}
+
+// Drive the v6 presentation builder (Purchasely.presentation) from WEBVIEW context and
+// resolve with { ok, value } / { ok:false, error } -- same contract as callBridge, since
+// fetchPresentation*/presentPresentation* (and their (args..., success, error) shape that
+// callBridge drives) were removed in favor of the promise-based builder.
+// `source` is 'placement' | 'screen' | 'defaultSource'; `sourceId` is the placement/screen
+// id (omit for 'defaultSource'); `action` is 'preload' or 'display'; `transition` is passed
+// to display() when action is 'display'. Stashes the built request on
+// `window.__plyLastRequest` so a follow-up closeCurrentPresentation()/backCurrentPresentation()
+// call in the same test can drive it (mirrors closePresentation()/backPresentation() acting
+// on the natively-tracked current presentation pre-builder).
+async function callPresentation(source, sourceId, action, transition, timeoutMs = 90000) {
+  await browser.execute(
+    function (source, sourceId, action, transition) {
+      window.__plyResult = undefined;
+      var settled = false;
+      var finish = function (payload) { if (!settled) { settled = true; window.__plyResult = payload; } };
+      try {
+        var builder = sourceId
+          ? window.Purchasely.presentation[source](sourceId)
+          : window.Purchasely.presentation[source]();
+        var request = builder.build();
+        window.__plyLastRequest = request;
+        var promise = action === 'preload' ? request.preload() : request.display(transition);
+        promise.then(
+          function (value) { finish({ ok: true, value: value }); },
+          function (error) { finish({ ok: false, error: String(error) }); }
+        );
+      } catch (e) { finish({ ok: false, error: String(e) }); }
+    },
+    source,
+    sourceId,
+    action,
+    transition
   );
+  return pollGlobal('__plyResult', timeoutMs);
+}
+
+// Display a presentation and stash its dismiss outcome on a window global, WITHOUT
+// blocking the WebDriver session. callPresentation() drives display() inside a single
+// executeAsync that only settles at dismiss — but the session is then busy, so the
+// follow-up close() command can never run (deadlock -> script timeout). Fire display()
+// fire-and-forget instead and poll the outcome via awaitDismissOutcome(); the session
+// stays free to send closeCurrentPresentation() in between.
+async function displayPresentation(source, sourceId, transition) {
+  await browser.execute(
+    function (source, sourceId, transition) {
+      window.__plyOutcome = undefined;
+      var builder = sourceId
+        ? window.Purchasely.presentation[source](sourceId)
+        : window.Purchasely.presentation[source]();
+      var request = builder.build();
+      window.__plyLastRequest = request;
+      request.display(transition).then(
+        function (v) { window.__plyOutcome = { ok: true, value: v }; },
+        function (e) { window.__plyOutcome = { ok: false, error: String(e) }; }
+      );
+    },
+    source,
+    sourceId,
+    transition
+  );
+}
+
+// Poll for the dismiss outcome stashed by displayPresentation(). Resolves { ok, value } /
+// { ok:false, error } once display()'s promise settles (i.e. after close()), or
+// { ok:false, error:'timeout' } if no outcome arrives in time.
+async function awaitDismissOutcome(timeoutMs = 30000) {
+  return pollGlobal('__plyOutcome', timeoutMs);
+}
+
+// Close the presentation driven by the last callPresentation()/displayPresentation()
+// request (WEBVIEW context).
+async function closeCurrentPresentation() {
+  return browser.execute(function () {
+    if (window.__plyLastRequest) window.__plyLastRequest.close();
+  });
 }
 
-module.exports = { switchToWebview, switchToNative, waitForPurchaselyReady, callBridge };
+module.exports = {
+  switchToWebview,
+  switchToNative,
+  waitForPurchaselyReady,
+  callBridge,
+  fireBridge,
+  callPresentation,
+  displayPresentation,
+  awaitDismissOutcome,
+  closeCurrentPresentation,
+};

package/example/e2e/specs/bridge.e2e.js

@@ -1,7 +1,7 @@
 // Deterministic Dart<->native bridge assertions (no native taps). HARD gate — these
 // must pass. Mirrors the Flutter E2E_TEST_INDEX suite T1/T3/T5/T6 adapted to the
 // Cordova imperative API.
-const { waitForPurchaselyReady, callBridge } = require('../helpers/driver');
+const { waitForPurchaselyReady, callBridge, fireBridge, callPresentation } = require('../helpers/driver');
 
 const PLACEMENT = process.env.PURCHASELY_E2E_PLACEMENT || 'ONBOARDING';
 
@@ -18,20 +18,33 @@ describe('Purchasely bridge (WEBVIEW context)', () => {
     expect(res.value.length).toBeGreaterThan(0);
   });
 
-  // T5 — catalog
+  // T5 — catalog. Store-dependent: the iOS simulator has no StoreKit products configured,
+  // so allProducts settles as a clean error there while the Android emulator (Google
+  // Billing) returns a list. Assert the bridge round-trips cleanly either way.
   it('allProducts returns a list', async () => {
     const res = await callBridge('allProducts');
-    expect(res.ok).toBe(true);
-    expect(Array.isArray(res.value)).toBe(true);
+    if (res.ok) {
+      expect(Array.isArray(res.value)).toBe(true);
+    } else {
+      expect(typeof res.error).toBe('string');
+    }
   });
 
-  // T3 — preload a presentation for a placement
-  it('fetchPresentationForPlacement returns a presentation object', async () => {
-    const res = await callBridge('fetchPresentationForPlacement', [PLACEMENT, null]);
-    expect(res.ok).toBe(true);
-    expect(res.value).toBeDefined();
-    // v6 presentation carries an id/type so it can later be displayed.
-    expect(res.value === null || typeof res.value === 'object').toBe(true);
+  // T3 — preload a presentation for a placement (was fetchPresentationForPlacement;
+  // now Purchasely.presentation.placement(id).build().preload())
+  it('presentation.placement(...).build().preload() returns a presentation object', async () => {
+    const res = await callPresentation('placement', PLACEMENT, 'preload');
+    // Store-dependent (preload fetches the paywall + its products): tolerate a clean error
+    // on the store-less iOS simulator, assert the shape when it resolves.
+    if (res.ok) {
+      // v6 presentation normalizes screenId as the authoritative identifier.
+      expect(res.value === null || typeof res.value === 'object').toBe(true);
+      if (res.value) {
+        expect(typeof res.value.screenId).toBe('string');
+      }
+    } else {
+      expect(typeof res.error).toBe('string');
+    }
   });
 
   // T6 — synchronize now reports completion (v6 change). On a bare emulator/simulator
@@ -41,11 +54,101 @@ describe('Purchasely bridge (WEBVIEW context)', () => {
     expect(typeof res.ok).toBe('boolean');
   });
 
-  // user-attribute round-trip (set then read back)
+  // user-attribute round-trip (set then read back). The setters are fire-and-forget on
+  // the Cordova bridge (no success callback), so fire them via fireBridge and read back
+  // with callBridge; the small pause lets the native set land before the read.
   it('setUserAttributeWithString then userAttribute round-trips', async () => {
-    await callBridge('setUserAttributeWithString', ['e2e_key', 'e2e_value', 'ESSENTIAL']);
+    await fireBridge('setUserAttributeWithString', ['e2e_key', 'e2e_value', 'ESSENTIAL']);
+    await browser.pause(300);
     const res = await callBridge('userAttribute', ['e2e_key']);
     expect(res.ok).toBe(true);
     expect(res.value).toBe('e2e_value');
   });
+
+  // user-attribute round-trip, int variant
+  it('setUserAttributeWithInt then userAttribute round-trips', async () => {
+    await fireBridge('setUserAttributeWithInt', ['e2e_key_int', 7, 'ESSENTIAL']);
+    await browser.pause(300);
+    const res = await callBridge('userAttribute', ['e2e_key_int']);
+    expect(res.ok).toBe(true);
+    expect(res.value).toBe(7);
+  });
+
+  // user-attribute round-trip, boolean variant (CDV-W-09 fixed: both platforms now
+  // return a real JSON boolean, so this asserts strict equality, not just truthiness).
+  it('setUserAttributeWithBoolean then userAttribute round-trips', async () => {
+    await fireBridge('setUserAttributeWithBoolean', ['e2e_key_bool', true, 'ESSENTIAL']);
+    await browser.pause(300);
+    const res = await callBridge('userAttribute', ['e2e_key_bool']);
+    expect(res.ok).toBe(true);
+    expect(res.value).toBe(true);
+  });
+
+  // userSubscriptions on a fresh anonymous user. Store-dependent: settles as a list on the
+  // Android emulator, can settle as a clean error on the store-less iOS simulator.
+  it('userSubscriptions returns a list', async () => {
+    const res = await callBridge('userSubscriptions');
+    if (res.ok) {
+      expect(Array.isArray(res.value)).toBe(true);
+    } else {
+      expect(typeof res.error).toBe('string');
+    }
+  });
+
+  // T2 — login/logout cycle: isAnonymous flips true -> false -> true. userLogin/userLogout
+  // are fire-and-forget on the Cordova bridge, so drive them via fireBridge + verify via
+  // the callback-based isAnonymous getter.
+  it('isAnonymous flips around userLogin / userLogout', async () => {
+    let res = await callBridge('isAnonymous');
+    expect(res.ok).toBe(true);
+    expect(res.value).toBe(true);
+
+    await fireBridge('userLogin', ['cordova_e2e_user']);
+    await browser.pause(500);
+    res = await callBridge('isAnonymous');
+    expect(res.value).toBe(false);
+
+    await fireBridge('userLogout', []);
+    await browser.pause(500);
+    res = await callBridge('isAnonymous');
+    expect(res.value).toBe(true);
+  });
+
+  // T4 — dynamic offerings list (may be empty on a bare emulator)
+  it('getDynamicOfferings returns a list', async () => {
+    const res = await callBridge('getDynamicOfferings');
+    expect(res.ok).toBe(true);
+    expect(Array.isArray(res.value)).toBe(true);
+  });
+
+  // T18 — dynamic offerings set / get / remove / clear round-trip (list stays an array,
+  // no throw). The mutators are fire-and-forget; getDynamicOfferings reads back.
+  it('dynamic offerings set / remove / clear round-trip', async () => {
+    await fireBridge('setDynamicOffering', ['e2e_ref', 'e2e_plan', null, 0]);
+    await browser.pause(300);
+    let res = await callBridge('getDynamicOfferings');
+    expect(Array.isArray(res.value)).toBe(true);
+
+    await fireBridge('removeDynamicOffering', ['e2e_ref']);
+    await fireBridge('clearDynamicOfferings', []);
+    await browser.pause(300);
+    res = await callBridge('getDynamicOfferings');
+    expect(res.ok).toBe(true);
+    expect(Array.isArray(res.value)).toBe(true);
+  });
+
+  // T16 — increment / decrement a numeric user attribute
+  it('increment / decrement a numeric user attribute', async () => {
+    await fireBridge('setUserAttributeWithInt', ['e2e_counter', 5, 'ESSENTIAL']);
+    await browser.pause(300);
+    await fireBridge('incrementUserAttribute', ['e2e_counter', 3]);
+    await browser.pause(300);
+    let res = await callBridge('userAttribute', ['e2e_counter']);
+    expect(res.value).toBe(8);
+
+    await fireBridge('decrementUserAttribute', ['e2e_counter', 2]);
+    await browser.pause(300);
+    res = await callBridge('userAttribute', ['e2e_counter']);
+    expect(res.value).toBe(6);
+  });
 });

package/example/e2e/specs/dismiss.e2e.js

@@ -1,7 +1,12 @@
 // Presentation display + dismiss outcome. BEST-EFFORT (non-blocking in CI): depends on
 // a paywall actually rendering for the configured placement against the real backend.
 // Mirrors E2E_TEST_INDEX T8/T12 adapted to the Cordova imperative API.
-const { waitForPurchaselyReady, callBridge, switchToNative } = require('../helpers/driver');
+const {
+  waitForPurchaselyReady,
+  displayPresentation,
+  awaitDismissOutcome,
+  closeCurrentPresentation,
+} = require('../helpers/driver');
 
 const PLACEMENT = process.env.PURCHASELY_E2E_PLACEMENT || 'ONBOARDING';
 
@@ -10,28 +15,43 @@ describe('Presentation dismiss outcome', () => {
     await waitForPurchaselyReady();
   });
 
-  // T8/T12 — the present* success callback IS the per-presentation dismiss outcome.
+  // T8/T12 — display() resolves with the per-presentation dismiss outcome (was the
+  // presentPresentationForPlacement success callback; closePresentation() is now
+  // request.close(), driven here via closeCurrentPresentation()).
   // Present a placement, close it programmatically, and assert the outcome fires with a
   // closeReason.
-  it('presentPresentationForPlacement + closePresentation delivers a dismiss outcome', async () => {
-    // Kick off the presentation; do NOT await (the callback resolves at dismiss).
-    const outcomePromise = callBridge(
-      'presentPresentationForPlacement',
-      [PLACEMENT, null, 'fullScreen'],
-      90000
-    );
+  it('presentation.placement(...).build().display() + request.close() delivers a dismiss outcome', async () => {
+    // Fire display() fire-and-forget (its promise settles at dismiss and would otherwise
+    // block the session so close() could never run).
+    await displayPresentation('placement', PLACEMENT, 'fullScreen');
 
     // Give the paywall time to render, then close it programmatically from the bridge.
     await browser.pause(6000);
-    await callBridge('closePresentation');
+    await closeCurrentPresentation();
 
-    const outcome = await outcomePromise;
+    const outcome = await awaitDismissOutcome(30000);
     expect(outcome.ok).toBe(true);
     expect(outcome.value).toBeDefined();
     // v6 outcome carries a closeReason; programmatic close => 'programmatic' (Android).
     if (outcome.value && outcome.value.closeReason) {
       expect(typeof outcome.value.closeReason).toBe('string');
     }
-    await switchToNative().catch(() => {});
+  });
+
+  // v6 default (audience-targeted) presentation: same shape as the placement flow above,
+  // just with no placement/screen id (was presentPresentationForDefault). Best-effort:
+  // depends on a default audience being configured on the backend for this app id.
+  it('presentation.defaultSource().build().display() + request.close() delivers a dismiss outcome', async () => {
+    await displayPresentation('defaultSource', null, 'fullScreen');
+
+    await browser.pause(6000);
+    await closeCurrentPresentation();
+
+    const outcome = await awaitDismissOutcome(30000);
+    expect(outcome.ok).toBe(true);
+    expect(outcome.value).toBeDefined();
+    if (outcome.value && outcome.value.closeReason) {
+      expect(typeof outcome.value.closeReason).toBe('string');
+    }
   });
 });

package/example/e2e/tools/ci_run_e2e.sh

@@ -15,8 +15,22 @@ LOGDIR="$HERE/ci-logs"
 mkdir -p "$LOGDIR"
 export ANDROID_SERIAL="$SERIAL"
 
+# Appium 2 loads drivers from APPIUM_HOME (~/.appium), not node_modules, so a fresh CI
+# checkout has none installed even though appium-uiautomator2-driver is a devDependency.
+# Register it (idempotent; a no-op locally where it is already installed).
+echo "== Ensuring uiautomator2 driver is installed =="
+npx appium driver install uiautomator2 2>/dev/null || true
+
 echo "== Starting Appium =="
-npx appium --log "$LOGDIR/appium-android.log" --log-level info &
+# --allow-insecure=chromedriver_autodownload lets the uiautomator2 driver fetch the
+# Chromedriver matching the Cordova WebView's Chrome version on demand. Without it,
+# switching to the WEBVIEW context fails ("No Chromedriver found that can automate
+# Chrome 'X'"), which breaks every bridge test in its `before all` hook.
+# Detach Appium's stdout/stderr (it logs to --log anyway): if it keeps the script's
+# output pipe open, the android-emulator-runner action hangs after the tests finish
+# instead of returning.
+npx appium --allow-insecure=uiautomator2:chromedriver_autodownload \
+  --log "$LOGDIR/appium-android.log" --log-level info >/dev/null 2>&1 &
 APPIUM_PID=$!
 trap 'kill $APPIUM_PID 2>/dev/null || true' EXIT
 # Wait for Appium to accept connections.

package/example/e2e/tools/ci_run_e2e_ios.sh

@@ -13,8 +13,15 @@ LOGDIR="$HERE/ci-logs"
 mkdir -p "$LOGDIR"
 export PURCHASELY_E2E_UDID="$UDID"
 
+# Appium 2 loads drivers from APPIUM_HOME (~/.appium), not node_modules, so make sure the
+# xcuitest driver is registered (idempotent; a no-op where it is already installed).
+echo "== Ensuring xcuitest driver is installed =="
+npx appium driver install xcuitest 2>/dev/null || true
+
 echo "== Starting Appium =="
-npx appium --log "$LOGDIR/appium-ios.log" --log-level info &
+# Detach Appium's stdout/stderr (it logs to --log anyway) so it can't hold the runner's
+# output pipe open after the tests finish.
+npx appium --log "$LOGDIR/appium-ios.log" --log-level info >/dev/null 2>&1 &
 APPIUM_PID=$!
 trap 'kill $APPIUM_PID 2>/dev/null || true' EXIT
 for i in $(seq 1 30); do
@@ -23,7 +30,10 @@ for i in $(seq 1 30); do
 done
 
 run_suite() { # $1 = spec, $2 = hard|soft
-  local spec="$1" gate="$2" tries=3 n=1
+  # More retries than Android: WebDriverAgent's cold first build (~10-13 min) can outlast a
+  # few session-creation attempts, and the hard-gate bridge spec runs first — extra tries let
+  # WDA finish building (it is then cached via derivedDataPath, so later specs are instant).
+  local spec="$1" gate="$2" tries="${E2E_TRIES:-6}" n=1
   while [ $n -le $tries ]; do
     echo "== [$gate] $spec (attempt $n/$tries) =="
     if npx wdio run ./wdio.ios.conf.js --spec "$spec" 2>&1 | tee "$LOGDIR/wdio-$(basename "$spec").log"; then

package/example/e2e/wdio.android.conf.js

@@ -11,6 +11,9 @@ exports.config = Object.assign({}, config, {
     'appium:automationName': 'UiAutomator2',
     'appium:app': APK,
     'appium:appPackage': 'com.purchasely.demo',
+    // Pin the target device when several are attached (env override); CI has a
+    // single emulator so this is normally undefined.
+    'appium:udid': process.env.PURCHASELY_E2E_UDID || undefined,
     'appium:newCommandTimeout': 240,
     'appium:autoGrantPermissions': true,
     // The Cordova WebView is debuggable in the debug build, so Appium can attach

package/example/e2e/wdio.ios.conf.js

@@ -1,9 +1,18 @@
 const path = require('path');
+const fs = require('fs');
+const os = require('os');
 const { config } = require('./wdio.shared.conf');
 
 // Path to the .app built by `cordova build ios --emulator` (simulator build).
+// cordova-ios 8.x emits it under build/Debug-iphonesimulator; older cordova-ios
+// used build/emulator. Prefer whichever exists so the suite survives toolchain bumps.
+const APP_CANDIDATES = [
+  '../platforms/ios/build/Debug-iphonesimulator/HelloCordova.app',
+  '../platforms/ios/build/emulator/HelloCordova.app',
+].map((p) => path.resolve(__dirname, p));
 const APP = process.env.PURCHASELY_E2E_APP ||
-  path.resolve(__dirname, '../platforms/ios/build/emulator/HelloCordova.app');
+  APP_CANDIDATES.find((p) => fs.existsSync(p)) ||
+  APP_CANDIDATES[0];
 
 exports.config = Object.assign({}, config, {
   capabilities: [{
@@ -12,8 +21,24 @@ exports.config = Object.assign({}, config, {
     'appium:app': APP,
     'appium:bundleId': 'com.purchasely.demo',
     'appium:deviceName': process.env.PURCHASELY_E2E_SIM || 'iPhone 16',
+    // Pin an already-booted simulator when provided (CI boots one and exports its udid).
+    'appium:udid': process.env.PURCHASELY_E2E_UDID || undefined,
     'appium:platformVersion': process.env.PURCHASELY_E2E_IOS_VERSION || undefined,
     'appium:newCommandTimeout': 240,
     'appium:autoAcceptAlerts': true,
+    // WebDriverAgent's FIRST build on a cold CI runner can take several minutes; even 240s
+    // wasn't enough ("Unable to start WebDriverAgent ... after 240000ms"), so the first spec
+    // burned all its retries before WDA finished building. Give one attempt a long window to
+    // build WDA, then reuse it (useNewWDA:false) — later specs start in a few seconds.
+    'appium:wdaLaunchTimeout': 600000,
+    'appium:wdaConnectionTimeout': 600000,
+    'appium:wdaStartupRetries': 1,
+    'appium:wdaStartupRetryInterval': 20000,
+    'appium:useNewWDA': false,
+    // Build WebDriverAgent into a FIXED DerivedData dir so it is compiled once and reused
+    // across spec retries. Without it appium uses a fresh temp dir per session, so WDA is
+    // rebuilt from scratch every attempt and the hard-gate bridge spec times out before the
+    // (slow, cold) build ever finishes.
+    'appium:derivedDataPath': path.join(os.tmpdir(), 'ply-wda-derived'),
   }],
 });

package/example/ios.sh

@@ -1,9 +1,10 @@
 #!/bin/bash
 
-cordova plugin remove @purchasely/cordova-plugin-purchasely
-cordova platform remove ios
-cordova platform add ios@latest
-cordova plugin add ../ --link
+npm ci
+cordova plugin remove @purchasely/cordova-plugin-purchasely --nosave
+cordova platform remove ios --nosave
+cordova platform add ios@8.1.1 --nosave
+cordova plugin add ../ --link --nosave
 
 if [[ $1 = true ]]
 then
@@ -13,4 +14,4 @@ then
     pod repo update
     echo "Installing Purchasely SDK"
     pod install --project-directory=platforms/ios
-fi
+fi

package/example/package-lock.json

@@ -12,14 +12,14 @@
         "@purchasely/cordova-plugin-purchasely": "file:..",
         "@purchasely/cordova-plugin-purchasely-google": "file:../../purchasely-google",
         "cordova-android": "^15.0.0",
-        "cordova-ios": "^8.1.0",
+        "cordova-ios": "8.1.1",
         "cordova-plugin-purchasely": "file:..",
         "cordova-plugin-purchasely-google": "file:../../purchasely-google"
       }
     },
     "..": {
       "name": "@purchasely/cordova-plugin-purchasely",
-      "version": "6.0.0-rc.3",
+      "version": "6.0.0",
       "dev": true,
       "license": "ISC",
       "devDependencies": {
@@ -36,7 +36,7 @@
     },
     "../../purchasely-google": {
       "name": "@purchasely/cordova-plugin-purchasely-google",
-      "version": "6.0.0-rc.3",
+      "version": "6.0.0",
       "dev": true,
       "license": "ISC"
     },

package/example/package.json

@@ -16,7 +16,7 @@
     "@purchasely/cordova-plugin-purchasely": "file:..",
     "@purchasely/cordova-plugin-purchasely-google": "file:../../purchasely-google",
     "cordova-android": "^15.0.0",
-    "cordova-ios": "^8.1.0",
+    "cordova-ios": "8.1.1",
     "cordova-plugin-purchasely": "file:..",
     "cordova-plugin-purchasely-google": "file:../../purchasely-google"
   },
@@ -34,4 +34,4 @@
       "android"
     ]
   }
-}
+}