wsl-utils 0.1.0 → 0.2.0

package/index.d.ts

@@ -19,3 +19,26 @@ export function powerShellPath(): 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,7 +1,11 @@
 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';
 
+const execFile = promisify(childProcess.execFile);
+
 export const wslDrivesMountPoint = (() => {
 	// Default value for "root" param
 	// according to https://docs.microsoft.com/en-us/windows/wsl/wsl-config
@@ -54,4 +58,19 @@ export const powerShellPath = async () => {
 	return `${process.env.SYSTEMROOT || process.env.windir || String.raw`C:\Windows`}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
 };
 
+export const convertWslPathToWindows = async path => {
+	// Don't convert URLs
+	if (/^[a-z]+:\/\//i.test(path)) {
+		return path;
+	}
+
+	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.2.0",
 	"description": "Utilities for working with Windows Subsystem for Linux (WSL)",
 	"license": "MIT",
 	"repository": "sindresorhus/wsl-utils",

package/readme.md

@@ -48,3 +48,29 @@ Returns WSL path if in WSL, otherwise returns Windows path.
 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`).