@overwolf/ow-electron-packages-types 1.1.2-beta.4 → 1.1.2-beta.7

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@overwolf/ow-electron-packages-types",
-    "version": "1.1.2-beta.4",
+    "version": "1.1.2-beta.7",
     "description": "Type definition file for autocompletion and documentation purposes for ow-electron packages",
     "license": "MIT",
     "types": "types.d.ts",
@@ -37,4 +37,4 @@
     "dependencies": {
         "glob": "^13.0.0"
     }
-}
+}

package/types.d.ts

@@ -940,6 +940,38 @@ interface VideoInformation {
   readonly defaultEncoder: kSupportedEncodersTypes;
 }
 
+/**
+ * Information about the current Xbox Game DVR state on the system.
+ *
+ * Xbox Game DVR captures game video in the background and can interfere with
+ * recording. This interface reports whether it is active and the underlying
+ * registry values that drive it.
+ *
+ * @example
+ * const dvr: XboxDVRInfo = {
+ *   enabled: true,
+ *   appCaptureEnabled: true,
+ *   gameDVREnabled: false
+ * };
+ */
+interface XboxDVRInfo {
+  /**
+   * `true` if Xbox Game DVR is active via either capture path
+   * (`appCaptureEnabled || gameDVREnabled`).
+   */
+  readonly enabled: boolean;
+
+  /**
+   * The `AppCaptureEnabled` registry value.
+   */
+  readonly appCaptureEnabled: boolean;
+
+  /**
+   * The `GameDVR_Enabled` registry value.
+   */
+  readonly gameDVREnabled: boolean;
+}
+
 /**
  * Information about the complete recording configuration for the current system.
  *
@@ -975,6 +1007,13 @@ interface RecordingInformation {
    * @see MonitorInfo
    */
   monitors: MonitorInfo[];
+
+  /**
+   * The current Xbox Game DVR state on the system.
+   *
+   * @see XboxDVRInfo
+   */
+  xboxDVR: XboxDVRInfo;
 }
 
 
