firefox-location2 2.0.4 → 2.1.1

package/README.md

@@ -169,6 +169,7 @@ Note: On Linux, the module first tries to resolve binaries on <code>$PATH</code>
 
 ```js
 import firefoxLocation from 'firefox-location2'
+import {getFirefoxVersion} from 'firefox-location2'
 
 // Strict (Stable only)
 console.log(firefoxLocation())
@@ -183,6 +184,14 @@ import {locateFirefoxOrExplain, getInstallGuidance} from 'firefox-location2'
 try {
   const path = locateFirefoxOrExplain({allowFallback: true})
   console.log(path)
+
+  // Cross-platform version (no exec by default)
+  const v = getFirefoxVersion(path)
+  console.log(v) // e.g. "130.0.1" or null
+
+  // Opt-in: allow executing the binary to fetch version on platforms without metadata (e.g. Linux)
+  const v2 = getFirefoxVersion(path, {allowExec: true})
+  console.log(v2)
 } catch (e) {
   console.error(String(e))
   // Or print getInstallGuidance() explicitly
@@ -244,6 +253,22 @@ Notes:
 - Output is colorized when printed to a TTY (green success, red error)
 - After you run `npx @puppeteer/browsers install firefox@stable` once, we auto-detect Firefox from Puppeteer's cache on all platforms. No env vars needed.
 
+## API
+
+- `default export locateFirefox(allowFallback?: boolean): string | null`
+  - Returns the first existing path among the selected channels or `null`.
+  - When `allowFallback` is `true`, checks Stable → ESR → Developer → Nightly.
+
+- `locateFirefoxOrExplain(options?: boolean | { allowFallback?: boolean }): string`
+  - Returns a path if found, otherwise throws an `Error` with a friendly installation guide.
+  - Path resolution never executes the browser.
+
+- `getFirefoxVersion(bin: string, opts?: { allowExec?: boolean }): string | null`
+  - Cross-platform version resolver that does not execute the browser by default.
+  - Windows: reads PE file metadata via PowerShell (no GUI spawn).
+  - macOS: reads `Info.plist` (no GUI spawn).
+  - Linux/other: returns `null` unless `allowExec` is `true`, then tries `--version`.
+
 ## Planned enhancements
 
 - Flatpak detection on Linux: detect installed Flatpak app <code>org.mozilla.firefox</code> and expose the appropriate invocation.

package/bin.js

@@ -3,23 +3,39 @@
 import locateFirefox, {
   locateFirefoxOrExplain,
   getInstallGuidance,
+  getFirefoxVersion,
 } from './dist/index.js';
 
 const argv = process.argv.slice(2);
 const allowFallback = argv.includes('--fallback') || argv.includes('-f');
+const printBrowserVersion =
+  argv.includes('--firefox-version') || argv.includes('--browser-version');
+const allowExec = argv.includes('--allow-exec');
 
 try {
-  const result =
-    typeof locateFirefoxOrExplain === 'function'
-      ? locateFirefoxOrExplain({ allowFallback })
-      : locateFirefox(allowFallback);
+  const location =
+    (typeof locateFirefoxOrExplain === 'function' &&
+      locateFirefoxOrExplain({ allowFallback })) ||
+    (typeof locateFirefox === 'function' && locateFirefox(allowFallback)) ||
+    null;
 
-  if (!result)
+  if (!location)
     throw new Error(
       (typeof getInstallGuidance === 'function' && getInstallGuidance()) ||
         'No suitable Firefox binary found.',
     );
-  console.log(String(result));
+
+  if (printBrowserVersion && typeof getFirefoxVersion === 'function') {
+    const v = getFirefoxVersion(location, { allowExec });
+    if (!v) {
+      console.log('');
+      process.exit(2);
+    }
+    console.log(String(v));
+    process.exit(0);
+  }
+
+  console.log(String(location));
 } catch (e) {
   console.error(String(e));
   process.exit(1);

package/dist/index.cjs

@@ -33,8 +33,9 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    getInstallGuidance: ()=>getInstallGuidance,
     default: ()=>locateFirefox,
+    getFirefoxVersion: ()=>getFirefoxVersion,
+    getInstallGuidance: ()=>getInstallGuidance,
     locateFirefoxOrExplain: ()=>locateFirefoxOrExplain
 });
 const external_fs_namespaceObject = require("fs");
@@ -276,6 +277,82 @@ function locateFirefoxOrExplain(options) {
     if ('string' == typeof found && found) return found;
     throw new Error(getInstallGuidance());
 }
+function getFirefoxVersion(bin, opts) {
+    if ('win32' === process.platform) {
+        try {
+            const psPath = bin.replace(/'/g, "''");
+            const pv = (0, external_child_process_namespaceObject.execFileSync)('powershell.exe', [
+                '-NoProfile',
+                '-Command',
+                `(Get-Item -LiteralPath '${psPath}').VersionInfo.ProductVersion`
+            ], {
+                encoding: 'utf8',
+                stdio: [
+                    'ignore',
+                    'pipe',
+                    'ignore'
+                ]
+            }).trim();
+            return normalizeVersion(pv);
+        } catch  {}
+        if (null == opts ? void 0 : opts.allowExec) {
+            const v = tryExec(bin, [
+                '--version'
+            ]);
+            return normalizeVersion(v);
+        }
+        return null;
+    }
+    if ('darwin' === process.platform) {
+        try {
+            const contentsDir = external_path_default().dirname(external_path_default().dirname(bin));
+            const infoPlist = external_path_default().join(contentsDir, 'Info.plist');
+            if (external_fs_default().existsSync(infoPlist)) {
+                const xml = external_fs_default().readFileSync(infoPlist, 'utf8');
+                const v = parsePlistString(xml, 'CFBundleShortVersionString') || parsePlistString(xml, 'CFBundleVersion') || '';
+                return normalizeVersion(v);
+            }
+        } catch  {}
+        if (null == opts ? void 0 : opts.allowExec) {
+            const v = tryExec(bin, [
+                '--version'
+            ]);
+            return normalizeVersion(v);
+        }
+        return null;
+    }
+    if (null == opts ? void 0 : opts.allowExec) {
+        const v = tryExec(bin, [
+            '--version'
+        ]);
+        return normalizeVersion(v);
+    }
+    return null;
+}
+function normalizeVersion(s) {
+    if (!s) return null;
+    const m = String(s).match(/(\d+(?:\.\d+){1,3})/);
+    return m ? m[1] : null;
+}
+function parsePlistString(xml, key) {
+    const re = new RegExp(`<key>${key}<\\/key>\\s*<string>([^<]+)<\\/string>`);
+    const m = xml.match(re);
+    return m ? m[1].trim() : null;
+}
+function tryExec(bin, args) {
+    try {
+        return (0, external_child_process_namespaceObject.execFileSync)(bin, args, {
+            encoding: 'utf8',
+            stdio: [
+                'ignore',
+                'pipe',
+                'ignore'
+            ]
+        }).trim();
+    } catch  {
+        return null;
+    }
+}
 function resolveFromPuppeteerBrowsersCLI() {
     try {
         const attempts = [
@@ -331,10 +408,12 @@ function resolveFromPuppeteerBrowsersCLI() {
     return null;
 }
 exports["default"] = __webpack_exports__["default"];
+exports.getFirefoxVersion = __webpack_exports__.getFirefoxVersion;
 exports.getInstallGuidance = __webpack_exports__.getInstallGuidance;
 exports.locateFirefoxOrExplain = __webpack_exports__.locateFirefoxOrExplain;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "default",
+    "getFirefoxVersion",
     "getInstallGuidance",
     "locateFirefoxOrExplain"
 ].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];

package/dist/index.d.ts

@@ -21,3 +21,13 @@ export declare function getInstallGuidance(): string;
 export declare function locateFirefoxOrExplain(options?: boolean | {
     allowFallback?: boolean;
 }): string;
+/**
+ * Cross-platform Firefox version resolver.
+ * - Never executes the browser by default.
+ * - On Windows: reads PE metadata via PowerShell.
+ * - On macOS: reads Info.plist next to the binary.
+ * - On Linux/others: returns null unless opts.allowExec is true, then tries --version.
+ */
+export declare function getFirefoxVersion(bin: string, opts?: {
+    allowExec?: boolean;
+}): string | null;

package/dist/index.js

@@ -231,6 +231,82 @@ function locateFirefoxOrExplain(options) {
     if ('string' == typeof found && found) return found;
     throw new Error(getInstallGuidance());
 }
+function getFirefoxVersion(bin, opts) {
+    if ('win32' === process.platform) {
+        try {
+            const psPath = bin.replace(/'/g, "''");
+            const pv = (0, __WEBPACK_EXTERNAL_MODULE_child_process__.execFileSync)('powershell.exe', [
+                '-NoProfile',
+                '-Command',
+                `(Get-Item -LiteralPath '${psPath}').VersionInfo.ProductVersion`
+            ], {
+                encoding: 'utf8',
+                stdio: [
+                    'ignore',
+                    'pipe',
+                    'ignore'
+                ]
+            }).trim();
+            return normalizeVersion(pv);
+        } catch  {}
+        if (null == opts ? void 0 : opts.allowExec) {
+            const v = tryExec(bin, [
+                '--version'
+            ]);
+            return normalizeVersion(v);
+        }
+        return null;
+    }
+    if ('darwin' === process.platform) {
+        try {
+            const contentsDir = __WEBPACK_EXTERNAL_MODULE_path__["default"].dirname(__WEBPACK_EXTERNAL_MODULE_path__["default"].dirname(bin));
+            const infoPlist = __WEBPACK_EXTERNAL_MODULE_path__["default"].join(contentsDir, 'Info.plist');
+            if (__WEBPACK_EXTERNAL_MODULE_fs__["default"].existsSync(infoPlist)) {
+                const xml = __WEBPACK_EXTERNAL_MODULE_fs__["default"].readFileSync(infoPlist, 'utf8');
+                const v = parsePlistString(xml, 'CFBundleShortVersionString') || parsePlistString(xml, 'CFBundleVersion') || '';
+                return normalizeVersion(v);
+            }
+        } catch  {}
+        if (null == opts ? void 0 : opts.allowExec) {
+            const v = tryExec(bin, [
+                '--version'
+            ]);
+            return normalizeVersion(v);
+        }
+        return null;
+    }
+    if (null == opts ? void 0 : opts.allowExec) {
+        const v = tryExec(bin, [
+            '--version'
+        ]);
+        return normalizeVersion(v);
+    }
+    return null;
+}
+function normalizeVersion(s) {
+    if (!s) return null;
+    const m = String(s).match(/(\d+(?:\.\d+){1,3})/);
+    return m ? m[1] : null;
+}
+function parsePlistString(xml, key) {
+    const re = new RegExp(`<key>${key}<\\/key>\\s*<string>([^<]+)<\\/string>`);
+    const m = xml.match(re);
+    return m ? m[1].trim() : null;
+}
+function tryExec(bin, args) {
+    try {
+        return (0, __WEBPACK_EXTERNAL_MODULE_child_process__.execFileSync)(bin, args, {
+            encoding: 'utf8',
+            stdio: [
+                'ignore',
+                'pipe',
+                'ignore'
+            ]
+        }).trim();
+    } catch  {
+        return null;
+    }
+}
 function resolveFromPuppeteerBrowsersCLI() {
     try {
         const attempts = [
@@ -285,4 +361,4 @@ function resolveFromPuppeteerBrowsersCLI() {
     } catch  {}
     return null;
 }
-export { locateFirefox as default, getInstallGuidance, locateFirefoxOrExplain };
+export { locateFirefox as default, getFirefoxVersion, getInstallGuidance, locateFirefoxOrExplain };

package/package.json

@@ -5,7 +5,7 @@
     "url": "https://github.com/cezaraugusto/firefox-location2.git"
   },
   "name": "firefox-location2",
-  "version": "2.0.4",
+  "version": "2.1.1",
   "description": "Approximates the current location of the Firefox browser across platforms.",
   "homepage": "https://www.npmjs.com/package/firefox-location2",
   "type": "module",
@@ -29,14 +29,15 @@
     "check": "pnpm dlx @biomejs/biome@1.9.4 check --write",
     "dev": "rslib build --watch",
     "format": "pnpm dlx @biomejs/biome@1.9.4 format --write",
+    "pretest": "npm run build",
     "test": "vitest run --pool vmForks --poolOptions.vmForks.singleFork",
     "prepublishOnly": "npm run build",
     "publish:provenance": "np patch --no-tests --any-branch --yolo --message 'release: %s' --provenance"
   },
   "engines": {
-    "node": ">=18 <23"
+    "node": ">=16"
   },
-  "engineStrict": true,
+  "engineStrict": false,
   "publishConfig": {
     "provenance": true
   },