add lua language server annotations

- req.valid for validator middleware
- req.body and req.bodydata for body-parser
- req.cookies for cookie-parser

lua/body-parser.lua

@@ -78,6 +78,11 @@ local function parse_query_string(str)
 	return params
 end
 
+--- @class ExpressRequest
+--- @field bodydata string | nil raw body data
+--- @field body table | nil parsed body data
+
+--- @return fun(req: ExpressRequest, res: ExpressResponse, next: fun(err?: any))
 function bodyparser.urlencoded(opts)
 	local typ = opts and opts.type or "application/x-www-form-urlencoded"
 

lua/cookie-parser.lua

@@ -1,6 +1,10 @@
 --- @usage
 --- local cookie_parser = require("cookie-parser")
 --- app:use(cookie_parser())
+
+--- @class ExpressRequest
+--- @field cookies table | nil -- table of parsed cookies
+
 return function(opts)
 	-- todo? signed cookies
 

lua/validator.lua

@@ -167,9 +167,15 @@ local function validate_all(params_rules, params_values, messages)
 	return formatted_values, nil
 end
 
+--- @class ExpressRequest
+--- @field valid table | nil validated parameters by [validator middleware](https://github.com/TRIGONIM/lua-express-middlewares)
+
 -- Извлекает параметры из запроса в соответствии с правилами и проверяет их
 -- Если указан messages, то в случае ошибки будет использовано сообщение из него
 local function express_middleware(params_with_rules, messages) -- messages may be nil
+	--- @param req ExpressRequest
+	--- @param _ ExpressResponse
+	--- @param next fun(err?: any)
 	return function(req, _, next)
 		local params_values = {}
 		for param_name in pairs(params_with_rules) do