obsidian-integration-testing 8.0.1 → 8.1.1

package/dist/lib/cjs/obsidian-metadata.d.cts

@@ -0,0 +1,56 @@
+/**
+ * @file
+ *
+ * Typed access to the repo-root `metadata.json` — the per-Obsidian-app-version
+ * data table precomputed in this repo (installer-floor / recommended-installer /
+ * recommended-Electron thresholds; see the `metadata.json` section in
+ * `CLAUDE.md`). This is the single module that reads the raw table; everything
+ * else consumes it through {@link getVersionMetadata} against the
+ * {@link ObsidianVersionMetadata} shape, so the raw table stays internal and the
+ * public surface is a typed lookup.
+ *
+ * The table is injected at build time by esbuild's `define` (and at test time by
+ * Vitest's `define`) — the `OBSIDIAN_METADATA` global is replaced with the parsed
+ * contents of `metadata.json`. This mirrors how `OBSIDIAN_INTEGRATION_TESTING_VERSION`
+ * is injected, and keeps the built library self-contained (the table is inlined
+ * into the output, with no runtime file read and no `bundle`-time JSON import that
+ * `bundle: false` cannot inline).
+ */
+/**
+ * The subset of a `metadata.json` per-version entry this library reads.
+ *
+ * Every field is optional — an entry carries only the thresholds that apply to
+ * that version (e.g. only old versions carry {@link minRecommendedInstallerVersion}).
+ */
+export interface ObsidianVersionMetadata {
+    /** Whether the version's assets are available (present only when `false`). */
+    readonly available?: boolean;
+    /** URL of the version's changelog. */
+    readonly changelogUrl?: string;
+    /** The release channel: `'public'`, `'catalyst'`, or `'public+catalyst'`. */
+    readonly channel?: string;
+    /**
+     * The app's hardcoded required-minimum Electron version (e.g. `'28.2.3'`). An
+     * Electron version, not an installer version — comparing against it needs the
+     * installer's bundled Electron, which is not derivable offline.
+     */
+    readonly minRecommendedElectronVersion?: string;
+    /**
+     * The recommended-minimum installer version (Obsidian's own "installer too old,
+     * reinstall" guidance). Present only on older versions.
+     */
+    readonly minRecommendedInstallerVersion?: string;
+    /**
+     * The empirically-measured run floor: the oldest installer version whose
+     * Electron shell can actually boot this app version's asar. Below it the
+     * renderer dead-boots.
+     */
+    readonly minRunnableInstallerVersion?: string;
+}
+/**
+ * Looks up the metadata entry for a concrete Obsidian app version.
+ *
+ * @param version - A concrete `x.y.z` app version.
+ * @returns The entry, or `undefined` when the version is absent from the table.
+ */
+export declare function getVersionMetadata(version: string): ObsidianVersionMetadata | undefined;

package/dist/lib/cjs/renderer-boot-detection.cjs

