@willbooster/shared-lib-node 3.1.2 → 3.2.0

package/dist/env.cjs

@@ -1,2 +1,2 @@
-"use strict";var e=require("node:path"),n=require("dotenv");exports.loadEnvironmentVariables=function(a,t){let o=(a.env??[]).map((e=>e.toString()));const r=a.cascadeEnv??(a.cascadeNodeEnv?process.env.NODE_ENV||"development":a.autoCascadeEnv?process.env.WB_ENV||process.env.APP_ENV||process.env.NODE_ENV||"development":void 0);"string"==typeof r&&(0===o.length&&o.push(".env"),o=o.flatMap((e=>r?[`${e}.${r}.local`,`${e}.local`,`${e}.${r}`,e]:[`${e}.local`,e]))),a.verbose&&console.info("Loading env files:",o);let s={};for(const a of o)s={...n.config({path:e.join(t,a)}).parsed,...s};if(a.checkEnv){const r=Object.keys(n.config({path:e.join(t,a.checkEnv)}).parsed||{}).filter((e=>!(e in s)));if(r.length>0)throw new Error(`Missing environment variables in [${o.join(", ")}]: [${r.join(", ")}]`)}return s},exports.removeNpmAndYarnEnvironmentVariables=function(e){e.PATH&&e.BERRY_BIN_FOLDER&&(e.PATH=e.PATH.replace(`${e.BERRY_BIN_FOLDER}:`,"").replaceAll(/\/private\/var\/folders\/[^:]+:/g,"").replaceAll(/\/var\/tmp\/[^:]+:/g,"").replaceAll(/\/tmp\/[^:]+:/g,""));for(const n of Object.keys(e)){const a=n.toUpperCase();(a.startsWith("NPM_")||a.startsWith("YARN_")||a.startsWith("BERRY_")||"PROJECT_CWD"===a||"INIT_CWD"===a)&&delete e[n]}},exports.yargsOptionsBuilderForEnv={env:{description:".env files to be loaded.",type:"array"},"cascade-env":{description:"Environment to load cascading .env files (e.g., `.env`, `.env.<environment>`, `.env.local` and `.env.<environment>.local`). Preferred over `cascade-node-env` and `auto-cascade-env`.",type:"string"},"cascade-node-env":{description:'Same with --cascade-env=<NODE_ENV>. If NODE_ENV is falsy, "development" is applied. Preferred over `auto-cascade-env`.',type:"boolean"},"auto-cascade-env":{description:'Same with --cascade-env=<WB_ENV || APP_ENV || NODE_ENV>. If they are falsy, "development" is applied.',type:"boolean",default:!0},"check-env":{description:"Check whether the keys of the loaded .env files are same with the given .env file.",type:"string",default:".env.example"}};
+"use strict";var e=require("node:path"),n=require("dotenv");exports.loadEnvironmentVariables=function(o,t,a){let r=(o.env??[]).map((n=>e.resolve(a??t,n.toString())));const s=o.cascadeEnv??(o.cascadeNodeEnv?process.env.NODE_ENV||"development":o.autoCascadeEnv?process.env.WB_ENV||process.env.APP_ENV||process.env.NODE_ENV||"development":void 0);"string"==typeof s&&(0===r.length&&r.push(e.join(t,".env")),r=r.flatMap((e=>s?[`${e}.${s}.local`,`${e}.local`,`${e}.${s}`,e]:[`${e}.local`,e]))),r=r.map((n=>e.relative(t,n))),o.verbose&&console.info("Loading env files:",r);let i={};const c={...process.env};for(const o of r){i={...n.config({path:e.join(t,o)}).parsed,...i};let a=0;for(const[e,n]of Object.entries(i))c[e]!==n&&(c[e]=n,a++);a>0&&console.info(`Updated ${a} environment variables:`,o)}if(o.checkEnv){const a=Object.keys(n.config({path:e.join(t,o.checkEnv)}).parsed||{}).filter((e=>!(e in i)));if(a.length>0)throw new Error(`Missing environment variables in [${r.join(", ")}]: [${a.join(", ")}]`)}return i},exports.removeNpmAndYarnEnvironmentVariables=function(e){e.PATH&&e.BERRY_BIN_FOLDER&&(e.PATH=e.PATH.replace(`${e.BERRY_BIN_FOLDER}:`,"").replaceAll(/\/private\/var\/folders\/[^:]+:/g,"").replaceAll(/\/var\/tmp\/[^:]+:/g,"").replaceAll(/\/tmp\/[^:]+:/g,""));for(const n of Object.keys(e)){const o=n.toUpperCase();(o.startsWith("NPM_")||o.startsWith("YARN_")||o.startsWith("BERRY_")||"PROJECT_CWD"===o||"INIT_CWD"===o)&&delete e[n]}},exports.yargsOptionsBuilderForEnv={env:{description:".env files to be loaded.",type:"array"},"cascade-env":{description:"Environment to load cascading .env files (e.g., `.env`, `.env.<environment>`, `.env.local` and `.env.<environment>.local`). Preferred over `cascade-node-env` and `auto-cascade-env`.",type:"string"},"cascade-node-env":{description:'Same with --cascade-env=<NODE_ENV>. If NODE_ENV is falsy, "development" is applied. Preferred over `auto-cascade-env`.',type:"boolean"},"auto-cascade-env":{description:'Same with --cascade-env=<WB_ENV || APP_ENV || NODE_ENV>. If they are falsy, "development" is applied.',type:"boolean",default:!0},"check-env":{description:"Check whether the keys of the loaded .env files are same with the given .env file.",type:"string",default:".env.example"}};
 //# sourceMappingURL=env.cjs.map

package/dist/env.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.cjs","sources":["../src/env.ts"],"sourcesContent":["import path from 'node:path';\n\nimport { config } from 'dotenv';\n\ninterface Options {\n  env?: (string | number)[];\n  cascadeEnv?: string;\n  cascadeNodeEnv?: boolean;\n  autoCascadeEnv?: boolean;\n  checkEnv?: string;\n  verbose?: boolean;\n}\n\nexport const yargsOptionsBuilderForEnv = {\n  env: {\n    description: '.env files to be loaded.',\n    type: 'array',\n  },\n  'cascade-env': {\n    description:\n      'Environment to load cascading .env files (e.g., `.env`, `.env.<environment>`, `.env.local` and `.env.<environment>.local`). Preferred over `cascade-node-env` and `auto-cascade-env`.',\n    type: 'string',\n  },\n  'cascade-node-env': {\n    description:\n      'Same with --cascade-env=<NODE_ENV>. If NODE_ENV is falsy, \"development\" is applied. Preferred over `auto-cascade-env`.',\n    type: 'boolean',\n  },\n  'auto-cascade-env': {\n    description:\n      'Same with --cascade-env=<WB_ENV || APP_ENV || NODE_ENV>. If they are falsy, \"development\" is applied.',\n    type: 'boolean',\n    default: true,\n  },\n  'check-env': {\n    description: 'Check whether the keys of the loaded .env files are same with the given .env file.',\n    type: 'string',\n    default: '.env.example',\n  },\n} as const;\n\n/**\n * This function loads environment variables from `.env` files.\n * */\nexport function loadEnvironmentVariables(argv: Options, cwd: string): Record<string, string> {\n  let envPaths = (argv.env ?? []).map((envPath) => envPath.toString());\n  const cascade =\n    argv.cascadeEnv ??\n    (argv.cascadeNodeEnv\n      ? process.env.NODE_ENV || 'development'\n      : argv.autoCascadeEnv\n      ? process.env.WB_ENV || process.env.APP_ENV || process.env.NODE_ENV || 'development'\n      : undefined);\n  if (typeof cascade === 'string') {\n    if (envPaths.length === 0) envPaths.push('.env');\n    envPaths = envPaths.flatMap((envPath) =>\n      cascade\n        ? [`${envPath}.${cascade}.local`, `${envPath}.local`, `${envPath}.${cascade}`, envPath]\n        : [`${envPath}.local`, envPath]\n    );\n  }\n  if (argv.verbose) {\n    console.info('Loading env files:', envPaths);\n  }\n\n  let envVars = {};\n  for (const envPath of envPaths) {\n    envVars = { ...config({ path: path.join(cwd, envPath) }).parsed, ...envVars };\n  }\n\n  if (argv.checkEnv) {\n    const exampleKeys = Object.keys(config({ path: path.join(cwd, argv.checkEnv) }).parsed || {});\n    const missingKeys = exampleKeys.filter((key) => !(key in envVars));\n    if (missingKeys.length > 0) {\n      throw new Error(`Missing environment variables in [${envPaths.join(', ')}]: [${missingKeys.join(', ')}]`);\n    }\n  }\n  return envVars;\n}\n\n/**\n * This function removes environment variables related to npm and yarn from the given environment variables.\n * */\nexport function removeNpmAndYarnEnvironmentVariables(envVars: Record<string, string | undefined>): void {\n  // Remove npm & yarn environment variables from process.env\n  if (envVars.PATH && envVars.BERRY_BIN_FOLDER) {\n    envVars.PATH = envVars.PATH.replace(`${envVars.BERRY_BIN_FOLDER}:`, '')\n      // Temporary directory in macOS\n      .replaceAll(/\\/private\\/var\\/folders\\/[^:]+:/g, '')\n      // Temporary directories in Linux\n      .replaceAll(/\\/var\\/tmp\\/[^:]+:/g, '')\n      .replaceAll(/\\/tmp\\/[^:]+:/g, '');\n  }\n  for (const key of Object.keys(envVars)) {\n    const upperKey = key.toUpperCase();\n    if (\n      upperKey.startsWith('NPM_') ||\n      upperKey.startsWith('YARN_') ||\n      upperKey.startsWith('BERRY_') ||\n      upperKey === 'PROJECT_CWD' ||\n      upperKey === 'INIT_CWD'\n    ) {\n      delete envVars[key];\n    }\n  }\n}\n"],"names":["argv","cwd","envPaths","env","map","envPath","toString","cascade","cascadeEnv","cascadeNodeEnv","process","NODE_ENV","autoCascadeEnv","WB_ENV","APP_ENV","undefined","length","push","flatMap","verbose","console","info","envVars","config","path","join","parsed","checkEnv","missingKeys","Object","keys","filter","key","Error","PATH","BERRY_BIN_FOLDER","replace","replaceAll","upperKey","toUpperCase","startsWith","description","type","default"],"mappings":"6FA4CO,SAAkCA,EAAeC,GACtD,IAAIC,GAAYF,EAAKG,KAAO,IAAIC,KAAKC,GAAYA,EAAQC,aACzD,MAAMC,EACJP,EAAKQ,aACJR,EAAKS,eACFC,QAAQP,IAAIQ,UAAY,cACxBX,EAAKY,eACLF,QAAQP,IAAIU,QAAUH,QAAQP,IAAIW,SAAWJ,QAAQP,IAAIQ,UAAY,mBACrEI,GACiB,iBAAZR,IACe,IAApBL,EAASc,QAAcd,EAASe,KAAK,QACzCf,EAAWA,EAASgB,SAASb,GAC3BE,EACI,CAAE,GAAEF,KAAWE,UAAkB,GAAEF,UAAkB,GAAEA,KAAWE,IAAWF,GAC7E,CAAE,GAAEA,UAAiBA,MAGzBL,EAAKmB,SACPC,QAAQC,KAAK,qBAAsBnB,GAGrC,IAAIoB,EAAU,CAAA,EACd,IAAK,MAAMjB,KAAWH,EACpBoB,EAAU,IAAKC,SAAO,CAAEC,KAAMA,EAAKC,KAAKxB,EAAKI,KAAYqB,UAAWJ,GAGtE,GAAItB,EAAK2B,SAAU,CACjB,MACMC,EADcC,OAAOC,KAAKP,SAAO,CAAEC,KAAMA,EAAKC,KAAKxB,EAAKD,EAAK2B,YAAaD,QAAU,CAAA,GAC1DK,QAAQC,KAAUA,KAAOV,KACzD,GAAIM,EAAYZ,OAAS,EACvB,MAAM,IAAIiB,MAAO,qCAAoC/B,EAASuB,KAAK,YAAYG,EAAYH,KAAK,SAEpG,CACA,OAAOH,CACT,+CAKO,SAA8CA,GAE/CA,EAAQY,MAAQZ,EAAQa,mBAC1Bb,EAAQY,KAAOZ,EAAQY,KAAKE,QAAS,GAAEd,EAAQa,oBAAqB,IAEjEE,WAAW,mCAAoC,IAE/CA,WAAW,sBAAuB,IAClCA,WAAW,iBAAkB,KAElC,IAAK,MAAML,KAAOH,OAAOC,KAAKR,GAAU,CACtC,MAAMgB,EAAWN,EAAIO,eAEnBD,EAASE,WAAW,SACpBF,EAASE,WAAW,UACpBF,EAASE,WAAW,WACP,gBAAbF,GACa,aAAbA,WAEOhB,EAAQU,EAEnB,CACF,oCA5FyC,CACvC7B,IAAK,CACHsC,YAAa,2BACbC,KAAM,SAER,cAAe,CACbD,YACE,wLACFC,KAAM,UAER,mBAAoB,CAClBD,YACE,yHACFC,KAAM,WAER,mBAAoB,CAClBD,YACE,wGACFC,KAAM,UACNC,SAAS,GAEX,YAAa,CACXF,YAAa,qFACbC,KAAM,SACNC,QAAS"}
+{"version":3,"file":"env.cjs","sources":["../src/env.ts"],"sourcesContent":["import path from 'node:path';\n\nimport { config } from 'dotenv';\n\ninterface Options {\n  env?: (string | number)[];\n  cascadeEnv?: string;\n  cascadeNodeEnv?: boolean;\n  autoCascadeEnv?: boolean;\n  checkEnv?: string;\n  verbose?: boolean;\n}\n\nexport const yargsOptionsBuilderForEnv = {\n  env: {\n    description: '.env files to be loaded.',\n    type: 'array',\n  },\n  'cascade-env': {\n    description:\n      'Environment to load cascading .env files (e.g., `.env`, `.env.<environment>`, `.env.local` and `.env.<environment>.local`). Preferred over `cascade-node-env` and `auto-cascade-env`.',\n    type: 'string',\n  },\n  'cascade-node-env': {\n    description:\n      'Same with --cascade-env=<NODE_ENV>. If NODE_ENV is falsy, \"development\" is applied. Preferred over `auto-cascade-env`.',\n    type: 'boolean',\n  },\n  'auto-cascade-env': {\n    description:\n      'Same with --cascade-env=<WB_ENV || APP_ENV || NODE_ENV>. If they are falsy, \"development\" is applied.',\n    type: 'boolean',\n    default: true,\n  },\n  'check-env': {\n    description: 'Check whether the keys of the loaded .env files are same with the given .env file.',\n    type: 'string',\n    default: '.env.example',\n  },\n} as const;\n\n/**\n * This function loads environment variables from `.env` files.\n * */\nexport function loadEnvironmentVariables(argv: Options, cwd: string, orgCwd?: string): Record<string, string> {\n  let envPaths = (argv.env ?? []).map((envPath) => path.resolve(orgCwd ?? cwd, envPath.toString()));\n  const cascade =\n    argv.cascadeEnv ??\n    (argv.cascadeNodeEnv\n      ? process.env.NODE_ENV || 'development'\n      : argv.autoCascadeEnv\n      ? process.env.WB_ENV || process.env.APP_ENV || process.env.NODE_ENV || 'development'\n      : undefined);\n  if (typeof cascade === 'string') {\n    if (envPaths.length === 0) envPaths.push(path.join(cwd, '.env'));\n    envPaths = envPaths.flatMap((envPath) =>\n      cascade\n        ? [`${envPath}.${cascade}.local`, `${envPath}.local`, `${envPath}.${cascade}`, envPath]\n        : [`${envPath}.local`, envPath]\n    );\n  }\n  envPaths = envPaths.map((envPath) => path.relative(cwd, envPath));\n  if (argv.verbose) {\n    console.info('Loading env files:', envPaths);\n  }\n\n  let envVars: Record<string, string> = {};\n  const orgEnvVars = { ...process.env };\n  for (const envPath of envPaths) {\n    envVars = { ...config({ path: path.join(cwd, envPath) }).parsed, ...envVars };\n    let count = 0;\n    for (const [key, value] of Object.entries(envVars)) {\n      if (orgEnvVars[key] !== value) {\n        orgEnvVars[key] = value;\n        count++;\n      }\n    }\n    if (count > 0) {\n      console.info(`Updated ${count} environment variables:`, envPath);\n    }\n  }\n\n  if (argv.checkEnv) {\n    const exampleKeys = Object.keys(config({ path: path.join(cwd, argv.checkEnv) }).parsed || {});\n    const missingKeys = exampleKeys.filter((key) => !(key in envVars));\n    if (missingKeys.length > 0) {\n      throw new Error(`Missing environment variables in [${envPaths.join(', ')}]: [${missingKeys.join(', ')}]`);\n    }\n  }\n  return envVars;\n}\n\n/**\n * This function removes environment variables related to npm and yarn from the given environment variables.\n * */\nexport function removeNpmAndYarnEnvironmentVariables(envVars: Record<string, string | undefined>): void {\n  // Remove npm & yarn environment variables from process.env\n  if (envVars.PATH && envVars.BERRY_BIN_FOLDER) {\n    envVars.PATH = envVars.PATH.replace(`${envVars.BERRY_BIN_FOLDER}:`, '')\n      // Temporary directory in macOS\n      .replaceAll(/\\/private\\/var\\/folders\\/[^:]+:/g, '')\n      // Temporary directories in Linux\n      .replaceAll(/\\/var\\/tmp\\/[^:]+:/g, '')\n      .replaceAll(/\\/tmp\\/[^:]+:/g, '');\n  }\n  for (const key of Object.keys(envVars)) {\n    const upperKey = key.toUpperCase();\n    if (\n      upperKey.startsWith('NPM_') ||\n      upperKey.startsWith('YARN_') ||\n      upperKey.startsWith('BERRY_') ||\n      upperKey === 'PROJECT_CWD' ||\n      upperKey === 'INIT_CWD'\n    ) {\n      delete envVars[key];\n    }\n  }\n}\n"],"names":["argv","cwd","orgCwd","envPaths","env","map","envPath","path","resolve","toString","cascade","cascadeEnv","cascadeNodeEnv","process","NODE_ENV","autoCascadeEnv","WB_ENV","APP_ENV","undefined","length","push","join","flatMap","relative","verbose","console","info","envVars","orgEnvVars","config","parsed","count","key","value","Object","entries","checkEnv","missingKeys","keys","filter","Error","PATH","BERRY_BIN_FOLDER","replace","replaceAll","upperKey","toUpperCase","startsWith","description","type","default"],"mappings":"6FA4CO,SAAkCA,EAAeC,EAAaC,GACnE,IAAIC,GAAYH,EAAKI,KAAO,IAAIC,KAAKC,GAAYC,EAAKC,QAAQN,GAAUD,EAAKK,EAAQG,cACrF,MAAMC,EACJV,EAAKW,aACJX,EAAKY,eACFC,QAAQT,IAAIU,UAAY,cACxBd,EAAKe,eACLF,QAAQT,IAAIY,QAAUH,QAAQT,IAAIa,SAAWJ,QAAQT,IAAIU,UAAY,mBACrEI,GACiB,iBAAZR,IACe,IAApBP,EAASgB,QAAchB,EAASiB,KAAKb,EAAKc,KAAKpB,EAAK,SACxDE,EAAWA,EAASmB,SAAShB,GAC3BI,EACI,CAAE,GAAEJ,KAAWI,UAAkB,GAAEJ,UAAkB,GAAEA,KAAWI,IAAWJ,GAC7E,CAAE,GAAEA,UAAiBA,MAG7BH,EAAWA,EAASE,KAAKC,GAAYC,EAAKgB,SAAStB,EAAKK,KACpDN,EAAKwB,SACPC,QAAQC,KAAK,qBAAsBvB,GAGrC,IAAIwB,EAAkC,CAAA,EACtC,MAAMC,EAAa,IAAKf,QAAQT,KAChC,IAAK,MAAME,KAAWH,EAAU,CAC9BwB,EAAU,IAAKE,SAAO,CAAEtB,KAAMA,EAAKc,KAAKpB,EAAKK,KAAYwB,UAAWH,GACpE,IAAII,EAAQ,EACZ,IAAK,MAAOC,EAAKC,KAAUC,OAAOC,QAAQR,GACpCC,EAAWI,KAASC,IACtBL,EAAWI,GAAOC,EAClBF,KAGAA,EAAQ,GACVN,QAAQC,KAAM,WAAUK,2BAAgCzB,EAE5D,CAEA,GAAIN,EAAKoC,SAAU,CACjB,MACMC,EADcH,OAAOI,KAAKT,SAAO,CAAEtB,KAAMA,EAAKc,KAAKpB,EAAKD,EAAKoC,YAAaN,QAAU,CAAA,GAC1DS,QAAQP,KAAUA,KAAOL,KACzD,GAAIU,EAAYlB,OAAS,EACvB,MAAM,IAAIqB,MAAO,qCAAoCrC,EAASkB,KAAK,YAAYgB,EAAYhB,KAAK,SAEpG,CACA,OAAOM,CACT,+CAKO,SAA8CA,GAE/CA,EAAQc,MAAQd,EAAQe,mBAC1Bf,EAAQc,KAAOd,EAAQc,KAAKE,QAAS,GAAEhB,EAAQe,oBAAqB,IAEjEE,WAAW,mCAAoC,IAE/CA,WAAW,sBAAuB,IAClCA,WAAW,iBAAkB,KAElC,IAAK,MAAMZ,KAAOE,OAAOI,KAAKX,GAAU,CACtC,MAAMkB,EAAWb,EAAIc,eAEnBD,EAASE,WAAW,SACpBF,EAASE,WAAW,UACpBF,EAASE,WAAW,WACP,gBAAbF,GACa,aAAbA,WAEOlB,EAAQK,EAEnB,CACF,oCAxGyC,CACvC5B,IAAK,CACH4C,YAAa,2BACbC,KAAM,SAER,cAAe,CACbD,YACE,wLACFC,KAAM,UAER,mBAAoB,CAClBD,YACE,yHACFC,KAAM,WAER,mBAAoB,CAClBD,YACE,wGACFC,KAAM,UACNC,SAAS,GAEX,YAAa,CACXF,YAAa,qFACbC,KAAM,SACNC,QAAS"}

package/dist/env.d.ts

@@ -33,7 +33,7 @@ export declare const yargsOptionsBuilderForEnv: {
 /**
  * This function loads environment variables from `.env` files.
  * */
-export declare function loadEnvironmentVariables(argv: Options, cwd: string): Record<string, string>;
+export declare function loadEnvironmentVariables(argv: Options, cwd: string, orgCwd?: string): Record<string, string>;
 /**
  * This function removes environment variables related to npm and yarn from the given environment variables.
  * */

package/dist/env.js

@@ -1,2 +1,2 @@
-import e from"node:path";import{config as n}from"dotenv";const t={env:{description:".env files to be loaded.",type:"array"},"cascade-env":{description:"Environment to load cascading .env files (e.g., `.env`, `.env.<environment>`, `.env.local` and `.env.<environment>.local`). Preferred over `cascade-node-env` and `auto-cascade-env`.",type:"string"},"cascade-node-env":{description:'Same with --cascade-env=<NODE_ENV>. If NODE_ENV is falsy, "development" is applied. Preferred over `auto-cascade-env`.',type:"boolean"},"auto-cascade-env":{description:'Same with --cascade-env=<WB_ENV || APP_ENV || NODE_ENV>. If they are falsy, "development" is applied.',type:"boolean",default:!0},"check-env":{description:"Check whether the keys of the loaded .env files are same with the given .env file.",type:"string",default:".env.example"}};function a(t,a){let o=(t.env??[]).map((e=>e.toString()));const s=t.cascadeEnv??(t.cascadeNodeEnv?process.env.NODE_ENV||"development":t.autoCascadeEnv?process.env.WB_ENV||process.env.APP_ENV||process.env.NODE_ENV||"development":void 0);"string"==typeof s&&(0===o.length&&o.push(".env"),o=o.flatMap((e=>s?[`${e}.${s}.local`,`${e}.local`,`${e}.${s}`,e]:[`${e}.local`,e]))),t.verbose&&console.info("Loading env files:",o);let r={};for(const t of o)r={...n({path:e.join(a,t)}).parsed,...r};if(t.checkEnv){const s=Object.keys(n({path:e.join(a,t.checkEnv)}).parsed||{}).filter((e=>!(e in r)));if(s.length>0)throw new Error(`Missing environment variables in [${o.join(", ")}]: [${s.join(", ")}]`)}return r}function o(e){e.PATH&&e.BERRY_BIN_FOLDER&&(e.PATH=e.PATH.replace(`${e.BERRY_BIN_FOLDER}:`,"").replaceAll(/\/private\/var\/folders\/[^:]+:/g,"").replaceAll(/\/var\/tmp\/[^:]+:/g,"").replaceAll(/\/tmp\/[^:]+:/g,""));for(const n of Object.keys(e)){const t=n.toUpperCase();(t.startsWith("NPM_")||t.startsWith("YARN_")||t.startsWith("BERRY_")||"PROJECT_CWD"===t||"INIT_CWD"===t)&&delete e[n]}}export{a as loadEnvironmentVariables,o as removeNpmAndYarnEnvironmentVariables,t as yargsOptionsBuilderForEnv};
+import e from"node:path";import{config as n}from"dotenv";const o={env:{description:".env files to be loaded.",type:"array"},"cascade-env":{description:"Environment to load cascading .env files (e.g., `.env`, `.env.<environment>`, `.env.local` and `.env.<environment>.local`). Preferred over `cascade-node-env` and `auto-cascade-env`.",type:"string"},"cascade-node-env":{description:'Same with --cascade-env=<NODE_ENV>. If NODE_ENV is falsy, "development" is applied. Preferred over `auto-cascade-env`.',type:"boolean"},"auto-cascade-env":{description:'Same with --cascade-env=<WB_ENV || APP_ENV || NODE_ENV>. If they are falsy, "development" is applied.',type:"boolean",default:!0},"check-env":{description:"Check whether the keys of the loaded .env files are same with the given .env file.",type:"string",default:".env.example"}};function t(o,t,a){let s=(o.env??[]).map((n=>e.resolve(a??t,n.toString())));const r=o.cascadeEnv??(o.cascadeNodeEnv?process.env.NODE_ENV||"development":o.autoCascadeEnv?process.env.WB_ENV||process.env.APP_ENV||process.env.NODE_ENV||"development":void 0);"string"==typeof r&&(0===s.length&&s.push(e.join(t,".env")),s=s.flatMap((e=>r?[`${e}.${r}.local`,`${e}.local`,`${e}.${r}`,e]:[`${e}.local`,e]))),s=s.map((n=>e.relative(t,n))),o.verbose&&console.info("Loading env files:",s);let c={};const i={...process.env};for(const o of s){c={...n({path:e.join(t,o)}).parsed,...c};let a=0;for(const[e,n]of Object.entries(c))i[e]!==n&&(i[e]=n,a++);a>0&&console.info(`Updated ${a} environment variables:`,o)}if(o.checkEnv){const a=Object.keys(n({path:e.join(t,o.checkEnv)}).parsed||{}).filter((e=>!(e in c)));if(a.length>0)throw new Error(`Missing environment variables in [${s.join(", ")}]: [${a.join(", ")}]`)}return c}function a(e){e.PATH&&e.BERRY_BIN_FOLDER&&(e.PATH=e.PATH.replace(`${e.BERRY_BIN_FOLDER}:`,"").replaceAll(/\/private\/var\/folders\/[^:]+:/g,"").replaceAll(/\/var\/tmp\/[^:]+:/g,"").replaceAll(/\/tmp\/[^:]+:/g,""));for(const n of Object.keys(e)){const o=n.toUpperCase();(o.startsWith("NPM_")||o.startsWith("YARN_")||o.startsWith("BERRY_")||"PROJECT_CWD"===o||"INIT_CWD"===o)&&delete e[n]}}export{t as loadEnvironmentVariables,a as removeNpmAndYarnEnvironmentVariables,o as yargsOptionsBuilderForEnv};
 //# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sources":["../src/env.ts"],"sourcesContent":["import path from 'node:path';\n\nimport { config } from 'dotenv';\n\ninterface Options {\n  env?: (string | number)[];\n  cascadeEnv?: string;\n  cascadeNodeEnv?: boolean;\n  autoCascadeEnv?: boolean;\n  checkEnv?: string;\n  verbose?: boolean;\n}\n\nexport const yargsOptionsBuilderForEnv = {\n  env: {\n    description: '.env files to be loaded.',\n    type: 'array',\n  },\n  'cascade-env': {\n    description:\n      'Environment to load cascading .env files (e.g., `.env`, `.env.<environment>`, `.env.local` and `.env.<environment>.local`). Preferred over `cascade-node-env` and `auto-cascade-env`.',\n    type: 'string',\n  },\n  'cascade-node-env': {\n    description:\n      'Same with --cascade-env=<NODE_ENV>. If NODE_ENV is falsy, \"development\" is applied. Preferred over `auto-cascade-env`.',\n    type: 'boolean',\n  },\n  'auto-cascade-env': {\n    description:\n      'Same with --cascade-env=<WB_ENV || APP_ENV || NODE_ENV>. If they are falsy, \"development\" is applied.',\n    type: 'boolean',\n    default: true,\n  },\n  'check-env': {\n    description: 'Check whether the keys of the loaded .env files are same with the given .env file.',\n    type: 'string',\n    default: '.env.example',\n  },\n} as const;\n\n/**\n * This function loads environment variables from `.env` files.\n * */\nexport function loadEnvironmentVariables(argv: Options, cwd: string): Record<string, string> {\n  let envPaths = (argv.env ?? []).map((envPath) => envPath.toString());\n  const cascade =\n    argv.cascadeEnv ??\n    (argv.cascadeNodeEnv\n      ? process.env.NODE_ENV || 'development'\n      : argv.autoCascadeEnv\n      ? process.env.WB_ENV || process.env.APP_ENV || process.env.NODE_ENV || 'development'\n      : undefined);\n  if (typeof cascade === 'string') {\n    if (envPaths.length === 0) envPaths.push('.env');\n    envPaths = envPaths.flatMap((envPath) =>\n      cascade\n        ? [`${envPath}.${cascade}.local`, `${envPath}.local`, `${envPath}.${cascade}`, envPath]\n        : [`${envPath}.local`, envPath]\n    );\n  }\n  if (argv.verbose) {\n    console.info('Loading env files:', envPaths);\n  }\n\n  let envVars = {};\n  for (const envPath of envPaths) {\n    envVars = { ...config({ path: path.join(cwd, envPath) }).parsed, ...envVars };\n  }\n\n  if (argv.checkEnv) {\n    const exampleKeys = Object.keys(config({ path: path.join(cwd, argv.checkEnv) }).parsed || {});\n    const missingKeys = exampleKeys.filter((key) => !(key in envVars));\n    if (missingKeys.length > 0) {\n      throw new Error(`Missing environment variables in [${envPaths.join(', ')}]: [${missingKeys.join(', ')}]`);\n    }\n  }\n  return envVars;\n}\n\n/**\n * This function removes environment variables related to npm and yarn from the given environment variables.\n * */\nexport function removeNpmAndYarnEnvironmentVariables(envVars: Record<string, string | undefined>): void {\n  // Remove npm & yarn environment variables from process.env\n  if (envVars.PATH && envVars.BERRY_BIN_FOLDER) {\n    envVars.PATH = envVars.PATH.replace(`${envVars.BERRY_BIN_FOLDER}:`, '')\n      // Temporary directory in macOS\n      .replaceAll(/\\/private\\/var\\/folders\\/[^:]+:/g, '')\n      // Temporary directories in Linux\n      .replaceAll(/\\/var\\/tmp\\/[^:]+:/g, '')\n      .replaceAll(/\\/tmp\\/[^:]+:/g, '');\n  }\n  for (const key of Object.keys(envVars)) {\n    const upperKey = key.toUpperCase();\n    if (\n      upperKey.startsWith('NPM_') ||\n      upperKey.startsWith('YARN_') ||\n      upperKey.startsWith('BERRY_') ||\n      upperKey === 'PROJECT_CWD' ||\n      upperKey === 'INIT_CWD'\n    ) {\n      delete envVars[key];\n    }\n  }\n}\n"],"names":["yargsOptionsBuilderForEnv","env","description","type","default","loadEnvironmentVariables","argv","cwd","envPaths","map","envPath","toString","cascade","cascadeEnv","cascadeNodeEnv","process","NODE_ENV","autoCascadeEnv","WB_ENV","APP_ENV","undefined","length","push","flatMap","verbose","console","info","envVars","config","path","join","parsed","checkEnv","missingKeys","Object","keys","filter","key","Error","removeNpmAndYarnEnvironmentVariables","PATH","BERRY_BIN_FOLDER","replace","replaceAll","upperKey","toUpperCase","startsWith"],"mappings":"yDAaO,MAAMA,EAA4B,CACvCC,IAAK,CACHC,YAAa,2BACbC,KAAM,SAER,cAAe,CACbD,YACE,wLACFC,KAAM,UAER,mBAAoB,CAClBD,YACE,yHACFC,KAAM,WAER,mBAAoB,CAClBD,YACE,wGACFC,KAAM,UACNC,SAAS,GAEX,YAAa,CACXF,YAAa,qFACbC,KAAM,SACNC,QAAS,iBAON,SAASC,EAAyBC,EAAeC,GACtD,IAAIC,GAAYF,EAAKL,KAAO,IAAIQ,KAAKC,GAAYA,EAAQC,aACzD,MAAMC,EACJN,EAAKO,aACJP,EAAKQ,eACFC,QAAQd,IAAIe,UAAY,cACxBV,EAAKW,eACLF,QAAQd,IAAIiB,QAAUH,QAAQd,IAAIkB,SAAWJ,QAAQd,IAAIe,UAAY,mBACrEI,GACiB,iBAAZR,IACe,IAApBJ,EAASa,QAAcb,EAASc,KAAK,QACzCd,EAAWA,EAASe,SAASb,GAC3BE,EACI,CAAE,GAAEF,KAAWE,UAAkB,GAAEF,UAAkB,GAAEA,KAAWE,IAAWF,GAC7E,CAAE,GAAEA,UAAiBA,MAGzBJ,EAAKkB,SACPC,QAAQC,KAAK,qBAAsBlB,GAGrC,IAAImB,EAAU,CAAA,EACd,IAAK,MAAMjB,KAAWF,EACpBmB,EAAU,IAAKC,EAAO,CAAEC,KAAMA,EAAKC,KAAKvB,EAAKG,KAAYqB,UAAWJ,GAGtE,GAAIrB,EAAK0B,SAAU,CACjB,MACMC,EADcC,OAAOC,KAAKP,EAAO,CAAEC,KAAMA,EAAKC,KAAKvB,EAAKD,EAAK0B,YAAaD,QAAU,CAAA,GAC1DK,QAAQC,KAAUA,KAAOV,KACzD,GAAIM,EAAYZ,OAAS,EACvB,MAAM,IAAIiB,MAAO,qCAAoC9B,EAASsB,KAAK,YAAYG,EAAYH,KAAK,SAEpG,CACA,OAAOH,CACT,CAKO,SAASY,EAAqCZ,GAE/CA,EAAQa,MAAQb,EAAQc,mBAC1Bd,EAAQa,KAAOb,EAAQa,KAAKE,QAAS,GAAEf,EAAQc,oBAAqB,IAEjEE,WAAW,mCAAoC,IAE/CA,WAAW,sBAAuB,IAClCA,WAAW,iBAAkB,KAElC,IAAK,MAAMN,KAAOH,OAAOC,KAAKR,GAAU,CACtC,MAAMiB,EAAWP,EAAIQ,eAEnBD,EAASE,WAAW,SACpBF,EAASE,WAAW,UACpBF,EAASE,WAAW,WACP,gBAAbF,GACa,aAAbA,WAEOjB,EAAQU,EAEnB,CACF"}
+{"version":3,"file":"env.js","sources":["../src/env.ts"],"sourcesContent":["import path from 'node:path';\n\nimport { config } from 'dotenv';\n\ninterface Options {\n  env?: (string | number)[];\n  cascadeEnv?: string;\n  cascadeNodeEnv?: boolean;\n  autoCascadeEnv?: boolean;\n  checkEnv?: string;\n  verbose?: boolean;\n}\n\nexport const yargsOptionsBuilderForEnv = {\n  env: {\n    description: '.env files to be loaded.',\n    type: 'array',\n  },\n  'cascade-env': {\n    description:\n      'Environment to load cascading .env files (e.g., `.env`, `.env.<environment>`, `.env.local` and `.env.<environment>.local`). Preferred over `cascade-node-env` and `auto-cascade-env`.',\n    type: 'string',\n  },\n  'cascade-node-env': {\n    description:\n      'Same with --cascade-env=<NODE_ENV>. If NODE_ENV is falsy, \"development\" is applied. Preferred over `auto-cascade-env`.',\n    type: 'boolean',\n  },\n  'auto-cascade-env': {\n    description:\n      'Same with --cascade-env=<WB_ENV || APP_ENV || NODE_ENV>. If they are falsy, \"development\" is applied.',\n    type: 'boolean',\n    default: true,\n  },\n  'check-env': {\n    description: 'Check whether the keys of the loaded .env files are same with the given .env file.',\n    type: 'string',\n    default: '.env.example',\n  },\n} as const;\n\n/**\n * This function loads environment variables from `.env` files.\n * */\nexport function loadEnvironmentVariables(argv: Options, cwd: string, orgCwd?: string): Record<string, string> {\n  let envPaths = (argv.env ?? []).map((envPath) => path.resolve(orgCwd ?? cwd, envPath.toString()));\n  const cascade =\n    argv.cascadeEnv ??\n    (argv.cascadeNodeEnv\n      ? process.env.NODE_ENV || 'development'\n      : argv.autoCascadeEnv\n      ? process.env.WB_ENV || process.env.APP_ENV || process.env.NODE_ENV || 'development'\n      : undefined);\n  if (typeof cascade === 'string') {\n    if (envPaths.length === 0) envPaths.push(path.join(cwd, '.env'));\n    envPaths = envPaths.flatMap((envPath) =>\n      cascade\n        ? [`${envPath}.${cascade}.local`, `${envPath}.local`, `${envPath}.${cascade}`, envPath]\n        : [`${envPath}.local`, envPath]\n    );\n  }\n  envPaths = envPaths.map((envPath) => path.relative(cwd, envPath));\n  if (argv.verbose) {\n    console.info('Loading env files:', envPaths);\n  }\n\n  let envVars: Record<string, string> = {};\n  const orgEnvVars = { ...process.env };\n  for (const envPath of envPaths) {\n    envVars = { ...config({ path: path.join(cwd, envPath) }).parsed, ...envVars };\n    let count = 0;\n    for (const [key, value] of Object.entries(envVars)) {\n      if (orgEnvVars[key] !== value) {\n        orgEnvVars[key] = value;\n        count++;\n      }\n    }\n    if (count > 0) {\n      console.info(`Updated ${count} environment variables:`, envPath);\n    }\n  }\n\n  if (argv.checkEnv) {\n    const exampleKeys = Object.keys(config({ path: path.join(cwd, argv.checkEnv) }).parsed || {});\n    const missingKeys = exampleKeys.filter((key) => !(key in envVars));\n    if (missingKeys.length > 0) {\n      throw new Error(`Missing environment variables in [${envPaths.join(', ')}]: [${missingKeys.join(', ')}]`);\n    }\n  }\n  return envVars;\n}\n\n/**\n * This function removes environment variables related to npm and yarn from the given environment variables.\n * */\nexport function removeNpmAndYarnEnvironmentVariables(envVars: Record<string, string | undefined>): void {\n  // Remove npm & yarn environment variables from process.env\n  if (envVars.PATH && envVars.BERRY_BIN_FOLDER) {\n    envVars.PATH = envVars.PATH.replace(`${envVars.BERRY_BIN_FOLDER}:`, '')\n      // Temporary directory in macOS\n      .replaceAll(/\\/private\\/var\\/folders\\/[^:]+:/g, '')\n      // Temporary directories in Linux\n      .replaceAll(/\\/var\\/tmp\\/[^:]+:/g, '')\n      .replaceAll(/\\/tmp\\/[^:]+:/g, '');\n  }\n  for (const key of Object.keys(envVars)) {\n    const upperKey = key.toUpperCase();\n    if (\n      upperKey.startsWith('NPM_') ||\n      upperKey.startsWith('YARN_') ||\n      upperKey.startsWith('BERRY_') ||\n      upperKey === 'PROJECT_CWD' ||\n      upperKey === 'INIT_CWD'\n    ) {\n      delete envVars[key];\n    }\n  }\n}\n"],"names":["yargsOptionsBuilderForEnv","env","description","type","default","loadEnvironmentVariables","argv","cwd","orgCwd","envPaths","map","envPath","path","resolve","toString","cascade","cascadeEnv","cascadeNodeEnv","process","NODE_ENV","autoCascadeEnv","WB_ENV","APP_ENV","undefined","length","push","join","flatMap","relative","verbose","console","info","envVars","orgEnvVars","config","parsed","count","key","value","Object","entries","checkEnv","missingKeys","keys","filter","Error","removeNpmAndYarnEnvironmentVariables","PATH","BERRY_BIN_FOLDER","replace","replaceAll","upperKey","toUpperCase","startsWith"],"mappings":"yDAaO,MAAMA,EAA4B,CACvCC,IAAK,CACHC,YAAa,2BACbC,KAAM,SAER,cAAe,CACbD,YACE,wLACFC,KAAM,UAER,mBAAoB,CAClBD,YACE,yHACFC,KAAM,WAER,mBAAoB,CAClBD,YACE,wGACFC,KAAM,UACNC,SAAS,GAEX,YAAa,CACXF,YAAa,qFACbC,KAAM,SACNC,QAAS,iBAON,SAASC,EAAyBC,EAAeC,EAAaC,GACnE,IAAIC,GAAYH,EAAKL,KAAO,IAAIS,KAAKC,GAAYC,EAAKC,QAAQL,GAAUD,EAAKI,EAAQG,cACrF,MAAMC,EACJT,EAAKU,aACJV,EAAKW,eACFC,QAAQjB,IAAIkB,UAAY,cACxBb,EAAKc,eACLF,QAAQjB,IAAIoB,QAAUH,QAAQjB,IAAIqB,SAAWJ,QAAQjB,IAAIkB,UAAY,mBACrEI,GACiB,iBAAZR,IACe,IAApBN,EAASe,QAAcf,EAASgB,KAAKb,EAAKc,KAAKnB,EAAK,SACxDE,EAAWA,EAASkB,SAAShB,GAC3BI,EACI,CAAE,GAAEJ,KAAWI,UAAkB,GAAEJ,UAAkB,GAAEA,KAAWI,IAAWJ,GAC7E,CAAE,GAAEA,UAAiBA,MAG7BF,EAAWA,EAASC,KAAKC,GAAYC,EAAKgB,SAASrB,EAAKI,KACpDL,EAAKuB,SACPC,QAAQC,KAAK,qBAAsBtB,GAGrC,IAAIuB,EAAkC,CAAA,EACtC,MAAMC,EAAa,IAAKf,QAAQjB,KAChC,IAAK,MAAMU,KAAWF,EAAU,CAC9BuB,EAAU,IAAKE,EAAO,CAAEtB,KAAMA,EAAKc,KAAKnB,EAAKI,KAAYwB,UAAWH,GACpE,IAAII,EAAQ,EACZ,IAAK,MAAOC,EAAKC,KAAUC,OAAOC,QAAQR,GACpCC,EAAWI,KAASC,IACtBL,EAAWI,GAAOC,EAClBF,KAGAA,EAAQ,GACVN,QAAQC,KAAM,WAAUK,2BAAgCzB,EAE5D,CAEA,GAAIL,EAAKmC,SAAU,CACjB,MACMC,EADcH,OAAOI,KAAKT,EAAO,CAAEtB,KAAMA,EAAKc,KAAKnB,EAAKD,EAAKmC,YAAaN,QAAU,CAAA,GAC1DS,QAAQP,KAAUA,KAAOL,KACzD,GAAIU,EAAYlB,OAAS,EACvB,MAAM,IAAIqB,MAAO,qCAAoCpC,EAASiB,KAAK,YAAYgB,EAAYhB,KAAK,SAEpG,CACA,OAAOM,CACT,CAKO,SAASc,EAAqCd,GAE/CA,EAAQe,MAAQf,EAAQgB,mBAC1BhB,EAAQe,KAAOf,EAAQe,KAAKE,QAAS,GAAEjB,EAAQgB,oBAAqB,IAEjEE,WAAW,mCAAoC,IAE/CA,WAAW,sBAAuB,IAClCA,WAAW,iBAAkB,KAElC,IAAK,MAAMb,KAAOE,OAAOI,KAAKX,GAAU,CACtC,MAAMmB,EAAWd,EAAIe,eAEnBD,EAASE,WAAW,SACpBF,EAASE,WAAW,UACpBF,EAASE,WAAW,WACP,gBAAbF,GACa,aAAbA,WAEOnB,EAAQK,EAEnB,CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willbooster/shared-lib-node",
-  "version": "3.1.2",
+  "version": "3.2.0",
   "license": "Apache-2.0",
   "author": "WillBooster Inc.",
   "sideEffects": false,