obsidian-integration-testing 4.4.0 → 5.0.0

package/dist/lib/esm/obsidian-version.d.mts

@@ -0,0 +1,111 @@
+/**
+ * @file
+ *
+ * Pure helpers for resolving Obsidian desktop version specifiers.
+ *
+ * A version specifier is either an explicit `x.y.z` string or one of the
+ * channel aliases {@link PUBLIC_LATEST} / {@link CATALYST_LATEST}, which resolve
+ * against Obsidian's published desktop releases manifest.
+ *
+ * The network call that fetches the manifest lives in the integration-time
+ * version-switch module; everything here is pure and unit-tested.
+ */
+/**
+ * Version specifier alias resolving to the latest **public** desktop release
+ * (the manifest's `latestVersion`).
+ */
+export declare const PUBLIC_LATEST = "public-latest";
+/**
+ * Version specifier alias resolving to the latest **catalyst** (early access /
+ * insider) desktop release (the manifest's `beta.latestVersion`).
+ */
+export declare const CATALYST_LATEST = "catalyst-latest";
+/**
+ * URL of Obsidian's desktop releases manifest (raw JSON).
+ */
+export declare const DESKTOP_RELEASES_MANIFEST_URL = "https://raw.githubusercontent.com/obsidianmd/obsidian-releases/master/desktop-releases.json";
+/**
+ * A version specifier resolved against a release channel.
+ */
+export interface ChannelVersionSpec {
+    /** The channel to resolve against the manifest. */
+    readonly channel: ReleaseChannel;
+    /** Discriminant. */
+    readonly kind: 'channel';
+}
+/**
+ * The `beta` (catalyst) entry of {@link DesktopReleasesManifest}.
+ */
+export interface DesktopReleasesBeta {
+    /** The latest catalyst version, e.g. `'1.13.1'`. */
+    readonly latestVersion: string;
+}
+/**
+ * The subset of Obsidian's `desktop-releases.json` this library reads.
+ */
+export interface DesktopReleasesManifest {
+    /**
+     * The latest catalyst (early access / insider) release, when present.
+     */
+    readonly beta?: DesktopReleasesBeta;
+    /**
+     * The latest public (stable) version, e.g. `'1.12.7'`.
+     */
+    readonly latestVersion: string;
+}
+/**
+ * A version specifier naming a concrete `x.y.z` version.
+ */
+export interface ExplicitVersionSpec {
+    /** Discriminant. */
+    readonly kind: 'explicit';
+    /** The concrete `x.y.z` version. */
+    readonly version: string;
+}
+/**
+ * A release channel resolved from a channel-alias specifier.
+ *
+ * - `public` — the latest stable release.
+ * - `catalyst` — the latest early access / insider release.
+ */
+export type ReleaseChannel = 'catalyst' | 'public';
+/**
+ * The parsed form of a version specifier.
+ *
+ * - `explicit` — a concrete `x.y.z` version.
+ * - `channel` — a channel alias to be resolved against the manifest.
+ */
+export type VersionSpec = ChannelVersionSpec | ExplicitVersionSpec;
+/**
+ * Compares two `x.y.z` version strings numerically, segment by segment.
+ *
+ * @param a - The first version.
+ * @param b - The second version.
+ * @returns A negative number if `a < b`, `0` if equal, a positive number if `a > b`.
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Returns the user-data asar file name for a given version, matching the name
+ * Obsidian itself uses when it downloads an update (`obsidian-<version>.asar`).
+ *
+ * @param version - A concrete `x.y.z` version.
+ * @returns The asar file name.
+ */
+export declare function getVersionAsarFileName(version: string): string;
+/**
+ * Parses a version specifier into either an explicit version or a channel alias.
+ *
+ * @param spec - The specifier: an `x.y.z` string, {@link PUBLIC_LATEST}, or {@link CATALYST_LATEST}.
+ * @returns The parsed {@link VersionSpec}.
+ * @throws Error if the specifier is neither a valid `x.y.z` version nor a known alias.
+ */
+export declare function parseVersionSpec(spec: string): VersionSpec;
+/**
+ * Resolves a channel to a concrete version using a desktop releases manifest.
+ *
+ * @param manifest - The parsed manifest.
+ * @param channel - The channel to resolve.
+ * @returns The concrete `x.y.z` version for the channel.
+ * @throws Error if the catalyst channel is requested but the manifest has no `beta` entry.
+ */
+export declare function resolveVersionFromManifest(manifest: DesktopReleasesManifest, channel: ReleaseChannel): string;

