Add cds.app (#228)

See https://cap.cloud.sap/docs/node.js/cds-server#cds-app

CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
+## Version 0.7.0 - tbd
+
+### Added
+- `cds.app` typed as express.js application
+
 ## Version 0.6.5 - 2024-08-13
 ### Fixed
 - The `@types/sap__cds` link created by the `postinstall` script now also works in monorepo setups where the target `@cap-js/cds-types` might already be preinstalled (often hoisted some levels up).

apis/server.d.ts

@@ -163,3 +163,10 @@ type Middleswares = 'context' | 'trace' | 'auth' | 'ctx_model' | string
 export const middlewares: {
   add: (middleware: RequestHandler, pos?: XOR<XOR<{ at: number }, { after: Middleswares }>, { before: Middleswares }>) => void,
 }
+
+/**
+ * The {@link https://expressjs.com/en/4x/api.html#app| express.js application} constructed by the server implementation.
+ *
+ * @see [capire](https://cap.cloud.sap/docs/node.js/cds-server#cds-app)
+ */
+export const app: Application

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cap-js/cds-types",
-  "version": "0.6.5",
+  "version": "0.7.0",
   "description": "Type definitions for main packages of CAP, like `@sap/cds`",
   "repository": "github:cap-js/cds-types",
   "homepage": "https://cap.cloud.sap/",

test/typescript/apis/project/cds-server.ts

@@ -1,5 +1,5 @@
 import cds from '@sap/cds'
-import express from 'express'
+import express, { Application } from 'express'
 
 const h = undefined as unknown as express.RequestHandler
 
@@ -11,3 +11,5 @@ cds.middlewares.add(h, {after: 'foo'})
 cds.middlewares.add(h, {before: 'foo', after: 'foo'})
 // @ts-expect-error
 cds.middlewares.add(h, {after: 'foo', at: 2})
+
+cds.app satisfies Application