@expressots/adapter-express 3.0.0 → 4.0.0-preview.1

package/README.md

@@ -1,118 +1,61 @@
-<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 href="https://expresso-ts.com">
+    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="ExpressoTS" 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>
+  <h1>@expressots/adapter-express</h1>
+
+  <p>Express HTTP adapter for ExpressoTS — connects the framework core to the Express.js server engine.</p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/@expressots/adapter-express"><img src="https://img.shields.io/npm/v/@expressots/adapter-express?style=flat&color=0d0d0d" alt="npm"></a>
+    <a href="https://github.com/expressots/adapter-express/blob/main/LICENSE.md"><img src="https://img.shields.io/github/license/expressots/adapter-express?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>
-</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>
+  <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>
 
-<!-- ABOUT THE PROJECT -->
+---
 
-# About The Project
+## Install
 
-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 🐎
+```bash
+npm i @expressots/adapter-express
+```
 
-## Getting Started
+## What This Package Does
 
-- 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)
+This adapter bridges ExpressoTS Core and Express.js. It provides the HTTP server implementation, route registration, middleware pipeline, and the `App` class that wires everything together. Install it alongside `@expressots/core` to run ExpressoTS on Express.
 
-## Contributing
+## Quick Look
 
-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.
+```typescript
+import { ExpressAdapter } from "@expressots/adapter-express";
 
-Why Contribute to Documentation?
+// Used as the server adapter when bootstrapping your ExpressoTS application
+const app = await AppFactory.create(App, ExpressAdapter);
+await app.listen(3000, "development");
+```
 
-- **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.
+## Documentation
 
