@expressots/shared 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Richard Zampieri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+<a name="readme-top"></a>
+
+<!-- PROJECT SHIELDS -->
+
+[![Codecov][codecov-shield]][codecov-url]
+[![NPM][npm-shield]][npm-url]
+![Build][build-shield]
+[![Contributors][contributors-shield]][contributors-url]
+[![Forks][forks-shield]][forks-url]
+[![Stargazers][stars-shield]][stars-url]
+[![Issues][issues-shield]][issues-url]
+[![MIT License][license-shield]][license-url]
+[![LinkedIn][linkedin-shield]][linkedin-url]
+
+<!-- PROJECT LOGO -->
+<br />
+<div align="center">
+  <a href="https://github.com/othneildrew/Best-README-Template">
+    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="Logo" width="120">
+  </a>
+
+  <h3 align="center">ExpressoTS Framework</h3>
+
+  <p align="center">
+    Everything you need to know to build applications with ExpressoTS
+    <br />
+    <a href="https://doc.expresso-ts.com/"><strong>Explore the docs »</strong></a>
+    <br />
+    <br />
+    <a href="https://github.com/expressots/expressots/discussions">Let's discuss</a>
+    ·
+    <a href="https://github.com/expressots/expressots/issues">Report Bug</a>
+    ·
+    <a href="https://github.com/expressots/expressots/issues">Request Feature</a>
+  </p>
+</div>
+
+<!-- TABLE OF CONTENTS -->
+<details>
+  <summary>Table of Contents</summary>
+  <ol>
+    <li><a href="#about-the-project">About The Project</a></li>
+    <li><a href="#getting-started">Getting Started</a></li>
+    <li><a href="#contributing">Contributing</a></li>
+    <li><a href="#support-the-project">Support the project</a></li>
+    <li><a href="#license">License</a></li>
+  </ol>
+</details>
+
+<!-- ABOUT THE PROJECT -->
+
+# About The Project
+
+ExpressoTS is a [Typescript](https://www.typescriptlang.org/) + [Node.js](https://nodejs.org/en/) lightweight framework for quick building scalable, easy to read and maintain, server-side applications 🐎
+
+## Getting Started
+
+- Here is our [Site](https://expresso-ts.com/)
+- You can find our [Documentation here](https://doc.expresso-ts.com/)
+- Checkout our [First Steps documentation](https://doc.expresso-ts.com/docs/overview/first-steps)
+- Our [CLI Documentation](https://doc.expresso-ts.com/docs/cli/overview)
+
+## Contributing
+
+Welcome to the ExpressoTS community, a place bustling with innovative minds just like yours. We're absolutely thrilled to have you here!
+ExpressoTS is more than just a TypeScript framework; it's a collective effort by developers who are passionate about creating a more efficient, secure, and robust web ecosystem. We firmly believe that the best ideas come from a diversity of perspectives, backgrounds, and skills.
+
+Why Contribute to Documentation?
+
+- **Share Knowledge**: If you've figured out something cool, why keep it to yourself?
+- **Build Your Portfolio**: Contributing to an open-source project like ExpressoTS is a great way to showcase your skills.
+- **Join a Network**: Get to know a community of like-minded developers.
+- **Improve the Product**: Help us fill in the gaps, correct errors, or make complex topics easier to understand.
+
+Ready to contribute?
+
+- [Contributing Guidelines](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md)
+- [How to Contribute](https://github.com/expressots/expressots/blob/main/CONTRIBUTING_HOWTO.md)
+- [Coding Guidelines](https://github.com/rsaz/TypescriptCodingGuidelines)
+
+## Support the project
+
+ExpressoTS is an independent open source project with ongoing development made possible thanks to your support. If you'd like to help, please consider:
+
+- Become a **[sponsor on GitHub](https://github.com/sponsors/expressots)**
+- Follow the **[organization](https://github.com/expressots)** on GitHub and Star ⭐ the project
+- Subscribe to the Twitch channel: **[Richard Zampieri](https://www.twitch.tv/richardzampieri)**
+- Join our **[Discord](https://discord.com/invite/PyPJfGK)**
+- Contribute submitting **[issues and pull requests](https://github.com/expressots/expressots/issues)**
+- Share the project with your friends and colleagues
+
+## License
+
+Distributed under the MIT License. See [`LICENSE.txt`](https://github.com/expressots/expressots/blob/main/LICENSE) for more information.
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+<!-- MARKDOWN LINKS & IMAGES -->
+<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
+
+[codecov-url]: https://codecov.io/gh/expressots/shared
+[codecov-shield]: https://img.shields.io/codecov/c/gh/expressots/shared/main?style=for-the-badge&logo=codecov&labelColor=FB9AD1
+[npm-url]: https://www.npmjs.com/package/@expressots/shared
+[npm-shield]: https://img.shields.io/npm/v/@expressots/shared?style=for-the-badge&logo=npm&color=9B3922
+[build-shield]: https://img.shields.io/github/actions/workflow/status/expressots/adapter-express/build.yaml?branch=main&style=for-the-badge&logo=github
+[contributors-shield]: https://img.shields.io/github/contributors/expressots/shared?style=for-the-badge
+[contributors-url]: https://github.com/expressots/shared/graphs/contributors
+[forks-shield]: https://img.shields.io/github/forks/expressots/shared?style=for-the-badge
+[forks-url]: https://github.com/expressots/shared/forks
+[stars-shield]: https://img.shields.io/github/stars/expressots/shared?style=for-the-badge
+[stars-url]: https://github.com/expressots/shared/stargazers
+[issues-shield]: https://img.shields.io/github/issues/expressots/shared?style=for-the-badge
+[issues-url]: https://github.com/expressots/shared/issues
+[license-shield]: https://img.shields.io/github/license/expressots/shared?style=for-the-badge
+[license-url]: https://github.com/expressots/shared/blob/main/LICENSE
+[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
+[linkedin-url]: https://www.linkedin.com/company/expresso-ts/
+[product-screenshot]: images/screenshot.png

package/lib/CHANGELOG.md

@@ -0,0 +1,8 @@
+
+
+## 0.0.1 (2023-09-05)
+
+
+### Bug Fixes
+
+* testing commitlint ([0e78653](https://github.com/expressots/<<repo_name>>/commit/0e786539402f69fdca3fe5b684d850e523db7698))

package/lib/README.md

@@ -0,0 +1,118 @@
+<a name="readme-top"></a>
+
+<!-- PROJECT SHIELDS -->
+
+[![Codecov][codecov-shield]][codecov-url]
+[![NPM][npm-shield]][npm-url]
+![Build][build-shield]
+[![Contributors][contributors-shield]][contributors-url]
+[![Forks][forks-shield]][forks-url]
+[![Stargazers][stars-shield]][stars-url]
+[![Issues][issues-shield]][issues-url]
+[![MIT License][license-shield]][license-url]
+[![LinkedIn][linkedin-shield]][linkedin-url]
+
+<!-- PROJECT LOGO -->
+<br />
+<div align="center">
+  <a href="https://github.com/othneildrew/Best-README-Template">
+    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="Logo" width="120">
+  </a>
+
+  <h3 align="center">ExpressoTS Framework</h3>
+
+  <p align="center">
+    Everything you need to know to build applications with ExpressoTS
+    <br />
+    <a href="https://doc.expresso-ts.com/"><strong>Explore the docs »</strong></a>
+    <br />
+    <br />
+    <a href="https://github.com/expressots/expressots/discussions">Let's discuss</a>
+    ·
+    <a href="https://github.com/expressots/expressots/issues">Report Bug</a>
+    ·
+    <a href="https://github.com/expressots/expressots/issues">Request Feature</a>
+  </p>
+</div>
+
+<!-- TABLE OF CONTENTS -->
+<details>
+  <summary>Table of Contents</summary>
+  <ol>
+    <li><a href="#about-the-project">About The Project</a></li>
+    <li><a href="#getting-started">Getting Started</a></li>
+    <li><a href="#contributing">Contributing</a></li>
+    <li><a href="#support-the-project">Support the project</a></li>
+    <li><a href="#license">License</a></li>
+  </ol>
+</details>
+
+<!-- ABOUT THE PROJECT -->
+
+# About The Project
+
+ExpressoTS is a [Typescript](https://www.typescriptlang.org/) + [Node.js](https://nodejs.org/en/) lightweight framework for quick building scalable, easy to read and maintain, server-side applications 🐎
+
+## Getting Started
+
+- Here is our [Site](https://expresso-ts.com/)
+- You can find our [Documentation here](https://doc.expresso-ts.com/)
+- Checkout our [First Steps documentation](https://doc.expresso-ts.com/docs/overview/first-steps)
+- Our [CLI Documentation](https://doc.expresso-ts.com/docs/cli/overview)
+
+## Contributing
+
+Welcome to the ExpressoTS community, a place bustling with innovative minds just like yours. We're absolutely thrilled to have you here!
+ExpressoTS is more than just a TypeScript framework; it's a collective effort by developers who are passionate about creating a more efficient, secure, and robust web ecosystem. We firmly believe that the best ideas come from a diversity of perspectives, backgrounds, and skills.
+
+Why Contribute to Documentation?
+
+- **Share Knowledge**: If you've figured out something cool, why keep it to yourself?
+- **Build Your Portfolio**: Contributing to an open-source project like ExpressoTS is a great way to showcase your skills.
+- **Join a Network**: Get to know a community of like-minded developers.
+- **Improve the Product**: Help us fill in the gaps, correct errors, or make complex topics easier to understand.
+
+Ready to contribute?
+
+- [Contributing Guidelines](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md)
+- [How to Contribute](https://github.com/expressots/expressots/blob/main/CONTRIBUTING_HOWTO.md)
+- [Coding Guidelines](https://github.com/rsaz/TypescriptCodingGuidelines)
+
+## Support the project
+
+ExpressoTS is an independent open source project with ongoing development made possible thanks to your support. If you'd like to help, please consider:
+
+- Become a **[sponsor on GitHub](https://github.com/sponsors/expressots)**
+- Follow the **[organization](https://github.com/expressots)** on GitHub and Star ⭐ the project
+- Subscribe to the Twitch channel: **[Richard Zampieri](https://www.twitch.tv/richardzampieri)**
+- Join our **[Discord](https://discord.com/invite/PyPJfGK)**
+- Contribute submitting **[issues and pull requests](https://github.com/expressots/expressots/issues)**
+- Share the project with your friends and colleagues
+
+## License
+
+Distributed under the MIT License. See [`LICENSE.txt`](https://github.com/expressots/expressots/blob/main/LICENSE) for more information.
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+<!-- MARKDOWN LINKS & IMAGES -->
+<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
+
+[codecov-url]: https://codecov.io/gh/expressots/shared
+[codecov-shield]: https://img.shields.io/codecov/c/gh/expressots/shared/main?style=for-the-badge&logo=codecov&labelColor=FB9AD1
+[npm-url]: https://www.npmjs.com/package/@expressots/shared
+[npm-shield]: https://img.shields.io/npm/v/@expressots/shared?style=for-the-badge&logo=npm&color=9B3922
+[build-shield]: https://img.shields.io/github/actions/workflow/status/expressots/adapter-express/build.yaml?branch=main&style=for-the-badge&logo=github
+[contributors-shield]: https://img.shields.io/github/contributors/expressots/shared?style=for-the-badge
+[contributors-url]: https://github.com/expressots/shared/graphs/contributors
+[forks-shield]: https://img.shields.io/github/forks/expressots/shared?style=for-the-badge
+[forks-url]: https://github.com/expressots/shared/forks
+[stars-shield]: https://img.shields.io/github/stars/expressots/shared?style=for-the-badge
+[stars-url]: https://github.com/expressots/shared/stargazers
+[issues-shield]: https://img.shields.io/github/issues/expressots/shared?style=for-the-badge
+[issues-url]: https://github.com/expressots/shared/issues
+[license-shield]: https://img.shields.io/github/license/expressots/shared?style=for-the-badge
+[license-url]: https://github.com/expressots/shared/blob/main/LICENSE
+[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
+[linkedin-url]: https://www.linkedin.com/company/expresso-ts/
+[product-screenshot]: images/screenshot.png

package/lib/cjs/config/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/config/project-config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/env/cli-options.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optionMatcher = optionMatcher;
+const constants_1 = require("./constants");
+/**
+ * Matches the options passed in the command line
+ * @param args - The arguments passed in the command line
+ * @returns The options passed in the command line
+ */
+function optionMatcher(args) {
+    return args.reduce((previous, current) => {
+        const matches = current.match(constants_1.ENV_VAR_REGEX);
+        if (matches) {
+            previous[matches[1]] = matches[2];
+        }
+        return previous;
+    }, {});
+}

package/lib/cjs/env/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENV_VAR_REGEX = exports.LINE_REGEX = void 0;
+/**
+ * LINE_REGEX is a regular expression that matches a line in a .env file.
+ * It is used to parse the content of the .env file.
+ */
+exports.LINE_REGEX = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/gm;
+/**
+ * ENV_VAR_REGEX is a regular expression that matches an environment variable in the command line.
+ * It is used to parse the options passed in the command line.
+ */
+exports.ENV_VAR_REGEX = /^dotenv_config_(encoding|path|debug|override|vaultEnvKey)=(.+)$/;

package/lib/cjs/env/env-options.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPTIONS = void 0;
+/**
+ * The options for the dotenv configuration.
+ */
+exports.OPTIONS = {};
+if (process.env.DOTENV_CONFIG_ENCODING != null) {
+    exports.OPTIONS.encoding = process.env.DOTENV_CONFIG_ENCODING;
+}
+if (process.env.DOTENV_CONFIG_PATH != null) {
+    exports.OPTIONS.path = process.env.DOTENV_CONFIG_PATH;
+}
+if (process.env.DOTENV_CONFIG_DEBUG != null) {
+    exports.OPTIONS.debug = process.env.DOTENV_CONFIG_DEBUG === "true";
+}
+if (process.env.DOTENV_CONFIG_OVERRIDE != null) {
+    exports.OPTIONS.override = process.env.DOTENV_CONFIG_OVERRIDE === "true";
+}
+if (process.env.DOTENV_CONFIG_DOTENV_KEY != null) {
+    exports.OPTIONS.vaultEnvKey = process.env.DOTENV_CONFIG_DOTENV_KEY;
+}

package/lib/cjs/env/environment.js

@@ -0,0 +1,316 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._configVault = _configVault;
+exports.config = config;
+exports.configDotenv = configDotenv;
+exports.parse = parse;
+exports.decrypt = decrypt;
+exports.populate = populate;
+exports._parseVault = _parseVault;
+exports._vaultPath = _vaultPath;
+exports._dotenvKey = _dotenvKey;
+exports._instructions = _instructions;
+exports._resolveHome = _resolveHome;
+/* eslint-disable @typescript-eslint/explicit-function-return-type */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const crypto_1 = __importDefault(require("crypto"));
+const constants_1 = require("./constants");
+const logger_1 = require("../utils/logger");
+/**
+ * Module to parse the .env.vault file
+ * @param options - The configuration options
+ * @returns The parsed object
+ */
+function _parseVault(options) {
+    const vaultPath = _vaultPath(options);
+    const result = configDotenv({ path: vaultPath });
+    if (!result.parsed) {
+        const err = new Error(`MISSING_DATA: Cannot parse ${vaultPath} for an unknown reason`);
+        err.name = "MISSING_DATA";
+        throw err;
+    }
+    //DOTENV_KEY="dotenv://:key_1234@dotenvx.com/vault/.env.vault?environment=prod, // dotenv://:key_7890@dotenvx.com/vault/.env.vault?environment=prod"
+    const keys = _dotenvKey(options).split(",");
+    const length = keys.length;
+    let decrypted = "";
+    for (let i = 0; i < length; i++) {
+        try {
+            const key = keys[i].trim();
+            const attrs = _instructions(result, key);
+            decrypted = decrypt(attrs.ciphertext, attrs.key);
+            break;
+        }
+        catch (error) {
+            if (i + 1 >= length) {
+                throw error;
+            }
+        }
+    }
+    return parse(decrypted);
+}
+/**
+ * Module to verify and return the .env.vault file path
+ * @param options - The configuration options
+ * @returns The .env.vault file path
+ */
+function _vaultPath(options) {
+    let possibleVaultPath = null;
+    if (options && options.path && options.path.length > 0) {
+        if (Array.isArray(options.path)) {
+            for (const filepath of options.path) {
+                if (fs_1.default.existsSync(filepath)) {
+                    possibleVaultPath = filepath.endsWith(".vault") ? filepath : `${filepath}.vault`;
+                }
+            }
+        }
+        else {
+            possibleVaultPath = options.path.endsWith(".vault") ? options.path : `${options.path}.vault`;
+        }
+    }
+    else {
+        possibleVaultPath = path_1.default.resolve(process.cwd(), ".env.vault");
+    }
+    if (fs_1.default.existsSync(possibleVaultPath)) {
+        return possibleVaultPath;
+    }
+    return null;
+}
+/**
+ * Module to verify and return the DOTENV_KEY vault key
+ * @param options - The configuration options
+ * @returns The DOTENV_KEY as a string
+ */
+function _dotenvKey(options) {
+    if (options && options.vaultEnvKey && options.vaultEnvKey.length > 0) {
+        return options.vaultEnvKey;
+    }
+    if (process.env.DOTENV_KEY && process.env.DOTENV_KEY.length > 0) {
+        return process.env.DOTENV_KEY;
+    }
+    return "";
+}
+/**
+ * Module to get instructions for decrypting the .env.vault file
+ * @param result -
+ * @param dotenvKey
+ * @returns
+ */
+function _instructions(result, dotenvKey) {
+    let uri = null;
+    try {
+        uri = new URL(dotenvKey);
+    }
+    catch (error) {
+        if (error.code === "ERR_INVALID_URL") {
+            const err = new Error("INVALID_DOTENV_KEY: Wrong format. Must be in valid uri format like dotenv://:key_1234@dotenvx.com/vault/.env.vault?environment=development");
+            err.code = "INVALID_DOTENV_KEY";
+            throw err;
+        }
+        throw error;
+    }
+    // Get decrypt key
+    const key = uri.password;
+    if (!key) {
+        const err = new Error("INVALID_DOTENV_KEY: Missing key part");
+        err.code = "INVALID_DOTENV_KEY";
+        throw err;
+    }
+    // Get environment
+    const environment = uri.searchParams.get("environment");
+    if (!environment) {
+        const err = new Error("INVALID_DOTENV_KEY: Missing environment part");
+        err.code = "INVALID_DOTENV_KEY";
+        throw err;
+    }
+    // Get ciphertext payload
+    const environmentKey = `DOTENV_VAULT_${environment.toUpperCase()}`;
+    const ciphertext = result.parsed[environmentKey]; // DOTENV_VAULT_PRODUCTION
+    if (!ciphertext) {
+        const err = new Error(`NOT_FOUND_DOTENV_ENVIRONMENT: Cannot locate environment ${environmentKey} in your .env.vault file.`);
+        err.code = "NOT_FOUND_DOTENV_ENVIRONMENT";
+        throw err;
+    }
+    return { ciphertext, key };
+}
+/**
+ * Module responsible to resolve home path
+ * @param envPath - The path to resolve
+ * @returns The resolved path
+ */
+function _resolveHome(envPath) {
+    return envPath[0] === "~" ? path_1.default.join(os_1.default.homedir(), envPath.slice(1)) : envPath;
+}
+/**
+ * Module to load environment variables from .env.vault file
+ * @param options - The configuration options
+ * @returns The parsed object
+ */
+function _configVault(options) {
+    (0, logger_1.log)("Loading env from encrypted .env.vault");
+    const parsed = _parseVault(options);
+    let processEnv = process.env;
+    if (options && options.envObject != null) {
+        processEnv = options.envObject;
+    }
+    populate(processEnv, parsed, options);
+    return { parsed };
+}
+/**
+ * Module to load environment variables from .env file
+ * @param options - The configuration options
+ * @returns The parsed object
+ * @public API
+ */
+function config(options) {
+    if (_dotenvKey(options).length === 0) {
+        return configDotenv(options);
+    }
+    const vaultPath = _vaultPath(options);
+    console.log(vaultPath);
+    if (!vaultPath) {
+        (0, logger_1.log)(`You set DOTENV_KEY but you are missing a .env.vault file at ${vaultPath}. Did you forget to build it?`, logger_1.LogLevel.Warn);
+        return configDotenv(options);
+    }
+    return _configVault(options);
+}
+/**
+ * Module to load environment variables from .env file
+ * @param options - The configuration options
+ * @returns The parsed object
+ * @public API
+ */
+function configDotenv(options) {
+    const dotenvPath = path_1.default.resolve(process.cwd(), String(options?.path ?? ".env"));
+    const encoding = (options.encoding ?? "utf8");
+    const debug = !!options.debug;
+    const paths = Array.isArray(options.path)
+        ? options.path.map(_resolveHome)
+        : [_resolveHome(dotenvPath)];
+    const parsed = {};
+    let lastError;
+    for (const envPath of paths) {
+        try {
+            const fileContent = fs_1.default.readFileSync(envPath, { encoding });
+            const parsedContent = parse(fileContent);
+            populate(process.env, parsedContent, options);
+        }
+        catch (error) {
+            lastError = error;
+            if (debug) {
+                (0, logger_1.log)(`Failed to load ${envPath} file with error: ${error.message}`, logger_1.LogLevel.Debug);
+            }
+        }
+    }
+    return { parsed, error: lastError };
+}
+/**
+ * Module to load environment variables from .env file
+ * @param envFile - The source of the .env file
+ * @returns The parsed object
+ * @public API
+ */
+function parse(envFile) {
+    const obj = {};
+    const lines = envFile.toString().replace(/\r\n?/gm, "\n");
+    let match;
+    while ((match = constants_1.LINE_REGEX.exec(lines)) != null) {
+        const key = match[1].trim();
+        let value = match[2]?.trim() ?? "";
+        if (["'", '"', "`"].includes(value[0])) {
+            value = value.slice(1, -1);
+        }
+        value = value.replace(/^(['"`])([\s\S]*)\1$/gm, "$2");
+        if (match[2]?.[0] === '"') {
+            value = value.replace(/\\n/g, "\n").replace(/\\r/g, "\r");
+        }
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * Decrypts a base64 encoded string
+ * @param encrypted - The base64 encoded string to decrypt
+ * @param keyStr - The key to use for decryption
+ * @returns The decrypted string
+ * @public API
+ */
+function decrypt(encrypted, keyStr) {
+    const key = Buffer.from(keyStr.slice(-64), "hex");
+    let ciphertext = Buffer.from(encrypted, "base64");
+    const nonce = ciphertext.subarray(0, 12);
+    const authTag = ciphertext.subarray(-16);
+    ciphertext = ciphertext.subarray(12, -16);
+    try {
+        const aesgcm = crypto_1.default.createDecipheriv("aes-256-gcm", key, nonce);
+        aesgcm.setAuthTag(authTag);
+        return `${aesgcm.update(ciphertext)}${aesgcm.final()}`;
+    }
+    catch (error) {
+        const isRange = error instanceof RangeError;
+        const invalidKeyLength = error.message === "Invalid key length";
+        const decryptionFailed = error.message === "Unsupported state or unable to authenticate data";
+        if (isRange || invalidKeyLength) {
+            const err = new Error("INVALID_DOTENV_KEY: It must be 64 characters long (or more)");
+            err.name = "INVALID_DOTENV_KEY";
+            throw err;
+        }
+        else if (decryptionFailed) {
+            const err = new Error("DECRYPTION_FAILED: Please check your DOTENV_KEY");
+            err.name = "DECRYPTION_FAILED";
+            throw err;
+        }
+        else {
+            throw error;
+        }
+    }
+}
+/**
+ * Populates the environment with the given parsed object
+ * @param envObject - The object to populate the environment with (e.g. process.env)
+ * @param parsed - The parsed object
+ * @param options - The configuration options
+ * @public API
+ */
+function populate(envObject, // Usually process.env
+parsed, options = {}) {
+    const debug = Boolean(options && options.debug);
+    const override = Boolean(options && options.override);
+    if (typeof parsed !== "object") {
+        const err = new Error("OBJECT_REQUIRED: Please check the processEnv argument being passed to populate");
+        err.name = "OBJECT_REQUIRED";
+        throw err;
+    }
+    // Set process.env (envObject)
+    for (const key of Object.keys(parsed)) {
+        const parsedValue = parsed[key];
+        // Decide whether to override existing env var or not
+        if (Object.prototype.hasOwnProperty.call(envObject, key)) {
+            if (override) {
+                envObject[key] = parsedValue;
+                if (debug) {
+                    (0, logger_1.log)(`"${key}" was overwritten to "${parsedValue}"`, logger_1.LogLevel.Debug);
+                }
+            }
+            else if (debug) {
+                (0, logger_1.log)(`"${key}" was NOT overwritten (already exists)`, logger_1.LogLevel.Debug);
+            }
+        }
+        else {
+            // Variable doesn't exist in process.env, so set it
+            envObject[key] = parsedValue;
+            if (debug) {
+                (0, logger_1.log)(`"${key}" was set to "${parsedValue}"`, logger_1.LogLevel.Debug);
+            }
+        }
+    }
+    // Final debug log to ensure variables are correctly populated
+    if (debug) {
+        console.log("Final process.env object:", envObject);
+    }
+}

package/lib/cjs/env/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./environment"), exports);

package/lib/cjs/env/interfaces.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });