Feature: [TypeScript] "CollectParameters" to accept params as option-bag

[cspotcode]

Description

I would like the TypeScript code generator to support "CollectParameters" extension, which tells generated methods to accept all parameters as a single object / option-bag instead of multiple, positional arguments.

This extension is described here:
https://blog.apimatic.io/swagger-2-0-extension-for-code-generation-settings-abf602c3869d

openapi-generator version

3.2.1

OpenAPI declaration file content or url

paths:
  /favorites:
    get:
      operationId: GetFavorites
      x-operation-settings:
        CollectParameters: true
      parameters:
        - in: query
          name: account_id
          type: string
        - in: query
          name: user_id
          type: string
      responses:
        '200':
          description: '200'
          schema:
            $ref: '#/definitions/Favorites'

CollectParameters: true should generate client methods that accept an option-bag of params.

await client.getFavorites({account_id: '123', user_id: '456'});

Related issues/PRs

Rewrite of TypeScript generators

[macjohnny]

@TiFu maybe this can also be considered in the rewrite of the TS generators?

[TiFu]

Will keep this in mind.

[cspotcode]

@TiFu the code-gen changes should be really minimal. Given a function signature like this:

fooOperation(fooId: FooId, otherParam: OtherParamType) {

The CollectParameters version looks almost identical:

fooOperation({fooId, otherParam}: {fooId: FooId, otherParam: OtherParamType}) {

When none of the params are required, then append a default value so that the option-bag can be omitted entirely:

fooOperation({fooId, otherParam}: {fooId?: FooId, otherParam?: OtherParamType} = {}) {

[TiFu]

@cspotcode Another option would be to create interfaces for these parameter bags

e.g.

interface FooOperationParam {
      fooId: FooId,
      otherParam: OtherParamType
}

fooOperation(param: FooOperationParam) { }

// if all params are optional:
fooOperation(param: FooOperationParam = {})

What would you prefer?

[cspotcode]

No preference. I merely wanted to show that argument destructuring can be used to avoid any changes to the body of each method. The signature will be different, but the method body will still refer to each parameter via a local identifier. No need for property access expressions, e.g. `params.foo`

…

On Wed, Aug 22, 2018, 12:00 PM Tino Fuhrmann ***@***.***> wrote: @cspotcode <https://github.com/cspotcode> Another option would be to create classes for these parameter bags e.g. interface FooOperationParam { fooId: FooId, otherParam: OtherParamType } fooOperation(param: FooOperationParam) { } // if all params are optional: fooOperation(param: FooOperationParam = {}) What would you prefer? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#865 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAW-uNqQyFcioeOiSZVMTkDTXzlDRBA7ks5uTYAygaJpZM4WF-_Z> .

[wing328]

There were similar suggestions before but nothing has been implemented yet. The use case was that the method contains many optional parameters, which will make the method signature very long in languages such as Java.

Related: #641

[cspotcode]

@TiFu If I want to take a stab at implementing this issue, which branch should I base my code on?

[wing328]

FYI. I've added group parameters support to PHP API client: #1337

[wing328]

Hi all,

I've tried to add group parameters support to TS Fetch client with some fake parameters to illustrate the change in #1394.

https://github.com/OpenAPITools/openapi-generator/pull/1394/files#diff-157014844e879c93896c6ee0805f91ddR1541 is a good starting point to review the change.

Please review and let me know if you've any feedback.

Disclaimer: I'm no expert in TypeScript

Thanks,
William

cc @TiFu (2017/07) @taxpon (2017/07) @sebastianhaas (2017/07) @kenisteward (2017/07) @Vrolijkx (2017/09) @macjohnny (2018/01) @nicokoenig (2018/09) @topce (2018/10)