obsidian-integration-testing 4.3.0 → 5.0.0

package/dist/lib/esm/setup-lock.mjs

@@ -0,0 +1,132 @@
+import {
+  mkdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync
+} from "node:fs";
+import {
+  hostname,
+  tmpdir
+} from "node:os";
+import { join } from "node:path";
+import process from "node:process";
+import { log } from "./log.mjs";
+const LOCK_DIR_NAME = "obsidian-integration-testing";
+const LOCK_FILE_SUFFIX = ".setup.lock";
+const POLL_INTERVAL_IN_MILLISECONDS = 500;
+const MILLISECONDS_PER_SECOND = 1e3;
+const SECONDS_PER_MINUTE = 60;
+const STALE_LOCK_AGE_IN_MINUTES = 30;
+const DEFAULT_TIMEOUT_IN_MINUTES = 60;
+const STALE_LOCK_AGE_IN_MILLISECONDS = STALE_LOCK_AGE_IN_MINUTES * SECONDS_PER_MINUTE * MILLISECONDS_PER_SECOND;
+const DEFAULT_TIMEOUT_IN_MILLISECONDS = DEFAULT_TIMEOUT_IN_MINUTES * SECONDS_PER_MINUTE * MILLISECONDS_PER_SECOND;
+const PROCESS_EXISTENCE_PROBE_SIGNAL = 0;
+async function acquireSetupLock(params) {
+  const {
+    label,
+    scope
+  } = params;
+  const timeoutInMilliseconds = params.timeoutInMilliseconds ?? DEFAULT_TIMEOUT_IN_MILLISECONDS;
+  const lockFilePath = getLockFilePath(scope);
+  mkdirSync(getLockDir(), { recursive: true });
+  const deadlineInMilliseconds = Date.now() + timeoutInMilliseconds;
+  let hasLoggedWait = false;
+  for (; ; ) {
+    if (tryCreateLockFile(lockFilePath, label)) {
+      return createLockHandle(lockFilePath);
+    }
+    const info = readLockFileInfo(lockFilePath);
+    if (info && isLockStale(info)) {
+      log(`[integration-setup:${label}] Stealing stale '${scope}' setup lock from ${describeInfo(info)}.`);
+      rmSync(lockFilePath, { force: true });
+      continue;
+    }
+    if (Date.now() >= deadlineInMilliseconds) {
+      throw new Error(
+        `Timed out after ${String(timeoutInMilliseconds)}ms waiting for the '${scope}' integration-test setup lock held by ${describeHolder(info)}. Another integration-test run is still in progress.`
+      );
+    }
+    if (!hasLoggedWait) {
+      hasLoggedWait = true;
+      log(`[integration-setup:${label}] Waiting for the '${scope}' setup lock held by ${describeHolder(info)} to be released...`);
+    }
+    await delay(POLL_INTERVAL_IN_MILLISECONDS);
+  }
+}
+function createLockHandle(lockFilePath) {
+  let isReleased = false;
+  return {
+    release() {
+      if (isReleased) {
+        return;
+      }
+      isReleased = true;
+      rmSync(lockFilePath, { force: true });
+    }
+  };
+}
+function delay(milliseconds) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, milliseconds);
+  });
+}
+function describeHolder(info) {
+  return info ? describeInfo(info) : "another run";
+}
+function describeInfo(info) {
+  return `pid ${String(info.pid)} (${info.label}) on ${info.hostname}`;
+}
+function getErrorCode(error) {
+  if (error instanceof Error && "code" in error && typeof error.code === "string") {
+    return error.code;
+  }
+  return void 0;
+}
+function getLockDir() {
+  return join(tmpdir(), LOCK_DIR_NAME);
+}
+function getLockFilePath(scope) {
+  return join(getLockDir(), `${scope}${LOCK_FILE_SUFFIX}`);
+}
+function isLockStale(info) {
+  if (info.hostname === hostname()) {
+    return !isProcessAlive(info.pid);
+  }
+  return Date.now() - info.acquiredAtInMilliseconds > STALE_LOCK_AGE_IN_MILLISECONDS;
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, PROCESS_EXISTENCE_PROBE_SIGNAL);
+    return true;
+  } catch (error) {
+    return getErrorCode(error) === "EPERM";
+  }
+}
+function readLockFileInfo(lockFilePath) {
+  try {
+    return JSON.parse(readFileSync(lockFilePath, "utf-8"));
+  } catch {
+    return void 0;
+  }
+}
+function tryCreateLockFile(lockFilePath, label) {
+  const info = {
+    acquiredAtInMilliseconds: Date.now(),
+    hostname: hostname(),
+    label,
+    pid: process.pid
+  };
+  try {
+    writeFileSync(lockFilePath, JSON.stringify(info), { flag: "wx" });
+    return true;
+  } catch (error) {
+    if (getErrorCode(error) === "EEXIST") {
+      return false;
+    }
+    throw error;
+  }
+}
+export {
+  acquireSetupLock
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3NldHVwLWxvY2sudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDcm9zcy1wcm9jZXNzIGFkdmlzb3J5IGxvY2sgdGhhdCBzZXJpYWxpemVzIHdob2xlIGludGVncmF0aW9uLXRlc3QgcnVucy5cbiAqXG4gKiBUd28gdGVzdCBydW5zIHRoYXQgZHJpdmUgdGhlIHNhbWUgc2hhcmVkIHJlc291cmNlcyBjb3JydXB0IGVhY2ggb3RoZXI6IG9uXG4gKiBkZXNrdG9wIHRoZXkgc2hhcmUgdGhlIHNpbmdsZSBsb2NhbCBPYnNpZGlhbiBpbnN0YW5jZSwgaXRzIGBvYnNpZGlhbi5qc29uYFxuICogcmVnaXN0cnksIGFuZCB0aGUgQ0RQIHBvcnQ7IG9uIEFuZHJvaWQgdGhleSBzaGFyZSB0aGUgZW11bGF0b3IgYW5kIHRoZSBBcHBpdW1cbiAqIHNlcnZlci4gT25lIHJ1bidzIHNldHVwL3RlYXJkb3duIGtpbGxzIG9yIHJlY29uZmlndXJlcyB0aGUgaW5zdGFuY2UgdGhlIG90aGVyXG4gKiBydW4gaXMgbWlkLWV2YWwgb24gKG9ic2VydmVkIGFzIGBFQ09OTlJFRlVTRURgIG9yIFwidmF1bHQgbm90IG9wZW5cIiksIHNvIGJvdGhcbiAqIHJ1bnMgZmFpbC5cbiAqXG4gKiBUaGlzIGxvY2sgbWFrZXMgdGhlIHNlY29uZCBydW4gKip3YWl0KiogZm9yIHRoZSBmaXJzdCB0byBmaW5pc2ggaW5zdGVhZCBvZlxuICogcnVubmluZyBjb25jdXJyZW50bHkuIEl0IGlzIGhlbGQgZm9yIHRoZSBlbnRpcmUgcnVuOiBhY3F1aXJlZCBhdCB0aGUgc3RhcnQgb2ZcbiAqIHRoZSBjb3JlIHNldHVwIGFuZCByZWxlYXNlZCBieSB0aGUgY29yZSB0ZWFyZG93biAoYW5kIGJ5IHRoZSBwcm9jZXNzIGNsZWFudXBcbiAqIGhhbmRsZXJzKS4gVGhlIGxvY2sgaXMgYSBzZW50aW5lbCBmaWxlIGluIGEgc2hhcmVkIHRlbXAgZGlyZWN0b3J5LCBjYXJyeWluZ1xuICogdGhlIGhvbGRlcidzIFBJRCBzbyBhIHJ1biB0aGF0IGNyYXNoZWQgd2l0aG91dCByZWxlYXNpbmcgbGVhdmVzIGEgbG9jayB0aGF0XG4gKiB0aGUgbmV4dCBydW4gZGV0ZWN0cyBhcyBzdGFsZSBhbmQgc3RlYWxzLlxuICovXG5cbmltcG9ydCB7XG4gIG1rZGlyU3luYyxcbiAgcmVhZEZpbGVTeW5jLFxuICBybVN5bmMsXG4gIHdyaXRlRmlsZVN5bmNcbn0gZnJvbSAnbm9kZTpmcyc7XG5pbXBvcnQge1xuICBob3N0bmFtZSxcbiAgdG1wZGlyXG59IGZyb20gJ25vZGU6b3MnO1xuaW1wb3J0IHsgam9pbiB9IGZyb20gJ25vZGU6cGF0aCc7XG5pbXBvcnQgcHJvY2VzcyBmcm9tICdub2RlOnByb2Nlc3MnO1xuXG5pbXBvcnQgeyBsb2cgfSBmcm9tICcuL2xvZy5tanMnO1xuXG5jb25zdCBMT0NLX0RJUl9OQU1FID0gJ29ic2lkaWFuLWludGVncmF0aW9uLXRlc3RpbmcnO1xuY29uc3QgTE9DS19GSUxFX1NVRkZJWCA9ICcuc2V0dXAubG9jayc7XG5jb25zdCBQT0xMX0lOVEVSVkFMX0lOX01JTExJU0VDT05EUyA9IDUwMDtcbmNvbnN0IE1JTExJU0VDT05EU19QRVJfU0VDT05EID0gMTAwMDtcbmNvbnN0IFNFQ09ORFNfUEVSX01JTlVURSA9IDYwO1xuY29uc3QgU1RBTEVfTE9DS19BR0VfSU5fTUlOVVRFUyA9IDMwO1xuY29uc3QgREVGQVVMVF9USU1FT1VUX0lOX01JTlVURVMgPSA2MDtcbmNvbnN0IFNUQUxFX0xPQ0tfQUdFX0lOX01JTExJU0VDT05EUyA9IFNUQUxFX0xPQ0tfQUdFX0lOX01JTlVURVMgKiBTRUNPTkRTX1BFUl9NSU5VVEUgKiBNSUxMSVNFQ09ORFNfUEVSX1NFQ09ORDtcbmNvbnN0IERFRkFVTFRfVElNRU9VVF9JTl9NSUxMSVNFQ09ORFMgPSBERUZBVUxUX1RJTUVPVVRfSU5fTUlOVVRFUyAqIFNFQ09ORFNfUEVSX01JTlVURSAqIE1JTExJU0VDT05EU19QRVJfU0VDT05EO1xuY29uc3QgUFJPQ0VTU19FWElTVEVOQ0VfUFJPQkVfU0lHTkFMID0gMDtcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgYWNxdWlyZVNldHVwTG9ja30uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQWNxdWlyZVNldHVwTG9ja1BhcmFtcyB7XG4gIC8qKiBTaG9ydCB0cmFuc3BvcnQgbGFiZWwgZm9yIGxvZyBtZXNzYWdlcyAoZS5nLiBgXCJvYnNpZGlhbi1jbGlcImApLiAqL1xuICByZWFkb25seSBsYWJlbDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBMb2dpY2FsIHNjb3BlIHRoZSBsb2NrIHNlcmlhbGl6ZXMgd2l0aGluLiBSdW5zIHRoYXQgc2hhcmUgcmVzb3VyY2VzIG11c3RcbiAgICogdXNlIHRoZSBzYW1lIHNjb3BlIChlLmcuIGBcImRlc2t0b3BcImAgZm9yIHRoZSBDTEkvQ0RQIHRyYW5zcG9ydHMsIGBcImFuZHJvaWRcImBcbiAgICogZm9yIHRoZSBBcHBpdW0gdHJhbnNwb3J0KS5cbiAgICovXG4gIHJlYWRvbmx5IHNjb3BlOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIE1heGltdW0gdGltZSB0byB3YWl0IGZvciBhIGNvbXBldGluZyBydW4gdG8gcmVsZWFzZSB0aGUgbG9jayBiZWZvcmUgZ2l2aW5nXG4gICAqIHVwIGFuZCB0aHJvd2luZy5cbiAgICpcbiAgICogQGRlZmF1bHQgMSBob3VyXG4gICAqL1xuICByZWFkb25seSB0aW1lb3V0SW5NaWxsaXNlY29uZHM/OiBudW1iZXIgfCB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogQSBoZWxkIHNldHVwIGxvY2suIFJlbGVhc2UgaXQgb25jZSB0aGUgcnVuJ3MgdGVhcmRvd24gaXMgY29tcGxldGUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU2V0dXBMb2NrIHtcbiAgLyoqIFJlbGVhc2VzIHRoZSBsb2NrLiBTYWZlIHRvIGNhbGwgbW9yZSB0aGFuIG9uY2UuICovXG4gIHJlbGVhc2UoKTogdm9pZDtcbn1cblxuLyoqXG4gKiBUaGUgSlNPTiBwYXlsb2FkIHN0b3JlZCBpbnNpZGUgYSBsb2NrIGZpbGUsIGlkZW50aWZ5aW5nIHRoZSBob2xkZXIuXG4gKi9cbmludGVyZmFjZSBMb2NrRmlsZUluZm8ge1xuICAvKiogV2hlbiB0aGUgbG9jayB3YXMgYWNxdWlyZWQgKGBEYXRlLm5vdygpYCBlcG9jaCBtaWxsaXNlY29uZHMpLiAqL1xuICByZWFkb25seSBhY3F1aXJlZEF0SW5NaWxsaXNlY29uZHM6IG51bWJlcjtcblxuICAvKiogVGhlIGhvc3QgdGhhdCBob2xkcyB0aGUgbG9jayAoUElEIGxpdmVuZXNzIGlzIG9ubHkgdmFsaWQgb24gdGhlIHNhbWUgaG9zdCkuICovXG4gIHJlYWRvbmx5IGhvc3RuYW1lOiBzdHJpbmc7XG5cbiAgLyoqIFRoZSB0cmFuc3BvcnQgbGFiZWwgb2YgdGhlIGhvbGRpbmcgcnVuLiAqL1xuICByZWFkb25seSBsYWJlbDogc3RyaW5nO1xuXG4gIC8qKiBUaGUgcHJvY2VzcyBJRCBvZiB0aGUgaG9sZGluZyBydW4uICovXG4gIHJlYWRvbmx5IHBpZDogbnVtYmVyO1xufVxuXG4vKipcbiAqIEFjcXVpcmVzIHRoZSBjcm9zcy1wcm9jZXNzIHNldHVwIGxvY2sgZm9yIHRoZSBnaXZlbiBzY29wZSwgd2FpdGluZyB1bnRpbCBhbnlcbiAqIGNvbXBldGluZyBydW4gcmVsZWFzZXMgaXQgKG9yIGl0cyBsb2NrIGlzIGRldGVjdGVkIGFzIHN0YWxlKS5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIGxvY2sgcGFyYW1ldGVycy5cbiAqIEByZXR1cm5zIEEgaGFuZGxlIHdob3NlIHtAbGluayBTZXR1cExvY2sucmVsZWFzZX0gZnJlZXMgdGhlIGxvY2suXG4gKiBAdGhyb3dzIElmIHRoZSBsb2NrIGNhbm5vdCBiZSBhY3F1aXJlZCB3aXRoaW4gYHRpbWVvdXRJbk1pbGxpc2Vjb25kc2AuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBhY3F1aXJlU2V0dXBMb2NrKHBhcmFtczogQWNxdWlyZVNldHVwTG9ja1BhcmFtcyk6IFByb21pc2U8U2V0dXBMb2NrPiB7XG4gIGNvbnN0IHtcbiAgICBsYWJlbCxcbiAgICBzY29wZVxuICB9ID0gcGFyYW1zO1xuICBjb25zdCB0aW1lb3V0SW5NaWxsaXNlY29uZHMgPSBwYXJhbXMudGltZW91dEluTWlsbGlzZWNvbmRzID8/IERFRkFVTFRfVElNRU9VVF9JTl9NSUxMSVNFQ09ORFM7XG4gIGNvbnN0IGxvY2tGaWxlUGF0aCA9IGdldExvY2tGaWxlUGF0aChzY29wZSk7XG4gIG1rZGlyU3luYyhnZXRMb2NrRGlyKCksIHsgcmVjdXJzaXZlOiB0cnVlIH0pO1xuXG4gIGNvbnN0IGRlYWRsaW5lSW5NaWxsaXNlY29uZHMgPSBEYXRlLm5vdygpICsgdGltZW91dEluTWlsbGlzZWNvbmRzO1xuICBsZXQgaGFzTG9nZ2VkV2FpdCA9IGZhbHNlO1xuXG4gIGZvciAoOzspIHtcbiAgICBpZiAodHJ5Q3JlYXRlTG9ja0ZpbGUobG9ja0ZpbGVQYXRoLCBsYWJlbCkpIHtcbiAgICAgIHJldHVybiBjcmVhdGVMb2NrSGFuZGxlKGxvY2tGaWxlUGF0aCk7XG4gICAgfVxuXG4gICAgY29uc3QgaW5mbyA9IHJlYWRMb2NrRmlsZUluZm8obG9ja0ZpbGVQYXRoKTtcbiAgICBpZiAoaW5mbyAmJiBpc0xvY2tTdGFsZShpbmZvKSkge1xuICAgICAgbG9nKGBbaW50ZWdyYXRpb24tc2V0dXA6JHtsYWJlbH1dIFN0ZWFsaW5nIHN0YWxlICcke3Njb3BlfScgc2V0dXAgbG9jayBmcm9tICR7ZGVzY3JpYmVJbmZvKGluZm8pfS5gKTtcbiAgICAgIHJtU3luYyhsb2NrRmlsZVBhdGgsIHsgZm9yY2U6IHRydWUgfSk7XG4gICAgICBjb250aW51ZTtcbiAgICB9XG5cbiAgICBpZiAoRGF0ZS5ub3coKSA+PSBkZWFkbGluZUluTWlsbGlzZWNvbmRzKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgIGBUaW1lZCBvdXQgYWZ0ZXIgJHtTdHJpbmcodGltZW91dEluTWlsbGlzZWNvbmRzKX1tcyB3YWl0aW5nIGZvciB0aGUgJyR7c2NvcGV9JyBpbnRlZ3JhdGlvbi10ZXN0IHNldHVwIGxvY2sgYFxuICAgICAgICAgICsgYGhlbGQgYnkgJHtkZXNjcmliZUhvbGRlcihpbmZvKX0uIEFub3RoZXIgaW50ZWdyYXRpb24tdGVzdCBydW4gaXMgc3RpbGwgaW4gcHJvZ3Jlc3MuYFxuICAgICAgKTtcbiAgICB9XG5cbiAgICBpZiAoIWhhc0xvZ2dlZFdhaXQpIHtcbiAgICAgIGhhc0xvZ2dlZFdhaXQgPSB0cnVlO1xuICAgICAgbG9nKGBbaW50ZWdyYXRpb24tc2V0dXA6JHtsYWJlbH1dIFdhaXRpbmcgZm9yIHRoZSAnJHtzY29wZX0nIHNldHVwIGxvY2sgaGVsZCBieSAke2Rlc2NyaWJlSG9sZGVyKGluZm8pfSB0byBiZSByZWxlYXNlZC4uLmApO1xuICAgIH1cblxuICAgIGF3YWl0IGRlbGF5KFBPTExfSU5URVJWQUxfSU5fTUlMTElTRUNPTkRTKTtcbiAgfVxufVxuXG4vKipcbiAqIENyZWF0ZXMgYSB7QGxpbmsgU2V0dXBMb2NrfSBoYW5kbGUgdGhhdCByZW1vdmVzIHRoZSBsb2NrIGZpbGUgb24gcmVsZWFzZS5cbiAqXG4gKiBAcGFyYW0gbG9ja0ZpbGVQYXRoIC0gVGhlIHBhdGggdG8gdGhlIGxvY2sgZmlsZSB0byByZW1vdmUgb24gcmVsZWFzZS5cbiAqIEByZXR1cm5zIFRoZSBsb2NrIGhhbmRsZS5cbiAqL1xuZnVuY3Rpb24gY3JlYXRlTG9ja0hhbmRsZShsb2NrRmlsZVBhdGg6IHN0cmluZyk6IFNldHVwTG9jayB7XG4gIGxldCBpc1JlbGVhc2VkID0gZmFsc2U7XG4gIHJldHVybiB7XG4gICAgcmVsZWFzZSgpOiB2b2lkIHtcbiAgICAgIGlmIChpc1JlbGVhc2VkKSB7XG4gICAgICAgIHJldHVybjtcbiAgICAgIH1cbiAgICAgIGlzUmVsZWFzZWQgPSB0cnVlO1xuICAgICAgcm1TeW5jKGxvY2tGaWxlUGF0aCwgeyBmb3JjZTogdHJ1ZSB9KTtcbiAgICB9XG4gIH07XG59XG5cbi8qKlxuICogUmVzb2x2ZXMgYWZ0ZXIgdGhlIGdpdmVuIGRlbGF5LiBVc2VkIHRvIHBvbGwgYmV0d2VlbiBsb2NrLWFjcXVpc2l0aW9uIGF0dGVtcHRzLlxuICpcbiAqIEBwYXJhbSBtaWxsaXNlY29uZHMgLSBUaGUgZGVsYXkgaW4gbWlsbGlzZWNvbmRzLlxuICogQHJldHVybnMgQSBwcm9taXNlIHRoYXQgcmVzb2x2ZXMgYWZ0ZXIgdGhlIGRlbGF5LlxuICovXG5mdW5jdGlvbiBkZWxheShtaWxsaXNlY29uZHM6IG51bWJlcik6IFByb21pc2U8dm9pZD4ge1xuICByZXR1cm4gbmV3IFByb21pc2U8dm9pZD4oKHJlc29sdmUpID0+IHtcbiAgICBzZXRUaW1lb3V0KHJlc29sdmUsIG1pbGxpc2Vjb25kcyk7XG4gIH0pO1xufVxuXG4vKipcbiAqIEJ1aWxkcyBhIGh1bWFuLXJlYWRhYmxlIGRlc2NyaXB0aW9uIG9mIHRoZSBjdXJyZW50IGxvY2sgaG9sZGVyIGZvciBsb2cvZXJyb3JcbiAqIG1lc3NhZ2VzLlxuICpcbiAqIEBwYXJhbSBpbmZvIC0gVGhlIHBhcnNlZCBsb2NrIGluZm8sIG9yIGB1bmRlZmluZWRgIGlmIGl0IGNvdWxkIG5vdCBiZSByZWFkLlxuICogQHJldHVybnMgQSBkZXNjcmlwdGlvbiBzdHJpbmcuXG4gKi9cbmZ1bmN0aW9uIGRlc2NyaWJlSG9sZGVyKGluZm86IExvY2tGaWxlSW5mbyB8IHVuZGVmaW5lZCk6IHN0cmluZyB7XG4gIHJldHVybiBpbmZvID8gZGVzY3JpYmVJbmZvKGluZm8pIDogJ2Fub3RoZXIgcnVuJztcbn1cblxuLyoqXG4gKiBGb3JtYXRzIGEge0BsaW5rIExvY2tGaWxlSW5mb30gYXMgYSBzaG9ydCBpZGVudGlmaWVyIHN0cmluZy5cbiAqXG4gKiBAcGFyYW0gaW5mbyAtIFRoZSBsb2NrIGluZm8uXG4gKiBAcmV0dXJucyBBIHN0cmluZyBsaWtlIGBwaWQgMTIzNCAob2JzaWRpYW4tY2xpKSBvbiBob3N0YC5cbiAqL1xuZnVuY3Rpb24gZGVzY3JpYmVJbmZvKGluZm86IExvY2tGaWxlSW5mbyk6IHN0cmluZyB7XG4gIHJldHVybiBgcGlkICR7U3RyaW5nKGluZm8ucGlkKX0gKCR7aW5mby5sYWJlbH0pIG9uICR7aW5mby5ob3N0bmFtZX1gO1xufVxuXG4vKipcbiAqIEV4dHJhY3RzIHRoZSBgY29kZWAgZnJvbSBhIE5vZGUuanMgc3lzdGVtIGVycm9yLCBpZiBwcmVzZW50LlxuICpcbiAqIEBwYXJhbSBlcnJvciAtIFRoZSB0aHJvd24gdmFsdWUuXG4gKiBAcmV0dXJucyBUaGUgZXJyb3IgY29kZSBzdHJpbmcsIG9yIGB1bmRlZmluZWRgIGlmIG5vdCBhIGNvZGVkIGVycm9yLlxuICovXG5mdW5jdGlvbiBnZXRFcnJvckNvZGUoZXJyb3I6IHVua25vd24pOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuICBpZiAoZXJyb3IgaW5zdGFuY2VvZiBFcnJvciAmJiAnY29kZScgaW4gZXJyb3IgJiYgdHlwZW9mIGVycm9yLmNvZGUgPT09ICdzdHJpbmcnKSB7XG4gICAgcmV0dXJuIGVycm9yLmNvZGU7XG4gIH1cbiAgcmV0dXJuIHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBSZXR1cm5zIHRoZSBzaGFyZWQgbG9jayBkaXJlY3RvcnkgaW5zaWRlIHRoZSBPUyB0ZW1wIGRpcmVjdG9yeS5cbiAqXG4gKiBAcmV0dXJucyBUaGUgYWJzb2x1dGUgcGF0aCB0byB0aGUgbG9jayBkaXJlY3RvcnkuXG4gKi9cbmZ1bmN0aW9uIGdldExvY2tEaXIoKTogc3RyaW5nIHtcbiAgcmV0dXJuIGpvaW4odG1wZGlyKCksIExPQ0tfRElSX05BTUUpO1xufVxuXG4vKipcbiAqIFJldHVybnMgdGhlIGxvY2sgZmlsZSBwYXRoIGZvciB0aGUgZ2l2ZW4gc2NvcGUuXG4gKlxuICogQHBhcmFtIHNjb3BlIC0gVGhlIGxvY2sgc2NvcGUuXG4gKiBAcmV0dXJucyBUaGUgYWJzb2x1dGUgcGF0aCB0byB0aGUgc2NvcGUncyBsb2NrIGZpbGUuXG4gKi9cbmZ1bmN0aW9uIGdldExvY2tGaWxlUGF0aChzY29wZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIGpvaW4oZ2V0TG9ja0RpcigpLCBgJHtzY29wZX0ke0xPQ0tfRklMRV9TVUZGSVh9YCk7XG59XG5cbi8qKlxuICogRGV0ZXJtaW5lcyB3aGV0aGVyIGEgbG9jayBjYW4gYmUgY29uc2lkZXJlZCBhYmFuZG9uZWQuXG4gKlxuICogT24gdGhlIHNhbWUgaG9zdCwgdGhlIGhvbGRlcidzIFBJRCBpcyBwcm9iZWQgZGlyZWN0bHk6IGEgZGVhZCBQSUQgbWVhbnMgdGhlXG4gKiBydW4gY3Jhc2hlZCB3aXRob3V0IHJlbGVhc2luZy4gT24gYSBkaWZmZXJlbnQgaG9zdCAoYSBzaGFyZWQvbmV0d29yayB0ZW1wXG4gKiBkaXJlY3RvcnkpIHRoZSBQSUQgY2Fubm90IGJlIHByb2JlZCwgc28gYW4gYWdlIHRocmVzaG9sZCBpcyB1c2VkIGluc3RlYWQuXG4gKlxuICogQHBhcmFtIGluZm8gLSBUaGUgcGFyc2VkIGxvY2sgaW5mby5cbiAqIEByZXR1cm5zIGB0cnVlYCBpZiB0aGUgbG9jayBpcyBzdGFsZSBhbmQgbWF5IGJlIHN0b2xlbi5cbiAqL1xuZnVuY3Rpb24gaXNMb2NrU3RhbGUoaW5mbzogTG9ja0ZpbGVJbmZvKTogYm9vbGVhbiB7XG4gIGlmIChpbmZvLmhvc3RuYW1lID09PSBob3N0bmFtZSgpKSB7XG4gICAgcmV0dXJuICFpc1Byb2Nlc3NBbGl2ZShpbmZvLnBpZCk7XG4gIH1cblxuICByZXR1cm4gRGF0ZS5ub3coKSAtIGluZm8uYWNxdWlyZWRBdEluTWlsbGlzZWNvbmRzID4gU1RBTEVfTE9DS19BR0VfSU5fTUlMTElTRUNPTkRTO1xufVxuXG4vKipcbiAqIENoZWNrcyB3aGV0aGVyIGEgcHJvY2VzcyB3aXRoIHRoZSBnaXZlbiBQSUQgaXMgY3VycmVudGx5IGFsaXZlLlxuICpcbiAqIEBwYXJhbSBwaWQgLSBUaGUgcHJvY2VzcyBJRCB0byBwcm9iZS5cbiAqIEByZXR1cm5zIGB0cnVlYCBpZiB0aGUgcHJvY2VzcyBleGlzdHMuXG4gKi9cbmZ1bmN0aW9uIGlzUHJvY2Vzc0FsaXZlKHBpZDogbnVtYmVyKTogYm9vbGVhbiB7XG4gIHRyeSB7XG4gICAgcHJvY2Vzcy5raWxsKHBpZCwgUFJPQ0VTU19FWElTVEVOQ0VfUFJPQkVfU0lHTkFMKTtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfSBjYXRjaCAoZXJyb3I6IHVua25vd24pIHtcbiAgICAvLyBgRVBFUk1gIG1lYW5zIHRoZSBwcm9jZXNzIGV4aXN0cyBidXQgaXMgb3duZWQgYnkgYW5vdGhlciB1c2VyIFx1MjAxNCBzdGlsbCBhbGl2ZS5cbiAgICByZXR1cm4gZ2V0RXJyb3JDb2RlKGVycm9yKSA9PT0gJ0VQRVJNJztcbiAgfVxufVxuXG4vKipcbiAqIFJlYWRzIGFuZCBwYXJzZXMgdGhlIGxvY2sgZmlsZSwgaWYgaXQgZXhpc3RzIGFuZCBpcyB2YWxpZCBKU09OLlxuICpcbiAqIEBwYXJhbSBsb2NrRmlsZVBhdGggLSBUaGUgcGF0aCB0byB0aGUgbG9jayBmaWxlLlxuICogQHJldHVybnMgVGhlIHBhcnNlZCBsb2NrIGluZm8sIG9yIGB1bmRlZmluZWRgIGlmIGl0IGNvdWxkIG5vdCBiZSByZWFkLlxuICovXG5mdW5jdGlvbiByZWFkTG9ja0ZpbGVJbmZvKGxvY2tGaWxlUGF0aDogc3RyaW5nKTogTG9ja0ZpbGVJbmZvIHwgdW5kZWZpbmVkIHtcbiAgdHJ5IHtcbiAgICByZXR1cm4gSlNPTi5wYXJzZShyZWFkRmlsZVN5bmMobG9ja0ZpbGVQYXRoLCAndXRmLTgnKSkgYXMgTG9ja0ZpbGVJbmZvO1xuICB9IGNhdGNoIHtcbiAgICByZXR1cm4gdW5kZWZpbmVkO1xuICB9XG59XG5cbi8qKlxuICogQXR0ZW1wdHMgdG8gYXRvbWljYWxseSBjcmVhdGUgdGhlIGxvY2sgZmlsZSAoZmFpbGluZyBpZiBpdCBhbHJlYWR5IGV4aXN0cykuXG4gKlxuICogQHBhcmFtIGxvY2tGaWxlUGF0aCAtIFRoZSBwYXRoIHRvIHRoZSBsb2NrIGZpbGUuXG4gKiBAcGFyYW0gbGFiZWwgLSBUaGUgdHJhbnNwb3J0IGxhYmVsIHRvIHJlY29yZCBpbiB0aGUgbG9jayBmaWxlLlxuICogQHJldHVybnMgYHRydWVgIGlmIHRoZSBsb2NrIHdhcyBhY3F1aXJlZCwgYGZhbHNlYCBpZiBpdCBpcyBhbHJlYWR5IGhlbGQuXG4gKiBAdGhyb3dzIElmIHRoZSBmaWxlIHN5c3RlbSBmYWlscyBmb3IgYW55IHJlYXNvbiBvdGhlciB0aGFuIHRoZSBmaWxlIGV4aXN0aW5nLlxuICovXG5mdW5jdGlvbiB0cnlDcmVhdGVMb2NrRmlsZShsb2NrRmlsZVBhdGg6IHN0cmluZywgbGFiZWw6IHN0cmluZyk6IGJvb2xlYW4ge1xuICBjb25zdCBpbmZvOiBMb2NrRmlsZUluZm8gPSB7XG4gICAgYWNxdWlyZWRBdEluTWlsbGlzZWNvbmRzOiBEYXRlLm5vdygpLFxuICAgIGhvc3RuYW1lOiBob3N0bmFtZSgpLFxuICAgIGxhYmVsLFxuICAgIHBpZDogcHJvY2Vzcy5waWRcbiAgfTtcblxuICB0cnkge1xuICAgIHdyaXRlRmlsZVN5bmMobG9ja0ZpbGVQYXRoLCBKU09OLnN0cmluZ2lmeShpbmZvKSwgeyBmbGFnOiAnd3gnIH0pO1xuICAgIHJldHVybiB0cnVlO1xuICB9IGNhdGNoIChlcnJvcjogdW5rbm93bikge1xuICAgIGlmIChnZXRFcnJvckNvZGUoZXJyb3IpID09PSAnRUVYSVNUJykge1xuICAgICAgcmV0dXJuIGZhbHNlO1xuICAgIH1cbiAgICB0aHJvdyBlcnJvcjtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIkFBb0JBO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUDtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQLFNBQVMsWUFBWTtBQUNyQixPQUFPLGFBQWE7QUFFcEIsU0FBUyxXQUFXO0FBRXBCLE1BQU0sZ0JBQWdCO0FBQ3RCLE1BQU0sbUJBQW1CO0FBQ3pCLE1BQU0sZ0NBQWdDO0FBQ3RDLE1BQU0sMEJB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

package/dist/lib/esm/transport-desktop-cdp.d.mts

@@ -4,18 +4,17 @@
  * Desktop CDP transport — evaluates expressions via Chrome DevTools Protocol
  * over WebSocket and manages vaults via Electron IPC.
  *
- * Obsidian exposes CDP on port 8315 by default. This transport connects to
- * page targets, sends `Runtime.evaluate` commands, and routes to the correct
- * vault target using `getBasePath()` probing.
+ * Two modes:
+ * - **Owned (default)**: the transport launches and owns an isolated Obsidian
+ *   instance against a temporary `--user-data-dir` on a free `--remote-debugging-port`,
+ *   never touching the user's Obsidian. Supports version pinning via the user-data asar.
+ * - **Attach**: when an explicit CDP port is configured, the transport connects
+ *   to an already-running Obsidian on that port.
  *
- * Advantages over CLI transport:
- * - No CLI binary installation needed
- * - No "CLI enabled" setting required in Obsidian
- * - Lower overhead (WebSocket vs. process spawn per eval)
+ * It connects to page targets, sends `Runtime.evaluate` commands, and routes to
+ * the correct vault target using `getBasePath()` probing.
  *
- * Requirements:
- * - Obsidian must be running with remote debugging enabled (port 8315)
- * - Node.js 22+ (uses built-in `WebSocket` and `fetch` globals)
+ * Requirements: Node.js 22+ (uses built-in `WebSocket` and `fetch` globals).
  */
 import type { ObsidianTransport, TransportEvalOptions } from './transport.mjs';
 /**
@@ -27,7 +26,9 @@ export interface DesktopCdpTransportConfig {
      */
     cdpHost?: string;
     /**
-     * CDP port. Defaults to `8315`.
+     * CDP port for **attach** mode (the `--remote-debugging-port` the running
+     * Obsidian was launched with). In owned-instance mode this is ignored — a
+     * free port is chosen at launch.
      */
     cdpPort?: number;
     /**
@@ -35,6 +36,37 @@ export interface DesktopCdpTransportConfig {
      * Defaults to `30000`.
      */
     commandTimeoutInMilliseconds?: number;
+    /**
+     * When set, the transport launches and owns an isolated Obsidian instance
+     * instead of attaching to a running one. This is the default desktop mode.
+     */
+    ownedInstance?: OwnedInstanceConfig;
+}
+/**
+ * An asar to provision into a harness-owned instance's user-data dir before launch.
+ */
+export interface OwnedInstanceAsar {
+    /** Absolute path to the cached/source asar file. */
+    readonly path: string;
+    /** The asar's `x.y.z` version. */
+    readonly version: string;
+}
+/**
+ * Configuration for a harness-owned, isolated Obsidian instance.
+ *
+ * When present, the transport launches and owns its own Obsidian process
+ * against an isolated user-data dir instead of attaching to a running instance.
+ */
+export interface OwnedInstanceConfig {
+    /** Optional asar to provision into {@link userDataDir} before launch. */
+    readonly asar?: OwnedInstanceAsar | undefined;
+    /** Absolute path to the Obsidian shell executable to launch. */
+    readonly exePath: string;
+    /**
+     * Absolute path to the isolated user-data dir. Created and owned by the
+     * transport, and deleted on dispose.
+     */
+    readonly userDataDir: string;
 }
 /**
  * Transport that communicates with Desktop Obsidian via Chrome DevTools Protocol.
@@ -48,10 +80,13 @@ export declare class DesktopCdpTransport implements ObsidianTransport {
      */
     readonly isMobile = false;
     private activeVaultPath;
