@condorinst/mobile-bridge 0.22.0 → 0.23.0

package/dist/cli.js

@@ -5,7 +5,7 @@ import { mkdirSync, writeFileSync } from "fs";
 import { dirname as dirname3, resolve as resolve4 } from "path";
 
 // package.json
-var version = "0.22.0";
+var version = "0.23.0";
 
 // src/canvas-admin/command.ts
 import { createHash as createHash2 } from "crypto";
@@ -164,6 +164,11 @@ var BLOCKED_API_RULES = [
     pattern: /window\s*\.\s*open\s*\(/,
     message: "The sandbox has no allow-popups; window.open() returns null."
   },
+  {
+    rule: "crypto-randomuuid",
+    pattern: /crypto\s*\.\s*randomUUID\b/,
+    message: "crypto.randomUUID exists only in a secure context, and the app's sandboxed iframe is probably not one: it can be undefined on the phone while it works in the harness. Use createRequestId() from the SDK, or crypto.getRandomValues."
+  },
   {
     rule: "top-navigation",
     pattern: /window\s*\.\s*top\b/,
@@ -303,6 +308,8 @@ function parseArgs(argv) {
     scenario: "default",
     port: DEFAULT_DEV_PORT,
     nativeVersion: void 0,
+    latencyMs: void 0,
+    panel: true,
     help: false
   };
   for (let i = 0; i < argv.length; i++) {
@@ -345,6 +352,14 @@ function parseArgs(argv) {
       case "--port":
         args.port = Number.parseInt(argv[++i] ?? "", 10) || DEFAULT_DEV_PORT;
         break;
+      case "--latency": {
+        const ms = Number.parseInt(argv[++i] ?? "", 10);
+        args.latencyMs = Number.isFinite(ms) && ms >= 0 ? ms : void 0;
+        break;
+      }
+      case "--no-panel":
+        args.panel = false;
+        break;
       default:
         if (token && !token.startsWith("-") && !args.htmlPath) args.htmlPath = token;
     }
@@ -357,7 +372,8 @@ Usage:
   npx condor-mobile-bridge build    -i <html> [-o <zip>]
   npx condor-mobile-bridge validate -i <zip|html> [--strict]
   npx condor-mobile-bridge canvas   publish|list|revoke ...   (see: canvas --help)
-  npx condor-mobile-bridge dev      -i <html|zip|dir> [--scenario <name>] [--native-version <v|null>] [--port <n>]
+  npx condor-mobile-bridge dev      -i <html|zip|dir> [--scenario <name|file.json>] [--native-version <v|null>]
+                                    [--port <n>] [--latency <ms>] [--no-panel]
 
 Commands:
   build      Inline a dist/index.html into a self-contained .zip.
@@ -375,12 +391,15 @@ Options:
   -o, --out <path>     build only: output .zip (default: ${DEFAULT_OUT}).
       --max-bytes <n>  Size limit in bytes (default: ${DEFAULT_MAX_BYTES} = 2 MB).
       --strict         validate only: exit 1 on warnings too, not just errors.
-      --scenario <n>   dev only: device behaviour to simulate (default: default).
+      --scenario <n>   dev only: device behaviour to simulate (default: default),
+                       or a .json file that extends one (see docs/device-testing.md).
       --port <n>       dev only: HTTP port (default: ${DEFAULT_DEV_PORT}).
       --native-version <v|null>
                        dev only: nativeVersion the harness reports (default
-                       0.17.0). 'null' reproduces a shell that could not
+                       0.18.0). 'null' reproduces a shell that could not
                        reach the native side.
+      --latency <ms>   dev only: fixed reply latency (e.g. 0 for fast tests).
+      --no-panel       dev only: hide the floating MOCK panel.
   -h, --help           Show this help.`;
 
 // src/canvas-admin/client.ts
@@ -960,7 +979,7 @@ function telemetry(spec, now) {
         serialNo: spec.serialNo,
         attemptDate: now - 10 * 6e4,
         message: spec.syncError,
-        messageCode: "SYNC_FAILED"
+        messageCode: "send_data_log_error"
       }
     ] : []
   };
@@ -1044,6 +1063,7 @@ function systemStatus(overrides = {}) {
     internet: true,
     permission: true,
     hasDevices: true,
+    hasDevicesKnown: true,
     missingOptionalPermissions: [],
     missingEssentialPermissions: [],
     deviceSyncError: {},
@@ -1053,28 +1073,27 @@ function systemStatus(overrides = {}) {
 }
 
 // src/dev/scenarios.ts
-var HARNESS_NATIVE_VERSION = "0.17.0";
+var HARNESS_NATIVE_VERSION = "0.18.0";
 var base = {
-  description: "Two devices, background service already running, realistic latency.",
+  description: "Two devices, background service already running, realistic latency. The first device starts a BLE session 3 s after load; the second stays between sessions.",
   nativeVersion: HARNESS_NATIVE_VERSION,
   latencyMs: [80, 250],
   serviceStartMs: 0,
-  userDeviceSilent: false,
   logPeriodS: 60,
   systemStatus: systemStatus(),
   devices: () => twoDevices()
 };
 var SCENARIOS = {
-  default: base,
+  default: { ...base, firstSessionAfterMs: 3e3 },
   "cold-start": {
     ...base,
-    description: "App launched from cold: the background service takes 4 s to start, and every ping/userDevice sent before that is lost. A bundle that asks once stays on its loading screen forever.",
+    description: "App launched from cold: the background service takes 4 s to start, and every ping/userDevice sent before that is lost. From nativeVersion 0.18.0 the app re-sends the lost userDevice itself; below it, a bundle that asks once stays on its loading screen forever.",
     serviceStartMs: 4e3
   },
   "no-devices": {
     ...base,
-    description: "Account with no linked device: userDevice never answers and systemStatus.hasDevices is false. Your bundle must show an empty state.",
-    userDeviceSilent: true,
+    description: "Account with no linked device: userDevice answers with error NO_DEVICES (below nativeVersion 0.18.0: never answers) and systemStatus.hasDevices is false. Your bundle must show an empty state.",
+    userDeviceError: "NO_DEVICES",
     systemStatus: systemStatus({ hasDevices: false })
   },
   "shared-serial": {
@@ -1084,9 +1103,8 @@ var SCENARIOS = {
   },
   offline: {
     ...base,
-    description: "No internet. systemStatus.internet is false and sensorLog fails; userDevice answers from the cache.",
-    sensorLogError: "Connection failed",
-    systemStatus: systemStatus({ internet: false })
+    description: "No internet. systemStatus.internet is false and sensorLog fails; userDevice answers from the cache. The internet comes back when a test calls window.condorDev.setStatus({ internet: true }).",
+    systemStatus: systemStatus({ internet: false, hasDevicesKnown: false })
   }
 };
 
@@ -1105,11 +1123,18 @@ function readClientHtml(input) {
   return inlineHtml(path);
 }
 var escapeHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-function harnessPage(scenario, nativeVersion) {
+function harnessPage(scenario, nativeVersion, extra = {}) {
   const options = Object.entries(SCENARIOS).map(
     ([name, s]) => `<option value="${name}" title="${escapeHtml(s.description)}"${name === scenario ? " selected" : ""}>${name}</option>`
   ).join("");
-  const description = escapeHtml(SCENARIOS[scenario]?.description ?? "");
+  const description = escapeHtml(
+    extra.scenarioFile ? `Scenario file ${extra.scenarioFile}` : SCENARIOS[scenario]?.description ?? ""
+  );
+  const defaultsJson = JSON.stringify({
+    latencyMs: extra.latencyMs ?? null,
+    panel: extra.panel !== false,
+    scenarioFile: Boolean(extra.scenarioFile)
+  }).replace(/</g, "\\u003c");
   const scenarioJson = JSON.stringify(scenario).replace(/</g, "\\u003c");
   const nativeJson = JSON.stringify(
     nativeVersion === void 0 ? void 0 : nativeVersion === "null" ? null : nativeVersion
@@ -1145,6 +1170,11 @@ function harnessPage(scenario, nativeVersion) {
 <script>
   var scenario = ${scenarioJson};
   var nativeVersion = ${nativeJson};
+  var defaults = ${defaultsJson};
+  var params = new URLSearchParams(location.search);
+  var latency = params.has('latency') ? Number(params.get('latency')) : defaults.latencyMs;
+  var panel = params.has('panel') ? params.get('panel') !== '0' : defaults.panel;
+  var useFile = defaults.scenarioFile && !params.has('scenario');
   var harness = null;
   document.getElementById('scenario').addEventListener('change', function (e) {
     var params = new URLSearchParams(location.search);
@@ -1154,14 +1184,55 @@ function harnessPage(scenario, nativeVersion) {
   document.getElementById('back').addEventListener('click', function () {
     if (harness) harness.pressBack();
   });
-  var chosen = CondorDevHarness.SCENARIOS[scenario];
-  if (nativeVersion !== undefined) chosen = Object.assign({}, chosen, { nativeVersion: nativeVersion });
-  fetch('/__condor/client.html')
+  // A scenario file extends a named scenario: its fields replace the base's,
+  // systemStatus is merged, and devices is the userDevice payload to answer.
+  function fromFile(file) {
+    var base = CondorDevHarness.SCENARIOS[file.extends || 'default'];
+    if (!base) throw new Error('scenario file: unknown "extends": ' + file.extends);
+    var out = Object.assign({}, base, file);
+    out.systemStatus = Object.assign({}, base.systemStatus, file.systemStatus || {});
+    if (file.devices) {
+      var devices = JSON.stringify(file.devices);
+      out.devices = function () { return JSON.parse(devices); };
+    } else out.devices = base.devices;
+    return out;
+  }
+  var chosen = null;
+  (useFile ? fetch('/__condor/scenario.json').then(function (r) { return r.json(); }).then(fromFile)
+           : Promise.resolve(CondorDevHarness.SCENARIOS[scenario]))
+    .then(function (s) {
+      chosen = s;
+      if (nativeVersion !== undefined) chosen = Object.assign({}, chosen, { nativeVersion: nativeVersion });
+      if (latency !== null && latency >= 0) chosen = Object.assign({}, chosen, { latencyMs: latency });
+      return fetch('/__condor/client.html');
+    })
     .then(function (r) { if (!r.ok) throw new Error('could not read the bundle: HTTP ' + r.status); return r.text(); })
     .then(function (html) {
-      return CondorDevHarness.createDevHarness({ html: html, scenario: chosen, mount: document.getElementById('device') });
+      return CondorDevHarness.createDevHarness({ html: html, scenario: chosen, mount: document.getElementById('device'), devPanel: panel });
+    })
+    .then(function (h) {
+      harness = h;
+      var confirm = new URLSearchParams(location.search).get('confirm');
+      if (confirm === 'accept' || confirm === 'decline') h.setConfirmations(confirm);
+      // Scripted tests (Puppeteer, Playwright) drive the simulated app here.
+      // See docs/device-testing.md, "Scripted tests".
+      window.condorDev = {
+        scenario: h.scenario,
+        get log() { return h.log.slice(); },
+        // true once the bundle is mounted AND its handshake was answered (or,
+        // with nativeVersion null, left unanswered on purpose).
+        get ready() {
+          return h.log.some(function (e) {
+            return (e.kind === 'reply' && e.key === 'handshake-ack') || /handshake unanswered/.test(e.detail);
+          });
+        },
+        emit: function (key, payload) { h.emit(key, payload); },
+        setStatus: function (patch) { h.setStatus(patch); },
+        setConnected: function (deviceId, connected) { h.setConnected(deviceId, connected); },
+        setConfirmations: function (mode) { h.setConfirmations(mode); },
+        pressBack: function () { h.pressBack(); }
+      };
     })
-    .then(function (h) { harness = h; })
     .catch(function (err) { document.getElementById('device').textContent = String(err); console.error(err); });
 </script>
 </body>
@@ -1172,7 +1243,10 @@ function harnessScriptPath() {
   return join2(here, "dev-harness.global.js");
 }
 function startDevServer(opts) {
-  if (!(opts.scenario in SCENARIOS)) {
+  const scenarioFile = opts.scenario.endsWith(".json") ? resolve3(opts.scenario) : void 0;
+  if (scenarioFile) {
+    JSON.parse(readFileSync3(scenarioFile, "utf-8"));
+  } else if (!(opts.scenario in SCENARIOS)) {
     throw new Error(
       `Unknown scenario "${opts.scenario}". Known: ${Object.keys(SCENARIOS).join(", ")}.`
     );
@@ -1189,6 +1263,14 @@ function startDevServer(opts) {
         res.end(readClientHtml(opts.input));
         return;
       }
+      if (url.pathname === "/__condor/scenario.json" && scenarioFile) {
+        res.writeHead(200, {
+          "content-type": "application/json; charset=utf-8",
+          "cache-control": "no-store"
+        });
+        res.end(readFileSync3(scenarioFile));
+        return;
+      }
       if (url.pathname === "/__condor/harness.js") {
         res.writeHead(200, {
           "content-type": "text/javascript; charset=utf-8",
@@ -1198,14 +1280,21 @@ function startDevServer(opts) {
         return;
       }
       if (url.pathname === "/") {
-        const scenario = url.searchParams.get("scenario") ?? opts.scenario;
+        const named = url.searchParams.get("scenario");
+        const scenario = named ?? (scenarioFile ? "default" : opts.scenario);
         res.writeHead(200, {
           "content-type": "text/html; charset=utf-8",
           "content-security-policy": CANVAS_CSP,
           "cache-control": "no-store"
         });
         const nativeVersion = url.searchParams.get("nativeVersion") ?? opts.nativeVersion;
-        res.end(harnessPage(scenario in SCENARIOS ? scenario : opts.scenario, nativeVersion));
+        res.end(
+          harnessPage(scenario in SCENARIOS ? scenario : "default", nativeVersion, {
+            latencyMs: opts.latencyMs,
+            panel: opts.panel,
+            scenarioFile: named ? void 0 : scenarioFile && opts.scenario
+          })
+        );
         return;
       }
       res.writeHead(404).end();
@@ -1219,12 +1308,13 @@ function startDevServer(opts) {
 }
 
 // src/cli.ts
-function runDev(input, scenario, port, nativeVersion) {
-  const server = startDevServer({ input, scenario, port, nativeVersion });
+function runDev(opts) {
+  const { input, scenario, port, nativeVersion } = opts;
+  const server = startDevServer(opts);
   server.on("listening", () => {
     const native = nativeVersion === void 0 ? "" : `&nativeVersion=${nativeVersion}`;
     console.log(
-      `Condor Canvas dev harness: http://localhost:${port}/?scenario=${scenario}${native}`
+      `Condor Canvas dev harness: http://localhost:${port}/${scenario.endsWith(".json") ? "" : `?scenario=${scenario}`}${native}`
     );
     console.log(`  bundle:   ${input} (re-read on every reload)`);
     console.log("  sandbox, shell policy and CSP: same as the app");
@@ -1318,7 +1408,14 @@ function main() {
   }
   if (args.command === "dev") {
     try {
-      runDev(args.htmlPath, args.scenario, args.port, args.nativeVersion);
+      runDev({
+        input: args.htmlPath,
+        scenario: args.scenario,
+        port: args.port,
+        nativeVersion: args.nativeVersion,
+        latencyMs: args.latencyMs,
+        panel: args.panel
+      });
     } catch (err) {
       console.error(`dev: ${err instanceof Error ? err.message : String(err)}`);
       process.exit(1);