setil

Setil - single executable applications utility

The goal of this package is to help you build node.js SEA with ease.

CLI Example

CLI usage is not implemented yet.

Code Example

import { compile } from "setil";
import { readFileSync } from "node:fs";
import { resolve } from "nod:path";

const input = readFileSync("src/index.js", "utf-8");
const output = `./app.exe`;

await setil.compile(input, output);

// Enjoy!

Usage

compile(input: string, rawOutput: string, rawOptions?: Partial<Options>): Promise<Result>

• input - The input code, as SEA doesn't accept imports after compilation, you can use rollup to bundle your project into a single file. You can also check rollup-plugin-jsative if you use native modules.
• output (rawOutput) - The output path of your application, e.g. ./program.exe.
• options (rawOptions) - Any additional customization, checkout Options

Options

Property	Type	Default	Description
logLevel	LogLevel	"warn"	Specifies the desired log level for the application.
disableSeaWarning	boolean	false	Disables (node:16104) ExperimentalWarning: Single executable application is an experimental feature and might change at any time
useSnapshot	boolean	false	Startup Snapshots
useCodeCache	boolean	false	V8 Code Cache
nodeExePath	string | undefined	process.execPath	The path where the blob should be injected into (Optional)
noSign	boolean	true	Controls whether to remove the original Node.JS signature.
preInject	(path: string) => any | Promise	Noop (no operation)	A hook executed just before the blob is injected into the application can be used to modify the nodeExePath file.

Types

Result

Property	Type	Description
input	string	The input code used.
outputPath	string	The output path of the SEA.
nodeExePath	string	The nodeExePath used.
tempDir	string	The temporary directory used.

LogLevel

One of debug, warn or silent

• debug - Show debug logs
• warn - Show warnings only (default)
• silent - Don't print anything

Resources

• Github
• Node.js SEA
• Rollup
• @rollup/plugin-commonjs
• @rollup/plugin-node-resolve
• rollup-plugin-jsative