ExpressoTS Framework

Everything you need to know to build applications with ExpressoTS
Explore the docs »

Let's discuss · Report Bug · Request Feature

About The Project

ExpressoTS is a Typescript + Node.js lightweight framework for quick building scalable, easy to read and maintain, server-side applications 🐎

Getting Started

• Here is our Site
• You can find our Documentation here
• Checkout our First Steps documentation
• Our CLI Documentation

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
• How to Contribute
• Coding Guidelines

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
• Follow the organization on GitHub and Star ⭐ the project
• Subscribe to the Twitch channel: Richard Zampieri
• Join our Discord
• Contribute submitting issues and pull requests
• Share the project with your friends and colleagues

License

Distributed under the MIT License. See LICENSE.md for more information.

(back to top)

3.0.0 (2024-12-04)

Tests

• update MockWebServer to use Server and IWebServerPublic types (3c736c3)
• update unit tests for AppFactory.create() to include close() (24446d8)
• update unit tests for AppFactory.create() to include close() (24446d8)

3.0.0-beta.3 (2024-11-28)

Features

• implement in-memory data provider and repository interfaces (09561fa)

Tests

• add unit tests for insert, update, delete, and find methods in InMemoryDataTable (a96f4a6)

3.0.0-beta.1 (2024-11-17)

Features

• add di impl and remove inversify deps (9ff6302)
• add env configuration load from expressots.config (fc61d44)
• remove binding decor deps & offer as core (a8aeecc)

Bug Fixes

• adjust env validator to load files dynamically (09d0cc3)
• adjust env validator to load files dynamically (d1c5a2e)
• update license reference (acb5f7e)
• view binding tables info (f93abb6)

Code Refactoring

• change express types deps (c10336b)
• clean up code by removing unnecessary whitespace and improving formatting (2090efd)
• enhance doc by adding @public API annotations and cleaning up comments (f98a52c)
• make basecontroller injectable (d2ef5a7)
• move config to shared lib (d14bb98)
• remove provide decorators for items not in container (fb0ecd3)
• remove unnecessary whitespace in inject.ts documentation example (538039b)
• remove unnecessary whitespace in URL Encoded Parser documentation (d81610d)
• remove unused Compiler and ExpressoConfig imports from AppFactory (913d919)
• remove vitest configuration and update types in tsconfig (047f7a2)
• reorg files application, console, color and logger (2bb619e)
• simplify application container and factory, enhance provider interface (2f32b1d)
• update @expressots/shared dependency to version 0.2.0 (61b5c27)
• update app factory and container tests, improve mocks and error handling (9852507)
• update container and interface (4be3fd5)
• update ContainerOptions interface and improve AppContainer logging (b31de0d)
• update decorators to export and enhance doc with @public API annotations (a935933)
• update express imports and usage in middleware-service (f8046bd)
• update Jest configuration and improve mock handling for express (47ae688)
• update package dependencies and migrate interfaces to @expressots/shared (4cf1582)

Tests

• add unit tests for middleware, provider and repository methods (2de4d6e)
• adding early ai agent tests p1 (7e74f01)
• adding early ai agent tests p2 (0ef25d2)
• improve unit tests formatting and edge case handling (8439e5d)

2.16.2 (2024-09-02)

Code Refactoring

• add stackTrace app provider and add @expressots/cli to devDependencies (212c681)
• add test and coverage for base controller and error middleware (5ddb7b2)
• adjust error middleware code property (ef4e9b8)
• remove render from base controller, add usecase as type T (9002129)
• update templates main.ts removing reflect and serverenv type (e5a789c)
• update templates nonop & add .env gitignore (304cf88)

2.16.1 (2024-08-21)

Bug Fixes

• remove reflect-metadata from main, add server env types (43a5a33)

2.16.0 (2024-08-08)

Features

• add stack trace option on defaultErrorHandler middleware (c9005ed)
• add urlEncodedParser default middleware (ec44767)
• bump release-it from 17.5.0 to 17.6.0 (bbdc3c8)

Bug Fixes

• remove express dependency and middlewares.spec (b538cce)

Code Refactoring

• adjust command dev, build, prod (c819625)
• remove opinionated template example (bca45ac)

Tests

• ignore middleware service, utils (6c3e6f7)
• ignore spec on coverage & better comments in app-factory (698053d)

2.15.0 (2024-07-17)

Features

