[typescript-rxjs] Feat: Add @deprecated JSDoc tag to API operations

[plantexchen]

This commit introduces the JSDoc @deprecated tag to API methods generated by the typescript-rxjs generator when the corresponding operation is marked as deprecated in the OpenAPI specification (deprecated: true).

The change aims to improve developer experience (DX) and code quality by providing immediate feedback on API usage.

Details

• Behavior: If an operation includes deprecated: true in the spec, the @deprecated tag is inserted into the JSDoc block preceding the method signature in the generated api.service.ts file.
• Benefit: IDEs like VS Code, WebStorm, or IntelliJ will correctly display a strike-through on the method name and surface deprecation warnings, encouraging developers to switch to newer alternatives.

Files Modified

• modules/openapi-generator/src/main/resources/typescript-rxjs/apis.mustache
• modules/openapi-generator/src/main/resources/typescript-rxjs/modelGeneric.mustache
• modules/openapi-generator/src/main/resources/typescript-rxjs/modelAllOf.mustache
• modules/openapi-generator/src/main/resources/typescript-rxjs/modelOneOf.mustache
• modules/openapi-generator/src/main/resources/typescript-rxjs/modelEnum.mustache

[wing328]

thanks for the pr

please follow step 3 to update the samples so that the CI can verify the change.

[wing328]

CC @TiFu (2017/07) @taxpon (2017/07) @sebastianhaas (2017/07) @kenisteward (2017/07) @Vrolijkx (2017/09) @macjohnny (2018/01) @topce (2018/10) @akehir (2019/07) @petejohansonxo (2019/11) @amakhrov (2020/02) @davidgamero (2022/03) @mkusaka (2022/04) @joscha (2024/10)

[wing328]

Thanks for the PR but your commit (as shown in the Commits tab) is not linked to your Github account, which means this PR won't count as your contribution in https://github.com/OpenAPITools/openapi-generator/graphs/contributors.

Let me know if you need help fixing it.

Ref: https://github.com/OpenAPITools/openapi-generator/wiki/FAQ#how-can-i-update-commits-that-are-not-linked-to-my-github-account