wsl-utils 0.2.0 → 0.3.0

package/index.d.ts

@@ -15,6 +15,43 @@ Returns WSL path if in WSL, otherwise returns Windows path.
 */
 export function powerShellPath(): Promise<string>;
 
+/**
+Check if PowerShell is accessible in the current environment.
+
+This is useful to determine whether Windows integration features can be used. In sandboxed WSL environments or systems where PowerShell is not accessible, this will return `false`.
+
+@returns A promise that resolves to `true` if PowerShell is accessible, `false` otherwise.
+
+@example
+```
+import {canAccessPowerShell} from 'wsl-utils';
+
+if (await canAccessPowerShell()) {
+	// Use Windows integration features
+	console.log('PowerShell is accessible');
+} else {
+	// Fall back to Linux-native behavior
+	console.log('PowerShell is not accessible');
+}
+```
+*/
+export function canAccessPowerShell(): Promise<boolean>;
+
+/**
+Get the default browser in WSL.
+
+@returns A promise that resolves to the [ProgID](https://setuserfta.com/guide-to-understanding-progids-and-file-type-associations/) of the default browser (e.g., `'ChromeHTML'`, `'FirefoxURL'`).
+
+@example
+```
+import {wslDefaultBrowser} from 'wsl-utils';
+
+const progId = await wslDefaultBrowser();
+//=> 'ChromeHTML'
+```
+*/
+export function wslDefaultBrowser(): Promise<string>;
+
 /**
 Get the mount point for fixed drives in WSL.
 */

package/index.js

@@ -1,8 +1,8 @@
-import process from 'node:process';
 import {promisify} from 'node:util';
 import childProcess from 'node:child_process';
 import fs, {constants as fsConstants} from 'node:fs/promises';
 import isWsl from 'is-wsl';
+import {powerShellPath as windowsPowerShellPath, executePowerShell} from 'powershell-utils';
 
 const execFile = promisify(childProcess.execFile);
 
@@ -50,12 +50,33 @@ export const powerShellPathFromWsl = async () => {
 	return `${mountPoint}c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe`;
 };
 
-export const powerShellPath = async () => {
-	if (isWsl) {
-		return powerShellPathFromWsl();
-	}
+export const powerShellPath = isWsl ? powerShellPathFromWsl : windowsPowerShellPath;
+
+// Cache for PowerShell accessibility check
+let canAccessPowerShellPromise;
+
+export const canAccessPowerShell = async () => {
+	canAccessPowerShellPromise ??= (async () => {
+		try {
+			const psPath = await powerShellPath();
+			await fs.access(psPath, fsConstants.X_OK);
+			return true;
+		} catch {
+			// PowerShell is not accessible (either doesn't exist, no execute permission, or other error)
+			return false;
+		}
+	})();
+
+	return canAccessPowerShellPromise;
+};
+
+export const wslDefaultBrowser = async () => {
+	const psPath = await powerShellPath();
+	const command = String.raw`(Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\http\UserChoice").ProgId`;
+
+	const {stdout} = await executePowerShell(command, {powerShellPath: psPath});
 
-	return `${process.env.SYSTEMROOT || process.env.windir || String.raw`C:\Windows`}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
+	return stdout.trim();
 };
 
 export const convertWslPathToWindows = async path => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "wsl-utils",
-	"version": "0.2.0",
+	"version": "0.3.0",
 	"description": "Utilities for working with Windows Subsystem for Linux (WSL)",
 	"license": "MIT",
 	"repository": "sindresorhus/wsl-utils",
@@ -17,7 +17,7 @@
 	},
 	"sideEffects": false,
 	"engines": {
-		"node": ">=18"
+		"node": ">=20"
 	},
 	"scripts": {
 		"test": "xo && ava && tsc index.d.ts --skipLibCheck"
@@ -36,11 +36,12 @@
 		"utilities"
 	],
 	"dependencies": {
-		"is-wsl": "^3.1.0"
+		"is-wsl": "^3.1.0",
+		"powershell-utils": "^0.1.0"
 	},
 	"devDependencies": {
-		"ava": "^6.3.0",
-		"typescript": "^5.8.3",
-		"xo": "^1.0.0"
+		"ava": "^6.4.1",
+		"typescript": "^5.9.3",
+		"xo": "^1.2.3"
 	}
 }

package/readme.md

@@ -43,6 +43,41 @@ Get the PowerShell executable path for the current environment.
 
 Returns WSL path if in WSL, otherwise returns Windows path.
 
+### canAccessPowerShell()
+
+Returns: `Promise<boolean>`
+
+Check if PowerShell is accessible in the current environment.
+
+This is useful to determine whether Windows integration features can be used. In sandboxed WSL environments or systems where PowerShell is not accessible, this will return `false`.
+
+```js
+import {canAccessPowerShell} from 'wsl-utils';
+
+if (await canAccessPowerShell()) {
+	// Use Windows integration features
+	console.log('PowerShell is accessible');
+} else {
+	// Fall back to Linux-native behavior
+	console.log('PowerShell is not accessible');
+}
+```
+
+### wslDefaultBrowser()
+
+Returns: `Promise<string>`
+
+Get the default browser in WSL.
+
+Returns a promise that resolves to the [ProgID](https://setuserfta.com/guide-to-understanding-progids-and-file-type-associations/) of the default browser (e.g., `'ChromeHTML'`, `'FirefoxURL'`).
+
+```js
+import {wslDefaultBrowser} from 'wsl-utils';
+
+const progId = await wslDefaultBrowser();
+//=> 'ChromeHTML'
+```
+
 ### wslDrivesMountPoint()
 
 Returns: `Promise<string>`