@covas-labs/electron-vr 0.8.0 → 0.8.2

package/dist/bridge.d.ts

@@ -30,6 +30,10 @@ export interface RuntimeInfo {
     openxrProtocolVersion: number;
     openxrSubmittedFrameSequence: number;
     openxrConsumedFrameSequence: number;
+    libovrHostDetected: boolean;
+    libovrHostProcessId: number;
+    libovrHostApplicationName: string;
+    libovrHostBinaryPath: string;
     openvrAvailable: boolean;
     openvrRuntimeInstalled: boolean;
     openvrRuntimePath: string;
@@ -103,6 +107,15 @@ export interface NativeImageLike {
 export interface AttachWindowOptions {
     frameRate?: number;
 }
+export interface NativeOpenXRApiLayerStatus {
+    installed: boolean;
+    enabled: boolean;
+    registered: boolean;
+    requiresUpdate: boolean;
+    manifestPath: string;
+    scope: string;
+}
+export declare function runNativeOpenXRApiLayerCommand(command: "status" | "install" | "enable" | "disable" | "uninstall", sourceDirectory: string): NativeOpenXRApiLayerStatus;
 export declare class VrBridge {
     private readonly addon;
     private attachedWindow;

package/dist/bridge.js

@@ -105,6 +105,21 @@ function loadVrBridgeAddon() {
         }
     }
 }
+export function runNativeOpenXRApiLayerCommand(command, sourceDirectory) {
+    const addon = loadVrBridgeAddon();
+    const method = command === "status"
+        ? addon.getOpenXRApiLayerStatus
+        : command === "install"
+            ? addon.installOpenXRApiLayer
+            : command === "enable"
+                ? addon.enableOpenXRApiLayer
+                : command === "disable"
+                    ? addon.disableOpenXRApiLayer
+                    : addon.uninstallOpenXRApiLayer;
+    if (!method)
+        throw new Error("The native OpenXR API-layer management API is unavailable.");
+    return method.call(addon, sourceDirectory);
+}
 function sanitizeRuntimeInfo(runtimeInfo) {
     return {
         ...runtimeInfo,
@@ -124,6 +139,10 @@ function sanitizeRuntimeInfo(runtimeInfo) {
         openxrProtocolVersion: runtimeInfo.openxrProtocolVersion ?? 0,
         openxrSubmittedFrameSequence: runtimeInfo.openxrSubmittedFrameSequence ?? 0,
         openxrConsumedFrameSequence: runtimeInfo.openxrConsumedFrameSequence ?? 0,
+        libovrHostDetected: runtimeInfo.libovrHostDetected ?? false,
+        libovrHostProcessId: runtimeInfo.libovrHostProcessId ?? 0,
+        libovrHostApplicationName: runtimeInfo.libovrHostApplicationName ?? "",
+        libovrHostBinaryPath: runtimeInfo.libovrHostBinaryPath ?? "",
         openvrSceneApplicationState: runtimeInfo.openvrSceneApplicationState ?? "",
         openvrSceneProcessId: runtimeInfo.openvrSceneProcessId ?? 0,
         openvrSceneApplicationKey: runtimeInfo.openvrSceneApplicationKey ?? "",

package/dist/compatibility.js

@@ -45,7 +45,19 @@ export function analyzeVRCompatibility(runtime, context = {}) {
     let compatibleHostGraphicsApis = [];
     let requiresApiLayer = false;
     let recommendedAction = "none";
-    if (runtime.selectedBackend === "openxr" && runtime.openxrMode === "overlay-session") {
+    const supportedHostDetected = runtime.openxrCompanionConnected || runtime.openxrHostDetected ||
+        runtime.openvrSceneProcessId !== 0;
+    const unsupportedLibOVRHost = runtime.libovrHostDetected && !supportedHostDetected &&
+        runtime.openxrMode !== "overlay-session";
+    if (unsupportedLibOVRHost) {
+        const applicationName = runtime.libovrHostApplicationName || "A VR application";
+        readiness = "unavailable";
+        backendLabel = "Unsupported native Oculus application";
+        summary = `${applicationName} is using native Oculus/LibOVR, which electron-vr cannot overlay.`;
+        recommendedAction = "use-supported-openxr-host";
+        issues.push(issue("libovr-host-unsupported", "error", "Native Oculus application detected", "Relaunch the application through OpenXR or a supported OpenVR runtime. Native LibOVR applications do not expose a cross-application overlay API.", "use-supported-openxr-host"));
+    }
+    else if (runtime.selectedBackend === "openxr" && runtime.openxrMode === "overlay-session") {
         readiness = "ready";
         backendLabel = "OpenXR direct overlay";
         summary = "The active OpenXR runtime supports a direct overlay session.";
@@ -134,7 +146,17 @@ export function analyzeVRCompatibility(runtime, context = {}) {
     const canRenderOverlay = readiness === "ready" || readiness === "waiting-for-host" ||
         (readiness === "fallback-only" && runtime.platform === "linux" && runtime.selectedBackend === "mock");
     let launch;
-    if (readiness === "ready" && (runtime.selectedBackend === "openxr" || runtime.selectedBackend === "openvr")) {
+    if (unsupportedLibOVRHost) {
+        launch = {
+            verdict: "incompatible",
+            wouldWorkNow: false,
+            canStartNow: false,
+            fundamentalIncompatibility: true,
+            message: "The running VR application uses native Oculus/LibOVR and cannot host an electron-vr overlay.",
+            requiredActions: ["use-supported-openxr-host"]
+        };
+    }
+    else if (readiness === "ready" && (runtime.selectedBackend === "openxr" || runtime.selectedBackend === "openvr")) {
         launch = {
             verdict: "works-now",
             wouldWorkNow: true,

package/dist/openxrApiLayer.js

@@ -3,6 +3,7 @@ import { createRequire } from "node:module";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { runNativeOpenXRApiLayerCommand } from "./bridge.js";
 const PREBUILT_PACKAGES = {
     linux: "@covas-labs/electron-vr-prebuilt-linux-x64",
     win32: "@covas-labs/electron-vr-prebuilt-win32-x64"
@@ -33,6 +34,24 @@ function resolvePrebuiltCli() {
     }
     return null;
 }
+function resolveWindowsLayerAssets() {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    const repositoryAssets = resolve(currentDir, "..", "..", "native-addon", "build", "Release");
+    if (existsSync(resolve(repositoryAssets, "electron_vr_openxr_layer.dll")))
+        return repositoryAssets;
+    const requires = [createRequire(import.meta.url), createRequire(resolve(process.cwd(), "package.json"))];
+    for (const require of requires) {
+        try {
+            const directory = dirname(require.resolve(PREBUILT_PACKAGES.win32));
+            if (existsSync(resolve(directory, "electron_vr_openxr_layer.dll")))
+                return directory;
+        }
+        catch {
+            // Try the next package resolution context.
+        }
+    }
+    throw new Error("The Windows OpenXR API-layer assets are unavailable.");
+}
 function resolveCli() {
     assertSupportedPlatform();
     const currentDir = dirname(fileURLToPath(import.meta.url));
@@ -91,9 +110,15 @@ export function parseOpenXRApiLayerStatus(output) {
     };
 }
 export async function getOpenXRApiLayerStatus() {
+    if (process.platform === "win32") {
+        return runNativeOpenXRApiLayerCommand("status", resolveWindowsLayerAssets());
+    }
     return parseOpenXRApiLayerStatus(await runCommand("status"));
 }
 async function runLifecycleCommand(command) {
+    if (process.platform === "win32") {
+        return runNativeOpenXRApiLayerCommand(command, resolveWindowsLayerAssets());
+    }
     await runCommand(command);
     return getOpenXRApiLayerStatus();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@covas-labs/electron-vr",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Electron VR overlay bridge with OpenXR, OpenVR, and mock fallback backends.",
   "repository": {
     "type": "git",
@@ -22,8 +22,8 @@
     "electron": ">=37"
   },
   "optionalDependencies": {
-    "@covas-labs/electron-vr-prebuilt-linux-x64": "0.8.0",
-    "@covas-labs/electron-vr-prebuilt-win32-x64": "0.8.0"
+    "@covas-labs/electron-vr-prebuilt-linux-x64": "0.8.2",
+    "@covas-labs/electron-vr-prebuilt-win32-x64": "0.8.2"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",