@expressots/shared 4.0.0-preview.1 → 4.0.0-preview.3

package/LICENSE.md

@@ -1,21 +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.
+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

@@ -1,51 +1,51 @@
-<div align="center">
-  <a href="https://expresso-ts.com">
-    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="ExpressoTS" width="120">
-  </a>
-
-  <h1>@expressots/shared</h1>
-
-  <p>Shared types, interfaces, and utilities used across all ExpressoTS packages.</p>
-
-  <p>
-    <a href="https://www.npmjs.com/package/@expressots/shared"><img src="https://img.shields.io/npm/v/@expressots/shared?style=flat&color=0d0d0d" alt="npm"></a>
-    <a href="https://github.com/expressots/shared/blob/main/LICENSE.md"><img src="https://img.shields.io/github/license/expressots/shared?style=flat&color=0d0d0d" alt="License"></a>
-    <a href="https://discord.com/invite/PyPJfGK"><img src="https://img.shields.io/badge/Discord-join-0d0d0d?logo=discord&logoColor=white" alt="Discord"></a>
-  </p>
-
-  <p>
-    <a href="https://doc.expresso-ts.com">Documentation</a> ·
-    <a href="https://doc.expresso-ts.com/docs/core/first-steps">Getting Started</a> ·
-    <a href="https://discord.com/invite/PyPJfGK">Community</a>
-  </p>
-</div>
-
----
-
-## Install
-
-```bash
-npm i @expressots/shared
-```
-
-## What This Package Does
-
-This is the shared foundation layer for the ExpressoTS ecosystem. It provides common TypeScript interfaces, configuration types, environment utilities, and helper functions that `@expressots/core`, `@expressots/adapter-express`, and other packages depend on. Most applications consume it indirectly through the core package.
-
-## Documentation
-
-For guides, API reference, architecture patterns, and examples visit **[doc.expresso-ts.com](https://doc.expresso-ts.com)**.
-
-## Contributing
-
-See the [Contributing Guide](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md) for how to get involved.
-
-## Support
-
-- [GitHub Sponsors](https://github.com/sponsors/expressots)
-- [Discord](https://discord.com/invite/PyPJfGK)
-- [Report an Issue](https://github.com/expressots/shared/issues)
-
-## License
-
-MIT — see [LICENSE](./LICENSE.md).
+<div align="center">
+  <a href="https://expresso-ts.com">
+    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="ExpressoTS" width="120">
+  </a>
+
+  <h1>@expressots/shared</h1>
+
+  <p>Shared types, interfaces, and utilities used across all ExpressoTS packages.</p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/@expressots/shared"><img src="https://img.shields.io/npm/v/@expressots/shared?style=flat&color=0d0d0d" alt="npm"></a>
+    <a href="https://github.com/expressots/shared/blob/main/LICENSE.md"><img src="https://img.shields.io/github/license/expressots/shared?style=flat&color=0d0d0d" alt="License"></a>
+    <a href="https://discord.com/invite/PyPJfGK"><img src="https://img.shields.io/badge/Discord-join-0d0d0d?logo=discord&logoColor=white" alt="Discord"></a>
+  </p>
+
+  <p>
+    <a href="https://doc.expresso-ts.com">Documentation</a> ·
+    <a href="https://doc.expresso-ts.com/docs/core/first-steps">Getting Started</a> ·
+    <a href="https://discord.com/invite/PyPJfGK">Community</a>
+  </p>
+</div>
+
+---
+
+## Install
+
+```bash
+npm i @expressots/shared
+```
+
+## What This Package Does
+
+This is the shared foundation layer for the ExpressoTS ecosystem. It provides common TypeScript interfaces, configuration types, environment utilities, and helper functions that `@expressots/core`, `@expressots/adapter-express`, and other packages depend on. Most applications consume it indirectly through the core package.
+
+## Documentation
+
+For guides, API reference, architecture patterns, and examples visit **[doc.expresso-ts.com](https://doc.expresso-ts.com)**.
+
+## Contributing
+
+See the [Contributing Guide](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md) for how to get involved.
+
+## Support
+
+- [GitHub Sponsors](https://github.com/sponsors/expressots)
+- [Discord](https://discord.com/invite/PyPJfGK)
+- [Report an Issue](https://github.com/expressots/shared/issues)
+
+## License
+
+MIT — see [LICENSE](./LICENSE.md).

package/lib/CHANGELOG.md

@@ -1,89 +1,92 @@
-## [4.0.0](https://github.com/expressots/shared/compare/3.0.0...4.0.0) (2026-05-12)
-
-Part of the ExpressoTS **v4.0.0 release bundle**. See the [v4.0.0 release notes](https://expresso-ts.com/docs/4.0.0/prologue/release) and the [upgrade guide](https://expresso-ts.com/docs/4.0.0/prologue/upgrade_guide) for the full picture.
-
-### Features
-
-* extend `ExpressoConfig` with `scaffoldSchematics` covering all v4 schematics (`controller`, `usecase`, `dto`, `module`, `provider`, `entity`, `middleware`, `interceptor`, `event`, `handler`, `guard`, `config`).
-* add type-safe `Pattern` enum for the CLI `scaffoldPattern` option.
-* expose shared content-negotiation primitives consumed by `@expressots/core` formatters.
-* publish dual ESM + CJS builds with subpath exports for both module systems.
-
-### Bug Fixes
-
-* tighten the `IWebServer` / `IWebServerBuilder` typings so v4 adapters can declare their server contract without leaking Express types.
-
-### Build System
-
-* bump dev toolchain to TypeScript 5.5, ESLint 8.57, Jest 29.7, Prettier 3.5.
-
-## [3.0.0](https://github.com/expressots/shared/compare/3.0.0-beta.3...3.0.0) (2024-12-04)
-
-
-### Features
-
-* refactor IWebServer interface, add IWebServerBuilder ([9a23fff](https://github.com/expressots/shared/commit/9a23fff1e7de8d3880ed90317ffde1037ef1947b))
-* update initEnvironment method to return a Promise for better async handling ([6ae9525](https://github.com/expressots/shared/commit/6ae9525b5497dacf81c1861e467bf6e27421ad2e))
-
-## [3.0.0](https://github.com/expressots/shared/compare/3.0.0-beta.3...3.0.0) (2024-12-03)
-
-
-### Features
-
-* refactor IWebServer interface, add IWebServerBuilder ([9a23fff](https://github.com/expressots/shared/commit/9a23fff1e7de8d3880ed90317ffde1037ef1947b))
-
-## [3.0.0-beta.3](https://github.com/expressots/shared/compare/0.3.0...0.4.0) (2024-11-28)
-
-### Features
-
-- add close method to Server interface for graceful shutdown ([7d0cd8f](https://github.com/expressots/shared/commit/7d0cd8f1e05c5fed96e74b01dc715e5c7eb268d0))
-
-## [0.3.0](https://github.com/expressots/shared/compare/0.2.0...0.3.0) (2024-11-24)
-
-### Features
-
-- add entryPoint property to ExpressoConfig interface ([324ac37](https://github.com/expressots/shared/commit/324ac37a7d407c491881998c6ed3288e04a0ae39))
-
-## [0.2.0](https://github.com/expressots/shared/compare/0.1.0...0.2.0) (2024-11-16)
-
-### Features
-
-- add interfaces for console, middleware, and environment; update index exports ([30d7dbb](https://github.com/expressots/shared/commit/30d7dbb0c24af12e4537f626be816f2f5d8a81a0))
-
-### Bug Fixes
-
-- standardize quotes in middleware interface file ([6b3f045](https://github.com/expressots/shared/commit/6b3f0459c3ba0bf58d1de920335c6ef7dd438e32))
-
-### Tests
-
-- enhance coverage for configDotenv function and add edge case handling ([58612bd](https://github.com/expressots/shared/commit/58612bd0040b592133bac687cfb29b9c6ece2a94))
-
-## 0.1.0 (2024-11-10)
-
-### Features
-
-- add compiler and package definitions ([8352e66](https://github.com/expressots/shared/commit/8352e663c1a3429c70bbf7588380fe92f547e0a9))
-- add early ai unit test generation and code coverage ([7eb5f38](https://github.com/expressots/shared/commit/7eb5f380f6b49ce6316a9749daaa7311fda74f04))
-- add env and compiler modules ([f93f6c3](https://github.com/expressots/shared/commit/f93f6c3a719d1a1129112bee4e5e9cf6e42ddd89))
-- add global config interface ([cbe2e12](https://github.com/expressots/shared/commit/cbe2e127db006273e9049220fe3ed20b964d697b))
-- change to beta version ([4e835ca](https://github.com/expressots/shared/commit/4e835ca58933336bc78d66fb42935bf4d02ec641))
-- update readme to include badges ([5995b1a](https://github.com/expressots/shared/commit/5995b1a3eab1481aa4552ca76683c6b16ae0dc60))
-
-### Bug Fixes
-
-- add express config file for testing ([d7ae7e1](https://github.com/expressots/shared/commit/d7ae7e1d91a73965be89a9f96df4dfdbc67575d4))
-- change dependency installation from npm ci to npm install in CI workflow ([6bc1ece](https://github.com/expressots/shared/commit/6bc1ece4da3c9aca717e769a8d2f615058652579))
-- remove compiler load lib ([c8f6085](https://github.com/expressots/shared/commit/c8f6085ffdd2af524522174789cfe51203827bbb))
-- reorder build and test steps in CI workflow; update Jest config to ignore specific paths ([4500863](https://github.com/expressots/shared/commit/45008637af232929c8c20df24c3cf4d6b56a082e))
-- update CI workflow to use npm ci for dependency installation; refine Jest configs ([356c232](https://github.com/expressots/shared/commit/356c232bbfcf6bad7254ee0ab3417fd82f831a9f))
-- update package.json to use exact version numbers for dependencies ([7cdd924](https://github.com/expressots/shared/commit/7cdd924b468af56ccf5bdfaa36b7cad82034e007))
-
-### Code Refactoring
-
-- remove unused env property from ExpressoConfig interface ([97663e8](https://github.com/expressots/shared/commit/97663e8a386ece45111eba0c2f8b66d1eb9c90af))
-
-## 0.0.1 (2023-09-05)
-
-### Bug Fixes
-
-- testing commitlint ([0e78653](https://github.com/expressots/<<repo_name>>/commit/0e786539402f69fdca3fe5b684d850e523db7698))
+## [4.0.0-preview.3](https://github.com/expressots/shared/compare/3.0.0...4.0.0-preview.3) (2026-05-25)
+
+Part of the ExpressoTS **v4.0.0 preview bundle**. See the [v4.0.0 release notes](https://expresso-ts.com/docs/4.0.0/prologue/release) and the [upgrade guide](https://expresso-ts.com/docs/4.0.0/prologue/upgrade_guide) for the full picture.
+
+### Features
+
+* extend `ExpressoConfig` with `scaffoldSchematics` covering all v4 schematics (`controller`, `usecase`, `dto`, `module`, `provider`, `entity`, `middleware`, `interceptor`, `event`, `handler`, `guard`, `config`).
+* add type-safe `Pattern` enum (regular `enum`, not `const enum`, so consumers compiling with `isolatedModules: true` such as Vite/Vitest/esbuild/SWC can import it).
+* expose shared content-negotiation primitives consumed by `@expressots/core` formatters.
+* add `Env.when(condition, value, fallback)` helper for environment-specific config resolution.
+* publish dual ESM + CJS builds with subpath exports for both module systems.
+* declare `engines.node: ">=20.18.0"`.
+
+### Bug Fixes
+
+* tighten the `IWebServer` / `IWebServerBuilder` typings so v4 adapters can declare their server contract without leaking Express types.
+* `configDotenv()` is now safe to call with no arguments — null-guard added on `options.encoding` / `options.debug` (previously threw `TypeError: Cannot read properties of undefined`).
+
+### Build System
+
+* bump dev toolchain to TypeScript 5.5, ESLint 8.57, Jest 29.7, Prettier 3.5.
+
+## [3.0.0](https://github.com/expressots/shared/compare/3.0.0-beta.3...3.0.0) (2024-12-04)
+
+
+### Features
+
+* refactor IWebServer interface, add IWebServerBuilder ([9a23fff](https://github.com/expressots/shared/commit/9a23fff1e7de8d3880ed90317ffde1037ef1947b))
+* update initEnvironment method to return a Promise for better async handling ([6ae9525](https://github.com/expressots/shared/commit/6ae9525b5497dacf81c1861e467bf6e27421ad2e))
+
+## [3.0.0](https://github.com/expressots/shared/compare/3.0.0-beta.3...3.0.0) (2024-12-03)
+
+
+### Features
+
+* refactor IWebServer interface, add IWebServerBuilder ([9a23fff](https://github.com/expressots/shared/commit/9a23fff1e7de8d3880ed90317ffde1037ef1947b))
+
+## [3.0.0-beta.3](https://github.com/expressots/shared/compare/0.3.0...0.4.0) (2024-11-28)
+
+### Features
+
+- add close method to Server interface for graceful shutdown ([7d0cd8f](https://github.com/expressots/shared/commit/7d0cd8f1e05c5fed96e74b01dc715e5c7eb268d0))
+
+## [0.3.0](https://github.com/expressots/shared/compare/0.2.0...0.3.0) (2024-11-24)
+
+### Features
+
+- add entryPoint property to ExpressoConfig interface ([324ac37](https://github.com/expressots/shared/commit/324ac37a7d407c491881998c6ed3288e04a0ae39))
+
+## [0.2.0](https://github.com/expressots/shared/compare/0.1.0...0.2.0) (2024-11-16)
+
+### Features
+
+- add interfaces for console, middleware, and environment; update index exports ([30d7dbb](https://github.com/expressots/shared/commit/30d7dbb0c24af12e4537f626be816f2f5d8a81a0))
+
+### Bug Fixes
+
+- standardize quotes in middleware interface file ([6b3f045](https://github.com/expressots/shared/commit/6b3f0459c3ba0bf58d1de920335c6ef7dd438e32))
+
+### Tests
+
+- enhance coverage for configDotenv function and add edge case handling ([58612bd](https://github.com/expressots/shared/commit/58612bd0040b592133bac687cfb29b9c6ece2a94))
+
+## 0.1.0 (2024-11-10)
+
+### Features
+
+- add compiler and package definitions ([8352e66](https://github.com/expressots/shared/commit/8352e663c1a3429c70bbf7588380fe92f547e0a9))
+- add early ai unit test generation and code coverage ([7eb5f38](https://github.com/expressots/shared/commit/7eb5f380f6b49ce6316a9749daaa7311fda74f04))
+- add env and compiler modules ([f93f6c3](https://github.com/expressots/shared/commit/f93f6c3a719d1a1129112bee4e5e9cf6e42ddd89))
+- add global config interface ([cbe2e12](https://github.com/expressots/shared/commit/cbe2e127db006273e9049220fe3ed20b964d697b))
+- change to beta version ([4e835ca](https://github.com/expressots/shared/commit/4e835ca58933336bc78d66fb42935bf4d02ec641))
+- update readme to include badges ([5995b1a](https://github.com/expressots/shared/commit/5995b1a3eab1481aa4552ca76683c6b16ae0dc60))
+
+### Bug Fixes
+
+- add express config file for testing ([d7ae7e1](https://github.com/expressots/shared/commit/d7ae7e1d91a73965be89a9f96df4dfdbc67575d4))
+- change dependency installation from npm ci to npm install in CI workflow ([6bc1ece](https://github.com/expressots/shared/commit/6bc1ece4da3c9aca717e769a8d2f615058652579))
+- remove compiler load lib ([c8f6085](https://github.com/expressots/shared/commit/c8f6085ffdd2af524522174789cfe51203827bbb))
+- reorder build and test steps in CI workflow; update Jest config to ignore specific paths ([4500863](https://github.com/expressots/shared/commit/45008637af232929c8c20df24c3cf4d6b56a082e))
+- update CI workflow to use npm ci for dependency installation; refine Jest configs ([356c232](https://github.com/expressots/shared/commit/356c232bbfcf6bad7254ee0ab3417fd82f831a9f))
+- update package.json to use exact version numbers for dependencies ([7cdd924](https://github.com/expressots/shared/commit/7cdd924b468af56ccf5bdfaa36b7cad82034e007))
+
+### Code Refactoring
+
+- remove unused env property from ExpressoConfig interface ([97663e8](https://github.com/expressots/shared/commit/97663e8a386ece45111eba0c2f8b66d1eb9c90af))
+
+## 0.0.1 (2023-09-05)
+
+### Bug Fixes
+
+- testing commitlint ([0e78653](https://github.com/expressots/<<repo_name>>/commit/0e786539402f69fdca3fe5b684d850e523db7698))

package/lib/README.md

@@ -1,51 +1,51 @@
-<div align="center">
-  <a href="https://expresso-ts.com">
-    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="ExpressoTS" width="120">
-  </a>
-
-  <h1>@expressots/shared</h1>
-
-  <p>Shared types, interfaces, and utilities used across all ExpressoTS packages.</p>
-
-  <p>
-    <a href="https://www.npmjs.com/package/@expressots/shared"><img src="https://img.shields.io/npm/v/@expressots/shared?style=flat&color=0d0d0d" alt="npm"></a>
-    <a href="https://github.com/expressots/shared/blob/main/LICENSE.md"><img src="https://img.shields.io/github/license/expressots/shared?style=flat&color=0d0d0d" alt="License"></a>
-    <a href="https://discord.com/invite/PyPJfGK"><img src="https://img.shields.io/badge/Discord-join-0d0d0d?logo=discord&logoColor=white" alt="Discord"></a>
-  </p>
-
-  <p>
-    <a href="https://doc.expresso-ts.com">Documentation</a> ·
-    <a href="https://doc.expresso-ts.com/docs/core/first-steps">Getting Started</a> ·
-    <a href="https://discord.com/invite/PyPJfGK">Community</a>
-  </p>
-</div>
-
----
-
-## Install
-
-```bash
-npm i @expressots/shared
-```
-
-## What This Package Does
-
-This is the shared foundation layer for the ExpressoTS ecosystem. It provides common TypeScript interfaces, configuration types, environment utilities, and helper functions that `@expressots/core`, `@expressots/adapter-express`, and other packages depend on. Most applications consume it indirectly through the core package.
-
-## Documentation
-
-For guides, API reference, architecture patterns, and examples visit **[doc.expresso-ts.com](https://doc.expresso-ts.com)**.
-
-## Contributing
-
-See the [Contributing Guide](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md) for how to get involved.
-
-## Support
-
-- [GitHub Sponsors](https://github.com/sponsors/expressots)
-- [Discord](https://discord.com/invite/PyPJfGK)
-- [Report an Issue](https://github.com/expressots/shared/issues)
-
-## License
-
-MIT — see [LICENSE](./LICENSE.md).
+<div align="center">
+  <a href="https://expresso-ts.com">
+    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="ExpressoTS" width="120">
+  </a>
+
+  <h1>@expressots/shared</h1>
+
+  <p>Shared types, interfaces, and utilities used across all ExpressoTS packages.</p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/@expressots/shared"><img src="https://img.shields.io/npm/v/@expressots/shared?style=flat&color=0d0d0d" alt="npm"></a>
+    <a href="https://github.com/expressots/shared/blob/main/LICENSE.md"><img src="https://img.shields.io/github/license/expressots/shared?style=flat&color=0d0d0d" alt="License"></a>
+    <a href="https://discord.com/invite/PyPJfGK"><img src="https://img.shields.io/badge/Discord-join-0d0d0d?logo=discord&logoColor=white" alt="Discord"></a>
+  </p>
+
+  <p>
+    <a href="https://doc.expresso-ts.com">Documentation</a> ·
+    <a href="https://doc.expresso-ts.com/docs/core/first-steps">Getting Started</a> ·
+    <a href="https://discord.com/invite/PyPJfGK">Community</a>
+  </p>
+</div>
+
+---
+
+## Install
+
+```bash
+npm i @expressots/shared
+```
+
+## What This Package Does
+
+This is the shared foundation layer for the ExpressoTS ecosystem. It provides common TypeScript interfaces, configuration types, environment utilities, and helper functions that `@expressots/core`, `@expressots/adapter-express`, and other packages depend on. Most applications consume it indirectly through the core package.
+
+## Documentation
+
+For guides, API reference, architecture patterns, and examples visit **[doc.expresso-ts.com](https://doc.expresso-ts.com)**.
+
+## Contributing
+
+See the [Contributing Guide](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md) for how to get involved.
+
+## Support
+
+- [GitHub Sponsors](https://github.com/sponsors/expressots)
+- [Discord](https://discord.com/invite/PyPJfGK)
+- [Report an Issue](https://github.com/expressots/shared/issues)
+
+## License
+
+MIT — see [LICENSE](./LICENSE.md).

package/lib/cjs/config/index.js

@@ -1,2 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pattern = void 0;
+var project_config_js_1 = require("./project-config.js");
+Object.defineProperty(exports, "Pattern", { enumerable: true, get: function () { return project_config_js_1.Pattern; } });

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

@@ -1,2 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pattern = void 0;
+/**
+ * Enum representing different string patterns.
+ *
+ * - LOWER_CASE: Represents strings in all lowercase letters. E.g. "hello"
+ * - KEBAB_CASE: Represents strings separated by hyphens. E.g. "hello-world"
+ * - PASCAL_CASE: Represents strings where the first letter of each word is capitalized. E.g. "HelloWorld"
+ * - CAMEL_CASE: Represents strings where the first letter of the first word is lowercase and the first letter of subsequent words are capitalized. E.g. "helloWorld"
+ * @public API
+ */
+var Pattern;
+(function (Pattern) {
+    Pattern["LOWER_CASE"] = "lowercase";
+    Pattern["KEBAB_CASE"] = "kebab-case";
+    Pattern["PASCAL_CASE"] = "PascalCase";
+    Pattern["CAMEL_CASE"] = "camelCase";
+})(Pattern || (exports.Pattern = Pattern = {}));

package/lib/cjs/env/environment.js

@@ -186,19 +186,19 @@ function config(options) {
  * @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 opts = options ?? {};
+    const dotenvPath = path_1.default.resolve(process.cwd(), String(opts.path ?? ".env"));
+    const encoding = (opts.encoding ?? "utf8");
+    const debug = !!opts.debug;
+    const paths = Array.isArray(opts.path) ? opts.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);
+            Object.assign(parsed, parsedContent);
+            populate(process.env, parsedContent, opts);
         }
         catch (error) {
             lastError = error;

package/lib/cjs/types/config/project-config.d.ts

@@ -7,7 +7,7 @@
  * - CAMEL_CASE: Represents strings where the first letter of the first word is lowercase and the first letter of subsequent words are capitalized. E.g. "helloWorld"
  * @public API
  */
-export declare const enum Pattern {
+export declare enum Pattern {
     LOWER_CASE = "lowercase",
     KEBAB_CASE = "kebab-case",
     PASCAL_CASE = "PascalCase",

package/lib/esm/config/index.js

@@ -1 +1 @@
-export {};
+export { Pattern } from "./project-config.js";

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

@@ -1 +1,16 @@
-export {};
+/**
+ * Enum representing different string patterns.
+ *
+ * - LOWER_CASE: Represents strings in all lowercase letters. E.g. "hello"
+ * - KEBAB_CASE: Represents strings separated by hyphens. E.g. "hello-world"
+ * - PASCAL_CASE: Represents strings where the first letter of each word is capitalized. E.g. "HelloWorld"
+ * - CAMEL_CASE: Represents strings where the first letter of the first word is lowercase and the first letter of subsequent words are capitalized. E.g. "helloWorld"
+ * @public API
+ */
+export var Pattern;
+(function (Pattern) {
+    Pattern["LOWER_CASE"] = "lowercase";
+    Pattern["KEBAB_CASE"] = "kebab-case";
+    Pattern["PASCAL_CASE"] = "PascalCase";
+    Pattern["CAMEL_CASE"] = "camelCase";
+})(Pattern || (Pattern = {}));

package/lib/esm/env/environment.js

@@ -170,19 +170,19 @@ export function config(options) {
  * @public API
  */
 export function configDotenv(options) {
-    const dotenvPath = path.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 opts = options ?? {};
+    const dotenvPath = path.resolve(process.cwd(), String(opts.path ?? ".env"));
+    const encoding = (opts.encoding ?? "utf8");
+    const debug = !!opts.debug;
+    const paths = Array.isArray(opts.path) ? opts.path.map(_resolveHome) : [_resolveHome(dotenvPath)];
     const parsed = {};
     let lastError;
     for (const envPath of paths) {
         try {
             const fileContent = fs.readFileSync(envPath, { encoding });
             const parsedContent = parse(fileContent);
-            populate(process.env, parsedContent, options);
+            Object.assign(parsed, parsedContent);
+            populate(process.env, parsedContent, opts);
         }
         catch (error) {
             lastError = error;

package/lib/esm/types/config/project-config.d.ts

@@ -7,7 +7,7 @@
  * - CAMEL_CASE: Represents strings where the first letter of the first word is lowercase and the first letter of subsequent words are capitalized. E.g. "helloWorld"
  * @public API
  */
-export declare const enum Pattern {
+export declare enum Pattern {
     LOWER_CASE = "lowercase",
     KEBAB_CASE = "kebab-case",
     PASCAL_CASE = "PascalCase",

package/lib/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/shared",
-  "version": "4.0.0-preview.1",
+  "version": "4.0.0-preview.3",
   "description": "Shared library for ExpressoTS modules 🐎",
   "author": "Richard Zampieri <richard.zampieri@expresso-ts.com>",
   "main": "./lib/cjs/index.js",
@@ -36,6 +36,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=20.18.0"
+  },
   "keywords": [
     "expressots",
     "nodejs",
@@ -55,13 +58,16 @@
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "build:esm": "node scripts/build-esm.js",
     "release": "release-it",
+    "release:prepare": "node scripts/release/prepare-publish.mjs",
+    "release:restore": "node scripts/release/restore-package-json.mjs",
+    "release:publish": "npm run build && npm run release:prepare && npm publish --tag next --access public && npm run release:restore",
     "prepublish": "npm run build && npm pack",
     "test": "jest",
     "test:watch": "jest --watch",
     "coverage": "jest --coverage",
     "format": "prettier --write \"src/**/*.ts\" --cache",
-    "lint": "eslint \"src/**/*.ts\"",
-    "lint:fix": "eslint \"src/**/*.ts\" --fix"
+    "lint": "eslint \"src/**/*.ts\" --cache --cache-location node_modules/.cache/eslint/",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix --cache --cache-location node_modules/.cache/eslint/"
   },
   "dependencies": {
     "chalk": "4.1.2"
@@ -75,10 +81,9 @@
     }
   },
   "devDependencies": {
-    "ts-node": "10.9.2",
     "@commitlint/cli": "19.6.0",
     "@commitlint/config-conventional": "19.6.0",
-    "@release-it/conventional-changelog": "8.0.1",
+    "@release-it/conventional-changelog": "^11.0.0",
     "@types/express": "4.17.21",
     "@types/jest": "29.5.13",
     "@types/node": "20.14.10",
@@ -88,12 +93,20 @@
     "eslint-config-prettier": "10.0.2",
     "husky": "9.1.1",
     "jest": "29.7.0",
+    "lint-staged": "^15.2.10",
     "prettier": "3.5.3",
     "reflect-metadata": "0.2.2",
-    "release-it": "17.6.0",
+    "release-it": "^20.0.1",
     "ts-jest": "29.2.5",
+    "ts-node": "10.9.2",
     "typescript": "5.5.3"
   },
+  "lint-staged": {
+    "src/**/*.ts": [
+      "eslint --cache --cache-location node_modules/.cache/eslint/ --fix",
+      "prettier --write --cache"
+    ]
+  },
   "release-it": {
     "git": {
       "commitMessage": "chore(release): ${version}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/shared",
-  "version": "4.0.0-preview.1",
+  "version": "4.0.0-preview.3",
   "description": "Shared library for ExpressoTS modules 🐎",
   "author": "Richard Zampieri <richard.zampieri@expresso-ts.com>",
   "main": "./lib/cjs/index.js",
@@ -36,6 +36,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=20.18.0"
+  },
   "keywords": [
     "expressots",
     "nodejs",
@@ -55,13 +58,16 @@
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "build:esm": "node scripts/build-esm.js",
     "release": "release-it",
+    "release:prepare": "node scripts/release/prepare-publish.mjs",
+    "release:restore": "node scripts/release/restore-package-json.mjs",
+    "release:publish": "npm run build && npm run release:prepare && npm publish --tag next --access public && npm run release:restore",
     "prepublish": "npm run build && npm pack",
     "test": "jest",
     "test:watch": "jest --watch",
     "coverage": "jest --coverage",
     "format": "prettier --write \"src/**/*.ts\" --cache",
-    "lint": "eslint \"src/**/*.ts\"",
-    "lint:fix": "eslint \"src/**/*.ts\" --fix"
+    "lint": "eslint \"src/**/*.ts\" --cache --cache-location node_modules/.cache/eslint/",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix --cache --cache-location node_modules/.cache/eslint/"
   },
   "dependencies": {
     "chalk": "4.1.2"
@@ -75,10 +81,9 @@
     }
   },
   "devDependencies": {
-    "ts-node": "10.9.2",
     "@commitlint/cli": "19.6.0",
     "@commitlint/config-conventional": "19.6.0",
-    "@release-it/conventional-changelog": "8.0.1",
+    "@release-it/conventional-changelog": "^11.0.0",
     "@types/express": "4.17.21",
     "@types/jest": "29.5.13",
     "@types/node": "20.14.10",
@@ -88,12 +93,20 @@
     "eslint-config-prettier": "10.0.2",
     "husky": "9.1.1",
     "jest": "29.7.0",
+    "lint-staged": "^15.2.10",
     "prettier": "3.5.3",
     "reflect-metadata": "0.2.2",
-    "release-it": "17.6.0",
+    "release-it": "^20.0.1",
     "ts-jest": "29.2.5",
+    "ts-node": "10.9.2",
     "typescript": "5.5.3"
   },
+  "lint-staged": {
+    "src/**/*.ts": [
+      "eslint --cache --cache-location node_modules/.cache/eslint/ --fix",
+      "prettier --write --cache"
+    ]
+  },
   "release-it": {
     "git": {
       "commitMessage": "chore(release): ${version}"