feat: presets meta (#374)

src/env.ts

@@ -15,6 +15,7 @@ import nodeCompatPreset from "./presets/nodeless";
  */
 export function defineEnv(opts: CreateEnvOptions = {}): {
   env: Environment;
+  presets: Preset[];
 } {
   const presets: Preset[] = [];
 
@@ -32,7 +33,7 @@ export function defineEnv(opts: CreateEnvOptions = {}): {
 
   const resolvedEnv = env(...presets);
 
-  return { env: resolvedEnv };
+  return { env: resolvedEnv, presets };
 }
 
 /**

src/presets/cloudflare.ts

@@ -1,4 +1,5 @@
 import type { Preset } from "../types";
+import { version } from "../../package.json";
 
 // Built-in APIs provided by workerd.
 // https://developers.cloudflare.com/workers/runtime-apis/nodejs/
@@ -42,6 +43,10 @@ const hybridNodeCompatModules = [
 ];
 
 const cloudflarePreset: Preset = {
+  meta: {
+    name: "unenv:cloudflare",
+    version,
+  },
   alias: {
     ...Object.fromEntries(
       cloudflareNodeCompatModules.flatMap((p) => [

src/presets/node.ts

@@ -1,7 +1,13 @@
 import { NodeBuiltinModules } from "../utils";
 import type { Preset } from "../types";
+import { version } from "../../package.json";
 
 export default {
+  meta: {
+    name: "unenv:node",
+    version,
+  },
+
   alias: {
     "node-fetch": "unenv/runtime/npm/node-fetch",
     "cross-fetch": "unenv/runtime/npm/cross-fetch",

src/presets/nodeless.ts

@@ -1,7 +1,13 @@
 import { NodeBuiltinModules, mapArrToVal } from "../utils";
 import type { Preset } from "../types";
+import { version } from "../../package.json";
 
 const nodeless: Preset & { alias: Map<string, string> } = {
+  meta: {
+    name: "unenv:nodeless",
+    version,
+  },
+
   alias: {
     // Generic mock for built-ins
     ...mapArrToVal("unenv/runtime/mock/proxy-cjs", NodeBuiltinModules),

src/types.ts

@@ -23,6 +23,23 @@ export interface Environment {
 }
 
 export interface Preset {
+  meta?: {
+    /**
+     * Preset name.
+     */
+    readonly name?: string;
+
+    /**
+     * Preset version.
+     */
+    readonly version?: string;
+
+    /**
+     * Path to preset directory usable for absolute path imports
+     */
+    readonly path?: string;
+  };
+
   alias?: Environment["alias"];
   // inject's value is nullable to support overrides/subtraction
   inject?: { [key: string]: string | string[] | false };

tsconfig.json

@@ -6,6 +6,7 @@
     "esModuleInterop": true,
     "strict": true,
     "declaration": true,
+    "resolveJsonModule": true,
     "types": [
       "node"
     ],