feat!: support only ECMAScript Modules

.eslintignore

@@ -6,4 +6,3 @@ dist
 coverage
 # don't lint scripts/configs
 *.js
-*.cjs

.gitattributes

@@ -1,7 +1,6 @@
 *                 text=auto
 
 # Source code
-*.cjs             text eol=lf linguist-language=JavaScript
 *.js              text eol=lf linguist-language=JavaScript
 *.json            text eol=lf linguist-language=JSON-With-Comments
 *.ts              text eol=lf linguist-language=TypeScript

.github/workflows/nodejs.yml

@@ -32,12 +32,10 @@ jobs:
           cache: 'yarn'
       - name: Install dependencies
         run: yarn install --frozen-lock-file
-      - name: Build projects (with ESM)
+      - name: Build projects
         run: yarn build
-      - name: Run library tests (with ESM)
+      - name: Run tests
         run: yarn test
-        env:
-          CI: true
       - name: Upload unit-tests coverage to Codecov
         uses: codecov/codecov-action@v2.1.0
         with:

.gitignore

@@ -7,3 +7,4 @@ dist
 node_modules
 *.log
 *.sarif
+*.tsbuildinfo

CHANGELOG.md

@@ -9,7 +9,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- BREAKING: minimal supported Node.js version is v12.13.1
 - BREAKING: moved dependency injection functionality into separate package
+- BREAKING: removed CommonJS build
+- BREAKING: minimal TypeScript version supported is 4.0
 
 ## 3.10.0
 

docs/Testing.md

@@ -62,13 +62,7 @@ module.exports = {
   // Note resolver required only when using imports with extensions
   resolver: 'jest-ts-webcompat-resolver',
   // In test environment we setup reflect-metadata
-  testEnvironment: './jest.environment.cjs',
-  // Jest does not support ESM modules well, so you will need to define mappings to CJS modules
-  moduleNameMapper: {
-    '^fastify-decorators/testing$': 'fastify-decorators/testing/index.cjs',
-    '^fastify-decorators/plugins$': 'fastify-decorators/plugins/index.cjs',
-    '^fastify-decorators$': 'fastify-decorators/index.cjs',
-  },
+  testEnvironment: './jest.environment.js',
 };
 ```
 
@@ -330,4 +324,3 @@ describe('Application: authorization', () => {
 ```
 
 [`reflect-metadata`]: https://npmjs.com/package/reflect-metadata
-[`jest.environment.cjs`]: ../jest.environment.cjs

examples/aws-lambda/jest.config.js

@@ -1,6 +1,6 @@
-const baseConfig = require('../../jest.examples.config');
+import baseConfig from '../../jest.examples.config.js';
 