@@ -4340,10 +4379,15 @@ interface IOverwolfRecordingApi {
   readonly version: string;
 
   /**
-   * Path to ffmpeg file.
+   * Path to ffmpeg executable
    */
   readonly ffmpegPath: string;
 
+  /**
+   * Path to ffprobe executable
+   */
+  readonly ffprobePath: string;
+
   /**
    * Path to OBS binaries folder.
    */
@@ -4367,12 +4411,31 @@ interface IOverwolfRecordingApi {
   /**
    * Queries supported encoders, audio/video devices, and configuration options.
    *
+   * The result also includes the current Xbox Game DVR state (`xboxDVR`).
+   *
    * @param overrideCache If `true`, bypasses cached result and queries OBS directly.
    * @returns A promise that resolves to the full recording capability information.
    * @see {@link RecordingInformation}
    */
   queryInformation(overrideCache?: boolean): Promise<RecordingInformation>;
 
+  /**
+   * Returns whether Xbox Game DVR is enabled, checking both the
+   * `GameDVR_Enabled` and `AppCaptureEnabled` registry values.
+   *
+   * @returns A promise that resolves to the current Xbox Game DVR state.
+   * @see {@link XboxDVRInfo}
+   */
+  isXboxDVREnabled(): Promise<XboxDVRInfo>;
+
+  /**
+   * Disables Xbox Game DVR by setting `AppCaptureEnabled` and
+   * `GameDVR_Enabled` to `0` in the registry.
+   *
+   * @returns A promise that resolves once the values have been written.
+   */
+  disableXboxDVR(): Promise<void>;
+
   /**
    * Creates a capture settings builder instance to configure video/audio sources.
    *
@@ -5574,7 +5637,7 @@ interface IOverwolfOverlayApi extends EventEmitter {
    */
   exitExclusiveMode(): void;
 
-   /**
+  /**
    * Install ow-electron helpers to
    * `%CommonProgramFiles%\<app-name>\` with UAC elevation.
    * Allows injection into high elevation games.
@@ -5620,20 +5683,20 @@ interface IOverwolfOverlayApi extends EventEmitter {
    * }
    * ```
    * @returns Resolves when installation completes.
-   * 
-   * 
-   * 
+   *
+   *
+   *
    */
   installHighElevationHelper?(): Promise<void>;
 
   /**
    * Returns true if ow-electron helpers is already installed in
    * `%CommonProgramFiles%\<app-name>\`.
-   * 
+   *
    * @returns `true` if the helper is installed and ready.
-   * 
+   *
    * @example
-   * ```ts 
+   * ```ts
    * const installed: boolean = await api.isHighElevationHelperInstalled();
    * if (!installed) {
    *   // Prompt the user to run the one-time setup before injecting into elevated games
@@ -5649,17 +5712,24 @@ interface IOverwolfOverlayApi extends EventEmitter {
    * while a previous capture is still pending will reject immediately —
    * wait for the returned promise to settle before issuing the next call.
    *
-   * The file extension in `filePath` is normalized automatically: if it does
-   * not already end with `.jpg` or `.bmp` (matching `format`), the correct
-   * extension is appended.
+   * The output format is resolved by precedence: an explicit `format`
+   * argument wins; otherwise the extension already present in `filePath`
+   * (`.jpg`/`.jpeg` or `.bmp`) is used; otherwise it defaults to `'bmp'`.
+   * The file extension is then normalized to match the resolved format, so
+   * an existing extension is rewritten rather than doubled (e.g.
+   * `shot.jpg` stays `shot.jpg`, and `shot.png` with `format: 'jpg'` becomes
+   * `shot.jpg`).
    *
    * Internally all backends (D3D9, D3D11, D3D12, Vulkan) capture as BMP
    * first and transcode to JPEG on demand, ensuring correct colors across
    * all graphics APIs and formats.
    *
    * @param filePath - Absolute path (UTF-8) where the image will be saved.
-   * @param format - Output image format: `'jpg'` or `'bmp'`. Defaults to `'bmp'`.
-   * @returns A promise that resolves with `void` when the file is written.
+   * @param format - Output image format: `'jpg'` or `'bmp'`. When omitted,
+   *   the extension in `filePath` is used, falling back to `'bmp'`.
+   * @returns A promise that resolves with the absolute path the file was
+   *   actually written to, including the normalized extension (which may
+   *   differ from `filePath`).
    *
    * @throws `'no active game'` — the overlay is not currently injected into
    *   any game. Wait for the `game-injected` event before calling.
@@ -5681,8 +5751,8 @@ interface IOverwolfOverlayApi extends EventEmitter {
    *       const ts = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
    *       const filePath = path.join(app.getPath('pictures'), `screenshot_${ts}`);
    *       try {
-   *         await overlay.takeScreenshot(filePath, 'jpg');
-   *         // file written to filePath + '.jpg'
+   *         const savedPath = await overlay.takeScreenshot(filePath, 'jpg');
+   *         console.log('screenshot written to', savedPath); // ...filePath.jpg
    *       } catch (err) {
    *         console.error('Screenshot failed:', err.message);
    *       }
@@ -5706,7 +5776,10 @@ interface IOverwolfOverlayApi extends EventEmitter {
    * @param listener - Callback with game launch event and game metadata.
    * @see {@link GameInfo}.
    */
-  on(eventName: 'game-launched', listener: (event: GameLaunchEvent, gameInfo: GameInfo) => void): this;
+  on(
+    eventName: 'game-launched',
+    listener: (event: GameLaunchEvent, gameInfo: GameInfo) => void,
+  ): this;
 
   /**
    * Fires when a registered game process terminates.
@@ -5726,7 +5799,10 @@ interface IOverwolfOverlayApi extends EventEmitter {
    *
    * @see {@link GameInfo}.
    */
-  on(eventName: 'game-exit', listener: (gameInfo: GameInfo, wasInjected: boolean) => void): this;
+  on(
+    eventName: 'game-exit',
+    listener: (gameInfo: GameInfo, wasInjected: boolean) => void,
+  ): this;
 
   /**
    * Fires when the overlay is ready and successfully injected into the game.
@@ -5746,7 +5822,7 @@ interface IOverwolfOverlayApi extends EventEmitter {
    */
   on(
     eventName: 'game-injection-error',
-    listener: (gameInfo: GameInfo, error: string, ...args: any[]) => void
+    listener: (gameInfo: GameInfo, error: string, ...args: any[]) => void,
   ): this;
 
   /**
@@ -5762,8 +5838,8 @@ interface IOverwolfOverlayApi extends EventEmitter {
     listener: (
       window: GameWindowInfo,
       gameInfo: GameInfo,
-      focus: boolean
-    ) => void
+      focus: boolean,
+    ) => void,
   ): this;
 
   /**
@@ -5780,8 +5856,8 @@ interface IOverwolfOverlayApi extends EventEmitter {
     listener: (
       window: GameWindowInfo,
       gameInfo: GameInfo,
-      reason?: GameWindowUpdateReason
-    ) => void
+      reason?: GameWindowUpdateReason,
+    ) => void,
   ): this;
 
   /**
@@ -5794,7 +5870,7 @@ interface IOverwolfOverlayApi extends EventEmitter {
    */
   on(
     eventName: 'game-input-interception-changed',
-    listener: (info: GameInputInterception) => void
+    listener: (info: GameInputInterception) => void,
   ): this;
 
   /**
@@ -5806,7 +5882,7 @@ interface IOverwolfOverlayApi extends EventEmitter {
    */
   on(
     eventName: 'game-input-exclusive-mode-changed',
-    listener: (info: GameInputInterception) => void
+    listener: (info: GameInputInterception) => void,
   ): this;
 }