egisl 0.0.1

package/README.md

@@ -0,0 +1,26 @@
+Modern JS engine installer (WIP).
+```sh
+# create config file at ./egist.json if not exists, else install all engines in config file
+egist init
+
+# latest v8
+egisl add v8
+
+# llrt v0.8.1-beta
+egisl add llrt@v0.8.1-beta
+
+# quickjs 2026-06-04 build for x64 arch
+egisl add quickjs@2026-06-04_x64
+
+# llrt v0.8.1-beta for x64 linux
+egisl add llrt@v0.8.1-beta_x64_linux
+
+# add multiple engines
+egisl add v8 quickjs llrt jsc hermes spidermonkey xs
+
+# remove engines, similar arguments to egist add
+egisl remove ...
+
+# alias binaries, similar arguments to egist add
+egist use ...
+```

package/cli.js

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/llrt.d.ts

@@ -0,0 +1,5 @@
+import { type Arch, type Installer, type OS } from "./utils.ts";
+import { type Unzipped } from "fflate/node";
+export declare const getLink: (releaseTag: string, arch: Arch, os: OS) => string;
+export declare const getBinary: (zipLink: string) => Promise<Unzipped[string]>;
+export declare const install: Installer;

package/llrt.js

@@ -0,0 +1 @@
+import{createDir,formatBytes,saveBinary,unsupportedTarget}from"./utils.js";import{unzipSync}from"fflate/node";export const getLink=(releaseTag,arch,os)=>{"x64"===arch||"arm64"===arch||unsupportedTarget(arch,os,"llrt supports linux-x64, linux-arm64, mac-x64, mac-arm64, win-x64, win-arm64");"mac"===os?os="darwin":"win"===os&&(os="windows");return`https://github.com/awslabs/llrt/releases/download/${releaseTag}/llrt-${os}-${arch}.zip`};export const getBinary=async zipLink=>Object.values(unzipSync(await (await fetch(zipLink)).bytes()))[0];export const install=async(id,dest,version,arch,os)=>{let logGroup="[llrt@"+id+"]";dest=await createDir(logGroup,dest,"llrt");let link=getLink(version,arch,os);console.info(logGroup,"fetching",link);let binary=await getBinary(link);console.log(logGroup,"binary size:",formatBytes(binary.byteLength));let llrt=await saveBinary(logGroup,os,dest,id,binary);console.info(logGroup,"done :>");return{llrt}};

package/package.json

@@ -0,0 +1 @@
+{"name":"egisl","version":"0.0.1","description":"Modern JS engine installer","keywords":[],"homepage":"","bin":"cli.js","license":"MIT","repository":"js-benchmark-all/engine-installer","type":"module","dependencies":{"fflate":"^0.8.3"},"exports":{"./*":"./*.js"}}

package/quickjs.d.ts

@@ -0,0 +1,5 @@
+import { type Arch, type Installer, type OS } from "./utils.ts";
+import { type Unzipped } from "fflate/node";
+export declare const getLink: (releaseDate: string, arch: Arch, os: OS) => string;
+export declare const getBinary: (zipLink: string) => Promise<Unzipped[string]>;
+export declare const install: Installer;

package/quickjs.js

@@ -0,0 +1 @@
+import{createDir,formatBytes,saveBinary,unsupportedTarget}from"./utils.js";import{unzipSync}from"fflate/node";let additionalMsg="quickjs supports linux-x64, linux-x86, win-x64, win-x86";export const getLink=(releaseDate,arch,os)=>{"linux"===os||"win"===os||unsupportedTarget(arch,os,additionalMsg);"x64"===arch?arch="x86_64":"x86"===arch?arch="i686":unsupportedTarget(arch,os,additionalMsg);return`https://bellard.org/quickjs/binary_releases/quickjs-${os}-${arch}-${releaseDate}.zip`};export const getBinary=async zipLink=>unzipSync(await (await fetch(zipLink)).bytes()).qjs;export const install=async(id,dest,version,arch,os)=>{let logGroup="[quickjs@"+id+"]";dest=await createDir(logGroup,dest,"quickjs");let link=getLink(version,arch,os);console.info(logGroup,"fetching",link);let binary=await getBinary(link);console.log(logGroup,"binary size:",formatBytes(binary.byteLength));let qjs=await saveBinary(logGroup,os,dest,id,binary);console.info(logGroup,"done :>");return{qjs}};

package/utils.d.ts

@@ -0,0 +1,34 @@
+import { writeFile } from "node:fs/promises";
+export interface Config {
+	/**
+	* Default OS.
+	*/
+	os?: OS;
+	/**
+	* Default arch.
+	*/
+	arch?: Arch;
+	/**
+	* Directory path to install engines, relative to this config file.
+	*
+	* Defaults to `.egist`.
+	*/
+	dir: string;
+	/**
+	* Installed engine binaries.
+	*/
+	engines: Record<string, Record<string, string>>;
+}
+declare const ARCH: readonly ["x64", "x86", "arm64", "arm"];
+export type Arch = typeof ARCH[number];
+declare const OS: readonly ["linux", "win", "mac"];
+export type OS = typeof OS[number];
+export type Installer = (id: string, dest: string, version: string, arch: Arch, os: OS) => Promise<Record<string, string>>;
+export declare const formatBytes: (size: number) => string;
+export declare const unsupportedTarget: (arch: Arch, os: OS, additionalMsg: string) => never;
+export declare const createDir: (logGroup: string, dest: string, id: string) => Promise<string>;
+export declare const saveBinary: (logGroup: string, os: OS, dest: string, id: string, binary: Parameters<typeof writeFile>[1]) => Promise<string>;
+export declare const useBinary: (logGroup: string, os: OS, dest: string, id: string, binPath: string) => Promise<string>;
+export declare const assertOS: (v: string) => OS;
+export declare const assertArch: (v: string) => Arch;
+export {};

package/utils.js

@@ -0,0 +1 @@
+import{mkdir,writeFile}from"node:fs/promises";import{join,relative}from"node:path";let ARCH=["x64","x86","arm64","arm"],OS=["linux","win","mac"];export const formatBytes=size=>{let unit="b";if(size>=1e6){size/=1e6;unit="mb"}else if(size>=1e3){size/=1e3;unit="kb"}return Math.round(100*size)/100+unit};export const unsupportedTarget=(arch,os,additionalMsg)=>{throw new Error(`installer does not support ${os}-${arch} (${additionalMsg})`)};export const createDir=async(logGroup,dest,id)=>{dest=join(dest,id);console.info(logGroup,"creating",relative(".",dest));await mkdir(dest,{recursive:!0});return dest};export const saveBinary=async(logGroup,os,dest,id,binary)=>{dest=join(dest,"win"===os?id+".exe":id);console.info(logGroup,"saving to",relative(".",dest));await writeFile(dest,binary);return dest};export const useBinary=async(logGroup,os,dest,id,binPath)=>{if("win"===os){dest=join(dest,id+".cmd");console.info(logGroup,"saving script to",relative(".",dest));await writeFile(dest,`@echo off\n"${binPath}" %*`)}else{dest=join(dest,id);console.info(logGroup,"saving script to",relative(".",dest));await writeFile(dest,`#!/usr/bin/env bash\n"${binPath}" "$@"`)}return dest};export const assertOS=v=>{if(OS.includes(v))return v;throw new Error(`expected: ${OS.join(", ")}. recieved: ${v}.`)};export const assertArch=v=>{if(ARCH.includes(v))return v;throw new Error(`expected: ${ARCH.join(", ")}. recieved: ${v}.`)};