feat: add package version for bun

BREAKING CHANGE

Author: SunsetTechuila

package.json

@@ -7,18 +7,12 @@
   "files": [
     "dist/**/*"
   ],
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.mjs",
+  "main": "./dist/generic.js",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/esm/index.d.mts",
-        "default": "./dist/esm/index.mjs"
-      },
-      "require": {
-        "types": "./dist/cjs/index.d.ts",
-        "default": "./dist/cjs/index.js"
-      }
+      "bun": "./dist/bun.mjs",
+      "types": "./dist/generic.d.ts",
+      "default": "./dist/generic.js"
     },
     "./package.json": "./package.json"
   },

src/bun.ts

@@ -0,0 +1,45 @@
+import { builtinModules } from "node:module";
+
+import { checkModule, getModules, bundledBunModules, implementedNodeModules } from "./shared";
+import type { BunVersion, Modules } from "./shared";
+
+export type { BunVersion };
+export { MINIMUM_BUN_VERSION } from "./shared";
+
+const currentBunVersion = Bun.version as BunVersion;
+
+const bunModules = { ...bundledBunModules } as Modules;
+// don't do the same with node modules because `builtinModules` in bun contains even not implemented node modules
+for (const moduleName of builtinModules) {
+  if (moduleName.startsWith("bun:")) {
+    bunModules[moduleName] ??= `>=${currentBunVersion}`;
+  }
+}
+
+export function isBunModule(moduleName: string, bunVersion?: BunVersion): boolean {
+  return checkModule(moduleName, bunModules, bunVersion ?? currentBunVersion);
+}
+
+export function isBunImplementedNodeModule(moduleName: string, bunVersion?: BunVersion): boolean {
+  return checkModule(
+    moduleName.replace(/^node:/, ""),
+    implementedNodeModules,
+    bunVersion ?? currentBunVersion,
+  );
+}
+
+export function isBunBuiltin(moduleName: string, bunVersion?: BunVersion): boolean {
+  return isBunModule(moduleName, bunVersion) || isBunImplementedNodeModule(moduleName, bunVersion);
+}
+
+export function getBunModules(bunVersion?: BunVersion): string[] {
+  return getModules(bunModules, bunVersion ?? currentBunVersion);
+}
+
+export function getBunImplementedNodeModules(bunVersion?: BunVersion): string[] {
+  return getModules(implementedNodeModules, bunVersion ?? currentBunVersion);
+}
+
+export function getBunBuiltinModules(bunVersion?: BunVersion): string[] {
+  return [...getBunModules(bunVersion), ...getBunImplementedNodeModules(bunVersion)];
+}

src/generic.ts

@@ -0,0 +1,33 @@
+import { checkModule, getModules, bundledBunModules, implementedNodeModules } from "./shared";
+import type { BunVersion } from "./shared";
+
+export type { BunVersion };
+export { MINIMUM_BUN_VERSION } from "./shared";
+
+export function isBunModule(moduleName: string, bunVersion?: BunVersion): boolean {
+  return checkModule(moduleName, bundledBunModules, bunVersion ?? "latest");
+}
+
+export function isBunImplementedNodeModule(moduleName: string, bunVersion?: BunVersion): boolean {
+  return checkModule(
+    moduleName.replace(/^node:/, ""),
+    implementedNodeModules,
+    bunVersion ?? "latest",
+  );
+}
+
+export function isBunBuiltin(moduleName: string, bunVersion?: BunVersion): boolean {
+  return isBunModule(moduleName, bunVersion) || isBunImplementedNodeModule(moduleName, bunVersion);
+}
+
+export function getBunModules(bunVersion?: BunVersion): string[] {
+  return getModules(bundledBunModules, bunVersion ?? "latest");
+}
+
+export function getBunImplementedNodeModules(bunVersion?: BunVersion): string[] {
+  return getModules(implementedNodeModules, bunVersion ?? "latest");
+}
+
+export function getBunBuiltinModules(bunVersion?: BunVersion): string[] {
+  return [...getBunModules(bunVersion), ...getBunImplementedNodeModules(bunVersion)];
+}

src/index.ts

