molex-env 0.1.1 → 0.2.2

package/README.md

@@ -22,11 +22,14 @@ npm install molex-env
 
 ## Quick start
 ```js
+// simplest usage
+require('molex-env').load();
+
+// more detailed usage
 const { load } = require('molex-env');
 
 const result = load({
   profile: 'prod',
-  export: true,
   strict: true,
   schema: {
     PORT: 'number',
@@ -37,6 +40,7 @@ const result = load({
 
 console.log(result.parsed.PORT);
 console.log(result.origins.SERVICE_URL);
+console.log(process.menv.PORT);
 ```
 
 ## Setup
@@ -72,8 +76,9 @@ Load, merge, parse, and validate .menv files.
 - schema: allowed keys, types, defaults, required
 - strict: reject unknown keys, duplicates, and invalid lines
 - cast: true | false | { boolean, number, json, date }
-- export: write values to process.env
+- exportEnv: write values to process.env
 - override: override existing process.env values
+- attach: attach parsed values to process.menv (default true)
 - freeze: deep-freeze parsed config (default true)
 - onWarning: function(info) for non-strict duplicates
 
@@ -166,6 +171,7 @@ load({ freeze: false });
 ## Notes
 - Use .menv.local for machine-specific values
 - Use strict mode to detect surprises early
+- Parsed values are attached to process.menv by default (disable with attach: false)
 
 ## Example project
 An example app is included in examples/basic.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "molex-env",
-  "version": "0.1.1",
+  "version": "0.2.2",
   "description": "Native .menv loader with profiles, typing, and origin tracking.",
   "main": "src/index.js",
   "files": [

package/src/index.js

@@ -3,17 +3,24 @@
 const { load, parse } = require('./lib/core');
 const { watch } = require('./lib/watch');
 
-module.exports = {
-    load,
+function loadEntry(options)
+{
+    return load(options);
+}
+
+/**
+ * Watch resolved .menv files and reload on change.
+ * @param {object} options
+ * @param {(err: Error|null, result?: {parsed: object, origins: object, files: string[]}) => void} onChange
+ * @returns {{close: () => void}}
+ */
+function watchEntry(options, onChange)
+{
+    return watch(options, onChange, loadEntry);
+}
+
+module.exports = Object.assign(loadEntry, {
+    load: loadEntry,
     parse,
-    /**
-     * Watch resolved .menv files and reload on change.
-     * @param {object} options
-     * @param {(err: Error|null, result?: {parsed: object, origins: object, files: string[]}) => void} onChange
-     * @returns {{close: () => void}}
-     */
-    watch(options, onChange)
-    {
-        return watch(options, onChange, load);
-    }
-};
+    watch: watchEntry
+});

package/src/lib/core.js

@@ -30,7 +30,7 @@ function buildState()
  */
 function exportToEnv(values, options)
 {
-    if (!options.export) return;
+     if (!options.exportEnv) return;
     for (const [key, value] of Object.entries(values))
     {
         if (!options.override && Object.prototype.hasOwnProperty.call(process.env, key))
@@ -41,6 +41,18 @@ function exportToEnv(values, options)
     }
 }
 
+/**
+ * Attach parsed values to process.menv unless disabled.
+ * @param {object} values
+ * @param {object} options
+ * @returns {void}
+ */
+function attachToProcess(values, options)
+{
+    if (options.attach === false) return;
+    process.menv = values;
+}
+
 /**
  * Load .menv files and return parsed values with origins.
  * @param {object} options
@@ -81,6 +93,8 @@ function load(options = {})
         deepFreeze(state.values);
     }
 
+    attachToProcess(state.values, options);
+
     return {
         parsed: state.values,
         origins: state.origins,