package/dist/lib/esm/obsidian-version.mjs

@@ -0,0 +1,55 @@
+const PUBLIC_LATEST = "public-latest";
+const CATALYST_LATEST = "catalyst-latest";
+const DESKTOP_RELEASES_MANIFEST_URL = "https://raw.githubusercontent.com/obsidianmd/obsidian-releases/master/desktop-releases.json";
+const EXPLICIT_VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
+const VERSION_SEGMENT_COUNT = 3;
+function compareVersions(a, b) {
+  const aSegments = parseVersionSegments(a);
+  const bSegments = parseVersionSegments(b);
+  for (let i = 0; i < VERSION_SEGMENT_COUNT; i++) {
+    const diff = (aSegments[i] ?? 0) - (bSegments[i] ?? 0);
+    if (diff !== 0) {
+      return diff;
+    }
+  }
+  return 0;
+}
+function getVersionAsarFileName(version) {
+  return `obsidian-${version}.asar`;
+}
+function parseVersionSpec(spec) {
+  if (spec === PUBLIC_LATEST) {
+    return { channel: "public", kind: "channel" };
+  }
+  if (spec === CATALYST_LATEST) {
+    return { channel: "catalyst", kind: "channel" };
+  }
+  if (EXPLICIT_VERSION_PATTERN.test(spec)) {
+    return { kind: "explicit", version: spec };
+  }
+  throw new Error(
+    `Invalid Obsidian version "${spec}". Expected an "x.y.z" version, "${PUBLIC_LATEST}", or "${CATALYST_LATEST}".`
+  );
+}
+function resolveVersionFromManifest(manifest, channel) {
+  if (channel === "public") {
+    return manifest.latestVersion;
+  }
+  if (!manifest.beta) {
+    throw new Error("Desktop releases manifest has no catalyst (beta) release.");
+  }
+  return manifest.beta.latestVersion;
+}
+function parseVersionSegments(version) {
+  return version.split(".").map((segment) => Number.parseInt(segment, 10));
+}
+export {
+  CATALYST_LATEST,
+  DESKTOP_RELEASES_MANIFEST_URL,
+  PUBLIC_LATEST,
+  compareVersions,
+  getVersionAsarFileName,
+  parseVersionSpec,
+  resolveVersionFromManifest
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL29ic2lkaWFuLXZlcnNpb24udHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBQdXJlIGhlbHBlcnMgZm9yIHJlc29sdmluZyBPYnNpZGlhbiBkZXNrdG9wIHZlcnNpb24gc3BlY2lmaWVycy5cbiAqXG4gKiBBIHZlcnNpb24gc3BlY2lmaWVyIGlzIGVpdGhlciBhbiBleHBsaWNpdCBgeC55LnpgIHN0cmluZyBvciBvbmUgb2YgdGhlXG4gKiBjaGFubmVsIGFsaWFzZXMge0BsaW5rIFBVQkxJQ19MQVRFU1R9IC8ge0BsaW5rIENBVEFMWVNUX0xBVEVTVH0sIHdoaWNoIHJlc29sdmVcbiAqIGFnYWluc3QgT2JzaWRpYW4ncyBwdWJsaXNoZWQgZGVza3RvcCByZWxlYXNlcyBtYW5pZmVzdC5cbiAqXG4gKiBUaGUgbmV0d29yayBjYWxsIHRoYXQgZmV0Y2hlcyB0aGUgbWFuaWZlc3QgbGl2ZXMgaW4gdGhlIGludGVncmF0aW9uLXRpbWVcbiAqIHZlcnNpb24tc3dpdGNoIG1vZHVsZTsgZXZlcnl0aGluZyBoZXJlIGlzIHB1cmUgYW5kIHVuaXQtdGVzdGVkLlxuICovXG5cbi8qKlxuICogVmVyc2lvbiBzcGVjaWZpZXIgYWxpYXMgcmVzb2x2aW5nIHRvIHRoZSBsYXRlc3QgKipwdWJsaWMqKiBkZXNrdG9wIHJlbGVhc2VcbiAqICh0aGUgbWFuaWZlc3QncyBgbGF0ZXN0VmVyc2lvbmApLlxuICovXG5leHBvcnQgY29uc3QgUFVCTElDX0xBVEVTVCA9ICdwdWJsaWMtbGF0ZXN0JztcblxuLyoqXG4gKiBWZXJzaW9uIHNwZWNpZmllciBhbGlhcyByZXNvbHZpbmcgdG8gdGhlIGxhdGVzdCAqKmNhdGFseXN0KiogKGVhcmx5IGFjY2VzcyAvXG4gKiBpbnNpZGVyKSBkZXNrdG9wIHJlbGVhc2UgKHRoZSBtYW5pZmVzdCdzIGBiZXRhLmxhdGVzdFZlcnNpb25gKS5cbiAqL1xuZXhwb3J0IGNvbnN0IENBVEFMWVNUX0xBVEVTVCA9ICdjYXRhbHlzdC1sYXRlc3QnO1xuXG4vKipcbiAqIFVSTCBvZiBPYnNpZGlhbidzIGRlc2t0b3AgcmVsZWFzZXMgbWFuaWZlc3QgKHJhdyBKU09OKS5cbiAqL1xuZXhwb3J0IGNvbnN0IERFU0tUT1BfUkVMRUFTRVNfTUFOSUZFU1RfVVJMID0gJ2h0dHBzOi8vcmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbS9vYnNpZGlhbm1kL29ic2lkaWFuLXJlbGVhc2VzL21hc3Rlci9kZXNrdG9wLXJlbGVhc2VzLmpzb24nO1xuXG5jb25zdCBFWFBMSUNJVF9WRVJTSU9OX1BBVFRFUk4gPSAvXlxcZCtcXC5cXGQrXFwuXFxkKyQvO1xuY29uc3QgVkVSU0lPTl9TRUdNRU5UX0NPVU5UID0gMztcblxuLyoqXG4gKiBBIHZlcnNpb24gc3BlY2lmaWVyIHJlc29sdmVkIGFnYWluc3QgYSByZWxlYXNlIGNoYW5uZWwuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ2hhbm5lbFZlcnNpb25TcGVjIHtcbiAgLyoqIFRoZSBjaGFubmVsIHRvIHJlc29sdmUgYWdhaW5zdCB0aGUgbWFuaWZlc3QuICovXG4gIHJlYWRvbmx5IGNoYW5uZWw6IFJlbGVhc2VDaGFubmVsO1xuXG4gIC8qKiBEaXNjcmltaW5hbnQuICovXG4gIHJlYWRvbmx5IGtpbmQ6ICdjaGFubmVsJztcbn1cblxuLyoqXG4gKiBUaGUgYGJldGFgIChjYXRhbHlzdCkgZW50cnkgb2Yge0BsaW5rIERlc2t0b3BSZWxlYXNlc01hbmlmZXN0fS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBEZXNrdG9wUmVsZWFzZXNCZXRhIHtcbiAgLyoqIFRoZSBsYXRlc3QgY2F0YWx5c3QgdmVyc2lvbiwgZS5nLiBgJzEuMTMuMSdgLiAqL1xuICByZWFkb25seSBsYXRlc3RWZXJzaW9uOiBzdHJpbmc7XG59XG5cbi8qKlxuICogVGhlIHN1YnNldCBvZiBPYnNpZGlhbidzIGBkZXNrdG9wLXJlbGVhc2VzLmpzb25gIHRoaXMgbGlicmFyeSByZWFkcy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBEZXNrdG9wUmVsZWFzZXNNYW5pZmVzdCB7XG4gIC8qKlxuICAgKiBUaGUgbGF0ZXN0IGNhdGFseXN0IChlYXJseSBhY2Nlc3MgLyBpbnNpZGVyKSByZWxlYXNlLCB3aGVuIHByZXNlbnQuXG4gICAqL1xuICByZWFkb25seSBiZXRhPzogRGVza3RvcFJlbGVhc2VzQmV0YTtcblxuICAvKipcbiAgICogVGhlIGxhdGVzdCBwdWJsaWMgKHN0YWJsZSkgdmVyc2lvbiwgZS5nLiBgJzEuMTIuNydgLlxuICAgKi9cbiAgcmVhZG9ubHkgbGF0ZXN0VmVyc2lvbjogc3RyaW5nO1xufVxuXG4vKipcbiAqIEEgdmVyc2lvbiBzcGVjaWZpZXIgbmFtaW5nIGEgY29uY3JldGUgYHgueS56YCB2ZXJzaW9uLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEV4cGxpY2l0VmVyc2lvblNwZWMge1xuICAvKiogRGlzY3JpbWluYW50LiAqL1xuICByZWFkb25seSBraW5kOiAnZXhwbGljaXQnO1xuXG4gIC8qKiBUaGUgY29uY3JldGUgYHgueS56YCB2ZXJzaW9uLiAqL1xuICByZWFkb25seSB2ZXJzaW9uOiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSByZWxlYXNlIGNoYW5uZWwgcmVzb2x2ZWQgZnJvbSBhIGNoYW5uZWwtYWxpYXMgc3BlY2lmaWVyLlxuICpcbiAqIC0gYHB1YmxpY2AgXHUyMDE0IHRoZSBsYXRlc3Qgc3RhYmxlIHJlbGVhc2UuXG4gKiAtIGBjYXRhbHlzdGAgXHUyMDE0IHRoZSBsYXRlc3QgZWFybHkgYWNjZXNzIC8gaW5zaWRlciByZWxlYXNlLlxuICovXG5leHBvcnQgdHlwZSBSZWxlYXNlQ2hhbm5lbCA9ICdjYXRhbHlzdCcgfCAncHVibGljJztcblxuLyoqXG4gKiBUaGUgcGFyc2VkIGZvcm0gb2YgYSB2ZXJzaW9uIHNwZWNpZmllci5cbiAqXG4gKiAtIGBleHBsaWNpdGAgXHUyMDE0IGEgY29uY3JldGUgYHgueS56YCB2ZXJzaW9uLlxuICogLSBgY2hhbm5lbGAgXHUyMDE0IGEgY2hhbm5lbCBhbGlhcyB0byBiZSByZXNvbHZlZCBhZ2FpbnN0IHRoZSBtYW5pZmVzdC5cbiAqL1xuZXhwb3J0IHR5cGUgVmVyc2lvblNwZWMgPSBDaGFubmVsVmVyc2lvblNwZWMgfCBFeHBsaWNpdFZlcnNpb25TcGVjO1xuXG4vKipcbiAqIENvbXBhcmVzIHR3byBgeC55LnpgIHZlcnNpb24gc3RyaW5ncyBudW1lcmljYWxseSwgc2VnbWVudCBieSBzZWdtZW50LlxuICpcbiAqIEBwYXJhbSBhIC0gVGhlIGZpcnN0IHZlcnNpb24uXG4gKiBAcGFyYW0gYiAtIFRoZSBzZWNvbmQgdmVyc2lvbi5cbiAqIEByZXR1cm5zIEEgbmVnYXRpdmUgbnVtYmVyIGlmIGBhIDwgYmAsIGAwYCBpZiBlcXVhbCwgYSBwb3NpdGl2ZSBudW1iZXIgaWYgYGEgPiBiYC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNvbXBhcmVWZXJzaW9ucyhhOiBzdHJpbmcsIGI6IHN0cmluZyk6IG51bWJlciB7XG4gIGNvbnN0IGFTZWdtZW50cyA9IHBhcnNlVmVyc2lvblNlZ21lbnRzKGEpO1xuICBjb25zdCBiU2VnbWVudHMgPSBwYXJzZVZlcnNpb25TZWdtZW50cyhiKTtcblxuICBmb3IgKGxldCBpID0gMDsgaSA8IFZFUlNJT05fU0VHTUVOVF9DT1VOVDsgaSsrKSB7XG4gICAgY29uc3QgZGlmZiA9IChhU2VnbWVudHNbaV0gPz8gMCkgLSAoYlNlZ21lbnRzW2ldID8/IDApO1xuICAgIGlmIChkaWZmICE9PSAwKSB7XG4gICAgICByZXR1cm4gZGlmZjtcbiAgICB9XG4gIH1cblxuICByZXR1cm4gMDtcbn1cblxuLyoqXG4gKiBSZXR1cm5zIHRoZSB1c2VyLWRhdGEgYXNhciBmaWxlIG5hbWUgZm9yIGEgZ2l2ZW4gdmVyc2lvbiwgbWF0Y2hpbmcgdGhlIG5hbWVcbiAqIE9ic2lkaWFuIGl0c2VsZiB1c2VzIHdoZW4gaXQgZG93bmxvYWRzIGFuIHVwZGF0ZSAoYG9ic2lkaWFuLTx2ZXJzaW9uPi5hc2FyYCkuXG4gKlxuICogQHBhcmFtIHZlcnNpb24gLSBBIGNvbmNyZXRlIGB4LnkuemAgdmVyc2lvbi5cbiAqIEByZXR1cm5zIFRoZSBhc2FyIGZpbGUgbmFtZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFZlcnNpb25Bc2FyRmlsZU5hbWUodmVyc2lvbjogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIGBvYnNpZGlhbi0ke3ZlcnNpb259LmFzYXJgO1xufVxuXG4vKipcbiAqIFBhcnNlcyBhIHZlcnNpb24gc3BlY2lmaWVyIGludG8gZWl0aGVyIGFuIGV4cGxpY2l0IHZlcnNpb24gb3IgYSBjaGFubmVsIGFsaWFzLlxuICpcbiAqIEBwYXJhbSBzcGVjIC0gVGhlIHNwZWNpZmllcjogYW4gYHgueS56YCBzdHJpbmcsIHtAbGluayBQVUJMSUNfTEFURVNUfSwgb3Ige0BsaW5rIENBVEFMWVNUX0xBVEVTVH0uXG4gKiBAcmV0dXJucyBUaGUgcGFyc2VkIHtAbGluayBWZXJzaW9uU3BlY30uXG4gKiBAdGhyb3dzIEVycm9yIGlmIHRoZSBzcGVjaWZpZXIgaXMgbmVpdGhlciBhIHZhbGlkIGB4LnkuemAgdmVyc2lvbiBub3IgYSBrbm93biBhbGlhcy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlVmVyc2lvblNwZWMoc3BlYzogc3RyaW5nKTogVmVyc2lvblNwZWMge1xuICBpZiAoc3BlYyA9PT0gUFVCTElDX0xBVEVTVCkge1xuICAgIHJldHVybiB7IGNoYW5uZWw6ICdwdWJsaWMnLCBraW5kOiAnY2hhbm5lbCcgfTtcbiAgfVxuXG4gIGlmIChzcGVjID09PSBDQVRBTFlTVF9MQVRFU1QpIHtcbiAgICByZXR1cm4geyBjaGFubmVsOiAnY2F0YWx5c3QnLCBraW5kOiAnY2hhbm5lbCcgfTtcbiAgfVxuXG4gIGlmIChFWFBMSUNJVF9WRVJTSU9OX1BBVFRFUk4udGVzdChzcGVjKSkge1xuICAgIHJldHVybiB7IGtpbmQ6ICdleHBsaWNpdCcsIHZlcnNpb246IHNwZWMgfTtcbiAgfVxuXG4gIHRocm93IG5ldyBFcnJvcihcbiAgICBgSW52YWxpZCBPYnNpZGlhbiB2ZXJzaW9uIFwiJHtzcGVjfVwiLiBFeHBlY3RlZCBhbiBcIngueS56XCIgdmVyc2lvbiwgXCIke1BVQkxJQ19MQVRFU1R9XCIsIG9yIFwiJHtDQVRBTFlTVF9MQVRFU1R9XCIuYFxuICApO1xufVxuXG4vKipcbiAqIFJlc29sdmVzIGEgY2hhbm5lbCB0byBhIGNvbmNyZXRlIHZlcnNpb24gdXNpbmcgYSBkZXNrdG9wIHJlbGVhc2VzIG1hbmlmZXN0LlxuICpcbiAqIEBwYXJhbSBtYW5pZmVzdCAtIFRoZSBwYXJzZWQgbWFuaWZlc3QuXG4gKiBAcGFyYW0gY2hhbm5lbCAtIFRoZSBjaGFubmVsIHRvIHJlc29sdmUuXG4gKiBAcmV0dXJucyBUaGUgY29uY3JldGUgYHgueS56YCB2ZXJzaW9uIGZvciB0aGUgY2hhbm5lbC5cbiAqIEB0aHJvd3MgRXJyb3IgaWYgdGhlIGNhdGFseXN0IGNoYW5uZWwgaXMgcmVxdWVzdGVkIGJ1dCB0aGUgbWFuaWZlc3QgaGFzIG5vIGBiZXRhYCBlbnRyeS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlc29sdmVWZXJzaW9uRnJvbU1hbmlmZXN0KG1hbmlmZXN0OiBEZXNrdG9wUmVsZWFzZXNNYW5pZmVzdCwgY2hhbm5lbDogUmVsZWFzZUNoYW5uZWwpOiBzdHJpbmcge1xuICBpZiAoY2hhbm5lbCA9PT0gJ3B1YmxpYycpIHtcbiAgICByZXR1cm4gbWFuaWZlc3QubGF0ZXN0VmVyc2lvbjtcbiAgfVxuXG4gIGlmICghbWFuaWZlc3QuYmV0YSkge1xuICAgIHRocm93IG5ldyBFcnJvcignRGVza3RvcCByZWxlYXNlcyBtYW5pZmVzdCBoYXMgbm8gY2F0YWx5c3QgKGJldGEpIHJlbGVhc2UuJyk7XG4gIH1cblxuICByZXR1cm4gbWFuaWZlc3QuYmV0YS5sYXRlc3RWZXJzaW9uO1xufVxuXG4vKipcbiAqIFNwbGl0cyBhbiBgeC55LnpgIHZlcnNpb24gaW50byBpdHMgbnVtZXJpYyBzZWdtZW50cy5cbiAqXG4gKiBAcGFyYW0gdmVyc2lvbiAtIFRoZSB2ZXJzaW9uIHN0cmluZy5cbiAqIEByZXR1cm5zIFRoZSBudW1lcmljIHNlZ21lbnRzLlxuICovXG5mdW5jdGlvbiBwYXJzZVZlcnNpb25TZWdtZW50cyh2ZXJzaW9uOiBzdHJpbmcpOiBudW1iZXJbXSB7XG4gIHJldHVybiB2ZXJzaW9uLnNwbGl0KCcuJykubWFwKChzZWdtZW50KSA9PiBOdW1iZXIucGFyc2VJbnQoc2VnbWVudCwgMTApKTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICJBQWlCTyxNQUFNLGdCQUFnQjtBQU10QixNQUFNLGtCQUFrQjtBQUt4QixNQUFNLGdDQUFnQztBQUU3QyxNQUFNLDJCQUEyQjtBQUNqQyxNQUFNLHdCQUF3QjtBQXNFdkIsU0FBUyxnQkFBZ0IsR0FBVyxHQUFtQjtBQUM1RCxRQUFNLFlBQVkscUJBQXFCLENBQUM7QUFDeEMsUUFBTSxZQUFZLHFCQUFxQixDQUFDO0FBRXhDLFdBQVMsSUFBSSxHQUFHLElBQUksdUJBQXVCLEtBQUs7QUFDOUMsVUFBTSxRQUFRLFVBQVUsQ0FBQyxLQUFLLE1BQU0sVUFBVSxDQUFDLEtBQUs7QUFDcEQsUUFBSSxTQUFTLEdBQUc7QUFDZCxhQUFPO0FBQUEsSUFDVDtBQUFBLEVBQ0Y7QUFFQSxTQUFPO0FBQ1Q7QUFTTyxTQUFTLHVCQUF1QixTQUF5QjtBQUM5RCxTQUFPLFlBQVksT0FBTztBQUM1QjtBQVNPLFNBQVMsaUJBQWlCLE1BQTJCO0FBQzFELE1BQUksU0FBUyxlQUFlO0FBQzFCLFdBQU8sRUFBRSxTQUFTLFVBQVUsTUFBTSxVQUFVO0FBQUEsRUFDOUM7QUFFQSxNQUFJLFNBQVMsaUJBQWlCO0FBQzVCLFdBQU8sRUFBRSxTQUFTLFlBQVksTUFBTSxVQUFVO0FBQUEsRUFDaEQ7QUFFQSxNQUFJLHlCQUF5QixLQUFLLElBQUksR0FBRztBQUN2QyxXQUFPLEVBQUUsTUFBTSxZQUFZLFNBQVMsS0FBSztBQUFBLEVBQzNDO0FBRUEsUUFBTSxJQUFJO0FBQUEsSUFDUiw2QkFBNkIsSUFBSSxvQ0FBb0MsYUFBYSxVQUFVLGVBQWU7QUFBQSxFQUM3RztBQUNGO0FBVU8sU0FBUywyQkFBMkIsVUFBbUMsU0FBaUM7QUFDN0csTUFBSSxZQUFZLFVBQVU7QUFDeEIsV0FBTyxTQUFTO0FBQUEsRUFDbEI7QUFFQSxNQUFJLENBQUMsU0FBUyxNQUFNO0FBQ2xCLFVBQU0sSUFBSSxNQUFNLDJEQUEyRDtBQUFBLEVBQzdFO0FBRUEsU0FBTyxTQUFTLEtBQUs7QUFDdkI7QUFRQSxTQUFTLHFCQUFxQixTQUEyQjtBQUN2RCxTQUFPLFFBQVEsTUFBTSxHQUFHLEVBQUUsSUFBSSxDQUFDLFlBQVksT0FBTyxTQUFTLFNBQVMsRUFBRSxDQUFDO0FBQ3pFOyIsCiAgIm5hbWVzIjogW10KfQo=

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;
 }