(feat, express): pass next into express handlers (#3696)

(feat): pass  into express handlers

generators/typescript/express/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.15.0] - 2024-05-13
+
+- Feature: Every endpoint method now accepts a third parameter called `next`. This gives 
+ express authors access to the express internals if they are useful 
+
+ ```ts
+ getUsers: (req, res, next: NextFunction) => {
+ // implementation
+ }
+ ```
+
 ## [0.14.0] - 2024-05-13
 
 - Feature: Support a `skipResponseValidation` configuration so that users can disable

generators/typescript/express/VERSION

@@ -1 +1 @@
-0.14.0
+0.15.0

generators/typescript/express/express-service-generator/src/GeneratedExpressServiceImpl.ts

@@ -168,6 +168,7 @@ export class GeneratedExpressServiceImpl implements GeneratedExpressService {
  }) {
  const REQUEST_PARAMETER_NAME = "req";
  const RESPONSE_PARAMETER_NAME = "res";
+ const NEXT_PARAMETER_NAME = "next";
 
  const COOKIE_PARAMETER_NAME = "cookie";
  const COOKIE_VALUE_PARAMETER_NAME = "value";
@@ -303,6 +304,10 @@ export class GeneratedExpressServiceImpl implements GeneratedExpressService {
  )
  ])
  )
+ },
+ {
+ name: NEXT_PARAMETER_NAME,
+ type: getTextOfTsNode(context.externalDependencies.express.NextFunction._getReferenceToType())
  }
  ],
  returnType: getTextOfTsNode(
@@ -673,7 +678,8 @@ export class GeneratedExpressServiceImpl implements GeneratedExpressService {
  )
  ],
  true
- )
+ ),
+ next
  ]
  )
  )

generators/typescript/utils/commons/src/external-dependencies/express/Express.ts

@@ -28,6 +28,9 @@ export interface Express {
  locals: (args: { referenceToExpressResponse: ts.Expression }) => ts.Expression;
  _getReferenceToType: () => ts.TypeNode;
  };
+ NextFunction: {
+ _getReferenceToType: () => ts.TypeNode;
+ };
  App: {
  use: (args: { referenceToApp: ts.Expression; path: ts.Expression; router: ts.Expression }) => ts.Expression;
  };

generators/typescript/utils/commons/src/external-dependencies/express/ExpressImpl.ts

@@ -6,6 +6,17 @@ export class ExpressImpl extends ExternalDependency implements Express {
  protected override PACKAGE = { name: "express", version: "4.18.2" };
  protected override TYPES_PACKAGE = { name: "@types/express", version: "4.17.16" };
 
+ public NextFunction = {
+ _getReferenceToType: this.withDefaultImport("express", (withImport, express) =>
+ withImport(() => {
+ return ts.factory.createTypeReferenceNode(
+ ts.factory.createQualifiedName(ts.factory.createIdentifier(express), "NextFunction"),
+ []
+ );
+ })
+ )
+ };
+
  public Request = {
  body: "body" as const,
  _getReferenceToType: this.withDefaultImport("express", (withImport, express) =>