@willbooster/shared-lib-node 3.0.0 → 3.1.1

package/dist/env.cjs

@@ -1,2 +1,2 @@
-"use strict";var e=require("node:path"),n=require("dotenv");exports.loadEnvironmentVariables=function(a,o){let t=(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===t.length&&t.push(".env"),t=t.flatMap((e=>r?[`${e}.${r}.local`,`${e}.local`,`${e}.${r}`,e]:[`${e}.local`,e]))),a.verbose&&console.info("Loading env files:",t);let s={};for(const a of t)s={...n.config({path:e.join(o,a)}).parsed,...s};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}};
+"use strict";var e=require("node:path"),n=require("dotenv");exports.loadEnvironmentVariables=function(a,o){let t=(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===t.length&&t.push(".env"),t=t.flatMap((e=>r?[`${e}.${r}.local`,`${e}.local`,`${e}.${r}`,e]:[`${e}.local`,e]))),a.verbose&&console.info("Loading env files:",t);let s={};for(const a of t)s={...n.config({path:e.join(o,a)}).parsed,...s};if(a.checkEnv){const t=Object.keys(n.config({path:e.join(o,a.checkEnv)}).parsed||{});for(const e of t)if(!(e in s))throw new Error(`Missing environment variable: ${e}`)}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"}};
 //# 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  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} 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  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","PATH","BERRY_BIN_FOLDER","replace","replaceAll","key","Object","keys","upperKey","toUpperCase","startsWith","description","type","default"],"mappings":"6FAsCO,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,GAEtE,OAAOA,CACT,+CAKO,SAA8CA,GAE/CA,EAAQK,MAAQL,EAAQM,mBAC1BN,EAAQK,KAAOL,EAAQK,KAAKE,QAAS,GAAEP,EAAQM,oBAAqB,IAEjEE,WAAW,mCAAoC,IAE/CA,WAAW,sBAAuB,IAClCA,WAAW,iBAAkB,KAElC,IAAK,MAAMC,KAAOC,OAAOC,KAAKX,GAAU,CACtC,MAAMY,EAAWH,EAAII,eAEnBD,EAASE,WAAW,SACpBF,EAASE,WAAW,UACpBF,EAASE,WAAW,WACP,gBAAbF,GACa,aAAbA,WAEOZ,EAAQS,EAEnB,CACF,oCA/EyC,CACvC5B,IAAK,CACHkC,YAAa,2BACbC,KAAM,SAER,cAAe,CACbD,YACE,wLACFC,KAAM,UAER,mBAAoB,CAClBD,YACE,yHACFC,KAAM,WAER,mBAAoB,CAClBD,YACE,wGACFC,KAAM,UACNC,SAAS"}
+{"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    for (const key of exampleKeys) {\n      if (!(key in envVars)) {\n        throw new Error(`Missing environment variable: ${key}`);\n      }\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","exampleKeys","Object","keys","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,MAAMC,EAAcC,OAAOC,KAAKP,SAAO,CAAEC,KAAMA,EAAKC,KAAKxB,EAAKD,EAAK2B,YAAaD,QAAU,CAAA,GAC1F,IAAK,MAAMK,KAAOH,EAChB,KAAMG,KAAOT,GACX,MAAM,IAAIU,MAAO,iCAAgCD,IAGvD,CACA,OAAOT,CACT,+CAKO,SAA8CA,GAE/CA,EAAQW,MAAQX,EAAQY,mBAC1BZ,EAAQW,KAAOX,EAAQW,KAAKE,QAAS,GAAEb,EAAQY,oBAAqB,IAEjEE,WAAW,mCAAoC,IAE/CA,WAAW,sBAAuB,IAClCA,WAAW,iBAAkB,KAElC,IAAK,MAAML,KAAOF,OAAOC,KAAKR,GAAU,CACtC,MAAMe,EAAWN,EAAIO,eAEnBD,EAASE,WAAW,SACpBF,EAASE,WAAW,UACpBF,EAASE,WAAW,WACP,gBAAbF,GACa,aAAbA,WAEOf,EAAQS,EAEnB,CACF,oCA7FyC,CACvC5B,IAAK,CACHqC,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

@@ -3,6 +3,7 @@ interface Options {
     cascadeEnv?: string;
     cascadeNodeEnv?: boolean;
     autoCascadeEnv?: boolean;
+    checkEnv?: string;
     verbose?: boolean;
 }
 export declare const yargsOptionsBuilderForEnv: {
@@ -23,6 +24,11 @@ export declare const yargsOptionsBuilderForEnv: {
         readonly type: "boolean";
         readonly default: true;
     };
+    readonly 'check-env': {
+        readonly description: "Check whether the keys of the loaded .env files are same with the given .env file.";
+        readonly type: "string";
+        readonly default: ".env.example";
+    };
 };
 /**
  * This function loads environment variables from `.env` files.

package/dist/env.js

@@ -1,2 +1,2 @@
-import e from"node:path";import{config as n}from"dotenv";const a={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}};function o(a,o){let t=(a.env??[]).map((e=>e.toString()));const s=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 s&&(0===t.length&&t.push(".env"),t=t.flatMap((e=>s?[`${e}.${s}.local`,`${e}.local`,`${e}.${s}`,e]:[`${e}.local`,e]))),a.verbose&&console.info("Loading env files:",t);let c={};for(const a of t)c={...n({path:e.join(o,a)}).parsed,...c};return c}function t(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]}}export{o as loadEnvironmentVariables,t as removeNpmAndYarnEnvironmentVariables,a as yargsOptionsBuilderForEnv};
+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 o(t,o){let a=(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===a.length&&a.push(".env"),a=a.flatMap((e=>s?[`${e}.${s}.local`,`${e}.local`,`${e}.${s}`,e]:[`${e}.local`,e]))),t.verbose&&console.info("Loading env files:",a);let c={};for(const t of a)c={...n({path:e.join(o,t)}).parsed,...c};if(t.checkEnv){const a=Object.keys(n({path:e.join(o,t.checkEnv)}).parsed||{});for(const e of a)if(!(e in c))throw new Error(`Missing environment variable: ${e}`)}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 t=n.toUpperCase();(t.startsWith("NPM_")||t.startsWith("YARN_")||t.startsWith("BERRY_")||"PROJECT_CWD"===t||"INIT_CWD"===t)&&delete e[n]}}export{o as loadEnvironmentVariables,a as removeNpmAndYarnEnvironmentVariables,t 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  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} 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  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","removeNpmAndYarnEnvironmentVariables","PATH","BERRY_BIN_FOLDER","replace","replaceAll","key","Object","keys","upperKey","toUpperCase","startsWith"],"mappings":"yDAYO,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,IAON,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,GAEtE,OAAOA,CACT,CAKO,SAASK,EAAqCL,GAE/CA,EAAQM,MAAQN,EAAQO,mBAC1BP,EAAQM,KAAON,EAAQM,KAAKE,QAAS,GAAER,EAAQO,oBAAqB,IAEjEE,WAAW,mCAAoC,IAE/CA,WAAW,sBAAuB,IAClCA,WAAW,iBAAkB,KAElC,IAAK,MAAMC,KAAOC,OAAOC,KAAKZ,GAAU,CACtC,MAAMa,EAAWH,EAAII,eAEnBD,EAASE,WAAW,SACpBF,EAASE,WAAW,UACpBF,EAASE,WAAW,WACP,gBAAbF,GACa,aAAbA,WAEOb,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): 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    for (const key of exampleKeys) {\n      if (!(key in envVars)) {\n        throw new Error(`Missing environment variable: ${key}`);\n      }\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","exampleKeys","Object","keys","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,MAAMC,EAAcC,OAAOC,KAAKP,EAAO,CAAEC,KAAMA,EAAKC,KAAKvB,EAAKD,EAAK0B,YAAaD,QAAU,CAAA,GAC1F,IAAK,MAAMK,KAAOH,EAChB,KAAMG,KAAOT,GACX,MAAM,IAAIU,MAAO,iCAAgCD,IAGvD,CACA,OAAOT,CACT,CAKO,SAASW,EAAqCX,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,MAAMN,KAAOF,OAAOC,KAAKR,GAAU,CACtC,MAAMgB,EAAWP,EAAIQ,eAEnBD,EAASE,WAAW,SACpBF,EAASE,WAAW,UACpBF,EAASE,WAAW,WACP,gBAAbF,GACa,aAAbA,WAEOhB,EAAQS,EAEnB,CACF"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@willbooster/shared-lib-node",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "license": "Apache-2.0",
   "author": "WillBooster Inc.",
   "sideEffects": false,
   "type": "module",
   "exports": {
     ".": {
-      "require": "./dist/cjs/index.cjs",
+      "require": "./dist/index.cjs",
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
@@ -17,7 +17,7 @@
       "types": "./src/index.ts"
     }
   },
-  "main": "dist/cjs/index.cjs",
+  "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [