@matthew-hre/env 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Matthew Hrehirchuk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @matthew-hre/env
+
+Type safe environment variable validation for NextJS projects.
+
+> This package is mostly for my own projects, and I wouldn't recommend using it yourself in its current state. It may be improved in the future. May.

package/dist/index.cjs

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  loadEnv: () => loadEnv
+});
+module.exports = __toCommonJS(index_exports);
+var import_zod = require("zod");
+function loadEnv(schema, env = process.env) {
+  try {
+    return schema.parse(env);
+  } catch (err) {
+    if (err instanceof import_zod.ZodError) {
+      let message = "Invalid environment variables:\n";
+      err.issues.forEach((issue) => {
+        message += ` - ${String(issue.path[0])} (${issue.message})
+`;
+      });
+      console.error(message);
+    } else {
+      console.error("Unexpected error while parsing env:", err);
+    }
+    process.exit(1);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadEnv
+});

package/dist/index.d.cts

@@ -0,0 +1,5 @@
+import { ZodRawShape, ZodObject, z } from 'zod';
+
+declare function loadEnv<T extends ZodRawShape>(schema: ZodObject<T>, env?: Record<string, string | undefined>): z.output<typeof schema>;
+
+export { loadEnv };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { ZodRawShape, ZodObject, z } from 'zod';
+
+declare function loadEnv<T extends ZodRawShape>(schema: ZodObject<T>, env?: Record<string, string | undefined>): z.output<typeof schema>;
+
+export { loadEnv };

package/dist/index.js

@@ -0,0 +1,22 @@
+// src/index.ts
+import { ZodError } from "zod";
+function loadEnv(schema, env = process.env) {
+  try {
+    return schema.parse(env);
+  } catch (err) {
+    if (err instanceof ZodError) {
+      let message = "Invalid environment variables:\n";
+      err.issues.forEach((issue) => {
+        message += ` - ${String(issue.path[0])} (${issue.message})
+`;
+      });
+      console.error(message);
+    } else {
+      console.error("Unexpected error while parsing env:", err);
+    }
+    process.exit(1);
+  }
+}
+export {
+  loadEnv
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@matthew-hre/env",
+  "version": "0.1.0",
+  "description": "Type safe environment variable validation for NextJS projects",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --watch --dts"
+  },
+  "keywords": [
+    "nextjs",
+    "zod",
+    "env",
+    "typed",
+    "validation"
+  ],
+  "author": "Matthew Hrehirchuk",
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^4.1.9"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}