@maestro-js/config 1.0.0-alpha.24 → 1.0.0-alpha.26

package/README.md

@@ -16,12 +16,23 @@ await Config.loadConfigFile({
 })
 ```
 
-Or auto-load at startup without application code:
+Or auto-load at startup without application code. Options come from CLI flags or environment variables (CLI flags take precedence):
 
 ```bash
-node --import @maestro-js/config/load --config app --env production --root /path/to/project
+# CLI flags
+node --import @maestro-js/config/load app.js --config app --env production
+
+# Environment variables
+MAESTRO_CONFIG_NAME=app MAESTRO_ENV_NAME=production node --import @maestro-js/config/load app.js
 ```
 
+| CLI flag   | Env var                         | Description                                        |
+| ---------- | ------------------------------- | -------------------------------------------------- |
+| `--config` | `MAESTRO_CONFIG_NAME`           | Config file name without extension (**required**)  |
+| `--env`    | `MAESTRO_ENV_NAME` / `ENV_NAME` | Environment name (`.env.<name>`)                   |
+| `--key`    | `MAESTRO_ENV_ENCRYPTION_KEY`    | 64-char hex key for encrypted `.env` files         |
+| `--root`   | `MAESTRO_CONFIG_ROOT`           | Project root (defaults to `process.cwd()`)         |
+
 ## API Reference
 
 ### ConfigOptions
@@ -172,13 +183,16 @@ Encrypted values use the format `<iv_base64>.<authTag_base64>.<ciphertext_base64
 
 ### Auto-load entry point
 
-The `@maestro-js/config/load` export is a standalone script intended for `node --import`. It parses CLI arguments and calls `Config.loadConfigFile`.
+The `@maestro-js/config/load` export is a standalone script intended for `node --import`. It resolves options from CLI flags or the environment variables below — CLI flags take precedence — and calls `Config.loadConfigFile`.
+
+| Option | Environment variable | Default |
+| --- | --- | --- |
+| Config name (required) | `MAESTRO_CONFIG_NAME` | — |
+| Environment name | `MAESTRO_ENV_NAME` (falls back to `ENV_NAME`) | `null` (`.env`) |
+| Encryption key | `MAESTRO_ENV_ENCRYPTION_KEY` | `null` |
+| Project root | `MAESTRO_CONFIG_ROOT` | `process.cwd()` |
 
-CLI flags:
-- `--config <name>` (required) -- config file name without extension
-- `--env <name>` -- environment name
-- `--key <hex>` -- encryption key (falls back to `MAESTRO_ENV_ENCRYPTION_KEY` env var)
-- `--root <path>` -- project root (defaults to `process.cwd()`)
+With `node --import`, any CLI flags must be placed **after** the script name — flags before it are parsed by Node itself and rejected. Environment variables aren't position-sensitive, so they're the simpler path for `--import`.
 
 ## Cross-Package Integration
 

package/dist/load.js

@@ -3,17 +3,17 @@ import {
 } from "./chunk-AVYD4MV2.js";
 
 // src/load.ts
-import "path";
-var { configName, envName, encryptionKey, rootDir } = parseArgs(process.argv);
+var { configName, envName, encryptionKey, rootDir } = resolveOptions();
 await Config.loadConfigFile({ rootDir, configName, envName, encryptionKey });
-function parseArgs(argv) {
-  const configName2 = getArgValue(argv, "--config");
+function resolveOptions() {
+  const argv = process.argv;
+  const configName2 = getArgValue(argv, "--config") ?? process.env["MAESTRO_CONFIG_NAME"];
   if (!configName2) {
-    throw new Error("Missing required --config <name> argument");
+    throw new Error("Missing required config name (--config <name> or MAESTRO_CONFIG_NAME)");
   }
-  const envName2 = getArgValue(argv, "--env") ?? null;
+  const envName2 = getArgValue(argv, "--env") ?? process.env["MAESTRO_ENV_NAME"] ?? process.env["ENV_NAME"] ?? null;
   const encryptionKey2 = getArgValue(argv, "--key") ?? process.env["MAESTRO_ENV_ENCRYPTION_KEY"] ?? null;
-  const rootDir2 = getArgValue(argv, "--root") ?? process.cwd();
+  const rootDir2 = getArgValue(argv, "--root") ?? process.env["MAESTRO_CONFIG_ROOT"] ?? process.cwd();
   return { configName: configName2, envName: envName2, encryptionKey: encryptionKey2, rootDir: rootDir2 };
 }
 function getArgValue(argv, flag) {

package/package.json

@@ -15,7 +15,7 @@
   "devDependencies": {
     "@types/node": "^22.19.11"
   },
-  "version": "1.0.0-alpha.24",
+  "version": "1.0.0-alpha.26",
   "publishConfig": {
     "access": "public"
   },