@@ -0,0 +1,49 @@
+"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 renderer_boot_detection_exports = {};
+__export(renderer_boot_detection_exports, {
+  DEFAULT_DEAD_BOOT_GRACE_IN_MILLISECONDS: () => DEFAULT_DEAD_BOOT_GRACE_IN_MILLISECONDS,
+  checkRendererBootState: () => checkRendererBootState,
+  resolveDeadBootGraceInMilliseconds: () => resolveDeadBootGraceInMilliseconds
+});
+module.exports = __toCommonJS(renderer_boot_detection_exports);
+const DEFAULT_DEAD_BOOT_GRACE_IN_MILLISECONDS = 1e4;
+function checkRendererBootState(params) {
+  const { bodyChildElementCount, hasGraceElapsed, hasWindowApp, isDocumentComplete } = params;
+  if (hasWindowApp) {
+    return "pending";
+  }
+  if (!hasGraceElapsed) {
+    return "pending";
+  }
+  if (isDocumentComplete && bodyChildElementCount === 0) {
+    return "dead";
+  }
+  return "pending";
+}
+function resolveDeadBootGraceInMilliseconds(options) {
+  return options?.deadBootGraceInMilliseconds ?? DEFAULT_DEAD_BOOT_GRACE_IN_MILLISECONDS;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_DEAD_BOOT_GRACE_IN_MILLISECONDS,
+  checkRendererBootState,
+  resolveDeadBootGraceInMilliseconds
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3JlbmRlcmVyLWJvb3QtZGV0ZWN0aW9uLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogUHVyZSBkZXRlY3Rpb24gb2YgYSB0ZXJtaW5hbCBcImRlYWQgYm9vdFwiIG9mIHRoZSBvd25lZCBPYnNpZGlhbiByZW5kZXJlciwgcGx1c1xuICogcmVzb2x2aW5nIHRoZSBmYXN0LWZhaWwgZ3JhY2Ugd2luZG93IGZyb20gdGhlIHRyYW5zcG9ydCBvcHRpb25zLiBLZXB0IHNlcGFyYXRlXG4gKiBmcm9tIHRoZSBpbnRlZ3JhdGlvbi1vbmx5IGB0cmFuc3BvcnQtZGVza3RvcC1jZHBgICh3aGljaCBkcml2ZXMgcmVhbCBDRFAgYW5kIGlzXG4gKiBleGNsdWRlZCBmcm9tIHVuaXQgdGVzdHMpIHNvIHRoZSB2ZXJkaWN0IGxvZ2ljIGFuZCBkZWZhdWx0IHJlc29sdXRpb24gc3RheVxuICogdW5pdC10ZXN0YWJsZS5cbiAqXG4gKiBXaGVuIGFuIE9ic2lkaWFuIGFzYXIgY2Fubm90IHJ1biBvbiB0aGUgbGF1bmNoZWQgRWxlY3Ryb24gc2hlbGwgKHRoZSBpbnN0YWxsZXJcbiAqIHZlcnNpb24gaXMgdG9vIG9sZCBmb3IgdGhhdCBhcHAgdmVyc2lvbiksIHRoZSByZW5kZXJlciBsb2FkcyBgaW5kZXguaHRtbGBcbiAqIChgZG9jdW1lbnQucmVhZHlTdGF0ZWAgcmVhY2hlcyBgJ2NvbXBsZXRlJ2ApIGJ1dCB0aGUgYXBwIG5ldmVyIGJvb3RzdHJhcHM6XG4gKiBgZG9jdW1lbnQuYm9keWAgc3RheXMgZW1wdHkgYW5kIGB3aW5kb3cuYXBwYCByZW1haW5zIGB1bmRlZmluZWRgIFx1MjAxNCB2aXN1YWxseSBhXG4gKiBibGFjayBzY3JlZW4uIFRoZSBvd25lZC12YXVsdCByZWFkaW5lc3MgcG9sbCBjYW5ub3QgdGVsbCB0aGlzIHRlcm1pbmFsIHN0YXRlXG4gKiBhcGFydCBmcm9tIFwic3RpbGwgbG9hZGluZ1wiLCBzbyB3aXRob3V0IGEgZGV0ZWN0b3IgaXQgd2FpdHMgb3V0IHRoZSB3aG9sZVxuICogcmVhZGluZXNzIHRpbWVvdXQgYmVmb3JlIGZhaWxpbmcuIFRoaXMgbW9kdWxlIGVuY29kZXMgdGhlIHNpZ25hbCB0aGF0XG4gKiBkaXN0aW5ndWlzaGVzIHRoZSB0d286IG9uY2UgdGhlIHJlbmRlcmVyIGhhcyBiZWVuIGBjb21wbGV0ZWAgZm9yIGEgc2hvcnQgZ3JhY2VcbiAqIHdpbmRvdyB3aXRoIG5vIGB3aW5kb3cuYXBwYCBhbmQgYW4gZW1wdHkgYDxib2R5PmAsIGl0IGlzIGRlYWQsIG5vdCBzbG93LlxuICovXG5cbmltcG9ydCB0eXBlIHsgT2JzaWRpYW5DZHBUcmFuc3BvcnRPcHRpb25zIH0gZnJvbSAnLi90cmFuc3BvcnQtb3B0aW9ucy5janMnO1xuXG4vKipcbiAqIERlZmF1bHQgZm9yIHtAbGluayBPYnNpZGlhbkNkcFRyYW5zcG9ydE9wdGlvbnMuZGVhZEJvb3RHcmFjZUluTWlsbGlzZWNvbmRzfS5cbiAqL1xuZXhwb3J0IGNvbnN0IERFRkFVTFRfREVBRF9CT09UX0dSQUNFX0lOX01JTExJU0VDT05EUyA9IDEwMDAwO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayBjaGVja1JlbmRlcmVyQm9vdFN0YXRlfS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDaGVja1JlbmRlcmVyQm9vdFN0YXRlUGFyYW1zIGV4dGVuZHMgUmVuZGVyZXJCb290T2JzZXJ2YXRpb24ge1xuICAvKipcbiAgICogV2hldGhlciB0aGUgYm9vdHN0cmFwIGdyYWNlIHdpbmRvdyBoYXMgZWxhcHNlZCBzaW5jZSB0aGUgcmVuZGVyZXIgZmlyc3RcbiAgICogcmVhY2hlZCBgZG9jdW1lbnQucmVhZHlTdGF0ZWAgYCdjb21wbGV0ZSdgLiBUaGUgYCdkZWFkJ2AgdmVyZGljdCBpcyB3aXRoaGVsZFxuICAgKiB1bnRpbCB0aGlzIGlzIGB0cnVlYCBzbyBhIGdlbnVpbmVseSBzbG93IGJvb3QgaXMgbmV2ZXIgbWlzanVkZ2VkLlxuICAgKi9cbiAgcmVhZG9ubHkgaGFzR3JhY2VFbGFwc2VkOiBib29sZWFuO1xufVxuXG4vKipcbiAqIEEgc2FtcGxlIG9mIHRoZSBvd25lZCByZW5kZXJlcidzIGJvb3RzdHJhcCBzdGF0ZSwgdGFrZW4gZnJvbSB0aGUgdmF1bHQgcGFnZVxuICogdGFyZ2V0IHZpYSBhIHNpbmdsZSBDRFAgZXZhbHVhdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZW5kZXJlckJvb3RPYnNlcnZhdGlvbiB7XG4gIC8qKlxuICAgKiBgZG9jdW1lbnQuYm9keS5jaGlsZEVsZW1lbnRDb3VudGAgaW4gdGhlIHZhdWx0IHJlbmRlcmVyIChgMGAgd2hlbiBgYm9keWAgaXNcbiAgICogYWJzZW50KS4gQSBkZWFkIGJvb3QgbGVhdmVzIHRoZSBib2R5IGVtcHR5OyBhIHNsb3ctYnV0LXZhbGlkIGJvb3QgcmVuZGVycyBhdFxuICAgKiBsZWFzdCBhIGxvYWRpbmcgc2hlbGwuXG4gICAqL1xuICByZWFkb25seSBib2R5Q2hpbGRFbGVtZW50Q291bnQ6IG51bWJlcjtcblxuICAvKiogV2hldGhlciBgd2luZG93LmFwcGAgaXMgZGVmaW5lZCBpbiB0aGUgdmF1bHQgcmVuZGVyZXIuICovXG4gIHJlYWRvbmx5IGhhc1dpbmRvd0FwcDogYm9vbGVhbjtcblxuICAvKiogV2hldGhlciB0aGUgdmF1bHQgcmVuZGVyZXIncyBgZG9jdW1lbnQucmVhZHlTdGF0ZWAgaXMgYCdjb21wbGV0ZSdgLiAqL1xuICByZWFkb25seSBpc0RvY3VtZW50Q29tcGxldGU6IGJvb2xlYW47XG59XG5cbi8qKlxuICogVmVyZGljdCBmcm9tIHtAbGluayBjaGVja1JlbmRlcmVyQm9vdFN0YXRlfTogYCdkZWFkJ2Agd2hlbiB0aGUgcmVuZGVyZXIgaGFzXG4gKiB0ZXJtaW5hbGx5IGZhaWxlZCB0byBpbml0aWFsaXplLCBgJ3BlbmRpbmcnYCB3aGVuIGl0IG1heSBzdGlsbCBiZSBib290aW5nLlxuICovXG5leHBvcnQgdHlwZSBSZW5kZXJlckJvb3RWZXJkaWN0ID0gJ2RlYWQnIHwgJ3BlbmRpbmcnO1xuXG4vKipcbiAqIERlY2lkZXMgd2hldGhlciB0aGUgb3duZWQgcmVuZGVyZXIgaGFzIHRlcm1pbmFsbHkgZmFpbGVkIHRvIGluaXRpYWxpemUuXG4gKlxuICogVGhlIHZlcmRpY3QgaXMgYCdkZWFkJ2Agb25seSB3aGVuIGFsbCBvZiB0aGUgZm9sbG93aW5nIGhvbGQ6IHRoZSBncmFjZSB3aW5kb3dcbiAqIGhhcyBlbGFwc2VkLCBgd2luZG93LmFwcGAgaXMgc3RpbGwgdW5kZWZpbmVkLCB0aGUgZG9jdW1lbnQgaXMgYCdjb21wbGV0ZSdgLFxuICogYW5kIGA8Ym9keT5gIGlzIGVtcHR5LiBUaGlzIGlzIGV4YWN0bHkgdGhlIG9ic2VydmVkIGluY29tcGF0aWJsZS1zaGVsbCBzdGF0ZVxuICogKGFuIGFzYXIgdGhhdCBjYW5ub3QgcnVuIG9uIHRoZSBsYXVuY2hlZCBFbGVjdHJvbiksIGFuZCBpdCBjYW5ub3QgYmUgcmVhY2hlZFxuICogYnkgYSBoZWFsdGh5IGJvb3QgXHUyMDE0IGB3aW5kb3cuYXBwYCBpcyBkZWZpbmVkIGVhcmx5LCBhbmQgYSBzbG93IGJvb3QgcmVuZGVycyBhXG4gKiBub24tZW1wdHkgbG9hZGluZyBzaGVsbCBcdTIwMTQgc28gdGhlcmUgaXMgbm8gZmFsc2UtcG9zaXRpdmUgcGF0aCBvbiBhIHZhbGlkIGJvb3QuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBzYW1wbGVkIG9ic2VydmF0aW9uIHBsdXMgd2hldGhlciB0aGUgZ3JhY2UgaGFzIGVsYXBzZWQuXG4gKiBAcmV0dXJucyBgJ2RlYWQnYCB3aGVuIHRoZSByZW5kZXJlciBpcyB0ZXJtaW5hbGx5IGRlYWQsIG90aGVyd2lzZSBgJ3BlbmRpbmcnYC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNoZWNrUmVuZGVyZXJCb290U3RhdGUocGFyYW1zOiBDaGVja1JlbmRlcmVyQm9vdFN0YXRlUGFyYW1zKTogUmVuZGVyZXJCb290VmVyZGljdCB7XG4gIGNvbnN0IHsgYm9keUNoaWxkRWxlbWVudENvdW50LCBoYXNHcmFjZUVsYXBzZWQsIGhhc1dpbmRvd0FwcCwgaXNEb2N1bWVudENvbXBsZXRlIH0gPSBwYXJhbXM7XG5cbiAgaWYgKGhhc1dpbmRvd0FwcCkge1xuICAgIHJldHVybiAncGVuZGluZyc7XG4gIH1cblxuICBpZiAoIWhhc0dyYWNlRWxhcHNlZCkge1xuICAgIHJldHVybiAncGVuZGluZyc7XG4gIH1cblxuICBpZiAoaXNEb2N1bWVudENvbXBsZXRlICYmIGJvZHlDaGlsZEVsZW1lbnRDb3VudCA9PT0gMCkge1xuICAgIHJldHVybiAnZGVhZCc7XG4gIH1cblxuICByZXR1cm4gJ3BlbmRpbmcnO1xufVxuXG4vKipcbiAqIFJlc29sdmVzIHRoZSBkZWFkLWJvb3QgZmFzdC1mYWlsIGdyYWNlIHdpbmRvdywgYXBwbHlpbmcgdGhlIGRlZmF1bHQgd2hlbiB0aGVcbiAqIG9wdGlvbiBpcyBvbWl0dGVkLlxuICpcbiAqIFRoaXMgYm91bmRzIGhvdyBsb25nIHRoZSBvd25lZC12YXVsdCByZWFkaW5lc3MgcG9sbCB3YWl0cyBcdTIwMTQgYWZ0ZXIgdGhlIHJlbmRlcmVyXG4gKiBmaXJzdCByZWFjaGVzIGBkb2N1bWVudC5yZWFkeVN0YXRlYCBgJ2NvbXBsZXRlJ2AgXHUyMDE0IGJlZm9yZSBjb25jbHVkaW5nIHRoZSBib290XG4gKiBpcyBkZWFkIChzZWUge0BsaW5rIGNoZWNrUmVuZGVyZXJCb290U3RhdGV9KS4gQSB2YWx1ZSBvZiBgMGAgZGlzYWJsZXMgZmFzdC1mYWlsXG4gKiBlbnRpcmVseSwgcmVzdG9yaW5nIHRoZSBwbGFpbiB3YWl0LW91dC10aGUtcmVhZGluZXNzLXRpbWVvdXQgYmVoYXZpb3IuXG4gKlxuICogQHBhcmFtIG9wdGlvbnMgLSBUaGUgZGVza3RvcCBDRFAgdHJhbnNwb3J0IG9wdGlvbnMgKG9yIHRoZSByZWxldmFudCBzbGljZSkuXG4gKiBAcmV0dXJucyBUaGUgZ3JhY2Ugd2luZG93IGluIG1pbGxpc2Vjb25kcy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlc29sdmVEZWFkQm9vdEdyYWNlSW5NaWxsaXNlY29uZHMoXG4gIG9wdGlvbnM/OiBQaWNrPE9ic2lkaWFuQ2RwVHJhbnNwb3J0T3B0aW9ucywgJ2RlYWRCb290R3JhY2VJbk1pbGxpc2Vjb25kcyc+XG4pOiBudW1iZXIge1xuICByZXR1cm4gb3B0aW9ucz8uZGVhZEJvb3RHcmFjZUluTWlsbGlzZWNvbmRzID8/IERFRkFVTFRfREVBRF9CT09UX0dSQUNFX0lOX01JTExJU0VDT05EUztcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBeUJPLE1BQU0sMENBQTBDO0FBb0RoRCxTQUFTLHVCQUF1QixRQUEyRDtBQUNoRyxRQUFNLEVBQUUsdUJBQXVCLGlCQUFpQixjQUFjLG1CQUFtQixJQUFJO0FBRXJGLE1BQUksY0FBYztBQUNoQixXQUFPO0FBQUEsRUFDVDtBQUVBLE1BQUksQ0FBQyxpQkFBaUI7QUFDcEIsV0FBTztBQUFBLEVBQ1Q7QUFFQSxNQUFJLHNCQUFzQiwwQkFBMEIsR0FBRztBQUNyRCxXQUFPO0FBQUEsRUFDVDtBQUVBLFNBQU87QUFDVDtBQWNPLFNBQVMsbUNBQ2QsU0FDUTtBQUNSLFNBQU8sU0FBUywrQkFBK0I7QUFDakQ7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/renderer-boot-detection.d.cts

@@ -0,0 +1,83 @@
+/**
+ * @file
+ *
+ * Pure detection of a terminal "dead boot" of the owned Obsidian renderer, plus
+ * resolving the fast-fail grace window from the transport options. Kept separate
+ * from the integration-only `transport-desktop-cdp` (which drives real CDP and is
+ * excluded from unit tests) so the verdict logic and default resolution stay
+ * unit-testable.
+ *
+ * When an Obsidian asar cannot run on the launched Electron shell (the installer
+ * version is too old for that app version), the renderer loads `index.html`
+ * (`document.readyState` reaches `'complete'`) but the app never bootstraps:
+ * `document.body` stays empty and `window.app` remains `undefined` — visually a
+ * black screen. The owned-vault readiness poll cannot tell this terminal state
+ * apart from "still loading", so without a detector it waits out the whole
+ * readiness timeout before failing. This module encodes the signal that
+ * distinguishes the two: once the renderer has been `complete` for a short grace
+ * window with no `window.app` and an empty `<body>`, it is dead, not slow.
+ */
+import type { ObsidianCdpTransportOptions } from './transport-options.cjs';
+/**
+ * Default for {@link ObsidianCdpTransportOptions.deadBootGraceInMilliseconds}.
+ */
+export declare const DEFAULT_DEAD_BOOT_GRACE_IN_MILLISECONDS = 10000;
+/**
+ * Parameters for {@link checkRendererBootState}.
+ */
+export interface CheckRendererBootStateParams extends RendererBootObservation {
+    /**
+     * Whether the bootstrap grace window has elapsed since the renderer first
+     * reached `document.readyState` `'complete'`. The `'dead'` verdict is withheld
+     * until this is `true` so a genuinely slow boot is never misjudged.
+     */
+    readonly hasGraceElapsed: boolean;
+}
+/**
+ * A sample of the owned renderer's bootstrap state, taken from the vault page
+ * target via a single CDP evaluation.
+ */
+export interface RendererBootObservation {
+    /**
+     * `document.body.childElementCount` in the vault renderer (`0` when `body` is
+     * absent). A dead boot leaves the body empty; a slow-but-valid boot renders at
+     * least a loading shell.
+     */
+    readonly bodyChildElementCount: number;
+    /** Whether `window.app` is defined in the vault renderer. */
+    readonly hasWindowApp: boolean;
+    /** Whether the vault renderer's `document.readyState` is `'complete'`. */
+    readonly isDocumentComplete: boolean;
+}
+/**
+ * Verdict from {@link checkRendererBootState}: `'dead'` when the renderer has
+ * terminally failed to initialize, `'pending'` when it may still be booting.
+ */
+export type RendererBootVerdict = 'dead' | 'pending';
+/**
+ * Decides whether the owned renderer has terminally failed to initialize.
+ *
+ * The verdict is `'dead'` only when all of the following hold: the grace window
+ * has elapsed, `window.app` is still undefined, the document is `'complete'`,
+ * and `<body>` is empty. This is exactly the observed incompatible-shell state
+ * (an asar that cannot run on the launched Electron), and it cannot be reached
+ * by a healthy boot — `window.app` is defined early, and a slow boot renders a
+ * non-empty loading shell — so there is no false-positive path on a valid boot.
+ *
+ * @param params - The sampled observation plus whether the grace has elapsed.
+ * @returns `'dead'` when the renderer is terminally dead, otherwise `'pending'`.
+ */
+export declare function checkRendererBootState(params: CheckRendererBootStateParams): RendererBootVerdict;
+/**
+ * Resolves the dead-boot fast-fail grace window, applying the default when the
+ * option is omitted.
+ *
+ * This bounds how long the owned-vault readiness poll waits — after the renderer
+ * first reaches `document.readyState` `'complete'` — before concluding the boot
+ * is dead (see {@link checkRendererBootState}). A value of `0` disables fast-fail
+ * entirely, restoring the plain wait-out-the-readiness-timeout behavior.
+ *
+ * @param options - The desktop CDP transport options (or the relevant slice).
+ * @returns The grace window in milliseconds.
+ */
+export declare function resolveDeadBootGraceInMilliseconds(options?: Pick<ObsidianCdpTransportOptions, 'deadBootGraceInMilliseconds'>): number;

package/dist/lib/cjs/renderer-failed-to-initialize-error.cjs

@@ -0,0 +1,41 @@
+"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 renderer_failed_to_initialize_error_exports = {};
+__export(renderer_failed_to_initialize_error_exports, {
+  RendererFailedToInitializeError: () => RendererFailedToInitializeError
+});
+module.exports = __toCommonJS(renderer_failed_to_initialize_error_exports);
+class RendererFailedToInitializeError extends Error {
+  /**
+   * Creates the error for a specific vault.
+   *
+   * @param vaultPath - The vault whose owned renderer failed to initialize.
+   */
+  constructor(vaultPath) {
+    super(
+      `The Obsidian renderer for vault ${vaultPath} did not initialize on this Electron shell. The installer/Electron version is likely too old for this Obsidian app version. Pin a newer obsidianInstallerVersion, or align obsidianVersion with the installed shell.`
+    );
+    this.name = "RendererFailedToInitializeError";
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RendererFailedToInitializeError
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3JlbmRlcmVyLWZhaWxlZC10by1pbml0aWFsaXplLWVycm9yLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogVGhlIGRpc3RpbmN0IGVycm9yIHRocm93biB3aGVuIHRoZSBvd25lZCBPYnNpZGlhbiByZW5kZXJlciB0ZXJtaW5hbGx5IGZhaWxzIHRvXG4gKiBpbml0aWFsaXplIFx1MjAxNCB0aGUgYXNhciBjb3VsZCBub3QgcnVuIG9uIHRoZSBsYXVuY2hlZCBFbGVjdHJvbiBzaGVsbCAodGhlXG4gKiBpbnN0YWxsZXIvRWxlY3Ryb24gdmVyc2lvbiBpcyB0b28gb2xkIGZvciB0aGUgT2JzaWRpYW4gYXBwIHZlcnNpb24pLiBJdCBpc1xuICogZXhwb3J0ZWQgc28gY2FsbGVycyBvZiBgY29ubmVjdFRvQ2RwYCAvIHRoZSB0cmFuc3BvcnQgY2FuIGBpbnN0YW5jZW9mYC1tYXRjaFxuICogdGhpcyBzcGVjaWZpYyBmYWlsdXJlIGFuZCBkaXN0aW5ndWlzaCBpdCBmcm9tIGEgZ2VuZXJpYyByZWFkaW5lc3MgdGltZW91dC5cbiAqL1xuXG4vKipcbiAqIFRocm93biB3aGVuIHRoZSBvd25lZCBPYnNpZGlhbiByZW5kZXJlciBsb2FkcyBidXQgbmV2ZXIgYm9vdHN0cmFwcyB0aGUgYXBwIFx1MjAxNFxuICogYW4gZW1wdHkgYDxib2R5PmAgd2l0aCBubyBgd2luZG93LmFwcGAgYWZ0ZXIgdGhlIGJvb3QgZ3JhY2Ugd2luZG93IChzZWVcbiAqIGBjaGVja1JlbmRlcmVyQm9vdFN0YXRlYCkuIFRoZSB1c3VhbCBjYXVzZSBpcyBhbiBpbnN0YWxsZXIvRWxlY3Ryb24gc2hlbGwgdG9vXG4gKiBvbGQgZm9yIHRoZSBwaW5uZWQgT2JzaWRpYW4gYXBwIHZlcnNpb24uXG4gKi9cbmV4cG9ydCBjbGFzcyBSZW5kZXJlckZhaWxlZFRvSW5pdGlhbGl6ZUVycm9yIGV4dGVuZHMgRXJyb3Ige1xuICAvKipcbiAgICogQ3JlYXRlcyB0aGUgZXJyb3IgZm9yIGEgc3BlY2lmaWMgdmF1bHQuXG4gICAqXG4gICAqIEBwYXJhbSB2YXVsdFBhdGggLSBUaGUgdmF1bHQgd2hvc2Ugb3duZWQgcmVuZGVyZXIgZmFpbGVkIHRvIGluaXRpYWxpemUuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IodmF1bHRQYXRoOiBzdHJpbmcpIHtcbiAgICBzdXBlcihcbiAgICAgIGBUaGUgT2JzaWRpYW4gcmVuZGVyZXIgZm9yIHZhdWx0ICR7dmF1bHRQYXRofSBkaWQgbm90IGluaXRpYWxpemUgb24gdGhpcyBFbGVjdHJvbiBzaGVsbC4gYFxuICAgICAgICArICdUaGUgaW5zdGFsbGVyL0VsZWN0cm9uIHZlcnNpb24gaXMgbGlrZWx5IHRvbyBvbGQgZm9yIHRoaXMgT2JzaWRpYW4gYXBwIHZlcnNpb24uICdcbiAgICAgICAgKyAnUGluIGEgbmV3ZXIgb2JzaWRpYW5JbnN0YWxsZXJWZXJzaW9uLCBvciBhbGlnbiBvYnNpZGlhblZlcnNpb24gd2l0aCB0aGUgaW5zdGFsbGVkIHNoZWxsLidcbiAgICApO1xuICAgIHRoaXMubmFtZSA9ICdSZW5kZXJlckZhaWxlZFRvSW5pdGlhbGl6ZUVycm9yJztcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQWdCTyxNQUFNLHdDQUF3QyxNQUFNO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBTWxELFlBQVksV0FBbUI7QUFDcEM7QUFBQSxNQUNFLG1DQUFtQyxTQUFTO0FBQUEsSUFHOUM7QUFDQSxTQUFLLE9BQU87QUFBQSxFQUNkO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/renderer-failed-to-initialize-error.d.cts

@@ -0,0 +1,23 @@
+/**
+ * @file
+ *
+ * The distinct error thrown when the owned Obsidian renderer terminally fails to
+ * initialize — the asar could not run on the launched Electron shell (the
+ * installer/Electron version is too old for the Obsidian app version). It is
+ * exported so callers of `connectToCdp` / the transport can `instanceof`-match
+ * this specific failure and distinguish it from a generic readiness timeout.
+ */
+/**
+ * Thrown when the owned Obsidian renderer loads but never bootstraps the app —
+ * an empty `<body>` with no `window.app` after the boot grace window (see
+ * `checkRendererBootState`). The usual cause is an installer/Electron shell too
+ * old for the pinned Obsidian app version.
+ */
+export declare class RendererFailedToInitializeError extends Error {
+    /**
+     * Creates the error for a specific vault.
+     *
+     * @param vaultPath - The vault whose owned renderer failed to initialize.
+     */
+    constructor(vaultPath: string);
+}