fix(swagger.helper.ts): change query params meta to comply with swagger spec

[DaVarga]

Make use of swagger array query params on getMany endpoints for fields filter or sort and
join. Also use integer as type for cache page offset and limit

fix #196

[michaelyali]

@Diluka are you good with it?
We still need to change our swagger docs generation (regarding your complaints about English description and html tags) but we still can merge.
What do you think?

[Diluka]

according to #196 (comment)
fields filter or sort there are not multi value params
we don't pass value like this &filter=a||eq||1,b||eq||2

[DaVarga]

@Diluka I think you missed the collectionFormat. The &filter=a||eq||1,b||eq|||2 you mentioned would be collectionFormat: csv used for the fields parameter.
But for join, sort, or and filter I used the format collectionFormat: multi. Which according to swagger translates to "Multiple parameter instances rather than multiple values." e.g. foo=value&foo=another_value

Look at the collectionFormat table at https://swagger.io/docs/specification/2-0/describing-parameters/#array

It also makes me wonder why the API has different approaches to use arrays in url params 🤔

[Diluka]

oh, understood

[ignatvilesov]

@zMotivat0r @Diluka This PR is critical to generate a correct TS library. Could you please merge this one and share any release date?

[ignatvilesov]

Thank you so much for merging this one @zMotivat0r
Any ideas when it's going to be released? Looking forward to using it in our application.