@tsdown/exe 0.21.0-beta.2 → 0.21.0-beta.4

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2025-present VoidZero Inc. & Contributors
+Copyright (c) 2024 Kevin Deng (https://github.com/sxzz)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @tsdown/exe
+
+[![npm version][npmx-version-src]][npmx-href]
+[![npm downloads][npmx-downloads-src]][npmx-href]
+
+Cross-platform executable building for [tsdown](https://tsdown.dev), powered by Node.js [Single Executable Applications (SEA)](https://nodejs.org/api/single-executable-applications.html).
+
+## Documentation
+
+See the [Executable documentation](https://tsdown.dev/options/exe) for usage and configuration details.
+
+## License
+
+[MIT](../../LICENSE)
+
+<!-- Badges -->
+
+[npmx-version-src]: https://npmx.dev/api/registry/badge/version/@tsdown/exe
+[npmx-downloads-src]: https://npmx.dev/api/registry/badge/downloads-month/@tsdown/exe
+[npmx-href]: https://npmx.dev/@tsdown/exe

package/dist/index.d.mts

@@ -0,0 +1,42 @@
+//#region src/platform.d.ts
+type ExePlatform = "win" | "darwin" | "linux";
+type ExeArch = "x64" | "arm64";
+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").
+  * The minimum required version is 25.7.0, which is when SEA support was added to Node.js.
+  */
+  nodeVersion: string;
+}
+interface ExeExtensionOptions {
+  /**
+  * Cross-platform targets for building executables.
+  * Requires `@tsdown/exe` to be installed.
+  * When specified, builds an executable for each target platform/arch combination.
+  *
+  * @example
+  * ```ts
+  * targets: [
+  *   { platform: 'linux', arch: 'x64', nodeVersion: '25.7.0' },
+  *   { platform: 'darwin', arch: 'arm64', nodeVersion: '25.7.0' },
+  *   { platform: 'win', arch: 'x64', nodeVersion: '25.7.0' },
+  * ]
+  * ```
+  */
+  targets?: ExeTarget[];
+}
+declare function getTargetSuffix(target: ExeTarget): string;
+//#endregion
+//#region src/cache.d.ts
+declare function getCacheDir(): string;
+declare function getCachedBinaryPath(target: ExeTarget): string;
+//#endregion
+//#region src/download.d.ts
+interface MinimalLogger {
+  info: (...args: any[]) => void;
+}
+declare function resolveNodeBinary(target: ExeTarget, logger?: MinimalLogger): Promise<string>;
+//#endregion
+export { type ExeArch, type ExeExtensionOptions, type ExePlatform, type ExeTarget, getCacheDir, getCachedBinaryPath, getTargetSuffix, resolveNodeBinary };

package/dist/index.mjs

@@ -0,0 +1,134 @@
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+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";
+
+//#region src/cache.ts
+function getCacheDir() {
+	const home = os.homedir();
+	if (process.platform === "win32") {
+		const localAppData = process.env.LOCALAPPDATA || path.join(home, "AppData/Local");
+		return path.join(localAppData, "tsdown/Caches");
+	}
+	if (process.platform === "darwin") return path.join(home, "Library/Caches/tsdown");
+	const xdgCache = process.env.XDG_CACHE_HOME || path.join(home, ".cache");
+	return path.join(xdgCache, "tsdown");
+}
+function getCachedBinaryPath(target) {
+	const cacheDir = getCacheDir();
+	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) {
+	return access(path).then(() => true, () => false);
+}
+function fsRemove(path) {
+	return rm(path, {
+		force: true,
+		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";
+	return "tar.gz";
+}
+function getDownloadUrl(target) {
+	const { platform, arch, nodeVersion } = target;
+	return `https://nodejs.org/dist/v${nodeVersion}/node-v${nodeVersion}-${platform}-${arch}.${getArchiveExtension(platform)}`;
+}
+function getBinaryPathInArchive(target) {
+	const { platform, arch, nodeVersion } = target;
+	const dirName = `node-v${nodeVersion}-${platform}-${arch}`;
+	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}`);
+	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);
+	const cachedPath = getCachedBinaryPath(target);
+	debug("Cache path: %s", cachedPath);
+	if (await fsExists(cachedPath)) {
+		debug("Cache hit: %s", cachedPath);
+		logger?.info(`Using cached Node.js ${target.nodeVersion} for ${target.platform}-${target.arch}`);
+		return cachedPath;
+	}
+	const url = getDownloadUrl(target);
+	debug("Cache miss, downloading from: %s", url);
+	logger?.info(`Downloading Node.js ${target.nodeVersion} for ${target.platform}-${target.arch}...`);
+	logger?.info(`  ${url}`);
+	await mkdir(path.dirname(cachedPath), { recursive: true });
+	const response = await fetch(url);
+	if (!response.ok) throw new Error(`Failed to download Node.js binary: HTTP ${response.status} from ${url}`);
+	const archivePath = `${cachedPath}.download.${getArchiveExtension(target.platform)}`;
+	const buffer = Buffer.from(await response.arrayBuffer());
+	debug("Downloaded %d bytes, writing to: %s", buffer.length, archivePath);
+	await writeFile(archivePath, buffer);
+	try {
+		await extractBinary(archivePath, cachedPath, target);
+		if (target.platform !== "win") await chmod(cachedPath, 493);
+		debug("Binary cached at: %s", cachedPath);
+		logger?.info(`Cached Node.js binary at: ${cachedPath}`);
+	} finally {
+		await fsRemove(archivePath);
+	}
+	return cachedPath;
+}
+async function extractBinary(archivePath, targetBinaryPath, target) {
+	const binaryInArchive = getBinaryPathInArchive(target);
+	const outDir = path.dirname(targetBinaryPath);
+	debug("Extracting %s from archive to %s", binaryInArchive, outDir);
+	if (target.platform === "win") await x("tar", [
+		"-xf",
+		archivePath,
+		"-C",
+		outDir,
+		"--strip-components=1",
+		binaryInArchive
+	], {
+		nodeOptions: { stdio: "inherit" },
+		throwOnError: true
+	});
+	else await x("tar", [
+		`-x${archivePath.endsWith(".tar.xz") ? "J" : "z"}f`,
+		archivePath,
+		"-C",
+		outDir,
+		"--strip-components=2",
+		binaryInArchive
+	], {
+		nodeOptions: { stdio: "inherit" },
+		throwOnError: true
+	});
+	const extractedName = target.platform === "win" ? "node.exe" : "node";
+	const extractedPath = path.join(outDir, extractedName);
+	if (extractedPath !== targetBinaryPath) await rename(extractedPath, targetBinaryPath);
+}
+
+//#endregion
+export { getCacheDir, getCachedBinaryPath, getTargetSuffix, resolveNodeBinary };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tsdown/exe",
   "type": "module",
-  "version": "0.21.0-beta.2",
+  "version": "0.21.0-beta.4",
   "description": "Cross-platform executable building for tsdown",
   "author": "Kevin Deng <sxzz@sxzz.moe>",
   "license": "MIT",
@@ -16,10 +16,7 @@
     "url": "https://github.com/rolldown/tsdown/issues"
   },
   "exports": {
-    ".": {
-      "dev": "./src/index.ts",
-      "default": "./dist/index.mjs"
-    },
+    ".": "./dist/index.mjs",
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.mts",
@@ -35,21 +32,17 @@
     "dist"
   ],
   "publishConfig": {
-    "access": "public",
-    "exports": {
-      ".": "./dist/index.mjs",
-      "./package.json": "./package.json"
-    }
+    "access": "public"
   },
   "engines": {
     "node": ">=20.19.0"
   },
+  "dependencies": {
+    "obug": "^2.1.1",
+    "semver": "^7.7.4",
+    "tinyexec": "^1.0.2"
+  },
   "scripts": {
     "build": "unrun ../../src/run.ts -c ../../tsdown.config.ts -F ."
-  },
-  "dependencies": {
-    "obug": "catalog:prod",
-    "semver": "catalog:prod",
-    "tinyexec": "catalog:prod"
   }
-}
+}