• bump @types/node from 20.14.9 to 20.14.10 (2061291)
• bump @typescript-eslint/eslint-plugin from 7.15.0 to 7.16.0 (4c33e38)
• bump @typescript-eslint/parser from 7.15.0 to 7.16.0 (db38183)
• bump prettier from 3.3.2 to 3.3.3 (1d3ee41)
• bump release-it from 17.4.1 to 17.5.0 (a4aa310)
• bump vitest and @vitest/coverage-v8 (f186dc3)

Bug Fixes

• remove git modules cmds (be88854)
• update index (ebb6e8e)

Code Refactoring

• remove render from core (70ba135)

2.14.1 (2024-07-04)

Code Refactoring

• add tests for in memory db (6914f15)
• in memory db internal provider (168547b)
• remove inversify binding dependency (593620c)

Tests

• increase code coverage (ae71339)

2.14.0 (2024-07-04)

Features

• bump @types/node from 20.12.7 to 20.14.9 (ca36368)
• bump @typescript-eslint/eslint-plugin from 7.6.0 to 7.15.0 (3255f6a)
• bump @typescript-eslint/parser from 7.6.0 to 7.15.0 (3ac1c8c)
• bump prettier from 3.3.1 to 3.3.2 (56c3299)
• bump release-it and @release-it/conventional-changelog (c68612f)
• bump typescript from 5.2.2 to 5.5.3 (ee338de)
• bump vite from 5.2.8 to 5.3.3 (0299602)

Bug Fixes

• engine bump & husky init script (57d0549)

Code Refactoring

• @provide is available through core (6c315e4)
• add test to validate the decorator @provide (e4981c4)

2.13.0 (2024-06-11)

Features

• bump prettier from 3.3.0 to 3.3.1 (90ff872)

Code Refactoring

• update adapter-express to latest (3905e9a)

2.12.0 (2024-06-07)

Features

• add code coverage report (b4d4982)
• add codecov plugin bundler (9cef3c2)
• add codecov plugin bundler (1edd11f)
• bump @expressots/adapter-express from 1.2.1 to 1.2.2 (6492983)
• bump @types/node from 20.12.3 to 20.12.5 (74924bf)
• bump @types/node from 20.12.5 to 20.12.7 (a040456)
• bump @typescript-eslint/eslint-plugin from 7.5.0 to 7.6.0 (05e60bc)
• bump @typescript-eslint/parser from 6.6.0 to 7.5.0 (d2ade4b)
• bump @typescript-eslint/parser from 7.5.0 to 7.6.0 (6e06f7c)
• bump prettier from 3.2.5 to 3.3.0 (8f68fa4)
• update adapter express ver (afcfd42)

Bug Fixes

• update codecov actions (e1637e1)
• update codecov actions (4c2330f)
• upgrade dotenv from 16.0.3 to 16.4.5 (29fb00f)
• upgrade dotenv from 16.0.3 to 16.4.5 (de7f53e)
• upgrade dotenv from 16.0.3 to 16.4.5 (e325d6c)
• upgrade inversify from 6.0.1 to 6.0.2 (0975b5c)
• upgrade reflect-metadata from 0.2.1 to 0.2.2 (ff93c46)

Documentation

• add codecov badge (3964037)
• add npm and build badge (79a0b87)

Code Refactoring

• container module scope binding for unit test and remove vitest config from tsconfig base (a93bd31)
• remove vitest/eslint conflict, review pr template (5e63d64)
• update adapter version to 1.4 (ab53902)
• update dependencies and jest config (807c03e)

Tests

• add unit test application, common, console (78c1989)
• add unit test container, controller. decorator (20591ea)
• add unit test env validator (4eb63d5)
• add unit test error module (4442d8e)
• add unit test middleware, provider, db, dto (65e88ce)

2.11.0 (2024-04-04)

Features

• bump @types/node from 20.12.2 to 20.12.3 (430ada9)

Bug Fixes

• update adpater version to latest (89c671d)
• update console tests (c639466)
• upgrade tsconfig-paths from 4.1.2 to 4.2.0 (fc373a6)
• upgrade tsconfig-paths from 4.1.2 to 4.2.0 (e8f0d68)

Code Refactoring

• appfactory class (3fde40a)
• rename items for standardization and improve doc (d01f4d1)

2.10.0 (2024-03-31)

Features

