@nitra/check-env 4.0.0 → 4.1.0

package/README.md

@@ -8,7 +8,7 @@ and that you did not leave dangerous development overrides in production.
 ## Installation
 
 ```bash
-yarn add @nitra/check-env
+bun add @nitra/check-env
 ```
 
 ## Usage
@@ -31,6 +31,17 @@ If some required environment variable are not set, it will tell you and throw
 an error at the end:
 !["CLI output"](output.png)
 
+## SKIP_CHECK_ENV
+
+If the `SKIP_CHECK_ENV` environment variable is set, the library will skip required variable checks and will not throw. This can be useful for local development or specific CI scenarios.
+
+```bash
+SKIP_CHECK_ENV=1 bun node app.js
+```
+
+- With `SKIP_CHECK_ENV` enabled, you'll see a warning in logs: `SKIP_CHECK_ENV is set, skipping environment variable check`.
+- The exported `env` will behave like plain `process.env` (no proxy checks for prior validation).
+
 ## License
 
 [MIT](https://github.com/47ng/check-env/blob/master/LICENSE) - Made with ❤️ by [François Best](https://francoisbest.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/check-env",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Check that the critical environment variables are set",
   "type": "module",
   "main": "./src/index.js",
@@ -32,6 +32,6 @@
     "types"
   ],
   "dependencies": {
-    "@nitra/pino": "^2.3.0"
+    "@nitra/pino": "^2.7.4"
   }
 }

package/src/index.js

@@ -1,7 +1,7 @@
-import process from 'node:process'
-import log from '@nitra/pino'
+import { log } from '@nitra/pino'
+import { env as pEnv } from 'node:process'
 
-const testEnv = name => !process.env[name]
+const testEnv = name => !pEnv[name]
 
 const displayMissing = name => {
   log.error(`❌  Missing required environment variable ${name}`)
@@ -24,9 +24,15 @@ const checked = new Set()
 /**
  * Перевірка наявності змінних середовища
  * @function
- * @param {Array.<string>} required
+ * @param {Array.<string>} required - список обов'язкових змінних середовища
  */
 export const checkEnv = required => {
+  // Якщо змінна SKIP_CHECK_ENV встановлена, то пропускаємо перевірку
+  if (pEnv.SKIP_CHECK_ENV) {
+    log.warn('SKIP_CHECK_ENV is set, skipping environment variable check')
+    return
+  }
+
   const missingReq = []
 
   for (const name of required) {
@@ -52,11 +58,11 @@ export default checkEnv
 
 const envProxyHandler = {
   /**
-   * Set colour of object
-   * @param target
-   * @param prop
-   * @param _
-   * @returns {string}
+   * Проксі-доступ до значень змінних середовища
+   * @param {object} target - об'єкт із змінними середовища
+   * @param {string} prop - назва змінної середовища
+   * @param {unknown} _ - не використовується
+   * @returns {string} - значення змінної середовища
    */
   get(target, prop, _) {
     // Якщо зі списку перевірених то повертаємо значення
@@ -70,6 +76,6 @@ const envProxyHandler = {
 }
 
 /**
- * @type {Object.<string, string>}
+ * @type {Record<string, string>}
  */
-export const env = new Proxy(process.env, envProxyHandler)
+export const env = pEnv.SKIP_CHECK_ENV ? pEnv : new Proxy(pEnv, envProxyHandler) // Якщо змінна SKIP_CHECK_ENV встановлена, то пропускаємо перевірку

package/types/index.d.ts

@@ -2,7 +2,7 @@
  * MissingEnvironmentVariableError
  *
  * @class
- * @extends Error
+ * @augments Error
  */
 export class MissingEnvironmentVariableError extends Error {
     constructor(envs: any);