@cap-js/graphql - npm Package Versions

Version 0.11.0 - 2024-07-30

Added

• Support for configuring request payload limit using global flag cds.server.body_parser.limit

Changed

• Bump required @sap/cds version to >=7.8
• To improve performance, binary payloads are no longer validated to check if they are properly base64 or base64url encoded
• Bump required node version to ^16 due to usage of Buffer.toString('base64url')
• Use cds.compile.to.serviceinfo to determine if a service should be compiled to GraphQL schema

Version 0.10.1 - 2024-03-07

Fixed

• Type parsing error for literal values passed within arguments on fields of scalar type differing from the literal type. This case occurred for delete mutations when the filter operands had a type other than Int.

Version 0.10.0 - 2024-01-30

Added

• Support for generating GraphQL descriptions from CDS doc comments of services, entities, and elements
• Support for operator in for filtering on lists of values

Changed

• Bump @graphiql/plugin-explorer version to ^1
• Ignore fields that represent foreign keys in GraphQL schema generation
• When compiling to GraphQL using the CDS API or CLI, only generate GraphQL schemas for services that are annotated with GraphQL protocol annotations

Fixed

• Name clashes when CDS elements are named nodes or totalCount
• Parsing of null values in lists

Version 0.9.0 - 2023-11-16

Added

• Message interpolation of logged errors, transforming error message placeholders into human-readable text (default locale)

Changed

• Moved registration of cds.compile.to.gql and cds.compile.to.graphql targets from @sap/cds to @cap-js/graphql
• Improve merging of custom graphql protocol configuration with plugin default configuration
• Errors representing client errors (4xx range) are now logged as warnings instead of errors
• Exclude the stack trace of the outer logged error message in multiple error scenarios, as the inner stack trace already contained the precise initial segment of the outer stack trace

Fixed

• Load custom errorFormatter relative to CDS project root
• Fix internal server error when formatting errors that aren't CDS errors (thrown by CDS or in custom handlers) or instances of GraphQLError, such as the error caused by requests with undefined query property

Version 0.8.0 - 2023-10-06

Added

• [beta] Translate CDS error messages and include additional error properties in GraphQLError extensions. Only specific allowed properties are exposed when running in production.
• [beta] Option errorFormatter that can be pointed to a function that overwrites the default logic of how CDS errors are formatted before they are added to the GraphQL error response. Please note that this may overwrite sanitization logic that is otherwise applied to error messages in production.
• [beta] Logging of errors that occur during query and mutation execution

Changed

• Bump required @sap/cds version to >=7.3
• Bump required graphql-http version to ^1.18.0

Fixed

• Malformed responses for convoluted queries in which parts of results are supposed to be returned multiple times, caused by formatting results in-place

Version 0.7.0 - 2023-09-04

Changed

• Omit variables from log if it is an empty object

Version 0.6.2 - 2023-07-12

Changed

• Pin graphiql version to ^3
• Pin @graphiql/plugin-explorer version to ~0.3

Fixed

• GraphiQL Explorer Plugin initialization due to upstream implementation pattern change

Version 0.6.1 - 2023-07-05

Changed

• Improved query logging:
  • Don't log queries that are undefined
  • Log operationName
  • Log variables when not in production
  • Sanitize arguments and their values in queries when in production

Fixed

• Changed GraphiQL Explorer Plugin CDN URL due to upstream renaming

Version 0.6.0 - 2023-06-23

Added

• Support for @sap/cds^7 middlewares and protocols. Note: services now need to be annotated with protocol annotations such as @graphql or @protocol: 'graphql'.

Changed

• Bump required @sap/cds version to >=7
• @cap-js/graphql/index.js now collects individual services and mounts the adapter as a protocol middleware on the cds.on('served', ...) event
• Moved the GraphQLAdapter module to lib/GraphQLAdapter.js and merged it with CDSGraphQLAdapter previously found in index.js in the root directory
• Don't generate fields that represent compositions of aspects within mutation types that represent services
• Disabled conjunction on the same field for the following operators:
  • eq (Equal)
  • gt (Greater Than)
  • ge (Greater Than or Equal)
  • le (Less Than or Equal)
  • lt (Less Than)
  • startswith
  • endswith

Version 0.5.0 - 2023-05-04

Changed

• Improved consistency of handling results of different types returned by custom handlers in CRUD resolvers:
  • Wrap only objects (i.e. not primitive types or arrays) returned by custom handlers in arrays in create, read, and update resolvers
  • Delete mutations return the length of an array that is returned by a DELETE custom handler or 1 if a single object is returned
• Don't generate fields for key elements in update input objects
• Update and delete mutations have mandatory filter argument
• Allow services that are not instances of cds.ApplicationService. It is expected that the invoker provides the correct set of service providers when directly using the GraphQL protocol adapter API.

Fixed

• Aligned cds.Request instantiation with other protocols for more consistent usage in custom handlers