@achs/env 5.0.0-alpha.3 → 5.0.0

package/exec.js

@@ -2,23 +2,24 @@ import { getSubcommand as e, loadConfigFile as t, loadProjectInfo as n, loadSche
 import { interpolateJson as i } from "./utils/interpolate.util.js";
 import { resolvePath as a } from "./utils/json.util.js";
 import { configureLogger as o, logger as s } from "./utils/logger.js";
+import { ui as c } from "./utils/ui.js";
 import "./utils/index.js";
-import { IntegratedProviders as c } from "./providers/index.js";
-import { args as l } from "./arguments.js";
-import { envCommand as u } from "./commands/env.command.js";
-import { exportCommand as d } from "./commands/export.command.js";
-import { pullCommand as f } from "./commands/pull.command.js";
-import { pushCommand as p } from "./commands/push.command.js";
-import { schemaCommand as m } from "./commands/schema.command.js";
+import { IntegratedProviders as l } from "./providers/index.js";
+import { args as u } from "./arguments.js";
+import { envCommand as d } from "./commands/env.command.js";
+import { exportCommand as f } from "./commands/export.command.js";
+import { pullCommand as p } from "./commands/pull.command.js";
+import { pushCommand as m } from "./commands/push.command.js";
+import { schemaCommand as h } from "./commands/schema.command.js";
 import "./commands/index.js";
-import h from "picocolors";
-import { readFileSync as g } from "node:fs";
-import { fileURLToPath as _ } from "node:url";
-import v from "yargs";
-import { Parser as y } from "yargs/helpers";
+import g from "picocolors";
+import { readFileSync as _ } from "node:fs";
+import { fileURLToPath as v } from "node:url";
+import y from "yargs";
+import { Parser as b } from "yargs/helpers";
 //#region src/exec.ts
-async function b(e, n, r) {
-	let i = y.detailed(e, {
+async function x(e, n, r) {
+	let i = b.detailed(e, {
 		array: [
 			"modes",
 			"logMaskAnyRegEx",
@@ -34,55 +35,58 @@ async function b(e, n, r) {
 			"logLevel"
 		],
 		alias: {
-			configFile: l.configFile.alias,
-			env: l.env.alias,
-			logLevel: l.logLevel.alias,
-			logMaskAnyRegEx: l.logMaskAnyRegEx.alias,
-			logMaskValuesOfKeys: l.logMaskValuesOfKeys.alias,
-			modes: l.modes.alias
+			configFile: u.configFile.alias,
+			env: u.env.alias,
+			logLevel: u.logLevel.alias,
+			logMaskAnyRegEx: u.logMaskAnyRegEx.alias,
+			logMaskValuesOfKeys: u.logMaskValuesOfKeys.alias,
+			modes: u.modes.alias
 		},
 		default: {
-			configFile: l.configFile.default,
-			root: l.root.default
+			configFile: u.configFile.default,
+			root: u.root.default
 		}
 	}).argv;
-	await t(i, r), i.logLevel ??= l.logLevel.default, i.logMaskAnyRegEx ??= l.logMaskAnyRegEx.default, i.logMaskValuesOfKeys ??= l.logMaskValuesOfKeys.default, i.providers ??= l.providers.default;
-	let { logLevel: a, logMaskAnyRegEx: c, logMaskValuesOfKeys: u } = i;
+	await t(i, r), i.logLevel ??= u.logLevel.default, i.logMaskAnyRegEx ??= u.logMaskAnyRegEx.default, i.logMaskValuesOfKeys ??= u.logMaskValuesOfKeys.default, i.providers ??= u.providers.default;
+	let { logLevel: a, logMaskAnyRegEx: c, logMaskValuesOfKeys: l } = i;
 	return o(s, {
 		maskAnyRegEx: c,
-		maskValuesOfKeys: u,
+		maskValuesOfKeys: l,
 		minLevel: a
 	}), (a === "silly" || a === "trace") && (process.env.AKV_DEBUG = "true"), i;
 }
-async function x(t) {
-	let { config: n, version: r } = JSON.parse(g(_(new URL("package.json", "" + import.meta.url)), "utf8")), i = e(t, n.delimiters.subcommand), o = await b(t, n.parser, n.delimiters.template), { env: l, help: u, modes: d, providers: f } = o;
-	u && S(t, o, i, n, r), (!Array.isArray(f) || f.length === 0) && (s.error("no providers found"), process.exit(1));
-	let p = l ? ` ${h.bold(h.underline(h.green(l)))} environment` : "", m = d ? ` ${h.bold(h.magenta(d.join("+")))} mode` : "";
-	s.info(`loading${p}${l && d ? " in" : ""}${m}`);
-	for (let e of f) try {
-		if (s.debug(`using ${h.yellow(e.path)} provider`), !e.type || e.type === "integrated") e.handler = c[e.path];
+async function S(t) {
+	let { config: n, version: r } = JSON.parse(_(v(new URL("package.json", "" + import.meta.url)), "utf8")), i = e(t, n.delimiters.subcommand), o = await x(t, n.parser, n.delimiters.template), { env: u, help: d, modes: f, providers: p } = o;
+	d && C(t, o, i, n, r), (!Array.isArray(p) || p.length === 0) && (s.error("no providers found"), process.exit(1)), c.header(r, u, f);
+	for (let e of p) try {
+		if (s.debug(`using ${g.yellow(e.path)} provider`), !e.type || e.type === "integrated") e.handler = l[e.path];
 		else {
 			let { default: t } = await (e.type === "module" ? import(e.path) : import(a(e.path)));
 			e.handler = t;
 		}
 	} catch {
-		s.error(`${h.yellow(e.path)} provider not found or not compatible`), process.exit(1);
+		s.error(`${g.yellow(e.path)} provider not found or not compatible`), process.exit(1);
 	}
-	S(t, o, i, n, r);
+	C(t, o, i, n, r);
 }
-function S(e, t, a, o, c = "unknown") {
-	let g = v(e).strict().scriptName("env").version(c).detectLocale(!1).showHelpOnFail(!1).parserConfiguration(o.parser).usage("Usage: $0 [command] [options..] [: subcmd [:]] [options..]").options(l).middleware(async (e) => {
-		a?.length > 0 && (e.subcmd = a), Object.assign(e, t), s.silly("interpolating arguments surrounded by", h.bold(h.yellow(`${o.delimiters.template[0]} ${o.delimiters.template[1]}`)));
+function C(e, t, a, o, c = "unknown") {
+	let l = g.dim(`v${c}`), _ = [
+		"",
+		`${g.bold(g.yellow("⚡ env"))} ${l}  ${g.dim("· environment variables made easy")}`,
+		"",
+		`${g.bold("Usage:")} $0 [command] [options..] ${g.dim(": <subcmd> :")} [options..]`
+	].join("\n"), v = [`${g.dim("Run")} ${g.cyan("env <command> --help")} ${g.dim("for command-specific options.")}`, `${g.dim("Use")} ${g.cyan("--log debug")} ${g.dim("to inspect the resolved environment (secrets stay masked).")}`].join("\n"), b = y(e).strict().scriptName("env").version(c).detectLocale(!1).showHelpOnFail(!1).parserConfiguration(o.parser).wrap(Math.min(110, process.stdout.columns ?? 110)).usage(_).epilog(v).options(u).middleware(async (e) => {
+		a?.length > 0 && (e.subcmd = a), Object.assign(e, t), s.silly("interpolating arguments surrounded by", g.bold(g.yellow(`${o.delimiters.template[0]} ${o.delimiters.template[1]}`)));
 		let c = e.subcmd;
 		if (i(e, e, o.delimiters.template), Array.isArray(e.subcmd)) for (let t in e.subcmd) e.subcmd[t]?.includes("undefined") && (e.subcmd[t] = c[t]);
 		s.silly("config loaded:", e), [e.projectInfo, e.schema] = await Promise.all([n(e.packageJson ?? e.pkg), r(e, o.delimiters.template)]), e.schemaValidate && (e.schemaValidate = !!e.schema, e.schemaValidate && s.silly("schema loaded:", e.schema));
 	});
-	g.command(u), g.command(d), g.command(f), g.command(p), g.command(m);
-	let { providers: _ } = t;
-	for (let { handler: e } of _) e?.builder && e.builder(g);
-	g.parse();
+	b.command(d), b.command(f), b.command(p), b.command(m), b.command(h);
+	let { providers: x } = t;
+	for (let { handler: e } of x) e?.builder && e.builder(b);
+	b.parse();
 }
 //#endregion
-export { x as exec };
+export { S as exec };
 
 //# sourceMappingURL=exec.js.map

package/exec.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec.js","names":[],"sources":["../src/exec.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\r\nimport { fileURLToPath } from 'node:url';\r\nimport pc from 'picocolors';\r\nimport yargs from 'yargs';\r\nimport type { Arguments } from 'yargs';\r\nimport { Parser } from 'yargs/helpers';\r\nimport { args } from './arguments.js';\r\nimport type { CommandArguments } from './arguments.js';\r\nimport {\r\n\tenvCommand,\r\n\texportCommand,\r\n\tpullCommand,\r\n\tpushCommand,\r\n\tschemaCommand,\r\n} from './commands/index.js';\r\nimport { IntegratedProviders } from './providers/index.js';\r\nimport {\r\n\tconfigureLogger,\r\n\tgetSubcommand,\r\n\tinterpolateJson,\r\n\tloadConfigFile,\r\n\tloadProjectInfo,\r\n\tloadSchemaFile,\r\n\tlogger,\r\n\tresolvePath,\r\n} from './utils/index.js';\r\n\r\ntype Alias = string[] | string;\r\n\r\n/**\r\n * Preload basic config from command line and config file.\r\n *\r\n * @param {string[]} rawArgv process.argv\r\n * @param {Partial<yargsParser.Configuration>} parser yargs parser config\r\n * @param {[string, string]} delimiters\r\n *\r\n * @returns {Promise<Partial<CommandArguments>>} preloaded config\r\n */\r\nasync function preloadConfig(\r\n\trawArgv: string[],\r\n\tparser: Record<string, unknown>,\r\n\tdelimiters: [string, string],\r\n): Promise<Partial<CommandArguments>> {\r\n\t// preload base config\r\n\tconst preloadedArgv = Parser.detailed(rawArgv, {\r\n\t\tarray: ['modes', 'logMaskAnyRegEx', 'logMaskValuesOfKeys'],\r\n\t\tboolean: ['help'],\r\n\t\tconfiguration: parser as any,\r\n\t\tstring: ['root', 'env', 'configFile', 'schemaFile', 'logLevel'],\r\n\t\talias: {\r\n\t\t\tconfigFile: args.configFile.alias as Alias,\r\n\t\t\tenv: args.env.alias as Alias,\r\n\t\t\tlogLevel: args.logLevel.alias as Alias,\r\n\t\t\tlogMaskAnyRegEx: args.logMaskAnyRegEx.alias as Alias,\r\n\t\t\tlogMaskValuesOfKeys: args.logMaskValuesOfKeys.alias as Alias,\r\n\t\t\tmodes: args.modes.alias as Alias,\r\n\t\t},\r\n\t\tdefault: {\r\n\t\t\tconfigFile: args.configFile.default,\r\n\t\t\troot: args.root.default,\r\n\t\t},\r\n\t}).argv;\r\n\r\n\t// loads configuration file\r\n\tawait loadConfigFile(preloadedArgv, delimiters);\r\n\r\n\tpreloadedArgv.logLevel ??= args.logLevel.default;\r\n\tpreloadedArgv.logMaskAnyRegEx ??= args.logMaskAnyRegEx.default;\r\n\tpreloadedArgv.logMaskValuesOfKeys ??= args.logMaskValuesOfKeys.default;\r\n\tpreloadedArgv.providers ??= args.providers.default;\r\n\r\n\tconst { logLevel, logMaskAnyRegEx, logMaskValuesOfKeys } = preloadedArgv;\r\n\r\n\t// logging level\r\n\tconfigureLogger(logger, {\r\n\t\tmaskAnyRegEx: logMaskAnyRegEx,\r\n\t\tmaskValuesOfKeys: logMaskValuesOfKeys,\r\n\t\tminLevel: logLevel,\r\n\t});\r\n\r\n\tif (logLevel === 'silly' || logLevel === 'trace')\r\n\t\tprocess.env.AKV_DEBUG = 'true';\r\n\r\n\treturn preloadedArgv;\r\n}\r\n\r\n/**\r\n * Command preprocessing and lib info\r\n * reading from package.json.\r\n * Preloads config file and setup basic config.\r\n *\r\n * @param {string[]} rawArgv process.argv\r\n */\r\nexport async function exec(rawArgv: string[]) {\r\n\t// reads some lib base config from package.json\r\n\tconst pkg = JSON.parse(\r\n\t\treadFileSync(\r\n\t\t\tfileURLToPath(new URL('package.json', import.meta.url)),\r\n\t\t\t'utf8',\r\n\t\t),\r\n\t) as { config: Record<string, any>; version: string };\r\n\tconst { config, version } = pkg;\r\n\r\n\t// execs yargs\r\n\tconst subcommand = getSubcommand(rawArgv, config.delimiters.subcommand);\r\n\r\n\tconst preloadedArgv = await preloadConfig(\r\n\t\trawArgv,\r\n\t\tconfig.parser,\r\n\t\tconfig.delimiters.template,\r\n\t);\r\n\r\n\tconst { env, help, modes, providers } = preloadedArgv;\r\n\r\n\tif (help) build(rawArgv, preloadedArgv, subcommand, config, version);\r\n\r\n\tif (!Array.isArray(providers) || providers.length === 0) {\r\n\t\tlogger.error('no providers found');\r\n\r\n\t\tprocess.exit(1);\r\n\t}\r\n\r\n\tconst envMsg = env\r\n\t\t? ` ${pc.bold(pc.underline(pc.green(env)))} environment`\r\n\t\t: '';\r\n\tconst modesMsg = modes\r\n\t\t? ` ${pc.bold(pc.magenta(modes.join('+')))} mode`\r\n\t\t: '';\r\n\r\n\tlogger.info(`loading${envMsg}${env && modes ? ' in' : ''}${modesMsg}`);\r\n\r\n\t// read loaders from config\r\n\tfor (const provider of providers!) {\r\n\t\ttry {\r\n\t\t\tlogger.debug(`using ${pc.yellow(provider.path)} provider`);\r\n\r\n\t\t\tif (!provider.type || provider.type === 'integrated') {\r\n\t\t\t\tprovider.handler = IntegratedProviders[provider.path];\r\n\t\t\t} else {\r\n\t\t\t\tconst { default: module } = await import(\r\n\t\t\t\t\tprovider.type === 'module'\r\n\t\t\t\t\t\t? provider.path\r\n\t\t\t\t\t\t: resolvePath(provider.path)\r\n\t\t\t\t);\r\n\r\n\t\t\t\tprovider.handler = module;\r\n\t\t\t}\r\n\t\t} catch {\r\n\t\t\tlogger.error(\r\n\t\t\t\t`${pc.yellow(\r\n\t\t\t\t\tprovider.path,\r\n\t\t\t\t)} provider not found or not compatible`,\r\n\t\t\t);\r\n\r\n\t\t\tprocess.exit(1);\r\n\t\t}\r\n\t}\r\n\r\n\tbuild(rawArgv, preloadedArgv, subcommand, config, version);\r\n}\r\n\r\n/**\r\n * Builds commands and execs Yargs.\r\n *\r\n * @param {string[]} rawArgv process.argv.slice(2)\r\n * @param {Partial<Arguments<CommandArguments>>} preloadedArgv\r\n * @param {string[]} subcommand subcommand for wrap if exists\r\n * @param {Record<string, any>} config lib config from package.json\r\n * @param {string} version lib version from package.json\r\n */\r\nfunction build(\r\n\trawArgv: string[],\r\n\tpreloadedArgv: Partial<Arguments<CommandArguments>>,\r\n\tsubcommand: string[],\r\n\tconfig: Record<string, any>,\r\n\tversion = 'unknown',\r\n): void {\r\n\tconst builder = yargs(rawArgv)\r\n\t\t.strict()\r\n\t\t.scriptName('env')\r\n\t\t.version(version)\r\n\t\t.detectLocale(false)\r\n\t\t.showHelpOnFail(false)\r\n\t\t.parserConfiguration(config.parser)\r\n\t\t.usage('Usage: $0 [command] [options..] [: subcmd [:]] [options..]')\r\n\t\t.options(args)\r\n\t\t.middleware(async (argv): Promise<void> => {\r\n\t\t\t// in case of subcommand argument for main\r\n\t\t\tif (subcommand?.length > 0) argv.subcmd = subcommand;\r\n\r\n\t\t\t// merges preloaded args\r\n\t\t\tObject.assign(argv, preloadedArgv);\r\n\r\n\t\t\tlogger.silly(\r\n\t\t\t\t'interpolating arguments surrounded by',\r\n\t\t\t\tpc.bold(\r\n\t\t\t\t\tpc.yellow(\r\n\t\t\t\t\t\t`${config.delimiters.template[0]} ${config.delimiters.template[1]}`,\r\n\t\t\t\t\t),\r\n\t\t\t\t),\r\n\t\t\t);\r\n\r\n\t\t\tconst subcmdAux = argv.subcmd as string[];\r\n\t\t\t// applies string templating with current vars\r\n\t\t\tinterpolateJson(argv, argv, config.delimiters.template);\r\n\r\n\t\t\tif (Array.isArray(argv.subcmd)) {\r\n\t\t\t\t// fix for argv interpolation pre env interpolation for subcommand\r\n\t\t\t\tfor (const index in argv.subcmd) {\r\n\t\t\t\t\tif (argv.subcmd[index]?.includes('undefined'))\r\n\t\t\t\t\t\targv.subcmd[index] = subcmdAux[index];\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\tlogger.silly('config loaded:', argv);\r\n\r\n\t\t\t// loads environment JSON schema if exists\r\n\t\t\t// and current project info from package.json\r\n\t\t\t[argv.projectInfo, argv.schema] = await Promise.all([\r\n\t\t\t\tloadProjectInfo((argv.packageJson ?? argv.pkg) as string),\r\n\t\t\t\tloadSchemaFile(argv, config.delimiters.template),\r\n\t\t\t]);\r\n\r\n\t\t\tif (argv.schemaValidate) {\r\n\t\t\t\targv.schemaValidate = !!argv.schema;\r\n\r\n\t\t\t\tif (argv.schemaValidate)\r\n\t\t\t\t\tlogger.silly('schema loaded:', argv.schema);\r\n\t\t\t}\r\n\t\t});\r\n\r\n\t// integrated commands builder\r\n\tbuilder.command(envCommand);\r\n\tbuilder.command(exportCommand);\r\n\tbuilder.command(pullCommand);\r\n\tbuilder.command(pushCommand);\r\n\tbuilder.command(schemaCommand);\r\n\r\n\tconst { providers } = preloadedArgv;\r\n\r\n\t// extends command from plugins\r\n\tfor (const { handler } of providers!)\r\n\t\tif (handler?.builder) handler.builder(builder);\r\n\r\n\t// executes command processing\r\n\tvoid builder.parse();\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"exec.js","names":[],"sources":["../src/exec.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\r\nimport { fileURLToPath } from 'node:url';\r\nimport pc from 'picocolors';\r\nimport yargs from 'yargs';\r\nimport type { Arguments } from 'yargs';\r\nimport { Parser } from 'yargs/helpers';\r\nimport { args } from './arguments.js';\r\nimport type { CommandArguments } from './arguments.js';\r\nimport {\r\n\tenvCommand,\r\n\texportCommand,\r\n\tpullCommand,\r\n\tpushCommand,\r\n\tschemaCommand,\r\n} from './commands/index.js';\r\nimport { IntegratedProviders } from './providers/index.js';\r\nimport {\r\n\tconfigureLogger,\r\n\tgetSubcommand,\r\n\tinterpolateJson,\r\n\tloadConfigFile,\r\n\tloadProjectInfo,\r\n\tloadSchemaFile,\r\n\tlogger,\r\n\tresolvePath,\r\n\tui,\r\n} from './utils/index.js';\r\n\r\ntype Alias = string[] | string;\r\n\r\n/**\r\n * Preload basic config from command line and config file.\r\n *\r\n * @param {string[]} rawArgv process.argv\r\n * @param {Partial<yargsParser.Configuration>} parser yargs parser config\r\n * @param {[string, string]} delimiters\r\n *\r\n * @returns {Promise<Partial<CommandArguments>>} preloaded config\r\n */\r\nasync function preloadConfig(\r\n\trawArgv: string[],\r\n\tparser: Record<string, unknown>,\r\n\tdelimiters: [string, string],\r\n): Promise<Partial<CommandArguments>> {\r\n\t// preload base config\r\n\tconst preloadedArgv = Parser.detailed(rawArgv, {\r\n\t\tarray: ['modes', 'logMaskAnyRegEx', 'logMaskValuesOfKeys'],\r\n\t\tboolean: ['help'],\r\n\t\tconfiguration: parser as any,\r\n\t\tstring: ['root', 'env', 'configFile', 'schemaFile', 'logLevel'],\r\n\t\talias: {\r\n\t\t\tconfigFile: args.configFile.alias as Alias,\r\n\t\t\tenv: args.env.alias as Alias,\r\n\t\t\tlogLevel: args.logLevel.alias as Alias,\r\n\t\t\tlogMaskAnyRegEx: args.logMaskAnyRegEx.alias as Alias,\r\n\t\t\tlogMaskValuesOfKeys: args.logMaskValuesOfKeys.alias as Alias,\r\n\t\t\tmodes: args.modes.alias as Alias,\r\n\t\t},\r\n\t\tdefault: {\r\n\t\t\tconfigFile: args.configFile.default,\r\n\t\t\troot: args.root.default,\r\n\t\t},\r\n\t}).argv;\r\n\r\n\t// loads configuration file\r\n\tawait loadConfigFile(preloadedArgv, delimiters);\r\n\r\n\tpreloadedArgv.logLevel ??= args.logLevel.default;\r\n\tpreloadedArgv.logMaskAnyRegEx ??= args.logMaskAnyRegEx.default;\r\n\tpreloadedArgv.logMaskValuesOfKeys ??= args.logMaskValuesOfKeys.default;\r\n\tpreloadedArgv.providers ??= args.providers.default;\r\n\r\n\tconst { logLevel, logMaskAnyRegEx, logMaskValuesOfKeys } = preloadedArgv;\r\n\r\n\t// logging level\r\n\tconfigureLogger(logger, {\r\n\t\tmaskAnyRegEx: logMaskAnyRegEx,\r\n\t\tmaskValuesOfKeys: logMaskValuesOfKeys,\r\n\t\tminLevel: logLevel,\r\n\t});\r\n\r\n\tif (logLevel === 'silly' || logLevel === 'trace')\r\n\t\tprocess.env.AKV_DEBUG = 'true';\r\n\r\n\treturn preloadedArgv;\r\n}\r\n\r\n/**\r\n * Command preprocessing and lib info\r\n * reading from package.json.\r\n * Preloads config file and setup basic config.\r\n *\r\n * @param {string[]} rawArgv process.argv\r\n */\r\nexport async function exec(rawArgv: string[]) {\r\n\t// reads some lib base config from package.json\r\n\tconst pkg = JSON.parse(\r\n\t\treadFileSync(\r\n\t\t\tfileURLToPath(new URL('package.json', import.meta.url)),\r\n\t\t\t'utf8',\r\n\t\t),\r\n\t) as { config: Record<string, any>; version: string };\r\n\tconst { config, version } = pkg;\r\n\r\n\t// execs yargs\r\n\tconst subcommand = getSubcommand(rawArgv, config.delimiters.subcommand);\r\n\r\n\tconst preloadedArgv = await preloadConfig(\r\n\t\trawArgv,\r\n\t\tconfig.parser,\r\n\t\tconfig.delimiters.template,\r\n\t);\r\n\r\n\tconst { env, help, modes, providers } = preloadedArgv;\r\n\r\n\tif (help) build(rawArgv, preloadedArgv, subcommand, config, version);\r\n\r\n\tif (!Array.isArray(providers) || providers.length === 0) {\r\n\t\tlogger.error('no providers found');\r\n\r\n\t\tprocess.exit(1);\r\n\t}\r\n\r\n\tui.header(version, env, modes);\r\n\r\n\t// read loaders from config\r\n\tfor (const provider of providers!) {\r\n\t\ttry {\r\n\t\t\tlogger.debug(`using ${pc.yellow(provider.path)} provider`);\r\n\r\n\t\t\tif (!provider.type || provider.type === 'integrated') {\r\n\t\t\t\tprovider.handler = IntegratedProviders[provider.path];\r\n\t\t\t} else {\r\n\t\t\t\tconst { default: module } = await import(\r\n\t\t\t\t\tprovider.type === 'module'\r\n\t\t\t\t\t\t? provider.path\r\n\t\t\t\t\t\t: resolvePath(provider.path)\r\n\t\t\t\t);\r\n\r\n\t\t\t\tprovider.handler = module;\r\n\t\t\t}\r\n\t\t} catch {\r\n\t\t\tlogger.error(\r\n\t\t\t\t`${pc.yellow(\r\n\t\t\t\t\tprovider.path,\r\n\t\t\t\t)} provider not found or not compatible`,\r\n\t\t\t);\r\n\r\n\t\t\tprocess.exit(1);\r\n\t\t}\r\n\t}\r\n\r\n\tbuild(rawArgv, preloadedArgv, subcommand, config, version);\r\n}\r\n\r\n/**\r\n * Builds commands and execs Yargs.\r\n *\r\n * @param {string[]} rawArgv process.argv.slice(2)\r\n * @param {Partial<Arguments<CommandArguments>>} preloadedArgv\r\n * @param {string[]} subcommand subcommand for wrap if exists\r\n * @param {Record<string, any>} config lib config from package.json\r\n * @param {string} version lib version from package.json\r\n */\r\nfunction build(\r\n\trawArgv: string[],\r\n\tpreloadedArgv: Partial<Arguments<CommandArguments>>,\r\n\tsubcommand: string[],\r\n\tconfig: Record<string, any>,\r\n\tversion = 'unknown',\r\n): void {\r\n\tconst versionTag = pc.dim(`v${version}`);\r\n\tconst banner = [\r\n\t\t'',\r\n\t\t`${pc.bold(pc.yellow('⚡ env'))} ${versionTag}  ${pc.dim('· environment variables made easy')}`,\r\n\t\t'',\r\n\t\t`${pc.bold('Usage:')} $0 [command] [options..] ${pc.dim(': <subcmd> :')} [options..]`,\r\n\t].join('\\n');\r\n\tconst epilog = [\r\n\t\t`${pc.dim('Run')} ${pc.cyan('env <command> --help')} ${pc.dim('for command-specific options.')}`,\r\n\t\t`${pc.dim('Use')} ${pc.cyan('--log debug')} ${pc.dim('to inspect the resolved environment (secrets stay masked).')}`,\r\n\t].join('\\n');\r\n\r\n\tconst builder = yargs(rawArgv)\r\n\t\t.strict()\r\n\t\t.scriptName('env')\r\n\t\t.version(version)\r\n\t\t.detectLocale(false)\r\n\t\t.showHelpOnFail(false)\r\n\t\t.parserConfiguration(config.parser)\r\n\t\t.wrap(Math.min(110, process.stdout.columns ?? 110))\r\n\t\t.usage(banner)\r\n\t\t.epilog(epilog)\r\n\t\t.options(args)\r\n\t\t.middleware(async (argv): Promise<void> => {\r\n\t\t\t// in case of subcommand argument for main\r\n\t\t\tif (subcommand?.length > 0) argv.subcmd = subcommand;\r\n\r\n\t\t\t// merges preloaded args\r\n\t\t\tObject.assign(argv, preloadedArgv);\r\n\r\n\t\t\tlogger.silly(\r\n\t\t\t\t'interpolating arguments surrounded by',\r\n\t\t\t\tpc.bold(\r\n\t\t\t\t\tpc.yellow(\r\n\t\t\t\t\t\t`${config.delimiters.template[0]} ${config.delimiters.template[1]}`,\r\n\t\t\t\t\t),\r\n\t\t\t\t),\r\n\t\t\t);\r\n\r\n\t\t\tconst subcmdAux = argv.subcmd as string[];\r\n\t\t\t// applies string templating with current vars\r\n\t\t\tinterpolateJson(argv, argv, config.delimiters.template);\r\n\r\n\t\t\tif (Array.isArray(argv.subcmd)) {\r\n\t\t\t\t// fix for argv interpolation pre env interpolation for subcommand\r\n\t\t\t\tfor (const index in argv.subcmd) {\r\n\t\t\t\t\tif (argv.subcmd[index]?.includes('undefined'))\r\n\t\t\t\t\t\targv.subcmd[index] = subcmdAux[index];\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\tlogger.silly('config loaded:', argv);\r\n\r\n\t\t\t// loads environment JSON schema if exists\r\n\t\t\t// and current project info from package.json\r\n\t\t\t[argv.projectInfo, argv.schema] = await Promise.all([\r\n\t\t\t\tloadProjectInfo((argv.packageJson ?? argv.pkg) as string),\r\n\t\t\t\tloadSchemaFile(argv, config.delimiters.template),\r\n\t\t\t]);\r\n\r\n\t\t\tif (argv.schemaValidate) {\r\n\t\t\t\targv.schemaValidate = !!argv.schema;\r\n\r\n\t\t\t\tif (argv.schemaValidate)\r\n\t\t\t\t\tlogger.silly('schema loaded:', argv.schema);\r\n\t\t\t}\r\n\t\t});\r\n\r\n\t// integrated commands builder\r\n\tbuilder.command(envCommand);\r\n\tbuilder.command(exportCommand);\r\n\tbuilder.command(pullCommand);\r\n\tbuilder.command(pushCommand);\r\n\tbuilder.command(schemaCommand);\r\n\r\n\tconst { providers } = preloadedArgv;\r\n\r\n\t// extends command from plugins\r\n\tfor (const { handler } of providers!)\r\n\t\tif (handler?.builder) handler.builder(builder);\r\n\r\n\t// executes command processing\r\n\tvoid builder.parse();\r\n}\r\n"],"mappings":"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"}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.0.0-alpha.3",
+  "version": "5.0.0",
   "project": "common",
   "name": "@achs/env",
   "type": "module",

package/providers/azure-key-vault.provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"azure-key-vault.provider.d.ts","sourceRoot":"","sources":["../../src/providers/azure-key-vault.provider.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAe1D,UAAU,6BAA8B,SAAQ,gBAAgB;IAC/D,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,UAAU,0BAA0B;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG;QACd,QAAQ,EAAE,MAAM,CAAC;KACjB,CAAC;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAC9C,6BAA6B,GAAG,oBAAoB,EACpD,0BAA0B,CAgJ1B,CAAC"}
+{"version":3,"file":"azure-key-vault.provider.d.ts","sourceRoot":"","sources":["../../src/providers/azure-key-vault.provider.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAe1D,UAAU,6BAA8B,SAAQ,gBAAgB;IAC/D,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,UAAU,0BAA0B;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG;QACd,QAAQ,EAAE,MAAM,CAAC;KACjB,CAAC;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAC9C,6BAA6B,GAAG,oBAAoB,EACpD,0BAA0B,CAgJ1B,CAAC"}

package/providers/azure-key-vault.provider.js

@@ -5,24 +5,23 @@ import { schemaToJson as i } from "../utils/schema.util.js";
 import "../utils/index.js";
 import a from "picocolors";
 import { existsSync as o } from "node:fs";
-import { AzureKeyVault as s, createAzureKeyVaultMock as c } from "@achs/azure-key-vault";
-import l from "node:dns";
+import s from "node:dns";
 //#region src/providers/azure-key-vault.provider.ts
-var u = "azure-key-vault", d = r.getSubLogger({ prefix: [a.bold(a.blue(`[${u}]`))] }), f = {
-	key: u,
+var c = "azure-key-vault", l = r.getSubLogger({ prefix: [a.bold(a.blue(`[${c}]`))] }), u = {
+	key: c,
 	builder: (e) => {
 		e.options({
 			keysFile: {
 				alias: ["k", "keys"],
 				default: ["[[root]]/keys.json", "../keys.json"],
 				describe: "Azure Key Vault keys file path",
-				group: u,
+				group: c,
 				type: "array"
 			},
 			mock: {
 				default: !1,
 				describe: "Mocks Azure Key Vault client",
-				group: u,
+				group: c,
 				type: "boolean"
 			},
 			password: {
@@ -32,13 +31,13 @@ var u = "azure-key-vault", d = r.getSubLogger({ prefix: [a.bold(a.blue(`[${u}]`)
 					"clientSecret"
 				],
 				describe: "SPN Client Secret Password",
-				group: u,
+				group: c,
 				type: "string"
 			},
 			secretsFile: {
 				default: "[[root]]/[[env]].env.json",
 				describe: "Secret variables file path",
-				group: u,
+				group: c,
 				type: "string"
 			},
 			skipDnsCheck: {
@@ -50,94 +49,96 @@ var u = "azure-key-vault", d = r.getSubLogger({ prefix: [a.bold(a.blue(`[${u}]`)
 			spn: {
 				alias: ["clientId", "id"],
 				describe: "SPN Client ID",
-				group: u,
+				group: c,
 				type: "string"
 			},
 			tenant: {
 				alias: "t",
 				describe: "Azure Tenant ID",
-				group: u,
+				group: c,
 				type: "string"
 			},
 			vaultUrl: {
 				alias: "url",
 				describe: "Azure Key Vault URL",
-				group: u,
+				group: c,
 				type: "string"
 			}
 		});
 	},
 	push: async (n, r) => {
 		let [i, o] = await t(n.secretsFile);
-		o || (d.error(`${a.blue(n.secretsFile)} not found`), process.exit(1)), d.silly("local secrets loaded:", i);
-		let s = await h(n, r?.[n.env]?.vaultUrl);
-		d.info("pushing variables to store");
-		let c = await s.setAll(i);
-		d.silly("secrets pushed:", c);
-		let l = await e([{
-			key: u,
+		o || (l.error(`${a.blue(n.secretsFile)} not found`), process.exit(1)), l.silly("local secrets loaded:", i);
+		let s = await p(n, r?.[n.env]?.vaultUrl);
+		l.info("pushing variables to store");
+		let u = await s.setAll(i);
+		l.silly("secrets pushed:", u);
+		let d = await e([{
+			key: c,
 			value: i
 		}], n);
-		d.silly("schema for akv updated:", l);
+		l.silly("schema for akv updated:", d);
 	},
 	pull: async (e, t) => {
-		let r = e.schema?.[u];
+		let r = e.schema?.[c];
 		if (!r) {
-			d.error("no schema found, you can gen one with \"env schema -e {env} -m {modes}\""), d.info(`generated empty ${a.bold(a.underline(a.yellowBright(e.secretsFile)))} file (you can retry the command)`), await n(e.secretsFile, {}, !1, !0);
+			l.error("no schema found, you can gen one with \"env schema -e {env} -m {modes}\""), l.info(`generated empty ${a.bold(a.underline(a.yellowBright(e.secretsFile)))} file (you can retry the command)`), await n(e.secretsFile, {}, !1, !0);
 			return;
 		}
 		let o = i(r), s = t?.[e.env]?.vaultUrl;
 		if (!s) return n(e.secretsFile, {}, !1, !0);
-		let c = await h(e, s);
-		d.info(`pulling stored secrets from ${a.underline(a.yellowBright(s))}`);
-		let l = await c.getFor(o, !0);
-		d.silly("remote secrets loaded:", l), await n(e.secretsFile, l, e.overwrite, !0);
+		let u = await p(e, s);
+		l.info(`pulling stored secrets from ${a.underline(a.yellowBright(s))}`);
+		let d = await u.getFor(o, !0);
+		l.silly("remote secrets loaded:", d), await n(e.secretsFile, d, e.overwrite, !0);
 	},
 	load: async (e, n) => {
 		let { env: r, secretsFile: i } = e;
-		if (!r) return d.silly("no env, so skipping provider"), [];
-		o(i) || (d.warn("secrets file not found, pulling from store"), await f.pull(e, n));
+		if (!r) return l.silly("no env, so skipping provider"), [];
+		o(i) || (l.warn("secrets file not found, pulling from store"), await u.pull(e, n));
 		let [a] = await t(i);
 		return [a];
 	}
 };
-function p(e) {
+function d(e) {
 	return !!(e && e.clientId && e.clientSecret && e.tenantId);
 }
-async function m(e, n) {
-	d.debug(`searching keys at ${a.yellow(n.join(","))}`);
-	let [r] = (await Promise.all(n.map((e) => t(e)))).find(([t, n]) => n && p(t[e])) ?? [null];
+async function f(e, n) {
+	l.debug(`searching keys at ${a.yellow(n.join(","))}`);
+	let [r] = (await Promise.all(n.map((e) => t(e)))).find(([t, n]) => n && d(t[e])) ?? [null];
 	return r?.[e] ?? {};
 }
-async function h({ env: e, keysFile: t, mock: n, password: r, projectInfo: i, skipDnsCheck: o, spn: l, tenant: u, vaultUrl: f }, h) {
-	let _ = process.env.AZURE_VAULT_URL ?? f ?? h, v = {
+async function p({ env: e, keysFile: t, mock: n, password: r, projectInfo: i, skipDnsCheck: o, spn: s, tenant: c, vaultUrl: u }, p) {
+	let h = process.env.AZURE_VAULT_URL ?? u ?? p, g = {
 		env: e,
 		group: process.env.AZURE_GROUP ?? i.name,
 		project: process.env.AZURE_PROJECT ?? i.project
 	};
-	v.project || (d.error(`no project info from ${a.blue("package.json")} found`), process.exit(1));
-	let y = {
-		clientId: process.env.AZURE_CLIENT_ID ?? l,
-		tenantId: process.env.AZURE_TENANT_ID ?? u,
+	g.project || (l.error(`no project info from ${a.blue("package.json")} found`), process.exit(1));
+	let _ = {
+		clientId: process.env.AZURE_CLIENT_ID ?? s,
+		tenantId: process.env.AZURE_TENANT_ID ?? c,
 		clientSecret: process.env.AZURE_CLIENT_SECRET ?? r
 	};
-	if (t && t.length > 0 && !p(y)) {
-		let n = await m(e, t);
-		_ ??= n.vaultUrl, y.clientId ??= n.clientId, y.clientSecret ??= n.clientSecret, y.tenantId ??= n.tenantId;
+	if (t && t.length > 0 && !d(_)) {
+		let n = await f(e, t);
+		h ??= n.vaultUrl, _.clientId ??= n.clientId, _.clientSecret ??= n.clientSecret, _.tenantId ??= n.tenantId;
 	}
-	if (d.debug(`credentials loaded for project ${a.bold(a.underline(a.yellowBright(v.project)))} and group ${a.bold(a.underline(a.yellowBright(v.group)))}`), d.debug(`connected to ${a.bold(a.underline(a.greenBright(_)))}`), n) return c(v);
-	let b = new s(_, v, y);
-	return o || await g(_), b;
+	l.debug(`credentials loaded for project ${a.bold(a.underline(a.yellowBright(g.project)))} and group ${a.bold(a.underline(a.yellowBright(g.group)))}`), l.debug(`connected to ${a.bold(a.underline(a.greenBright(h)))}`);
+	let { AzureKeyVault: v, createAzureKeyVaultMock: y } = await import("@achs/azure-key-vault");
+	if (n) return y(g);
+	let b = new v(h, g, _);
+	return o || await m(h), b;
 }
-function g(e) {
-	let t = new l.Resolver();
+function m(e) {
+	let t = new s.Resolver();
 	return t.setServers(["8.8.8.8", "1.1.1.1"]), new Promise((n) => {
 		t.resolve4(new URL(e).hostname, (t) => {
-			t && (d.error(`cannot resolve vault host ${a.red(e)}`, t), process.exit(1)), d.debug(`vault host reachable ${a.green(e)}`), n();
+			t && (l.error(`cannot resolve vault host ${a.red(e)}`, t), process.exit(1)), l.debug(`vault host reachable ${a.green(e)}`), n();
 		});
 	});
 }
 //#endregion
-export { f as AzureKeyVaultProvider };
+export { u as AzureKeyVaultProvider };
 
 //# sourceMappingURL=azure-key-vault.provider.js.map

package/providers/azure-key-vault.provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"azure-key-vault.provider.js","names":[],"sources":["../../src/providers/azure-key-vault.provider.ts"],"sourcesContent":["import { AzureKeyVault, createAzureKeyVaultMock } from '@achs/azure-key-vault';\r\nimport type { AzureKeyVaultSecrets } from '@achs/azure-key-vault';\r\nimport dns from 'node:dns';\r\nimport { existsSync } from 'node:fs';\r\nimport pc from 'picocolors';\r\nimport type { Arguments } from 'yargs';\r\nimport type { CommandArguments } from '../arguments.js';\r\nimport type { PullCommandArguments } from '../commands/pull.command.js';\r\nimport type { EnvProvider } from '../interfaces/index.js';\r\nimport {\r\n\tgenerateSchemaFrom,\r\n\tlogger as globalLogger,\r\n\treadJson,\r\n\tschemaToJson,\r\n\twriteJson,\r\n} from '../utils/index.js';\r\n\r\nconst KEY = 'azure-key-vault';\r\n\r\nconst logger = globalLogger.getSubLogger({\r\n\tprefix: [pc.bold(pc.blue(`[${KEY}]`))],\r\n});\r\n\r\ninterface AzureKeyVaultCommandArguments extends CommandArguments {\r\n\tmock: boolean;\r\n\tpassword: string;\r\n\tsecretsFile: string;\r\n\tskipDnsCheck: boolean;\r\n\tspn: string;\r\n\ttenant: string;\r\n\tvaultUrl: string;\r\n\tkeysFile?: string[];\r\n}\r\n\r\ninterface AzureKeyVaultCommandConfig {\r\n\t[key: string]: {\r\n\t\tvaultUrl: string;\r\n\t};\r\n}\r\n\r\n/**\r\n * Loads secrets from env files in env/secrets\r\n * folder, loaded from Azure Key Vault.\r\n */\r\nexport const AzureKeyVaultProvider: EnvProvider<\r\n\tAzureKeyVaultCommandArguments & PullCommandArguments,\r\n\tAzureKeyVaultCommandConfig\r\n> = {\r\n\tkey: KEY,\r\n\r\n\tbuilder: (builder) => {\r\n\t\tbuilder.options({\r\n\t\t\tkeysFile: {\r\n\t\t\t\talias: ['k', 'keys'],\r\n\t\t\t\tdefault: ['[[root]]/keys.json', '../keys.json'],\r\n\t\t\t\tdescribe: 'Azure Key Vault keys file path',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'array',\r\n\t\t\t},\r\n\t\t\tmock: {\r\n\t\t\t\tdefault: false,\r\n\t\t\t\tdescribe: 'Mocks Azure Key Vault client',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'boolean',\r\n\t\t\t},\r\n\t\t\tpassword: {\r\n\t\t\t\talias: ['p', 'pass', 'clientSecret'],\r\n\t\t\t\tdescribe: 'SPN Client Secret Password',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t\tsecretsFile: {\r\n\t\t\t\tdefault: '[[root]]/[[env]].env.json',\r\n\t\t\t\tdescribe: 'Secret variables file path',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t\tskipDnsCheck: {\r\n\t\t\t\talias: 'dns',\r\n\t\t\t\tdefault: false,\r\n\t\t\t\tdescribe: 'Skips DNS checking when connect to Azure Key Vault',\r\n\t\t\t\ttype: 'boolean',\r\n\t\t\t},\r\n\t\t\tspn: {\r\n\t\t\t\talias: ['clientId', 'id'],\r\n\t\t\t\tdescribe: 'SPN Client ID',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t\ttenant: {\r\n\t\t\t\talias: 't',\r\n\t\t\t\tdescribe: 'Azure Tenant ID',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t\tvaultUrl: {\r\n\t\t\t\talias: 'url',\r\n\t\t\t\tdescribe: 'Azure Key Vault URL',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t});\r\n\t},\r\n\r\n\tpush: async (argv, config) => {\r\n\t\tconst [secrets, secretsWasFound] = await readJson(argv.secretsFile);\r\n\r\n\t\tif (!secretsWasFound) {\r\n\t\t\tlogger.error(`${pc.blue(argv.secretsFile)} not found`);\r\n\r\n\t\t\tprocess.exit(1);\r\n\t\t}\r\n\r\n\t\tlogger.silly('local secrets loaded:', secrets);\r\n\t\tconst akv = await loadAzureKeyVaultClient(\r\n\t\t\targv,\r\n\t\t\tconfig?.[argv.env]?.vaultUrl,\r\n\t\t);\r\n\t\tlogger.info('pushing variables to store');\r\n\t\tconst results = await akv.setAll(secrets);\r\n\t\tlogger.silly('secrets pushed:', results);\r\n\r\n\t\tconst schema = await generateSchemaFrom(\r\n\t\t\t[{ key: KEY, value: secrets }],\r\n\t\t\targv,\r\n\t\t);\r\n\r\n\t\tlogger.silly('schema for akv updated:', schema);\r\n\t},\r\n\r\n\tpull: async (argv, config) => {\r\n\t\tconst schema = argv.schema?.[KEY] as\r\n\t\t\t| Record<string, unknown>\r\n\t\t\t| undefined;\r\n\r\n\t\tif (!schema) {\r\n\t\t\tlogger.error(\r\n\t\t\t\t'no schema found, you can gen one with \"env schema -e {env} -m {modes}\"',\r\n\t\t\t);\r\n\r\n\t\t\tlogger.info(\r\n\t\t\t\t`generated empty ${pc.bold(\r\n\t\t\t\t\tpc.underline(pc.yellowBright(argv.secretsFile)),\r\n\t\t\t\t)} file (you can retry the command)`,\r\n\t\t\t);\r\n\t\t\tawait writeJson(argv.secretsFile, {}, false, true);\r\n\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tconst jsonTemplate = schemaToJson(schema) as Record<string, unknown>;\r\n\r\n\t\tconst vaultUrl = config?.[argv.env]?.vaultUrl;\r\n\t\tif (!vaultUrl) return writeJson(argv.secretsFile, {}, false, true);\r\n\r\n\t\tconst akv = await loadAzureKeyVaultClient(argv, vaultUrl);\r\n\r\n\t\tlogger.info(\r\n\t\t\t`pulling stored secrets from ${pc.underline(pc.yellowBright(vaultUrl))}`,\r\n\t\t);\r\n\r\n\t\tconst secrets = await akv.getFor(\r\n\t\t\tjsonTemplate as AzureKeyVaultSecrets,\r\n\t\t\ttrue,\r\n\t\t);\r\n\r\n\t\tlogger.silly('remote secrets loaded:', secrets);\r\n\r\n\t\tawait writeJson(argv.secretsFile, secrets, argv.overwrite, true);\r\n\t},\r\n\r\n\tload: async (argv, config) => {\r\n\t\tconst { env, secretsFile } = argv;\r\n\r\n\t\tif (!env) {\r\n\t\t\tlogger.silly('no env, so skipping provider');\r\n\r\n\t\t\treturn [];\r\n\t\t}\r\n\r\n\t\tif (!existsSync(secretsFile)) {\r\n\t\t\tlogger.warn('secrets file not found, pulling from store');\r\n\r\n\t\t\tawait AzureKeyVaultProvider.pull!(argv, config);\r\n\t\t}\r\n\r\n\t\tconst [secrets] = await readJson(secretsFile);\r\n\r\n\t\treturn [secrets];\r\n\t},\r\n};\r\n\r\n/**\r\n * Validate SPN credentials/keys.\r\n *\r\n * @param {(Record<string, any> | null)} keys\r\n *\r\n * @returns {boolean}\r\n */\r\nfunction keysAreValid(keys: Record<string, any> | null): boolean {\r\n\treturn Boolean(keys && keys.clientId && keys.clientSecret && keys.tenantId);\r\n}\r\n\r\n/**\r\n * Loads SPN Azure Key Vault credentials from keys file.\r\n *\r\n * @param {string} env\r\n * @param {string[]} paths\r\n *\r\n * @returns {Record<string, string>} credentials\r\n */\r\nasync function loadKeysFile(\r\n\tenv: string,\r\n\tpaths: string[],\r\n): Promise<Record<string, string>> {\r\n\tlogger.debug(`searching keys at ${pc.yellow(paths.join(','))}`);\r\n\r\n\tconst readers = await Promise.all(paths.map((path) => readJson(path)));\r\n\r\n\tconst [keys] = readers.find(\r\n\t\t([candidate, wasFound]) => wasFound && keysAreValid(candidate[env]),\r\n\t) ?? [null];\r\n\r\n\treturn keys?.[env] ?? {};\r\n}\r\n\r\n/**\r\n * Loads credentials and initializes Azure Key Vault client.\r\n *\r\n * @param {Arguments<AzureKeyVaultCommandArguments>} argv command arguments\r\n *\r\n * @returns {*}  {Promise<AzureKeyVault>}\r\n */\r\n// linear credential-resolution (env vars → args → keys file precedence);\r\n// complexity comes from `??` fallbacks, not tangled control flow\r\n// eslint-disable-next-line complexity\r\nasync function loadAzureKeyVaultClient(\r\n\t{\r\n\t\tenv,\r\n\t\tkeysFile,\r\n\t\tmock,\r\n\t\tpassword,\r\n\t\tprojectInfo,\r\n\t\tskipDnsCheck,\r\n\t\tspn,\r\n\t\ttenant,\r\n\t\tvaultUrl,\r\n\t}: Arguments<AzureKeyVaultCommandArguments>,\r\n\tconfigVaultUrl?: string,\r\n): Promise<AzureKeyVault> {\r\n\tlet url = process.env.AZURE_VAULT_URL ?? vaultUrl ?? configVaultUrl;\r\n\r\n\tconst config = {\r\n\t\tenv,\r\n\t\tgroup: process.env.AZURE_GROUP ?? projectInfo.name,\r\n\t\tproject: process.env.AZURE_PROJECT ?? projectInfo.project,\r\n\t};\r\n\r\n\tif (!config.project) {\r\n\t\tlogger.error(`no project info from ${pc.blue('package.json')} found`);\r\n\r\n\t\tprocess.exit(1);\r\n\t}\r\n\r\n\tconst credentials = {\r\n\t\tclientId: process.env.AZURE_CLIENT_ID ?? spn,\r\n\t\ttenantId: process.env.AZURE_TENANT_ID ?? tenant,\r\n\t\tclientSecret: process.env.AZURE_CLIENT_SECRET ?? password,\r\n\t};\r\n\r\n\tif (keysFile && keysFile.length > 0 && !keysAreValid(credentials)) {\r\n\t\tconst keys = await loadKeysFile(env, keysFile);\r\n\r\n\t\turl ??= keys.vaultUrl;\r\n\t\tcredentials.clientId ??= keys.clientId;\r\n\t\tcredentials.clientSecret ??= keys.clientSecret;\r\n\t\tcredentials.tenantId ??= keys.tenantId;\r\n\t}\r\n\r\n\tlogger.debug(\r\n\t\t`credentials loaded for project ${pc.bold(\r\n\t\t\tpc.underline(pc.yellowBright(config.project)),\r\n\t\t)} and group ${pc.bold(pc.underline(pc.yellowBright(config.group)))}`,\r\n\t);\r\n\r\n\tlogger.debug(`connected to ${pc.bold(pc.underline(pc.greenBright(url)))}`);\r\n\r\n\tif (mock) return createAzureKeyVaultMock(config);\r\n\r\n\tconst akv = new AzureKeyVault(url, config, credentials);\r\n\r\n\tif (!skipDnsCheck) await verifyVaultReachable(url);\r\n\r\n\treturn akv;\r\n}\r\n\r\n/**\r\n * Best-effort DNS reachability check for the vault host. Resolves the hostname\r\n * via public resolvers; logs and exits on failure. Does NOT issue a\r\n * guaranteed-failing secret call (the old `getSecret('')` probe).\r\n */\r\nfunction verifyVaultReachable(url: string): Promise<void> {\r\n\tconst resolver = new dns.Resolver();\r\n\r\n\tresolver.setServers(['8.8.8.8', '1.1.1.1']);\r\n\r\n\treturn new Promise<void>((resolve) => {\r\n\t\tresolver.resolve4(new URL(url).hostname, (error) => {\r\n\t\t\tif (error) {\r\n\t\t\t\tlogger.error(`cannot resolve vault host ${pc.red(url)}`, error);\r\n\t\t\t\tprocess.exit(1);\r\n\t\t\t}\r\n\r\n\t\t\tlogger.debug(`vault host reachable ${pc.green(url)}`);\r\n\t\t\tresolve();\r\n\t\t});\r\n\t});\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"azure-key-vault.provider.js","names":[],"sources":["../../src/providers/azure-key-vault.provider.ts"],"sourcesContent":["import type {\r\n\tAzureKeyVault,\r\n\tAzureKeyVaultSecrets,\r\n} from '@achs/azure-key-vault';\r\nimport dns from 'node:dns';\r\nimport { existsSync } from 'node:fs';\r\nimport pc from 'picocolors';\r\nimport type { Arguments } from 'yargs';\r\nimport type { CommandArguments } from '../arguments.js';\r\nimport type { PullCommandArguments } from '../commands/pull.command.js';\r\nimport type { EnvProvider } from '../interfaces/index.js';\r\nimport {\r\n\tgenerateSchemaFrom,\r\n\tlogger as globalLogger,\r\n\treadJson,\r\n\tschemaToJson,\r\n\twriteJson,\r\n} from '../utils/index.js';\r\n\r\nconst KEY = 'azure-key-vault';\r\n\r\nconst logger = globalLogger.getSubLogger({\r\n\tprefix: [pc.bold(pc.blue(`[${KEY}]`))],\r\n});\r\n\r\ninterface AzureKeyVaultCommandArguments extends CommandArguments {\r\n\tmock: boolean;\r\n\tpassword: string;\r\n\tsecretsFile: string;\r\n\tskipDnsCheck: boolean;\r\n\tspn: string;\r\n\ttenant: string;\r\n\tvaultUrl: string;\r\n\tkeysFile?: string[];\r\n}\r\n\r\ninterface AzureKeyVaultCommandConfig {\r\n\t[key: string]: {\r\n\t\tvaultUrl: string;\r\n\t};\r\n}\r\n\r\n/**\r\n * Loads secrets from env files in env/secrets\r\n * folder, loaded from Azure Key Vault.\r\n */\r\nexport const AzureKeyVaultProvider: EnvProvider<\r\n\tAzureKeyVaultCommandArguments & PullCommandArguments,\r\n\tAzureKeyVaultCommandConfig\r\n> = {\r\n\tkey: KEY,\r\n\r\n\tbuilder: (builder) => {\r\n\t\tbuilder.options({\r\n\t\t\tkeysFile: {\r\n\t\t\t\talias: ['k', 'keys'],\r\n\t\t\t\tdefault: ['[[root]]/keys.json', '../keys.json'],\r\n\t\t\t\tdescribe: 'Azure Key Vault keys file path',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'array',\r\n\t\t\t},\r\n\t\t\tmock: {\r\n\t\t\t\tdefault: false,\r\n\t\t\t\tdescribe: 'Mocks Azure Key Vault client',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'boolean',\r\n\t\t\t},\r\n\t\t\tpassword: {\r\n\t\t\t\talias: ['p', 'pass', 'clientSecret'],\r\n\t\t\t\tdescribe: 'SPN Client Secret Password',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t\tsecretsFile: {\r\n\t\t\t\tdefault: '[[root]]/[[env]].env.json',\r\n\t\t\t\tdescribe: 'Secret variables file path',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t\tskipDnsCheck: {\r\n\t\t\t\talias: 'dns',\r\n\t\t\t\tdefault: false,\r\n\t\t\t\tdescribe: 'Skips DNS checking when connect to Azure Key Vault',\r\n\t\t\t\ttype: 'boolean',\r\n\t\t\t},\r\n\t\t\tspn: {\r\n\t\t\t\talias: ['clientId', 'id'],\r\n\t\t\t\tdescribe: 'SPN Client ID',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t\ttenant: {\r\n\t\t\t\talias: 't',\r\n\t\t\t\tdescribe: 'Azure Tenant ID',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t\tvaultUrl: {\r\n\t\t\t\talias: 'url',\r\n\t\t\t\tdescribe: 'Azure Key Vault URL',\r\n\t\t\t\tgroup: KEY,\r\n\t\t\t\ttype: 'string',\r\n\t\t\t},\r\n\t\t});\r\n\t},\r\n\r\n\tpush: async (argv, config) => {\r\n\t\tconst [secrets, secretsWasFound] = await readJson(argv.secretsFile);\r\n\r\n\t\tif (!secretsWasFound) {\r\n\t\t\tlogger.error(`${pc.blue(argv.secretsFile)} not found`);\r\n\r\n\t\t\tprocess.exit(1);\r\n\t\t}\r\n\r\n\t\tlogger.silly('local secrets loaded:', secrets);\r\n\t\tconst akv = await loadAzureKeyVaultClient(\r\n\t\t\targv,\r\n\t\t\tconfig?.[argv.env]?.vaultUrl,\r\n\t\t);\r\n\t\tlogger.info('pushing variables to store');\r\n\t\tconst results = await akv.setAll(secrets);\r\n\t\tlogger.silly('secrets pushed:', results);\r\n\r\n\t\tconst schema = await generateSchemaFrom(\r\n\t\t\t[{ key: KEY, value: secrets }],\r\n\t\t\targv,\r\n\t\t);\r\n\r\n\t\tlogger.silly('schema for akv updated:', schema);\r\n\t},\r\n\r\n\tpull: async (argv, config) => {\r\n\t\tconst schema = argv.schema?.[KEY] as\r\n\t\t\t| Record<string, unknown>\r\n\t\t\t| undefined;\r\n\r\n\t\tif (!schema) {\r\n\t\t\tlogger.error(\r\n\t\t\t\t'no schema found, you can gen one with \"env schema -e {env} -m {modes}\"',\r\n\t\t\t);\r\n\r\n\t\t\tlogger.info(\r\n\t\t\t\t`generated empty ${pc.bold(\r\n\t\t\t\t\tpc.underline(pc.yellowBright(argv.secretsFile)),\r\n\t\t\t\t)} file (you can retry the command)`,\r\n\t\t\t);\r\n\t\t\tawait writeJson(argv.secretsFile, {}, false, true);\r\n\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tconst jsonTemplate = schemaToJson(schema) as Record<string, unknown>;\r\n\r\n\t\tconst vaultUrl = config?.[argv.env]?.vaultUrl;\r\n\t\tif (!vaultUrl) return writeJson(argv.secretsFile, {}, false, true);\r\n\r\n\t\tconst akv = await loadAzureKeyVaultClient(argv, vaultUrl);\r\n\r\n\t\tlogger.info(\r\n\t\t\t`pulling stored secrets from ${pc.underline(pc.yellowBright(vaultUrl))}`,\r\n\t\t);\r\n\r\n\t\tconst secrets = await akv.getFor(\r\n\t\t\tjsonTemplate as AzureKeyVaultSecrets,\r\n\t\t\ttrue,\r\n\t\t);\r\n\r\n\t\tlogger.silly('remote secrets loaded:', secrets);\r\n\r\n\t\tawait writeJson(argv.secretsFile, secrets, argv.overwrite, true);\r\n\t},\r\n\r\n\tload: async (argv, config) => {\r\n\t\tconst { env, secretsFile } = argv;\r\n\r\n\t\tif (!env) {\r\n\t\t\tlogger.silly('no env, so skipping provider');\r\n\r\n\t\t\treturn [];\r\n\t\t}\r\n\r\n\t\tif (!existsSync(secretsFile)) {\r\n\t\t\tlogger.warn('secrets file not found, pulling from store');\r\n\r\n\t\t\tawait AzureKeyVaultProvider.pull!(argv, config);\r\n\t\t}\r\n\r\n\t\tconst [secrets] = await readJson(secretsFile);\r\n\r\n\t\treturn [secrets];\r\n\t},\r\n};\r\n\r\n/**\r\n * Validate SPN credentials/keys.\r\n *\r\n * @param {(Record<string, any> | null)} keys\r\n *\r\n * @returns {boolean}\r\n */\r\nfunction keysAreValid(keys: Record<string, any> | null): boolean {\r\n\treturn Boolean(keys && keys.clientId && keys.clientSecret && keys.tenantId);\r\n}\r\n\r\n/**\r\n * Loads SPN Azure Key Vault credentials from keys file.\r\n *\r\n * @param {string} env\r\n * @param {string[]} paths\r\n *\r\n * @returns {Record<string, string>} credentials\r\n */\r\nasync function loadKeysFile(\r\n\tenv: string,\r\n\tpaths: string[],\r\n): Promise<Record<string, string>> {\r\n\tlogger.debug(`searching keys at ${pc.yellow(paths.join(','))}`);\r\n\r\n\tconst readers = await Promise.all(paths.map((path) => readJson(path)));\r\n\r\n\tconst [keys] = readers.find(\r\n\t\t([candidate, wasFound]) => wasFound && keysAreValid(candidate[env]),\r\n\t) ?? [null];\r\n\r\n\treturn keys?.[env] ?? {};\r\n}\r\n\r\n/**\r\n * Loads credentials and initializes Azure Key Vault client.\r\n *\r\n * @param {Arguments<AzureKeyVaultCommandArguments>} argv command arguments\r\n *\r\n * @returns {*}  {Promise<AzureKeyVault>}\r\n */\r\n// linear credential-resolution (env vars → args → keys file precedence);\r\n// complexity comes from `??` fallbacks, not tangled control flow\r\n// eslint-disable-next-line complexity\r\nasync function loadAzureKeyVaultClient(\r\n\t{\r\n\t\tenv,\r\n\t\tkeysFile,\r\n\t\tmock,\r\n\t\tpassword,\r\n\t\tprojectInfo,\r\n\t\tskipDnsCheck,\r\n\t\tspn,\r\n\t\ttenant,\r\n\t\tvaultUrl,\r\n\t}: Arguments<AzureKeyVaultCommandArguments>,\r\n\tconfigVaultUrl?: string,\r\n): Promise<AzureKeyVault> {\r\n\tlet url = process.env.AZURE_VAULT_URL ?? vaultUrl ?? configVaultUrl;\r\n\r\n\tconst config = {\r\n\t\tenv,\r\n\t\tgroup: process.env.AZURE_GROUP ?? projectInfo.name,\r\n\t\tproject: process.env.AZURE_PROJECT ?? projectInfo.project,\r\n\t};\r\n\r\n\tif (!config.project) {\r\n\t\tlogger.error(`no project info from ${pc.blue('package.json')} found`);\r\n\r\n\t\tprocess.exit(1);\r\n\t}\r\n\r\n\tconst credentials = {\r\n\t\tclientId: process.env.AZURE_CLIENT_ID ?? spn,\r\n\t\ttenantId: process.env.AZURE_TENANT_ID ?? tenant,\r\n\t\tclientSecret: process.env.AZURE_CLIENT_SECRET ?? password,\r\n\t};\r\n\r\n\tif (keysFile && keysFile.length > 0 && !keysAreValid(credentials)) {\r\n\t\tconst keys = await loadKeysFile(env, keysFile);\r\n\r\n\t\turl ??= keys.vaultUrl;\r\n\t\tcredentials.clientId ??= keys.clientId;\r\n\t\tcredentials.clientSecret ??= keys.clientSecret;\r\n\t\tcredentials.tenantId ??= keys.tenantId;\r\n\t}\r\n\r\n\tlogger.debug(\r\n\t\t`credentials loaded for project ${pc.bold(\r\n\t\t\tpc.underline(pc.yellowBright(config.project)),\r\n\t\t)} and group ${pc.bold(pc.underline(pc.yellowBright(config.group)))}`,\r\n\t);\r\n\r\n\tlogger.debug(`connected to ${pc.bold(pc.underline(pc.greenBright(url)))}`);\r\n\r\n\tconst { AzureKeyVault, createAzureKeyVaultMock } =\r\n\t\tawait import('@achs/azure-key-vault');\r\n\r\n\tif (mock) return createAzureKeyVaultMock(config);\r\n\r\n\tconst akv = new AzureKeyVault(url, config, credentials);\r\n\r\n\tif (!skipDnsCheck) await verifyVaultReachable(url);\r\n\r\n\treturn akv;\r\n}\r\n\r\n/**\r\n * Best-effort DNS reachability check for the vault host. Resolves the hostname\r\n * via public resolvers; logs and exits on failure. Does NOT issue a\r\n * guaranteed-failing secret call (the old `getSecret('')` probe).\r\n */\r\nfunction verifyVaultReachable(url: string): Promise<void> {\r\n\tconst resolver = new dns.Resolver();\r\n\r\n\tresolver.setServers(['8.8.8.8', '1.1.1.1']);\r\n\r\n\treturn new Promise<void>((resolve) => {\r\n\t\tresolver.resolve4(new URL(url).hostname, (error) => {\r\n\t\t\tif (error) {\r\n\t\t\t\tlogger.error(`cannot resolve vault host ${pc.red(url)}`, error);\r\n\t\t\t\tprocess.exit(1);\r\n\t\t\t}\r\n\r\n\t\t\tlogger.debug(`vault host reachable ${pc.green(url)}`);\r\n\t\t\tresolve();\r\n\t\t});\r\n\t});\r\n}\r\n"],"mappings":"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"}

package/utils/command.util.d.ts

@@ -65,7 +65,7 @@ export declare function flatResults(results: EnvProviderResult[], nestingDelimit
  *
  * @returns {EnvProviderResult[]}
  */
-export declare function flatAndValidateResults(results: EnvProviderResult[], argv: Partial<Arguments<EnvCommandArguments>>): EnvProviderResult[] | never;
+export declare function flatAndValidateResults(results: EnvProviderResult[], argv: Partial<Arguments<EnvCommandArguments>>): Promise<EnvProviderResult[]>;
 /**
  * Creates or updates JSON schema from
  * environment variables grouped by provider key.

package/utils/command.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.util.d.ts","sourceRoot":"","sources":["../../src/utils/command.util.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EACX,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,wBAAwB,CAAC;AAWhC;;;;;GAKG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,YAkB5E;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAS9C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,YAAY,SAAK,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiBlC;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACzC,SAAS,EAAE,iBAAiB,EAAE,EAC9B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,GAC3C,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAY9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,OAAO,EAAE,iBAAiB,EAAE,EAC5B,gBAAgB,SAAO,GACrB,iBAAiB,EAAE,GAAG,KAAK,CAO7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,iBAAiB,EAAE,EAC5B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,GAC3C,iBAAiB,EAAE,GAAG,KAAK,CA6B7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,iBAAiB,EAAE,EACxB,IAAI,EAAE,SAAS,CAAC,gBAAgB,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAqBjB"}
+{"version":3,"file":"command.util.d.ts","sourceRoot":"","sources":["../../src/utils/command.util.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EACX,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,wBAAwB,CAAC;AAWhC;;;;;GAKG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,YAkB5E;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAS9C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,YAAY,SAAK,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiBlC;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACzC,SAAS,EAAE,iBAAiB,EAAE,EAC9B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,GAC3C,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAY9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,OAAO,EAAE,iBAAiB,EAAE,EAC5B,gBAAgB,SAAO,GACrB,iBAAiB,EAAE,GAAG,KAAK,CAO7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,iBAAiB,EAAE,EAC5B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,GAC3C,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA6B9B;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,iBAAiB,EAAE,EACxB,IAAI,EAAE,SAAS,CAAC,gBAAgB,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/utils/command.util.js

@@ -43,9 +43,9 @@ function h(e, t) {
 function g(e, t = "__") {
 	return e.flatMap(({ value: e }) => Array.isArray(e) ? c({}, ...e.map((e) => i(e, t))) : i(e, t));
 }
-function _(e, t) {
+async function _(e, t) {
 	if (!t.schemaValidate) return g(e, t.nestingDelimiter);
-	let n = a(t.schema, t.detectFormat);
+	let n = await a(t.schema, t.detectFormat);
 	return e.flatMap(({ key: e, value: a }) => {
 		let o = a;
 		Array.isArray(a) ? (a = c({}, ...a), o = c({}, ...o.map((e) => i(e, t.nestingDelimiter)))) : o = i(a, t.nestingDelimiter);
@@ -56,7 +56,7 @@ function _(e, t) {
 }
 async function v(e, t) {
 	let { detectFormat: r, nullable: i, resolve: a, schemaFile: s } = t, l = {};
-	for (let { key: t, value: n } of e) l[t] = o(Array.isArray(n) ? c({}, ...n) : n, {
+	for (let { key: t, value: n } of e) l[t] = await o(Array.isArray(n) ? c({}, ...n) : n, {
 		nullable: i,
 		strings: { detectFormat: r }
 	});

package/utils/command.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.util.js","names":[],"sources":["../../src/utils/command.util.ts"],"sourcesContent":["import merge from 'merge-deep';\r\nimport { readFileSync } from 'node:fs';\r\nimport Path from 'node:path';\r\nimport pc from 'picocolors';\r\nimport type { Arguments } from 'yargs';\r\nimport type { CommandArguments } from '../arguments.js';\r\nimport type { EnvCommandArguments } from '../commands/env.command.js';\r\nimport type {\r\n\tEnvProviderConfig,\r\n\tEnvProviderResult,\r\n} from '../interfaces/index.js';\r\nimport {\r\n\tcreateValidators,\r\n\tflatten,\r\n\tinterpolate,\r\n\tlogger,\r\n\treadJson,\r\n\tschemaFrom,\r\n\twriteJson,\r\n} from './index.js';\r\n\r\n/**\r\n * Injects config to command arguments from file.\r\n *\r\n * @param {Record<string, unknown>} argv\r\n * @param {[string, string]} delimiters\r\n */\r\nexport async function loadConfigFile(\r\n\targv: Record<string, unknown>,\r\n\tdelimiters: [string, string],\r\n): Promise<void> {\r\n\tif (typeof argv.configFile === 'string') {\r\n\t\tconst path = interpolate(argv.configFile, argv, delimiters);\r\n\t\tconst [config, success] = await readJson(path);\r\n\r\n\t\tif (success) for (const key in config) argv[key] ??= config[key];\r\n\t}\r\n}\r\n\r\n/**\r\n * Extracts subcommand from command line parameters.\r\n *\r\n * @export\r\n * @param {string[]} rawArgv process.argv.slice(2)\r\n * @param {[string, string]} delimiters\r\n *\r\n * @returns {string[]} subcommand for wrap if exists\r\n */\r\nexport function getSubcommand(rawArgv: string[], delimiters: [string, string]) {\r\n\tlet subcommand: string[] = [];\r\n\r\n\t// subcommand delimiter indexes\r\n\r\n\tconst begin = rawArgv.indexOf(delimiters[0]);\r\n\r\n\tconst count = rawArgv.lastIndexOf(delimiters[1]) - begin;\r\n\r\n\t// calculates subcommand surrounded by delimiters\r\n\tif (begin > 0) {\r\n\t\tsubcommand =\r\n\t\t\tcount > 0\r\n\t\t\t\t? rawArgv.splice(begin, count + 1).slice(1, -1)\r\n\t\t\t\t: rawArgv.splice(begin).slice(1);\r\n\t}\r\n\r\n\treturn subcommand;\r\n}\r\n\r\n/**\r\n * Loads providers JSON schema from file.\r\n *\r\n * @param {Record<string, unknown>} argv\r\n * @param {[string, string]} delimiters\r\n *\r\n * @returns {Promise<Record<string, unknown>>}\r\n */\r\nexport async function loadSchemaFile(\r\n\targv: Record<string, unknown>,\r\n\tdelimiters: [string, string],\r\n): Promise<Record<string, unknown> | undefined> {\r\n\tif (typeof argv.schemaFile === 'string') {\r\n\t\tconst path = interpolate(argv.schemaFile, argv, delimiters);\r\n\t\tconst [schema, success] = await readJson(path);\r\n\r\n\t\treturn success ? schema : undefined;\r\n\t}\r\n\r\n\treturn undefined;\r\n}\r\n\r\n/**\r\n * Reads project package.json.\r\n *\r\n * @export\r\n * @returns {Promise<Record<string, unknown>> | never}\r\n */\r\nexport function loadProjectInfo(\r\n\trelativePath = '',\r\n): Promise<Record<string, unknown>> {\r\n\ttry {\r\n\t\tconst filePath = Path.join(process.cwd(), relativePath, 'package.json');\r\n\r\n\t\treturn Promise.resolve(\r\n\t\t\tJSON.parse(readFileSync(filePath, 'utf8')) as Record<\r\n\t\t\t\tstring,\r\n\t\t\t\tunknown\r\n\t\t\t>,\r\n\t\t);\r\n\t} catch {\r\n\t\tlogger.warn(\r\n\t\t\t`project file ${pc.underline(pc.yellow('package.json'))} not found`,\r\n\t\t);\r\n\r\n\t\treturn Promise.resolve({});\r\n\t}\r\n}\r\n\r\n/**\r\n * Executes load functions from provider handlers.\r\n *\r\n * @param {EnvProviderConfig[]} providers\r\n * @param {Partial<Arguments<EnvCommandArguments>>} argv\r\n *\r\n * @returns {EnvProviderResult[]}\r\n */\r\nexport function loadVariablesFromProviders(\r\n\tproviders: EnvProviderConfig[],\r\n\targv: Partial<Arguments<EnvCommandArguments>>,\r\n): Promise<EnvProviderResult[]> {\r\n\tif (!providers) return Promise.resolve([]) as Promise<EnvProviderResult[]>;\r\n\r\n\treturn Promise.all(\r\n\t\tproviders.map(async ({ config, handler: { key, load } }) => {\r\n\t\t\tlogger.silly(`executing ${pc.yellow(key)} provider`);\r\n\r\n\t\t\tconst value = await load(argv, config);\r\n\r\n\t\t\treturn { config, key, value };\r\n\t\t}),\r\n\t);\r\n}\r\n\r\n/**\r\n * Flattern environment provider results.\r\n *\r\n * @param {EnvProviderResult[]} results\r\n * @param {Partial<Arguments<EnvCommandArguments>>} argv\r\n *\r\n * @throws {Error} on schema validation failed\r\n *\r\n * @returns {EnvProviderResult[]} flatten results\r\n */\r\nexport function flatResults(\r\n\tresults: EnvProviderResult[],\r\n\tnestingDelimiter = '__',\r\n): EnvProviderResult[] | never {\r\n\treturn results.flatMap(({ value }) => {\r\n\t\tif (Array.isArray(value))\r\n\t\t\treturn merge({}, ...value.map((v) => flatten(v, nestingDelimiter)));\r\n\r\n\t\treturn flatten(value, nestingDelimiter);\r\n\t});\r\n}\r\n\r\n/**\r\n * Flattern and validates environment provider results.\r\n *\r\n * @param {EnvProviderResult[]} results\r\n * @param {Partial<Arguments<EnvCommandArguments>>} argv\r\n *\r\n * @throws {Error} on schema validation failed\r\n *\r\n * @returns {EnvProviderResult[]}\r\n */\r\nexport function flatAndValidateResults(\r\n\tresults: EnvProviderResult[],\r\n\targv: Partial<Arguments<EnvCommandArguments>>,\r\n): EnvProviderResult[] | never {\r\n\tif (!argv.schemaValidate)\r\n\t\treturn flatResults(results, argv.nestingDelimiter);\r\n\r\n\tconst validators = createValidators(argv.schema!, argv.detectFormat);\r\n\r\n\treturn results.flatMap(({ key, value }) => {\r\n\t\tlet baseValue = value;\r\n\t\tif (Array.isArray(value)) {\r\n\t\t\tvalue = merge({}, ...value);\r\n\t\t\tbaseValue = merge(\r\n\t\t\t\t{},\r\n\t\t\t\t...baseValue.map((v: any) => flatten(v, argv.nestingDelimiter)),\r\n\t\t\t);\r\n\t\t} else {\r\n\t\t\tbaseValue = flatten(value, argv.nestingDelimiter);\r\n\t\t}\r\n\r\n\t\tconst validator = validators![key];\r\n\r\n\t\tif (!validator || validator?.(value)) return baseValue;\r\n\r\n\t\tlogger.error(\r\n\t\t\t`schema validation failed for ${pc.yellow(key)}`,\r\n\t\t\tvalidator?.errors,\r\n\t\t);\r\n\r\n\t\tthrow new Error(`schema validation failed for ${key}`);\r\n\t});\r\n}\r\n\r\n/**\r\n * Creates or updates JSON schema from\r\n * environment variables grouped by provider key.\r\n *\r\n * @export\r\n * @param {EnvProviderResult[]} env\r\n * @param {Arguments<EnvCommandArguments>} argv\r\n *\r\n * @returns {Promise<object>} JSON schema grouped by provider key.\r\n */\r\nexport async function generateSchemaFrom(\r\n\tenv: EnvProviderResult[],\r\n\targv: Arguments<CommandArguments>,\r\n): Promise<object> {\r\n\tconst { detectFormat, nullable, resolve, schemaFile } = argv;\r\n\r\n\t// generates schemas from providers results\r\n\tconst schemaEntries: Record<string, unknown> = {};\r\n\tfor (const { key, value } of env) {\r\n\t\tconst merged = Array.isArray(value) ? merge({}, ...value) : value;\r\n\r\n\t\tschemaEntries[key] = schemaFrom(merged, {\r\n\t\t\tnullable,\r\n\t\t\tstrings: { detectFormat },\r\n\t\t});\r\n\t}\r\n\r\n\tlet schema: Record<string, unknown> = schemaEntries;\r\n\r\n\tif (resolve === 'merge') schema = merge(argv.schema, schema);\r\n\r\n\tawait writeJson(schemaFile, schema, true);\r\n\r\n\treturn schema;\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"command.util.js","names":[],"sources":["../../src/utils/command.util.ts"],"sourcesContent":["import merge from 'merge-deep';\r\nimport { readFileSync } from 'node:fs';\r\nimport Path from 'node:path';\r\nimport pc from 'picocolors';\r\nimport type { Arguments } from 'yargs';\r\nimport type { CommandArguments } from '../arguments.js';\r\nimport type { EnvCommandArguments } from '../commands/env.command.js';\r\nimport type {\r\n\tEnvProviderConfig,\r\n\tEnvProviderResult,\r\n} from '../interfaces/index.js';\r\nimport {\r\n\tcreateValidators,\r\n\tflatten,\r\n\tinterpolate,\r\n\tlogger,\r\n\treadJson,\r\n\tschemaFrom,\r\n\twriteJson,\r\n} from './index.js';\r\n\r\n/**\r\n * Injects config to command arguments from file.\r\n *\r\n * @param {Record<string, unknown>} argv\r\n * @param {[string, string]} delimiters\r\n */\r\nexport async function loadConfigFile(\r\n\targv: Record<string, unknown>,\r\n\tdelimiters: [string, string],\r\n): Promise<void> {\r\n\tif (typeof argv.configFile === 'string') {\r\n\t\tconst path = interpolate(argv.configFile, argv, delimiters);\r\n\t\tconst [config, success] = await readJson(path);\r\n\r\n\t\tif (success) for (const key in config) argv[key] ??= config[key];\r\n\t}\r\n}\r\n\r\n/**\r\n * Extracts subcommand from command line parameters.\r\n *\r\n * @export\r\n * @param {string[]} rawArgv process.argv.slice(2)\r\n * @param {[string, string]} delimiters\r\n *\r\n * @returns {string[]} subcommand for wrap if exists\r\n */\r\nexport function getSubcommand(rawArgv: string[], delimiters: [string, string]) {\r\n\tlet subcommand: string[] = [];\r\n\r\n\t// subcommand delimiter indexes\r\n\r\n\tconst begin = rawArgv.indexOf(delimiters[0]);\r\n\r\n\tconst count = rawArgv.lastIndexOf(delimiters[1]) - begin;\r\n\r\n\t// calculates subcommand surrounded by delimiters\r\n\tif (begin > 0) {\r\n\t\tsubcommand =\r\n\t\t\tcount > 0\r\n\t\t\t\t? rawArgv.splice(begin, count + 1).slice(1, -1)\r\n\t\t\t\t: rawArgv.splice(begin).slice(1);\r\n\t}\r\n\r\n\treturn subcommand;\r\n}\r\n\r\n/**\r\n * Loads providers JSON schema from file.\r\n *\r\n * @param {Record<string, unknown>} argv\r\n * @param {[string, string]} delimiters\r\n *\r\n * @returns {Promise<Record<string, unknown>>}\r\n */\r\nexport async function loadSchemaFile(\r\n\targv: Record<string, unknown>,\r\n\tdelimiters: [string, string],\r\n): Promise<Record<string, unknown> | undefined> {\r\n\tif (typeof argv.schemaFile === 'string') {\r\n\t\tconst path = interpolate(argv.schemaFile, argv, delimiters);\r\n\t\tconst [schema, success] = await readJson(path);\r\n\r\n\t\treturn success ? schema : undefined;\r\n\t}\r\n\r\n\treturn undefined;\r\n}\r\n\r\n/**\r\n * Reads project package.json.\r\n *\r\n * @export\r\n * @returns {Promise<Record<string, unknown>> | never}\r\n */\r\nexport function loadProjectInfo(\r\n\trelativePath = '',\r\n): Promise<Record<string, unknown>> {\r\n\ttry {\r\n\t\tconst filePath = Path.join(process.cwd(), relativePath, 'package.json');\r\n\r\n\t\treturn Promise.resolve(\r\n\t\t\tJSON.parse(readFileSync(filePath, 'utf8')) as Record<\r\n\t\t\t\tstring,\r\n\t\t\t\tunknown\r\n\t\t\t>,\r\n\t\t);\r\n\t} catch {\r\n\t\tlogger.warn(\r\n\t\t\t`project file ${pc.underline(pc.yellow('package.json'))} not found`,\r\n\t\t);\r\n\r\n\t\treturn Promise.resolve({});\r\n\t}\r\n}\r\n\r\n/**\r\n * Executes load functions from provider handlers.\r\n *\r\n * @param {EnvProviderConfig[]} providers\r\n * @param {Partial<Arguments<EnvCommandArguments>>} argv\r\n *\r\n * @returns {EnvProviderResult[]}\r\n */\r\nexport function loadVariablesFromProviders(\r\n\tproviders: EnvProviderConfig[],\r\n\targv: Partial<Arguments<EnvCommandArguments>>,\r\n): Promise<EnvProviderResult[]> {\r\n\tif (!providers) return Promise.resolve([]) as Promise<EnvProviderResult[]>;\r\n\r\n\treturn Promise.all(\r\n\t\tproviders.map(async ({ config, handler: { key, load } }) => {\r\n\t\t\tlogger.silly(`executing ${pc.yellow(key)} provider`);\r\n\r\n\t\t\tconst value = await load(argv, config);\r\n\r\n\t\t\treturn { config, key, value };\r\n\t\t}),\r\n\t);\r\n}\r\n\r\n/**\r\n * Flattern environment provider results.\r\n *\r\n * @param {EnvProviderResult[]} results\r\n * @param {Partial<Arguments<EnvCommandArguments>>} argv\r\n *\r\n * @throws {Error} on schema validation failed\r\n *\r\n * @returns {EnvProviderResult[]} flatten results\r\n */\r\nexport function flatResults(\r\n\tresults: EnvProviderResult[],\r\n\tnestingDelimiter = '__',\r\n): EnvProviderResult[] | never {\r\n\treturn results.flatMap(({ value }) => {\r\n\t\tif (Array.isArray(value))\r\n\t\t\treturn merge({}, ...value.map((v) => flatten(v, nestingDelimiter)));\r\n\r\n\t\treturn flatten(value, nestingDelimiter);\r\n\t});\r\n}\r\n\r\n/**\r\n * Flattern and validates environment provider results.\r\n *\r\n * @param {EnvProviderResult[]} results\r\n * @param {Partial<Arguments<EnvCommandArguments>>} argv\r\n *\r\n * @throws {Error} on schema validation failed\r\n *\r\n * @returns {EnvProviderResult[]}\r\n */\r\nexport async function flatAndValidateResults(\r\n\tresults: EnvProviderResult[],\r\n\targv: Partial<Arguments<EnvCommandArguments>>,\r\n): Promise<EnvProviderResult[]> {\r\n\tif (!argv.schemaValidate)\r\n\t\treturn flatResults(results, argv.nestingDelimiter);\r\n\r\n\tconst validators = await createValidators(argv.schema!, argv.detectFormat);\r\n\r\n\treturn results.flatMap(({ key, value }) => {\r\n\t\tlet baseValue = value;\r\n\t\tif (Array.isArray(value)) {\r\n\t\t\tvalue = merge({}, ...value);\r\n\t\t\tbaseValue = merge(\r\n\t\t\t\t{},\r\n\t\t\t\t...baseValue.map((v: any) => flatten(v, argv.nestingDelimiter)),\r\n\t\t\t);\r\n\t\t} else {\r\n\t\t\tbaseValue = flatten(value, argv.nestingDelimiter);\r\n\t\t}\r\n\r\n\t\tconst validator = validators![key];\r\n\r\n\t\tif (!validator || validator?.(value)) return baseValue;\r\n\r\n\t\tlogger.error(\r\n\t\t\t`schema validation failed for ${pc.yellow(key)}`,\r\n\t\t\tvalidator?.errors,\r\n\t\t);\r\n\r\n\t\tthrow new Error(`schema validation failed for ${key}`);\r\n\t});\r\n}\r\n\r\n/**\r\n * Creates or updates JSON schema from\r\n * environment variables grouped by provider key.\r\n *\r\n * @export\r\n * @param {EnvProviderResult[]} env\r\n * @param {Arguments<EnvCommandArguments>} argv\r\n *\r\n * @returns {Promise<object>} JSON schema grouped by provider key.\r\n */\r\nexport async function generateSchemaFrom(\r\n\tenv: EnvProviderResult[],\r\n\targv: Arguments<CommandArguments>,\r\n): Promise<object> {\r\n\tconst { detectFormat, nullable, resolve, schemaFile } = argv;\r\n\r\n\t// generates schemas from providers results\r\n\tconst schemaEntries: Record<string, unknown> = {};\r\n\tfor (const { key, value } of env) {\r\n\t\tconst merged = Array.isArray(value) ? merge({}, ...value) : value;\r\n\r\n\t\tschemaEntries[key] = await schemaFrom(merged, {\r\n\t\t\tnullable,\r\n\t\t\tstrings: { detectFormat },\r\n\t\t});\r\n\t}\r\n\r\n\tlet schema: Record<string, unknown> = schemaEntries;\r\n\r\n\tif (resolve === 'merge') schema = merge(argv.schema, schema);\r\n\r\n\tawait writeJson(schemaFile, schema, true);\r\n\r\n\treturn schema;\r\n}\r\n"],"mappings":"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"}

package/utils/index.d.ts

@@ -5,4 +5,5 @@ export * from './json.util.js';
 export * from './logger.js';
 export * from './normalize.util.js';
 export * from './schema.util.js';
+export * from './ui.js';
 //# sourceMappingURL=index.d.ts.map

package/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/utils/index.js

@@ -5,4 +5,5 @@ import { readJson as f, resolvePath as p, writeEnvFromJson as m, writeJson as h
 import { LOG_LEVELS as g, configureLogger as _, createLogger as v, logger as y } from "./logger.js";
 import { flatten as b, normalize as x } from "./normalize.util.js";
 import { createValidator as S, createValidators as C, flatSchema as w, isJsonSchemaObject as T, schemaFrom as E, schemaToJson as D } from "./schema.util.js";
-export { g as LOG_LEVELS, _ as configureLogger, v as createLogger, S as createValidator, C as createValidators, t as flatAndValidateResults, n as flatResults, w as flatSchema, b as flatten, r as generateSchemaFrom, i as getSubcommand, l as interpolate, u as interpolateJson, T as isJsonSchemaObject, d as isRecord, a as loadConfigFile, o as loadProjectInfo, s as loadSchemaFile, c as loadVariablesFromProviders, y as logger, x as normalize, e as normalizeRawArgv, f as readJson, p as resolvePath, E as schemaFrom, D as schemaToJson, m as writeEnvFromJson, h as writeJson };
+import { formatDuration as O, ui as k } from "./ui.js";
+export { g as LOG_LEVELS, _ as configureLogger, v as createLogger, S as createValidator, C as createValidators, t as flatAndValidateResults, n as flatResults, w as flatSchema, b as flatten, O as formatDuration, r as generateSchemaFrom, i as getSubcommand, l as interpolate, u as interpolateJson, T as isJsonSchemaObject, d as isRecord, a as loadConfigFile, o as loadProjectInfo, s as loadSchemaFile, c as loadVariablesFromProviders, y as logger, x as normalize, e as normalizeRawArgv, f as readJson, p as resolvePath, E as schemaFrom, D as schemaToJson, k as ui, m as writeEnvFromJson, h as writeJson };

package/utils/json.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json.util.d.ts","sourceRoot":"","sources":["../../src/utils/json.util.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAI7C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,UAAQ,EACjB,eAAe,UAAQ,GACrB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,UAAQ,EACjB,MAAM,UAAQ,GACZ,OAAO,CAAC,OAAO,CAAC,CAiBlB"}
+{"version":3,"file":"json.util.d.ts","sourceRoot":"","sources":["../../src/utils/json.util.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAS7C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,UAAQ,EACjB,eAAe,UAAQ,GACrB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,UAAQ,EACjB,MAAM,UAAQ,GACZ,OAAO,CAAC,OAAO,CAAC,CAiBlB"}

package/utils/json.util.js

@@ -8,8 +8,13 @@ function o(e) {
 	let n = i.homedir();
 	return n && (e = e.replace(/^~($|\/|\\)/, `${n}$1`)), t.resolve(process.cwd(), e);
 }
-async function s(t) {
-	return e(t) ? [JSON.parse(await n(t, "utf8")), !0] : [{}, !1];
+async function s(e) {
+	try {
+		return [JSON.parse(await n(e, "utf8")), !0];
+	} catch (e) {
+		if (e.code === "ENOENT") return [{}, !1];
+		throw e;
+	}
 }
 async function c(t, n, i = !1, o = !1) {
 	return e(t) && !i ? !1 : (await r(t, `${JSON.stringify(n, o ? a : void 0, 4)}\n`, "utf8"), !0);

package/utils/json.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.util.js","names":[],"sources":["../../src/utils/json.util.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\r\nimport { readFile, writeFile } from 'node:fs/promises';\r\nimport os from 'node:os';\r\nimport path from 'node:path';\r\n\r\n/**\r\n * Replaces undefined by null in JSON.stringify()\r\n *\r\n * @param {string} _ property key\r\n * @param {any} value property value\r\n *\r\n * @returns {any} value\r\n */\r\nconst replacer = (_: string, value: any): any =>\r\n\tvalue === undefined ? null : value;\r\n\r\n/**\r\n * Resolve a relative path for os.\r\n *\r\n * @export\r\n * @param {string} filePath relative path from project root\r\n *\r\n * @returns {string} path\r\n */\r\nexport function resolvePath(filePath: string): string {\r\n\tconst home = os.homedir();\r\n\r\n\tif (home) filePath = filePath.replace(/^~($|\\/|\\\\)/, `${home}$1`);\r\n\r\n\treturn path.resolve(process.cwd(), filePath);\r\n}\r\n\r\n/**\r\n * Reads and parses a JSON file.\r\n *\r\n * @export\r\n * @template T\r\n * @param {string} path\r\n *\r\n * @returns {Promise<[Record<string, any>, boolean]>}\r\n */\r\nexport async function readJson<T = Record<string, any>>(\r\n\tpath: string,\r\n): Promise<[Record<string, any> | T, boolean]> {\r\n\tif (!existsSync(path)) return [{}, false];\r\n\r\n\treturn [JSON.parse(await readFile(path, 'utf8')), true];\r\n}\r\n\r\n/**\r\n * Saves a JSON into a file.\r\n *\r\n * @export\r\n * @param {string} path\r\n * @param {unknown} content\r\n * @param {false} overwrite\r\n * @param {false} undefinedAsNull replaces undefined by null\r\n *\r\n * @returns {Promise<boolean>}\r\n */\r\nexport async function writeJson(\r\n\tpath: string,\r\n\tcontent: Record<string, unknown>,\r\n\toverwrite = false,\r\n\tundefinedAsNull = false,\r\n): Promise<boolean> {\r\n\tconst exists = existsSync(path);\r\n\r\n\tif (exists && !overwrite) return false;\r\n\r\n\tawait writeFile(\r\n\t\tpath,\r\n\t\t`${JSON.stringify(\r\n\t\t\tcontent,\r\n\t\t\tundefinedAsNull ? replacer : undefined,\r\n\t\t\t4,\r\n\t\t)}\\n`,\r\n\t\t'utf8',\r\n\t);\r\n\r\n\treturn true;\r\n}\r\n\r\n/**\r\n * Saves a JSON into a file as dotenv.\r\n *\r\n * @export\r\n * @param {string} path\r\n * @param {unknown} content\r\n * @param {false} overwrite\r\n *\r\n * @returns {Promise<boolean>}\r\n */\r\nexport async function writeEnvFromJson(\r\n\tpath: string,\r\n\tcontent: Record<string, unknown>,\r\n\toverwrite = false,\r\n\tquotes = false,\r\n): Promise<boolean> {\r\n\tconst exists = existsSync(path);\r\n\r\n\tif (exists && !overwrite) return false;\r\n\r\n\tlet data = '';\r\n\r\n\tfor (const key in content) {\r\n\t\tlet value = content[key];\r\n\t\tif (quotes) value = `\"${value}\"`;\r\n\r\n\t\tdata += `${key}=${value}\\n`;\r\n\t}\r\n\r\n\tawait writeFile(path, data, 'utf8');\r\n\r\n\treturn true;\r\n}\r\n"],"mappings":";;;;;AAaA,IAAM,KAAY,GAAW,MAC5B,MAAU,KAAA,IAAY,OAAO;AAU9B,SAAgB,EAAY,GAA0B;CACrD,IAAM,IAAO,EAAG,QAAQ;CAIxB,OAFI,MAAM,IAAW,EAAS,QAAQ,eAAe,GAAG,EAAK,GAAG,IAEzD,EAAK,QAAQ,QAAQ,IAAI,GAAG,CAAQ;AAC5C;AAWA,eAAsB,EACrB,GAC8C;CAG9C,OAFK,EAAW,CAAI,IAEb,CAAC,KAAK,MAAM,MAAM,EAAS,GAAM,MAAM,CAAC,GAAG,EAAI,IAFxB,CAAC,CAAC,GAAG,EAAK;AAGzC;AAaA,eAAsB,EACrB,GACA,GACA,IAAY,IACZ,IAAkB,IACC;CAenB,OAde,EAAW,CAEtB,KAAU,CAAC,IAAkB,MAEjC,MAAM,EACL,GACA,GAAG,KAAK,UACP,GACA,IAAkB,IAAW,KAAA,GAC7B,CACD,EAAE,KACF,MACD,GAEO;AACR;AAYA,eAAsB,EACrB,GACA,GACA,IAAY,IACZ,IAAS,IACU;CAGnB,IAFe,EAAW,CAEtB,KAAU,CAAC,GAAW,OAAO;CAEjC,IAAI,IAAO;CAEX,KAAK,IAAM,KAAO,GAAS;EAC1B,IAAI,IAAQ,EAAQ;EAGpB,AAFI,MAAQ,IAAQ,IAAI,EAAM,KAE9B,KAAQ,GAAG,EAAI,GAAG,EAAM;CACzB;CAIA,OAFA,MAAM,EAAU,GAAM,GAAM,MAAM,GAE3B;AACR"}
+{"version":3,"file":"json.util.js","names":[],"sources":["../../src/utils/json.util.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\r\nimport { readFile, writeFile } from 'node:fs/promises';\r\nimport os from 'node:os';\r\nimport path from 'node:path';\r\n\r\n/**\r\n * Replaces undefined by null in JSON.stringify()\r\n *\r\n * @param {string} _ property key\r\n * @param {any} value property value\r\n *\r\n * @returns {any} value\r\n */\r\nconst replacer = (_: string, value: any): any =>\r\n\tvalue === undefined ? null : value;\r\n\r\n/**\r\n * Resolve a relative path for os.\r\n *\r\n * @export\r\n * @param {string} filePath relative path from project root\r\n *\r\n * @returns {string} path\r\n */\r\nexport function resolvePath(filePath: string): string {\r\n\tconst home = os.homedir();\r\n\r\n\tif (home) filePath = filePath.replace(/^~($|\\/|\\\\)/, `${home}$1`);\r\n\r\n\treturn path.resolve(process.cwd(), filePath);\r\n}\r\n\r\n/**\r\n * Reads and parses a JSON file.\r\n *\r\n * @export\r\n * @template T\r\n * @param {string} path\r\n *\r\n * @returns {Promise<[Record<string, any>, boolean]>}\r\n */\r\nexport async function readJson<T = Record<string, any>>(\r\n\tpath: string,\r\n): Promise<[Record<string, any> | T, boolean]> {\r\n\ttry {\r\n\t\treturn [JSON.parse(await readFile(path, 'utf8')), true];\r\n\t} catch (error) {\r\n\t\tif ((error as NodeJS.ErrnoException).code === 'ENOENT')\r\n\t\t\treturn [{}, false];\r\n\r\n\t\tthrow error; // invalid JSON or other IO error must still surface\r\n\t}\r\n}\r\n\r\n/**\r\n * Saves a JSON into a file.\r\n *\r\n * @export\r\n * @param {string} path\r\n * @param {unknown} content\r\n * @param {false} overwrite\r\n * @param {false} undefinedAsNull replaces undefined by null\r\n *\r\n * @returns {Promise<boolean>}\r\n */\r\nexport async function writeJson(\r\n\tpath: string,\r\n\tcontent: Record<string, unknown>,\r\n\toverwrite = false,\r\n\tundefinedAsNull = false,\r\n): Promise<boolean> {\r\n\tconst exists = existsSync(path);\r\n\r\n\tif (exists && !overwrite) return false;\r\n\r\n\tawait writeFile(\r\n\t\tpath,\r\n\t\t`${JSON.stringify(\r\n\t\t\tcontent,\r\n\t\t\tundefinedAsNull ? replacer : undefined,\r\n\t\t\t4,\r\n\t\t)}\\n`,\r\n\t\t'utf8',\r\n\t);\r\n\r\n\treturn true;\r\n}\r\n\r\n/**\r\n * Saves a JSON into a file as dotenv.\r\n *\r\n * @export\r\n * @param {string} path\r\n * @param {unknown} content\r\n * @param {false} overwrite\r\n *\r\n * @returns {Promise<boolean>}\r\n */\r\nexport async function writeEnvFromJson(\r\n\tpath: string,\r\n\tcontent: Record<string, unknown>,\r\n\toverwrite = false,\r\n\tquotes = false,\r\n): Promise<boolean> {\r\n\tconst exists = existsSync(path);\r\n\r\n\tif (exists && !overwrite) return false;\r\n\r\n\tlet data = '';\r\n\r\n\tfor (const key in content) {\r\n\t\tlet value = content[key];\r\n\t\tif (quotes) value = `\"${value}\"`;\r\n\r\n\t\tdata += `${key}=${value}\\n`;\r\n\t}\r\n\r\n\tawait writeFile(path, data, 'utf8');\r\n\r\n\treturn true;\r\n}\r\n"],"mappings":";;;;;AAaA,IAAM,KAAY,GAAW,MAC5B,MAAU,KAAA,IAAY,OAAO;AAU9B,SAAgB,EAAY,GAA0B;CACrD,IAAM,IAAO,EAAG,QAAQ;CAIxB,OAFI,MAAM,IAAW,EAAS,QAAQ,eAAe,GAAG,EAAK,GAAG,IAEzD,EAAK,QAAQ,QAAQ,IAAI,GAAG,CAAQ;AAC5C;AAWA,eAAsB,EACrB,GAC8C;CAC9C,IAAI;EACH,OAAO,CAAC,KAAK,MAAM,MAAM,EAAS,GAAM,MAAM,CAAC,GAAG,EAAI;CACvD,SAAS,GAAO;EACf,IAAK,EAAgC,SAAS,UAC7C,OAAO,CAAC,CAAC,GAAG,EAAK;EAElB,MAAM;CACP;AACD;AAaA,eAAsB,EACrB,GACA,GACA,IAAY,IACZ,IAAkB,IACC;CAenB,OAde,EAAW,CAEtB,KAAU,CAAC,IAAkB,MAEjC,MAAM,EACL,GACA,GAAG,KAAK,UACP,GACA,IAAkB,IAAW,KAAA,GAC7B,CACD,EAAE,KACF,MACD,GAEO;AACR;AAYA,eAAsB,EACrB,GACA,GACA,IAAY,IACZ,IAAS,IACU;CAGnB,IAFe,EAAW,CAEtB,KAAU,CAAC,GAAW,OAAO;CAEjC,IAAI,IAAO;CAEX,KAAK,IAAM,KAAO,GAAS;EAC1B,IAAI,IAAQ,EAAQ;EAGpB,AAFI,MAAQ,IAAQ,IAAI,EAAM,KAE9B,KAAQ,GAAG,EAAI,GAAG,EAAM;CACzB;CAIA,OAFA,MAAM,EAAU,GAAM,GAAM,MAAM,GAE3B;AACR"}