• bump @commitlint/cli from 18.0.0 to 19.2.1 (cbdf106)
• bump @commitlint/config-conventional from 18.6.3 to 19.1.0 (3e283c5)
• bump @release-it/conventional-changelog from 7.0.1 to 7.0.2 (5916d10)
• bump @types/express from 4.17.17 to 4.17.21 (9d3ce90)
• bump @types/node from 20.4.9 to 20.12.2 (b62d698)
• bump @typescript-eslint/eslint-plugin from 6.6.0 to 6.21.0 (f03e326)
• bump eslint from 8.48.0 to 8.57.0 (c58c68b)
• bump eslint-config-prettier from 9.0.0 to 9.1.0 (6003fd9)
• bump inversify from 6.0.1 to 6.0.2 (dffffdd)
• bump reflect-metadata from 0.2.1 to 0.2.2 (eb606cd)
• bump release-it from 16.1.5 to 16.3.0 (ac94b32)
• bump typescript from 4.9.5 to 5.4.3 (2f7d8a3)
• bump vite from 4.5.0 to 5.2.7 (c53a852)
• bump vitest and @vitest/coverage-v8 (dd561f8)

Bug Fixes

• update inversify, reflect-metadata and express version, remove vulnerabilites (62a7e92)
• update typescript to 5.2.2 rm conflict on eslin-tstree (26e160d)

Code Refactoring

• separate template tests from core (57e6a98)
• update app provider opinionated template (9e45fcd)
• update express types (6a546d2)
• update non opinionated template (77dd2cc)
• update non opinionated template (f9d3b16)

2.9.1 (2024-03-29)

Bug Fixes

• add non opinionated scaffold schematics name change (35cf0cb)

Code Refactoring

• add expressots project commands (523cf19)
• adjust expressots build, dev, prod (7be37a7)

2.9.0 (2024-03-18)

Features

• add plugin pattern on provider manager (f56d5b3)

Bug Fixes

• change expressots version to latest (d42f0c9)
• lock lib ver, add tsconfig to package (298201c)
• lock versions, update to es2021 (1ca53ca)
• remove the appcontainer return dictionary method (3dddb86)
• rename logger-service to logger.provider (3344717)

Code Refactoring

• adjust core op template and add full example (ca5a843)
• non opinionated templated structure change (8caf0d1)
• update eslint config inferrable types (845101f)

Continuous Integrations

• add prepublish script (7b1478e)

2.8.0 (2024-3-5)

Features

