@tsdown/exe 0.21.0-beta.4 → 0.21.0

package/dist/index.d.mts

@@ -5,10 +5,15 @@ interface ExeTarget {
   platform: ExePlatform;
   arch: ExeArch;
   /**
-  * Node.js version to use for the executable. Should be a valid Node.js version string (e.g., "25.7.0").
+  * Node.js version to use for the executable.
+  *
+  * Accepts a valid semver string (e.g., `"25.7.0"`), or the special values
+  * `"latest"` / `"latest-lts"` which resolve the version automatically from
+  * {@link https://nodejs.org/dist/index.json}.
+  *
   * The minimum required version is 25.7.0, which is when SEA support was added to Node.js.
   */
-  nodeVersion: string;
+  nodeVersion: (string & {}) | "latest" | "latest-lts" | `${string}.${string}.${string}`;
 }
 interface ExeExtensionOptions {
   /**

package/dist/index.mjs

@@ -5,9 +5,8 @@ import { Buffer } from "node:buffer";
 import { access, chmod, mkdir, rename, rm, writeFile } from "node:fs/promises";
 import { createDebug } from "obug";
 import { x } from "tinyexec";
-import semver from "semver";
 import satisfies from "semver/functions/satisfies.js";
-
+import valid from "semver/functions/valid.js";
 //#region src/cache.ts
 function getCacheDir() {
 	const home = os.homedir();
@@ -24,7 +23,6 @@ function getCachedBinaryPath(target) {
 	const binName = target.platform === "win" ? "node.exe" : "node";
 	return path.join(cacheDir, "node", `v${target.nodeVersion}`, `${target.platform}-${target.arch}`, binName);
 }
-
 //#endregion
 //#region ../../src/utils/fs.ts
 function fsExists(path) {
@@ -36,10 +34,8 @@ function fsRemove(path) {
 		recursive: true
 	}).catch(() => {});
 }
-
 //#endregion
 //#region src/platform.ts
-const SEA_VERSION_RANGE = ">=25.7.0";
 function getArchiveExtension(platform) {
 	if (platform === "win") return "zip";
 	if (platform === "linux") return "tar.xz";
@@ -55,22 +51,30 @@ function getBinaryPathInArchive(target) {
 	if (platform === "win") return `${dirName}/node.exe`;
 	return `${dirName}/bin/node`;
 }
-function normalizeNodeVersion(target) {
-	const version = semver.valid(target.nodeVersion);
-	if (!version) throw new Error(`Invalid Node.js version: ${target.nodeVersion}. Please provide a valid version string (e.g., "25.7.0").`);
-	if (!satisfies(version, SEA_VERSION_RANGE)) throw new Error(`Node.js ${version} does not support SEA (Single Executable Applications). Required: ${SEA_VERSION_RANGE}`);
+const NODE_DIST_INDEX_URL = "https://nodejs.org/dist/index.json";
+async function resolveNodeVersion(nodeVersion) {
+	if (nodeVersion === "latest" || nodeVersion === "latest-lts") {
+		const response = await fetch(NODE_DIST_INDEX_URL);
+		if (!response.ok) throw new Error(`Failed to fetch Node.js releases: HTTP ${response.status} from ${NODE_DIST_INDEX_URL}`);
+		const releases = await response.json();
+		const release = nodeVersion === "latest" ? releases[0] : releases.find((r) => r.lts !== false);
+		if (!release) throw new Error(`No matching Node.js release found for "${nodeVersion}".`);
+		nodeVersion = release.version.replace(/^v/, "");
+	}
+	const version = valid(nodeVersion);
+	if (!version) throw new Error(`Invalid Node.js version: ${nodeVersion}. Please provide a valid version string (e.g., "25.7.0").`);
+	if (!satisfies(version, ">=25.7.0")) throw new Error(`Node.js ${version} does not support SEA (Single Executable Applications). Required minimum version is 25.7.0. Please update the nodeVersion in your target configuration.`);
 	return version;
 }
 function getTargetSuffix(target) {
 	return `-${target.platform}-${target.arch}`;
 }
-
 //#endregion
 //#region src/download.ts
 const debug = createDebug("tsdown:exe:download");
 async function resolveNodeBinary(target, logger) {
 	debug("Resolving Node.js binary for target: %O", target);
-	target.nodeVersion = normalizeNodeVersion(target);
+	target.nodeVersion = await resolveNodeVersion(target.nodeVersion);
 	const cachedPath = getCachedBinaryPath(target);
 	debug("Cache path: %s", cachedPath);
 	if (await fsExists(cachedPath)) {
@@ -129,6 +133,5 @@ async function extractBinary(archivePath, targetBinaryPath, target) {
 	const extractedPath = path.join(outDir, extractedName);
 	if (extractedPath !== targetBinaryPath) await rename(extractedPath, targetBinaryPath);
 }
-
 //#endregion
-export { getCacheDir, getCachedBinaryPath, getTargetSuffix, resolveNodeBinary };
+export { getCacheDir, getCachedBinaryPath, getTargetSuffix, resolveNodeBinary };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tsdown/exe",
   "type": "module",
-  "version": "0.21.0-beta.4",
+  "version": "0.21.0",
   "description": "Cross-platform executable building for tsdown",
   "author": "Kevin Deng <sxzz@sxzz.moe>",
   "license": "MIT",