@unbound-app/rollup-plugin-hermes 2.0.0 → 3.0.0

package/dist/index.d.mts

@@ -32,7 +32,7 @@ export type HermesPlugin = {
 };
 /**
  * @description Compiles the bundle's output file to Hermes bytecode, once per held hermesc version, as `<name>.<version>.bundle` beside it.
- * @param options A fixed hermesc directory, or how many of npm's newest versions to hold; plus extra hermesc flags.
+ * @param options A fixed hermesc directory, or which of npm's bytecode versions to hold; plus extra hermesc flags.
  * @returns The rollup plugin, which rolldown also accepts.
  */
 export default function hermes(options?: HermesOptions): HermesPlugin;

package/dist/index.mjs

@@ -60,7 +60,7 @@ async function compile(ctx, dir, js, flags) {
 }
 /**
 * @description Compiles the bundle's output file to Hermes bytecode, once per held hermesc version, as `<name>.<version>.bundle` beside it.
-* @param options A fixed hermesc directory, or how many of npm's newest versions to hold; plus extra hermesc flags.
+* @param options A fixed hermesc directory, or which of npm's bytecode versions to hold; plus extra hermesc flags.
 * @returns The rollup plugin, which rolldown also accepts.
 */
 function hermes(options = {}) {

package/dist/manifest.d.mts

@@ -21,7 +21,8 @@ export type ManifestContext = {
 export type ManifestOptions = {
   registryUrl?: string;
   cacheDir?: string;
-  versions?: number;
+  /** The exact bytecode versions to hold; the newest few the manifest publishes when omitted. */
+  versions?: number[];
 };
 export type ManifestDeps = {
   fetch?: typeof fetch;
@@ -54,9 +55,10 @@ export declare function fetchManifest(ctx: ManifestContext, options?: ManifestOp
  */
 export declare function hermescBinary(dir: string): string;
 /**
- * @description Downloads the newest hermesc versions into the cache, once each, and returns where each one lives.
+ * @description Downloads the requested hermesc versions, or the newest few, into the cache, once each, and returns where each one lives.
+ * Reports an error through `ctx` when a requested version is not published.
  * @param ctx The plugin context that reports warnings and errors.
- * @param options How many of the newest bytecode versions to hold, the registry URL and the cache directory.
+ * @param options The bytecode versions to hold, the registry URL and the cache directory.
  * @param deps Replacements for `fetch` and the download, for tests.
  * @returns One target per held bytecode version, newest first.
  */

package/dist/manifest.mjs

@@ -172,9 +172,10 @@ async function downloadVersion(npmVersion, root) {
 	if (process.platform !== "win32" && existsSync(binary)) await chmod(binary, 493);
 }
 /**
-* @description Downloads the newest hermesc versions into the cache, once each, and returns where each one lives.
+* @description Downloads the requested hermesc versions, or the newest few, into the cache, once each, and returns where each one lives.
+* Reports an error through `ctx` when a requested version is not published.
 * @param ctx The plugin context that reports warnings and errors.
-* @param options How many of the newest bytecode versions to hold, the registry URL and the cache directory.
+* @param options The bytecode versions to hold, the registry URL and the cache directory.
 * @param deps Replacements for `fetch` and the download, for tests.
 * @returns One target per held bytecode version, newest first.
 */
@@ -182,8 +183,12 @@ async function resolveHermesTargets(ctx, options = {}, deps = {}) {
 	const download = deps.download ?? downloadVersion;
 	const cacheDir = options.cacheDir ?? defaultCacheDir();
 	const manifest = await fetchManifest(ctx, options, deps);
+	const wanted = options.versions;
+	const missing = wanted?.filter((version) => !manifest.latest.includes(version)) ?? [];
+	if (missing.length) ctx.error(`hermesc does not publish bytecode ${missing.join(", ")}.`);
+	const held = wanted ? manifest.latest.filter((version) => wanted.includes(version)) : manifest.latest.slice(0, DEFAULT_HELD_VERSIONS);
 	const targets = [];
-	for (const version of manifest.latest.slice(0, options.versions ?? DEFAULT_HELD_VERSIONS)) {
+	for (const version of held) {
 		const entry = manifest.versions[String(version)];
 		if (!entry) {
 			ctx.warn(`The hermesc manifest has no package for bytecode ${version}, skipping it.`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@unbound-app/rollup-plugin-hermes",
-	"version": "2.0.0",
+	"version": "3.0.0",
 	"description": "Compiles rollup and rolldown bundles to Hermes bytecode with every hermesc version Discord may run.",
 	"author": {
 		"name": "Mario P.",