@super-repo/envx 0.2.3-b.4 → 0.2.3-b.5

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as createCli } from "./chunks/commands-D3eQPQO6.js";
+import { t as createCli } from "./chunks/commands-Cg8YMJHj.js";
 import { hideBin } from "yargs/helpers";
 //#region src/cli.ts
 createCli(hideBin(process.argv)).parseSync();

package/dist/commands/index.js

@@ -1,2 +1,2 @@
-import { t as createCli } from "../chunks/commands-D3eQPQO6.js";
+import { t as createCli } from "../chunks/commands-Cg8YMJHj.js";
 export { createCli };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { LoadEnvOptions } from '../../libs/src/index.ts';
-export { auditFiles, BUILT_IN_PATTERNS, type AuditFinding, type AuditOptions, type SecretPattern, ENCRYPTED_PREFIX, generateKeyPair, encryptValueAsymmetric, decryptValueAsymmetric, isEncrypted, encryptFiles, decryptFiles, rotateFiles, parseEnv, serializeEnv, toRecord, expandRecord, expandEnvSrc, loadDotenvxConfig, findWorkspaceRoot, resolveCwdOrWorkspace, resolveEnvPaths, detectEnvironment, readKeysFile, writeKeysFile, defaultKeysPath, } from '../../libs/src/index.ts';
+export { auditFiles, BUILT_IN_PATTERNS, type AuditFinding, type AuditOptions, type SecretPattern, ENCRYPTED_PREFIX, generateKeyPair, encryptValueAsymmetric, decryptValueAsymmetric, isEncrypted, encryptFiles, decryptFiles, rotateFiles, parseEnv, serializeEnv, toRecord, expandRecord, expandEnvSrc, defineConfig, loadDotenvxConfig, findWorkspaceRoot, resolveCwdOrWorkspace, resolveEnvPaths, detectEnvironment, readKeysFile, writeKeysFile, defaultKeysPath, } from '../../libs/src/index.ts';
 export type { DotenvxConfig, LoadEnvOptions, ProcessedEnv, ProcessingError, ErrorCode, RunOptions, RunResult, ExpandOptions, ExpandResult, EnvLine, KvLine, RawLine, } from '../../libs/src/index.ts';
 /**
  * Load env files into `process.env` and return it.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAEL,UAAU,EACV,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAElB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EAEX,YAAY,EACZ,YAAY,EACZ,WAAW,EAEX,QAAQ,EACR,YAAY,EACZ,QAAQ,EAER,YAAY,EACZ,YAAY,EAEZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EAEjB,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,OAAO,EACP,MAAM,EACN,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,iBAAS,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC;AACnC,iBAAS,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;AAChD,iBAAS,IAAI,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAAC,UAAU,CAAC;AAiGhE,eAAe,IAAI,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,CAAC;AAGhB,YAAY,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAEL,UAAU,EACV,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAElB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EAEX,YAAY,EACZ,YAAY,EACZ,WAAW,EAEX,QAAQ,EACR,YAAY,EACZ,QAAQ,EAER,YAAY,EACZ,YAAY,EAEZ,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EAEjB,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,OAAO,EACP,MAAM,EACN,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,iBAAS,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC;AACnC,iBAAS,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;AAChD,iBAAS,IAAI,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAAC,UAAU,CAAC;AAiGhE,eAAe,IAAI,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,CAAC;AAGhB,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { C as serializeEnv, D as encryptValueAsymmetric, E as decryptValueAsymmetric, O as generateKeyPair, S as parseEnv, T as ENCRYPTED_PREFIX, _ as resolveEnvPaths, a as rotateFiles, b as expandRecord, c as defaultKeysPath, f as detectEnvironment, g as resolveCwdOrWorkspace, h as loadEnv, i as auditFiles, k as isEncrypted, l as readKeysFile, n as loadDotenvxConfig, o as decryptFiles, p as findWorkspaceRoot, r as BUILT_IN_PATTERNS, s as encryptFiles, u as writeKeysFile, w as toRecord, y as expandEnvSrc } from "./chunks/src-D0n2wHDg.js";
+import { A as isEncrypted, C as parseEnv, D as decryptValueAsymmetric, E as ENCRYPTED_PREFIX, O as encryptValueAsymmetric, T as toRecord, _ as resolveCwdOrWorkspace, a as auditFiles, b as expandEnvSrc, c as encryptFiles, d as writeKeysFile, g as loadEnv, i as BUILT_IN_PATTERNS, k as generateKeyPair, l as defaultKeysPath, m as findWorkspaceRoot, n as defineConfig, o as rotateFiles, p as detectEnvironment, r as loadDotenvxConfig, s as decryptFiles, u as readKeysFile, v as resolveEnvPaths, w as serializeEnv, x as expandRecord } from "./chunks/src-jaqb5pGP.js";
 //#region src/index.ts
 function envx(arg) {
 	const { config: baseConfig } = loadDotenvxConfig();
@@ -59,6 +59,6 @@ function mergeOpts(config, user) {
 	return out;
 }
 //#endregion
-export { BUILT_IN_PATTERNS, ENCRYPTED_PREFIX, auditFiles, decryptFiles, decryptValueAsymmetric, envx as default, envx, defaultKeysPath, detectEnvironment, encryptFiles, encryptValueAsymmetric, expandEnvSrc, expandRecord, findWorkspaceRoot, generateKeyPair, isEncrypted, loadDotenvxConfig, parseEnv, readKeysFile, resolveCwdOrWorkspace, resolveEnvPaths, rotateFiles, serializeEnv, toRecord, writeKeysFile };
+export { BUILT_IN_PATTERNS, ENCRYPTED_PREFIX, auditFiles, decryptFiles, decryptValueAsymmetric, envx as default, envx, defaultKeysPath, defineConfig, detectEnvironment, encryptFiles, encryptValueAsymmetric, expandEnvSrc, expandRecord, findWorkspaceRoot, generateKeyPair, isEncrypted, loadDotenvxConfig, parseEnv, readKeysFile, resolveCwdOrWorkspace, resolveEnvPaths, rotateFiles, serializeEnv, toRecord, writeKeysFile };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["// #region -- Programmatic Entry Point ----------------------\n\nimport {\n  loadEnv,\n  loadDotenvxConfig,\n  type DotenvxConfig,\n  type LoadEnvOptions,\n} from \"@super-repo/envx-libs\";\n\n// Re-export the lib surface that consumers depend on (especially the\n// `auditFiles` API used by czar's `envxAuditPlugin`). Internal\n// packages `@super-repo/envx-libs` and `@super-repo/envx-common`\n// aren't on npm — `@super-repo/envx` is the only published entry, so\n// every public API has to be reachable from here.\nexport {\n  // Audit (plaintext-secret scanner)\n  auditFiles,\n  BUILT_IN_PATTERNS,\n  type AuditFinding,\n  type AuditOptions,\n  type SecretPattern,\n  // Crypto primitives\n  ENCRYPTED_PREFIX,\n  generateKeyPair,\n  encryptValueAsymmetric,\n  decryptValueAsymmetric,\n  isEncrypted,\n  // High-level operations\n  encryptFiles,\n  decryptFiles,\n  rotateFiles,\n  // Env-file parser\n  parseEnv,\n  serializeEnv,\n  toRecord,\n  // Variable expansion\n  expandRecord,\n  expandEnvSrc,\n  // Config + path resolution\n  loadDotenvxConfig,\n  findWorkspaceRoot,\n  resolveCwdOrWorkspace,\n  resolveEnvPaths,\n  detectEnvironment,\n  // Keys-file management\n  readKeysFile,\n  writeKeysFile,\n  defaultKeysPath,\n} from \"@super-repo/envx-libs\";\n\nexport type {\n  DotenvxConfig,\n  LoadEnvOptions,\n  ProcessedEnv,\n  ProcessingError,\n  ErrorCode,\n  RunOptions,\n  RunResult,\n  ExpandOptions,\n  ExpandResult,\n  EnvLine,\n  KvLine,\n  RawLine,\n} from \"@super-repo/envx-libs\";\n\n/**\n * Load env files into `process.env` and return it.\n *\n * Modeled after the `dotenv` API but with explicit scoping. Three call\n * shapes:\n *\n * ```ts\n * import envx from \"@super-repo/envx\";\n *\n * envx();              // load `.env` (auto-detect from NODE_ENV / VERCEL_ENV / NETLIFY)\n * envx(\"prod\");        // load `.env` with cascade=prod (.env, .env.prod, .env.local, .env.prod.local)\n * envx({ envFiles: [\"vault/.env.prod\"], envPath: \"vault\", quiet: false }); // full options\n * ```\n *\n * In all cases `process.env` is mutated and returned for ergonomic\n * destructuring. Config file discovery (`envx.config.{ts,js,json}` /\n * `package.json` `envx.config`) runs automatically; programmatic\n * options layer on top of the discovered config, with caller-supplied\n * fields winning per-field.\n */\n/**\n * Programmatic options accept everything `LoadEnvOptions` does plus an\n * optional `profile` name. When set, the matching `config.profiles[name]`\n * is merged onto the base config (per-field) before the user options\n * take over.\n */\nexport type EnvxProgrammaticOptions = LoadEnvOptions & { readonly profile?: string };\n\nfunction envx(): NodeJS.ProcessEnv;\nfunction envx(scope: string): NodeJS.ProcessEnv;\nfunction envx(opts: EnvxProgrammaticOptions): NodeJS.ProcessEnv;\nfunction envx(arg?: string | EnvxProgrammaticOptions): NodeJS.ProcessEnv {\n  const { config: baseConfig } = loadDotenvxConfig();\n  const userOpts: EnvxProgrammaticOptions =\n    arg === undefined\n      ? {}\n      : typeof arg === \"string\"\n        ? { cascade: arg }\n        : arg;\n  let cfg: DotenvxConfig = baseConfig;\n  if (userOpts.profile) {\n    const profile = cfg.profiles?.[userOpts.profile];\n    if (!profile) {\n      throw new Error(\n        `[ENVX_UNKNOWN_PROFILE] '${userOpts.profile}' not found (available: ${\n          Object.keys(cfg.profiles ?? {}).join(\", \") || \"none\"\n        })`,\n      );\n    }\n    cfg = { ...cfg, ...profile };\n  }\n  // Strip `profile` before passing to mergeOpts — it's not a LoadEnvOptions field.\n  const { profile: _drop, ...rest } = userOpts;\n  void _drop;\n  loadEnv(mergeOpts(cfg, rest));\n  return process.env;\n}\n\n/**\n * Per-field merge: caller-supplied option wins, falling through to the\n * matching config field, falling through to whatever default `loadEnv`\n * has built in. Fields the caller doesn't pass and the config doesn't\n * set are simply omitted from the merged options object.\n */\nfunction mergeOpts(\n  config: DotenvxConfig,\n  user: LoadEnvOptions,\n): LoadEnvOptions {\n  const out: { -readonly [K in keyof LoadEnvOptions]: LoadEnvOptions[K] } = {};\n\n  // env-file selection\n  if (user.envFiles !== undefined) out.envFiles = user.envFiles;\n  else if (config.envFiles !== undefined) out.envFiles = [...config.envFiles];\n\n  if (user.envPath !== undefined) out.envPath = user.envPath;\n  else if (config.envPath !== undefined) out.envPath = config.envPath;\n\n  if (user.cascade !== undefined) out.cascade = user.cascade;\n  else if (config.cascade !== undefined) out.cascade = config.cascade;\n\n  if (user.vault !== undefined) out.vault = user.vault;\n\n  if (user.variables !== undefined) out.variables = user.variables;\n\n  // load behavior\n  if (user.override !== undefined) out.override = user.override;\n  else if (config.override !== undefined) out.override = config.override;\n\n  if (user.quiet !== undefined) out.quiet = user.quiet;\n  else if (config.quiet !== undefined) out.quiet = config.quiet;\n\n  // auto-detection\n  if (user.autoDetect !== undefined) out.autoDetect = user.autoDetect;\n  else if (config.autoDetect !== undefined) out.autoDetect = config.autoDetect;\n\n  if (user.nodeEnvMap !== undefined) out.nodeEnvMap = user.nodeEnvMap;\n  else if (config.nodeEnvMap !== undefined) out.nodeEnvMap = config.nodeEnvMap;\n\n  // post-load behavior\n  if (user.required !== undefined) out.required = user.required;\n  else if (config.required !== undefined) out.required = config.required;\n\n  if (user.expand !== undefined) out.expand = user.expand;\n  else if (config.expand !== undefined) out.expand = config.expand;\n\n  if (user.defaults !== undefined) out.defaults = user.defaults;\n  else if (config.defaults !== undefined) out.defaults = config.defaults;\n\n  // advanced\n  if (user.workspaceRoot !== undefined) out.workspaceRoot = user.workspaceRoot;\n  else if (config.workspaceRoot !== undefined) out.workspaceRoot = config.workspaceRoot;\n\n  if (user.schema !== undefined) out.schema = user.schema;\n  else if (config.schema !== undefined) out.schema = config.schema;\n\n  if (user.resolvers !== undefined) out.resolvers = user.resolvers;\n  else if (config.resolvers !== undefined) out.resolvers = config.resolvers;\n\n  if (user.publicPrefixes !== undefined) out.publicPrefixes = user.publicPrefixes;\n  else if (config.publicPrefixes !== undefined) out.publicPrefixes = config.publicPrefixes;\n\n  if (user.publicSource !== undefined) out.publicSource = user.publicSource;\n  else if (config.publicSource !== undefined) out.publicSource = config.publicSource;\n\n  return out;\n}\n\nexport default envx;\nexport { envx };\n\n// Re-export the types callers will need to type their own wrappers.\nexport type { LoadEnvOptions };\n\n// #endregion -----------------------------------------------\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["// #region -- Programmatic Entry Point ----------------------\n\nimport {\n  loadEnv,\n  loadDotenvxConfig,\n  type DotenvxConfig,\n  type LoadEnvOptions,\n} from \"@super-repo/envx-libs\";\n\n// Re-export the lib surface that consumers depend on (especially the\n// `auditFiles` API used by czar's `envxAuditPlugin`). Internal\n// packages `@super-repo/envx-libs` and `@super-repo/envx-common`\n// aren't on npm — `@super-repo/envx` is the only published entry, so\n// every public API has to be reachable from here.\nexport {\n  // Audit (plaintext-secret scanner)\n  auditFiles,\n  BUILT_IN_PATTERNS,\n  type AuditFinding,\n  type AuditOptions,\n  type SecretPattern,\n  // Crypto primitives\n  ENCRYPTED_PREFIX,\n  generateKeyPair,\n  encryptValueAsymmetric,\n  decryptValueAsymmetric,\n  isEncrypted,\n  // High-level operations\n  encryptFiles,\n  decryptFiles,\n  rotateFiles,\n  // Env-file parser\n  parseEnv,\n  serializeEnv,\n  toRecord,\n  // Variable expansion\n  expandRecord,\n  expandEnvSrc,\n  // Config + path resolution\n  defineConfig,\n  loadDotenvxConfig,\n  findWorkspaceRoot,\n  resolveCwdOrWorkspace,\n  resolveEnvPaths,\n  detectEnvironment,\n  // Keys-file management\n  readKeysFile,\n  writeKeysFile,\n  defaultKeysPath,\n} from \"@super-repo/envx-libs\";\n\nexport type {\n  DotenvxConfig,\n  LoadEnvOptions,\n  ProcessedEnv,\n  ProcessingError,\n  ErrorCode,\n  RunOptions,\n  RunResult,\n  ExpandOptions,\n  ExpandResult,\n  EnvLine,\n  KvLine,\n  RawLine,\n} from \"@super-repo/envx-libs\";\n\n/**\n * Load env files into `process.env` and return it.\n *\n * Modeled after the `dotenv` API but with explicit scoping. Three call\n * shapes:\n *\n * ```ts\n * import envx from \"@super-repo/envx\";\n *\n * envx();              // load `.env` (auto-detect from NODE_ENV / VERCEL_ENV / NETLIFY)\n * envx(\"prod\");        // load `.env` with cascade=prod (.env, .env.prod, .env.local, .env.prod.local)\n * envx({ envFiles: [\"vault/.env.prod\"], envPath: \"vault\", quiet: false }); // full options\n * ```\n *\n * In all cases `process.env` is mutated and returned for ergonomic\n * destructuring. Config file discovery (`envx.config.{ts,js,json}` /\n * `package.json` `envx.config`) runs automatically; programmatic\n * options layer on top of the discovered config, with caller-supplied\n * fields winning per-field.\n */\n/**\n * Programmatic options accept everything `LoadEnvOptions` does plus an\n * optional `profile` name. When set, the matching `config.profiles[name]`\n * is merged onto the base config (per-field) before the user options\n * take over.\n */\nexport type EnvxProgrammaticOptions = LoadEnvOptions & { readonly profile?: string };\n\nfunction envx(): NodeJS.ProcessEnv;\nfunction envx(scope: string): NodeJS.ProcessEnv;\nfunction envx(opts: EnvxProgrammaticOptions): NodeJS.ProcessEnv;\nfunction envx(arg?: string | EnvxProgrammaticOptions): NodeJS.ProcessEnv {\n  const { config: baseConfig } = loadDotenvxConfig();\n  const userOpts: EnvxProgrammaticOptions =\n    arg === undefined\n      ? {}\n      : typeof arg === \"string\"\n        ? { cascade: arg }\n        : arg;\n  let cfg: DotenvxConfig = baseConfig;\n  if (userOpts.profile) {\n    const profile = cfg.profiles?.[userOpts.profile];\n    if (!profile) {\n      throw new Error(\n        `[ENVX_UNKNOWN_PROFILE] '${userOpts.profile}' not found (available: ${\n          Object.keys(cfg.profiles ?? {}).join(\", \") || \"none\"\n        })`,\n      );\n    }\n    cfg = { ...cfg, ...profile };\n  }\n  // Strip `profile` before passing to mergeOpts — it's not a LoadEnvOptions field.\n  const { profile: _drop, ...rest } = userOpts;\n  void _drop;\n  loadEnv(mergeOpts(cfg, rest));\n  return process.env;\n}\n\n/**\n * Per-field merge: caller-supplied option wins, falling through to the\n * matching config field, falling through to whatever default `loadEnv`\n * has built in. Fields the caller doesn't pass and the config doesn't\n * set are simply omitted from the merged options object.\n */\nfunction mergeOpts(\n  config: DotenvxConfig,\n  user: LoadEnvOptions,\n): LoadEnvOptions {\n  const out: { -readonly [K in keyof LoadEnvOptions]: LoadEnvOptions[K] } = {};\n\n  // env-file selection\n  if (user.envFiles !== undefined) out.envFiles = user.envFiles;\n  else if (config.envFiles !== undefined) out.envFiles = [...config.envFiles];\n\n  if (user.envPath !== undefined) out.envPath = user.envPath;\n  else if (config.envPath !== undefined) out.envPath = config.envPath;\n\n  if (user.cascade !== undefined) out.cascade = user.cascade;\n  else if (config.cascade !== undefined) out.cascade = config.cascade;\n\n  if (user.vault !== undefined) out.vault = user.vault;\n\n  if (user.variables !== undefined) out.variables = user.variables;\n\n  // load behavior\n  if (user.override !== undefined) out.override = user.override;\n  else if (config.override !== undefined) out.override = config.override;\n\n  if (user.quiet !== undefined) out.quiet = user.quiet;\n  else if (config.quiet !== undefined) out.quiet = config.quiet;\n\n  // auto-detection\n  if (user.autoDetect !== undefined) out.autoDetect = user.autoDetect;\n  else if (config.autoDetect !== undefined) out.autoDetect = config.autoDetect;\n\n  if (user.nodeEnvMap !== undefined) out.nodeEnvMap = user.nodeEnvMap;\n  else if (config.nodeEnvMap !== undefined) out.nodeEnvMap = config.nodeEnvMap;\n\n  // post-load behavior\n  if (user.required !== undefined) out.required = user.required;\n  else if (config.required !== undefined) out.required = config.required;\n\n  if (user.expand !== undefined) out.expand = user.expand;\n  else if (config.expand !== undefined) out.expand = config.expand;\n\n  if (user.defaults !== undefined) out.defaults = user.defaults;\n  else if (config.defaults !== undefined) out.defaults = config.defaults;\n\n  // advanced\n  if (user.workspaceRoot !== undefined) out.workspaceRoot = user.workspaceRoot;\n  else if (config.workspaceRoot !== undefined) out.workspaceRoot = config.workspaceRoot;\n\n  if (user.schema !== undefined) out.schema = user.schema;\n  else if (config.schema !== undefined) out.schema = config.schema;\n\n  if (user.resolvers !== undefined) out.resolvers = user.resolvers;\n  else if (config.resolvers !== undefined) out.resolvers = config.resolvers;\n\n  if (user.publicPrefixes !== undefined) out.publicPrefixes = user.publicPrefixes;\n  else if (config.publicPrefixes !== undefined) out.publicPrefixes = config.publicPrefixes;\n\n  if (user.publicSource !== undefined) out.publicSource = user.publicSource;\n  else if (config.publicSource !== undefined) out.publicSource = config.publicSource;\n\n  return out;\n}\n\nexport default envx;\nexport { envx };\n\n// Re-export the types callers will need to type their own wrappers.\nexport type { LoadEnvOptions };\n\n// #endregion -----------------------------------------------\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@super-repo/envx",
   "description": "A global executable to run applications with the ENV variables witin a monorepo loaded by dotenvx",
-  "version": "0.2.3-b.4",
+  "version": "0.2.3-b.5",
   "type": "module",
   "bin": {
     "envx": "./dist/cli.js",
@@ -60,8 +60,8 @@
     "vite": "^8.0.11",
     "vite-plugin-dts": "^5.0.0",
     "vitest": "^4.1.5",
+    "@super-repo/cli": "0.2.3-b.5",
     "@super-repo/envx-libs": "0.0.1",
-    "@super-repo/cli": "0.2.3-b.4",
     "@super-repo/envx-common": "0.0.1"
   }
 }