Support Deprecation in GraphQL

[ThisaruGuruge]

Description:
In a GraphQL schema, a field or an enum value can be deprecated. If deprecated, the users can include the deprecation reason for the particular field or the enum value.

In Ballerina, a field or an enum value in a GraphQL service can be marked deprecated using the existing Ballerina annotations. The Ballerina documentation even supports the deprecation reason through the Ballerina doc comments.

But when filtering the values using the includeDeprecated = false argument, the values aren't filtered correctly.

[ThisaruGuruge]

This cannot be supported for INPUT_OBJECT types due to ballerina-platform/ballerina-spec#823. The @deprecated directive support for the input object fields will be tracked via #2998