-    private readonly cdpPort;
-    private readonly cdpUrl;
+    private readonly cdpHost;
+    private cdpPort;
+    private cdpUrl;
     private readonly commandTimeoutInMilliseconds;
     private messageId;
+    private readonly ownedConfig;
+    private ownedInstance;
     private ws;
     /**
      * Creates a new CDP transport.
@@ -60,9 +95,19 @@ export declare class DesktopCdpTransport implements ObsidianTransport {
      */
     constructor(config?: DesktopCdpTransportConfig);
     /**
-     * Disposes of the active WebSocket connection.
+     * Disposes of the active WebSocket connection and, in owned-instance mode,
+     * kills the owned Obsidian process and removes its isolated user-data dir.
+     *
+     * The removal is retried because Windows briefly holds the just-killed
+     * process's file handles, which would otherwise fail `rmSync` with `EPERM`.
      */
     dispose(): Promise<void>;
+    /**
+     * Synchronous disposal — kills the owned instance and makes a best-effort
+     * removal of its user-data dir. Safe to call from a process `exit` handler
+     * (where async retries are impossible; a leftover temp dir is acceptable).
+     */
+    disposeSync(): void;
     /**
      * Evaluates a JavaScript expression inside Obsidian via CDP `Runtime.evaluate`.
      *
@@ -170,6 +215,15 @@ export declare class DesktopCdpTransport implements ObsidianTransport {
      * @returns The vault's base path.
      */
     private probeVaultPath;
+    /**
+     * Launches and connects to a harness-owned, isolated Obsidian instance for a
+     * vault: provisions the asar (if any), pre-seeds the isolated `obsidian.json`
+     * so the vault opens directly, launches the instance on a free CDP port, then
+     * waits until the vault window is ready and dismisses the trust dialog.
+     *
+     * @param vaultPath - The absolute path to the vault folder.
+     */
+    private registerVaultInOwnedInstance;
     /**
      * Sends a CDP command over WebSocket and waits for the response.
      *
@@ -192,4 +246,11 @@ export declare class DesktopCdpTransport implements ObsidianTransport {
      * @param vaultPath - The vault path to evaluate in.
      */
     private waitForLayoutReady;
+    /**
+     * Polls the owned instance until the vault target exists, layout is ready, and
+     * the trust dialog (if any) has been dismissed.
+     *
+     * @param vaultPath - The absolute path to the vault folder.
+     */
+    private waitForOwnedVaultReady;
 }