fix: Document cds.middlewares.before

[schiwekM]

Document https://cap.cloud.sap/docs/node.js/cds-serve#cds-middlewares

[daogrady]

Hi Marten,

thank you for your contribution! Judging from the documentation, before should take in an ordered list of handlers:

The standard set of middlewares uses the following order
https://cap.cloud.sap/docs/node.js/cds-serve#cds-middlewares

is there a way to distinguish them, making sure they are defined in the right order?

Also, there's a subtle syntactic quirk here:

[number]  // tuple with exactly one number in it
[number, number]  // tuple with exactly two numbers in it
number[]  // array of number (arbitrary length)

I guess we want to aim for either

RequestHandler[]

if we want to allow an arbitrary number of handlers in any order, or

[RequestHandler, RequestHandler, RequestHandler]

if we want to strictly allow three (or however many is correct) handlers, or

[RequestHandlerA, RequestHandlerB, RequestHandlerC]

if we want to strictly allow three handlers, and each such handler must fulfil some condition we define, to make sure they are in the correct order.

Best,
Daniel

[schiwekM]

Hi @daogrady,

thanks for the explanation - first time writing types :)

I think

RequestHandler[]

is the best version as in theory applications can also modify cds.middlewares.before to introduce own ones.

BR, Marten

[daogrady]

No worries, just wanted to make sure. Welcome to TypeScript in that case and thanks for your contribution!