• add middleware handler, config and expresso (df60183)
• add provide annotation to abstract class ExpressMiddleware (49e762e)
• Added it into options wiring (58e58c1)
• Added multer middleware for expressots (522db5d)
• bump @commitlint/cli from 17.8.1 to 18.0.0 (4ddcbd4)
• bump @commitlint/config-conventional from 17.8.1 to 18.0.0 (91e1237)
• bump husky from 8.0.3 to 9.0.11 (#170) (342983f)
• bump prettier from 3.0.3 to 3.1.1 (#145) (2e7b812)
• bump prettier from 3.1.1 to 3.2.5 (#166) (49c148c)
• bump reflect-metadata from 0.1.14 to 0.2.1 (#148) (f444982)
• bump vite from 4.4.11 to 4.5.0 (344161c)
• comments addressed (8c3f55a)
• correct expresso middleware path (0879c10)
• Include multer as resolver (056d4d9)
• remove getmiddleware pipeline from interface (0577527)
• Remove multer dependency / Added dynamic multer usage behavior (6a4530b)
• Remove multer dependency with interface defined (5a0acd2)
• Remove multer dependency with interface defined (8133621)
• update reflect metadata on templates (#152) (75a3312)

Bug Fixes

• interface types and middleware return multer (b5223fd)
• remove codesee build (#177) (812e06d)

2.7.0 (2023-10-17)

Features

• add db in memory as provider (b656f22)
• modify IMemoryDB interface name (fd1d440)

Bug Fixes

• remove db in memory from template opinionated (0516c8c)

Tests

• improve collocation and fix console tests (52bdf98)

2.6.0 (2023-10-09)

Features

• Added express-session middleware for expressots (9d0c79f)
• bump vite from 4.4.10 to 4.4.11 (45c8a80)

Bug Fixes

• Auto setup husky with project setup and installation (dcdc279)
• remove prepare husky install from lib (ba9b536)
• typo (079aad6)

2.5.0 (2023-10-04)

Features

• bump vite from 4.4.9 to 4.4.10 (5be4adc)
• bump vitest from 0.34.5 to 0.34.6 (11ca77f)
• core: add helmet middleware (7648afb), closes #107

Bug Fixes

• adjust interface, remove duplicated helmet registry (376c065)
• remove duplicate optionslhelmet interface (93bfdea)

2.4.0 (2023-10-01)

Features

• add interface for express-rate-limit (86cf5d2)
• implement express-rate-limit in service (e31a5f4)

Bug Fixes

• add App container all tests (d6c8212)
• add cjs as default build (d16cfa5)
• add code coverage configuration (3676e32)
• adjust reporter to text, html, json (04acb04)
• remove adapter peer dependecy (bad171b)
• resolves all current issues (877c121)

Documentation

• add jsdoc to interfaces (228d190)

Code Refactoring

• add types to default params (b366e14)
• eliminate duplicate return statements (b57fa85)
• revert changes due to future features (89fce01)

2.3.0 (2023-09-25)

Features

• add morgan middleware (ffe5f36)
• bump vitest from 0.34.4 to 0.34.5 (e1a1da5)

Bug Fixes

• add IMorgan interface to serve it types (adb29e5)

2.2.0 (2023-09-21)

Features

• add middleware based routing (3d7720e)
• add serve-favicon middleware (024bdc4)
• add serve-favicon middleware (0733697)

Bug Fixes

• add chore message to pre-commit hook (45ae428)
• add middleware validation based on path (7035153)
• re-write cp, mv and rm improving performance (68d68ad)
• update contribute_howto doc (4bf6e12)
• update contribute_howto doc (fbbe47d)
• update templates for v2 scaffold (74811f3)

Build System

• scripts: add cross platform build scripts (e6cecbc)
• scripts: add cross platform build scripts (8b5c133)

2.1.0 (2023-09-16)

Features

• add cookie-parser middleware (2fe9377)
• add cookie-parser middleware (a53a0c2)
• add cookie-session middleware (323c2d3)
• add cookie-session middleware (60ac1fa)

Bug Fixes

• create folder for interface and print pck name instead of curated name (2a47508)

2.0.0 (2023-09-14)

Features

• add middleware resolver (23b8d9f)
• add app factory
• add services layer
• add middleware interfaces for cors, compression, bodyparser and generic middleware
• add configurable error handler
• separate expressjs from core library in its own library called adapter-express
• created provider mechanism to share resources between multiple adapters
• eliminate chalk, inversify utils dependencies
• create a logger system using stdout

Code Refactoring

• refactor error handling
• remove winston lib for loggin (5868bc9)
• removing unnecessary dependencies (fdd43e0)

1.9.1 (2023-09-14)

Bug Fixes

• add peer dependency @expressots/adapter-express (874db40)
• change esm config to modeule interop (32f04b5)
• change esm config to modeule interop (978b168)
• opinionated template app provider services (bcb55ca)
• using adapter-express dependency (84b0348)

Code Refactoring

• create express adapter platform (784beaa)
• expose app base class for adapter (36d8dec)

1.9.0 (2023-09-12)

Features

• add pck resolver & remove chalk dependency (6bbd415)
• bump vitest from 0.34.3 to 0.34.4 (#92) (89dc682)

Bug Fixes

• disable console.spec to be refactored (22a54bd)
• dto validator json structure per property (a8fbe40)
• export console for testing (d3f2c07)
• opinionated template logger.error function (073f4e1)
• replace dto interface for class opinionated template (3e99d7c)
• use new report utility in usecases (#91) (d1477b2)

Code Refactoring

• update type from any to number (#90) (5e34a44)

1.8.1 (2023-09-10)

Bug Fixes

• add generic in memory db and virtual table analysis (#86) (29541f9)

Continuous Integrations

• config test workflow and setup vitest (#88) (67316ce)

1.8.0 (2023-09-05)

Features

• add benchmark folder (#83) (30cb1f9)
• bump prettier from 3.0.1 to 3.0.2 (#74) (a66f80d)
• bump prettier from 3.0.2 to 3.0.3 (#80) (59af991)

Bug Fixes

• increase the event range for graceful shutdown (#76) (8e88c7e)
• remove verb should from unit tests labels (#78) (f37d028)
• update readme (c1f0bcd)

1.7.0 (2023-08-14)

Features

• bump @release-it/conventional-changelog from 5.1.1 to 6.0.0 (#61) (634304b)
• bump @types/node from 18.17.4 to 20.4.9 (#72) (31a887d)

Bug Fixes

• add options parameter to AppContainer (#73) (804d5cd)

1.6.0 (2023-08-07)

Features

• add community ideas form (#43) (e23c936)
• add dependabot for fetch new version of dependencies (#60) (9ea1033)
• add prisma provider configuration types in ExpressoConfig (#71) (4a189a2)
• bump prettier from 3.0.0 to 3.0.1 (#68) (b555e19)
• prettier: add a prettier config and run it in the core package (#58) (2ac367b)

Bug Fixes

• add workflow for auto project and label (#44) (1306d18)

1.5.1 (2023-07-16)

Bug Fixes

• add 404 on opinionated template user usecases (#41) (e2920cc)

1.5.0 (2023-07-12)

Features

• add render engine for handlebars (1257fe0)

1.5.0 (2023-07-11)

Features

• add render engine mechanic and handlebars sup (#37) (c9f1c61)

Bug Fixes

• remove npm auto publish from ci (#35) (c7145aa)

1.4.2 (2023-06-19)

Bug Fixes

• error handling (#34) (0c8bdc8)
• remove exclude pattern (#33) (9f5461b)
• update cicd (#32) (c6e4820)
• update usecases to the new error handling (1471e25)

1.4.1 (2023-06-14)

Bug Fixes

• add user crud, remove ping, app.container (befb447)
• correct bootstrap function name (1b99dcc)
• report known error in middleware (#31) (3790e24)
• update .env.example (90c0375)
• update changelog (4e117b9)
• update core and template readme (b2cc461)
• update non-op template app.container (11a3938)
• update response type on controllers (8ca9f5e)
• update singleton decorator in dbInmemory (61bd590)

1.4.0 (2023-05-14)

• add DI (dependency injection) singleton, transient, scope to container, providers, entities, etc

Bug Fixes

• update sponsor link on package
• add example with controller only (11b4ce3)
• opinionated template ientity id (dd50ca0)

1.3.0 (2023-04-21)

Features

• add user repository as singleton provider in opinionated template (#24) (3b5bded)

Bug Fixes

• add gitignore on opinionated template (315d355)
• findall use case query db in memory (ff8feea)
• the number of constructor arguments (ccf2a48)
• update core pkg templates to always download latest (ca443eb)

1.2.1 (2023-04-18)

Features

• add bug report template (8a160c4)
• add feature request template (9d264c6)

Bug Fixes

• add expresso config (086ba59)
• add PR template (1ce4b65)
• config-path for build (72d8086)
• expose express.json() config (717f677)
• template import errors from dtos (#25) (471e311)
• update doc contributor (75cc0cc)
• update expressots version (e170a1f)
• update jest config (6b33fd6)
• update non-opinionated config (1b10e0e)
• update opinionated template (b7bde50)
• update opinionated template (cae55a0)
• update templates (e58af09)
• update test coverage path (0804c5c)

1.2.0 (2023-04-08)

Features

• add doc & config types for cli (a72db25)

Bug Fixes

• template folder path issue (babdce9)

1.1.1 (2023-04-04)

Bug Fixes

• template folder path issue (babdce9)

1.1.0 (2023-03-31)

1.2.0 (2023-03-31)

1.1.0 (2023-03-31)

1.1.0 (2023-03-31)

1.2.0 (2023-03-31)

• feat: add cjs/esm (92f858f)

1.1.0 (2023-03-31)

1.2.0 (2023-03-31)

1.1.0 (2023-02-19)

Features

• add eslint prettier config (906cdcc)
• add opinionated template (d1eb222)
• add readme (557e1ff)
• update 01_base template (d289c57)

Bug Fixes

• add ping controller (ca7b005)
• fix index.js main on package (26596b7)
• fix jest compilation error (9c5be2e)
• fix release tag pipeline (#12) (d2a5491)
• logo update on doc (b2fe55b)
• logo update on doc, build update (b36889d)
• non opinionated folder and prettier (61d1e1b)
• prettier eslint jest setup (0f29452)
• remove test-app (767c7a5)
• set pipeline only pr merge (2936442)
• update main remove index.js (8b40b11)
• update readme (a2ef784)

0.0.7 (2023-02-18)

Bug Fixes

• fix release step (6e4d7b9)
• fix release tag pipeline (#12) (d2a5491)
• set pipeline only pr merge (2936442)

0.0.6 (2023-02-17)

Bug Fixes

• fix pipeline release (69e3fc4)
• fix release tag pipeline (#12) (d2a5491)
• set pipeline only pr merge (2936442)

0.0.5 (2023-02-17)

Bug Fixes

• fix pipeline on push (da20e93)
• fix release tag pipeline (#12) (d2a5491)
• set pipeline only pr merge (2936442)

0.0.4 (2023-02-17)

Bug Fixes

• fix release tag pipeline (#12) (d2a5491)
• set pipeline only pr merge (2936442)
• update pipeline (27dd961)

0.0.3 (2023-02-17)

Bug Fixes

• fix release tag pipeline (ed03d24)
• set pipeline only pr merge (2936442)

0.0.2 (2023-02-17)

Bug Fixes

• fix pipeline for tag name (b9ec52d)

0.0.1 (2023-02-17)

Bug Fixes

• fix pipeline for tag name (b9ec52d)