loony-dotenv 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025, Sankar Boro
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,117 @@
+# 📦 loony-dotenv
+
+A tiny, fast, zero-dependency utility for loading `.env` files into `process.env` — clean, simple, and reliable.
+
+---
+
+## 🚀 Features
+
+- ⚡ Zero dependencies
+- 📁 Loads `.env` files into `process.env`
+- 🧼 Handles quotes and whitespace cleanly
+- 🛑 Does **not** overwrite existing env variables
+- 🪶 Lightweight and minimal API
+- 🧩 Works with both CommonJS and ESM projects
+
+---
+
+## 📥 Installation
+
+```bash
+npm install loony-dotenv
+```
+
+or
+
+```bash
+yarn add loony-dotenv
+```
+
+---
+
+## 🔧 Usage
+
+### Basic example
+
+```js
+import loadEnv from "loony-dotenv";
+
+loadEnv(); // loads "./.env"
+
+// Now you can use:
+console.log(process.env.MY_VARIABLE);
+```
+
+---
+
+### Custom .env file path
+
+```js
+loadEnv("./config/custom.env");
+```
+
+---
+
+## 🧪 Example `.env` file
+
+```
+PORT=3000
+DB_HOST="localhost"
+API_KEY='secret-key'
+```
+
+---
+
+## 📘 API
+
+### `loadEnv(envPath?: string): void`
+
+| Parameter | Type     | Default | Description             |
+| --------- | -------- | ------- | ----------------------- |
+| `envPath` | `string` | `.env`  | Path to the `.env` file |
+
+---
+
+## ⚠️ Behavior Notes
+
+- Environment variables **already set** will **not** be overwritten.
+- Lines beginning with `#` or empty lines are ignored.
+- Quoted values (`"value"` or `'value'`) are automatically unwrapped.
+
+---
+
+## 🛠 How It Works (Simplified)
+
+1. Reads the file synchronously
+2. Splits the contents line-by-line
+3. Parses `KEY=VALUE` pairs
+4. Cleans quotes and whitespace
+5. Populates `process.env`
+
+Clean, obvious, predictable.
+
+---
+
+## 🗂 Project Structure Suggestion
+
+```
+project/
+  ├─ index.mjs
+  ├─ .env
+  └─ package.json
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome!
+Feel free to open a pull request or issue on GitHub:
+
+👉 [https://github.com/loony-js/loony-dotenv](https://github.com/loony-js/loony-dotenv)
+
+---
+
+## 📄 License
+
+ISC © Sankar Boro

package/index.mjs

@@ -0,0 +1,81 @@
+import fs from "fs";
+import path from "path";
+
+/**
+ * Safely parse a single line of KEY=VALUE format.
+ * Supports quoted values and inline comments.
+ * @param {string} line
+ * @returns {{ key: string, value: string } | null}
+ */
+function parseEnvLine(line) {
+  const trimmed = line.trim();
+
+  // Skip blank lines and comment lines
+  if (!trimmed || trimmed.startsWith("#")) return null;
+
+  // Find first '=' that isn't escaped
+  let separatorIndex = -1;
+  for (let i = 0; i < trimmed.length; i++) {
+    if (trimmed[i] === "=" && trimmed[i - 1] !== "\\") {
+      separatorIndex = i;
+      break;
+    }
+  }
+
+  if (separatorIndex === -1) {
+    console.warn(`[loony-dotenv] Skipping malformed line: ${trimmed}`);
+    return null;
+  }
+
+  const key = trimmed.slice(0, separatorIndex).trim();
+  let value = trimmed.slice(separatorIndex + 1).trim();
+
+  // Remove inline comments: KEY=value # comment
+  const commentIndex = value.indexOf(" #");
+  if (commentIndex !== -1) {
+    value = value.slice(0, commentIndex).trim();
+  }
+
+  // Remove surrounding quotes
+  if (
+    (value.startsWith('"') && value.endsWith('"')) ||
+    (value.startsWith("'") && value.endsWith("'"))
+  ) {
+    value = value.slice(1, -1);
+  }
+
+  // Unescape escaped '=' (i.e., KEY=va\=lue)
+  value = value.replace(/\\=/g, "=");
+
+  return { key, value };
+}
+
+/**
+ * Loads variables from a .env file into process.env.
+ * @param {string} envPath - Path to .env file (default: ".env")
+ */
+function loadEnv(envPath = ".env") {
+  const absolutePath = path.resolve(envPath);
+
+  if (!fs.existsSync(absolutePath)) {
+    console.error(`[loony-dotenv] .env file not found at: ${absolutePath}`);
+    return;
+  }
+
+  const fileContents = fs.readFileSync(absolutePath, "utf8");
+  const lines = fileContents.split(/\r?\n/);
+
+  for (const line of lines) {
+    const parsed = parseEnvLine(line);
+    if (!parsed) continue;
+
+    const { key, value } = parsed;
+
+    // Do not override existing environment variables
+    if (!(key in process.env)) {
+      process.env[key] = value;
+    }
+  }
+}
+
+export default loadEnv;

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "loony-dotenv",
+  "version": "0.1.0",
+  "description": "Simple environment loader that reads .env files and automatically populates process.env for Node.js applications.",
+  "type": "module",
+  "main": "index.mjs",
+  "exports": {
+    ".": "./index.mjs"
+  },
+  "files": [
+    "index.mjs"
+  ],
+  "keywords": [
+    "loony-env",
+    "loony-dotenv",
+    "dotenv",
+    "env"
+  ],
+  "author": "Sankar Boro",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loony-js/loony-dotenv.git"
+  }
+}