obsidian-integration-testing 1.1.2 → 1.2.0

package/dist/lib/cjs/transport-desktop-cli.cjs

@@ -0,0 +1,221 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var transport_desktop_cli_exports = {};
+__export(transport_desktop_cli_exports, {
+  DesktopCliTransport: () => DesktopCliTransport
+});
+module.exports = __toCommonJS(transport_desktop_cli_exports);
+var import_node_process = __toESM(require("node:process"), 1);
+var import_exec = require("./exec.cjs");
+var import_obsidian_config = require("./obsidian-config.cjs");
+const UNABLE_TO_FIND_OBSIDIAN = "unable to find Obsidian";
+const AUTO_START_POLL_INTERVAL_IN_MILLISECONDS = 2e3;
+const AUTO_START_TIMEOUT_IN_MILLISECONDS = 3e4;
+const VAULT_POLL_INTERVAL_IN_MILLISECONDS = 500;
+const VAULT_POLL_TIMEOUT_IN_MILLISECONDS = 3e4;
+const VAULT_CLOSE_DELAY_IN_MILLISECONDS = 1e3;
+class DesktopCliTransport {
+  /** */
+  isMobile = false;
+  /**
+   * Evaluates a JavaScript expression inside Obsidian via `obsidian eval`.
+   *
+   * Handles auto-start: if Obsidian is not running, launches it via URI protocol
+   * and retries until it becomes available.
+   *
+   * @param expression - The JavaScript expression to evaluate.
+   * @param options - Evaluation options.
+   * @returns The normalized result string (transport-specific prefixes stripped).
+   */
+  async evaluate(expression, options) {
+    const command = ["obsidian", "eval", `code=${expression}`];
+    let resultStr;
+    try {
+      resultStr = await (0, import_exec.exec)(command, { cwd: options.cwd, isQuiet: true });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      if (message.includes(UNABLE_TO_FIND_OBSIDIAN)) {
+        resultStr = await this.ensureObsidianRunningAndRetry(command, options.cwd);
+      } else {
+        throw error;
+      }
+    }
+    if (resultStr === "" || resultStr === "Vault not found.") {
+      throw new Error(`Unexpected empty response from Obsidian for path: ${options.cwd}`);
+    }
+    const lines = resultStr.split("\n");
+    const resultLine = lines.findLast((line) => line.startsWith("=> "));
+    if (resultLine) {
+      return resultLine.slice("=> ".length);
+    }
+    return resultStr;
+  }
+  /**
+   * Runs CLI-specific preflight checks.
+   *
+   * Verifies that the vault is registered, CLI is enabled in Obsidian settings,
+   * and the `obsidian` CLI binary is available in PATH.
+   *
+   * @param vaultPath - The absolute path to the vault folder.
+   */
+  async preflightCheck(vaultPath) {
+    if (!(0, import_obsidian_config.isVaultRegistered)(vaultPath)) {
+      throw new Error(
+        `Vault is not registered in Obsidian: ${vaultPath}. Register the vault first with registerVault() or TempVault.register().`
+      );
+    }
+    if (!(0, import_obsidian_config.isCliEnabled)()) {
+      throw new Error("Obsidian CLI is disabled. Enable it in Obsidian Settings \u2192 General \u2192 CLI.");
+    }
+    await this.assertCliAvailable();
+  }
+  /**
+   * Registers a vault in the running Obsidian instance via Electron IPC.
+   *
+   * Uses `vault-open` IPC to register and open the vault, then polls until
+   * the vault's CLI is ready and `getBasePath()` matches `vaultPath`.
+   *
+   * @param vaultPath - The absolute path to the vault folder.
+   */
+  async registerVault(vaultPath) {
+    const registerExpr = buildIpcExpression(
+      `window.electron.ipcRenderer.sendSync('vault-open', ${JSON.stringify(vaultPath)}, false);`
+    );
+    await this.evaluate(registerExpr, { cwd: import_node_process.default.cwd() });
+    const pollExpr = buildSimpleExpression(
+      "return JSON.stringify(app.vault.adapter.getBasePath());"
+    );
+    const deadline = Date.now() + VAULT_POLL_TIMEOUT_IN_MILLISECONDS;
+    while (Date.now() < deadline) {
+      try {
+        const basePath = await this.evaluate(pollExpr, { cwd: vaultPath });
+        if (JSON.parse(basePath) === vaultPath) {
+          return;
+        }
+      } catch {
+      }
+      await delay(VAULT_POLL_INTERVAL_IN_MILLISECONDS);
+    }
+    throw new Error(`Vault at ${vaultPath} did not become ready within ${String(VAULT_POLL_TIMEOUT_IN_MILLISECONDS)}ms`);
+  }
+  /**
+   * Unregisters a vault from the running Obsidian instance.
+   *
+   * Schedules the vault window to close, waits, then removes the vault
+   * from the registry via `vault-remove` IPC.
+   *
+   * @param vaultPath - The absolute path to the vault folder.
+   */
+  async unregisterVault(vaultPath) {
+    const destroyExpr = buildSimpleExpression(`
+      setTimeout(() => {
+        if (window.electron && window.electron.remote) {
+          window.electron.remote.getCurrentWindow().destroy();
+        }
+      }, 0);
+    `);
+    try {
+      await this.evaluate(destroyExpr, { cwd: vaultPath });
+    } catch {
+    }
+    await delay(VAULT_CLOSE_DELAY_IN_MILLISECONDS);
+    const removeExpr = buildIpcExpression(
+      `window.electron.ipcRenderer.sendSync('vault-remove', ${JSON.stringify(vaultPath)});`
+    );
+    await this.evaluate(removeExpr, { cwd: import_node_process.default.cwd() });
+  }
+  /**
+   * Checks whether the Obsidian CLI binary is available in the system PATH.
+   */
+  async assertCliAvailable() {
+    const command = import_node_process.default.platform === "win32" ? "where.exe obsidian" : "which obsidian";
+    try {
+      await (0, import_exec.exec)(command, { isQuiet: true });
+    } catch {
+      throw new Error("Obsidian CLI is not available. Ensure Obsidian is installed and its CLI is in your PATH.");
+    }
+  }
+  /**
+   * Launches Obsidian binary and retries the eval until it responds.
+   *
+   * @param command - The CLI command array to retry.
+   * @param cwd - The working directory.
+   * @returns The result string from the successful eval.
+   */
+  async ensureObsidianRunningAndRetry(command, cwd) {
+    console.warn("Obsidian is not running. Starting Obsidian...");
+    try {
+      await (0, import_exec.exec)(getObsidianLaunchCommand(), { isQuiet: true });
+    } catch {
+    }
+    const deadline = Date.now() + AUTO_START_TIMEOUT_IN_MILLISECONDS;
+    while (Date.now() < deadline) {
+      await delay(AUTO_START_POLL_INTERVAL_IN_MILLISECONDS);
+      try {
+        return await (0, import_exec.exec)(command, { cwd, isQuiet: true });
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!message.includes(UNABLE_TO_FIND_OBSIDIAN)) {
+          throw error;
+        }
+      }
+    }
+    throw new Error(`Obsidian did not start within ${String(AUTO_START_TIMEOUT_IN_MILLISECONDS)}ms.`);
+  }
+}
+function buildIpcExpression(ipcStatement) {
+  return buildSimpleExpression(ipcStatement);
+}
+function buildSimpleExpression(body) {
+  return `(async () => {
+  if (!app.workspace.layoutReady) {
+    await new Promise((resolve) => app.workspace.onLayoutReady(resolve));
+  }
+  ${body}
+})()`;
+}
+function delay(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+function getObsidianLaunchCommand() {
+  if (import_node_process.default.platform === "win32") {
+    return 'start "" "%LOCALAPPDATA%\\Programs\\Obsidian\\Obsidian.exe"';
+  }
+  if (import_node_process.default.platform === "darwin") {
+    return "/Applications/Obsidian.app/Contents/MacOS/Obsidian &";
+  }
+  return "obsidian &";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DesktopCliTransport
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3RyYW5zcG9ydC1kZXNrdG9wLWNsaS50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIERlc2t0b3AgQ0xJIHRyYW5zcG9ydCBcdTIwMTQgZXZhbHVhdGVzIGV4cHJlc3Npb25zIHZpYSBgb2JzaWRpYW4gZXZhbGAgYW5kIG1hbmFnZXNcbiAqIHZhdWx0cyB2aWEgRWxlY3Ryb24gSVBDLlxuICovXG5cbi8qIHY4IGlnbm9yZSBzdGFydCAtLSBJbnRlZ3JhdGlvbi10aW1lIGNvZGUgY292ZXJlZCBieSBpbnRlZ3JhdGlvbiB0ZXN0cywgbm90IHVuaXQgdGVzdHMuICovXG5cbmltcG9ydCBwcm9jZXNzIGZyb20gJ25vZGU6cHJvY2Vzcyc7XG5cbmltcG9ydCB0eXBlIHtcbiAgT2JzaWRpYW5UcmFuc3BvcnQsXG4gIFRyYW5zcG9ydEV2YWxPcHRpb25zXG59IGZyb20gJy4vdHJhbnNwb3J0LmNqcyc7XG5cbmltcG9ydCB7IGV4ZWMgfSBmcm9tICcuL2V4ZWMuY2pzJztcbmltcG9ydCB7XG4gIGlzQ2xpRW5hYmxlZCxcbiAgaXNWYXVsdFJlZ2lzdGVyZWRcbn0gZnJvbSAnLi9vYnNpZGlhbi1jb25maWcuY2pzJztcblxuY29uc3QgVU5BQkxFX1RPX0ZJTkRfT0JTSURJQU4gPSAndW5hYmxlIHRvIGZpbmQgT2JzaWRpYW4nO1xuY29uc3QgQVVUT19TVEFSVF9QT0xMX0lOVEVSVkFMX0lOX01JTExJU0VDT05EUyA9IDIwMDA7XG5jb25zdCBBVVRPX1NUQVJUX1RJTUVPVVRfSU5fTUlMTElTRUNPTkRTID0gMzAwMDA7XG5jb25zdCBWQVVMVF9QT0xMX0lOVEVSVkFMX0lOX01JTExJU0VDT05EUyA9IDUwMDtcbmNvbnN0IFZBVUxUX1BPTExfVElNRU9VVF9JTl9NSUxMSVNFQ09ORFMgPSAzMDAwMDtcbmNvbnN0IFZBVUxUX0NMT1NFX0RFTEFZX0lOX01JTExJU0VDT05EUyA9IDEwMDA7XG5cbi8qKlxuICogVHJhbnNwb3J0IHRoYXQgY29tbXVuaWNhdGVzIHdpdGggRGVza3RvcCBPYnNpZGlhbiB2aWEgdGhlIGBvYnNpZGlhbiBldmFsYCBDTEkgY29tbWFuZFxuICogYW5kIG1hbmFnZXMgdmF1bHRzIHZpYSBFbGVjdHJvbiBJUEMuXG4gKi9cbmV4cG9ydCBjbGFzcyBEZXNrdG9wQ2xpVHJhbnNwb3J0IGltcGxlbWVudHMgT2JzaWRpYW5UcmFuc3BvcnQge1xuICAvKiogKi9cbiAgcHVibGljIHJlYWRvbmx5IGlzTW9iaWxlID0gZmFsc2U7XG5cbiAgLyoqXG4gICAqIEV2YWx1YXRlcyBhIEphdmFTY3JpcHQgZXhwcmVzc2lvbiBpbnNpZGUgT2JzaWRpYW4gdmlhIGBvYnNpZGlhbiBldmFsYC5cbiAgICpcbiAgICogSGFuZGxlcyBhdXRvLXN0YXJ0OiBpZiBPYnNpZGlhbiBpcyBub3QgcnVubmluZywgbGF1bmNoZXMgaXQgdmlhIFVSSSBwcm90b2NvbFxuICAgKiBhbmQgcmV0cmllcyB1bnRpbCBpdCBiZWNvbWVzIGF2YWlsYWJsZS5cbiAgICpcbiAgICogQHBhcmFtIGV4cHJlc3Npb24gLSBUaGUgSmF2YVNjcmlwdCBleHByZXNzaW9uIHRvIGV2YWx1YXRlLlxuICAgKiBAcGFyYW0gb3B0aW9ucyAtIEV2YWx1YXRpb24gb3B0aW9ucy5cbiAgICogQHJldHVybnMgVGhlIG5vcm1hbGl6ZWQgcmVzdWx0IHN0cmluZyAodHJhbnNwb3J0LXNwZWNpZmljIHByZWZpeGVzIHN0cmlwcGVkKS5cbiAgICovXG4gIHB1YmxpYyBhc3luYyBldmFsdWF0ZShleHByZXNzaW9uOiBzdHJpbmcsIG9wdGlvbnM6IFRyYW5zcG9ydEV2YWxPcHRpb25zKTogUHJvbWlzZTxzdHJpbmc+IHtcbiAgICBjb25zdCBjb21tYW5kID0gWydvYnNpZGlhbicsICdldmFsJywgYGNvZGU9JHtleHByZXNzaW9ufWBdO1xuXG4gICAgbGV0IHJlc3VsdFN0cjogc3RyaW5nO1xuICAgIHRyeSB7XG4gICAgICByZXN1bHRTdHIgPSBhd2FpdCBleGVjKGNvbW1hbmQsIHsgY3dkOiBvcHRpb25zLmN3ZCwgaXNRdWlldDogdHJ1ZSB9KTtcbiAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgY29uc3QgbWVzc2FnZSA9IGVycm9yIGluc3RhbmNlb2YgRXJyb3IgPyBlcnJvci5tZXNzYWdlIDogU3RyaW5nKGVycm9yKTtcbiAgICAgIGlmIChtZXNzYWdlLmluY2x1ZGVzKFVOQUJMRV9UT19GSU5EX09CU0lESUFOKSkge1xuICAgICAgICByZXN1bHRTdHIgPSBhd2FpdCB0aGlzLmVuc3VyZU9ic2lkaWFuUnVubmluZ0FuZFJldHJ5KGNvbW1hbmQsIG9wdGlvbnMuY3dkKTtcbiAgICAgIH0gZWxzZSB7XG4gICAgICAgIHRocm93IGVycm9yO1xuICAgICAgfVxuICAgIH1cblxuICAgIGlmIChyZXN1bHRTdHIgPT09ICcnIHx8IHJlc3VsdFN0ciA9PT0gJ1ZhdWx0IG5vdCBmb3VuZC4nKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYFVuZXhwZWN0ZWQgZW1wdHkgcmVzcG9uc2UgZnJvbSBPYnNpZGlhbiBmb3IgcGF0aDogJHtvcHRpb25zLmN3ZH1gKTtcbiAgICB9XG5cbiAgICAvLyBUaGUgQ0xJIG1heSBwcmVwZW5kIGVycm9yL3dhcm5pbmcgbGluZXMgYmVmb3JlIHRoZSByZXN1bHQuXG4gICAgLy8gRmluZCB0aGUgbGFzdCBgPT4gYCBsaW5lIHdoaWNoIGNvbnRhaW5zIHRoZSBhY3R1YWwgcmVzdWx0LlxuICAgIGNvbnN0IGxpbmVzID0gcmVzdWx0U3RyLnNwbGl0KCdcXG4nKTtcbiAgICBjb25zdCByZXN1bHRMaW5lID0gbGluZXMuZmluZExhc3QoKGxpbmUpID0+IGxpbmUuc3RhcnRzV2l0aCgnPT4gJykpO1xuICAgIGlmIChyZXN1bHRMaW5lKSB7XG4gICAgICByZXR1cm4gcmVzdWx0TGluZS5zbGljZSgnPT4gJy5sZW5ndGgpO1xuICAgIH1cblxuICAgIHJldHVybiByZXN1bHRTdHI7XG4gIH1cblxuICAvKipcbiAgICogUnVucyBDTEktc3BlY2lmaWMgcHJlZmxpZ2h0IGNoZWNrcy5cbiAgICpcbiAgICogVmVyaWZpZXMgdGhhdCB0aGUgdmF1bHQgaXMgcmVnaXN0ZXJlZCwgQ0xJIGlzIGVuYWJsZWQgaW4gT2JzaWRpYW4gc2V0dGluZ3MsXG4gICAqIGFuZCB0aGUgYG9ic2lkaWFuYCBDTEkgYmluYXJ5IGlzIGF2YWlsYWJsZSBpbiBQQVRILlxuICAgKlxuICAgKiBAcGFyYW0gdmF1bHRQYXRoIC0gVGhlIGFic29sdXRlIHBhdGggdG8gdGhlIHZhdWx0IGZvbGRlci5cbiAgICovXG4gIHB1YmxpYyBhc3luYyBwcmVmbGlnaHRDaGVjayh2YXVsdFBhdGg6IHN0cmluZyk6IFByb21pc2U8dm9pZD4ge1xuICAgIGlmICghaXNWYXVsdFJlZ2lzdGVyZWQodmF1bHRQYXRoKSkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICBgVmF1bHQgaXMgbm90IHJlZ2lzdGVyZWQgaW4gT2JzaWRpYW46ICR7dmF1bHRQYXRofS4gUmVnaXN0ZXIgdGhlIHZhdWx0IGZpcnN0IHdpdGggcmVnaXN0ZXJWYXVsdCgpIG9yIFRlbXBWYXVsdC5yZWdpc3RlcigpLmBcbiAgICAgICk7XG4gICAgfVxuXG4gICAgaWYgKCFpc0NsaUVuYWJsZWQoKSkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdPYnNpZGlhbiBDTEkgaXMgZGlzYWJsZWQuIEVuYWJsZSBpdCBpbiBPYnNpZGlhbiBTZXR0aW5ncyBcXHUyMTkyIEdlbmVyYWwgXFx1MjE5MiBDTEkuJyk7XG4gICAgfVxuXG4gICAgYXdhaXQgdGhpcy5hc3NlcnRDbGlBdmFpbGFibGUoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSB2YXVsdCBpbiB0aGUgcnVubmluZyBPYnNpZGlhbiBpbnN0YW5jZSB2aWEgRWxlY3Ryb24gSVBDLlxuICAgKlxuICAgKiBVc2VzIGB2YXVsdC1vcGVuYCBJUEMgdG8gcmVnaXN0ZXIgYW5kIG9wZW4gdGhlIHZhdWx0LCB0aGVuIHBvbGxzIHVudGlsXG4gICAqIHRoZSB2YXVsdCdzIENMSSBpcyByZWFkeSBhbmQgYGdldEJhc2VQYXRoKClgIG1hdGNoZXMgYHZhdWx0UGF0aGAuXG4gICAqXG4gICAqIEBwYXJhbSB2YXVsdFBhdGggLSBUaGUgYWJzb2x1dGUgcGF0aCB0byB0aGUgdmF1bHQgZm9sZGVyLlxuICAgKi9cbiAgcHVibGljIGFzeW5jIHJlZ2lzdGVyVmF1bHQodmF1bHRQYXRoOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBjb25zdCByZWdpc3RlckV4cHIgPSBidWlsZElwY0V4cHJlc3Npb24oXG4gICAgICBgd2luZG93LmVsZWN0cm9uLmlwY1JlbmRlcmVyLnNlbmRTeW5jKCd2YXVsdC1vcGVuJywgJHtKU09OLnN0cmluZ2lmeSh2YXVsdFBhdGgpfSwgZmFsc2UpO2BcbiAgICApO1xuICAgIGF3YWl0IHRoaXMuZXZhbHVhdGUocmVnaXN0ZXJFeHByLCB7IGN3ZDogcHJvY2Vzcy5jd2QoKSB9KTtcblxuICAgIGNvbnN0IHBvbGxFeHByID0gYnVpbGRTaW1wbGVFeHByZXNzaW9uKFxuICAgICAgJ3JldHVybiBKU09OLnN0cmluZ2lmeShhcHAudmF1bHQuYWRhcHRlci5nZXRCYXNlUGF0aCgpKTsnXG4gICAgKTtcblxuICAgIGNvbnN0IGRlYWRsaW5lID0gRGF0ZS5ub3coKSArIFZBVUxUX1BPTExfVElNRU9VVF9JTl9NSUxMSVNFQ09ORFM7XG4gICAgd2hpbGUgKERhdGUubm93KCkgPCBkZWFkbGluZSkge1xuICAgICAgdHJ5IHtcbiAgICAgICAgY29uc3QgYmFzZVBhdGggPSBhd2FpdCB0aGlzLmV2YWx1YXRlKHBvbGxFeHByLCB7IGN3ZDogdmF1bHRQYXRoIH0pO1xuICAgICAgICBpZiAoSlNPTi5wYXJzZShiYXNlUGF0aCkgPT09IHZhdWx0UGF0aCkge1xuICAgICAgICAgIHJldHVybjtcbiAgICAgICAgfVxuICAgICAgfSBjYXRjaCB7XG4gICAgICAgIC8vIFZhdWx0IG5vdCByZWFkeSB5ZXQuXG4gICAgICB9XG4gICAgICBhd2FpdCBkZWxheShWQVVMVF9QT0xMX0lOVEVSVkFMX0lOX01JTExJU0VDT05EUyk7XG4gICAgfVxuICAgIHRocm93IG5ldyBFcnJvcihgVmF1bHQgYXQgJHt2YXVsdFBhdGh9IGRpZCBub3QgYmVjb21lIHJlYWR5IHdpdGhpbiAke1N0cmluZyhWQVVMVF9QT0xMX1RJTUVPVVRfSU5fTUlMTElTRUNPTkRTKX1tc2ApO1xuICB9XG5cbiAgLyoqXG4gICAqIFVucmVnaXN0ZXJzIGEgdmF1bHQgZnJvbSB0aGUgcnVubmluZyBPYnNpZGlhbiBpbnN0YW5jZS5cbiAgICpcbiAgICogU2NoZWR1bGVzIHRoZSB2YXVsdCB3aW5kb3cgdG8gY2xvc2UsIHdhaXRzLCB0aGVuIHJlbW92ZXMgdGhlIHZhdWx0XG4gICAqIGZyb20gdGhlIHJlZ2lzdHJ5IHZpYSBgdmF1bHQtcmVtb3ZlYCBJUEMuXG4gICAqXG4gICAqIEBwYXJhbSB2YXVsdFBhdGggLSBUaGUgYWJzb2x1dGUgcGF0aCB0byB0aGUgdmF1bHQgZm9sZGVyLlxuICAgKi9cbiAgcHVibGljIGFzeW5jIHVucmVnaXN0ZXJWYXVsdCh2YXVsdFBhdGg6IHN0cmluZyk6IFByb21pc2U8dm9pZD4ge1xuICAgIGNvbnN0IGRlc3Ryb3lFeHByID0gYnVpbGRTaW1wbGVFeHByZXNzaW9uKGBcbiAgICAgIHNldFRpbWVvdXQoKCkgPT4ge1xuICAgICAgICBpZiAod2luZG93LmVsZWN0cm9uICYmIHdpbmRvdy5lbGVjdHJvbi5yZW1vdGUpIHtcbiAgICAgICAgICB3aW5kb3cuZWxlY3Ryb24ucmVtb3RlLmdldEN1cnJlbnRXaW5kb3coKS5kZXN0cm95KCk7XG4gICAgICAgIH1cbiAgICAgIH0sIDApO1xuICAgIGApO1xuICAgIHRyeSB7XG4gICAgICBhd2FpdCB0aGlzLmV2YWx1YXRlKGRlc3Ryb3lFeHByLCB7IGN3ZDogdmF1bHRQYXRoIH0pO1xuICAgIH0gY2F0Y2gge1xuICAgICAgLy8gVGhlIHdpbmRvdyBtYXkgaGF2ZSBjbG9zZWQgYmVmb3JlIHRoZSByZXNwb25zZSB3YXMgc2VudCBcdTIwMTQgdGhhdCdzIE9LLlxuICAgIH1cblxuICAgIGF3YWl0IGRlbGF5KFZBVUxUX0NMT1NFX0RFTEFZX0lOX01JTExJU0VDT05EUyk7XG5cbiAgICBjb25zdCByZW1vdmVFeHByID0gYnVpbGRJcGNFeHByZXNzaW9uKFxuICAgICAgYHdpbmRvdy5lbGVjdHJvbi5pcGNSZW5kZXJlci5zZW5kU3luYygndmF1bHQtcmVtb3ZlJywgJHtKU09OLnN0cmluZ2lmeSh2YXVsdFBhdGgpfSk7YFxuICAgICk7XG4gICAgYXdhaXQgdGhpcy5ldmFsdWF0ZShyZW1vdmVFeHByLCB7IGN3ZDogcHJvY2Vzcy5jd2QoKSB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBDaGVja3Mgd2hldGhlciB0aGUgT2JzaWRpYW4gQ0xJIGJpbmFyeSBpcyBhdmFpbGFibGUgaW4gdGhlIHN5c3RlbSBQQVRILlxuICAgKi9cbiAgcHJpdmF0ZSBhc3luYyBhc3NlcnRDbGlBdmFpbGFibGUoKTogUHJvbWlzZTx2b2lkPiB7XG4gICAgY29uc3QgY29tbWFuZCA9IHByb2Nlc3MucGxhdGZvcm0gPT09ICd3aW4zMicgPyAnd2hlcmUuZXhlIG9ic2lkaWFuJyA6ICd3aGljaCBvYnNpZGlhbic7XG4gICAgdHJ5IHtcbiAgICAgIGF3YWl0IGV4ZWMoY29tbWFuZCwgeyBpc1F1aWV0OiB0cnVlIH0pO1xuICAgIH0gY2F0Y2gge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdPYnNpZGlhbiBDTEkgaXMgbm90IGF2YWlsYWJsZS4gRW5zdXJlIE9ic2lkaWFuIGlzIGluc3RhbGxlZCBhbmQgaXRzIENMSSBpcyBpbiB5b3VyIFBBVEguJyk7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIExhdW5jaGVzIE9ic2lkaWFuIGJpbmFyeSBhbmQgcmV0cmllcyB0aGUgZXZhbCB1bnRpbCBpdCByZXNwb25kcy5cbiAgICpcbiAgICogQHBhcmFtIGNvbW1hbmQgLSBUaGUgQ0xJIGNvbW1hbmQgYXJyYXkgdG8gcmV0cnkuXG4gICAqIEBwYXJhbSBjd2QgLSBUaGUgd29ya2luZyBkaXJlY3RvcnkuXG4gICAqIEByZXR1cm5zIFRoZSByZXN1bHQgc3RyaW5nIGZyb20gdGhlIHN1Y2Nlc3NmdWwgZXZhbC5cbiAgICovXG4gIHByaXZhdGUgYXN5bmMgZW5zdXJlT2JzaWRpYW5SdW5uaW5nQW5kUmV0cnkoY29tbWFuZDogc3RyaW5nW10sIGN3ZDogc3RyaW5nKTogUHJvbWlzZTxzdHJpbmc+IHtcbiAgICBjb25zb2xlLndhcm4oJ09ic2lkaWFuIGlzIG5vdCBydW5uaW5nLiBTdGFydGluZyBPYnNpZGlhbi4uLicpO1xuXG4gICAgdHJ5IHtcbiAgICAgIGF3YWl0IGV4ZWMoZ2V0T2JzaWRpYW5MYXVuY2hDb21tYW5kKCksIHsgaXNRdWlldDogdHJ1ZSB9KTtcbiAgICB9IGNhdGNoIHtcbiAgICAgIC8vIFRoZSBsYXVuY2ggY29tbWFuZCBtYXkgZmFpbCBvbiBzb21lIHN5c3RlbXMgXHUyMDE0IHdlJ2xsIHN0aWxsIHRyeSBwb2xsaW5nLlxuICAgIH1cblxuICAgIGNvbnN0IGRlYWRsaW5lID0gRGF0ZS5ub3coKSArIEFVVE9fU1RBUlRfVElNRU9VVF9JTl9NSUxMSVNFQ09ORFM7XG4gICAgd2hpbGUgKERhdGUubm93KCkgPCBkZWFkbGluZSkge1xuICAgICAgYXdhaXQgZGVsYXkoQVVUT19TVEFSVF9QT0xMX0lOVEVSVkFMX0lOX01JTExJU0VDT05EUyk7XG4gICAgICB0cnkge1xuICAgICAgICByZXR1cm4gYXdhaXQgZXhlYyhjb21tYW5kLCB7IGN3ZCwgaXNRdWlldDogdHJ1ZSB9KTtcbiAgICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICAgIGNvbnN0IG1lc3NhZ2UgPSBlcnJvciBpbnN0YW5jZW9mIEVycm9yID8gZXJyb3IubWVzc2FnZSA6IFN0cmluZyhlcnJvcik7XG4gICAgICAgIGlmICghbWVzc2FnZS5pbmNsdWRlcyhVTkFCTEVfVE9fRklORF9PQlNJRElBTikpIHtcbiAgICAgICAgICB0aHJvdyBlcnJvcjtcbiAgICAgICAgfVxuICAgICAgfVxuICAgIH1cblxuICAgIHRocm93IG5ldyBFcnJvcihgT2JzaWRpYW4gZGlkIG5vdCBzdGFydCB3aXRoaW4gJHtTdHJpbmcoQVVUT19TVEFSVF9USU1FT1VUX0lOX01JTExJU0VDT05EUyl9bXMuYCk7XG4gIH1cbn1cblxuLyoqXG4gKiBCdWlsZHMgYW4gYXN5bmMgSUlGRSB0aGF0IHdhaXRzIGZvciBsYXlvdXQgcmVhZHkgYW5kIGV4ZWN1dGVzIGFuIElQQyBjYWxsLlxuICogVGhlIHJldHVybiB2YWx1ZSBpcyBgSlNPTi5zdHJpbmdpZnkodW5kZWZpbmVkKWAgc28gdGhlIENMSSBwcm9kdWNlcyBgKG5vIG91dHB1dClgLlxuICpcbiAqIEBwYXJhbSBpcGNTdGF0ZW1lbnQgLSBUaGUgSVBDIHN0YXRlbWVudCB0byBleGVjdXRlLlxuICogQHJldHVybnMgVGhlIElJRkUgZXhwcmVzc2lvbiBzdHJpbmcuXG4gKi9cbmZ1bmN0aW9uIGJ1aWxkSXBjRXhwcmVzc2lvbihpcGNTdGF0ZW1lbnQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiBidWlsZFNpbXBsZUV4cHJlc3Npb24oaXBjU3RhdGVtZW50KTtcbn1cblxuLyoqXG4gKiBCdWlsZHMgYSBzaW1wbGUgYXN5bmMgSUlGRSBleHByZXNzaW9uIHRoYXQgd2FpdHMgZm9yIGxheW91dCByZWFkeS5cbiAqXG4gKiBAcGFyYW0gYm9keSAtIFRoZSBKYXZhU2NyaXB0IHN0YXRlbWVudHMgdG8gZXhlY3V0ZS5cbiAqIEByZXR1cm5zIFRoZSBJSUZFIGV4cHJlc3Npb24gc3RyaW5nLlxuICovXG5mdW5jdGlvbiBidWlsZFNpbXBsZUV4cHJlc3Npb24oYm9keTogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIGAoYXN5bmMgKCkgPT4ge1xuICBpZiAoIWFwcC53b3Jrc3BhY2UubGF5b3V0UmVhZHkpIHtcbiAgICBhd2FpdCBuZXcgUHJvbWlzZSgocmVzb2x2ZSkgPT4gYXBwLndvcmtzcGFjZS5vbkxheW91dFJlYWR5KHJlc29sdmUpKTtcbiAgfVxuICAke2JvZHl9XG59KSgpYDtcbn1cblxuLyoqXG4gKiBSZXR1cm5zIGEgcHJvbWlzZSB0aGF0IHJlc29sdmVzIGFmdGVyIHRoZSBnaXZlbiBkZWxheS5cbiAqXG4gKiBAcGFyYW0gbXMgLSBUaGUgZGVsYXkgaW4gbWlsbGlzZWNvbmRzLlxuICogQHJldHVybnMgQSBwcm9taXNlIHRoYXQgcmVzb2x2ZXMgYWZ0ZXIgdGhlIGRlbGF5LlxuICovXG5mdW5jdGlvbiBkZWxheShtczogbnVtYmVyKTogUHJvbWlzZTx2b2lkPiB7XG4gIHJldHVybiBuZXcgUHJvbWlzZSgocmVzb2x2ZSkgPT4ge1xuICAgIHNldFRpbWVvdXQocmVzb2x2ZSwgbXMpO1xuICB9KTtcbn1cblxuLyoqXG4gKiBSZXR1cm5zIHRoZSBwbGF0Zm9ybS1zcGVjaWZpYyBjb21tYW5kIHRvIGxhdW5jaCB0aGUgT2JzaWRpYW4gYmluYXJ5LlxuICpcbiAqIEByZXR1cm5zIFRoZSBzaGVsbCBjb21tYW5kIHN0cmluZy5cbiAqL1xuZnVuY3Rpb24gZ2V0T2JzaWRpYW5MYXVuY2hDb21tYW5kKCk6IHN0cmluZyB7XG4gIGlmIChwcm9jZXNzLnBsYXRmb3JtID09PSAnd2luMzInKSB7XG4gICAgcmV0dXJuICdzdGFydCBcIlwiIFwiJUxPQ0FMQVBQREFUQSVcXFxcUHJvZ3JhbXNcXFxcT2JzaWRpYW5cXFxcT2JzaWRpYW4uZXhlXCInO1xuICB9XG5cbiAgaWYgKHByb2Nlc3MucGxhdGZvcm0gPT09ICdkYXJ3aW4nKSB7XG4gICAgcmV0dXJuICcvQXBwbGljYXRpb25zL09ic2lkaWFuLmFwcC9Db250ZW50cy9NYWNPUy9PYnNpZGlhbiAmJztcbiAgfVxuXG4gIHJldHVybiAnb2JzaWRpYW4gJic7XG59XG5cbi8qIHY4IGlnbm9yZSBzdG9wICovXG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQVNBLDBCQUFvQjtBQU9wQixrQkFBcUI7QUFDckIsNkJBR087QUFFUCxN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TSxNQUFNLGlDQUFpQztBQUU3QyxVQUFNLGFBQWE7QUFBQSxNQUNqQix3REFBd0QsS0FBSyxVQUFVLFNBQVMsQ0FBQztBQUFBLElBQ25GO0FBQ0EsVUFBTSxLQUFLLFNBQVMsWUFBWSxFQUFFLEtBQUssb0JBQUFBLFFBQVEsSUFBSSxFQUFFLENBQUM7QUFBQSxFQUN4RDtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS0EsTUFBYyxxQkFBb0M7QUFDaEQsVUFBTSxVQUFVLG9CQUFBQSxRQUFRLGFBQWEsVUFBVSx1QkFBdUI7QUFDdEUsUUFBSTtBQUNGLGdCQUFNLGtCQUFLLFNBQVMsRUFBRSxTQUFTLEtBQUssQ0FBQztBQUFBLElBQ3ZDLFFBQVE7QUFDTixZQUFNLElBQUksTUFBTSwwRkFBMEY7QUFBQSxJQUM1RztBQUFBLEVBQ0Y7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBU0EsTUFBYyw4QkFBOEIsU0FBbUIsS0FBOEI7QUFDM0YsWUFBUSxLQUFLLCtDQUErQztBQUU1RCxRQUFJO0FBQ0YsZ0JBQU0sa0JBQUsseUJBQXlCLEdBQUcsRUFBRSxTQUFTLEtBQUssQ0FBQztBQUFBLElBQzFELFFBQVE7QUFBQSxJQUVSO0FBRUEsVUFBTSxXQUFXLEtBQUssSUFBSSxJQUFJO0FBQzlCLFdBQU8sS0FBSyxJQUFJLElBQUksVUFBVTtBQUM1QixZQUFNLE1BQU0sd0NBQXdDO0FBQ3BELFVBQUk7QUFDRixlQUFPLFVBQU0sa0JBQUssU0FBUyxFQUFFLEtBQUssU0FBUyxLQUFLLENBQUM7QUFBQSxNQUNuRCxTQUFTLE9BQU87QUFDZCxjQUFNLFVBQVUsaUJBQWlCLFFBQVEsTUFBTSxVQUFVLE9BQU8sS0FBSztBQUNyRSxZQUFJLENBQUMsUUFBUSxTQUFTLHVCQUF1QixHQUFHO0FBQzlDLGdCQUFNO0FBQUEsUUFDUjtBQUFBLE1BQ0Y7QUFBQSxJQUNGO0FBRUEsVUFBTSxJQUFJLE1BQU0saUNBQWlDLE9BQU8sa0NBQWtDLENBQUMsS0FBSztBQUFBLEVBQ2xHO0FBQ0Y7QUFTQSxTQUFTLG1CQUFtQixjQUE4QjtBQUN4RCxTQUFPLHNCQUFzQixZQUFZO0FBQzNDO0FBUUEsU0FBUyxzQkFBc0IsTUFBc0I7QUFDbkQsU0FBTztBQUFBO0FBQUE7QUFBQTtBQUFBLElBSUwsSUFBSTtBQUFBO0FBRVI7QUFRQSxTQUFTLE1BQU0sSUFBMkI7QUFDeEMsU0FBTyxJQUFJLFFBQVEsQ0FBQyxZQUFZO0FBQzlCLGVBQVcsU0FBUyxFQUFFO0FBQUEsRUFDeEIsQ0FBQztBQUNIO0FBT0EsU0FBUywyQkFBbUM7QUFDMUMsTUFBSSxvQkFBQUEsUUFBUSxhQUFhLFNBQVM7QUFDaEMsV0FBTztBQUFBLEVBQ1Q7QUFFQSxNQUFJLG9CQUFBQSxRQUFRLGFBQWEsVUFBVTtBQUNqQyxXQUFPO0FBQUEsRUFDVDtBQUVBLFNBQU87QUFDVDsiLAogICJuYW1lcyI6IFsicHJvY2VzcyJdCn0K

package/dist/lib/cjs/transport-desktop-cli.d.cts

@@ -0,0 +1,65 @@
+/**
+ * @file
+ *
+ * Desktop CLI transport — evaluates expressions via `obsidian eval` and manages
+ * vaults via Electron IPC.
+ */
+import type { ObsidianTransport, TransportEvalOptions } from './transport.cjs';
+/**
+ * Transport that communicates with Desktop Obsidian via the `obsidian eval` CLI command
+ * and manages vaults via Electron IPC.
+ */
+export declare class DesktopCliTransport implements ObsidianTransport {
+    /** */
+    readonly isMobile = false;
+    /**
+     * Evaluates a JavaScript expression inside Obsidian via `obsidian eval`.
+     *
+     * Handles auto-start: if Obsidian is not running, launches it via URI protocol
+     * and retries until it becomes available.
+     *
+     * @param expression - The JavaScript expression to evaluate.
+     * @param options - Evaluation options.
+     * @returns The normalized result string (transport-specific prefixes stripped).
+     */
+    evaluate(expression: string, options: TransportEvalOptions): Promise<string>;
+    /**
+     * Runs CLI-specific preflight checks.
+     *
+     * Verifies that the vault is registered, CLI is enabled in Obsidian settings,
+     * and the `obsidian` CLI binary is available in PATH.
+     *
+     * @param vaultPath - The absolute path to the vault folder.
+     */
+    preflightCheck(vaultPath: string): Promise<void>;
+    /**
+     * Registers a vault in the running Obsidian instance via Electron IPC.
+     *
+     * Uses `vault-open` IPC to register and open the vault, then polls until
+     * the vault's CLI is ready and `getBasePath()` matches `vaultPath`.
+     *
+     * @param vaultPath - The absolute path to the vault folder.
+     */
+    registerVault(vaultPath: string): Promise<void>;
+    /**
+     * Unregisters a vault from the running Obsidian instance.
+     *
+     * Schedules the vault window to close, waits, then removes the vault
+     * from the registry via `vault-remove` IPC.
+     *
+     * @param vaultPath - The absolute path to the vault folder.
+     */
+    unregisterVault(vaultPath: string): Promise<void>;
+    /**
+     * Checks whether the Obsidian CLI binary is available in the system PATH.
+     */
+    private assertCliAvailable;
+    /**
+     * Launches Obsidian binary and retries the eval until it responds.
+     *
+     * @param command - The CLI command array to retry.
+     * @param cwd - The working directory.
+     * @returns The result string from the successful eval.
+     */
+    private ensureObsidianRunningAndRetry;
+}

package/dist/lib/cjs/transport-factory.cjs

@@ -0,0 +1,94 @@
+"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 transport_factory_exports = {};
+__export(transport_factory_exports, {
+  createTransportFromOptions: () => createTransportFromOptions,
+  getOrCreateTransport: () => getOrCreateTransport
+});
+module.exports = __toCommonJS(transport_factory_exports);
+var import_webdriverio = require("webdriverio");
+var import_transport_appium = require("./transport-appium.cjs");
+var import_transport_desktop_cdp = require("./transport-desktop-cdp.cjs");
+var import_transport_desktop_cli = require("./transport-desktop-cli.cjs");
+const APP_PACKAGE = "md.obsidian";
+const APP_ACTIVITY = `${APP_PACKAGE}.MainActivity`;
+const COMMAND_TIMEOUT_IN_MILLISECONDS = 300;
+const SERVER_LAUNCH_TIMEOUT_IN_MILLISECONDS = 3e4;
+let cachedTransport;
+async function createTransportFromOptions(options) {
+  if (!options || options.type === "obsidian-cli") {
+    return new import_transport_desktop_cli.DesktopCliTransport();
+  }
+  if (options.type === "obsidian-cdp") {
+    return new import_transport_desktop_cdp.DesktopCdpTransport({
+      ...options.host !== void 0 && { cdpHost: options.host },
+      ...options.port !== void 0 && { cdpPort: options.port },
+      ...options.commandTimeoutInMilliseconds !== void 0 && { commandTimeoutInMilliseconds: options.commandTimeoutInMilliseconds }
+    });
+  }
+  return createAppiumTransport(options);
+}
+async function getOrCreateTransport(options) {
+  if (cachedTransport) {
+    return cachedTransport;
+  }
+  const result = await createTransportFromOptions(options);
+  cachedTransport = result;
+  return result;
+}
+async function createAppiumTransport(options) {
+  const url = new URL(options.appiumUrl);
+  const port = Number(url.port);
+  if (isNaN(port)) {
+    throw new Error(`Invalid port in appiumUrl: ${url.port}`);
+  }
+  const appId = options.appId ?? APP_PACKAGE;
+  const browser = await (0, import_webdriverio.remote)({
+    capabilities: {
+      "appium:appActivity": APP_ACTIVITY,
+      "appium:appPackage": appId,
+      "appium:autoGrantPermissions": true,
+      "appium:automationName": "UiAutomator2",
+      "appium:newCommandTimeout": COMMAND_TIMEOUT_IN_MILLISECONDS,
+      "appium:noReset": true,
+      "appium:settings": {
+        "appium:chromedriverAutodownload": true
+      },
+      "appium:skipServerInstallation": true,
+      "appium:udid": options.deviceId,
+      "appium:uiautomator2ServerLaunchTimeout": SERVER_LAUNCH_TIMEOUT_IN_MILLISECONDS,
+      "platformName": "Android"
+    },
+    hostname: url.hostname,
+    path: url.pathname,
+    port
+  });
+  return new import_transport_appium.AppiumTransport({
+    appId,
+    browser,
+    platform: "android",
+    ...options.vaultBasePath !== void 0 && { vaultBasePath: options.vaultBasePath }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createTransportFromOptions,
+  getOrCreateTransport
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3RyYW5zcG9ydC1mYWN0b3J5LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogRmFjdG9yeSBmb3IgY3JlYXRpbmcgdHJhbnNwb3J0IGluc3RhbmNlcyBmcm9tIHtAbGluayBPYnNpZGlhblRyYW5zcG9ydE9wdGlvbnN9LlxuICovXG5cbi8qIHY4IGlnbm9yZSBzdGFydCAtLSBJbnRlZ3JhdGlvbi10aW1lIGZhY3RvcnkgY292ZXJlZCBieSBpbnRlZ3JhdGlvbiB0ZXN0cywgbm90IHVuaXQgdGVzdHMuICovXG5cbmltcG9ydCB7IHJlbW90ZSB9IGZyb20gJ3dlYmRyaXZlcmlvJztcblxuaW1wb3J0IHR5cGUge1xuICBPYnNpZGlhbkFuZHJvaWRBcHBpdW1UcmFuc3BvcnRPcHRpb25zLFxuICBPYnNpZGlhblRyYW5zcG9ydE9wdGlvbnNcbn0gZnJvbSAnLi90cmFuc3BvcnQtb3B0aW9ucy5janMnO1xuaW1wb3J0IHR5cGUgeyBPYnNpZGlhblRyYW5zcG9ydCB9IGZyb20gJy4vdHJhbnNwb3J0LmNqcyc7XG5cbmltcG9ydCB7IEFwcGl1bVRyYW5zcG9ydCB9IGZyb20gJy4vdHJhbnNwb3J0LWFwcGl1bS5janMnO1xuaW1wb3J0IHsgRGVza3RvcENkcFRyYW5zcG9ydCB9IGZyb20gJy4vdHJhbnNwb3J0LWRlc2t0b3AtY2RwLmNqcyc7XG5pbXBvcnQgeyBEZXNrdG9wQ2xpVHJhbnNwb3J0IH0gZnJvbSAnLi90cmFuc3BvcnQtZGVza3RvcC1jbGkuY2pzJztcblxuY29uc3QgQVBQX1BBQ0tBR0UgPSAnbWQub2JzaWRpYW4nO1xuY29uc3QgQVBQX0FDVElWSVRZID0gYCR7QVBQX1BBQ0tBR0V9Lk1haW5BY3Rpdml0eWA7XG5jb25zdCBDT01NQU5EX1RJTUVPVVRfSU5fTUlMTElTRUNPTkRTID0gMzAwO1xuY29uc3QgU0VSVkVSX0xBVU5DSF9USU1FT1VUX0lOX01JTExJU0VDT05EUyA9IDMwMDAwO1xuXG5sZXQgY2FjaGVkVHJhbnNwb3J0OiBPYnNpZGlhblRyYW5zcG9ydCB8IHVuZGVmaW5lZDtcblxuLyoqXG4gKiBDcmVhdGVzIGEgbmV3IHRyYW5zcG9ydCBpbnN0YW5jZSBmcm9tIHRoZSBnaXZlbiBvcHRpb25zLlxuICpcbiAqIEBwYXJhbSBvcHRpb25zIC0gVHJhbnNwb3J0IGNvbmZpZ3VyYXRpb24uIERlZmF1bHRzIHRvIENMSSB0cmFuc3BvcnQuXG4gKiBAcmV0dXJucyBBIG5ldyB0cmFuc3BvcnQgaW5zdGFuY2UuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBjcmVhdGVUcmFuc3BvcnRGcm9tT3B0aW9ucyhvcHRpb25zPzogT2JzaWRpYW5UcmFuc3BvcnRPcHRpb25zKTogUHJvbWlzZTxPYnNpZGlhblRyYW5zcG9ydD4ge1xuICBpZiAoIW9wdGlvbnMgfHwgb3B0aW9ucy50eXBlID09PSAnb2JzaWRpYW4tY2xpJykge1xuICAgIHJldHVybiBuZXcgRGVza3RvcENsaVRyYW5zcG9ydCgpO1xuICB9XG5cbiAgaWYgKG9wdGlvbnMudHlwZSA9PT0gJ29ic2lkaWFuLWNkcCcpIHtcbiAgICByZXR1cm4gbmV3IERlc2t0b3BDZHBUcmFuc3BvcnQoe1xuICAgICAgLi4uKG9wdGlvbnMuaG9zdCAhPT0gdW5kZWZpbmVkICYmIHsgY2RwSG9zdDogb3B0aW9ucy5ob3N0IH0pLFxuICAgICAgLi4uKG9wdGlvbnMucG9ydCAhPT0gdW5kZWZpbmVkICYmIHsgY2RwUG9ydDogb3B0aW9ucy5wb3J0IH0pLFxuICAgICAgLi4uKG9wdGlvbnMuY29tbWFuZFRpbWVvdXRJbk1pbGxpc2Vjb25kcyAhPT0gdW5kZWZpbmVkICYmIHsgY29tbWFuZFRpbWVvdXRJbk1pbGxpc2Vjb25kczogb3B0aW9ucy5jb21tYW5kVGltZW91dEluTWlsbGlzZWNvbmRzIH0pXG4gICAgfSk7XG4gIH1cblxuICByZXR1cm4gY3JlYXRlQXBwaXVtVHJhbnNwb3J0KG9wdGlvbnMpO1xufVxuXG4vKipcbiAqIFJldHVybnMgYSBjYWNoZWQgdHJhbnNwb3J0IGluc3RhbmNlLCBjcmVhdGluZyBvbmUgZnJvbSB0aGUgZ2l2ZW4gb3B0aW9uc1xuICogaWYgbm90IGFscmVhZHkgY2FjaGVkLlxuICpcbiAqIFRoZSB0cmFuc3BvcnQgaXMgY2FjaGVkIHBlciB3b3JrZXIgcHJvY2VzcyBzbyBXZWJTb2NrZXQvQXBwaXVtIHNlc3Npb25zXG4gKiBhcmUgcmV1c2VkIGFjcm9zcyBjYWxscyB3aXRoaW4gdGhlIHNhbWUgdGVzdCB3b3JrZXIuXG4gKlxuICogQHBhcmFtIG9wdGlvbnMgLSBUcmFuc3BvcnQgY29uZmlndXJhdGlvbi4gRGVmYXVsdHMgdG8gQ0xJIHRyYW5zcG9ydC5cbiAqIEByZXR1cm5zIFRoZSBjYWNoZWQgb3IgbmV3bHkgY3JlYXRlZCB0cmFuc3BvcnQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBnZXRPckNyZWF0ZVRyYW5zcG9ydChvcHRpb25zPzogT2JzaWRpYW5UcmFuc3BvcnRPcHRpb25zKTogUHJvbWlzZTxPYnNpZGlhblRyYW5zcG9ydD4ge1xuICBpZiAoY2FjaGVkVHJhbnNwb3J0KSB7XG4gICAgcmV0dXJuIGNhY2hlZFRyYW5zcG9ydDtcbiAgfVxuXG4gIGNvbnN0IHJlc3VsdCA9IGF3YWl0IGNyZWF0ZVRyYW5zcG9ydEZyb21PcHRpb25zKG9wdGlvbnMpO1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgcmVxdWlyZS1hdG9taWMtdXBkYXRlcyAtLSBTaW5nbGUtdGhyZWFkZWQgd29ya2VyOyBubyBjb25jdXJyZW50IHdyaXRlcy5cbiAgY2FjaGVkVHJhbnNwb3J0ID0gcmVzdWx0O1xuICByZXR1cm4gcmVzdWx0O1xufVxuXG4vKipcbiAqIENyZWF0ZXMgYW4gQXBwaXVtIHRyYW5zcG9ydCBieSBlc3RhYmxpc2hpbmcgYSBXZWJEcml2ZXJJTyBzZXNzaW9uLlxuICpcbiAqIEBwYXJhbSBvcHRpb25zIC0gQW5kcm9pZCBBcHBpdW0gdHJhbnNwb3J0IG9wdGlvbnMuXG4gKiBAcmV0dXJucyBBIGNvbmZpZ3VyZWQgQXBwaXVtIHRyYW5zcG9ydC5cbiAqL1xuYXN5bmMgZnVuY3Rpb24gY3JlYXRlQXBwaXVtVHJhbnNwb3J0KG9wdGlvbnM6IE9ic2lkaWFuQW5kcm9pZEFwcGl1bVRyYW5zcG9ydE9wdGlvbnMpOiBQcm9taXNlPEFwcGl1bVRyYW5zcG9ydD4ge1xuICBjb25zdCB1cmwgPSBuZXcgVVJMKG9wdGlvbnMuYXBwaXVtVXJsKTtcblxuICBjb25zdCBwb3J0ID0gTnVtYmVyKHVybC5wb3J0KTtcbiAgaWYgKGlzTmFOKHBvcnQpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBJbnZhbGlkIHBvcnQgaW4gYXBwaXVtVXJsOiAke3VybC5wb3J0fWApO1xuICB9XG5cbiAgY29uc3QgYXBwSWQgPSBvcHRpb25zLmFwcElkID8/IEFQUF9QQUNLQUdFO1xuXG4gIGNvbnN0IGJyb3dzZXIgPSBhd2FpdCByZW1vdGUoe1xuICAgIGNhcGFiaWxpdGllczoge1xuICAgICAgJ2FwcGl1bTphcHBBY3Rpdml0eSc6IEFQUF9BQ1RJVklUWSxcbiAgICAgICdhcHBpdW06YXBwUGFja2FnZSc6IGFwcElkLFxuICAgICAgJ2FwcGl1bTphdXRvR3JhbnRQZXJtaXNzaW9ucyc6IHRydWUsXG4gICAgICAnYXBwaXVtOmF1dG9tYXRpb25OYW1lJzogJ1VpQXV0b21hdG9yMicsXG4gICAgICAnYXBwaXVtOm5ld0NvbW1hbmRUaW1lb3V0JzogQ09NTUFORF9USU1FT1VUX0lOX01JTExJU0VDT05EUyxcbiAgICAgICdhcHBpdW06bm9SZXNldCc6IHRydWUsXG4gICAgICAnYXBwaXVtOnNldHRpbmdzJzoge1xuICAgICAgICAnYXBwaXVtOmNocm9tZWRyaXZlckF1dG9kb3dubG9hZCc6IHRydWVcbiAgICAgIH0sXG4gICAgICAnYXBwaXVtOnNraXBTZXJ2ZXJJbnN0YWxsYXRpb24nOiB0cnVlLFxuICAgICAgJ2FwcGl1bTp1ZGlkJzogb3B0aW9ucy5kZXZpY2VJZCxcbiAgICAgICdhcHBpdW06dWlhdXRvbWF0b3IyU2VydmVyTGF1bmNoVGltZW91dCc6IFNFUlZFUl9MQVVOQ0hfVElNRU9VVF9JTl9NSUxMSVNFQ09ORFMsXG4gICAgICAncGxhdGZvcm1OYW1lJzogJ0FuZHJvaWQnXG4gICAgfSxcbiAgICBob3N0bmFtZTogdXJsLmhvc3RuYW1lLFxuICAgIHBhdGg6IHVybC5wYXRobmFtZSxcbiAgICBwb3J0XG4gIH0pO1xuXG4gIHJldHVybiBuZXcgQXBwaXVtVHJhbnNwb3J0KHtcbiAgICBhcHBJZCxcbiAgICBicm93c2VyLFxuICAgIHBsYXRmb3JtOiAnYW5kcm9pZCcsXG4gICAgLi4uKG9wdGlvbnMudmF1bHRCYXNlUGF0aCAhPT0gdW5kZWZpbmVkICYmIHsgdmF1bHRCYXNlUGF0aDogb3B0aW9ucy52YXVsdEJhc2VQYXRoIH0pXG4gIH0pO1xufVxuXG4vKiB2OCBpZ25vcmUgc3RvcCAqL1xuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBUUEseUJBQXVCO0FBUXZCLDhCQUFnQztBQUNoQyxtQ0FBb0M7QUFDcEMsbUNBQW9DO0FBRXBDLE1BQU0sY0FBYztBQUNwQixNQUFNLGVBQWUsR0FBRyxXQUFXO0FBQ25DLE1BQU0sa0NBQWtDO0FBQ3hDLE1BQU0sd0NBQXdDO0FBRTlDLElBQUk7QUFRSixlQUFzQiwyQkFBMkIsU0FBZ0U7QUFDL0csTUFBSSxDQUFDLFdBQVcsUUFBUSxTQUFTLGdCQUFnQjtBQUMvQyxXQUFPLElBQUksaURBQW9CO0FBQUEsRUFDakM7QUFFQSxNQUFJLFFBQVEsU0FBUyxnQkFBZ0I7QUFDbkMsV0FBTyxJQUFJLGlEQUFvQjtBQUFBLE1BQzdCLEdBQUksUUFBUSxTQUFTLFVBQWEsRUFBRSxTQUFTLFFBQVEsS0FBSztBQUFBLE1BQzFELEdBQUksUUFBUSxTQUFTLFVBQWEsRUFBRSxTQUFTLFFBQVEsS0FBSztBQUFBLE1BQzFELEdBQUksUUFBUSxpQ0FBaUMsVUFBYSxFQUFFLDhCQUE4QixRQUFRLDZCQUE2QjtBQUFBLElBQ2pJLENBQUM7QUFBQSxFQUNIO0FBRUEsU0FBTyxzQkFBc0IsT0FBTztBQUN0QztBQVlBLGVBQXNCLHFCQUFxQixTQUFnRTtBQUN6RyxNQUFJLGlCQUFpQjtBQUNuQixXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sU0FBUyxNQUFNLDJCQUEyQixPQUFPO0FBRXZELG9CQUFrQjtBQUNsQixTQUFPO0FBQ1Q7QUFRQSxlQUFlLHNCQUFzQixTQUEwRTtBQUM3RyxRQUFNLE1BQU0sSUFBSSxJQUFJLFFBQVEsU0FBUztBQUVyQyxRQUFNLE9BQU8sT0FBTyxJQUFJLElBQUk7QUFDNUIsTUFBSSxNQUFNLElBQUksR0FBRztBQUNmLFVBQU0sSUFBSSxNQUFNLDhCQUE4QixJQUFJLElBQUksRUFBRTtBQUFBLEVBQzFEO0FBRUEsUUFBTSxRQUFRLFFBQVEsU0FBUztBQUUvQixRQUFNLFVBQVUsVUFBTSwyQkFBTztBQUFBLElBQzNCLGNBQWM7QUFBQSxNQUNaLHNCQUFzQjtBQUFBLE1BQ3RCLHFCQUFxQjtBQUFBLE1BQ3JCLCtCQUErQjtBQUFBLE1BQy9CLHlCQUF5QjtBQUFBLE1BQ3pCLDRCQUE0QjtBQUFBLE1BQzVCLGtCQUFrQjtBQUFBLE1BQ2xCLG1CQUFtQjtBQUFBLFFBQ2pCLG1DQUFtQztBQUFBLE1BQ3JDO0FBQUEsTUFDQSxpQ0FBaUM7QUFBQSxNQUNqQyxlQUFlLFFBQVE7QUFBQSxNQUN2QiwwQ0FBMEM7QUFBQSxNQUMxQyxnQkFBZ0I7QUFBQSxJQUNsQjtBQUFBLElBQ0EsVUFBVSxJQUFJO0FBQUEsSUFDZCxNQUFNLElBQUk7QUFBQSxJQUNWO0FBQUEsRUFDRixDQUFDO0FBRUQsU0FBTyxJQUFJLHdDQUFnQjtBQUFBLElBQ3pCO0FBQUEsSUFDQTtBQUFBLElBQ0EsVUFBVTtBQUFBLElBQ1YsR0FBSSxRQUFRLGtCQUFrQixVQUFhLEVBQUUsZUFBZSxRQUFRLGNBQWM7QUFBQSxFQUNwRixDQUFDO0FBQ0g7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/transport-factory.d.cts

@@ -0,0 +1,25 @@
+/**
+ * @file
+ *
+ * Factory for creating transport instances from {@link ObsidianTransportOptions}.
+ */
+import type { ObsidianTransportOptions } from './transport-options.cjs';
+import type { ObsidianTransport } from './transport.cjs';
+/**
+ * Creates a new transport instance from the given options.
+ *
+ * @param options - Transport configuration. Defaults to CLI transport.
+ * @returns A new transport instance.
+ */
+export declare function createTransportFromOptions(options?: ObsidianTransportOptions): Promise<ObsidianTransport>;
+/**
+ * Returns a cached transport instance, creating one from the given options
+ * if not already cached.
+ *
+ * The transport is cached per worker process so WebSocket/Appium sessions
+ * are reused across calls within the same test worker.
+ *
+ * @param options - Transport configuration. Defaults to CLI transport.
+ * @returns The cached or newly created transport.
+ */
+export declare function getOrCreateTransport(options?: ObsidianTransportOptions): Promise<ObsidianTransport>;

package/dist/lib/cjs/transport-options.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 transport_options_exports = {};
+module.exports = __toCommonJS(transport_options_exports);
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3RyYW5zcG9ydC1vcHRpb25zLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogRGlzY3JpbWluYXRlZCB1bmlvbiB0eXBlcyBmb3IgY29uZmlndXJpbmcgdGhlIE9ic2lkaWFuIHRyYW5zcG9ydFxuICogdmlhIHZpdGVzdCBgZW52aXJvbm1lbnRPcHRpb25zYC5cbiAqL1xuXG4vKipcbiAqIFRyYW5zcG9ydCBvcHRpb25zIGZvciBBbmRyb2lkIHRlc3RpbmcgdmlhIEFwcGl1bSBXZWJWaWV3IGluamVjdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBPYnNpZGlhbkFuZHJvaWRBcHBpdW1UcmFuc3BvcnRPcHRpb25zIHtcbiAgLyoqXG4gICAqIEFwcCBwYWNrYWdlIChBbmRyb2lkKSBvciBidW5kbGUgSUQgKGlPUykuXG4gICAqIERlZmF1bHRzIHRvIGAnbWQub2JzaWRpYW4nYFxuICAgKi9cbiAgYXBwSWQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBBcHBpdW0gc2VydmVyIFVSTCAoZS5nLiBgJ2h0dHA6Ly9sb2NhbGhvc3Q6NDcyMydgKS5cbiAgICovXG4gIGFwcGl1bVVybDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgZGV2aWNlIFVESUQgKGUuZy4gYCdlbXVsYXRvci01NTU0J2ApLlxuICAgKi9cbiAgZGV2aWNlSWQ6IHN0cmluZztcblxuICAvKipcbiAgICogRGlzY3JpbWluYW50IGZvciB0aGUgdHJhbnNwb3J0IHR5cGUuXG4gICAqL1xuICB0eXBlOiAnb2JzaWRpYW4tYW5kcm9pZC1hcHBpdW0nO1xuXG4gIC8qKlxuICAgKiBCYXNlIHBhdGggb24gdGhlIGRldmljZSB3aGVyZSBPYnNpZGlhbiBzdG9yZXMgdmF1bHRzLlxuICAgKlxuICAgKiBEZWZhdWx0czpcbiAgICogLSBBbmRyb2lkOiBgL3NkY2FyZC9Eb2N1bWVudHMvYFxuICAgKiAtIGlPUzogYEBtZC5vYnNpZGlhbjpkb2N1bWVudHMvYFxuICAgKi9cbiAgdmF1bHRCYXNlUGF0aD86IHN0cmluZztcbn1cblxuLyoqXG4gKiBUcmFuc3BvcnQgb3B0aW9ucyBmb3IgZGVza3RvcCB0ZXN0aW5nIHZpYSBDaHJvbWUgRGV2VG9vbHMgUHJvdG9jb2wuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgT2JzaWRpYW5DZHBUcmFuc3BvcnRPcHRpb25zIHtcbiAgLyoqXG4gICAqIFRpbWVvdXQgaW4gbWlsbGlzZWNvbmRzIGZvciBpbmRpdmlkdWFsIENEUCBjb21tYW5kcy5cbiAgICogRGVmYXVsdHMgdG8gMzAwMDBcbiAgICovXG4gIGNvbW1hbmRUaW1lb3V0SW5NaWxsaXNlY29uZHM/OiBudW1iZXI7XG5cbiAgLyoqXG4gICAqIENEUCBob3N0LlxuICAgKiBEZWZhdWx0cyB0byBgJ2xvY2FsaG9zdCdgXG4gICAqL1xuICBob3N0Pzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDRFAgcG9ydC5cbiAgICogRGVmYXVsdHMgdG8gODMxNVxuICAgKi9cbiAgcG9ydD86IG51bWJlcjtcblxuICAvKipcbiAgICogRGlzY3JpbWluYW50IGZvciB0aGUgdHJhbnNwb3J0IHR5cGUuXG4gICAqL1xuICB0eXBlOiAnb2JzaWRpYW4tY2RwJztcbn1cblxuLyoqXG4gKiBUcmFuc3BvcnQgb3B0aW9ucyBmb3IgZGVza3RvcCB0ZXN0aW5nIHZpYSB0aGUgT2JzaWRpYW4gQ0xJLlxuICpcbiAqIFRoaXMgaXMgdGhlIGRlZmF1bHQgdHJhbnNwb3J0IHdoZW4gbm8gYG9ic2lkaWFuVHJhbnNwb3J0YCBpcyBjb25maWd1cmVkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIE9ic2lkaWFuQ2xpVHJhbnNwb3J0T3B0aW9ucyB7XG4gIC8qKlxuICAgKiBEaXNjcmltaW5hbnQgZm9yIHRoZSB0cmFuc3BvcnQgdHlwZS5cbiAgICovXG4gIHR5cGU6ICdvYnNpZGlhbi1jbGknO1xufVxuXG4vKipcbiAqIERpc2NyaW1pbmF0ZWQgdW5pb24gb2YgYWxsIHN1cHBvcnRlZCB0cmFuc3BvcnQgY29uZmlndXJhdGlvbnMuXG4gKlxuICogVXNlZCBpbiB2aXRlc3QgYGVudmlyb25tZW50T3B0aW9ucy5vYnNpZGlhblRyYW5zcG9ydGAgdG8gc2VsZWN0IGFuZFxuICogY29uZmlndXJlIHRoZSB0cmFuc3BvcnQgZm9yIGludGVncmF0aW9uIHRlc3RzLlxuICovXG5leHBvcnQgdHlwZSBPYnNpZGlhblRyYW5zcG9ydE9wdGlvbnMgPVxuICB8IE9ic2lkaWFuQW5kcm9pZEFwcGl1bVRyYW5zcG9ydE9wdGlvbnNcbiAgfCBPYnNpZGlhbkNkcFRyYW5zcG9ydE9wdGlvbnNcbiAgfCBPYnNpZGlhbkNsaVRyYW5zcG9ydE9wdGlvbnM7XG5cbmRlY2xhcmUgbW9kdWxlICd2aXRlc3QnIHtcbiAgaW50ZXJmYWNlIEVudmlyb25tZW50T3B0aW9ucyB7XG4gICAgLyoqXG4gICAgICogQ29uZmlndXJlcyB0aGUgdHJhbnNwb3J0IHVzZWQgYnkgYG9ic2lkaWFuLWludGVncmF0aW9uLXRlc3RpbmdgIHRvXG4gICAgICogY29tbXVuaWNhdGUgd2l0aCBhIHJ1bm5pbmcgT2JzaWRpYW4gaW5zdGFuY2UuXG4gICAgICpcbiAgICAgKiBXaGVuIG9taXR0ZWQsIGRlZmF1bHRzIHRvIHRoZSBDTEkgdHJhbnNwb3J0IChgb2JzaWRpYW4tY2xpYCkuXG4gICAgICovXG4gICAgb2JzaWRpYW5UcmFuc3BvcnQ/OiBPYnNpZGlhblRyYW5zcG9ydE9wdGlvbnM7XG4gIH1cblxuICBpbnRlcmZhY2UgUHJvdmlkZWRDb250ZXh0IHtcbiAgICAvKipcbiAgICAgKiBUcmFuc3BvcnQgb3B0aW9ucyBwcm92aWRlZCBieSB0aGUgZ2xvYmFsIHNldHVwLCBjb25zdW1lZCBieVxuICAgICAqIGBldmFsSW5PYnNpZGlhbmAgYW5kIG90aGVyIGxpYnJhcnkgZnVuY3Rpb25zIHZpYSBgaW5qZWN0KClgLlxuICAgICAqL1xuICAgIG9ic2lkaWFuVHJhbnNwb3J0PzogT2JzaWRpYW5UcmFuc3BvcnRPcHRpb25zO1xuXG4gICAgLyoqXG4gICAgICogUGF0aCB0byB0aGUgdGVtcG9yYXJ5IHZhdWx0IGNyZWF0ZWQgYnkgdGhlIGdsb2JhbCBzZXR1cC5cbiAgICAgKi9cbiAgICB0ZW1wVmF1bHRQYXRoOiBzdHJpbmc7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/cjs/transport-options.d.cts

@@ -0,0 +1,100 @@
+/**
+ * @file
+ *
+ * Discriminated union types for configuring the Obsidian transport
+ * via vitest `environmentOptions`.
+ */
+/**
+ * Transport options for Android testing via Appium WebView injection.
+ */
+export interface ObsidianAndroidAppiumTransportOptions {
+    /**
+     * App package (Android) or bundle ID (iOS).
+     * Defaults to `'md.obsidian'`
+     */
+    appId?: string;
+    /**
+     * The Appium server URL (e.g. `'http://localhost:4723'`).
+     */
+    appiumUrl: string;
+    /**
+     * The device UDID (e.g. `'emulator-5554'`).
+     */
+    deviceId: string;
+    /**
+     * Discriminant for the transport type.
+     */
+    type: 'obsidian-android-appium';
+    /**
+     * Base path on the device where Obsidian stores vaults.
+     *
+     * Defaults:
+     * - Android: `/sdcard/Documents/`
+     * - iOS: `@md.obsidian:documents/`
+     */
+    vaultBasePath?: string;
+}
+/**
+ * Transport options for desktop testing via Chrome DevTools Protocol.
+ */
+export interface ObsidianCdpTransportOptions {
+    /**
+     * Timeout in milliseconds for individual CDP commands.
+     * Defaults to 30000
+     */
+    commandTimeoutInMilliseconds?: number;
+    /**
+     * CDP host.
+     * Defaults to `'localhost'`
+     */
+    host?: string;
+    /**
+     * CDP port.
+     * Defaults to 8315
+     */
+    port?: number;
+    /**
+     * Discriminant for the transport type.
+     */
+    type: 'obsidian-cdp';
+}
+/**
+ * Transport options for desktop testing via the Obsidian CLI.
+ *
+ * This is the default transport when no `obsidianTransport` is configured.
+ */
+export interface ObsidianCliTransportOptions {
+    /**
+     * Discriminant for the transport type.
+     */
+    type: 'obsidian-cli';
+}
+/**
+ * Discriminated union of all supported transport configurations.
+ *
+ * Used in vitest `environmentOptions.obsidianTransport` to select and
+ * configure the transport for integration tests.
+ */
+export type ObsidianTransportOptions = ObsidianAndroidAppiumTransportOptions | ObsidianCdpTransportOptions | ObsidianCliTransportOptions;
+declare module 'vitest' {
+    interface EnvironmentOptions {
+        /**
+         * Configures the transport used by `obsidian-integration-testing` to
+         * communicate with a running Obsidian instance.
+         *
+         * When omitted, defaults to the CLI transport (`obsidian-cli`).
+         */
+        obsidianTransport?: ObsidianTransportOptions;
+    }
+    interface ProvidedContext {
+        /**
+         * Transport options provided by the global setup, consumed by
+         * `evalInObsidian` and other library functions via `inject()`.
+         */
+        obsidianTransport?: ObsidianTransportOptions;
+        /**
+         * Path to the temporary vault created by the global setup.
+         */
+        tempVaultPath: string;
+    }
+}

package/dist/lib/cjs/transport.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 transport_exports = {};
+module.exports = __toCommonJS(transport_exports);
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3RyYW5zcG9ydC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIERlZmluZXMgdGhlIHRyYW5zcG9ydCBpbnRlcmZhY2UgZm9yIGNvbW11bmljYXRpbmcgd2l0aCBhIHJ1bm5pbmcgT2JzaWRpYW4gaW5zdGFuY2UuXG4gKi9cblxuLyoqXG4gKiBBIHBsdWdnYWJsZSB0cmFuc3BvcnQgdGhhdCBldmFsdWF0ZXMgSmF2YVNjcmlwdCBleHByZXNzaW9ucyBpbnNpZGUgYSBydW5uaW5nXG4gKiBPYnNpZGlhbiBpbnN0YW5jZSBhbmQgbWFuYWdlcyB2YXVsdCBsaWZlY3ljbGUuXG4gKlxuICogSW1wbGVtZW50YXRpb25zIGhhbmRsZSB0aGUgcGxhdGZvcm0tc3BlY2lmaWMgZGV0YWlsczpcbiAqIC0ge0BsaW5rIERlc2t0b3BDbGlUcmFuc3BvcnR9IFx1MjAxNCBEZXNrdG9wIE9ic2lkaWFuIHZpYSBDTEkgKGBvYnNpZGlhbiBldmFsYClcbiAqIC0ge0BsaW5rIERlc2t0b3BDZHBUcmFuc3BvcnR9IFx1MjAxNCBEZXNrdG9wIE9ic2lkaWFuIHZpYSBDaHJvbWUgRGV2VG9vbHMgUHJvdG9jb2xcbiAqIC0ge0BsaW5rIEFwcGl1bVRyYW5zcG9ydH0gXHUyMDE0IE1vYmlsZSBPYnNpZGlhbiB2aWEgQXBwaXVtIFdlYlZpZXcgSlMgaW5qZWN0aW9uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgT2JzaWRpYW5UcmFuc3BvcnQge1xuICAvKipcbiAgICogRGlzcG9zZXMgb2YgdHJhbnNwb3J0IHJlc291cmNlcyAoZS5nLiBXZWJTb2NrZXQgY29ubmVjdGlvbnMsIEFwcGl1bSBzZXNzaW9ucykuXG4gICAqL1xuICBkaXNwb3NlPygpOiBQcm9taXNlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBFdmFsdWF0ZXMgYSBKYXZhU2NyaXB0IGV4cHJlc3Npb24gc3RyaW5nIGluc2lkZSBPYnNpZGlhbiBhbmQgcmV0dXJucyB0aGVcbiAgICogcmF3IHN0cmluZyByZXN1bHQuXG4gICAqXG4gICAqIFRoZSB0cmFuc3BvcnQgbm9ybWFsaXplcyB0aGUgb3V0cHV0IFx1MjAxNCBzdHJpcHBpbmcgdHJhbnNwb3J0LXNwZWNpZmljIHByZWZpeGVzXG4gICAqIGFuZCBoYW5kbGluZyB0cmFuc3BvcnQtc3BlY2lmaWMgZXJyb3JzIFx1MjAxNCBzbyBjYWxsZXJzIHJlY2VpdmUgYSBjbGVhbiByZXN1bHRcbiAgICogc3RyaW5nIChlLmcuIGEgSlNPTiBzdHJpbmcsIG9yIGAobm8gb3V0cHV0KWApLlxuICAgKlxuICAgKiBAcGFyYW0gZXhwcmVzc2lvbiAtIEEgc2VsZi1jb250YWluZWQgSmF2YVNjcmlwdCBleHByZXNzaW9uICh0eXBpY2FsbHkgYW4gYXN5bmMgSUlGRSkuXG4gICAqIEBwYXJhbSBvcHRpb25zIC0gRXZhbHVhdGlvbiBvcHRpb25zIGluY2x1ZGluZyB0aGUgd29ya2luZyBkaXJlY3RvcnkuXG4gICAqIEByZXR1cm5zIFRoZSByYXcgcmVzdWx0IHN0cmluZyBmcm9tIE9ic2lkaWFuLlxuICAgKi9cbiAgZXZhbHVhdGUoZXhwcmVzc2lvbjogc3RyaW5nLCBvcHRpb25zOiBUcmFuc3BvcnRFdmFsT3B0aW9ucyk6IFByb21pc2U8c3RyaW5nPjtcblxuICAvKipcbiAgICogV2hldGhlciB0aGlzIHRyYW5zcG9ydCB0YXJnZXRzIGEgbW9iaWxlIE9ic2lkaWFuIGluc3RhbmNlLlxuICAgKlxuICAgKiBXaGVuIGB0cnVlYCwgZGVza3RvcC1vbmx5IHBsdWdpbnMgKHdpdGggYGlzRGVza3RvcE9ubHk6IHRydWVgIGluIG1hbmlmZXN0KVxuICAgKiB3aWxsIHJlZnVzZSB0byBydW4gaW50ZWdyYXRpb24gdGVzdHMuXG4gICAqL1xuICBpc01vYmlsZTogYm9vbGVhbjtcblxuICAvKipcbiAgICogUnVucyB0cmFuc3BvcnQtc3BlY2lmaWMgcHJlZmxpZ2h0IGNoZWNrcyBiZWZvcmUgZXZhbHVhdGlvbi5cbiAgICpcbiAgICogRm9yIGV4YW1wbGUsIHRoZSBDTEkgdHJhbnNwb3J0IHZlcmlmaWVzIHRoYXQgdGhlIHZhdWx0IGlzIHJlZ2lzdGVyZWQsXG4gICAqIHRoZSBDTEkgaXMgZW5hYmxlZCwgYW5kIHRoZSBDTEkgYmluYXJ5IGlzIGluIFBBVEguXG4gICAqXG4gICAqIEBwYXJhbSB2YXVsdFBhdGggLSBUaGUgYWJzb2x1dGUgcGF0aCB0byB0aGUgdmF1bHQgZm9sZGVyLlxuICAgKi9cbiAgcHJlZmxpZ2h0Q2hlY2sodmF1bHRQYXRoOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBQdXNoZXMgZmlsZXMgaW50byBhIHZhdWx0IGRpcmVjdG9yeSBvbiB0aGUgdGFyZ2V0IGRldmljZS5cbiAgICpcbiAgICogT24gZGVza3RvcCB0aGlzIGlzIGEgbm8tb3AgKGZpbGVzIGFyZSB3cml0dGVuIHRvIHRoZSBsb2NhbCBmaWxlc3lzdGVtIGRpcmVjdGx5KS5cbiAgICogT24gbW9iaWxlIHRoaXMgdXNlcyB0aGUgZGV2aWNlJ3MgZmlsZSB0cmFuc2ZlciBtZWNoYW5pc20gKGUuZy4gQXBwaXVtIGBwdXNoRmlsZWApLlxuICAgKlxuICAgKiBAcGFyYW0gdmF1bHRQYXRoIC0gVGhlIGFic29sdXRlIHBhdGggdG8gdGhlIHZhdWx0IGZvbGRlci5cbiAgICogQHBhcmFtIGZpbGVzIC0gTWFwIG9mIHJlbGF0aXZlIGZpbGUgcGF0aHMgdG8gY29udGVudCBzdHJpbmdzLlxuICAgKi9cbiAgcHVzaEZpbGVzPyh2YXVsdFBhdGg6IHN0cmluZywgZmlsZXM6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4pOiBQcm9taXNlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSB2YXVsdCBwYXRoIHNvIE9ic2lkaWFuIGNhbiB0YXJnZXQgaXQuXG4gICAqXG4gICAqIE9uIGRlc2t0b3A6IHVzZXMgRWxlY3Ryb24gSVBDIHRvIG9wZW4gdGhlIHZhdWx0IGFuZCBwb2xscyBmb3IgcmVhZGluZXNzLlxuICAgKiBPbiBtb2JpbGU6IHB1c2hlcyB2YXVsdCBmaWxlcyB0byB0aGUgZGV2aWNlIGFuZCByZXN0YXJ0cyB0aGUgYXBwLlxuICAgKlxuICAgKiBAcGFyYW0gdmF1bHRQYXRoIC0gVGhlIGFic29sdXRlIHBhdGggdG8gdGhlIHZhdWx0IGZvbGRlci5cbiAgICovXG4gIHJlZ2lzdGVyVmF1bHQodmF1bHRQYXRoOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBVbnJlZ2lzdGVycyBhIHZhdWx0IHBhdGggZnJvbSB0aGUgcnVubmluZyBPYnNpZGlhbiBpbnN0YW5jZS5cbiAgICpcbiAgICogT24gZGVza3RvcDogY2xvc2VzIHRoZSB2YXVsdCB3aW5kb3cgYW5kIHJlbW92ZXMgaXQgZnJvbSB0aGUgcmVnaXN0cnkuXG4gICAqIE9uIG1vYmlsZTogcmVtb3ZlcyB2YXVsdCBmaWxlcyBmcm9tIHRoZSBkZXZpY2UuXG4gICAqXG4gICAqIEBwYXJhbSB2YXVsdFBhdGggLSBUaGUgYWJzb2x1dGUgcGF0aCB0byB0aGUgdmF1bHQgZm9sZGVyLlxuICAgKi9cbiAgdW5yZWdpc3RlclZhdWx0KHZhdWx0UGF0aDogc3RyaW5nKTogUHJvbWlzZTx2b2lkPjtcbn1cblxuLyoqXG4gKiBPcHRpb25zIGZvciB7QGxpbmsgT2JzaWRpYW5UcmFuc3BvcnQuZXZhbHVhdGV9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFRyYW5zcG9ydEV2YWxPcHRpb25zIHtcbiAgLyoqXG4gICAqIFRoZSB3b3JraW5nIGRpcmVjdG9yeSAodmF1bHQgcGF0aCkgZm9yIHRoZSBldmFsdWF0aW9uLlxuICAgKi9cbiAgcmVhZG9ubHkgY3dkOiBzdHJpbmc7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7IiwKICAibmFtZXMiOiBbXQp9Cg==