obsidian-integration-testing 10.4.0 → 12.0.0

package/dist/lib/cjs/wedged-appium-server.cjs

@@ -0,0 +1,113 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var wedged_appium_server_exports = {};
+__export(wedged_appium_server_exports, {
+  buildWedgedAppiumServerMessage: () => buildWedgedAppiumServerMessage,
+  checkIsAppiumDeviceNotFoundError: () => checkIsAppiumDeviceNotFoundError,
+  checkIsAppiumStatusReady: () => checkIsAppiumStatusReady,
+  resolveWedgedAppiumServerRemedy: () => resolveWedgedAppiumServerRemedy
+});
+module.exports = __toCommonJS(wedged_appium_server_exports);
+var import_error_to_string = require("./error-to-string.cjs");
+const DEVICE_NOT_FOUND_MESSAGE_FRAGMENT = "Could not find a connected Android device";
+const MILLISECONDS_PER_SECOND = 1e3;
+const SECONDS_PER_MINUTE = 60;
+const MILLISECONDS_PER_MINUTE = MILLISECONDS_PER_SECOND * SECONDS_PER_MINUTE;
+function buildWedgedAppiumServerMessage(params) {
+  const lines = [
+    `The Appium server at ${params.appiumOrigin} cannot see Android device ${params.deviceId}, although this host's adb can.`,
+    "The server is stale \u2014 its adb connection is wedged \u2014 not the device, so `adb devices` will list the device and mislead you.",
+    resolveRemedyAdvice(params)
+  ];
+  const provenance = describeServer(params);
+  if (provenance) {
+    lines.push(provenance);
+  }
+  return lines.join("\n");
+}
+function checkIsAppiumDeviceNotFoundError(error) {
+  return (0, import_error_to_string.errorToString)(error).includes(DEVICE_NOT_FOUND_MESSAGE_FRAGMENT);
+}
+function checkIsAppiumStatusReady(statusBody) {
+  let parsed;
+  try {
+    parsed = JSON.parse(statusBody);
+  } catch {
+    return true;
+  }
+  return readReadyFlag(parsed) !== false;
+}
+function resolveWedgedAppiumServerRemedy(params) {
+  if (!checkIsAppiumDeviceNotFoundError(params.error)) {
+    return { reason: "other-error", remedy: "not-wedged" };
+  }
+  if (!params.connectedDeviceIds.includes(params.deviceId)) {
+    return { reason: "device-absent", remedy: "not-wedged" };
+  }
+  if (!params.isAdoptedServer) {
+    return { reason: "freshly-started", remedy: "report" };
+  }
+  if (!params.isAutoStartAllowed) {
+    return { reason: "auto-start-disabled", remedy: "report" };
+  }
+  if (!params.isHarnessOwnedServer) {
+    return { reason: "foreign-server", remedy: "report" };
+  }
+  return { reason: "harness-owned", remedy: "restart" };
+}
+function describeServer(params) {
+  if (params.serverPid === void 0) {
+    return "";
+  }
+  const age = params.serverAgeInMilliseconds === void 0 ? "" : `, running for ${formatAge(params.serverAgeInMilliseconds)}`;
+  return `The server was started by an earlier obsidian-integration-testing run (pid ${String(params.serverPid)}${age}).`;
+}
+function formatAge(ageInMilliseconds) {
+  if (ageInMilliseconds < MILLISECONDS_PER_MINUTE) {
+    return `${String(Math.round(ageInMilliseconds / MILLISECONDS_PER_SECOND))}s`;
+  }
+  return `${String(Math.round(ageInMilliseconds / MILLISECONDS_PER_MINUTE))}min`;
+}
+function readReadyFlag(parsed) {
+  if (typeof parsed !== "object" || parsed === null) {
+    return void 0;
+  }
+  const record = parsed;
+  const value = record["value"];
+  const nested = typeof value === "object" && value !== null ? value["ready"] : void 0;
+  const ready = nested ?? record["ready"];
+  return typeof ready === "boolean" ? ready : void 0;
+}
+function resolveRemedyAdvice(params) {
+  const advice = {
+    "auto-start-disabled": `Appium auto-start is disabled (\`shouldAutoStartAppium: false\`), so this server is yours to manage: kill it and start a fresh one on ${params.appiumOrigin}, then re-run.`,
+    "foreign-server": `This server was not started by obsidian-integration-testing, so it was left running: kill it and start a fresh one on ${params.appiumOrigin}, then re-run.`,
+    "freshly-started": "This server was started by this run, so restarting it would change nothing: check that adb and the emulator agree (`adb kill-server && adb devices`), then re-run.",
+    "restart-did-not-help": `Restarting the server on ${params.appiumOrigin} did not help \u2014 a fresh one still could not serve this run, so the wedge is not the server alone: check adb itself (\`adb kill-server && adb devices\`) and that nothing else holds the port, then re-run.`
+  };
+  return advice[params.reason];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildWedgedAppiumServerMessage,
+  checkIsAppiumDeviceNotFoundError,
+  checkIsAppiumStatusReady,
+  resolveWedgedAppiumServerRemedy
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3dlZGdlZC1hcHBpdW0tc2VydmVyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogUHVyZSBoZWxwZXJzIGZvciByZWNvZ25pemluZyBhICoqd2VkZ2VkKiogQXBwaXVtIHNlcnZlciBhbmQgZGVjaWRpbmcgd2hhdCB0b1xuICogZG8gYWJvdXQgaXQuIEtlcHQgc2VwYXJhdGUgZnJvbSB0aGUgaW50ZWdyYXRpb24tb25seSBgdHJhbnNwb3J0LWZhY3RvcnlgIHNvXG4gKiB0aGUgY2xhc3NpZmljYXRpb24sIHRoZSByZW1lZHkgZGVjaXNpb24gYW5kIHRoZSBtZXNzYWdlIHN0YXkgdW5pdC10ZXN0YWJsZVxuICogKHRoZSBmYWN0b3J5IGl0c2VsZiBuZWVkcyBhIHJlYWwgZGV2aWNlIGFuZCBpcyBleGNsdWRlZCBmcm9tIHVuaXQgdGVzdHMpLlxuICpcbiAqIEEgd2VkZ2VkIHNlcnZlciBpcyBvbmUgdGhhdCBpcyBzdGlsbCAqKmxpdmUqKiBcdTIwMTQgaXQgbGlzdGVucyBvbiBpdHMgcG9ydCBhbmRcbiAqIGFuc3dlcnMgYC9zdGF0dXNgIHdpdGggYHJlYWR5OiB0cnVlYCBcdTIwMTQgYnV0IGlzIG5vIGxvbmdlciAqKnVzYWJsZSoqOiBpdHNcbiAqIGBhcHBpdW0tYWRiYCBjYW4gbm8gbG9uZ2VyIGVudW1lcmF0ZSBkZXZpY2VzLCBzbyBldmVyeSBzZXNzaW9uIGNyZWF0aW9uIGRpZXNcbiAqIHdpdGggYENvdWxkIG5vdCBmaW5kIGEgY29ubmVjdGVkIEFuZHJvaWQgZGV2aWNlIGluIDxuPm1zYCB3aGlsZSB0aGUgaG9zdCdzIG93blxuICogYGFkYiBkZXZpY2VzYCBsaXN0cyB0aGUgZGV2aWNlIGluc3RhbnRseS4gTGl2ZW5lc3MgaXMgbm90IHJlYWRpbmVzcywgYW5kIHRoZVxuICogZXJyb3IgbmFtZXMgdGhlIHdyb25nIHN1YmplY3Q6IGl0IGJsYW1lcyBhIGRldmljZSB0aGF0IGlzIGRlbW9uc3RyYWJseVxuICogcHJlc2VudCwgd2hpY2ggc2VuZHMgd2hvZXZlciByZWFkcyBpdCB0byBgYWRiIGRldmljZXNgIFx1MjAxNCB0aGUgb25lIGRpYWdub3N0aWNcbiAqIHRoYXQgYWN0aXZlbHkgbWlzbGVhZHMgaGVyZS5cbiAqXG4gKiBUaGUgd2VkZ2UgZGV2ZWxvcHMgb3ZlciB0aW1lIGluIGEgbG9uZy1saXZlZCBzZXJ2ZXIgKG9uZSBhdXRvLXN0YXJ0ZWQgYnkgYW5cbiAqIGVhcmxpZXIgcnVuIGFuZCBsZWZ0IGxpc3RlbmluZyksIHNvIHRoZSBwcmVmbGlnaHQgY2Fubm90IHNlZSBpdCBjb21pbmc6IGl0IGNhblxuICogb25seSBiZSByZWNvZ25pemVkIGZyb20gdGhlIGZhaWxlZCBzZXNzaW9uLCBjcm9zcy1jaGVja2VkIGFnYWluc3QgdGhlIGhvc3Qnc1xuICogYWRiLlxuICovXG5cbmltcG9ydCB7IGVycm9yVG9TdHJpbmcgfSBmcm9tICcuL2Vycm9yLXRvLXN0cmluZy5janMnO1xuXG4vKipcbiAqIFRoZSBmcmFnbWVudCBgYXBwaXVtLWFkYmAgdGhyb3dzIHdoZW4gaXQgY2Fubm90IGVudW1lcmF0ZSBkZXZpY2VzIFx1MjAxNFxuICogYGAgYENvdWxkIG5vdCBmaW5kIGEgY29ubmVjdGVkIEFuZHJvaWQgZGV2aWNlIGluICR7dGltZW91dE1zfW1zYCBgYCBmcm9tIGl0c1xuICogYGdldERldmljZXNXaXRoUmV0cnlgIChgbGliL3Rvb2xzL3N5c3RlbS1jYWxscy50c2ApLiBNYXRjaGVkIGFzIGEgc3Vic3RyaW5nIHNvXG4gKiB0aGUgdGltZW91dCB2YWx1ZSBhbmQgYW55IHdyYXBwaW5nIGJ5IFdlYmRyaXZlcklPIGRvIG5vdCBhZmZlY3QgaXQuXG4gKi9cbmNvbnN0IERFVklDRV9OT1RfRk9VTkRfTUVTU0FHRV9GUkFHTUVOVCA9ICdDb3VsZCBub3QgZmluZCBhIGNvbm5lY3RlZCBBbmRyb2lkIGRldmljZSc7XG5cbmNvbnN0IE1JTExJU0VDT05EU19QRVJfU0VDT05EID0gMTAwMDtcbmNvbnN0IFNFQ09ORFNfUEVSX01JTlVURSA9IDYwO1xuY29uc3QgTUlMTElTRUNPTkRTX1BFUl9NSU5VVEUgPSBNSUxMSVNFQ09ORFNfUEVSX1NFQ09ORCAqIFNFQ09ORFNfUEVSX01JTlVURTtcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgYnVpbGRXZWRnZWRBcHBpdW1TZXJ2ZXJNZXNzYWdlfS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBCdWlsZFdlZGdlZEFwcGl1bVNlcnZlck1lc3NhZ2VQYXJhbXMge1xuICAvKipcbiAgT3JpZ2luIG9mIHRoZSBBcHBpdW0gc2VydmVyIHRoYXQgY291bGQgbm90IHNlZSB0aGUgZGV2aWNlIChlLmcuIGBodHRwOi8vbG9jYWxob3N0OjQ3MjNgKS5cbiAgICovXG4gIHJlYWRvbmx5IGFwcGl1bU9yaWdpbjogc3RyaW5nO1xuXG4gIC8qKlxuICBUaGUgZGV2aWNlIHRoZSBob3N0J3MgYWRiIGNhbiBzZWUgYnV0IEFwcGl1bSBjYW5ub3QuXG4gICAqL1xuICByZWFkb25seSBkZXZpY2VJZDogc3RyaW5nO1xuXG4gIC8qKlxuICBXaHkgdGhpcyBydW4gaXMgcmVwb3J0aW5nIHJhdGhlciB0aGFuIHJlc3RhcnRpbmcuXG4gICAqL1xuICByZWFkb25seSByZWFzb246IFdlZGdlZEFwcGl1bVNlcnZlclJlcG9ydFJlYXNvbjtcblxuICAvKipcbiAgSG93IGxvbmcgdGhlIHNlcnZlciBoYXMgYmVlbiBydW5uaW5nLCB3aGVuIGtub3duIGZyb20gaXRzIG1hcmtlci5cbiAgICovXG4gIHJlYWRvbmx5IHNlcnZlckFnZUluTWlsbGlzZWNvbmRzPzogbnVtYmVyIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICBQSUQgb2YgdGhlIHNlcnZlciwgd2hlbiBrbm93biBmcm9tIGl0cyBtYXJrZXIuXG4gICAqL1xuICByZWFkb25seSBzZXJ2ZXJQaWQ/OiBudW1iZXIgfCB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogVGhlIHNlcnZlciBpcyBub3QgdG8gYmxhbWU6IGVpdGhlciB0aGUgZmFpbHVyZSB3YXMgYSBkaWZmZXJlbnQgZXJyb3IsIG9yIHRoZVxuICogaG9zdCdzIGFkYiBjYW5ub3Qgc2VlIHRoZSBkZXZpY2UgZWl0aGVyLiBUaGUgb3JpZ2luYWwgZXJyb3IgaXMgcmV0aHJvd24uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTm90V2VkZ2VkVmVyZGljdCB7XG4gIC8qKlxuICBXaGljaCBvZiB0aGUgdHdvIGhvbmVzdC1mYWlsdXJlIGNhc2VzIHRoaXMgaXMuXG4gICAqL1xuICByZWFkb25seSByZWFzb246ICdkZXZpY2UtYWJzZW50JyB8ICdvdGhlci1lcnJvcic7XG5cbiAgLyoqXG4gIERpc2NyaW1pbmFudC5cbiAgICovXG4gIHJlYWRvbmx5IHJlbWVkeTogJ25vdC13ZWRnZWQnO1xufVxuXG4vKipcbiAqIFRoZSBzZXJ2ZXIgaXMgd2VkZ2VkIGJ1dCBtdXN0IG5vdCBiZSB0b3VjaGVkIGJ5IHRoaXMgcnVuLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFJlcG9ydFNlcnZlclZlcmRpY3Qge1xuICAvKipcbiAgV2h5IHRoaXMgcnVuIGlzIHJlcG9ydGluZyByYXRoZXIgdGhhbiByZXN0YXJ0aW5nLlxuICAgKi9cbiAgcmVhZG9ubHkgcmVhc29uOiBXZWRnZWRBcHBpdW1TZXJ2ZXJSZXBvcnRSZWFzb247XG5cbiAgLyoqXG4gIERpc2NyaW1pbmFudC5cbiAgICovXG4gIHJlYWRvbmx5IHJlbWVkeTogJ3JlcG9ydCc7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIHJlc29sdmVXZWRnZWRBcHBpdW1TZXJ2ZXJSZW1lZHl9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFJlc29sdmVXZWRnZWRBcHBpdW1TZXJ2ZXJSZW1lZHlQYXJhbXMge1xuICAvKipcbiAgRGV2aWNlIElEcyB0aGUgKipob3N0J3MqKiBhZGIgY3VycmVudGx5IGxpc3RzICh0aGUgY3Jvc3MtY2hlY2sgdGhhdCBjb252aWN0cyB0aGUgc2VydmVyKS5cbiAgICovXG4gIHJlYWRvbmx5IGNvbm5lY3RlZERldmljZUlkczogcmVhZG9ubHkgc3RyaW5nW107XG5cbiAgLyoqXG4gIFRoZSBkZXZpY2UgdGhlIHNlc3Npb24gd2FzIHJlcXVlc3RlZCBhZ2FpbnN0LlxuICAgKi9cbiAgcmVhZG9ubHkgZGV2aWNlSWQ6IHN0cmluZztcblxuICAvKipcbiAgVGhlIGVycm9yIHRoZSBzZXNzaW9uIGF0dGVtcHQgZmFpbGVkIHdpdGguXG4gICAqL1xuICByZWFkb25seSBlcnJvcjogdW5rbm93bjtcblxuICAvKipcbiAgV2hldGhlciB0aGUgc2VydmVyIHdhcyBhbHJlYWR5IGxpc3RlbmluZyBhbmQgd2FzIGFkb3B0ZWQsIHJhdGhlciB0aGFuIHN0YXJ0ZWQgYnkgdGhpcyBydW4uXG4gICAqL1xuICByZWFkb25seSBpc0Fkb3B0ZWRTZXJ2ZXI6IGJvb2xlYW47XG5cbiAgLyoqXG4gIFdoZXRoZXIgdGhpcyBydW4gbWF5IHN0YXJ0IGFuIEFwcGl1bSBzZXJ2ZXIgKGBzaG91bGRBdXRvU3RhcnRBcHBpdW1gIGlzIG5vdCBgZmFsc2VgKS5cbiAgICovXG4gIHJlYWRvbmx5IGlzQXV0b1N0YXJ0QWxsb3dlZDogYm9vbGVhbjtcblxuICAvKipcbiAgV2hldGhlciB0aGUgYWRvcHRlZCBzZXJ2ZXIncyBtYXJrZXIgcHJvdmVzIGFuIGVhcmxpZXIgcnVuIG9mIHRoaXMgaGFybmVzcyBzdGFydGVkIGl0LlxuICAgKi9cbiAgcmVhZG9ubHkgaXNIYXJuZXNzT3duZWRTZXJ2ZXI6IGJvb2xlYW47XG59XG5cbi8qKlxuICogVGhlIHNlcnZlciBpcyB3ZWRnZWQgYW5kIGFuIGVhcmxpZXIgcnVuIG9mIHRoaXMgaGFybmVzcyBzdGFydGVkIGl0LCBzbyB0aGlzXG4gKiBydW4gbWF5IHJlcGxhY2UgaXQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVzdGFydFNlcnZlclZlcmRpY3Qge1xuICAvKipcbiAgQWx3YXlzIHRoZSBoYXJuZXNzLW93bmVkIGNhc2UuXG4gICAqL1xuICByZWFkb25seSByZWFzb246ICdoYXJuZXNzLW93bmVkJztcblxuICAvKipcbiAgRGlzY3JpbWluYW50LlxuICAgKi9cbiAgcmVhZG9ubHkgcmVtZWR5OiAncmVzdGFydCc7XG59XG5cbi8qKlxuICogVGhlIGNsYXNzaWZpY2F0aW9uIG9mIGEgZmFpbGVkIHNlc3Npb24gYXR0ZW1wdC5cbiAqXG4gKiBgJ2RldmljZS1hYnNlbnQnYCBhbmQgYCdvdGhlci1lcnJvcidgIGFyZSB0aGUgbm90LXdlZGdlZCB2ZXJkaWN0czogdGhlXG4gKiBvcmlnaW5hbCBlcnJvciB3YXMgaG9uZXN0IGFuZCBpcyByZXRocm93biB1bnRvdWNoZWQuXG4gKi9cbmV4cG9ydCB0eXBlIFdlZGdlZEFwcGl1bVNlcnZlclJlYXNvbiA9ICdkZXZpY2UtYWJzZW50JyB8ICdoYXJuZXNzLW93bmVkJyB8ICdvdGhlci1lcnJvcicgfCBXZWRnZWRBcHBpdW1TZXJ2ZXJSZXBvcnRSZWFzb247XG5cbi8qKlxuICogV2hhdCB0aGUgZmFjdG9yeSBzaG91bGQgZG8gd2l0aCBhIGZhaWxlZCBzZXNzaW9uIGF0dGVtcHQuXG4gKi9cbmV4cG9ydCB0eXBlIFdlZGdlZEFwcGl1bVNlcnZlclJlbWVkeSA9ICdub3Qtd2VkZ2VkJyB8ICdyZXBvcnQnIHwgJ3Jlc3RhcnQnO1xuXG4vKipcbiAqIFdoeSBhIHdlZGdlZCBzZXJ2ZXIgaXMgb25seSByZXBvcnRlZCByYXRoZXIgdGhhbiByZXN0YXJ0ZWQuIEVhY2ggbWFwcyB0byBpdHNcbiAqIG93biByZW1lZHkgc2VudGVuY2UgXHUyMDE0IHRoZSB3aG9sZSBwb2ludCBvZiB0aGUgcmV3cml0ZSBpcyB0aGF0IHRoZSBtZXNzYWdlIHNheXNcbiAqIHdoYXQgKnRoaXMqIHJ1biBjYW4gYW5kIGNhbm5vdCBkbyBhYm91dCB0aGUgc2VydmVyIGl0IGZvdW5kLlxuICovXG5leHBvcnQgdHlwZSBXZWRnZWRBcHBpdW1TZXJ2ZXJSZXBvcnRSZWFzb24gPVxuICB8ICdhdXRvLXN0YXJ0LWRpc2FibGVkJ1xuICB8ICdmb3JlaWduLXNlcnZlcidcbiAgfCAnZnJlc2hseS1zdGFydGVkJ1xuICB8ICdyZXN0YXJ0LWRpZC1ub3QtaGVscCc7XG5cbi8qKlxuICogVGhlIHZlcmRpY3Qgb24gYSBmYWlsZWQgc2Vzc2lvbiBhdHRlbXB0LCBkaXNjcmltaW5hdGVkIGJ5IGByZW1lZHlgIHNvIGFcbiAqIGAncmVwb3J0J2AgdmVyZGljdCBjYXJyaWVzIGEgcmVhc29uIHtAbGluayBidWlsZFdlZGdlZEFwcGl1bVNlcnZlck1lc3NhZ2V9IGNhblxuICogdHVybiBpbnRvIGFkdmljZS5cbiAqL1xuZXhwb3J0IHR5cGUgV2VkZ2VkQXBwaXVtU2VydmVyVmVyZGljdCA9IE5vdFdlZGdlZFZlcmRpY3QgfCBSZXBvcnRTZXJ2ZXJWZXJkaWN0IHwgUmVzdGFydFNlcnZlclZlcmRpY3Q7XG5cbi8qKlxuICogQnVpbGRzIHRoZSBlcnJvciBtZXNzYWdlIHRoYXQgcmVwbGFjZXMgYENvdWxkIG5vdCBmaW5kIGEgY29ubmVjdGVkIEFuZHJvaWRcbiAqIGRldmljZWAsIG5hbWluZyB0aGUgKipzZXJ2ZXIqKiBhbmQgc3RhdGluZyB0aGUgZXZpZGVuY2UgXHUyMDE0IHRoZSBob3N0J3MgYWRiIGNhblxuICogc2VlIHRoZSBkZXZpY2UsIHNvIHRoZSBzZXJ2ZXIgaXMgdGhlIHRoaW5nIHRoYXQgaXMgc3RhbGUuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBzZXJ2ZXIsIHRoZSBkZXZpY2UsIGFuZCB3aHkgdGhpcyBydW4gaXMgbm90IHJlc3RhcnRpbmcgaXQuXG4gKiBAcmV0dXJucyBUaGUgbWVzc2FnZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGJ1aWxkV2VkZ2VkQXBwaXVtU2VydmVyTWVzc2FnZShwYXJhbXM6IEJ1aWxkV2VkZ2VkQXBwaXVtU2VydmVyTWVzc2FnZVBhcmFtcyk6IHN0cmluZyB7XG4gIGNvbnN0IGxpbmVzID0gW1xuICAgIGBUaGUgQXBwaXVtIHNlcnZlciBhdCAke3BhcmFtcy5hcHBpdW1PcmlnaW59IGNhbm5vdCBzZWUgQW5kcm9pZCBkZXZpY2UgJHtwYXJhbXMuZGV2aWNlSWR9LCBhbHRob3VnaCB0aGlzIGhvc3QncyBhZGIgY2FuLmAsXG4gICAgJ1RoZSBzZXJ2ZXIgaXMgc3RhbGUgXHUyMDE0IGl0cyBhZGIgY29ubmVjdGlvbiBpcyB3ZWRnZWQgXHUyMDE0IG5vdCB0aGUgZGV2aWNlLCBzbyBgYWRiIGRldmljZXNgIHdpbGwgbGlzdCB0aGUgZGV2aWNlIGFuZCBtaXNsZWFkIHlvdS4nLFxuICAgIHJlc29sdmVSZW1lZHlBZHZpY2UocGFyYW1zKVxuICBdO1xuXG4gIGNvbnN0IHByb3ZlbmFuY2UgPSBkZXNjcmliZVNlcnZlcihwYXJhbXMpO1xuICBpZiAocHJvdmVuYW5jZSkge1xuICAgIGxpbmVzLnB1c2gocHJvdmVuYW5jZSk7XG4gIH1cblxuICByZXR1cm4gbGluZXMuam9pbignXFxuJyk7XG59XG5cbi8qKlxuICogQ2hlY2tzIHdoZXRoZXIgYSBmYWlsZWQgc2Vzc2lvbiBhdHRlbXB0IGlzIGBhcHBpdW0tYWRiYCdzIGRldmljZS1lbnVtZXJhdGlvblxuICogZmFpbHVyZS4gVGhlIHdob2xlIGBjYXVzZWAgY2hhaW4gaXMgc2VhcmNoZWQsIHNvIFdlYmRyaXZlcklPJ3Mgd3JhcHBpbmcgb2YgdGhlXG4gKiBzZXJ2ZXIncyBlcnJvciBkb2VzIG5vdCBoaWRlIGl0LlxuICpcbiAqIEBwYXJhbSBlcnJvciAtIFRoZSBlcnJvciB0aGUgc2Vzc2lvbiBhdHRlbXB0IGZhaWxlZCB3aXRoLlxuICogQHJldHVybnMgYHRydWVgIHdoZW4gaXQgaXMgdGhlIGRldmljZS1ub3QtZm91bmQgZmFpbHVyZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNoZWNrSXNBcHBpdW1EZXZpY2VOb3RGb3VuZEVycm9yKGVycm9yOiB1bmtub3duKTogYm9vbGVhbiB7XG4gIHJldHVybiBlcnJvclRvU3RyaW5nKGVycm9yKS5pbmNsdWRlcyhERVZJQ0VfTk9UX0ZPVU5EX01FU1NBR0VfRlJBR01FTlQpO1xufVxuXG4vKipcbiAqIENoZWNrcyB3aGV0aGVyIGFuIEFwcGl1bSBgL3N0YXR1c2AgYm9keSByZXBvcnRzIGEgc2VydmVyIHRoYXQgaXMgYWNjZXB0aW5nIG5ld1xuICogc2Vzc2lvbnMuXG4gKlxuICogRGVsaWJlcmF0ZWx5ICoqdG9sZXJhbnQqKjogb25seSBhbiBleHBsaWNpdCBgcmVhZHk6IGZhbHNlYCAoQXBwaXVtIHNldHMgaXRcbiAqIHdoaWxlIHNodXR0aW5nIGRvd24pIGlzIHRyZWF0ZWQgYXMgbm90LXJlYWR5LiBBIGJvZHkgdGhhdCBjYW5ub3QgYmUgcGFyc2VkLCBvclxuICogdGhhdCBvbWl0cyB0aGUgZmxhZywgcmVhZHMgYXMgcmVhZHkgXHUyMDE0IGFuIHVucmVjb2duaXplZCBzaGFwZSBtdXN0IG5vdCBtYWtlIGFcbiAqIGhlYWx0aHkgc2VydmVyIGxvb2sgdW5yZWFjaGFibGUuXG4gKlxuICogVGhpcyBkb2VzIG5vdCBjYXRjaCB0aGUgd2VkZ2UgKGEgd2VkZ2VkIHNlcnZlciBzdGlsbCBhbnN3ZXJzIGByZWFkeTogdHJ1ZWApO1xuICogaXQgY2xvc2VzIHRoZSBhZGphY2VudCBob2xlIG9mIGFkb3B0aW5nIGEgc2VydmVyIHRoYXQgaXMgb24gaXRzIHdheSBkb3duLlxuICpcbiAqIEBwYXJhbSBzdGF0dXNCb2R5IC0gVGhlIHJhdyBgL3N0YXR1c2AgcmVzcG9uc2UgYm9keS5cbiAqIEByZXR1cm5zIGBmYWxzZWAgb25seSB3aGVuIHRoZSBzZXJ2ZXIgZXhwbGljaXRseSByZXBvcnRzIGl0c2VsZiBub3QgcmVhZHkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjaGVja0lzQXBwaXVtU3RhdHVzUmVhZHkoc3RhdHVzQm9keTogc3RyaW5nKTogYm9vbGVhbiB7XG4gIGxldCBwYXJzZWQ6IHVua25vd247XG4gIHRyeSB7XG4gICAgcGFyc2VkID0gSlNPTi5wYXJzZShzdGF0dXNCb2R5KTtcbiAgfSBjYXRjaCB7XG4gICAgcmV0dXJuIHRydWU7XG4gIH1cblxuICByZXR1cm4gcmVhZFJlYWR5RmxhZyhwYXJzZWQpICE9PSBmYWxzZTtcbn1cblxuLyoqXG4gKiBEZWNpZGVzIHdoYXQgdG8gZG8gd2l0aCBhIGZhaWxlZCBzZXNzaW9uIGF0dGVtcHQuXG4gKlxuICogVGhlIGRldmljZS1ub3QtZm91bmQgZXJyb3IgaXMgb25seSBldmlkZW5jZSBhZ2FpbnN0IHRoZSBzZXJ2ZXIgd2hlbiB0aGUgaG9zdCdzXG4gKiBhZGIgKmNhbiogc3RpbGwgc2VlIHRoZSBkZXZpY2U7IG90aGVyd2lzZSB0aGUgZXJyb3Igd2FzIGhvbmVzdCBhbmQgaXMgbGVmdFxuICogYWxvbmUuIEEgc2VydmVyIHRoaXMgaGFybmVzcyBzdGFydGVkIGluIGFuIGVhcmxpZXIgcnVuIGlzIHJlc3RhcnRlZCAodGhlXG4gKiBjb25maXJtZWQgcmVtZWR5KTsgZXZlcnkgb3RoZXIgd2VkZ2VkIHNlcnZlciBpcyByZXBvcnRlZCByYXRoZXIgdGhhbiBraWxsZWQsXG4gKiBiZWNhdXNlIHRlcm1pbmF0aW5nIGEgcHJvY2VzcyB0aGlzIHJ1biBkb2VzIG5vdCBvd24gaXMgbm90IGl0cyBjYWxsIHRvIG1ha2UuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBmYWlsZWQgYXR0ZW1wdCBhbmQgd2hhdCBpcyBrbm93biBhYm91dCB0aGUgc2VydmVyLlxuICogQHJldHVybnMgVGhlIHZlcmRpY3QuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZXNvbHZlV2VkZ2VkQXBwaXVtU2VydmVyUmVtZWR5KHBhcmFtczogUmVzb2x2ZVdlZGdlZEFwcGl1bVNlcnZlclJlbWVkeVBhcmFtcyk6IFdlZGdlZEFwcGl1bVNlcnZlclZlcmRpY3Qge1xuICBpZiAoIWNoZWNrSXNBcHBpdW1EZXZpY2VOb3RGb3VuZEVycm9yKHBhcmFtcy5lcnJvcikpIHtcbiAgICByZXR1cm4geyByZWFzb246ICdvdGhlci1lcnJvcicsIHJlbWVkeTogJ25vdC13ZWRnZWQnIH07XG4gIH1cblxuICBpZiAoIXBhcmFtcy5jb25uZWN0ZWREZXZpY2VJZHMuaW5jbHVkZXMocGFyYW1zLmRldmljZUlkKSkge1xuICAgIHJldHVybiB7IHJlYXNvbjogJ2RldmljZS1hYnNlbnQnLCByZW1lZHk6ICdub3Qtd2VkZ2VkJyB9O1xuICB9XG5cbiAgaWYgKCFwYXJhbXMuaXNBZG9wdGVkU2VydmVyKSB7XG4gICAgcmV0dXJuIHsgcmVhc29uOiAnZnJlc2hseS1zdGFydGVkJywgcmVtZWR5OiAncmVwb3J0JyB9O1xuICB9XG5cbiAgaWYgKCFwYXJhbXMuaXNBdXRvU3RhcnRBbGxvd2VkKSB7XG4gICAgcmV0dXJuIHsgcmVhc29uOiAnYXV0by1zdGFydC1kaXNhYmxlZCcsIHJlbWVkeTogJ3JlcG9ydCcgfTtcbiAgfVxuXG4gIGlmICghcGFyYW1zLmlzSGFybmVzc093bmVkU2VydmVyKSB7XG4gICAgcmV0dXJuIHsgcmVhc29uOiAnZm9yZWlnbi1zZXJ2ZXInLCByZW1lZHk6ICdyZXBvcnQnIH07XG4gIH1cblxuICByZXR1cm4geyByZWFzb246ICdoYXJuZXNzLW93bmVkJywgcmVtZWR5OiAncmVzdGFydCcgfTtcbn1cblxuZnVuY3Rpb24gZGVzY3JpYmVTZXJ2ZXIocGFyYW1zOiBCdWlsZFdlZGdlZEFwcGl1bVNlcnZlck1lc3NhZ2VQYXJhbXMpOiBzdHJpbmcge1xuICBpZiAocGFyYW1zLnNlcnZlclBpZCA9PT0gdW5kZWZpbmVkKSB7XG4gICAgcmV0dXJuICcnO1xuICB9XG5cbiAgY29uc3QgYWdlID0gcGFyYW1zLnNlcnZlckFnZUluTWlsbGlzZWNvbmRzID09PSB1bmRlZmluZWQgPyAnJyA6IGAsIHJ1bm5pbmcgZm9yICR7Zm9ybWF0QWdlKHBhcmFtcy5zZXJ2ZXJBZ2VJbk1pbGxpc2Vjb25kcyl9YDtcbiAgcmV0dXJuIGBUaGUgc2VydmVyIHdhcyBzdGFydGVkIGJ5IGFuIGVhcmxpZXIgb2JzaWRpYW4taW50ZWdyYXRpb24tdGVzdGluZyBydW4gKHBpZCAke1N0cmluZyhwYXJhbXMuc2VydmVyUGlkKX0ke2FnZX0pLmA7XG59XG5cbmZ1bmN0aW9uIGZvcm1hdEFnZShhZ2VJbk1pbGxpc2Vjb25kczogbnVtYmVyKTogc3RyaW5nIHtcbiAgaWYgKGFnZUluTWlsbGlzZWNvbmRzIDwgTUlMTElTRUNPTkRTX1BFUl9NSU5VVEUpIHtcbiAgICByZXR1cm4gYCR7U3RyaW5nKE1hdGgucm91bmQoYWdlSW5NaWxsaXNlY29uZHMgLyBNSUxMSVNFQ09ORFNfUEVSX1NFQ09ORCkpfXNgO1xuICB9XG5cbiAgcmV0dXJuIGAke1N0cmluZyhNYXRoLnJvdW5kKGFnZUluTWlsbGlzZWNvbmRzIC8gTUlMTElTRUNPTkRTX1BFUl9NSU5VVEUpKX1taW5gO1xufVxuXG5mdW5jdGlvbiByZWFkUmVhZHlGbGFnKHBhcnNlZDogdW5rbm93bik6IGJvb2xlYW4gfCB1bmRlZmluZWQge1xuICBpZiAodHlwZW9mIHBhcnNlZCAhPT0gJ29iamVjdCcgfHwgcGFyc2VkID09PSBudWxsKSB7XG4gICAgcmV0dXJuIHVuZGVmaW5lZDtcbiAgfVxuXG4gIGNvbnN0IHJlY29yZCA9IHBhcnNlZCBhcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPjtcbiAgY29uc3QgdmFsdWUgPSByZWNvcmRbJ3ZhbHVlJ107XG4gIGNvbnN0IG5lc3RlZCA9IHR5cGVvZiB2YWx1ZSA9PT0gJ29iamVjdCcgJiYgdmFsdWUgIT09IG51bGwgPyAodmFsdWUgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4pWydyZWFkeSddIDogdW5kZWZpbmVkO1xuICBjb25zdCByZWFkeSA9IG5lc3RlZCA/PyByZWNvcmRbJ3JlYWR5J107XG4gIHJldHVybiB0eXBlb2YgcmVhZHkgPT09ICdib29sZWFuJyA/IHJlYWR5IDogdW5kZWZpbmVkO1xufVxuXG5mdW5jdGlvbiByZXNvbHZlUmVtZWR5QWR2aWNlKHBhcmFtczogQnVpbGRXZWRnZWRBcHBpdW1TZXJ2ZXJNZXNzYWdlUGFyYW1zKTogc3RyaW5nIHtcbiAgY29uc3QgYWR2aWNlOiBSZWNvcmQ8V2VkZ2VkQXBwaXVtU2VydmVyUmVwb3J0UmVhc29uLCBzdHJpbmc+ID0ge1xuICAgICdhdXRvLXN0YXJ0LWRpc2FibGVkJzogYEFwcGl1bSBhdXRvLXN0YXJ0IGlzIGRpc2FibGVkIChcXGBzaG91bGRBdXRvU3RhcnRBcHBpdW06IGZhbHNlXFxgKSwgc28gdGhpcyBzZXJ2ZXIgaXMgeW91cnMgdG8gbWFuYWdlOiBraWxsIGl0IGFuZCBzdGFydCBhIGZyZXNoIG9uZSBvbiAke3BhcmFtcy5hcHBpdW1PcmlnaW59LCB0aGVuIHJlLXJ1bi5gLFxuICAgICdmb3JlaWduLXNlcnZlcic6IGBUaGlzIHNlcnZlciB3YXMgbm90IHN0YXJ0ZWQgYnkgb2JzaWRpYW4taW50ZWdyYXRpb24tdGVzdGluZywgc28gaXQgd2FzIGxlZnQgcnVubmluZzoga2lsbCBpdCBhbmQgc3RhcnQgYSBmcmVzaCBvbmUgb24gJHtwYXJhbXMuYXBwaXVtT3JpZ2lufSwgdGhlbiByZS1ydW4uYCxcbiAgICAnZnJlc2hseS1zdGFydGVkJzogJ1RoaXMgc2VydmVyIHdhcyBzdGFydGVkIGJ5IHRoaXMgcnVuLCBzbyByZXN0YXJ0aW5nIGl0IHdvdWxkIGNoYW5nZSBub3RoaW5nOiBjaGVjayB0aGF0IGFkYiBhbmQgdGhlIGVtdWxhdG9yIGFncmVlIChgYWRiIGtpbGwtc2VydmVyICYmIGFkYiBkZXZpY2VzYCksIHRoZW4gcmUtcnVuLicsXG4gICAgJ3Jlc3RhcnQtZGlkLW5vdC1oZWxwJzogYFJlc3RhcnRpbmcgdGhlIHNlcnZlciBvbiAke3BhcmFtcy5hcHBpdW1PcmlnaW59IGRpZCBub3QgaGVscCBcdTIwMTQgYSBmcmVzaCBvbmUgc3RpbGwgY291bGQgbm90IHNlcnZlIHRoaXMgcnVuLCBzbyB0aGUgd2VkZ2UgaXMgbm90IHRoZSBzZXJ2ZXIgYWxvbmU6IGNoZWNrIGFkYiBpdHNlbGYgKFxcYGFkYiBraWxsLXNlcnZlciAmJiBhZGIgZGV2aWNlc1xcYCkgYW5kIHRoYXQgbm90aGluZyBlbHNlIGhvbGRzIHRoZSBwb3J0LCB0aGVuIHJlLXJ1bi5gXG4gIH07XG5cbiAgcmV0dXJuIGFkdmljZVtwYXJhbXMucmVhc29uXTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFB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

package/dist/lib/cjs/wedged-appium-server.d.cts

@@ -0,0 +1,187 @@
+/**
+ * @file
+ *
+ * Pure helpers for recognizing a **wedged** Appium server and deciding what to
+ * do about it. Kept separate from the integration-only `transport-factory` so
+ * the classification, the remedy decision and the message stay unit-testable
+ * (the factory itself needs a real device and is excluded from unit tests).
+ *
+ * A wedged server is one that is still **live** — it listens on its port and
+ * answers `/status` with `ready: true` — but is no longer **usable**: its
+ * `appium-adb` can no longer enumerate devices, so every session creation dies
+ * with `Could not find a connected Android device in <n>ms` while the host's own
+ * `adb devices` lists the device instantly. Liveness is not readiness, and the
+ * error names the wrong subject: it blames a device that is demonstrably
+ * present, which sends whoever reads it to `adb devices` — the one diagnostic
+ * that actively misleads here.
+ *
+ * The wedge develops over time in a long-lived server (one auto-started by an
+ * earlier run and left listening), so the preflight cannot see it coming: it can
+ * only be recognized from the failed session, cross-checked against the host's
+ * adb.
+ */
+/**
+ * Parameters for {@link buildWedgedAppiumServerMessage}.
+ */
+export interface BuildWedgedAppiumServerMessageParams {
+    /**
+    Origin of the Appium server that could not see the device (e.g. `http://localhost:4723`).
+     */
+    readonly appiumOrigin: string;
+    /**
+    The device the host's adb can see but Appium cannot.
+     */
+    readonly deviceId: string;
+    /**
+    Why this run is reporting rather than restarting.
+     */
+    readonly reason: WedgedAppiumServerReportReason;
+    /**
+    How long the server has been running, when known from its marker.
+     */
+    readonly serverAgeInMilliseconds?: number | undefined;
+    /**
+    PID of the server, when known from its marker.
+     */
+    readonly serverPid?: number | undefined;
+}
+/**
+ * The server is not to blame: either the failure was a different error, or the
+ * host's adb cannot see the device either. The original error is rethrown.
+ */
+export interface NotWedgedVerdict {
+    /**
+    Which of the two honest-failure cases this is.
+     */
+    readonly reason: 'device-absent' | 'other-error';
+    /**
+    Discriminant.
+     */
+    readonly remedy: 'not-wedged';
+}
+/**
+ * The server is wedged but must not be touched by this run.
+ */
+export interface ReportServerVerdict {
+    /**
+    Why this run is reporting rather than restarting.
+     */
+    readonly reason: WedgedAppiumServerReportReason;
+    /**
+    Discriminant.
+     */
+    readonly remedy: 'report';
+}
+/**
+ * Parameters for {@link resolveWedgedAppiumServerRemedy}.
+ */
+export interface ResolveWedgedAppiumServerRemedyParams {
+    /**
+    Device IDs the **host's** adb currently lists (the cross-check that convicts the server).
+     */
+    readonly connectedDeviceIds: readonly string[];
+    /**
+    The device the session was requested against.
+     */
+    readonly deviceId: string;
+    /**
+    The error the session attempt failed with.
+     */
+    readonly error: unknown;
+    /**
+    Whether the server was already listening and was adopted, rather than started by this run.
+     */
+    readonly isAdoptedServer: boolean;
+    /**
+    Whether this run may start an Appium server (`shouldAutoStartAppium` is not `false`).
+     */
+    readonly isAutoStartAllowed: boolean;
+    /**
+    Whether the adopted server's marker proves an earlier run of this harness started it.
+     */
+    readonly isHarnessOwnedServer: boolean;
+}
+/**
+ * The server is wedged and an earlier run of this harness started it, so this
+ * run may replace it.
+ */
+export interface RestartServerVerdict {
+    /**
+    Always the harness-owned case.
+     */
+    readonly reason: 'harness-owned';
+    /**
+    Discriminant.
+     */
+    readonly remedy: 'restart';
+}
+/**
+ * The classification of a failed session attempt.
+ *
+ * `'device-absent'` and `'other-error'` are the not-wedged verdicts: the
+ * original error was honest and is rethrown untouched.
+ */
+export type WedgedAppiumServerReason = 'device-absent' | 'harness-owned' | 'other-error' | WedgedAppiumServerReportReason;
+/**
+ * What the factory should do with a failed session attempt.
+ */
+export type WedgedAppiumServerRemedy = 'not-wedged' | 'report' | 'restart';
+/**
+ * Why a wedged server is only reported rather than restarted. Each maps to its
+ * own remedy sentence — the whole point of the rewrite is that the message says
+ * what *this* run can and cannot do about the server it found.
+ */
+export type WedgedAppiumServerReportReason = 'auto-start-disabled' | 'foreign-server' | 'freshly-started' | 'restart-did-not-help';
+/**
+ * The verdict on a failed session attempt, discriminated by `remedy` so a
+ * `'report'` verdict carries a reason {@link buildWedgedAppiumServerMessage} can
+ * turn into advice.
+ */
+export type WedgedAppiumServerVerdict = NotWedgedVerdict | ReportServerVerdict | RestartServerVerdict;
+/**
+ * Builds the error message that replaces `Could not find a connected Android
+ * device`, naming the **server** and stating the evidence — the host's adb can
+ * see the device, so the server is the thing that is stale.
+ *
+ * @param params - The server, the device, and why this run is not restarting it.
+ * @returns The message.
+ */
+export declare function buildWedgedAppiumServerMessage(params: BuildWedgedAppiumServerMessageParams): string;
+/**
+ * Checks whether a failed session attempt is `appium-adb`'s device-enumeration
+ * failure. The whole `cause` chain is searched, so WebdriverIO's wrapping of the
+ * server's error does not hide it.
+ *
+ * @param error - The error the session attempt failed with.
+ * @returns `true` when it is the device-not-found failure.
+ */
+export declare function checkIsAppiumDeviceNotFoundError(error: unknown): boolean;
+/**
+ * Checks whether an Appium `/status` body reports a server that is accepting new
+ * sessions.
+ *
+ * Deliberately **tolerant**: only an explicit `ready: false` (Appium sets it
+ * while shutting down) is treated as not-ready. A body that cannot be parsed, or
+ * that omits the flag, reads as ready — an unrecognized shape must not make a
+ * healthy server look unreachable.
+ *
+ * This does not catch the wedge (a wedged server still answers `ready: true`);
+ * it closes the adjacent hole of adopting a server that is on its way down.
+ *
+ * @param statusBody - The raw `/status` response body.
+ * @returns `false` only when the server explicitly reports itself not ready.
+ */
+export declare function checkIsAppiumStatusReady(statusBody: string): boolean;
+/**
+ * Decides what to do with a failed session attempt.
+ *
+ * The device-not-found error is only evidence against the server when the host's
+ * adb *can* still see the device; otherwise the error was honest and is left
+ * alone. A server this harness started in an earlier run is restarted (the
+ * confirmed remedy); every other wedged server is reported rather than killed,
+ * because terminating a process this run does not own is not its call to make.
+ *
+ * @param params - The failed attempt and what is known about the server.
+ * @returns The verdict.
+ */
+export declare function resolveWedgedAppiumServerRemedy(params: ResolveWedgedAppiumServerRemedyParams): WedgedAppiumServerVerdict;

package/dist/lib/esm/appium-server-marker.d.mts

@@ -0,0 +1,81 @@
+/**
+ * @file
+ *
+ * Records which Appium server on a port this harness started, so a later run
+ * that finds a server already listening can tell **provenance**: one of our own
+ * servers left over from an earlier run, or a foreign one the user manages.
+ *
+ * The preflight adopts any server that answers `/status`, and adoption is the
+ * right default — starting a second server on an occupied port cannot work. But
+ * adopting silently means a wedged leftover (see `wedged-appium-server.ts`) is
+ * indistinguishable from a healthy server, and the harness has no basis on which
+ * to decide whether restarting it is its call to make. The marker supplies that
+ * basis: a server we started may be restarted, a foreign one is only ever
+ * reported.
+ *
+ * The marker is a small JSON sentinel next to the setup lock (`setup-lock.ts`),
+ * keyed by port, and is deliberately tolerant — a missing, unreadable, or
+ * mismatched marker simply reads as "not ours".
+ */
+/**
+ * Identifies the Appium server this harness started on a port.
+ */
+export interface AppiumServerMarker {
+    /**
+    PID of the spawned server process (the shell wrapper that owns the server's process tree).
+     */
+    readonly pid: number;
+    /**
+    The port the server was started on.
+     */
+    readonly port: number;
+    /**
+    When the server was started (`Date.now()` epoch milliseconds).
+     */
+    readonly startedAtInMilliseconds: number;
+}
+/**
+ * Parameters for {@link writeAppiumServerMarker}.
+ */
+export interface WriteAppiumServerMarkerParams {
+    /**
+    PID of the spawned server process.
+     */
+    readonly pid: number;
+    /**
+    The port the server was started on.
+     */
+    readonly port: number;
+}
+/**
+ * Checks whether the marked server is still running, which is what makes an
+ * adopted server ours to restart.
+ *
+ * A dead PID means the marker outlived its server, so whatever answers on that
+ * port now is somebody else's — the marker proves nothing about it.
+ *
+ * @param marker - The marker read for the port, or `undefined` when there is none.
+ * @returns `true` when an earlier run of this harness started the server now listening.
+ */
+export declare function checkIsHarnessOwnedAppiumServer(marker: AppiumServerMarker | undefined): boolean;
+/**
+ * Removes the marker for a port. Called once the marked server has been stopped,
+ * so a later run does not mistake a recycled PID for our server.
+ *
+ * @param port - The Appium server port.
+ */
+export declare function clearAppiumServerMarker(port: number): void;
+/**
+ * Reads the marker for a port.
+ *
+ * @param port - The Appium server port.
+ * @returns The marker, or `undefined` when there is none, it is unreadable, or it does not describe this port.
+ */
+export declare function readAppiumServerMarker(port: number): AppiumServerMarker | undefined;
+/**
+ * Records the server this run just started, stamping it with the current time so
+ * a later run can report how long it has been up.
+ *
+ * @param params - The started server's PID and port.
+ */
+export declare function writeAppiumServerMarker(params: WriteAppiumServerMarkerParams): void;

package/dist/lib/esm/appium-server-marker.mjs

@@ -0,0 +1,83 @@
+import {
+  mkdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import process from "node:process";
+import { log } from "./log.mjs";
+const MARKER_DIR_NAME = "obsidian-integration-testing";
+const MARKER_FILE_SUFFIX = ".appium-server.json";
+const PROCESS_EXISTENCE_PROBE_SIGNAL = 0;
+function checkIsHarnessOwnedAppiumServer(marker) {
+  if (!marker) {
+    return false;
+  }
+  try {
+    process.kill(marker.pid, PROCESS_EXISTENCE_PROBE_SIGNAL);
+    return true;
+  } catch (error) {
+    return getErrorCode(error) === "EPERM";
+  }
+}
+function clearAppiumServerMarker(port) {
+  try {
+    rmSync(getMarkerFilePath(port), { force: true });
+  } catch (error) {
+    log(`[appium-server-marker] Could not remove the marker for port ${String(port)}: ${getErrorMessage(error)}`);
+  }
+}
+function readAppiumServerMarker(port) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(getMarkerFilePath(port), "utf-8"));
+  } catch {
+    return void 0;
+  }
+  return parseMarker(parsed, port);
+}
+function writeAppiumServerMarker(params) {
+  const marker = {
+    pid: params.pid,
+    port: params.port,
+    startedAtInMilliseconds: Date.now()
+  };
+  try {
+    mkdirSync(getMarkerDirectory(), { recursive: true });
+    writeFileSync(getMarkerFilePath(params.port), JSON.stringify(marker));
+  } catch (error) {
+    log(`[appium-server-marker] Could not record the server on port ${String(params.port)}: ${getErrorMessage(error)}`);
+  }
+}
+function getErrorCode(error) {
+  return typeof error === "object" && error !== null && "code" in error ? String(error.code) : void 0;
+}
+function getErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function getMarkerDirectory() {
+  return join(tmpdir(), MARKER_DIR_NAME);
+}
+function getMarkerFilePath(port) {
+  return join(getMarkerDirectory(), `${String(port)}${MARKER_FILE_SUFFIX}`);
+}
+function parseMarker(parsed, port) {
+  if (typeof parsed !== "object" || parsed === null) {
+    return void 0;
+  }
+  const record = parsed;
+  const { pid, port: markedPort, startedAtInMilliseconds } = record;
+  if (typeof pid !== "number" || typeof startedAtInMilliseconds !== "number" || markedPort !== port) {
+    return void 0;
+  }
+  return { pid, port, startedAtInMilliseconds };
+}
+export {
+  checkIsHarnessOwnedAppiumServer,
+  clearAppiumServerMarker,
+  readAppiumServerMarker,
+  writeAppiumServerMarker
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2FwcGl1bS1zZXJ2ZXItbWFya2VyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogUmVjb3JkcyB3aGljaCBBcHBpdW0gc2VydmVyIG9uIGEgcG9ydCB0aGlzIGhhcm5lc3Mgc3RhcnRlZCwgc28gYSBsYXRlciBydW5cbiAqIHRoYXQgZmluZHMgYSBzZXJ2ZXIgYWxyZWFkeSBsaXN0ZW5pbmcgY2FuIHRlbGwgKipwcm92ZW5hbmNlKio6IG9uZSBvZiBvdXIgb3duXG4gKiBzZXJ2ZXJzIGxlZnQgb3ZlciBmcm9tIGFuIGVhcmxpZXIgcnVuLCBvciBhIGZvcmVpZ24gb25lIHRoZSB1c2VyIG1hbmFnZXMuXG4gKlxuICogVGhlIHByZWZsaWdodCBhZG9wdHMgYW55IHNlcnZlciB0aGF0IGFuc3dlcnMgYC9zdGF0dXNgLCBhbmQgYWRvcHRpb24gaXMgdGhlXG4gKiByaWdodCBkZWZhdWx0IFx1MjAxNCBzdGFydGluZyBhIHNlY29uZCBzZXJ2ZXIgb24gYW4gb2NjdXBpZWQgcG9ydCBjYW5ub3Qgd29yay4gQnV0XG4gKiBhZG9wdGluZyBzaWxlbnRseSBtZWFucyBhIHdlZGdlZCBsZWZ0b3ZlciAoc2VlIGB3ZWRnZWQtYXBwaXVtLXNlcnZlci50c2ApIGlzXG4gKiBpbmRpc3Rpbmd1aXNoYWJsZSBmcm9tIGEgaGVhbHRoeSBzZXJ2ZXIsIGFuZCB0aGUgaGFybmVzcyBoYXMgbm8gYmFzaXMgb24gd2hpY2hcbiAqIHRvIGRlY2lkZSB3aGV0aGVyIHJlc3RhcnRpbmcgaXQgaXMgaXRzIGNhbGwgdG8gbWFrZS4gVGhlIG1hcmtlciBzdXBwbGllcyB0aGF0XG4gKiBiYXNpczogYSBzZXJ2ZXIgd2Ugc3RhcnRlZCBtYXkgYmUgcmVzdGFydGVkLCBhIGZvcmVpZ24gb25lIGlzIG9ubHkgZXZlclxuICogcmVwb3J0ZWQuXG4gKlxuICogVGhlIG1hcmtlciBpcyBhIHNtYWxsIEpTT04gc2VudGluZWwgbmV4dCB0byB0aGUgc2V0dXAgbG9jayAoYHNldHVwLWxvY2sudHNgKSxcbiAqIGtleWVkIGJ5IHBvcnQsIGFuZCBpcyBkZWxpYmVyYXRlbHkgdG9sZXJhbnQgXHUyMDE0IGEgbWlzc2luZywgdW5yZWFkYWJsZSwgb3JcbiAqIG1pc21hdGNoZWQgbWFya2VyIHNpbXBseSByZWFkcyBhcyBcIm5vdCBvdXJzXCIuXG4gKi9cblxuaW1wb3J0IHtcbiAgbWtkaXJTeW5jLFxuICByZWFkRmlsZVN5bmMsXG4gIHJtU3luYyxcbiAgd3JpdGVGaWxlU3luY1xufSBmcm9tICdub2RlOmZzJztcbmltcG9ydCB7IHRtcGRpciB9IGZyb20gJ25vZGU6b3MnO1xuaW1wb3J0IHsgam9pbiB9IGZyb20gJ25vZGU6cGF0aCc7XG5pbXBvcnQgcHJvY2VzcyBmcm9tICdub2RlOnByb2Nlc3MnO1xuXG5pbXBvcnQgeyBsb2cgfSBmcm9tICcuL2xvZy5tanMnO1xuXG5jb25zdCBNQVJLRVJfRElSX05BTUUgPSAnb2JzaWRpYW4taW50ZWdyYXRpb24tdGVzdGluZyc7XG5jb25zdCBNQVJLRVJfRklMRV9TVUZGSVggPSAnLmFwcGl1bS1zZXJ2ZXIuanNvbic7XG5jb25zdCBQUk9DRVNTX0VYSVNURU5DRV9QUk9CRV9TSUdOQUwgPSAwO1xuXG4vKipcbiAqIElkZW50aWZpZXMgdGhlIEFwcGl1bSBzZXJ2ZXIgdGhpcyBoYXJuZXNzIHN0YXJ0ZWQgb24gYSBwb3J0LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEFwcGl1bVNlcnZlck1hcmtlciB7XG4gIC8qKlxuICBQSUQgb2YgdGhlIHNwYXduZWQgc2VydmVyIHByb2Nlc3MgKHRoZSBzaGVsbCB3cmFwcGVyIHRoYXQgb3ducyB0aGUgc2VydmVyJ3MgcHJvY2VzcyB0cmVlKS5cbiAgICovXG4gIHJlYWRvbmx5IHBpZDogbnVtYmVyO1xuXG4gIC8qKlxuICBUaGUgcG9ydCB0aGUgc2VydmVyIHdhcyBzdGFydGVkIG9uLlxuICAgKi9cbiAgcmVhZG9ubHkgcG9ydDogbnVtYmVyO1xuXG4gIC8qKlxuICBXaGVuIHRoZSBzZXJ2ZXIgd2FzIHN0YXJ0ZWQgKGBEYXRlLm5vdygpYCBlcG9jaCBtaWxsaXNlY29uZHMpLlxuICAgKi9cbiAgcmVhZG9ubHkgc3RhcnRlZEF0SW5NaWxsaXNlY29uZHM6IG51bWJlcjtcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgd3JpdGVBcHBpdW1TZXJ2ZXJNYXJrZXJ9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFdyaXRlQXBwaXVtU2VydmVyTWFya2VyUGFyYW1zIHtcbiAgLyoqXG4gIFBJRCBvZiB0aGUgc3Bhd25lZCBzZXJ2ZXIgcHJvY2Vzcy5cbiAgICovXG4gIHJlYWRvbmx5IHBpZDogbnVtYmVyO1xuXG4gIC8qKlxuICBUaGUgcG9ydCB0aGUgc2VydmVyIHdhcyBzdGFydGVkIG9uLlxuICAgKi9cbiAgcmVhZG9ubHkgcG9ydDogbnVtYmVyO1xufVxuXG4vKipcbiAqIENoZWNrcyB3aGV0aGVyIHRoZSBtYXJrZWQgc2VydmVyIGlzIHN0aWxsIHJ1bm5pbmcsIHdoaWNoIGlzIHdoYXQgbWFrZXMgYW5cbiAqIGFkb3B0ZWQgc2VydmVyIG91cnMgdG8gcmVzdGFydC5cbiAqXG4gKiBBIGRlYWQgUElEIG1lYW5zIHRoZSBtYXJrZXIgb3V0bGl2ZWQgaXRzIHNlcnZlciwgc28gd2hhdGV2ZXIgYW5zd2VycyBvbiB0aGF0XG4gKiBwb3J0IG5vdyBpcyBzb21lYm9keSBlbHNlJ3MgXHUyMDE0IHRoZSBtYXJrZXIgcHJvdmVzIG5vdGhpbmcgYWJvdXQgaXQuXG4gKlxuICogQHBhcmFtIG1hcmtlciAtIFRoZSBtYXJrZXIgcmVhZCBmb3IgdGhlIHBvcnQsIG9yIGB1bmRlZmluZWRgIHdoZW4gdGhlcmUgaXMgbm9uZS5cbiAqIEByZXR1cm5zIGB0cnVlYCB3aGVuIGFuIGVhcmxpZXIgcnVuIG9mIHRoaXMgaGFybmVzcyBzdGFydGVkIHRoZSBzZXJ2ZXIgbm93IGxpc3RlbmluZy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNoZWNrSXNIYXJuZXNzT3duZWRBcHBpdW1TZXJ2ZXIobWFya2VyOiBBcHBpdW1TZXJ2ZXJNYXJrZXIgfCB1bmRlZmluZWQpOiBib29sZWFuIHtcbiAgaWYgKCFtYXJrZXIpIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cblxuICB0cnkge1xuICAgIHByb2Nlc3Mua2lsbChtYXJrZXIucGlkLCBQUk9DRVNTX0VYSVNURU5DRV9QUk9CRV9TSUdOQUwpO1xuICAgIHJldHVybiB0cnVlO1xuICB9IGNhdGNoIChlcnJvcjogdW5rbm93bikge1xuICAgIC8vIGBFUEVSTWAgbWVhbnMgdGhlIHByb2Nlc3MgZXhpc3RzIGJ1dCBpcyBvd25lZCBieSBhbm90aGVyIHVzZXIgXHUyMDE0IHN0aWxsIGFsaXZlLlxuICAgIHJldHVybiBnZXRFcnJvckNvZGUoZXJyb3IpID09PSAnRVBFUk0nO1xuICB9XG59XG5cbi8qKlxuICogUmVtb3ZlcyB0aGUgbWFya2VyIGZvciBhIHBvcnQuIENhbGxlZCBvbmNlIHRoZSBtYXJrZWQgc2VydmVyIGhhcyBiZWVuIHN0b3BwZWQsXG4gKiBzbyBhIGxhdGVyIHJ1biBkb2VzIG5vdCBtaXN0YWtlIGEgcmVjeWNsZWQgUElEIGZvciBvdXIgc2VydmVyLlxuICpcbiAqIEBwYXJhbSBwb3J0IC0gVGhlIEFwcGl1bSBzZXJ2ZXIgcG9ydC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNsZWFyQXBwaXVtU2VydmVyTWFya2VyKHBvcnQ6IG51bWJlcik6IHZvaWQge1xuICB0cnkge1xuICAgIHJtU3luYyhnZXRNYXJrZXJGaWxlUGF0aChwb3J0KSwgeyBmb3JjZTogdHJ1ZSB9KTtcbiAgfSBjYXRjaCAoZXJyb3I6IHVua25vd24pIHtcbiAgICBsb2coYFthcHBpdW0tc2VydmVyLW1hcmtlcl0gQ291bGQgbm90IHJlbW92ZSB0aGUgbWFya2VyIGZvciBwb3J0ICR7U3RyaW5nKHBvcnQpfTogJHtnZXRFcnJvck1lc3NhZ2UoZXJyb3IpfWApO1xuICB9XG59XG5cbi8qKlxuICogUmVhZHMgdGhlIG1hcmtlciBmb3IgYSBwb3J0LlxuICpcbiAqIEBwYXJhbSBwb3J0IC0gVGhlIEFwcGl1bSBzZXJ2ZXIgcG9ydC5cbiAqIEByZXR1cm5zIFRoZSBtYXJrZXIsIG9yIGB1bmRlZmluZWRgIHdoZW4gdGhlcmUgaXMgbm9uZSwgaXQgaXMgdW5yZWFkYWJsZSwgb3IgaXQgZG9lcyBub3QgZGVzY3JpYmUgdGhpcyBwb3J0LlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVhZEFwcGl1bVNlcnZlck1hcmtlcihwb3J0OiBudW1iZXIpOiBBcHBpdW1TZXJ2ZXJNYXJrZXIgfCB1bmRlZmluZWQge1xuICBsZXQgcGFyc2VkOiB1bmtub3duO1xuICB0cnkge1xuICAgIHBhcnNlZCA9IEpTT04ucGFyc2UocmVhZEZpbGVTeW5jKGdldE1hcmtlckZpbGVQYXRoKHBvcnQpLCAndXRmLTgnKSk7XG4gIH0gY2F0Y2gge1xuICAgIHJldHVybiB1bmRlZmluZWQ7XG4gIH1cblxuICByZXR1cm4gcGFyc2VNYXJrZXIocGFyc2VkLCBwb3J0KTtcbn1cblxuLyoqXG4gKiBSZWNvcmRzIHRoZSBzZXJ2ZXIgdGhpcyBydW4ganVzdCBzdGFydGVkLCBzdGFtcGluZyBpdCB3aXRoIHRoZSBjdXJyZW50IHRpbWUgc29cbiAqIGEgbGF0ZXIgcnVuIGNhbiByZXBvcnQgaG93IGxvbmcgaXQgaGFzIGJlZW4gdXAuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBzdGFydGVkIHNlcnZlcidzIFBJRCBhbmQgcG9ydC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHdyaXRlQXBwaXVtU2VydmVyTWFya2VyKHBhcmFtczogV3JpdGVBcHBpdW1TZXJ2ZXJNYXJrZXJQYXJhbXMpOiB2b2lkIHtcbiAgY29uc3QgbWFya2VyOiBBcHBpdW1TZXJ2ZXJNYXJrZXIgPSB7XG4gICAgcGlkOiBwYXJhbXMucGlkLFxuICAgIHBvcnQ6IHBhcmFtcy5wb3J0LFxuICAgIHN0YXJ0ZWRBdEluTWlsbGlzZWNvbmRzOiBEYXRlLm5vdygpXG4gIH07XG5cbiAgdHJ5IHtcbiAgICBta2RpclN5bmMoZ2V0TWFya2VyRGlyZWN0b3J5KCksIHsgcmVjdXJzaXZlOiB0cnVlIH0pO1xuICAgIHdyaXRlRmlsZVN5bmMoZ2V0TWFya2VyRmlsZVBhdGgocGFyYW1zLnBvcnQpLCBKU09OLnN0cmluZ2lmeShtYXJrZXIpKTtcbiAgfSBjYXRjaCAoZXJyb3I6IHVua25vd24pIHtcbiAgICBsb2coYFthcHBpdW0tc2VydmVyLW1hcmtlcl0gQ291bGQgbm90IHJlY29yZCB0aGUgc2VydmVyIG9uIHBvcnQgJHtTdHJpbmcocGFyYW1zLnBvcnQpfTogJHtnZXRFcnJvck1lc3NhZ2UoZXJyb3IpfWApO1xuICB9XG59XG5cbmZ1bmN0aW9uIGdldEVycm9yQ29kZShlcnJvcjogdW5rbm93bik6IHN0cmluZyB8IHVuZGVmaW5lZCB7XG4gIHJldHVybiB0eXBlb2YgZXJyb3IgPT09ICdvYmplY3QnICYmIGVycm9yICE9PSBudWxsICYmICdjb2RlJyBpbiBlcnJvciA/IFN0cmluZyhlcnJvci5jb2RlKSA6IHVuZGVmaW5lZDtcbn1cblxuZnVuY3Rpb24gZ2V0RXJyb3JNZXNzYWdlKGVycm9yOiB1bmtub3duKTogc3RyaW5nIHtcbiAgcmV0dXJuIGVycm9yIGluc3RhbmNlb2YgRXJyb3IgPyBlcnJvci5tZXNzYWdlIDogU3RyaW5nKGVycm9yKTtcbn1cblxuZnVuY3Rpb24gZ2V0TWFya2VyRGlyZWN0b3J5KCk6IHN0cmluZyB7XG4gIHJldHVybiBqb2luKHRtcGRpcigpLCBNQVJLRVJfRElSX05BTUUpO1xufVxuXG5mdW5jdGlvbiBnZXRNYXJrZXJGaWxlUGF0aChwb3J0OiBudW1iZXIpOiBzdHJpbmcge1xuICByZXR1cm4gam9pbihnZXRNYXJrZXJEaXJlY3RvcnkoKSwgYCR7U3RyaW5nKHBvcnQpfSR7TUFSS0VSX0ZJTEVfU1VGRklYfWApO1xufVxuXG5mdW5jdGlvbiBwYXJzZU1hcmtlcihwYXJzZWQ6IHVua25vd24sIHBvcnQ6IG51bWJlcik6IEFwcGl1bVNlcnZlck1hcmtlciB8IHVuZGVmaW5lZCB7XG4gIGlmICh0eXBlb2YgcGFyc2VkICE9PSAnb2JqZWN0JyB8fCBwYXJzZWQgPT09IG51bGwpIHtcbiAgICByZXR1cm4gdW5kZWZpbmVkO1xuICB9XG5cbiAgY29uc3QgcmVjb3JkID0gcGFyc2VkIGFzIFJlY29yZDxzdHJpbmcsIHVua25vd24+O1xuICBjb25zdCB7IHBpZCwgcG9ydDogbWFya2VkUG9ydCwgc3RhcnRlZEF0SW5NaWxsaXNlY29uZHMgfSA9IHJlY29yZDtcblxuICBpZiAodHlwZW9mIHBpZCAhPT0gJ251bWJlcicgfHwgdHlwZW9mIHN0YXJ0ZWRBdEluTWlsbGlzZWNvbmRzICE9PSAnbnVtYmVyJyB8fCBtYXJrZWRQb3J0ICE9PSBwb3J0KSB7XG4gICAgcmV0dXJuIHVuZGVmaW5lZDtcbiAgfVxuXG4gIHJldHVybiB7IHBpZCwgcG9ydCwgc3RhcnRlZEF0SW5NaWxsaXNlY29uZHMgfTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICJBQW9CQTtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1AsU0FBUyxjQUFjO0FBQ3ZCLFNBQVMsWUFBWTtBQUNyQixPQUFPLGFBQWE7QUFFcEIsU0FBUyxXQUFXO0FBRXBCLE1BQU0sa0JBQWtCO0FBQ3hCLE1BQU0scUJBQXFCO0FBQzNCLE1BQU0saUNBQWlDO0FBK0NoQyxTQUFTLGdDQUFnQyxRQUFpRDtBQUMvRixNQUFJLENBQUMsUUFBUTtBQUNYLFdBQU87QUFBQSxFQUNUO0FBRUEsTUFBSTtBQUNGLFlBQVEsS0FBSyxPQUFPLEtBQUssOEJBQThCO0FBQ3ZELFdBQU87QUFBQSxFQUNULFNBQVMsT0FBZ0I7QUFFdkIsV0FBTyxhQUFhLEtBQUssTUFBTTtBQUFBLEVBQ2pDO0FBQ0Y7QUFRTyxTQUFTLHdCQUF3QixNQUFvQjtBQUMxRCxNQUFJO0FBQ0YsV0FBTyxrQkFBa0IsSUFBSSxHQUFHLEVBQUUsT0FBTyxLQUFLLENBQUM7QUFBQSxFQUNqRCxTQUFTLE9BQWdCO0FBQ3ZCLFFBQUksK0RBQStELE9BQU8sSUFBSSxDQUFDLEtBQUssZ0JBQWdCLEtBQUssQ0FBQyxFQUFFO0FBQUEsRUFDOUc7QUFDRjtBQVFPLFNBQVMsdUJBQXVCLE1BQThDO0FBQ25GLE1BQUk7QUFDSixNQUFJO0FBQ0YsYUFBUyxLQUFLLE1BQU0sYUFBYSxrQkFBa0IsSUFBSSxHQUFHLE9BQU8sQ0FBQztBQUFBLEVBQ3BFLFFBQVE7QUFDTixXQUFPO0FBQUEsRUFDVDtBQUVBLFNBQU8sWUFBWSxRQUFRLElBQUk7QUFDakM7QUFRTyxTQUFTLHdCQUF3QixRQUE2QztBQUNuRixRQUFNLFNBQTZCO0FBQUEsSUFDakMsS0FBSyxPQUFPO0FBQUEsSUFDWixNQUFNLE9BQU87QUFBQSxJQUNiLHlCQUF5QixLQUFLLElBQUk7QUFBQSxFQUNwQztBQUVBLE1BQUk7QUFDRixjQUFVLG1CQUFtQixHQUFHLEVBQUUsV0FBVyxLQUFLLENBQUM7QUFDbkQsa0JBQWMsa0JBQWtCLE9BQU8sSUFBSSxHQUFHLEtBQUssVUFBVSxNQUFNLENBQUM7QUFBQSxFQUN0RSxTQUFTLE9BQWdCO0FBQ3ZCLFFBQUksOERBQThELE9BQU8sT0FBTyxJQUFJLENBQUMsS0FBSyxnQkFBZ0IsS0FBSyxDQUFDLEVBQUU7QUFBQSxFQUNwSDtBQUNGO0FBRUEsU0FBUyxhQUFhLE9BQW9DO0FBQ3hELFNBQU8sT0FBTyxVQUFVLFlBQVksVUFBVSxRQUFRLFVBQVUsUUFBUSxPQUFPLE1BQU0sSUFBSSxJQUFJO0FBQy9GO0FBRUEsU0FBUyxnQkFBZ0IsT0FBd0I7QUFDL0MsU0FBTyxpQkFBaUIsUUFBUSxNQUFNLFVBQVUsT0FBTyxLQUFLO0FBQzlEO0FBRUEsU0FBUyxxQkFBNkI7QUFDcEMsU0FBTyxLQUFLLE9BQU8sR0FBRyxlQUFlO0FBQ3ZDO0FBRUEsU0FBUyxrQkFBa0IsTUFBc0I7QUFDL0MsU0FBTyxLQUFLLG1CQUFtQixHQUFHLEdBQUcsT0FBTyxJQUFJLENBQUMsR0FBRyxrQkFBa0IsRUFBRTtBQUMxRTtBQUVBLFNBQVMsWUFBWSxRQUFpQixNQUE4QztBQUNsRixNQUFJLE9BQU8sV0FBVyxZQUFZLFdBQVcsTUFBTTtBQUNqRCxXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sU0FBUztBQUNmLFFBQU0sRUFBRSxLQUFLLE1BQU0sWUFBWSx3QkFBd0IsSUFBSTtBQUUzRCxNQUFJLE9BQU8sUUFBUSxZQUFZLE9BQU8sNEJBQTRCLFlBQVksZUFBZSxNQUFNO0FBQ2pHLFdBQU87QUFBQSxFQUNUO0FBRUEsU0FBTyxFQUFFLEtBQUssTUFBTSx3QkFBd0I7QUFDOUM7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/cli.d.mts

@@ -1,16 +1,24 @@
 /**
  * @file
  *
- * Thin CLI over {@link connectToCdp}: launches (or attaches to) a CDP-enabled
- * Obsidian instance with the runtime helper namespace bootstrapped, prints the
- * chosen CDP port/URL, and stays alive until interrupted so an external tool
- * (raw CDP `ws`, DevTools, …) can attach.
+ * The package's CLI. Two commands:
+ *
+ * - The **default** (no subcommand) — a thin CLI over {@link connectToCdp}: launches
+ *   (or attaches to) a CDP-enabled Obsidian instance with the runtime helper
+ *   namespace bootstrapped, prints the chosen CDP port/URL, and stays alive until
+ *   interrupted so an external tool (raw CDP `ws`, DevTools, …) can attach.
+ * - **`bootstrap-demo-vault`** — installs a demo vault's injected community plugins
+ *   headlessly (see `demo-vault-bootstrap.ts`). This is the copy-pasteable remedy
+ *   `buildDemoVaultPopulate`'s throw names, replacing the GUI-only "open
+ *   `demo-vault/` in Obsidian once" step that a fresh clone or CI cannot perform.
+ *
+ * Anything that is not a recognized subcommand falls through to the default
+ * command, so `obsidian-integration-testing --vault …` keeps working unchanged.
  */
 /**
- * Parses CLI arguments, opens the connection, prints its endpoint, and blocks
- * until `SIGINT`/`SIGTERM` or the owned Obsidian window is closed, disposing the
- * connection on shutdown.
+ * Dispatches to the requested subcommand, falling through to the default CDP
+ * command for anything that is not one.
  *
- * @returns A {@link Promise} that resolves once the connection has been disposed.
+ * @returns A {@link Promise} that resolves once the chosen command has finished.
  */
 export declare function main(): Promise<void>;