@expressots/adapter-express 3.0.0 → 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,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>
-
-  <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/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
+<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/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>
+
+  <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/adapter-express
+```
+
+## What This Package Does
+
+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.
+
+## Quick Look
+
+```typescript
+import { ExpressAdapter } from "@expressots/adapter-express";
+
+// Used as the server adapter when bootstrapping your ExpressoTS application
+const app = await AppFactory.create(App, ExpressAdapter);
+await app.listen(3000, "development");
+```
+
+## 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/adapter-express/issues)
+
+## License
+
+MIT — see [LICENSE](./LICENSE.md).

package/lib/CHANGELOG.md

@@ -1,5 +1,36 @@
-
-
+## [4.0.0-preview.3](https://github.com/expressots/adapter-express/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
+
+* **Express 5:** upgraded to Express `^5.1.0` and `@types/express@^5`. Route registration uses `app.use(handler)` for the global HttpContext middleware (was `app.all("*", ...)`) so we are forward-compatible with `path-to-regexp` v8.
+* **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 + decorators:** `@Accept`, `@Consumes`, `@Produces`, `StreamResponse` decorators; `addContentNegotiation` middleware factory with `XmlOptions`, `CsvOptions`, `YamlOptions`, quality-value support, lazy formatter loading; built-in JSON / XML / CSV / YAML / Text formatters.
+* **route constraints + API versioning:** `@Version` decorator, `Patterns` route-constraint catalogue (`NUMERIC_ID`, `UUID`, `SLUG`, `ALPHA`, `ALPHANUMERIC`, `ANY_PATH`), URL / header / query versioning helpers.
+* **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`.
+* **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. Detection now uses `createRequire(import.meta.url)` so it works in both CJS and ESM consumers.
+
+### Bug Fixes
+
+* **import-time stdio:** importing `@expressots/adapter-express` no longer mutates `process.stdout.write`, `process.stderr.write`, or `console.*`. Banner-first log buffering is now opt-in: `bootstrap()` activates it before app construction, the `AppExpress` constructor is a safety net, and `micro()` keeps disabling it on entry. Test harnesses, type-only consumers, and IDE tooling that import the module without booting an app see normal stdio. (Regression test: `application-express.early.spec/no-import-side-effects.early.spec.ts`.)
+* **runtime dep classification:** `@expressots/core` and `@expressots/shared` are now declared in `dependencies` (previously misclassified as `devDependencies`). Fresh `npm install @expressots/adapter-express` no longer throws `Cannot find module '@expressots/core'`.
+* `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
+
+* **Express 5** is now required. Most apps need no changes; review the [Express 5 migration guide](https://expressjs.com/en/guide/migrating-5.html) if you used `req.param()`, `app.del()`, or path patterns like `:foo?` / `:foo*`.
+* 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 +44,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 +323,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>
-
-  <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/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
+<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/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>
+
+  <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/adapter-express
+```
+
+## What This Package Does
+
+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.
+
+## Quick Look
+
+```typescript
+import { ExpressAdapter } from "@expressots/adapter-express";
+
+// Used as the server adapter when bootstrapping your ExpressoTS application
+const app = await AppFactory.create(App, ExpressAdapter);
+await app.listen(3000, "development");
+```
+
+## 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/adapter-express/issues)
+
+## License
+
+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