-module.exports = {
+export default {
   ...baseConfig,
   coverageDirectory: './coverage/integration/aws-lambda',
   testRegex: 'examples/aws-lambda/test/.*.test.ts$',

examples/aws-lambda/package.json

@@ -4,10 +4,11 @@
   "description": "Example how to use fastify-decorators to write controllers",
   "version": "1.0.0",
   "main": "dist/index.js",
+  "type": "module",
   "license": "MIT",
   "scripts": {
     "build": "ncc build src/index.ts -o dist",
-    "test": "jest"
+    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest"
   },
   "dependencies": {
     "aws-lambda-fastify": "^1.7.1",
@@ -17,12 +18,12 @@
   },
   "devDependencies": {
     "@types/jest": "^27.0.2",
-    "@types/node": "~12.20.28",
+    "@types/node": "~12.20.33",
     "@vercel/ncc": "^0.31.1",
     "jest": "^27.2.5",
     "jest-ts-webcompat-resolver": "^1.0.0",
-    "ts-jest": "^27.0.5",
+    "ts-jest": "^27.0.6",
     "tslib": "^2.3.1",
-    "typescript": "^4.4.3"
+    "typescript": "^4.4.4"
   }
 }

examples/aws-lambda/tsconfig.base.json

@@ -4,9 +4,8 @@
 
     /* Basic Options */
     "target": "ES2019",
-    "module": "CommonJS",
+    "module": "ESNext",
     "outDir": "./dist",
-    "importHelpers": true,
 
     /* Strict Type-Checking Options */
     "strict": true,

examples/controllers/jest.config.js

@@ -1,6 +1,6 @@
-const baseConfig = require('../../jest.examples.config');
+import baseConfig from '../../jest.examples.config.js';
 
-module.exports = {
+export default {
   ...baseConfig,
   coverageDirectory: './coverage/integration/controllers',
   testRegex: 'examples/controllers/test/.*.test.ts$',

examples/controllers/package.json

@@ -4,11 +4,12 @@
   "description": "Example how to use fastify-decorators to write controllers",
   "version": "1.0.0",
   "main": "dist/index.js",
+  "type": "module",
   "license": "MIT",
   "scripts": {
-    "start": "node dist/index.js",
+    "start": "node dist/start.js",
     "build": "tsc -p tsconfig.app.json",
-    "test": "jest"
+    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest"
   },
   "dependencies": {
     "fastify": "^3.22.0",
@@ -17,10 +18,10 @@
   },
   "devDependencies": {
     "@types/jest": "^27.0.2",
-    "@types/node": "~12.20.28",
+    "@types/node": "~12.20.33",
     "jest": "^27.2.5",
     "jest-ts-webcompat-resolver": "^1.0.0",
-    "ts-jest": "^27.0.5",
-    "typescript": "^4.4.3"
+    "ts-jest": "^27.0.6",
+    "typescript": "^4.4.4"
   }
 }

examples/controllers/src/index.ts

@@ -1,22 +1,10 @@
 import { fastify } from 'fastify';
 import { bootstrap } from 'fastify-decorators';
+import { dirname } from 'path';
+import { fileURLToPath } from 'url';
 
 export const app = fastify();
 
-const address = '127.0.0.1';
-const port = 3001;
-
 app.register(bootstrap, {
-  directory: __dirname,
+  directory: dirname(fileURLToPath(import.meta.url)),
 });
-
-if (module.parent == null) {
-  app.listen(port, address, (error, address) => {
-    if (error != null) {
-      console.error(error);
-      process.exit(-1);
-    }
-    console.log(`Application start and listening at ${address}`);
-    console.log(`Available routes: \n${app.printRoutes()}`);
-  });
-}

examples/esm/src/index.ts → examples/controllers/src/start.ts

@@ -1,9 +1,9 @@
-import { app } from './app.js';
+import { app } from './index.js';
 
-const address = '127.0.0.1';
-const port = 3001;
+const hostname = '127.0.0.1';
+const port = 3003;
 
-app.listen(port, address, (error, address) => {
+app.listen(port, hostname, (error, address) => {
   if (error != null) {
     console.error(error);
     process.exit(-1);

examples/controllers/tsconfig.app.json

@@ -1,9 +1,10 @@
 {
   "extends": "./tsconfig.base.json",
-  "files": ["src/index.ts"],
+  "files": ["src/index.ts", "src/start.ts"],
   "include": ["src/**/*.ts"],
   "compilerOptions": {
-    "composite": true
+    "composite": true,
+    "rootDir": "src"
   },
   "references": [
     {

examples/controllers/tsconfig.base.json

@@ -4,9 +4,8 @@
 
     /* Basic Options */
     "target": "ES2019",
-    "module": "CommonJS",
+    "module": "ESNext",
     "outDir": "./dist",
-    "importHelpers": true,
 
     /* Strict Type-Checking Options */
     "strict": true,

examples/controllers/tsconfig.spec.json

@@ -2,6 +2,8 @@
   "extends": "./tsconfig.base.json",
   "include": ["test/**/*.ts"],
   "compilerOptions": {
+    "allowJs": true,
+
     "composite": true
   },
   "references": [