feat: platform agnostic process

README.md

@@ -81,6 +81,14 @@ List of well known providers can be found from [./src/providers.ts](./src/provid
 import { env } from "std-env";
 ```
 
+## Platform agnostic process
+
+`std-env` provides a lightweight proxy to access [`process`](https://nodejs.org/api/process.html) object in a platform agnostic way.
+
+```ts
+import { process } from "std-env";
+```
+
 ## License
 
 MIT

src/index.ts

@@ -1,3 +1,4 @@
-export * from "./providers";
 export * from "./env";
 export * from "./flags";
+export * from "./process";
+export * from "./providers";

src/process.ts

@@ -0,0 +1,12 @@
+import { env } from "./env";
+
+export const process = new Proxy(globalThis.process || Object.create(null), {
+  get(target, prop) {
+    if (prop in target) {
+      return target[prop];
+    }
+    if (prop === "env") {
+      return env;
+    }
+  },
+});

test/index.test.ts

@@ -5,7 +5,6 @@ describe("std-env", () => {
   it("has expected exports", () => {
     expect(Object.keys(stdEnv)).toMatchInlineSnapshot(`
       [
-        "detectProvider",
         "env",
         "nodeENV",
         "platform",
@@ -23,6 +22,8 @@ describe("std-env", () => {
         "isLinux",
         "isMacOS",
         "isColorSupported",
+        "process",
+        "detectProvider",
       ]
     `);
   });