@heybox/hb-sdk 0.9.1-alpha.8 → 0.9.1-alpha.9

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。
 
+## 0.9.1-alpha.9 - 2026-10-16
+
+### 新增能力
+
+- 反馈新建与追加回复支持上传本地图片和 GIF，图片和 GIF 合计最多 10 张，日志不占图片额度；普通图片单张 20 MiB、GIF 单张 10 MiB，暂不支持视频附件。
+- 新建和追加回复统一通过 `--log` 提供日志：支持本地 `.log`、ZIP 日志包，字符串自动包装成 `.log` 文件；单份上传最多 10 MiB，ZIP 内最多 50 份非空 UTF-8 `.log`，解压后合计最多 20 MiB，日志独立于图片额度，正文仅保留上传返回的日志下载链接。
+- 新建反馈强制校验至少 5 个字符的问题描述、问题项目的 SDK 版本、运行平台、非空日志和至少一张截图；追加回复的描述同步至少 5 个字符。
+- 移除重复的 `feedback submit` 子命令，统一使用 `hb-sdk feedback` 提交；工单列表保留分页以查看超过五条的历史记录。
+- 反馈命令仅直接提交工单，不再打开或输出反馈提交页面地址；缺少问题描述时提示补充。
+
+- 反馈提交与追加回复增加检查、上传和提交阶段提示，进度不混入 JSON 结果；附件按顺序串行上传，全部成功后才提交工单；结果不明确时提示在 App 核对，不自动重试，也不保存本地恢复缓存。
+
+### 问题修复
+
+- 修复反馈附件上传授权请求缺少表单类型，导致服务端无法读取上传范围并返回“参数错误:1000”的问题。
+- 反馈日志上传前校验 ZIP 目录、结束记录和 CRC，拒绝损坏或未写完的压缩包；修复普通日志末尾残缺 UTF-8 字符被漏检的问题。
+
+### 文档与工具
+
+- 移除开放平台与文档中的反馈页面直达入口，保留 App 帮助与反馈入口及 CLI 提交说明。
+
 ## 0.9.1-alpha.8 - 2026-10-16
 
 ### 问题修复

package/README.md

@@ -521,18 +521,18 @@ Controller 使用 `@heybox/hb-sdk/card-controller` 编写，普通页面使用
 小程序工坊开发者反馈统一进入现有私有客服工单。登录后只能查看自己的反馈，客服通过现有后台派单和回复。
 
 ```bash
-hb-sdk feedback                       # 打开现有反馈页面，预选开发者分类
-hb-sdk feedback --no-open              # 只输出地址
-hb-sdk feedback submit --desc "调用失败" --app-id app123 --api hb.network.request
-hb-sdk feedback submit --desc "调用失败" --screenshot https://cdn.example.com/error.png --json
+hb-sdk feedback --desc "调用接口时发生异常" --sdk-version 0.9.1-alpha.7 --platform ios --log ./error.log --screenshot ./error.png --app-id app123 --api hb.network.request
+hb-sdk feedback --desc "页面运行时出现崩溃" --sdk-version 0.9.1-alpha.7 --platform android --log ./error.log --screenshot ./error.png --json
 hb-sdk feedback list --json            # 先查看本人已有的小程序工坊工单
 hb-sdk feedback detail 9527 --json     # 查看内容和客服回复
-hb-sdk feedback reply 9527 --desc "补充复现步骤" --json
+hb-sdk feedback reply 9527 --desc "补充复现步骤" --screenshot ./error.png --log "Error: retry failed" --json
 ```
 
