bini-env 1.0.3 → 1.0.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Binidu Ranasinghe
+
+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,227 @@
+# bini-env
+
+![npm](https://img.shields.io/npm/v/bini-env?color=cyan&style=flat-square)
+![npm downloads](https://img.shields.io/npm/dm/bini-env?style=flat-square)
+![license](https://img.shields.io/npm/l/bini-env?style=flat-square)
+![vite](https://img.shields.io/badge/vite-plugin-646CFF?style=flat-square&logo=vite)
+![typescript](https://img.shields.io/badge/TypeScript-ready-3178C6?style=flat-square&logo=typescript)
+
+Universal environment variable loader and Vite plugin for Bini.js. Automatically loads `.env` files in development, reads env vars from the host in production, and works across Node.js, Deno, Bun, and Vite edge functions — with zero configuration.
+
+## Features
+
+- **Universal `getEnv()` / `requireEnv()`** — read env vars in any runtime (Node.js, Deno, Bun, Vite client)
+- **Auto `.env` loading** — no manual `dotenv` setup needed in API routes
+- **`BINI_` prefix** — replaces Vite's `VITE_` prefix with `BINI_` automatically
+- **Branded startup banner** — replaces Vite's default header with a clean Bini.js output
+- **Supports dev and preview modes**
+- **Safe for edge bundlers** — dotenv is loaded via dynamic import, never statically resolved
+
+---
+
+## Installation
+
+```bash
+pnpm add bini-env
+# or
+npm install bini-env
+# or
+yarn add bini-env
+```
+
+---
+
+## Vite Plugin Setup
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import biniEnv from 'bini-env';
+
+export default defineConfig({
+  plugins: [biniEnv()]
+});
+```
+
+That's it. Once added:
+- Your `.env` is auto-loaded for API routes in dev
+- Client code uses `import.meta.env.BINI_*` instead of `VITE_*`
+- The startup banner is replaced with the Bini.js header
+
+---
+
+## Environment Variables
+
+### `.env` file
+
+```env
+# Client-side vars — accessible via import.meta.env.BINI_*
+BINI_FIREBASE_API_KEY=your_key
+BINI_FIREBASE_AUTH_DOMAIN=your_domain
+
+# Server-side vars — accessible via getEnv() in API routes
+SMTP_USER=user@smtp.example.com
+SMTP_PASS=your_password
+FROM_EMAIL=App Name <noreply@example.com>
+```
+
+### In API routes
+
+```ts
+import { getEnv, requireEnv } from 'bini-env';
+
+// Returns string | undefined
+const smtpUser = getEnv('SMTP_USER');
+
+// Returns string — throws a clear error if missing
+const smtpPass = requireEnv('SMTP_PASS');
+```
+
+### In client code (React / Vue / etc.)
+
+```ts
+// Works because bini-env sets envPrefix: 'BINI_' automatically
+const apiKey = import.meta.env.BINI_FIREBASE_API_KEY;
+```
+
+---
+
+## How env loading works by environment
+
+| Environment | How vars are loaded | dotenv used? |
+|---|---|---|
+| Dev (Node.js / bini-router) | Auto-loaded from `.env` by bini-env | ✅ Yes (automatic) |
+| Preview (`vite preview`) | Auto-loaded from `.env` by bini-env | ✅ Yes (automatic) |
+| Production (Netlify / Vercel) | Injected by host dashboard | ❌ No |
+| Production (bini-server / VPS) | Set via server env or hosting panel | ❌ No |
+| Deno / Edge Functions | Read from `Deno.env` natively | ❌ No |
+
+You never need to import or configure `dotenv` manually.
+
+---
+
+## Startup Output
+
+**Dev mode**
+```
+  ß Bini.js (dev)
+  ➜  Environments: .env.local, .env
+  ➜  Local:   http://localhost:3000/
+  ➜  Network: http://192.168.1.10:3000/
+```
+
+**Preview mode**
+```
+  ß Bini.js (preview)
+  ➜  Environments: .env.local, .env
+  ➜  Local:   http://localhost:4173/
+  ➜  Network: http://192.168.1.10:4173/
+```
+
+---
+
+## Plugin Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `enabled` | `boolean` | `true` | Enable or disable the plugin |
+| `clearViteHeader` | `boolean` | `true` | Replace Vite's default startup header |
+| `logo` | `string` | `'ß'` | Custom logo or text shown in the banner |
+| `envPrefix` | `string` | `'BINI_'` | Prefix for client-side env vars in `import.meta.env` |
+
+```ts
+biniEnv({
+  logo: '🚀',
+  clearViteHeader: true,
+  envPrefix: 'BINI_', // change to 'VITE_' to keep Vite's default
+})
+```
+
+---
+
+## Detected `.env` Files
+
+The plugin checks for the following files in your project root (in priority order):
+
+1. `.env.local`
+2. `.env.[NODE_ENV].local`
+3. `.env.[NODE_ENV]`
+4. `.env`
+
+---
+
+## API Reference
+
+### `getEnv(key: string): string | undefined`
+
+Read an environment variable in any runtime. Checks `Deno.env` → `process.env` → `import.meta.env` in order.
+
+```ts
+import { getEnv } from 'bini-env';
+
+const smtpUser = getEnv('SMTP_USER');
+```
+
+### `requireEnv(key: string): string`
+
+Same as `getEnv` but throws a descriptive error if the variable is missing or empty. Use this for required secrets.
+
+```ts
+import { requireEnv } from 'bini-env';
+
+const smtpPass = requireEnv('SMTP_PASS');
+// Throws: [bini-env] Missing required environment variable: "SMTP_PASS".
+//   → In development: add it to your .env file.
+//   → In production: add it to your hosting dashboard environment variables.
+```
+
+### `loadEnv(projectRoot?: string): Promise<void>`
+
+Manually trigger `.env` loading. Called automatically by the Vite plugin — you should not need this.
+
+### `detectEnvFiles(projectRoot?: string): DetectedEnvFile[]`
+
+Scan a directory for `.env` files and return an array of matches.
+
+```ts
+import { detectEnvFiles } from 'bini-env';
+
+const files = detectEnvFiles('/my/project');
+// [{ name: '.env.local', path: '/my/project/.env.local' }, ...]
+```
+
+---
+
+## Types
+
+```ts
+interface BiniEnvPluginOptions {
+  enabled?: boolean;
+  clearViteHeader?: boolean;
+  logo?: string;
+  envPrefix?: string;
+}
+
+interface DetectedEnvFile {
+  name: string;
+  path: string;
+}
+```
+
+---
+
+## Compatibility
+
+| Runtime | Supported |
+|---|---|
+| Node.js 18+ | ✅ |
+| Bun | ✅ |
+| Deno / Edge Functions | ✅ |
+| Vite 7 | ✅ |
+| Vite 8 | ✅ |
+
+---
+
+## License
+
+MIT

package/dist/index.cjs

@@ -1,166 +1,177 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefault(fs);
+var path__default = /*#__PURE__*/_interopDefault(path);
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  default: () => biniEnvPlugin,
-  detectEnvFiles: () => detectEnvFiles,
-  formatEnvFilesForDisplay: () => formatEnvFilesForDisplay
-});
-module.exports = __toCommonJS(index_exports);
-var import_fs = __toESM(require("fs"), 1);
-var import_path = __toESM(require("path"), 1);
 var BINI_LOGO = "\xDF";
+var DEFAULT_ENV_PREFIX = "BINI_";
 var DEFAULT_OPTIONS = {
   enabled: true,
   clearViteHeader: true,
-  logo: BINI_LOGO
+  logo: BINI_LOGO,
+  envPrefix: DEFAULT_ENV_PREFIX
 };
 var COLORS = {
   CYAN: "\x1B[36m",
   RESET: "\x1B[0m",
-  GREEN: "\x1B[32m",
-  YELLOW: "\x1B[33m",
-  DIM: "\x1B[2m"
+  GREEN: "\x1B[32m"
 };
+function getEnv(key) {
+  const deno = globalThis.Deno;
+  if (deno) {
+    try {
+      const val = deno.env.get(key);
+      if (val !== void 0) return val;
+    } catch {
+    }
+  }
+  if (typeof process !== "undefined" && process.env) {
+    if (process.env[key] !== void 0) return process.env[key];
+  }
+  try {
+    const metaEnv = undefined;
+    if (metaEnv) {
+      if (metaEnv[key] !== void 0) return metaEnv[key];
+      if (metaEnv[`BINI_${key}`] !== void 0) return metaEnv[`BINI_${key}`];
+    }
+  } catch {
+  }
+  return void 0;
+}
+function requireEnv(key) {
+  const val = getEnv(key);
+  if (!val) {
+    throw new Error(
+      `[bini-env] Missing required environment variable: "${key}".
+  \u2192 In development: add it to your .env file.
+  \u2192 In production: add it to your hosting dashboard environment variables.`
+    );
+  }
+  return val;
+}
+var _envLoaded = false;
+async function loadEnv(projectRoot) {
+  if (_envLoaded) return;
+  if (globalThis.Deno) {
+    _envLoaded = true;
+    return;
+  }
+  if (typeof process === "undefined" || !process.env) {
+    _envLoaded = true;
+    return;
+  }
+  if (process.env.NODE_ENV === "production") {
+    _envLoaded = true;
+    return;
+  }
+  try {
+    const root = projectRoot ?? process.cwd();
+    const envPath = path__default.default.join(root, ".env");
+    if (!fs__default.default.existsSync(envPath)) {
+      _envLoaded = true;
+      return;
+    }
+    const dotenv = await import('dotenv');
+    dotenv.config({ path: envPath });
+  } catch {
+  }
+  _envLoaded = true;
+}
 function detectEnvFiles(projectRoot = process.cwd()) {
-  const nodeEnv = process.env.NODE_ENV || "development";
-  const envFiles = [
+  const nodeEnv = process.env.NODE_ENV ?? "development";
+  const candidates = [
     ".env.local",
     `.env.${nodeEnv}.local`,
     `.env.${nodeEnv}`,
     ".env"
   ];
   const found = [];
-  for (const file of envFiles) {
-    const filePath = import_path.default.join(projectRoot, file);
-    if (import_fs.default.existsSync(filePath)) {
-      found.push({
-        name: file,
-        path: filePath
-      });
+  for (const file of candidates) {
+    const filePath = path__default.default.join(projectRoot, file);
+    if (fs__default.default.existsSync(filePath)) {
+      found.push({ name: file, path: filePath });
     }
   }
   return found;
 }
-function formatEnvFilesForDisplay(envFiles) {
-  if (envFiles.length === 0) {
-    return "";
-  }
-  const envString = envFiles.map((f) => f.name).join(", ");
-  return `${COLORS.GREEN}\u279C${COLORS.RESET} Environments: ${envString}`;
-}
 function clearLine() {
   process.stdout.write("\x1B[2K\r");
 }
-function biniEnvPlugin(options = {}) {
-  const resolvedOptions = Object.freeze({
-    ...DEFAULT_OPTIONS,
-    ...options
-  });
-  const { enabled, clearViteHeader, logo } = resolvedOptions;
-  let config;
-  let isPreviewMode = false;
+function printResolvedUrls(urls) {
+  if (!urls) return;
+  if (urls.local.length > 0)
+    console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);
+  if (urls.network.length > 0)
+    console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);
+}
+function biniEnv(options = {}) {
+  const resolvedOptions = Object.freeze({ ...DEFAULT_OPTIONS, ...options });
+  const { enabled, clearViteHeader, logo, envPrefix } = resolvedOptions;
+  let resolvedConfig;
   let serverStarted = false;
   let previewStarted = false;
   return {
     name: "vite-plugin-bini-env",
     apply: "serve",
-    configResolved(resolvedConfig) {
-      config = resolvedConfig;
-      if (resolvedConfig.command === "serve") {
-        isPreviewMode = process.env.VITE_PREVIEW === "true" || process.argv.includes("preview") || false;
-      }
+    // Set BINI_ as the env prefix so import.meta.env.BINI_* works in client code
+    config() {
+      return { envPrefix };
+    },
+    configResolved(cfg) {
+      resolvedConfig = cfg;
     },
     configureServer(server) {
       if (!enabled) return;
-      const originalPrintUrls = server.printUrls;
+      if (server.httpServer) {
+        server.httpServer.once("listening", () => {
+          void loadEnv(resolvedConfig?.root ?? process.cwd());
+        });
+      } else {
+        void loadEnv(resolvedConfig?.root ?? process.cwd());
+      }
+      const originalPrintUrls = server.printUrls.bind(server);
       server.printUrls = () => {
-        if (!serverStarted) {
-          serverStarted = true;
-          if (clearViteHeader) {
-            clearLine();
-          }
-          console.log(`
+        if (serverStarted) return;
+        serverStarted = true;
+        if (clearViteHeader) clearLine();
+        console.log(`
   ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (dev)`);
-          const found = detectEnvFiles(config.root);
-          if (found.length > 0) {
-            const envString = found.map((f) => f.name).join(", ");
-            console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Environments: ${envString}`);
-          }
-          if (!clearViteHeader) {
-            originalPrintUrls.call(server);
-          } else {
-            const urls = server.resolvedUrls;
-            if (urls) {
-              if (urls.local.length > 0) {
-                console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);
-              }
-              if (urls.network.length > 0) {
-                console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);
-              }
-            }
-          }
+        const found = detectEnvFiles(resolvedConfig?.root);
+        if (found.length > 0) {
+          const envString = found.map((f) => f.name).join(", ");
+          console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Environments: ${envString}`);
+        }
+        if (!clearViteHeader) {
+          originalPrintUrls();
+        } else {
+          printResolvedUrls(server.resolvedUrls);
         }
       };
     },
     configurePreviewServer(server) {
       if (!enabled) return;
-      isPreviewMode = true;
-      const originalPrintUrls = server.printUrls;
+      const originalPrintUrls = server.printUrls.bind(server);
       server.printUrls = () => {
-        if (!previewStarted) {
-          previewStarted = true;
-          if (clearViteHeader) {
-            clearLine();
-          }
-          console.log(`
+        if (previewStarted) return;
+        previewStarted = true;
+        if (clearViteHeader) clearLine();
+        console.log(`
   ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (preview)`);
-          const found = detectEnvFiles(config.root);
-          if (found.length > 0) {
-            const envString = found.map((f) => f.name).join(", ");
-            console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Environments: ${envString}`);
-          }
-          if (!clearViteHeader) {
-            originalPrintUrls.call(server);
-          } else {
-            const urls = server.resolvedUrls;
-            if (urls) {
-              if (urls.local.length > 0) {
-                console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);
-              }
-              if (urls.network.length > 0) {
-                console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);
-              }
-            }
-          }
+        const found = detectEnvFiles(resolvedConfig?.root);
+        if (found.length > 0) {
+          const envString = found.map((f) => f.name).join(", ");
+          console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Environments: ${envString}`);
+        }
+        if (!clearViteHeader) {
+          originalPrintUrls();
+        } else {
+          printResolvedUrls(server.resolvedUrls);
         }
       };
     },
@@ -170,9 +181,11 @@ function biniEnvPlugin(options = {}) {
     }
   };
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  detectEnvFiles,
-  formatEnvFilesForDisplay
-});
+
+exports.biniEnv = biniEnv;
+exports.detectEnvFiles = detectEnvFiles;
+exports.getEnv = getEnv;
+exports.loadEnv = loadEnv;
+exports.requireEnv = requireEnv;
+//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// src/index.ts\r\nimport fs from 'fs';\r\nimport path from 'path';\r\nimport type { Plugin, ResolvedConfig } from 'vite';\r\n\r\n// Types\r\nexport interface BiniEnvPluginOptions {\r\n  /**\r\n   * Enable/disable the plugin\r\n   * @default true\r\n   * @readonly\r\n   */\r\n  readonly enabled?: boolean;\r\n  \r\n  /**\r\n   * Remove Vite's default header\r\n   * @default true\r\n   * @readonly\r\n   */\r\n  readonly clearViteHeader?: boolean;\r\n  \r\n  /**\r\n   * Custom logo/text to display\r\n   * @default 'ß'\r\n   * @readonly\r\n   */\r\n  readonly logo?: string;\r\n}\r\n\r\nexport interface DetectedEnvFile {\r\n  readonly name: string;\r\n  readonly path: string;\r\n}\r\n\r\n// Constants\r\nconst BINI_LOGO = 'ß' as const;\r\nconst DEFAULT_OPTIONS = {\r\n  enabled: true,\r\n  clearViteHeader: true,\r\n  logo: BINI_LOGO,\r\n} as const;\r\n\r\n// Color definitions\r\nconst COLORS = {\r\n  CYAN: '\\x1b[36m',\r\n  RESET: '\\x1b[0m',\r\n  GREEN: '\\x1b[32m',\r\n  YELLOW: '\\x1b[33m',\r\n  DIM: '\\x1b[2m'\r\n} as const;\r\n\r\n/**\r\n * Detect which .env files exist in project root\r\n */\r\nexport function detectEnvFiles(projectRoot: string = process.cwd()): DetectedEnvFile[] {\r\n  const nodeEnv = process.env.NODE_ENV || 'development';\r\n\r\n  const envFiles = [\r\n    '.env.local',\r\n    `.env.${nodeEnv}.local`,\r\n    `.env.${nodeEnv}`,\r\n    '.env'\r\n  ] as const;\r\n\r\n  const found: DetectedEnvFile[] = [];\r\n\r\n  for (const file of envFiles) {\r\n    const filePath = path.join(projectRoot, file);\r\n    if (fs.existsSync(filePath)) {\r\n      found.push({\r\n        name: file,\r\n        path: filePath\r\n      });\r\n    }\r\n  }\r\n\r\n  return found;\r\n}\r\n\r\n/**\r\n * Format environment files for console display\r\n */\r\nexport function formatEnvFilesForDisplay(envFiles: DetectedEnvFile[]): string {\r\n  if (envFiles.length === 0) {\r\n    return '';\r\n  }\r\n\r\n  const envString = envFiles.map(f => f.name).join(', ');\r\n  return `${COLORS.GREEN}➜${COLORS.RESET} Environments: ${envString}`;\r\n}\r\n\r\n/**\r\n * Clear the current line in console\r\n */\r\nfunction clearLine(): void {\r\n  process.stdout.write('\\x1b[2K\\r');\r\n}\r\n\r\n/**\r\n * Main plugin function\r\n */\r\nexport default function biniEnvPlugin(options: Readonly<BiniEnvPluginOptions> = {}): Plugin {\r\n  // Merge with defaults — user cannot override core behaviour\r\n  const resolvedOptions = Object.freeze({\r\n    ...DEFAULT_OPTIONS,\r\n    ...options,\r\n  });\r\n\r\n  const { enabled, clearViteHeader, logo } = resolvedOptions;\r\n\r\n  let config: ResolvedConfig;\r\n  let isPreviewMode = false;\r\n  let serverStarted = false;\r\n  let previewStarted = false;\r\n\r\n  return {\r\n    name: 'vite-plugin-bini-env',\r\n    \r\n    apply: 'serve',\r\n    \r\n    configResolved(resolvedConfig: ResolvedConfig) {\r\n      config = resolvedConfig;\r\n      \r\n      if (resolvedConfig.command === 'serve') {\r\n        isPreviewMode = process.env.VITE_PREVIEW === 'true' || \r\n                       process.argv.includes('preview') ||\r\n                       false;\r\n      }\r\n    },\r\n\r\n    configureServer(server) {\r\n      if (!enabled) return;\r\n\r\n      const originalPrintUrls = server.printUrls;\r\n      \r\n      server.printUrls = () => {\r\n        if (!serverStarted) {\r\n          serverStarted = true;\r\n          \r\n          if (clearViteHeader) {\r\n            clearLine();\r\n          }\r\n          \r\n          console.log(`\\n  ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (dev)`);\r\n\r\n          const found = detectEnvFiles(config.root);\r\n          if (found.length > 0) {\r\n            const envString = found.map(f => f.name).join(', ');\r\n            console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Environments: ${envString}`);\r\n          }\r\n          \r\n          if (!clearViteHeader) {\r\n            originalPrintUrls.call(server);\r\n          } else {\r\n            const urls = server.resolvedUrls;\r\n            if (urls) {\r\n              if (urls.local.length > 0) {\r\n                console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);\r\n              }\r\n              if (urls.network.length > 0) {\r\n                console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);\r\n              }\r\n            }\r\n          }\r\n        }\r\n      };\r\n    },\r\n\r\n    configurePreviewServer(server) {\r\n      if (!enabled) return;\r\n      \r\n      isPreviewMode = true;\r\n      \r\n      const originalPrintUrls = server.printUrls;\r\n      \r\n      server.printUrls = () => {\r\n        if (!previewStarted) {\r\n          previewStarted = true;\r\n          \r\n          if (clearViteHeader) {\r\n            clearLine();\r\n          }\r\n          \r\n          console.log(`\\n  ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (preview)`);\r\n\r\n          const found = detectEnvFiles(config.root);\r\n          if (found.length > 0) {\r\n            const envString = found.map(f => f.name).join(', ');\r\n            console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Environments: ${envString}`);\r\n          }\r\n          \r\n          if (!clearViteHeader) {\r\n            originalPrintUrls.call(server);\r\n          } else {\r\n            const urls = server.resolvedUrls;\r\n            if (urls) {\r\n              if (urls.local.length > 0) {\r\n                console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);\r\n              }\r\n              if (urls.network.length > 0) {\r\n                console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);\r\n              }\r\n            }\r\n          }\r\n        }\r\n      };\r\n    },\r\n\r\n    buildEnd() {\r\n      serverStarted = false;\r\n      previewStarted = false;\r\n    }\r\n  };\r\n}\r\n\r\nexport type { Plugin } from 'vite';"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,gBAAe;AACf,kBAAiB;AAiCjB,IAAM,YAAY;AAClB,IAAM,kBAAkB;AAAA,EACtB,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,MAAM;AACR;AAGA,IAAM,SAAS;AAAA,EACb,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,KAAK;AACP;AAKO,SAAS,eAAe,cAAsB,QAAQ,IAAI,GAAsB;AACrF,QAAM,UAAU,QAAQ,IAAI,YAAY;AAExC,QAAM,WAAW;AAAA,IACf;AAAA,IACA,QAAQ,OAAO;AAAA,IACf,QAAQ,OAAO;AAAA,IACf;AAAA,EACF;AAEA,QAAM,QAA2B,CAAC;AAElC,aAAW,QAAQ,UAAU;AAC3B,UAAM,WAAW,YAAAA,QAAK,KAAK,aAAa,IAAI;AAC5C,QAAI,UAAAC,QAAG,WAAW,QAAQ,GAAG;AAC3B,YAAM,KAAK;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,yBAAyB,UAAqC;AAC5E,MAAI,SAAS,WAAW,GAAG;AACzB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,SAAS,IAAI,OAAK,EAAE,IAAI,EAAE,KAAK,IAAI;AACrD,SAAO,GAAG,OAAO,KAAK,SAAI,OAAO,KAAK,kBAAkB,SAAS;AACnE;AAKA,SAAS,YAAkB;AACzB,UAAQ,OAAO,MAAM,WAAW;AAClC;AAKe,SAAR,cAA+B,UAA0C,CAAC,GAAW;AAE1F,QAAM,kBAAkB,OAAO,OAAO;AAAA,IACpC,GAAG;AAAA,IACH,GAAG;AAAA,EACL,CAAC;AAED,QAAM,EAAE,SAAS,iBAAiB,KAAK,IAAI;AAE3C,MAAI;AACJ,MAAI,gBAAgB;AACpB,MAAI,gBAAgB;AACpB,MAAI,iBAAiB;AAErB,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,OAAO;AAAA,IAEP,eAAe,gBAAgC;AAC7C,eAAS;AAET,UAAI,eAAe,YAAY,SAAS;AACtC,wBAAgB,QAAQ,IAAI,iBAAiB,UAC9B,QAAQ,KAAK,SAAS,SAAS,KAC/B;AAAA,MACjB;AAAA,IACF;AAAA,IAEA,gBAAgB,QAAQ;AACtB,UAAI,CAAC,QAAS;AAEd,YAAM,oBAAoB,OAAO;AAEjC,aAAO,YAAY,MAAM;AACvB,YAAI,CAAC,eAAe;AAClB,0BAAgB;AAEhB,cAAI,iBAAiB;AACnB,sBAAU;AAAA,UACZ;AAEA,kBAAQ,IAAI;AAAA,IAAO,OAAO,IAAI,GAAG,IAAI,WAAW,OAAO,KAAK,QAAQ;AAEpE,gBAAM,QAAQ,eAAe,OAAO,IAAI;AACxC,cAAI,MAAM,SAAS,GAAG;AACpB,kBAAM,YAAY,MAAM,IAAI,OAAK,EAAE,IAAI,EAAE,KAAK,IAAI;AAClD,oBAAQ,IAAI,KAAK,OAAO,KAAK,SAAI,OAAO,KAAK,mBAAmB,SAAS,EAAE;AAAA,UAC7E;AAEA,cAAI,CAAC,iBAAiB;AACpB,8BAAkB,KAAK,MAAM;AAAA,UAC/B,OAAO;AACL,kBAAM,OAAO,OAAO;AACpB,gBAAI,MAAM;AACR,kBAAI,KAAK,MAAM,SAAS,GAAG;AACzB,wBAAQ,IAAI,KAAK,OAAO,KAAK,SAAI,OAAO,KAAK,cAAc,OAAO,IAAI,GAAG,KAAK,MAAM,CAAC,CAAC,GAAG,OAAO,KAAK,EAAE;AAAA,cACzG;AACA,kBAAI,KAAK,QAAQ,SAAS,GAAG;AAC3B,wBAAQ,IAAI,KAAK,OAAO,KAAK,SAAI,OAAO,KAAK,cAAc,OAAO,IAAI,GAAG,KAAK,QAAQ,CAAC,CAAC,GAAG,OAAO,KAAK,EAAE;AAAA,cAC3G;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,uBAAuB,QAAQ;AAC7B,UAAI,CAAC,QAAS;AAEd,sBAAgB;AAEhB,YAAM,oBAAoB,OAAO;AAEjC,aAAO,YAAY,MAAM;AACvB,YAAI,CAAC,gBAAgB;AACnB,2BAAiB;AAEjB,cAAI,iBAAiB;AACnB,sBAAU;AAAA,UACZ;AAEA,kBAAQ,IAAI;AAAA,IAAO,OAAO,IAAI,GAAG,IAAI,WAAW,OAAO,KAAK,YAAY;AAExE,gBAAM,QAAQ,eAAe,OAAO,IAAI;AACxC,cAAI,MAAM,SAAS,GAAG;AACpB,kBAAM,YAAY,MAAM,IAAI,OAAK,EAAE,IAAI,EAAE,KAAK,IAAI;AAClD,oBAAQ,IAAI,KAAK,OAAO,KAAK,SAAI,OAAO,KAAK,mBAAmB,SAAS,EAAE;AAAA,UAC7E;AAEA,cAAI,CAAC,iBAAiB;AACpB,8BAAkB,KAAK,MAAM;AAAA,UAC/B,OAAO;AACL,kBAAM,OAAO,OAAO;AACpB,gBAAI,MAAM;AACR,kBAAI,KAAK,MAAM,SAAS,GAAG;AACzB,wBAAQ,IAAI,KAAK,OAAO,KAAK,SAAI,OAAO,KAAK,cAAc,OAAO,IAAI,GAAG,KAAK,MAAM,CAAC,CAAC,GAAG,OAAO,KAAK,EAAE;AAAA,cACzG;AACA,kBAAI,KAAK,QAAQ,SAAS,GAAG;AAC3B,wBAAQ,IAAI,KAAK,OAAO,KAAK,SAAI,OAAO,KAAK,cAAc,OAAO,IAAI,GAAG,KAAK,QAAQ,CAAC,CAAC,GAAG,OAAO,KAAK,EAAE;AAAA,cAC3G;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,WAAW;AACT,sBAAgB;AAChB,uBAAiB;AAAA,IACnB;AAAA,EACF;AACF;","names":["path","fs"]}
+{"version":3,"sources":["../src/index.ts"],"names":["path","fs"],"mappings":"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","file":"index.cjs","sourcesContent":["// src/index.ts\nimport fs from 'fs';\nimport path from 'path';\nimport type { Plugin, ResolvedConfig, UserConfig } from 'vite';\n\n/* ==========================================================================\n   Global type declarations for cross-runtime compatibility\n   ========================================================================== */\n\n// Deno runtime type — declared as an interface so we can safely cast\n// without relying on a global that TypeScript doesn't know about\ninterface DenoEnv {\n  get(key: string): string | undefined;\n  toObject(): Record<string, string>;\n}\ninterface DenoNamespace {\n  env: DenoEnv;\n}\n\n// Vite augments ImportMeta with .env\n// Using triple-slash reference so it works both inside and outside Vite projects\n/// <reference types=\"vite/client\" />\n\n/* ==========================================================================\n   Types\n   ========================================================================== */\n\nexport interface BiniEnvPluginOptions {\n  /**\n   * Enable/disable the plugin\n   * @default true\n   */\n  readonly enabled?: boolean;\n\n  /**\n   * Remove Vite's default header\n   * @default true\n   */\n  readonly clearViteHeader?: boolean;\n\n  /**\n   * Custom logo/text to display\n   * @default 'ß'\n   */\n  readonly logo?: string;\n\n  /**\n   * Override the env var prefix exposed to client code.\n   * Defaults to 'BINI_' — so BINI_MY_VAR is accessible via import.meta.env.BINI_MY_VAR\n   * Set to 'VITE_' to keep Vite's default behaviour.\n   * @default 'BINI_'\n   */\n  readonly envPrefix?: string;\n}\n\nexport interface DetectedEnvFile {\n  readonly name: string;\n  readonly path: string;\n}\n\n/* ==========================================================================\n   Constants\n   ========================================================================== */\n\nconst BINI_LOGO = 'ß' as const;\nconst DEFAULT_ENV_PREFIX = 'BINI_' as const;\n\nconst DEFAULT_OPTIONS = {\n  enabled: true,\n  clearViteHeader: true,\n  logo: BINI_LOGO,\n  envPrefix: DEFAULT_ENV_PREFIX,\n} as const;\n\nconst COLORS = {\n  CYAN: '\\x1b[36m',\n  RESET: '\\x1b[0m',\n  GREEN: '\\x1b[32m',\n} as const;\n\n/* ==========================================================================\n   getEnv — Universal env var accessor\n   Works in: Node.js, Deno (edge functions), Bun, Vite client\n   ========================================================================== */\n\n/**\n * Read an environment variable in any runtime.\n *\n * Priority order:\n *  1. Deno.env       — Netlify edge functions / Deno runtime\n *  2. process.env    — Node.js / Bun / bini-server\n *  3. import.meta.env — Vite client (BINI_-prefixed vars)\n *\n * Usage in API routes:\n *   import { getEnv } from 'bini-env';\n *   const smtpUser = getEnv('SMTP_USER');\n */\nexport function getEnv(key: string): string | undefined {\n  // 1. Deno runtime (Netlify edge functions)\n  const deno = (globalThis as unknown as { Deno?: DenoNamespace }).Deno;\n  if (deno) {\n    try {\n      const val = deno.env.get(key);\n      if (val !== undefined) return val;\n    } catch {\n      // Deno env access denied — fall through\n    }\n  }\n\n  // 2. Node.js / Bun / bini-server\n  if (typeof process !== 'undefined' && process.env) {\n    if (process.env[key] !== undefined) return process.env[key];\n  }\n\n  // 3. Vite injected (import.meta.env) — BINI_-prefixed client vars\n  // Wrapped in try/catch because import.meta.env doesn't exist in Node/Deno\n  try {\n    const metaEnv = import.meta.env as Record<string, string | undefined> | undefined;\n    if (metaEnv) {\n      if (metaEnv[key] !== undefined) return metaEnv[key];\n      // Try with BINI_ prefix automatically\n      if (metaEnv[`BINI_${key}`] !== undefined) return metaEnv[`BINI_${key}`];\n    }\n  } catch {\n    // import.meta.env not available in this runtime — ignore\n  }\n\n  return undefined;\n}\n\n/**\n * Read an environment variable and throw if it's missing or empty.\n * Use this for required secrets so you get a clear error at startup\n * instead of a cryptic crash later.\n *\n * Usage:\n *   const smtpPass = requireEnv('SMTP_PASS');\n */\nexport function requireEnv(key: string): string {\n  const val = getEnv(key);\n  if (!val) {\n    throw new Error(\n      `[bini-env] Missing required environment variable: \"${key}\".\\n` +\n      `  → In development: add it to your .env file.\\n` +\n      `  → In production: add it to your hosting dashboard environment variables.`\n    );\n  }\n  return val;\n}\n\n/* ==========================================================================\n   loadEnv — Auto dotenv loader for bini-router API routes (Node.js only)\n   Called internally by the Vite plugin. Safe to call multiple times.\n   ========================================================================== */\n\nlet _envLoaded = false;\n\n/**\n * Auto-load .env into process.env for Node.js API route contexts.\n *\n * Behaviour by environment:\n *  - Deno (edge functions)  → no-op, Deno/Netlify injects env natively\n *  - NODE_ENV=production    → no-op, host injects env vars automatically\n *  - Node.js dev            → loads .env via dotenv (dynamic import, safe for bundlers)\n *\n * Called automatically by bini-env Vite plugin. You should not need to call this manually.\n */\nexport async function loadEnv(projectRoot?: string): Promise<void> {\n  // Already loaded — skip\n  if (_envLoaded) return;\n\n  // Deno runtime — env is handled natively, skip\n  if ((globalThis as unknown as { Deno?: DenoNamespace }).Deno) {\n    _envLoaded = true;\n    return;\n  }\n\n  // Not in a Node-like runtime — skip\n  if (typeof process === 'undefined' || !process.env) {\n    _envLoaded = true;\n    return;\n  }\n\n  // Production — host injects env vars, dotenv not needed\n  if (process.env.NODE_ENV === 'production') {\n    _envLoaded = true;\n    return;\n  }\n\n  try {\n    const root = projectRoot ?? process.cwd();\n    const envPath = path.join(root, '.env');\n\n    if (!fs.existsSync(envPath)) {\n      _envLoaded = true;\n      return;\n    }\n\n    // Dynamic import so Deno/edge bundlers never try to statically resolve dotenv\n    const dotenv = await import('dotenv');\n    dotenv.config({ path: envPath });\n  } catch {\n    // dotenv not installed or read failed — silently skip.\n    // requireEnv() will surface clear errors if vars are missing when used.\n  }\n\n  _envLoaded = true;\n}\n\n/* ==========================================================================\n   detectEnvFiles — used by the Vite plugin display\n   ========================================================================== */\n\n/**\n * Detect which .env files exist in the project root, in Vite's priority order.\n */\nexport function detectEnvFiles(projectRoot: string = process.cwd()): DetectedEnvFile[] {\n  const nodeEnv = process.env.NODE_ENV ?? 'development';\n\n  const candidates = [\n    '.env.local',\n    `.env.${nodeEnv}.local`,\n    `.env.${nodeEnv}`,\n    '.env',\n  ] as const;\n\n  const found: DetectedEnvFile[] = [];\n\n  for (const file of candidates) {\n    const filePath = path.join(projectRoot, file);\n    if (fs.existsSync(filePath)) {\n      found.push({ name: file, path: filePath });\n    }\n  }\n\n  return found;\n}\n\n/* ==========================================================================\n   Vite plugin\n   ========================================================================== */\n\nfunction clearLine(): void {\n  process.stdout.write('\\x1b[2K\\r');\n}\n\nfunction printResolvedUrls(urls: { local: string[]; network: string[] } | null | undefined): void {\n  if (!urls) return;\n  if (urls.local.length > 0)\n    console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);\n  if (urls.network.length > 0)\n    console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);\n}\n\n/**\n * Bini.js Vite plugin.\n *\n * What it does:\n *  - Sets envPrefix to 'BINI_' so client code uses import.meta.env.BINI_MY_VAR\n *  - Auto-loads .env for API routes in dev via loadEnv()\n *  - Replaces Vite's startup output with the Bini.js branded header\n */\nexport function biniEnv(options: Readonly<BiniEnvPluginOptions> = {}): Plugin {\n  const resolvedOptions = Object.freeze({ ...DEFAULT_OPTIONS, ...options });\n  const { enabled, clearViteHeader, logo, envPrefix } = resolvedOptions;\n\n  let resolvedConfig: ResolvedConfig;\n  let serverStarted = false;\n  let previewStarted = false;\n\n  return {\n    name: 'vite-plugin-bini-env',\n\n    apply: 'serve',\n\n    // Set BINI_ as the env prefix so import.meta.env.BINI_* works in client code\n    config(): UserConfig {\n      return { envPrefix };\n    },\n\n    configResolved(cfg: ResolvedConfig) {\n      resolvedConfig = cfg;\n    },\n\n    configureServer(server) {\n      if (!enabled) return;\n\n      // Auto-load .env after server starts — guarantees resolvedConfig is available\n      // Falls back to immediate call in middleware mode where httpServer is null\n      if (server.httpServer) {\n        server.httpServer.once('listening', () => {\n          void loadEnv(resolvedConfig?.root ?? process.cwd());\n        });\n      } else {\n        // Middleware mode — httpServer is null, call immediately\n        void loadEnv(resolvedConfig?.root ?? process.cwd());\n      }\n\n      const originalPrintUrls = server.printUrls.bind(server);\n\n      server.printUrls = () => {\n        if (serverStarted) return;\n        serverStarted = true;\n\n        if (clearViteHeader) clearLine();\n        console.log(`\\n  ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (dev)`);\n\n        const found = detectEnvFiles(resolvedConfig?.root);\n        if (found.length > 0) {\n          const envString = found.map((f) => f.name).join(', ');\n          console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Environments: ${envString}`);\n        }\n\n        if (!clearViteHeader) {\n          originalPrintUrls();\n        } else {\n          printResolvedUrls(server.resolvedUrls);\n        }\n      };\n    },\n\n    configurePreviewServer(server) {\n      if (!enabled) return;\n\n      const originalPrintUrls = server.printUrls.bind(server);\n\n      server.printUrls = () => {\n        if (previewStarted) return;\n        previewStarted = true;\n\n        if (clearViteHeader) clearLine();\n        console.log(`\\n  ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (preview)`);\n\n        const found = detectEnvFiles(resolvedConfig?.root);\n        if (found.length > 0) {\n          const envString = found.map((f) => f.name).join(', ');\n          console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Environments: ${envString}`);\n        }\n\n        if (!clearViteHeader) {\n          originalPrintUrls();\n        } else {\n          printResolvedUrls(server.resolvedUrls);\n        }\n      };\n    },\n\n    buildEnd() {\n      serverStarted = false;\n      previewStarted = false;\n    },\n  };\n}\n\n// Named export: import { biniEnv } from 'bini-env'\nexport type { Plugin } from 'vite';"]}

package/dist/index.d.cts

@@ -5,37 +5,75 @@ interface BiniEnvPluginOptions {
     /**
      * Enable/disable the plugin
      * @default true
-     * @readonly
      */
     readonly enabled?: boolean;
     /**
      * Remove Vite's default header
      * @default true
-     * @readonly
      */
     readonly clearViteHeader?: boolean;
     /**
      * Custom logo/text to display
      * @default 'ß'
-     * @readonly
      */
     readonly logo?: string;
+    /**
+     * Override the env var prefix exposed to client code.
+     * Defaults to 'BINI_' — so BINI_MY_VAR is accessible via import.meta.env.BINI_MY_VAR
+     * Set to 'VITE_' to keep Vite's default behaviour.
+     * @default 'BINI_'
+     */
+    readonly envPrefix?: string;
 }
 interface DetectedEnvFile {
     readonly name: string;
     readonly path: string;
 }
 /**
- * Detect which .env files exist in project root
+ * Read an environment variable in any runtime.
+ *
+ * Priority order:
+ *  1. Deno.env       — Netlify edge functions / Deno runtime
+ *  2. process.env    — Node.js / Bun / bini-server
+ *  3. import.meta.env — Vite client (BINI_-prefixed vars)
+ *
+ * Usage in API routes:
+ *   import { getEnv } from 'bini-env';
+ *   const smtpUser = getEnv('SMTP_USER');
  */
-declare function detectEnvFiles(projectRoot?: string): DetectedEnvFile[];
+declare function getEnv(key: string): string | undefined;
+/**
+ * Read an environment variable and throw if it's missing or empty.
+ * Use this for required secrets so you get a clear error at startup
+ * instead of a cryptic crash later.
+ *
+ * Usage:
+ *   const smtpPass = requireEnv('SMTP_PASS');
+ */
+declare function requireEnv(key: string): string;
+/**
+ * Auto-load .env into process.env for Node.js API route contexts.
+ *
+ * Behaviour by environment:
+ *  - Deno (edge functions)  → no-op, Deno/Netlify injects env natively
+ *  - NODE_ENV=production    → no-op, host injects env vars automatically
+ *  - Node.js dev            → loads .env via dotenv (dynamic import, safe for bundlers)
+ *
+ * Called automatically by bini-env Vite plugin. You should not need to call this manually.
+ */
+declare function loadEnv(projectRoot?: string): Promise<void>;
 /**
- * Format environment files for console display
+ * Detect which .env files exist in the project root, in Vite's priority order.
  */
-declare function formatEnvFilesForDisplay(envFiles: DetectedEnvFile[]): string;
+declare function detectEnvFiles(projectRoot?: string): DetectedEnvFile[];
 /**
- * Main plugin function
+ * Bini.js Vite plugin.
+ *
+ * What it does:
+ *  - Sets envPrefix to 'BINI_' so client code uses import.meta.env.BINI_MY_VAR
+ *  - Auto-loads .env for API routes in dev via loadEnv()
+ *  - Replaces Vite's startup output with the Bini.js branded header
  */
-declare function biniEnvPlugin(options?: Readonly<BiniEnvPluginOptions>): Plugin;
+declare function biniEnv(options?: Readonly<BiniEnvPluginOptions>): Plugin;
 
-export { type BiniEnvPluginOptions, type DetectedEnvFile, biniEnvPlugin as default, detectEnvFiles, formatEnvFilesForDisplay };
+export { type BiniEnvPluginOptions, type DetectedEnvFile, biniEnv, detectEnvFiles, getEnv, loadEnv, requireEnv };

package/dist/index.d.ts

@@ -5,37 +5,75 @@ interface BiniEnvPluginOptions {
     /**
      * Enable/disable the plugin
      * @default true
-     * @readonly
      */
     readonly enabled?: boolean;
     /**
      * Remove Vite's default header
      * @default true
-     * @readonly
      */
     readonly clearViteHeader?: boolean;
     /**
      * Custom logo/text to display
      * @default 'ß'
-     * @readonly
      */
     readonly logo?: string;
+    /**
+     * Override the env var prefix exposed to client code.
+     * Defaults to 'BINI_' — so BINI_MY_VAR is accessible via import.meta.env.BINI_MY_VAR
+     * Set to 'VITE_' to keep Vite's default behaviour.
+     * @default 'BINI_'
+     */
+    readonly envPrefix?: string;
 }
 interface DetectedEnvFile {
     readonly name: string;
     readonly path: string;
 }
 /**
- * Detect which .env files exist in project root
+ * Read an environment variable in any runtime.
+ *
+ * Priority order:
+ *  1. Deno.env       — Netlify edge functions / Deno runtime
+ *  2. process.env    — Node.js / Bun / bini-server
+ *  3. import.meta.env — Vite client (BINI_-prefixed vars)
+ *
+ * Usage in API routes:
+ *   import { getEnv } from 'bini-env';
+ *   const smtpUser = getEnv('SMTP_USER');
  */
-declare function detectEnvFiles(projectRoot?: string): DetectedEnvFile[];
+declare function getEnv(key: string): string | undefined;
+/**
+ * Read an environment variable and throw if it's missing or empty.
+ * Use this for required secrets so you get a clear error at startup
+ * instead of a cryptic crash later.
+ *
+ * Usage:
+ *   const smtpPass = requireEnv('SMTP_PASS');
+ */
+declare function requireEnv(key: string): string;
+/**
+ * Auto-load .env into process.env for Node.js API route contexts.
+ *
+ * Behaviour by environment:
+ *  - Deno (edge functions)  → no-op, Deno/Netlify injects env natively
+ *  - NODE_ENV=production    → no-op, host injects env vars automatically
+ *  - Node.js dev            → loads .env via dotenv (dynamic import, safe for bundlers)
+ *
+ * Called automatically by bini-env Vite plugin. You should not need to call this manually.
+ */
+declare function loadEnv(projectRoot?: string): Promise<void>;
 /**
- * Format environment files for console display
+ * Detect which .env files exist in the project root, in Vite's priority order.
  */
-declare function formatEnvFilesForDisplay(envFiles: DetectedEnvFile[]): string;
+declare function detectEnvFiles(projectRoot?: string): DetectedEnvFile[];
 /**
- * Main plugin function
+ * Bini.js Vite plugin.
+ *
+ * What it does:
+ *  - Sets envPrefix to 'BINI_' so client code uses import.meta.env.BINI_MY_VAR
+ *  - Auto-loads .env for API routes in dev via loadEnv()
+ *  - Replaces Vite's startup output with the Bini.js branded header
  */
-declare function biniEnvPlugin(options?: Readonly<BiniEnvPluginOptions>): Plugin;
+declare function biniEnv(options?: Readonly<BiniEnvPluginOptions>): Plugin;
 
-export { type BiniEnvPluginOptions, type DetectedEnvFile, biniEnvPlugin as default, detectEnvFiles, formatEnvFilesForDisplay };
+export { type BiniEnvPluginOptions, type DetectedEnvFile, biniEnv, detectEnvFiles, getEnv, loadEnv, requireEnv };

package/dist/index.js

@@ -1,130 +1,170 @@
+import fs from 'fs';
+import path from 'path';
+
 // src/index.ts
-import fs from "fs";
-import path from "path";
 var BINI_LOGO = "\xDF";
+var DEFAULT_ENV_PREFIX = "BINI_";
 var DEFAULT_OPTIONS = {
   enabled: true,
   clearViteHeader: true,
-  logo: BINI_LOGO
+  logo: BINI_LOGO,
+  envPrefix: DEFAULT_ENV_PREFIX
 };
 var COLORS = {
   CYAN: "\x1B[36m",
   RESET: "\x1B[0m",
-  GREEN: "\x1B[32m",
-  YELLOW: "\x1B[33m",
-  DIM: "\x1B[2m"
+  GREEN: "\x1B[32m"
 };
+function getEnv(key) {
+  const deno = globalThis.Deno;
+  if (deno) {
+    try {
+      const val = deno.env.get(key);
+      if (val !== void 0) return val;
+    } catch {
+    }
+  }
+  if (typeof process !== "undefined" && process.env) {
+    if (process.env[key] !== void 0) return process.env[key];
+  }
+  try {
+    const metaEnv = import.meta.env;
+    if (metaEnv) {
+      if (metaEnv[key] !== void 0) return metaEnv[key];
+      if (metaEnv[`BINI_${key}`] !== void 0) return metaEnv[`BINI_${key}`];
+    }
+  } catch {
+  }
+  return void 0;
+}
+function requireEnv(key) {
+  const val = getEnv(key);
+  if (!val) {
+    throw new Error(
+      `[bini-env] Missing required environment variable: "${key}".
+  \u2192 In development: add it to your .env file.
+  \u2192 In production: add it to your hosting dashboard environment variables.`
+    );
+  }
+  return val;
+}
+var _envLoaded = false;
+async function loadEnv(projectRoot) {
+  if (_envLoaded) return;
+  if (globalThis.Deno) {
+    _envLoaded = true;
+    return;
+  }
+  if (typeof process === "undefined" || !process.env) {
+    _envLoaded = true;
+    return;
+  }
+  if (process.env.NODE_ENV === "production") {
+    _envLoaded = true;
+    return;
+  }
+  try {
+    const root = projectRoot ?? process.cwd();
+    const envPath = path.join(root, ".env");
+    if (!fs.existsSync(envPath)) {
+      _envLoaded = true;
+      return;
+    }
+    const dotenv = await import('dotenv');
+    dotenv.config({ path: envPath });
+  } catch {
+  }
+  _envLoaded = true;
+}
 function detectEnvFiles(projectRoot = process.cwd()) {
-  const nodeEnv = process.env.NODE_ENV || "development";
-  const envFiles = [
+  const nodeEnv = process.env.NODE_ENV ?? "development";
+  const candidates = [
     ".env.local",
     `.env.${nodeEnv}.local`,
     `.env.${nodeEnv}`,
     ".env"
   ];
   const found = [];
-  for (const file of envFiles) {
+  for (const file of candidates) {
     const filePath = path.join(projectRoot, file);
     if (fs.existsSync(filePath)) {
-      found.push({
-        name: file,
-        path: filePath
-      });
+      found.push({ name: file, path: filePath });
     }
   }
   return found;
 }
-function formatEnvFilesForDisplay(envFiles) {
-  if (envFiles.length === 0) {
-    return "";
-  }
-  const envString = envFiles.map((f) => f.name).join(", ");
-  return `${COLORS.GREEN}\u279C${COLORS.RESET} Environments: ${envString}`;
-}
 function clearLine() {
   process.stdout.write("\x1B[2K\r");
 }
-function biniEnvPlugin(options = {}) {
-  const resolvedOptions = Object.freeze({
-    ...DEFAULT_OPTIONS,
-    ...options
-  });
-  const { enabled, clearViteHeader, logo } = resolvedOptions;
-  let config;
-  let isPreviewMode = false;
+function printResolvedUrls(urls) {
+  if (!urls) return;
+  if (urls.local.length > 0)
+    console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);
+  if (urls.network.length > 0)
+    console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);
+}
+function biniEnv(options = {}) {
+  const resolvedOptions = Object.freeze({ ...DEFAULT_OPTIONS, ...options });
+  const { enabled, clearViteHeader, logo, envPrefix } = resolvedOptions;
+  let resolvedConfig;
   let serverStarted = false;
   let previewStarted = false;
   return {
     name: "vite-plugin-bini-env",
     apply: "serve",
-    configResolved(resolvedConfig) {
-      config = resolvedConfig;
-      if (resolvedConfig.command === "serve") {
-        isPreviewMode = process.env.VITE_PREVIEW === "true" || process.argv.includes("preview") || false;
-      }
+    // Set BINI_ as the env prefix so import.meta.env.BINI_* works in client code
+    config() {
+      return { envPrefix };
+    },
+    configResolved(cfg) {
+      resolvedConfig = cfg;
     },
     configureServer(server) {
       if (!enabled) return;
-      const originalPrintUrls = server.printUrls;
+      if (server.httpServer) {
+        server.httpServer.once("listening", () => {
+          void loadEnv(resolvedConfig?.root ?? process.cwd());
+        });
+      } else {
+        void loadEnv(resolvedConfig?.root ?? process.cwd());
+      }
+      const originalPrintUrls = server.printUrls.bind(server);
       server.printUrls = () => {
-        if (!serverStarted) {
-          serverStarted = true;
-          if (clearViteHeader) {
-            clearLine();
-          }
-          console.log(`
+        if (serverStarted) return;
+        serverStarted = true;
+        if (clearViteHeader) clearLine();
+        console.log(`
   ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (dev)`);
-          const found = detectEnvFiles(config.root);
-          if (found.length > 0) {
-            const envString = found.map((f) => f.name).join(", ");
-            console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Environments: ${envString}`);
-          }
-          if (!clearViteHeader) {
-            originalPrintUrls.call(server);
-          } else {
-            const urls = server.resolvedUrls;
-            if (urls) {
-              if (urls.local.length > 0) {
-                console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);
-              }
-              if (urls.network.length > 0) {
-                console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);
-              }
-            }
-          }
+        const found = detectEnvFiles(resolvedConfig?.root);
+        if (found.length > 0) {
+          const envString = found.map((f) => f.name).join(", ");
+          console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Environments: ${envString}`);
+        }
+        if (!clearViteHeader) {
+          originalPrintUrls();
+        } else {
+          printResolvedUrls(server.resolvedUrls);
         }
       };
     },
     configurePreviewServer(server) {
       if (!enabled) return;
-      isPreviewMode = true;
-      const originalPrintUrls = server.printUrls;
+      const originalPrintUrls = server.printUrls.bind(server);
       server.printUrls = () => {
-        if (!previewStarted) {
-          previewStarted = true;
-          if (clearViteHeader) {
-            clearLine();
-          }
-          console.log(`
+        if (previewStarted) return;
+        previewStarted = true;
+        if (clearViteHeader) clearLine();
+        console.log(`
   ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (preview)`);
-          const found = detectEnvFiles(config.root);
-          if (found.length > 0) {
-            const envString = found.map((f) => f.name).join(", ");
-            console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Environments: ${envString}`);
-          }
-          if (!clearViteHeader) {
-            originalPrintUrls.call(server);
-          } else {
-            const urls = server.resolvedUrls;
-            if (urls) {
-              if (urls.local.length > 0) {
-                console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);
-              }
-              if (urls.network.length > 0) {
-                console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);
-              }
-            }
-          }
+        const found = detectEnvFiles(resolvedConfig?.root);
+        if (found.length > 0) {
+          const envString = found.map((f) => f.name).join(", ");
+          console.log(`  ${COLORS.GREEN}\u279C${COLORS.RESET}  Environments: ${envString}`);
+        }
+        if (!clearViteHeader) {
+          originalPrintUrls();
+        } else {
+          printResolvedUrls(server.resolvedUrls);
         }
       };
     },
@@ -134,9 +174,7 @@ function biniEnvPlugin(options = {}) {
     }
   };
 }
-export {
-  biniEnvPlugin as default,
-  detectEnvFiles,
-  formatEnvFilesForDisplay
-};
+
+export { biniEnv, detectEnvFiles, getEnv, loadEnv, requireEnv };
+//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// src/index.ts\r\nimport fs from 'fs';\r\nimport path from 'path';\r\nimport type { Plugin, ResolvedConfig } from 'vite';\r\n\r\n// Types\r\nexport interface BiniEnvPluginOptions {\r\n  /**\r\n   * Enable/disable the plugin\r\n   * @default true\r\n   * @readonly\r\n   */\r\n  readonly enabled?: boolean;\r\n  \r\n  /**\r\n   * Remove Vite's default header\r\n   * @default true\r\n   * @readonly\r\n   */\r\n  readonly clearViteHeader?: boolean;\r\n  \r\n  /**\r\n   * Custom logo/text to display\r\n   * @default 'ß'\r\n   * @readonly\r\n   */\r\n  readonly logo?: string;\r\n}\r\n\r\nexport interface DetectedEnvFile {\r\n  readonly name: string;\r\n  readonly path: string;\r\n}\r\n\r\n// Constants\r\nconst BINI_LOGO = 'ß' as const;\r\nconst DEFAULT_OPTIONS = {\r\n  enabled: true,\r\n  clearViteHeader: true,\r\n  logo: BINI_LOGO,\r\n} as const;\r\n\r\n// Color definitions\r\nconst COLORS = {\r\n  CYAN: '\\x1b[36m',\r\n  RESET: '\\x1b[0m',\r\n  GREEN: '\\x1b[32m',\r\n  YELLOW: '\\x1b[33m',\r\n  DIM: '\\x1b[2m'\r\n} as const;\r\n\r\n/**\r\n * Detect which .env files exist in project root\r\n */\r\nexport function detectEnvFiles(projectRoot: string = process.cwd()): DetectedEnvFile[] {\r\n  const nodeEnv = process.env.NODE_ENV || 'development';\r\n\r\n  const envFiles = [\r\n    '.env.local',\r\n    `.env.${nodeEnv}.local`,\r\n    `.env.${nodeEnv}`,\r\n    '.env'\r\n  ] as const;\r\n\r\n  const found: DetectedEnvFile[] = [];\r\n\r\n  for (const file of envFiles) {\r\n    const filePath = path.join(projectRoot, file);\r\n    if (fs.existsSync(filePath)) {\r\n      found.push({\r\n        name: file,\r\n        path: filePath\r\n      });\r\n    }\r\n  }\r\n\r\n  return found;\r\n}\r\n\r\n/**\r\n * Format environment files for console display\r\n */\r\nexport function formatEnvFilesForDisplay(envFiles: DetectedEnvFile[]): string {\r\n  if (envFiles.length === 0) {\r\n    return '';\r\n  }\r\n\r\n  const envString = envFiles.map(f => f.name).join(', ');\r\n  return `${COLORS.GREEN}➜${COLORS.RESET} Environments: ${envString}`;\r\n}\r\n\r\n/**\r\n * Clear the current line in console\r\n */\r\nfunction clearLine(): void {\r\n  process.stdout.write('\\x1b[2K\\r');\r\n}\r\n\r\n/**\r\n * Main plugin function\r\n */\r\nexport default function biniEnvPlugin(options: Readonly<BiniEnvPluginOptions> = {}): Plugin {\r\n  // Merge with defaults — user cannot override core behaviour\r\n  const resolvedOptions = Object.freeze({\r\n    ...DEFAULT_OPTIONS,\r\n    ...options,\r\n  });\r\n\r\n  const { enabled, clearViteHeader, logo } = resolvedOptions;\r\n\r\n  let config: ResolvedConfig;\r\n  let isPreviewMode = false;\r\n  let serverStarted = false;\r\n  let previewStarted = false;\r\n\r\n  return {\r\n    name: 'vite-plugin-bini-env',\r\n    \r\n    apply: 'serve',\r\n    \r\n    configResolved(resolvedConfig: ResolvedConfig) {\r\n      config = resolvedConfig;\r\n      \r\n      if (resolvedConfig.command === 'serve') {\r\n        isPreviewMode = process.env.VITE_PREVIEW === 'true' || \r\n                       process.argv.includes('preview') ||\r\n                       false;\r\n      }\r\n    },\r\n\r\n    configureServer(server) {\r\n      if (!enabled) return;\r\n\r\n      const originalPrintUrls = server.printUrls;\r\n      \r\n      server.printUrls = () => {\r\n        if (!serverStarted) {\r\n          serverStarted = true;\r\n          \r\n          if (clearViteHeader) {\r\n            clearLine();\r\n          }\r\n          \r\n          console.log(`\\n  ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (dev)`);\r\n\r\n          const found = detectEnvFiles(config.root);\r\n          if (found.length > 0) {\r\n            const envString = found.map(f => f.name).join(', ');\r\n            console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Environments: ${envString}`);\r\n          }\r\n          \r\n          if (!clearViteHeader) {\r\n            originalPrintUrls.call(server);\r\n          } else {\r\n            const urls = server.resolvedUrls;\r\n            if (urls) {\r\n              if (urls.local.length > 0) {\r\n                console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);\r\n              }\r\n              if (urls.network.length > 0) {\r\n                console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);\r\n              }\r\n            }\r\n          }\r\n        }\r\n      };\r\n    },\r\n\r\n    configurePreviewServer(server) {\r\n      if (!enabled) return;\r\n      \r\n      isPreviewMode = true;\r\n      \r\n      const originalPrintUrls = server.printUrls;\r\n      \r\n      server.printUrls = () => {\r\n        if (!previewStarted) {\r\n          previewStarted = true;\r\n          \r\n          if (clearViteHeader) {\r\n            clearLine();\r\n          }\r\n          \r\n          console.log(`\\n  ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (preview)`);\r\n\r\n          const found = detectEnvFiles(config.root);\r\n          if (found.length > 0) {\r\n            const envString = found.map(f => f.name).join(', ');\r\n            console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Environments: ${envString}`);\r\n          }\r\n          \r\n          if (!clearViteHeader) {\r\n            originalPrintUrls.call(server);\r\n          } else {\r\n            const urls = server.resolvedUrls;\r\n            if (urls) {\r\n              if (urls.local.length > 0) {\r\n                console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);\r\n              }\r\n              if (urls.network.length > 0) {\r\n                console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);\r\n              }\r\n            }\r\n          }\r\n        }\r\n      };\r\n    },\r\n\r\n    buildEnd() {\r\n      serverStarted = false;\r\n      previewStarted = false;\r\n    }\r\n  };\r\n}\r\n\r\nexport type { Plugin } from 'vite';"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// src/index.ts\nimport fs from 'fs';\nimport path from 'path';\nimport type { Plugin, ResolvedConfig, UserConfig } from 'vite';\n\n/* ==========================================================================\n   Global type declarations for cross-runtime compatibility\n   ========================================================================== */\n\n// Deno runtime type — declared as an interface so we can safely cast\n// without relying on a global that TypeScript doesn't know about\ninterface DenoEnv {\n  get(key: string): string | undefined;\n  toObject(): Record<string, string>;\n}\ninterface DenoNamespace {\n  env: DenoEnv;\n}\n\n// Vite augments ImportMeta with .env\n// Using triple-slash reference so it works both inside and outside Vite projects\n/// <reference types=\"vite/client\" />\n\n/* ==========================================================================\n   Types\n   ========================================================================== */\n\nexport interface BiniEnvPluginOptions {\n  /**\n   * Enable/disable the plugin\n   * @default true\n   */\n  readonly enabled?: boolean;\n\n  /**\n   * Remove Vite's default header\n   * @default true\n   */\n  readonly clearViteHeader?: boolean;\n\n  /**\n   * Custom logo/text to display\n   * @default 'ß'\n   */\n  readonly logo?: string;\n\n  /**\n   * Override the env var prefix exposed to client code.\n   * Defaults to 'BINI_' — so BINI_MY_VAR is accessible via import.meta.env.BINI_MY_VAR\n   * Set to 'VITE_' to keep Vite's default behaviour.\n   * @default 'BINI_'\n   */\n  readonly envPrefix?: string;\n}\n\nexport interface DetectedEnvFile {\n  readonly name: string;\n  readonly path: string;\n}\n\n/* ==========================================================================\n   Constants\n   ========================================================================== */\n\nconst BINI_LOGO = 'ß' as const;\nconst DEFAULT_ENV_PREFIX = 'BINI_' as const;\n\nconst DEFAULT_OPTIONS = {\n  enabled: true,\n  clearViteHeader: true,\n  logo: BINI_LOGO,\n  envPrefix: DEFAULT_ENV_PREFIX,\n} as const;\n\nconst COLORS = {\n  CYAN: '\\x1b[36m',\n  RESET: '\\x1b[0m',\n  GREEN: '\\x1b[32m',\n} as const;\n\n/* ==========================================================================\n   getEnv — Universal env var accessor\n   Works in: Node.js, Deno (edge functions), Bun, Vite client\n   ========================================================================== */\n\n/**\n * Read an environment variable in any runtime.\n *\n * Priority order:\n *  1. Deno.env       — Netlify edge functions / Deno runtime\n *  2. process.env    — Node.js / Bun / bini-server\n *  3. import.meta.env — Vite client (BINI_-prefixed vars)\n *\n * Usage in API routes:\n *   import { getEnv } from 'bini-env';\n *   const smtpUser = getEnv('SMTP_USER');\n */\nexport function getEnv(key: string): string | undefined {\n  // 1. Deno runtime (Netlify edge functions)\n  const deno = (globalThis as unknown as { Deno?: DenoNamespace }).Deno;\n  if (deno) {\n    try {\n      const val = deno.env.get(key);\n      if (val !== undefined) return val;\n    } catch {\n      // Deno env access denied — fall through\n    }\n  }\n\n  // 2. Node.js / Bun / bini-server\n  if (typeof process !== 'undefined' && process.env) {\n    if (process.env[key] !== undefined) return process.env[key];\n  }\n\n  // 3. Vite injected (import.meta.env) — BINI_-prefixed client vars\n  // Wrapped in try/catch because import.meta.env doesn't exist in Node/Deno\n  try {\n    const metaEnv = import.meta.env as Record<string, string | undefined> | undefined;\n    if (metaEnv) {\n      if (metaEnv[key] !== undefined) return metaEnv[key];\n      // Try with BINI_ prefix automatically\n      if (metaEnv[`BINI_${key}`] !== undefined) return metaEnv[`BINI_${key}`];\n    }\n  } catch {\n    // import.meta.env not available in this runtime — ignore\n  }\n\n  return undefined;\n}\n\n/**\n * Read an environment variable and throw if it's missing or empty.\n * Use this for required secrets so you get a clear error at startup\n * instead of a cryptic crash later.\n *\n * Usage:\n *   const smtpPass = requireEnv('SMTP_PASS');\n */\nexport function requireEnv(key: string): string {\n  const val = getEnv(key);\n  if (!val) {\n    throw new Error(\n      `[bini-env] Missing required environment variable: \"${key}\".\\n` +\n      `  → In development: add it to your .env file.\\n` +\n      `  → In production: add it to your hosting dashboard environment variables.`\n    );\n  }\n  return val;\n}\n\n/* ==========================================================================\n   loadEnv — Auto dotenv loader for bini-router API routes (Node.js only)\n   Called internally by the Vite plugin. Safe to call multiple times.\n   ========================================================================== */\n\nlet _envLoaded = false;\n\n/**\n * Auto-load .env into process.env for Node.js API route contexts.\n *\n * Behaviour by environment:\n *  - Deno (edge functions)  → no-op, Deno/Netlify injects env natively\n *  - NODE_ENV=production    → no-op, host injects env vars automatically\n *  - Node.js dev            → loads .env via dotenv (dynamic import, safe for bundlers)\n *\n * Called automatically by bini-env Vite plugin. You should not need to call this manually.\n */\nexport async function loadEnv(projectRoot?: string): Promise<void> {\n  // Already loaded — skip\n  if (_envLoaded) return;\n\n  // Deno runtime — env is handled natively, skip\n  if ((globalThis as unknown as { Deno?: DenoNamespace }).Deno) {\n    _envLoaded = true;\n    return;\n  }\n\n  // Not in a Node-like runtime — skip\n  if (typeof process === 'undefined' || !process.env) {\n    _envLoaded = true;\n    return;\n  }\n\n  // Production — host injects env vars, dotenv not needed\n  if (process.env.NODE_ENV === 'production') {\n    _envLoaded = true;\n    return;\n  }\n\n  try {\n    const root = projectRoot ?? process.cwd();\n    const envPath = path.join(root, '.env');\n\n    if (!fs.existsSync(envPath)) {\n      _envLoaded = true;\n      return;\n    }\n\n    // Dynamic import so Deno/edge bundlers never try to statically resolve dotenv\n    const dotenv = await import('dotenv');\n    dotenv.config({ path: envPath });\n  } catch {\n    // dotenv not installed or read failed — silently skip.\n    // requireEnv() will surface clear errors if vars are missing when used.\n  }\n\n  _envLoaded = true;\n}\n\n/* ==========================================================================\n   detectEnvFiles — used by the Vite plugin display\n   ========================================================================== */\n\n/**\n * Detect which .env files exist in the project root, in Vite's priority order.\n */\nexport function detectEnvFiles(projectRoot: string = process.cwd()): DetectedEnvFile[] {\n  const nodeEnv = process.env.NODE_ENV ?? 'development';\n\n  const candidates = [\n    '.env.local',\n    `.env.${nodeEnv}.local`,\n    `.env.${nodeEnv}`,\n    '.env',\n  ] as const;\n\n  const found: DetectedEnvFile[] = [];\n\n  for (const file of candidates) {\n    const filePath = path.join(projectRoot, file);\n    if (fs.existsSync(filePath)) {\n      found.push({ name: file, path: filePath });\n    }\n  }\n\n  return found;\n}\n\n/* ==========================================================================\n   Vite plugin\n   ========================================================================== */\n\nfunction clearLine(): void {\n  process.stdout.write('\\x1b[2K\\r');\n}\n\nfunction printResolvedUrls(urls: { local: string[]; network: string[] } | null | undefined): void {\n  if (!urls) return;\n  if (urls.local.length > 0)\n    console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Local:   ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);\n  if (urls.network.length > 0)\n    console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);\n}\n\n/**\n * Bini.js Vite plugin.\n *\n * What it does:\n *  - Sets envPrefix to 'BINI_' so client code uses import.meta.env.BINI_MY_VAR\n *  - Auto-loads .env for API routes in dev via loadEnv()\n *  - Replaces Vite's startup output with the Bini.js branded header\n */\nexport function biniEnv(options: Readonly<BiniEnvPluginOptions> = {}): Plugin {\n  const resolvedOptions = Object.freeze({ ...DEFAULT_OPTIONS, ...options });\n  const { enabled, clearViteHeader, logo, envPrefix } = resolvedOptions;\n\n  let resolvedConfig: ResolvedConfig;\n  let serverStarted = false;\n  let previewStarted = false;\n\n  return {\n    name: 'vite-plugin-bini-env',\n\n    apply: 'serve',\n\n    // Set BINI_ as the env prefix so import.meta.env.BINI_* works in client code\n    config(): UserConfig {\n      return { envPrefix };\n    },\n\n    configResolved(cfg: ResolvedConfig) {\n      resolvedConfig = cfg;\n    },\n\n    configureServer(server) {\n      if (!enabled) return;\n\n      // Auto-load .env after server starts — guarantees resolvedConfig is available\n      // Falls back to immediate call in middleware mode where httpServer is null\n      if (server.httpServer) {\n        server.httpServer.once('listening', () => {\n          void loadEnv(resolvedConfig?.root ?? process.cwd());\n        });\n      } else {\n        // Middleware mode — httpServer is null, call immediately\n        void loadEnv(resolvedConfig?.root ?? process.cwd());\n      }\n\n      const originalPrintUrls = server.printUrls.bind(server);\n\n      server.printUrls = () => {\n        if (serverStarted) return;\n        serverStarted = true;\n\n        if (clearViteHeader) clearLine();\n        console.log(`\\n  ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (dev)`);\n\n        const found = detectEnvFiles(resolvedConfig?.root);\n        if (found.length > 0) {\n          const envString = found.map((f) => f.name).join(', ');\n          console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Environments: ${envString}`);\n        }\n\n        if (!clearViteHeader) {\n          originalPrintUrls();\n        } else {\n          printResolvedUrls(server.resolvedUrls);\n        }\n      };\n    },\n\n    configurePreviewServer(server) {\n      if (!enabled) return;\n\n      const originalPrintUrls = server.printUrls.bind(server);\n\n      server.printUrls = () => {\n        if (previewStarted) return;\n        previewStarted = true;\n\n        if (clearViteHeader) clearLine();\n        console.log(`\\n  ${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (preview)`);\n\n        const found = detectEnvFiles(resolvedConfig?.root);\n        if (found.length > 0) {\n          const envString = found.map((f) => f.name).join(', ');\n          console.log(`  ${COLORS.GREEN}➜${COLORS.RESET}  Environments: ${envString}`);\n        }\n\n        if (!clearViteHeader) {\n          originalPrintUrls();\n        } else {\n          printResolvedUrls(server.resolvedUrls);\n        }\n      };\n    },\n\n    buildEnd() {\n      serverStarted = false;\n      previewStarted = false;\n    },\n  };\n}\n\n// Named export: import { biniEnv } from 'bini-env'\nexport type { Plugin } from 'vite';"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bini-env",
-  "version": "1.0.3",
-  "description": "Vite plugin for Bini.js environment display",
+  "version": "1.0.6",
+  "description": "Universal environment variable loader and Vite plugin for Bini.js — works in Node.js, Deno, Bun, and Vite edge functions",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -17,25 +17,45 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
   "keywords": [
     "vite",
     "vite-plugin",
-    "bini.js",
     "bini",
+    "bini-js",
+    "bini.js",
     "environment",
     "env",
-    "dotenv"
+    "dotenv",
+    "deno",
+    "edge-functions",
+    "cross-runtime"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Binidu01/Bini-Env.git"
+  },
+  "homepage": "https://github.com/Binidu01/Bini-Env#readme",
+  "bugs": {
+    "url": "https://github.com/Binidu01/Bini-Env/issues"
+  },
   "author": "Bini.js Team",
   "license": "MIT",
   "peerDependencies": {
-    "vite": "^2.0.0 || ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0"
+    "vite": ">=7.0.0"
+  },
+  "dependencies": {
+    "dotenv": "^17.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.15.3",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
-    "vite": "^6.3.4"
+    "vite": "^7.3.1"
   },
   "tsup": {
     "entry": [
@@ -49,13 +69,14 @@
     "clean": true,
     "splitting": false,
     "sourcemap": true,
-    "minify": false
+    "minify": false,
+    "external": [
+      "vite",
+      "fs",
+      "path"
+    ]
   },
   "engines": {
     "node": ">=18.0.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
   }
 }

package/Readme.md

@@ -1,135 +0,0 @@
-# bini-env
-
-![npm](https://img.shields.io/npm/v/bini-env?color=cyan&style=flat-square)
-![npm downloads](https://img.shields.io/npm/dm/bini-env?style=flat-square)
-![license](https://img.shields.io/npm/l/bini-env?style=flat-square)
-![vite](https://img.shields.io/badge/vite-plugin-646CFF?style=flat-square&logo=vite)
-![typescript](https://img.shields.io/badge/TypeScript-ready-3178C6?style=flat-square&logo=typescript)
-
-A lightweight Vite plugin that enhances your dev and preview server output with a clean startup banner and detected `.env` files.
-
-## Features
-
-- Replaces Vite's default header with a clean custom banner
-- Automatically detects and displays active `.env` files
-- Supports `dev` and `preview` modes
-- Fully customizable logo and behavior
-
-## Installation
-```bash
-npm install bini-env --save-dev
-# or
-pnpm add -D bini-env
-# or
-yarn add -D bini-env
-```
-
-## Usage
-```ts
-// vite.config.ts
-import { defineConfig } from 'vite';
-import biniEnv from 'bini-env';
-
-export default defineConfig({
-  plugins: [biniEnv()]
-});
-```
-
-## Output Example
-
-**Dev mode**
-```
-  ß Bini.js (dev)
-  ➜  Environments: .env.local, .env
-  ➜  Local:   http://localhost:5173/
-  ➜  Network: http://192.168.1.10:5173/
-```
-
-**Preview mode**
-```
-  ß Bini.js (preview)
-  ➜  Environments: .env.local, .env
-  ➜  Local:   http://localhost:4173/
-  ➜  Network: http://192.168.1.10:4173/
-```
-
-## Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `enabled` | `boolean` | `true` | Enable or disable the plugin |
-| `clearViteHeader` | `boolean` | `true` | Replace Vite's default startup header |
-| `logo` | `string` | `'ß'` | Custom logo or text shown in the banner |
-
-### Example with options
-```ts
-biniEnv({
-  logo: '🚀',
-  clearViteHeader: true,
-})
-```
-
-## Detected `.env` Files
-
-The plugin checks for the following files in your project root (in priority order):
-
-1. `.env.local`
-2. `.env.[NODE_ENV].local`
-3. `.env.[NODE_ENV]`
-4. `.env`
-
-Any files found are displayed in the banner on startup.
-
-## Modes
-
-| Mode | Trigger | Banner |
-|------|---------|--------|
-| Development | `vite dev` | `ß Bini.js (dev)` |
-| Preview | `vite preview` | `ß Bini.js (preview)` |
-
-> **Note:** `bini-env` is a server-only plugin (`apply: 'serve'`) and does not run during `vite build`.
-
-## API
-
-The following utilities are exported for use outside of the plugin if needed.
-
-### `detectEnvFiles(projectRoot?: string): DetectedEnvFile[]`
-
-Scans a directory for `.env` files and returns an array of matches.
-```ts
-import { detectEnvFiles } from 'bini-env';
-
-const files = detectEnvFiles('/my/project');
-// [{ name: '.env.local', path: '/my/project/.env.local' }, ...]
-```
-
-Defaults to `process.cwd()` if no path is provided.
-
-### `formatEnvFilesForDisplay(envFiles: DetectedEnvFile[]): string`
-
-Formats a list of detected env files into a display-ready console string.
-```ts
-import { detectEnvFiles, formatEnvFilesForDisplay } from 'bini-env';
-
-const files = detectEnvFiles();
-console.log(formatEnvFilesForDisplay(files));
-// ➜ Environments: .env
-```
-
-## Types
-```ts
-interface BiniEnvPluginOptions {
-  enabled?: boolean;
-  clearViteHeader?: boolean;
-  logo?: string;
-}
-
-interface DetectedEnvFile {
-  name: string;
-  path: string;
-}
-```
-
-## License
-
-MIT