bini-env 1.0.6 → 1.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +152 -126
- package/dist/index.d.mts +37 -0
- package/dist/index.d.ts +10 -52
- package/dist/index.js +166 -100
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +235 -0
- package/dist/index.mjs.map +1 -0
- package/package.json +31 -19
- package/dist/index.cjs +0 -191
- package/dist/index.cjs.map +0 -1
- package/dist/index.d.cts +0 -79
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","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\ninterface DenoEnv {\n get(key: string): string | undefined;\n toObject(): Record<string, string>;\n}\ninterface DenoNamespace {\n env: DenoEnv;\n}\n\n/// <reference types=\"vite/client\" />\n\n/* ==========================================================================\n Types\n ========================================================================== */\n\nexport interface BiniEnvPluginOptions {\n readonly enabled?: boolean;\n readonly clearViteHeader?: boolean;\n readonly logo?: string;\n readonly envPrefix?: string | string[];\n}\n\nexport interface DetectedEnvFile {\n readonly name: string;\n readonly path: string;\n}\n\n/* ==========================================================================\n Constants - Optimized with Object.freeze for immutability\n ========================================================================== */\n\nconst BINI_LOGO = 'ß';\nconst DEFAULT_ENV_PREFIX: string[] = ['BINI_', 'VITE_'];\n\nconst DEFAULT_OPTIONS: Required<BiniEnvPluginOptions> = Object.freeze({\n enabled: true,\n clearViteHeader: true,\n logo: BINI_LOGO,\n envPrefix: DEFAULT_ENV_PREFIX,\n});\n\n// ANSI color codes - using const enum for better performance\nconst enum COLORS {\n CYAN = '\\x1b[36m',\n RESET = '\\x1b[0m',\n GREEN = '\\x1b[32m',\n}\n\n// Cache for environment variables to avoid repeated lookups\nconst envCache = new Map<string, string | undefined>();\n\n/* ==========================================================================\n Optimized getEnv with caching\n ========================================================================== */\n\n/**\n * Read an environment variable with caching for performance.\n * Cache is cleared on module reload in development only.\n */\nexport function getEnv(key: string): string | undefined {\n // Check cache first for frequent access patterns\n if (envCache.has(key)) {\n return envCache.get(key);\n }\n\n let value: string | undefined;\n\n // 1. Deno runtime (edge functions)\n const deno = (globalThis as unknown as { Deno?: DenoNamespace }).Deno;\n if (deno) {\n try {\n value = deno.env.get(key);\n if (value !== undefined) {\n envCache.set(key, value);\n return value;\n }\n } catch {\n // Silently fall through\n }\n }\n\n // 2. Node.js / Bun runtime\n if (typeof process !== 'undefined' && process.env) {\n value = process.env[key];\n if (value !== undefined) {\n envCache.set(key, value);\n return value;\n }\n }\n\n // 3. Vite client environment (with prefix fallback)\n try {\n const metaEnv = import.meta.env as Record<string, string | undefined> | undefined;\n if (metaEnv) {\n // Direct match\n if (metaEnv[key] !== undefined) {\n envCache.set(key, metaEnv[key]);\n return metaEnv[key];\n }\n \n // Try BINI_ prefix\n const biniKey = `BINI_${key}`;\n if (metaEnv[biniKey] !== undefined) {\n envCache.set(key, metaEnv[biniKey]);\n return metaEnv[biniKey];\n }\n \n // Try VITE_ prefix\n const viteKey = `VITE_${key}`;\n if (metaEnv[viteKey] !== undefined) {\n envCache.set(key, metaEnv[viteKey]);\n return metaEnv[viteKey];\n }\n }\n } catch {\n // import.meta.env not available\n }\n\n // Cache undefined to prevent repeated lookups\n envCache.set(key, undefined);\n return undefined;\n}\n\n/**\n * Optimized requireEnv with cached error messages\n */\nexport function requireEnv(key: string): string {\n const val = getEnv(key);\n if (!val) {\n // Create error message once\n const errorMsg = `[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 throw new Error(errorMsg);\n }\n return val;\n}\n\n/* ==========================================================================\n Optimized loadEnv with production checks\n ========================================================================== */\n\nlet _envLoaded = false;\nlet _loadPromise: Promise<void> | null = null;\n\n/**\n * Load .env file with memoization and race condition prevention\n */\nexport async function loadEnv(projectRoot?: string): Promise<void> {\n // Fast path: already loaded\n if (_envLoaded) return;\n \n // Prevent concurrent loads\n if (_loadPromise) {\n return _loadPromise;\n }\n\n _loadPromise = (async () => {\n try {\n // Deno runtime check - fast path\n if ((globalThis as unknown as { Deno?: DenoNamespace }).Deno) {\n _envLoaded = true;\n return;\n }\n\n // Node.js runtime check\n if (typeof process === 'undefined' || !process.env) {\n _envLoaded = true;\n return;\n }\n\n // Production optimization - skip file system operations entirely\n if (process.env.NODE_ENV === 'production') {\n _envLoaded = true;\n return;\n }\n\n const root = projectRoot ?? process.cwd();\n const envPath = path.join(root, '.env');\n\n // Check file existence with fs.promises for better performance\n try {\n await fs.promises.access(envPath, fs.constants.R_OK);\n } catch {\n _envLoaded = true;\n return;\n }\n\n // Dynamic import with caching\n const dotenv = await import('dotenv');\n dotenv.config({ path: envPath });\n \n // Clear cache after loading new env vars\n envCache.clear();\n } catch {\n // Silent fail - requireEnv will handle missing vars\n } finally {\n _envLoaded = true;\n _loadPromise = null;\n }\n })();\n\n return _loadPromise;\n}\n\n/* ==========================================================================\n Optimized detectEnvFiles with caching\n ========================================================================== */\n\nlet _envFilesCache: DetectedEnvFile[] | null = null;\nlet _cachedRoot: string = '';\n\nexport function detectEnvFiles(projectRoot: string = process.cwd()): DetectedEnvFile[] {\n // Cache results for the same root directory\n if (_envFilesCache && _cachedRoot === projectRoot) {\n return _envFilesCache;\n }\n\n const nodeEnv = process.env.NODE_ENV ?? 'development';\n const candidates = [\n '.env.local',\n `.env.${nodeEnv}.local`,\n `.env.${nodeEnv}`,\n '.env',\n ];\n\n const found: DetectedEnvFile[] = [];\n\n // Use for...of with early break if needed\n for (const file of candidates) {\n const filePath = path.join(projectRoot, file);\n try {\n if (fs.existsSync(filePath)) {\n found.push({ name: file, path: filePath });\n }\n } catch {\n // Skip files that can't be accessed\n }\n }\n\n // Cache the result\n _envFilesCache = found;\n _cachedRoot = projectRoot;\n \n return found;\n}\n\n/* ==========================================================================\n Optimized Vite plugin with minimal overhead\n ========================================================================== */\n\nfunction clearLine(): void {\n // Only write if stdout is a TTY (performance optimization)\n if (process.stdout.isTTY) {\n process.stdout.write('\\x1b[2K\\r');\n }\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 }\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/**\n * Production-ready Vite plugin with performance optimizations:\n * - Lazy loading\n * - Caching\n * - Minimal bundle impact\n * - No runtime overhead in production\n */\nexport function biniEnv(options: Readonly<BiniEnvPluginOptions> = {}): Plugin {\n // Fast path: disabled plugin returns no-op\n if (options.enabled === false) {\n return {\n name: 'vite-plugin-bini-env',\n // Minimal plugin that does nothing\n };\n }\n\n const resolvedOptions = { ...DEFAULT_OPTIONS, ...options };\n const { clearViteHeader, logo, envPrefix } = resolvedOptions;\n\n let resolvedConfig: ResolvedConfig;\n\n return {\n name: 'vite-plugin-bini-env',\n \n // Optimized config merge\n config(): UserConfig {\n return { envPrefix };\n },\n\n configResolved(cfg: ResolvedConfig) {\n resolvedConfig = cfg;\n },\n\n // Optimized server configuration with lazy loading\n configureServer(server) {\n // Defer env loading to avoid blocking server start\n const loadEnvTask = () => {\n void loadEnv(resolvedConfig?.root ?? process.cwd());\n };\n\n if (server.httpServer) {\n server.httpServer.once('listening', loadEnvTask);\n } else {\n // Use setImmediate for non-blocking execution\n setImmediate(loadEnvTask);\n }\n\n let serverStarted = false;\n const originalPrintUrls = server.printUrls.bind(server);\n\n // Only override printUrls if needed\n if (clearViteHeader || logo !== BINI_LOGO) {\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 // Only detect env files in development\n if (process.env.NODE_ENV !== 'production') {\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\n if (!clearViteHeader) {\n originalPrintUrls();\n } else {\n printResolvedUrls(server.resolvedUrls);\n }\n };\n }\n },\n\n // Preview server with same optimizations\n configurePreviewServer(server) {\n let previewStarted = false;\n const originalPrintUrls = server.printUrls.bind(server);\n\n if (clearViteHeader || logo !== BINI_LOGO) {\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 if (process.env.NODE_ENV !== 'production') {\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\n if (!clearViteHeader) {\n originalPrintUrls();\n } else {\n printResolvedUrls(server.resolvedUrls);\n }\n };\n }\n },\n };\n}\n\nexport type { Plugin } from 'vite';"]}
|
package/package.json
CHANGED
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bini-env",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.7",
|
|
4
4
|
"description": "Universal environment variable loader and Vite plugin for Bini.js — works in Node.js, Deno, Bun, and Vite edge functions",
|
|
5
5
|
"main": "./dist/index.cjs",
|
|
6
6
|
"module": "./dist/index.js",
|
|
7
7
|
"types": "./dist/index.d.ts",
|
|
8
|
-
"type": "module",
|
|
9
8
|
"exports": {
|
|
10
9
|
".": {
|
|
11
10
|
"types": "./dist/index.d.ts",
|
|
@@ -15,12 +14,16 @@
|
|
|
15
14
|
},
|
|
16
15
|
"files": [
|
|
17
16
|
"dist",
|
|
18
|
-
"README.md"
|
|
17
|
+
"README.md",
|
|
18
|
+
"LICENSE"
|
|
19
19
|
],
|
|
20
|
+
"sideEffects": false,
|
|
20
21
|
"scripts": {
|
|
21
22
|
"build": "tsup",
|
|
22
23
|
"dev": "tsup --watch",
|
|
23
|
-
"prepublishOnly": "npm run build"
|
|
24
|
+
"prepublishOnly": "npm run build",
|
|
25
|
+
"test": "node --test",
|
|
26
|
+
"type-check": "tsc --noEmit"
|
|
24
27
|
},
|
|
25
28
|
"keywords": [
|
|
26
29
|
"vite",
|
|
@@ -33,11 +36,12 @@
|
|
|
33
36
|
"dotenv",
|
|
34
37
|
"deno",
|
|
35
38
|
"edge-functions",
|
|
36
|
-
"cross-runtime"
|
|
39
|
+
"cross-runtime",
|
|
40
|
+
"env-loader"
|
|
37
41
|
],
|
|
38
42
|
"repository": {
|
|
39
43
|
"type": "git",
|
|
40
|
-
"url": "https://github.com/Binidu01/Bini-Env.git"
|
|
44
|
+
"url": "git+https://github.com/Binidu01/Bini-Env.git"
|
|
41
45
|
},
|
|
42
46
|
"homepage": "https://github.com/Binidu01/Bini-Env#readme",
|
|
43
47
|
"bugs": {
|
|
@@ -46,7 +50,12 @@
|
|
|
46
50
|
"author": "Bini.js Team",
|
|
47
51
|
"license": "MIT",
|
|
48
52
|
"peerDependencies": {
|
|
49
|
-
"vite": ">=
|
|
53
|
+
"vite": ">=8.0.0"
|
|
54
|
+
},
|
|
55
|
+
"peerDependenciesMeta": {
|
|
56
|
+
"vite": {
|
|
57
|
+
"optional": false
|
|
58
|
+
}
|
|
50
59
|
},
|
|
51
60
|
"dependencies": {
|
|
52
61
|
"dotenv": "^17.3.1"
|
|
@@ -55,28 +64,31 @@
|
|
|
55
64
|
"@types/node": "^22.15.3",
|
|
56
65
|
"tsup": "^8.4.0",
|
|
57
66
|
"typescript": "^5.8.3",
|
|
58
|
-
"vite": "^
|
|
67
|
+
"vite": "^8.0.0"
|
|
59
68
|
},
|
|
60
69
|
"tsup": {
|
|
61
|
-
"entry": [
|
|
62
|
-
|
|
63
|
-
],
|
|
64
|
-
"format": [
|
|
65
|
-
"cjs",
|
|
66
|
-
"esm"
|
|
67
|
-
],
|
|
70
|
+
"entry": ["src/index.ts"],
|
|
71
|
+
"format": ["cjs", "esm"],
|
|
68
72
|
"dts": true,
|
|
69
73
|
"clean": true,
|
|
70
74
|
"splitting": false,
|
|
71
75
|
"sourcemap": true,
|
|
72
76
|
"minify": false,
|
|
77
|
+
"treeshake": true,
|
|
78
|
+
"shims": true,
|
|
73
79
|
"external": [
|
|
74
80
|
"vite",
|
|
75
|
-
"
|
|
76
|
-
|
|
77
|
-
]
|
|
81
|
+
"dotenv"
|
|
82
|
+
],
|
|
83
|
+
"noExternal": [],
|
|
84
|
+
"platform": "node",
|
|
85
|
+
"target": "node20"
|
|
78
86
|
},
|
|
79
87
|
"engines": {
|
|
80
|
-
"node": ">=
|
|
88
|
+
"node": ">=20.19.0 || >=22.12.0"
|
|
89
|
+
},
|
|
90
|
+
"publishConfig": {
|
|
91
|
+
"access": "public",
|
|
92
|
+
"registry": "https://registry.npmjs.org/"
|
|
81
93
|
}
|
|
82
94
|
}
|
package/dist/index.cjs
DELETED
|
@@ -1,191 +0,0 @@
|
|
|
1
|
-
'use strict';
|
|
2
|
-
|
|
3
|
-
var fs = require('fs');
|
|
4
|
-
var path = require('path');
|
|
5
|
-
|
|
6
|
-
function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
|
|
7
|
-
|
|
8
|
-
var fs__default = /*#__PURE__*/_interopDefault(fs);
|
|
9
|
-
var path__default = /*#__PURE__*/_interopDefault(path);
|
|
10
|
-
|
|
11
|
-
// src/index.ts
|
|
12
|
-
var BINI_LOGO = "\xDF";
|
|
13
|
-
var DEFAULT_ENV_PREFIX = "BINI_";
|
|
14
|
-
var DEFAULT_OPTIONS = {
|
|
15
|
-
enabled: true,
|
|
16
|
-
clearViteHeader: true,
|
|
17
|
-
logo: BINI_LOGO,
|
|
18
|
-
envPrefix: DEFAULT_ENV_PREFIX
|
|
19
|
-
};
|
|
20
|
-
var COLORS = {
|
|
21
|
-
CYAN: "\x1B[36m",
|
|
22
|
-
RESET: "\x1B[0m",
|
|
23
|
-
GREEN: "\x1B[32m"
|
|
24
|
-
};
|
|
25
|
-
function getEnv(key) {
|
|
26
|
-
const deno = globalThis.Deno;
|
|
27
|
-
if (deno) {
|
|
28
|
-
try {
|
|
29
|
-
const val = deno.env.get(key);
|
|
30
|
-
if (val !== void 0) return val;
|
|
31
|
-
} catch {
|
|
32
|
-
}
|
|
33
|
-
}
|
|
34
|
-
if (typeof process !== "undefined" && process.env) {
|
|
35
|
-
if (process.env[key] !== void 0) return process.env[key];
|
|
36
|
-
}
|
|
37
|
-
try {
|
|
38
|
-
const metaEnv = undefined;
|
|
39
|
-
if (metaEnv) {
|
|
40
|
-
if (metaEnv[key] !== void 0) return metaEnv[key];
|
|
41
|
-
if (metaEnv[`BINI_${key}`] !== void 0) return metaEnv[`BINI_${key}`];
|
|
42
|
-
}
|
|
43
|
-
} catch {
|
|
44
|
-
}
|
|
45
|
-
return void 0;
|
|
46
|
-
}
|
|
47
|
-
function requireEnv(key) {
|
|
48
|
-
const val = getEnv(key);
|
|
49
|
-
if (!val) {
|
|
50
|
-
throw new Error(
|
|
51
|
-
`[bini-env] Missing required environment variable: "${key}".
|
|
52
|
-
\u2192 In development: add it to your .env file.
|
|
53
|
-
\u2192 In production: add it to your hosting dashboard environment variables.`
|
|
54
|
-
);
|
|
55
|
-
}
|
|
56
|
-
return val;
|
|
57
|
-
}
|
|
58
|
-
var _envLoaded = false;
|
|
59
|
-
async function loadEnv(projectRoot) {
|
|
60
|
-
if (_envLoaded) return;
|
|
61
|
-
if (globalThis.Deno) {
|
|
62
|
-
_envLoaded = true;
|
|
63
|
-
return;
|
|
64
|
-
}
|
|
65
|
-
if (typeof process === "undefined" || !process.env) {
|
|
66
|
-
_envLoaded = true;
|
|
67
|
-
return;
|
|
68
|
-
}
|
|
69
|
-
if (process.env.NODE_ENV === "production") {
|
|
70
|
-
_envLoaded = true;
|
|
71
|
-
return;
|
|
72
|
-
}
|
|
73
|
-
try {
|
|
74
|
-
const root = projectRoot ?? process.cwd();
|
|
75
|
-
const envPath = path__default.default.join(root, ".env");
|
|
76
|
-
if (!fs__default.default.existsSync(envPath)) {
|
|
77
|
-
_envLoaded = true;
|
|
78
|
-
return;
|
|
79
|
-
}
|
|
80
|
-
const dotenv = await import('dotenv');
|
|
81
|
-
dotenv.config({ path: envPath });
|
|
82
|
-
} catch {
|
|
83
|
-
}
|
|
84
|
-
_envLoaded = true;
|
|
85
|
-
}
|
|
86
|
-
function detectEnvFiles(projectRoot = process.cwd()) {
|
|
87
|
-
const nodeEnv = process.env.NODE_ENV ?? "development";
|
|
88
|
-
const candidates = [
|
|
89
|
-
".env.local",
|
|
90
|
-
`.env.${nodeEnv}.local`,
|
|
91
|
-
`.env.${nodeEnv}`,
|
|
92
|
-
".env"
|
|
93
|
-
];
|
|
94
|
-
const found = [];
|
|
95
|
-
for (const file of candidates) {
|
|
96
|
-
const filePath = path__default.default.join(projectRoot, file);
|
|
97
|
-
if (fs__default.default.existsSync(filePath)) {
|
|
98
|
-
found.push({ name: file, path: filePath });
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
return found;
|
|
102
|
-
}
|
|
103
|
-
function clearLine() {
|
|
104
|
-
process.stdout.write("\x1B[2K\r");
|
|
105
|
-
}
|
|
106
|
-
function printResolvedUrls(urls) {
|
|
107
|
-
if (!urls) return;
|
|
108
|
-
if (urls.local.length > 0)
|
|
109
|
-
console.log(` ${COLORS.GREEN}\u279C${COLORS.RESET} Local: ${COLORS.CYAN}${urls.local[0]}${COLORS.RESET}`);
|
|
110
|
-
if (urls.network.length > 0)
|
|
111
|
-
console.log(` ${COLORS.GREEN}\u279C${COLORS.RESET} Network: ${COLORS.CYAN}${urls.network[0]}${COLORS.RESET}`);
|
|
112
|
-
}
|
|
113
|
-
function biniEnv(options = {}) {
|
|
114
|
-
const resolvedOptions = Object.freeze({ ...DEFAULT_OPTIONS, ...options });
|
|
115
|
-
const { enabled, clearViteHeader, logo, envPrefix } = resolvedOptions;
|
|
116
|
-
let resolvedConfig;
|
|
117
|
-
let serverStarted = false;
|
|
118
|
-
let previewStarted = false;
|
|
119
|
-
return {
|
|
120
|
-
name: "vite-plugin-bini-env",
|
|
121
|
-
apply: "serve",
|
|
122
|
-
// Set BINI_ as the env prefix so import.meta.env.BINI_* works in client code
|
|
123
|
-
config() {
|
|
124
|
-
return { envPrefix };
|
|
125
|
-
},
|
|
126
|
-
configResolved(cfg) {
|
|
127
|
-
resolvedConfig = cfg;
|
|
128
|
-
},
|
|
129
|
-
configureServer(server) {
|
|
130
|
-
if (!enabled) return;
|
|
131
|
-
if (server.httpServer) {
|
|
132
|
-
server.httpServer.once("listening", () => {
|
|
133
|
-
void loadEnv(resolvedConfig?.root ?? process.cwd());
|
|
134
|
-
});
|
|
135
|
-
} else {
|
|
136
|
-
void loadEnv(resolvedConfig?.root ?? process.cwd());
|
|
137
|
-
}
|
|
138
|
-
const originalPrintUrls = server.printUrls.bind(server);
|
|
139
|
-
server.printUrls = () => {
|
|
140
|
-
if (serverStarted) return;
|
|
141
|
-
serverStarted = true;
|
|
142
|
-
if (clearViteHeader) clearLine();
|
|
143
|
-
console.log(`
|
|
144
|
-
${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (dev)`);
|
|
145
|
-
const found = detectEnvFiles(resolvedConfig?.root);
|
|
146
|
-
if (found.length > 0) {
|
|
147
|
-
const envString = found.map((f) => f.name).join(", ");
|
|
148
|
-
console.log(` ${COLORS.GREEN}\u279C${COLORS.RESET} Environments: ${envString}`);
|
|
149
|
-
}
|
|
150
|
-
if (!clearViteHeader) {
|
|
151
|
-
originalPrintUrls();
|
|
152
|
-
} else {
|
|
153
|
-
printResolvedUrls(server.resolvedUrls);
|
|
154
|
-
}
|
|
155
|
-
};
|
|
156
|
-
},
|
|
157
|
-
configurePreviewServer(server) {
|
|
158
|
-
if (!enabled) return;
|
|
159
|
-
const originalPrintUrls = server.printUrls.bind(server);
|
|
160
|
-
server.printUrls = () => {
|
|
161
|
-
if (previewStarted) return;
|
|
162
|
-
previewStarted = true;
|
|
163
|
-
if (clearViteHeader) clearLine();
|
|
164
|
-
console.log(`
|
|
165
|
-
${COLORS.CYAN}${logo} Bini.js${COLORS.RESET} (preview)`);
|
|
166
|
-
const found = detectEnvFiles(resolvedConfig?.root);
|
|
167
|
-
if (found.length > 0) {
|
|
168
|
-
const envString = found.map((f) => f.name).join(", ");
|
|
169
|
-
console.log(` ${COLORS.GREEN}\u279C${COLORS.RESET} Environments: ${envString}`);
|
|
170
|
-
}
|
|
171
|
-
if (!clearViteHeader) {
|
|
172
|
-
originalPrintUrls();
|
|
173
|
-
} else {
|
|
174
|
-
printResolvedUrls(server.resolvedUrls);
|
|
175
|
-
}
|
|
176
|
-
};
|
|
177
|
-
},
|
|
178
|
-
buildEnd() {
|
|
179
|
-
serverStarted = false;
|
|
180
|
-
previewStarted = false;
|
|
181
|
-
}
|
|
182
|
-
};
|
|
183
|
-
}
|
|
184
|
-
|
|
185
|
-
exports.biniEnv = biniEnv;
|
|
186
|
-
exports.detectEnvFiles = detectEnvFiles;
|
|
187
|
-
exports.getEnv = getEnv;
|
|
188
|
-
exports.loadEnv = loadEnv;
|
|
189
|
-
exports.requireEnv = requireEnv;
|
|
190
|
-
//# sourceMappingURL=index.cjs.map
|
|
191
|
-
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"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
DELETED
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
import { Plugin } from 'vite';
|
|
2
|
-
export { Plugin } from 'vite';
|
|
3
|
-
|
|
4
|
-
interface BiniEnvPluginOptions {
|
|
5
|
-
/**
|
|
6
|
-
* Enable/disable the plugin
|
|
7
|
-
* @default true
|
|
8
|
-
*/
|
|
9
|
-
readonly enabled?: boolean;
|
|
10
|
-
/**
|
|
11
|
-
* Remove Vite's default header
|
|
12
|
-
* @default true
|
|
13
|
-
*/
|
|
14
|
-
readonly clearViteHeader?: boolean;
|
|
15
|
-
/**
|
|
16
|
-
* Custom logo/text to display
|
|
17
|
-
* @default 'ß'
|
|
18
|
-
*/
|
|
19
|
-
readonly logo?: string;
|
|
20
|
-
/**
|
|
21
|
-
* Override the env var prefix exposed to client code.
|
|
22
|
-
* Defaults to 'BINI_' — so BINI_MY_VAR is accessible via import.meta.env.BINI_MY_VAR
|
|
23
|
-
* Set to 'VITE_' to keep Vite's default behaviour.
|
|
24
|
-
* @default 'BINI_'
|
|
25
|
-
*/
|
|
26
|
-
readonly envPrefix?: string;
|
|
27
|
-
}
|
|
28
|
-
interface DetectedEnvFile {
|
|
29
|
-
readonly name: string;
|
|
30
|
-
readonly path: string;
|
|
31
|
-
}
|
|
32
|
-
/**
|
|
33
|
-
* Read an environment variable in any runtime.
|
|
34
|
-
*
|
|
35
|
-
* Priority order:
|
|
36
|
-
* 1. Deno.env — Netlify edge functions / Deno runtime
|
|
37
|
-
* 2. process.env — Node.js / Bun / bini-server
|
|
38
|
-
* 3. import.meta.env — Vite client (BINI_-prefixed vars)
|
|
39
|
-
*
|
|
40
|
-
* Usage in API routes:
|
|
41
|
-
* import { getEnv } from 'bini-env';
|
|
42
|
-
* const smtpUser = getEnv('SMTP_USER');
|
|
43
|
-
*/
|
|
44
|
-
declare function getEnv(key: string): string | undefined;
|
|
45
|
-
/**
|
|
46
|
-
* Read an environment variable and throw if it's missing or empty.
|
|
47
|
-
* Use this for required secrets so you get a clear error at startup
|
|
48
|
-
* instead of a cryptic crash later.
|
|
49
|
-
*
|
|
50
|
-
* Usage:
|
|
51
|
-
* const smtpPass = requireEnv('SMTP_PASS');
|
|
52
|
-
*/
|
|
53
|
-
declare function requireEnv(key: string): string;
|
|
54
|
-
/**
|
|
55
|
-
* Auto-load .env into process.env for Node.js API route contexts.
|
|
56
|
-
*
|
|
57
|
-
* Behaviour by environment:
|
|
58
|
-
* - Deno (edge functions) → no-op, Deno/Netlify injects env natively
|
|
59
|
-
* - NODE_ENV=production → no-op, host injects env vars automatically
|
|
60
|
-
* - Node.js dev → loads .env via dotenv (dynamic import, safe for bundlers)
|
|
61
|
-
*
|
|
62
|
-
* Called automatically by bini-env Vite plugin. You should not need to call this manually.
|
|
63
|
-
*/
|
|
64
|
-
declare function loadEnv(projectRoot?: string): Promise<void>;
|
|
65
|
-
/**
|
|
66
|
-
* Detect which .env files exist in the project root, in Vite's priority order.
|
|
67
|
-
*/
|
|
68
|
-
declare function detectEnvFiles(projectRoot?: string): DetectedEnvFile[];
|
|
69
|
-
/**
|
|
70
|
-
* Bini.js Vite plugin.
|
|
71
|
-
*
|
|
72
|
-
* What it does:
|
|
73
|
-
* - Sets envPrefix to 'BINI_' so client code uses import.meta.env.BINI_MY_VAR
|
|
74
|
-
* - Auto-loads .env for API routes in dev via loadEnv()
|
|
75
|
-
* - Replaces Vite's startup output with the Bini.js branded header
|
|
76
|
-
*/
|
|
77
|
-
declare function biniEnv(options?: Readonly<BiniEnvPluginOptions>): Plugin;
|
|
78
|
-
|
|
79
|
-
export { type BiniEnvPluginOptions, type DetectedEnvFile, biniEnv, detectEnvFiles, getEnv, loadEnv, requireEnv };
|