wsl-utils 0.1.0 → 0.3.0

package/index.d.ts

@@ -15,7 +15,67 @@ 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.
 */
 export function wslDrivesMountPoint(): Promise<string>;
+
+/**
+Convert a WSL Linux path to a Windows-accessible path.
+
+URLs (strings starting with a protocol like `https://`) are returned unchanged.
+
+@param path - The WSL path to convert (e.g., `/home/user/file.html`).
+@returns The Windows-accessible path (e.g., `\\wsl.localhost\Ubuntu\home\user\file.html`) or the original path if conversion fails.
+
+@example
+```
+import {convertWslPathToWindows} from 'wsl-utils';
+
+// Convert a Linux path
+const windowsPath = await convertWslPathToWindows('/home/user/file.html');
+//=> '\\wsl.localhost\Ubuntu\home\user\file.html'
+
+// URLs are not converted
+const url = await convertWslPathToWindows('https://example.com');
+//=> 'https://example.com'
+```
+*/
+export function convertWslPathToWindows(path: string): Promise<string>;

package/index.js

@@ -1,6 +1,10 @@
-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);
 
 export const wslDrivesMountPoint = (() => {
 	// Default value for "root" param
@@ -46,12 +50,48 @@ 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 stdout.trim();
+};
+
+export const convertWslPathToWindows = async path => {
+	// Don't convert URLs
+	if (/^[a-z]+:\/\//i.test(path)) {
+		return path;
 	}
 
-	return `${process.env.SYSTEMROOT || process.env.windir || String.raw`C:\Windows`}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
+	try {
+		const {stdout} = await execFile('wslpath', ['-aw', path], {encoding: 'utf8'});
+		return stdout.trim();
+	} catch {
+		// If wslpath fails, return the original path
+		return path;
+	}
 };
 
 export {default as isWsl} from 'is-wsl';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "wsl-utils",
-	"version": "0.1.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,8 +43,69 @@ 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>`
 
 Get the mount point for fixed drives in WSL.
+
+### convertWslPathToWindows(path)
+
+Returns: `Promise<string>`
+
+Convert a WSL Linux path to a Windows-accessible path.
+
+URLs (strings starting with a protocol like `https://`) are returned unchanged.
+
+```js
+import {convertWslPathToWindows} from 'wsl-utils';
+
+// Convert a Linux path
+const windowsPath = await convertWslPathToWindows('/home/user/file.html');
+//=> '\\wsl.localhost\Ubuntu\home\user\file.html'
+
+// URLs are not converted
+const url = await convertWslPathToWindows('https://example.com');
+//=> 'https://example.com'
+```
+
+#### path
+
+Type: `string`
+
+The WSL path to convert (e.g., `/home/user/file.html`).