@@ -0,0 +1,53 @@
+import valid from "semver/functions/valid";
+import satisfies from "semver/functions/satisfies";
+import lt from "semver/functions/lt";
+
+export { default as bundledBunModules } from "@assets/bun-modules.json";
+export { default as implementedNodeModules } from "@assets/implemented-node-modules.json";
+
+type SemVerBaseStringified = `${bigint}.${bigint}.${bigint}`;
+type SemVerStringifiedWithReleaseName = `${SemVerBaseStringified}-${string}`;
+type SemVerStringified = SemVerBaseStringified | SemVerStringifiedWithReleaseName;
+export type BunVersion = SemVerStringified | "latest";
+
+export type Modules = Record<string, string | boolean>;
+
+export const MINIMUM_BUN_VERSION = "1.0.0" satisfies SemVerBaseStringified;
+
+export function checkModule(moduleName: string, modules: Modules, bunVersion: BunVersion): boolean {
+  if (typeof moduleName !== "string") throw new TypeError("Module name must be a string");
+  if (!(moduleName in modules)) return false;
+
+  const targetBunVersion = toSemVerStringified(bunVersion);
+  if (lt(targetBunVersion, MINIMUM_BUN_VERSION)) {
+    throw new RangeError(`Bun version must be at least ${MINIMUM_BUN_VERSION}`);
+  }
+
+  return satisfiesVersionRange(targetBunVersion, modules[moduleName]!);
+}
+
+export function getModules(modules: Modules, bunVersion?: BunVersion): string[] {
+  const targetBunVersion = toSemVerStringified(bunVersion);
+  if (lt(targetBunVersion, MINIMUM_BUN_VERSION)) {
+    throw new RangeError(`Bun version must be at least ${MINIMUM_BUN_VERSION}`);
+  }
+
+  return Object.keys(modules).filter((moduleName) => {
+    return satisfiesVersionRange(targetBunVersion, modules[moduleName]!);
+  });
+}
+
+function satisfiesVersionRange(
+  version: SemVerStringified,
+  versionRange: string | boolean,
+): boolean {
+  if (typeof versionRange === "boolean") return versionRange;
+  return satisfies(version, versionRange);
+}
+
+function toSemVerStringified(input: unknown): SemVerStringified {
+  if (typeof input !== "string") throw new TypeError("Bun version must be a string");
+  if (input === "latest") return "999.999.999" as SemVerStringified;
+  if (valid(input)) return input as SemVerBaseStringified;
+  throw new TypeError("Bun version must be a string like '1.0.0' or 'latest'");
+}

src/shared.ts

@@ -1,6 +1,6 @@
 import { test, expect, describe } from "bun:test";
 import bundledBunModules from "@assets/bun-modules.json";
-import bundledNodeModules from "@assets/node-modules.json";
+import bundledNodeModules from "@assets/implemented-node-modules.json";
 
 import {
   getBunModules,
@@ -25,7 +25,7 @@ describe("Module lists checking", () => {
     });
   });
 
-  test("getBunImplementedNodeModules() equals keys of node-modules.json", () => {
+  test("getBunImplementedNodeModules() equals keys of implemented-node-modules.json", () => {
     expect(getBunImplementedNodeModules()).toContainAllValues(nodeModulesList);
   });
   test("getBunImplementedNodeModules() returns only node modules", () => {
@@ -37,7 +37,7 @@ describe("Module lists checking", () => {
     expect(getBunImplementedNodeModules("1.0.0")).not.toContain("http2");
   });
 
-  test("getBunBuiltinModules() equals keys of node-modules.json && bun-modules.json", () => {
+  test("getBunBuiltinModules() equals keys of implemented-node-modules.json && bun-modules.json", () => {
     expect(getBunBuiltinModules()).toContainAllValues(builtinModulesList);
   });
   test("getBunBuiltinModules() returns only built-in modules", () => {

test/getModules.test.ts

@@ -1,22 +1,26 @@
 import { defineConfig, type Options } from "tsup";
 
-const baseConfig = {
-  entry: ["src/index.ts"],
+const sharedConfig = {
+  entry: ["src/shared.ts"],
   target: "es2019",
+  format: ["cjs"],
   dts: true,
   clean: true,
 } satisfies Options;
 
-const cjsConfig = {
-  ...baseConfig,
-  format: "cjs",
-  outDir: "dist/cjs",
+const genericConfig = {
+  entry: ["src/generic.ts"],
+  target: "es2019",
+  format: ["cjs"],
+  external: ["./shared"],
+  dts: true,
 } satisfies Options;
 
-const esmConfig = {
-  ...baseConfig,
-  format: "esm",
-  outDir: "dist/esm",
+const bunConfig = {
+  entry: ["src/bun.ts"],
+  target: "es2022",
+  format: ["esm"],
+  external: ["./shared"],
 } satisfies Options;
 
-export default defineConfig([cjsConfig, esmConfig]);
+export default defineConfig([sharedConfig, genericConfig, bunConfig]);