-Ready to contribute?
+For guides, API reference, architecture patterns, and examples visit **[doc.expresso-ts.com](https://doc.expresso-ts.com)**.
 
-- [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)
+## Contributing
 
-## Support the project
+See the [Contributing Guide](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md) for how to get involved.
 
-ExpressoTS is an independent open source project with ongoing development made possible thanks to your support. If you'd like to help, please consider:
+## Support
 
-- 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
+- [GitHub Sponsors](https://github.com/sponsors/expressots)
+- [Discord](https://discord.com/invite/PyPJfGK)
+- [Report an Issue](https://github.com/expressots/adapter-express/issues)
 
 ## 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/adapter-express
-[codecov-shield]: https://img.shields.io/codecov/c/gh/expressots/adapter-express/main?style=for-the-badge&logo=codecov&labelColor=FB9AD1
-[npm-url]: https://www.npmjs.com/package/@expressots/adapter-express
-[npm-shield]: https://img.shields.io/npm/v/@expressots/adapter-express?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/adapter-express?style=for-the-badge
-[contributors-url]: https://github.com/expressots/adapter-express/graphs/contributors
-[forks-shield]: https://img.shields.io/github/forks/expressots/adapter-express?style=for-the-badge
-[forks-url]: https://github.com/expressots/adapter-express/forks
-[stars-shield]: https://img.shields.io/github/stars/expressots/adapter-express?style=for-the-badge
-[stars-url]: https://github.com/expressots/adapter-express/stargazers
-[issues-shield]: https://img.shields.io/github/issues/expressots/adapter-express?style=for-the-badge
-[issues-url]: https://github.com/expressots/expressadapter-expressots/issues
-[license-shield]: https://img.shields.io/github/license/expressots/adapter-express?style=for-the-badge
-[license-url]: https://github.com/expressots/adapter-express/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
+MIT — see [LICENSE](./LICENSE.md).

package/lib/CHANGELOG.md

@@ -1,5 +1,31 @@
-
-
+## [4.0.0](https://github.com/expressots/adapter-express/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
+
+* **AppExpress lifecycle:** `globalConfiguration`, `configureServices`, `postServerInitialization`, `serverShutdown` hooks fully wired with async support; `setGlobalRoutePrefix`, `setBanner({ style, showMetrics })`, `isDevelopment()`, `getPort()` helpers.
+* **systems setup helpers:** `setupInterceptorsForExpress`, `setupEventSystemForExpress`, `setupLazyLoadingForExpress`, `setupAuthorizationForExpress` — one-call wiring for the new core subsystems with consistent return-shape diagnostics (`interceptorsRegistered`, `handlersDiscovered`, `lazyModulesCount`, `routeMappings`, ...).
+* **`micro()` API:** single-file Express apps with auto-response serialisation, optional global route prefix, environment-aware banner, and `setErrorHandler`.
+* **serverless adapters:** `awsLambdaAdapter`, `vercelAdapter`, `cloudflareAdapter` — same code runs locally and on the target platform with binary content-type and base64 handling.
+* **microservices primitives:** `CircuitBreaker`, `ServiceDiscovery` (static + dynamic), `ServiceClient` (timeouts, retries, circuit-breaker integration), `ServiceProxy` via `createProxy` with `pathRewrite` / `changeOrigin` / `onError`.
+* **content negotiation runtime:** `addContentNegotiation` middleware factory with `XmlOptions`, `CsvOptions`, `YamlOptions`, quality-value support, lazy formatter loading.
+* **smart validation runtime:** `Middleware.addValidation({ smartDetection, autoDetection, errorFormat })`.
+* **request logging middleware:** `createRequestLoggingMiddleware(logger, { verbosity, logBody, logHeaders, slowRequestThreshold, requestIdHeader, correlationIdHeader })`.
+* **route, body, query, params, header decorators:** `@Get/@Post/@Put/@Delete/@Patch`, `@body`, `@query`, `@param`, `@headers`, plus the new `@Accept` / `@Consumes` / `@Produces` content-negotiation decorators.
+* **exception filter middleware:** `Middleware.setErrorHandler({ showStackTrace, enableExceptionFilters })`.
+* **studio agent integration:** `@expressots/studio-agent` is an optional peer dependency — adapter-express dynamically imports it only when `NODE_ENV=development` and the package is installed; production deployments pay zero runtime cost.
+
+### Bug Fixes
+
+* `setupAuthorizationForExpress` signature corrected to `(container, config?, middleware?, authProvider?)` so the auth provider is passed as the fourth argument rather than inside the config object.
+
+### Breaking Changes
+
+* All `AppExpress` lifecycle methods are now async; `await` them or rely on the bootstrap pipeline to drive them.
+* `getHttpServer()` now returns an `http.Server` instance (was `AppExpress` in v3).
+* `server.listen(0)` now resolves to a randomly assigned port and the actual port is observable via `getHttpServer().address()`.
+
 ## [3.0.0](https://github.com/expressots/adapter-express/compare/3.0.0-beta.3...3.0.0) (2024-12-04)
 
 
@@ -13,8 +39,8 @@
 
 ### Tests
 
-* update tests for globalConfiguration, isDevelopment, getHttpServer, serverShutdown ([17b7d92](https://github.com/expressots/adapter-express/commit/17b7d92e87f4ad0d14a386e8351c723e1392a5c3))
-
+* update tests for globalConfiguration, isDevelopment, getHttpServer, serverShutdown ([17b7d92](https://github.com/expressots/adapter-express/commit/17b7d92e87f4ad0d14a386e8351c723e1392a5c3))
+
 ## [3.0.0-beta.4.2](https://github.com/expressots/adapter-express/compare/3.0.0-beta.3...3.0.0) (2024-12-03)
 
 ### Code Refactoring
@@ -292,4 +318,4 @@
 
 ### Bug Fixes
 
-- testing commitlint ([0e78653](https://github.com/expressots/<<repo_name>>/commit/0e786539402f69fdca3fe5b684d850e523db7698))
+- testing commitlint ([0e78653](https://github.com/expressots/<<repo_name>>/commit/0e786539402f69fdca3fe5b684d850e523db7698))

package/lib/README.md

@@ -1,118 +1,61 @@
-<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 href="https://expresso-ts.com">
+    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="ExpressoTS" 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>
+  <h1>@expressots/adapter-express</h1>
+
+  <p>Express HTTP adapter for ExpressoTS — connects the framework core to the Express.js server engine.</p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/@expressots/adapter-express"><img src="https://img.shields.io/npm/v/@expressots/adapter-express?style=flat&color=0d0d0d" alt="npm"></a>
+    <a href="https://github.com/expressots/adapter-express/blob/main/LICENSE.md"><img src="https://img.shields.io/github/license/expressots/adapter-express?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>
-</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>
+  <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>
 
-<!-- ABOUT THE PROJECT -->
+---
 
-# About The Project
+## Install
 
-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 🐎
+```bash
+npm i @expressots/adapter-express
+```
 
-## Getting Started
+## What This Package Does
 
-- 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)
+This adapter bridges ExpressoTS Core and Express.js. It provides the HTTP server implementation, route registration, middleware pipeline, and the `App` class that wires everything together. Install it alongside `@expressots/core` to run ExpressoTS on Express.
 
-## Contributing
+## Quick Look
 
-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.
+```typescript
+import { ExpressAdapter } from "@expressots/adapter-express";
 
-Why Contribute to Documentation?
+// Used as the server adapter when bootstrapping your ExpressoTS application
+const app = await AppFactory.create(App, ExpressAdapter);
+await app.listen(3000, "development");
+```
 
-- **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.
+## Documentation
 
-Ready to contribute?
+For guides, API reference, architecture patterns, and examples visit **[doc.expresso-ts.com](https://doc.expresso-ts.com)**.
 
-- [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)
+## Contributing
 
-## Support the project
+See the [Contributing Guide](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md) for how to get involved.
 
-ExpressoTS is an independent open source project with ongoing development made possible thanks to your support. If you'd like to help, please consider:
+## Support
 
-- 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
+- [GitHub Sponsors](https://github.com/sponsors/expressots)
+- [Discord](https://discord.com/invite/PyPJfGK)
+- [Report an Issue](https://github.com/expressots/adapter-express/issues)
 
 ## 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/adapter-express
-[codecov-shield]: https://img.shields.io/codecov/c/gh/expressots/adapter-express/main?style=for-the-badge&logo=codecov&labelColor=FB9AD1
-[npm-url]: https://www.npmjs.com/package/@expressots/adapter-express
-[npm-shield]: https://img.shields.io/npm/v/@expressots/adapter-express?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/adapter-express?style=for-the-badge
-[contributors-url]: https://github.com/expressots/adapter-express/graphs/contributors
-[forks-shield]: https://img.shields.io/github/forks/expressots/adapter-express?style=for-the-badge
-[forks-url]: https://github.com/expressots/adapter-express/forks
-[stars-shield]: https://img.shields.io/github/stars/expressots/adapter-express?style=for-the-badge
-[stars-url]: https://github.com/expressots/adapter-express/stargazers
-[issues-shield]: https://img.shields.io/github/issues/expressots/adapter-express?style=for-the-badge
-[issues-url]: https://github.com/expressots/expressadapter-expressots/issues
-[license-shield]: https://img.shields.io/github/license/expressots/adapter-express?style=for-the-badge
-[license-url]: https://github.com/expressots/adapter-express/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
+MIT — see [LICENSE](./LICENSE.md).

package/lib/cjs/adapter-express/application-express.base.js

@@ -15,7 +15,9 @@ exports.ApplicationBase = void 0;
  * class Application extends ApplicationBase {
  *   protected configureServices() { //... }
  *   protected postServerInitialization() { //... }
- *   protected serverShutdown() { //... }
+ *   protected serverShutdown(signal) {
+ *     console.log(`Shutting down due to ${signal}`);
+ *   }
  * }
  *
  * @export