-问题描述必填；AppID、关联 API、SDK 版本、环境、复现步骤、日志及截图选填。使用 `--scene` 补充复现步骤，`--log-file` 读取日志文件。完整正文最多 5000 字符；截图参数接受已经上传的 HTTP(S) URL，可重复，最多 10 张。CLI 不会上传本地图片文件，网页图片上传复用现有反馈页。
+CLI 仅直接提交工单，不打开或输出反馈提交页面地址。新建反馈必须提供至少 5 个字符的问题描述、问题项目实际使用的 SDK 版本、问题发生的平台、非空报错日志和至少一张截图。使用 `--sdk-version` 填写有效版本号，不能用 CLI 自身版本代替；使用 `--platform` 指定 `ios`、`android`、`windows`、`macos`、`linux` 或 `web`，不会把执行 CLI 的电脑平台当作问题平台。日志统一通过 `--log` 提供，可传本地 `.log`、ZIP 日志包路径或日志文本，提交前请脱敏。缺少或填写无效时在登录、上传和提交前拒绝。AppID、关联 API、补充运行环境、复现步骤选填。追加回复只要求至少 5 个字符的补充描述，日志和附件可选，不重复要求原工单的 SDK 版本与平台。使用 `--scene` 补充复现步骤。`--log ./error.log` 上传非空 UTF-8 `.log` 文件；`--log "Error: request failed"` 将原始文本包装成 `feedback-text.log` 后上传。`--log ./logs.zip` 支持多个日志文件打包上传：只允许非空 UTF-8 `.log` 文件，最多 50 份，解压后合计不超过 20 MiB；不接受其他附件或嵌套压缩包。日志文件或压缩包单个不超过 10 MiB；日志全文不写入正文，正文只记录日志下载链接。完整正文最多 5000 字符；使用 `--screenshot` 传本地图片路径或已上传的 HTTP(S) 图片链接，可重复，图片和 GIF 合计最多 10 张，日志不占图片额度。普通图片单张不超过 20 MiB，GIF 单张不超过 10 MiB。暂不支持视频附件。图片沿用帮助与反馈的上传流程。
 
-提交时从现有分类接口查找“小程序工坊”分类（兼容原“小程序工坊开发者”和“小程序工坊开发者反馈”名称）及“开发中的常见问题”问题项，再调用 `/bbs/web/feedback/user/post`。分类未配置时拒绝提交；上线前需配置分类、问题项，并绑定客服组和派单优先级。提交结果包含原有工单 ID 和详情链接，不再创建独立 SDK 反馈记录。提交前会明确提示将创建私有反馈工单；使用提交时的同一小黑盒账号，在 App「设置 → 帮助与反馈 → 我的反馈」查看进展、客服回复或补充信息，也可打开返回的工单详情链接。`--json` 的成功结果包含 `message` 和 `follow_up` 说明，提交前提示输出到 stderr，不影响 stdout JSON 解析。
+提交时从现有分类接口查找“小程序工坊”分类（兼容原“小程序工坊开发者”和“小程序工坊开发者反馈”名称）及“开发中的常见问题”问题项，再调用 `/bbs/web/feedback/user/post`。分类未配置时拒绝提交；回复前先检查原工单属于本人小程序工坊且尚未关闭。所有本地附件先校验，再使用同一登录账号上传并提交，上传失败不会继续提交工单；附件不会单独作为上传命令对外提供。日志复用现有上传接口，正文使用接口返回的完整下载链接，不要求下载地址保留 `.log` 后缀。上线前需配置分类、问题项，并绑定客服组和派单优先级。提交结果包含原有工单 ID 和详情链接，不再创建独立 SDK 反馈记录。提交前会明确提示将创建私有反馈工单；使用提交时的同一小黑盒账号，在 App「设置 → 帮助与反馈 → 我的反馈」查看进展、客服回复或补充信息，也可打开返回的工单详情链接。`--json` 的成功结果包含 `message` 和 `follow_up` 说明，提交前提示输出到 stderr，不影响 stdout JSON 解析。
+
+反馈命令会显示检查文件、上传附件和提交工单的阶段提示，附件按顺序串行上传，全部上传成功后才提交工单；上传失败会提示具体文件和阶段，不继续提交。进度输出到 stderr，`--json` 的 stdout 只输出最终结果。不保存本地上传进度或提交缓存。提交超时、连接中断或响应不明确时，不自动查询或重试，请先到 App「帮助与反馈 → 我的反馈」核对结果，确认未成功后再重试。
 
 列表支持 `--offset` 和 `--limit`（最多 50 条），详情和回复只允许访问当前登录账号在小程序工坊分类 `71` 下的工单。回复复用原工单，不占新建额度；已解决或关闭的工单不能继续回复。新能力需要后端支持范围隔离；服务未更新时会明确报错，不回退为读取全部工单。
 

package/dist/cli-chunks/_commonjs-dynamic-modules-DUamuDzp.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+function commonjsRequire(path) {
+	throw new Error('Could not dynamically require "' + path + '". Please configure the dynamicRequireTargets or/and ignoreDynamicRequires option of @rollup/plugin-commonjs appropriately for this require call to work.');
+}
+
+exports.commonjsRequire = commonjsRequire;

package/dist/cli-chunks/browser-RAy8e8cV.cjs

@@ -0,0 +1,635 @@
+'use strict';
+
+var process = require('node:process');
+var node_buffer = require('node:buffer');
+var path = require('node:path');
+var node_url = require('node:url');
+var node_util = require('node:util');
+var childProcess = require('node:child_process');
+var fs$1 = require('node:fs/promises');
+var os = require('node:os');
+var fs = require('node:fs');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+let isDockerCached;
+
+function hasDockerEnv() {
+	try {
+		fs.statSync('/.dockerenv');
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+function hasDockerCGroup() {
+	try {
+		return fs.readFileSync('/proc/self/cgroup', 'utf8').includes('docker');
+	} catch {
+		return false;
+	}
+}
+
+function isDocker() {
+	// TODO: Use `??=` when targeting Node.js 16.
+	if (isDockerCached === undefined) {
+		isDockerCached = hasDockerEnv() || hasDockerCGroup();
+	}
+
+	return isDockerCached;
+}
+
+let cachedResult;
+
+// Podman detection
+const hasContainerEnv = () => {
+	try {
+		fs.statSync('/run/.containerenv');
+		return true;
+	} catch {
+		return false;
+	}
+};
+
+function isInsideContainer() {
+	// TODO: Use `??=` when targeting Node.js 16.
+	if (cachedResult === undefined) {
+		cachedResult = hasContainerEnv() || isDocker();
+	}
+
+	return cachedResult;
+}
+
+const isWsl = () => {
+	if (process.platform !== 'linux') {
+		return false;
+	}
+
+	if (os.release().toLowerCase().includes('microsoft')) {
+		if (isInsideContainer()) {
+			return false;
+		}
+
+		return true;
+	}
+
+	try {
+		if (fs.readFileSync('/proc/version', 'utf8').toLowerCase().includes('microsoft')) {
+			return !isInsideContainer();
+		}
+	} catch {}
+
+	// Fallback for custom kernels: check WSL-specific paths.
+	if (
+		fs.existsSync('/proc/sys/fs/binfmt_misc/WSLInterop')
+		|| fs.existsSync('/run/WSL')
+	) {
+		return !isInsideContainer();
+	}
+
+	return false;
+};
+
+var isWsl$1 = process.env.__IS_WSL_TEST__ ? isWsl : isWsl();
+
+const wslDrivesMountPoint = (() => {
+	// Default value for "root" param
+	// according to https://docs.microsoft.com/en-us/windows/wsl/wsl-config
+	const defaultMountPoint = '/mnt/';
+
+	let mountPoint;
+
+	return async function () {
+		if (mountPoint) {
+			// Return memoized mount point value
+			return mountPoint;
+		}
+
+		const configFilePath = '/etc/wsl.conf';
+
+		let isConfigFileExists = false;
+		try {
+			await fs$1.access(configFilePath, fs$1.constants.F_OK);
+			isConfigFileExists = true;
+		} catch {}
+
+		if (!isConfigFileExists) {
+			return defaultMountPoint;
+		}
+
+		const configContent = await fs$1.readFile(configFilePath, {encoding: 'utf8'});
+		const configMountPoint = /(?<!#.*)root\s*=\s*(?<mountPoint>.*)/g.exec(configContent);
+
+		if (!configMountPoint) {
+			return defaultMountPoint;
+		}
+
+		mountPoint = configMountPoint.groups.mountPoint.trim();
+		mountPoint = mountPoint.endsWith('/') ? mountPoint : `${mountPoint}/`;
+
+		return mountPoint;
+	};
+})();
+
+const powerShellPathFromWsl = async () => {
+	const mountPoint = await wslDrivesMountPoint();
+	return `${mountPoint}c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe`;
+};
+
+const powerShellPath = async () => {
+	if (isWsl$1) {
+		return powerShellPathFromWsl();
+	}
+
+	return `${process.env.SYSTEMROOT || process.env.windir || String.raw`C:\Windows`}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
+};
+
+function defineLazyProperty(object, propertyName, valueGetter) {
+	const define = value => Object.defineProperty(object, propertyName, {value, enumerable: true, writable: true});
+
+	Object.defineProperty(object, propertyName, {
+		configurable: true,
+		enumerable: true,
+		get() {
+			const result = valueGetter();
+			define(result);
+			return result;
+		},
+		set(value) {
+			define(value);
+		}
+	});
+
+	return object;
+}
+
+const execFileAsync$3 = node_util.promisify(childProcess.execFile);
+
+async function defaultBrowserId() {
+	if (process.platform !== 'darwin') {
+		throw new Error('macOS only');
+	}
+
+	const {stdout} = await execFileAsync$3('defaults', ['read', 'com.apple.LaunchServices/com.apple.launchservices.secure', 'LSHandlers']);
+
+	// `(?!-)` is to prevent matching `LSHandlerRoleAll = "-";`.
+	const match = /LSHandlerRoleAll = "(?!-)(?<id>[^"]+?)";\s+?LSHandlerURLScheme = (?:http|https);/.exec(stdout);
+
+	const browserId = match?.groups.id ?? 'com.apple.Safari';
+
+	// Correct the case for Safari's bundle identifier
+	if (browserId === 'com.apple.safari') {
+		return 'com.apple.Safari';
+	}
+
+	return browserId;
+}
+
+const execFileAsync$2 = node_util.promisify(childProcess.execFile);
+
+async function runAppleScript(script, {humanReadableOutput = true, signal} = {}) {
+	if (process.platform !== 'darwin') {
+		throw new Error('macOS only');
+	}
+
+	const outputArguments = humanReadableOutput ? [] : ['-ss'];
+
+	const execOptions = {};
+	if (signal) {
+		execOptions.signal = signal;
+	}
+
+	const {stdout} = await execFileAsync$2('osascript', ['-e', script, outputArguments], execOptions);
+	return stdout.trim();
+}
+
+async function bundleName(bundleId) {
+	return runAppleScript(`tell application "Finder" to set app_path to application file id "${bundleId}" as string\ntell application "System Events" to get value of property list item "CFBundleName" of property list file (app_path & ":Contents:Info.plist")`);
+}
+
+const execFileAsync$1 = node_util.promisify(childProcess.execFile);
+
+// TODO: Fix the casing of bundle identifiers in the next major version.
+
+// Windows doesn't have browser IDs in the same way macOS/Linux does so we give fake
+// ones that look real and match the macOS/Linux versions for cross-platform apps.
+const windowsBrowserProgIds = {
+	MSEdgeHTM: {name: 'Edge', id: 'com.microsoft.edge'}, // The missing `L` is correct.
+	MSEdgeBHTML: {name: 'Edge Beta', id: 'com.microsoft.edge.beta'},
+	MSEdgeDHTML: {name: 'Edge Dev', id: 'com.microsoft.edge.dev'},
+	AppXq0fevzme2pys62n3e0fbqa7peapykr8v: {name: 'Edge', id: 'com.microsoft.edge.old'},
+	ChromeHTML: {name: 'Chrome', id: 'com.google.chrome'},
+	ChromeBHTML: {name: 'Chrome Beta', id: 'com.google.chrome.beta'},
+	ChromeDHTML: {name: 'Chrome Dev', id: 'com.google.chrome.dev'},
+	ChromiumHTM: {name: 'Chromium', id: 'org.chromium.Chromium'},
+	BraveHTML: {name: 'Brave', id: 'com.brave.Browser'},
+	BraveBHTML: {name: 'Brave Beta', id: 'com.brave.Browser.beta'},
+	BraveDHTML: {name: 'Brave Dev', id: 'com.brave.Browser.dev'},
+	BraveSSHTM: {name: 'Brave Nightly', id: 'com.brave.Browser.nightly'},
+	FirefoxURL: {name: 'Firefox', id: 'org.mozilla.firefox'},
+	OperaStable: {name: 'Opera', id: 'com.operasoftware.Opera'},
+	VivaldiHTM: {name: 'Vivaldi', id: 'com.vivaldi.Vivaldi'},
+	'IE.HTTP': {name: 'Internet Explorer', id: 'com.microsoft.ie'},
+};
+
+new Map(Object.entries(windowsBrowserProgIds));
+
+class UnknownBrowserError extends Error {}
+
+async function defaultBrowser$1(_execFileAsync = execFileAsync$1) {
+	const {stdout} = await _execFileAsync('reg', [
+		'QUERY',
+		' HKEY_CURRENT_USER\\Software\\Microsoft\\Windows\\Shell\\Associations\\UrlAssociations\\http\\UserChoice',
+		'/v',
+		'ProgId',
+	]);
+
+	const match = /ProgId\s*REG_SZ\s*(?<id>\S+)/.exec(stdout);
+	if (!match) {
+		throw new UnknownBrowserError(`Cannot find Windows browser in stdout: ${JSON.stringify(stdout)}`);
+	}
+
+	const {id} = match.groups;
+
+	// Windows can append a hash suffix to ProgIds using a dot or hyphen
+	// (e.g., `ChromeHTML.ABC123`, `FirefoxURL-6F193CCC56814779`).
+	// Try exact match first, then try without the suffix.
+	const dotIndex = id.lastIndexOf('.');
+	const hyphenIndex = id.lastIndexOf('-');
+	const baseIdByDot = dotIndex === -1 ? undefined : id.slice(0, dotIndex);
+	const baseIdByHyphen = hyphenIndex === -1 ? undefined : id.slice(0, hyphenIndex);
+
+	return windowsBrowserProgIds[id] ?? windowsBrowserProgIds[baseIdByDot] ?? windowsBrowserProgIds[baseIdByHyphen] ?? {name: id, id};
+}
+
+const execFileAsync = node_util.promisify(childProcess.execFile);
+
+// Inlined: https://github.com/sindresorhus/titleize/blob/main/index.js
+const titleize = string => string.toLowerCase().replaceAll(/(?:^|\s|-)\S/g, x => x.toUpperCase());
+
+async function defaultBrowser() {
+	if (process.platform === 'darwin') {
+		const id = await defaultBrowserId();
+		const name = await bundleName(id);
+		return {name, id};
+	}
+
+	if (process.platform === 'linux') {
+		const {stdout} = await execFileAsync('xdg-mime', ['query', 'default', 'x-scheme-handler/http']);
+		const id = stdout.trim();
+		const name = titleize(id.replace(/.desktop$/, '').replace('-', ' '));
+		return {name, id};
+	}
+
+	if (process.platform === 'win32') {
+		return defaultBrowser$1();
+	}
+
+	throw new Error('Only macOS, Linux, and Windows are supported');
+}
+
+const execFile = node_util.promisify(childProcess.execFile);
+
+// Path to included `xdg-open`.
+const __dirname$1 = path.dirname(node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/browser-RAy8e8cV.cjs', document.baseURI).href))));
+const localXdgOpenPath = path.join(__dirname$1, 'xdg-open');
+
+const {platform, arch} = process;
+
+/**
+Get the default browser name in Windows from WSL.
+
+@returns {Promise<string>} Browser name.
+*/
+async function getWindowsDefaultBrowserFromWsl() {
+	const powershellPath = await powerShellPath();
+	const rawCommand = String.raw`(Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\http\UserChoice").ProgId`;
+	const encodedCommand = node_buffer.Buffer.from(rawCommand, 'utf16le').toString('base64');
+
+	const {stdout} = await execFile(
+		powershellPath,
+		[
+			'-NoProfile',
+			'-NonInteractive',
+			'-ExecutionPolicy',
+			'Bypass',
+			'-EncodedCommand',
+			encodedCommand,
+		],
+		{encoding: 'utf8'},
+	);
+
+	const progId = stdout.trim();
+
+	// Map ProgId to browser IDs
+	const browserMap = {
+		ChromeHTML: 'com.google.chrome',
+		BraveHTML: 'com.brave.Browser',
+		MSEdgeHTM: 'com.microsoft.edge',
+		FirefoxURL: 'org.mozilla.firefox',
+	};
+
+	return browserMap[progId] ? {id: browserMap[progId]} : {};
+}
+
+const pTryEach = async (array, mapper) => {
+	let latestError;
+
+	for (const item of array) {
+		try {
+			return await mapper(item); // eslint-disable-line no-await-in-loop
+		} catch (error) {
+			latestError = error;
+		}
+	}
+
+	throw latestError;
+};
+
+// eslint-disable-next-line complexity
+const baseOpen = async options => {
+	options = {
+		wait: false,
+		background: false,
+		newInstance: false,
+		allowNonzeroExitCode: false,
+		...options,
+	};
+
+	if (Array.isArray(options.app)) {
+		return pTryEach(options.app, singleApp => baseOpen({
+			...options,
+			app: singleApp,
+		}));
+	}
+
+	let {name: app, arguments: appArguments = []} = options.app ?? {};
+	appArguments = [...appArguments];
+
+	if (Array.isArray(app)) {
+		return pTryEach(app, appName => baseOpen({
+			...options,
+			app: {
+				name: appName,
+				arguments: appArguments,
+			},
+		}));
+	}
+
+	if (app === 'browser' || app === 'browserPrivate') {
+		// IDs from default-browser for macOS and windows are the same
+		const ids = {
+			'com.google.chrome': 'chrome',
+			'google-chrome.desktop': 'chrome',
+			'com.brave.Browser': 'brave',
+			'org.mozilla.firefox': 'firefox',
+			'firefox.desktop': 'firefox',
+			'com.microsoft.msedge': 'edge',
+			'com.microsoft.edge': 'edge',
+			'com.microsoft.edgemac': 'edge',
+			'microsoft-edge.desktop': 'edge',
+		};
+
+		// Incognito flags for each browser in `apps`.
+		const flags = {
+			chrome: '--incognito',
+			brave: '--incognito',
+			firefox: '--private-window',
+			edge: '--inPrivate',
+		};
+
+		const browser = isWsl$1 ? await getWindowsDefaultBrowserFromWsl() : await defaultBrowser();
+		if (browser.id in ids) {
+			const browserName = ids[browser.id];
+
+			if (app === 'browserPrivate') {
+				appArguments.push(flags[browserName]);
+			}
+
+			return baseOpen({
+				...options,
+				app: {
+					name: apps[browserName],
+					arguments: appArguments,
+				},
+			});
+		}
+
+		throw new Error(`${browser.name} is not supported as a default browser`);
+	}
+
+	let command;
+	const cliArguments = [];
+	const childProcessOptions = {};
+
+	if (platform === 'darwin') {
+		command = 'open';
+
+		if (options.wait) {
+			cliArguments.push('--wait-apps');
+		}
+
+		if (options.background) {
+			cliArguments.push('--background');
+		}
+
+		if (options.newInstance) {
+			cliArguments.push('--new');
+		}
+
+		if (app) {
+			cliArguments.push('-a', app);
+		}
+	} else if (platform === 'win32' || (isWsl$1 && !isInsideContainer() && !app)) {
+		command = await powerShellPath();
+
+		cliArguments.push(
+			'-NoProfile',
+			'-NonInteractive',
+			'-ExecutionPolicy',
+			'Bypass',
+			'-EncodedCommand',
+		);
+
+		if (!isWsl$1) {
+			childProcessOptions.windowsVerbatimArguments = true;
+		}
+
+		const encodedArguments = ['Start'];
+
+		if (options.wait) {
+			encodedArguments.push('-Wait');
+		}
+
+		if (app) {
+			// Double quote with double quotes to ensure the inner quotes are passed through.
+			// Inner quotes are delimited for PowerShell interpretation with backticks.
+			encodedArguments.push(`"\`"${app}\`""`);
+			if (options.target) {
+				appArguments.push(options.target);
+			}
+		} else if (options.target) {
+			encodedArguments.push(`"${options.target}"`);
+		}
+
+		if (appArguments.length > 0) {
+			appArguments = appArguments.map(argument => `"\`"${argument}\`""`);
+			encodedArguments.push('-ArgumentList', appArguments.join(','));
+		}
+
+		// Using Base64-encoded command, accepted by PowerShell, to allow special characters.
+		options.target = node_buffer.Buffer.from(encodedArguments.join(' '), 'utf16le').toString('base64');
+	} else {
+		if (app) {
+			command = app;
+		} else {
+			// When bundled by Webpack, there's no actual package file path and no local `xdg-open`.
+			const isBundled = !__dirname$1 || __dirname$1 === '/';
+
+			// Check if local `xdg-open` exists and is executable.
+			let exeLocalXdgOpen = false;
+			try {
+				await fs$1.access(localXdgOpenPath, fs$1.constants.X_OK);
+				exeLocalXdgOpen = true;
+			} catch {}
+
+			const useSystemXdgOpen = process.versions.electron
+				?? (platform === 'android' || isBundled || !exeLocalXdgOpen);
+			command = useSystemXdgOpen ? 'xdg-open' : localXdgOpenPath;
+		}
+
+		if (appArguments.length > 0) {
+			cliArguments.push(...appArguments);
+		}
+
+		if (!options.wait) {
+			// `xdg-open` will block the process unless stdio is ignored
+			// and it's detached from the parent even if it's unref'd.
+			childProcessOptions.stdio = 'ignore';
+			childProcessOptions.detached = true;
+		}
+	}
+
+	if (platform === 'darwin' && appArguments.length > 0) {
+		cliArguments.push('--args', ...appArguments);
+	}
+
+	// This has to come after `--args`.
+	if (options.target) {
+		cliArguments.push(options.target);
+	}
+
+	const subprocess = childProcess.spawn(command, cliArguments, childProcessOptions);
+
+	if (options.wait) {
+		return new Promise((resolve, reject) => {
+			subprocess.once('error', reject);
+
+			subprocess.once('close', exitCode => {
+				if (!options.allowNonzeroExitCode && exitCode > 0) {
+					reject(new Error(`Exited with code ${exitCode}`));
+					return;
+				}
+
+				resolve(subprocess);
+			});
+		});
+	}
+
+	subprocess.unref();
+
+	return subprocess;
+};
+
+const open = (target, options) => {
+	if (typeof target !== 'string') {
+		throw new TypeError('Expected a `target`');
+	}
+
+	return baseOpen({
+		...options,
+		target,
+	});
+};
+
+function detectArchBinary(binary) {
+	if (typeof binary === 'string' || Array.isArray(binary)) {
+		return binary;
+	}
+
+	const {[arch]: archBinary} = binary;
+
+	if (!archBinary) {
+		throw new Error(`${arch} is not supported`);
+	}
+
+	return archBinary;
+}
+
+function detectPlatformBinary({[platform]: platformBinary}, {wsl}) {
+	if (wsl && isWsl$1) {
+		return detectArchBinary(wsl);
+	}
+
+	if (!platformBinary) {
+		throw new Error(`${platform} is not supported`);
+	}
+
+	return detectArchBinary(platformBinary);
+}
+
+const apps = {};
+
+defineLazyProperty(apps, 'chrome', () => detectPlatformBinary({
+	darwin: 'google chrome',
+	win32: 'chrome',
+	linux: ['google-chrome', 'google-chrome-stable', 'chromium'],
+}, {
+	wsl: {
+		ia32: '/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe',
+		x64: ['/mnt/c/Program Files/Google/Chrome/Application/chrome.exe', '/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'],
+	},
+}));
+
+defineLazyProperty(apps, 'brave', () => detectPlatformBinary({
+	darwin: 'brave browser',
+	win32: 'brave',
+	linux: ['brave-browser', 'brave'],
+}, {
+	wsl: {
+		ia32: '/mnt/c/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe',
+		x64: ['/mnt/c/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe', '/mnt/c/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe'],
+	},
+}));
+
+defineLazyProperty(apps, 'firefox', () => detectPlatformBinary({
+	darwin: 'firefox',
+	win32: String.raw`C:\Program Files\Mozilla Firefox\firefox.exe`,
+	linux: 'firefox',
+}, {
+	wsl: '/mnt/c/Program Files/Mozilla Firefox/firefox.exe',
+}));
+
+defineLazyProperty(apps, 'edge', () => detectPlatformBinary({
+	darwin: 'microsoft edge',
+	win32: 'msedge',
+	linux: ['microsoft-edge', 'microsoft-edge-dev'],
+}, {
+	wsl: '/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
+}));
+
+defineLazyProperty(apps, 'browser', () => 'browser');
+
+defineLazyProperty(apps, 'browserPrivate', () => 'browserPrivate');
+
+async function openExternalUrl(url) {
+    try {
+        await open(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
+exports.openExternalUrl = openExternalUrl;