Skip to content

Latest commit

 

History

History
1042 lines (679 loc) · 98.8 KB

CHANGELOG.md

File metadata and controls

1042 lines (679 loc) · 98.8 KB

CHANGELOG

The version headers in this history reflect the versions of Apollo Server itself. Versions of other packages (e.g., those which are not actual HTTP integrations; packages not prefixed with "apollo-server", or just supporting packages) may use different versions.

🆕 Please Note!: 🆕 The @apollo/federation and @apollo/gateway packages now live in the apollographql/federation repository.

vNEXT

The changes noted within this vNEXT section have not been released yet. New PRs and commits which introduce changes should include an entry in this vNEXT section as part of their development. With few exceptions, the format of the entry should follow convention (i.e., prefix with package name, use markdown backtick formatting for package names and code, suffix with a link to the change-set à la [PR #YYY](https://link/pull/YYY), etc.). When a release is being prepared, a new header will be (manually) created below and the appropriate changes within that release will be moved into the new section.

  • The debug option to new ApolloServer (which adds stack traces to errors) now affects errors that come from requests executed with server.executeOperation (and its wrapper apollo-server-testing), instead of just errors that come from requests executed over HTTP. Issue #4107 PR #4948
  • Bump version of @apollographql/graphql-playground-html to v1.6.27 and @apollographql/graphql-playground-react to v1.7.39 to resolve incorrectly rendered CDN URL when Playground version was false-y. PR #4932 PR #4955 Issue #4937

v2.21.0

  • Apollo Server can now be installed with graphql@15 without causing peer dependency errors or warnings. (Apollo Server has a file upload feature which was implemented as a wrapper around the graphql-upload package. We have been unable to upgrade our dependency on that package due to backwards-incompatible changes in later versions, and the version we were stuck on did not allow graphql@15 as a peer dependency. We have now switched to a fork of that old version called @apollographql/graphql-upload-8-fork that allows graphql@15.) Also bump the graphql-tools dependency from 4.0.0 to 4.0.8 for graphql@15 support. Issue #4865

v2.20.0

  • apollo-server: Previously, ApolloServer.stop() functioned like net.Server.close() in that it did not close idle connections or close active connections after a grace period. This meant that trying to await ApolloServer.stop() could hang indefinitely if there are open connections. Now, this method closes idle connections, and closes active connections after 10 seconds. The grace period can be adjusted by passing the new stopGracePeriodMillis option to new ApolloServer, or disabled by passing Infinity (though it will still close idle connections). Note that this only applies to the "batteries-included" ApolloServer in the apollo-server package with its own built-in Express and HTTP servers. PR #4908 Issue #4097
  • apollo-server-core: When used with ApolloGateway, ApolloServer.stop now invokes ApolloGateway.stop. (This makes sense because ApolloServer already invokes ApolloGateway.load which is what starts the behavior stopped by ApolloGateway.stop.) Note that @apollo/gateway 0.23 will expect to be stopped in order for natural program shutdown to occur. PR #4907 Issue #4428
  • apollo-server-core: Avoid instrumenting schemas for the old graphql-extensions library unless extensions are provided. PR #4893 Issue #4889
  • apollo-server-plugin-response-cache@0.6.0: The shouldReadFromCache and shouldWriteToCache hooks were always documented as returning ValueOrPromise<boolean> (ie, that they could be either sync or async), but they actually only worked if they returned a bool. Now they can be either sync or async as intended. PR #4890 Issue #4886
  • apollo-datasource-rest@0.10.0: The RESTDataSource.trace method is now protected instead of private to allow more control over logging and metrics. PR #3940

v2.19.2

  • apollo-server-express: types: Export ExpressContext from main module. PR #4821 Issue #3699
  • apollo-server-env: types: The first parameter to fetch is now marked as required, as intended and in accordance with the Fetch API specification. PR #4822 Issue #4741
  • apollo-server-core: Update graphql-tag package to latest, now with its graphql-js peerDependencies expanded to include ^15.0.0 PR #4833

v2.19.1

  • apollo-server-core: The debugPrintReports option to ApolloServerPluginUsageReporting now prints traces as well. PR #4805

v2.19.0

  • apollo-server-testing: types: Allow generic variables usage of query and mutate functions. PR #4383
  • apollo-server-express: Export the GetMiddlewareOptions type. PR #4599
  • apollo-server-lambda: Fix file uploads - ignore base64 decoding for multipart queries. PR #4506
  • apollo-server-core: Do not send operation documents that cannot be executed to Apollo Studio. Instead, information about these operations will be combined into one "operation" for parse failures, one for validation failures, and one for unknown operation names.

v2.18.2

  • apollo-server-core: Explicitly include lru-cache dependency in apollo-server-core's dependencies. PR #4600

v2.18.1

  • apollo-server-core: Fix support for legacy option engine: {logger}, broken in v2.18.0. PR #4588

  • apollo-server-plugin-base: The ApolloServerPlugin TypeScript type does not need to extend AnyFunctionMap, which was an unnecessary change in v2.18.0. PR #4588

  • apollo-server-core: Improve a usage reporting error which occurs when you use Apollo Server in an unsupported way. PR #4588

  • apollo-server-core: Fix typo in error message for unparsable/invalid schemas provided via overrideReportedSchema. PR #4581

v2.18.0

  • apollo-server-core: When Apollo Server is configured with an Apollo API key, the URLs it uses to connect to Apollo's servers have changed. If the environment in which you run your servers requires you to explicitly allow connections by domain, you will need to add the new domain names. Usage reporting previously connected to https://engine-report.apollodata.com/ and now connects to https://usage-reporting.api.apollographql.com/; schema reporting previously connected to https://edge-server-reporting.api.apollographql.com/ and now connects to https://schema-reporting.api.apollographql.com/ . PR #4453

  • Apollo Server's support for communicating with Apollo’s commercial products has been refactored into three separate plugins exported from apollo-server-core (for usage reporting, schema reporting, and inline tracing), configured using the standard plugins option. The engine option continues to work for backwards compatibility in the 2.x series; support for engine will be deprecated in Apollo Server 3.x. Full details are available in the migration guide. PR #4453

  • To consistently support tracing, inline tracing is enabled by default on federated implementing services, even when an Apollo API key is provided. Previously it was not enabled when an API key was provided. You can disable it with ApolloServerPluginInlineTraceDisabled. PR #4453

  • The apollo-engine-reporting npm package has been obsoleted and will no longer receive updates. PR #4453

  • The apollo-engine-reporting-protobuf package has been renamed to apollo-reporting-protobuf. No new versions of the old package will be published. PR #4453

  • Implementations of ApolloServer for serverless frameworks such as Lambda now override the serverlessFramework() method to return true. We have changed our own integrations, but other implementations that extend ApolloServer which need this behavior should do the same. Support for engine.sendReportsImmediately will be dropped in Apollo Server 3.x. PR #4453

  • The GraphQLServiceContext type passed to the plugin serverWillStart method now contains apollo and serverlessFramework values. PR #4453

  • apollo-server-core / apollo-server-plugin-base: The request pipeline plugin API now supports a serverWillStop lifecycle hook. PR #4453

  • apollo-server-core: Previously, the usage reporting functionality registered one-shot handlers for the SIGINT and SIGTERM signals, which it used to send one final usage report before re-sending the signal to itself to continue shutdown. These signals handlers were installed by default if you enabled usage or schema reporting, and could be disabled by passing engine.handleSignals: false. Now, termination signal handling is the responsibility of Apollo Server as a whole rather than something specific to usage reporting. Apollo Server itself now registers these one-shot signal handlers, which trigger ApolloServer.stop(). This allows any plugin that implements the new serverWillStop callback to hook into shutdown logic, not just the usage reporting code. Similarly to before, these signal handlers are registered by default but can be disabled by via an option. We've changed the option name to stopOnTerminationSignals: false as it is more explicit about the behavior. PR #4453

  • apollo-server-core: The default logger implementation (if you don't specify your own logger or specify debug) now logs at the INFO level instead of the WARN level. The main effect is on a few built-in plugins which log one INFO message at startup; if a custom plugin logs at the INFO level then those messages will be visible by default as well. PR #4453

  • apollo-server-core: Parse and validate any schema passed via overrideReportedSchema to the schema reporting plugin, and throw accordingly on unparsable or invalid schemas.

  • Using Apollo Server from TypeScript now requires TypeScript 3.8 due to the use of the import type and export type directives. (If this proves to be a major problem we can revert this choice, but it makes it easier for us to ensure that certain large dependencies are only loaded when needed.) PR #4453

  • Updated @apollographql/graphql-playground-react to 1.7.33 to include an upstream fix. PR #4550

v2.17.0

  • subscriptions: Fix bug which prevented installSubscriptionHandlers from accepting a websocket.Server (as intended in PR #1966) and also added support for other http.Server variations (e.g., Tls). Issue #4198 PR #4200

v2.16.1

  • This release only includes patch updates to dependencies.

v2.16.0

  • apollo-server-fastify: Pass Fastify's request and reply objects into the context function, which previously had been receiving nothing. Issue #3156 [PR #3895(apollographql#3895)
  • apollo-server-lamdbda: Automatically decode payloads which are Base64-encoded when the isBase64Encoded boolean is present on Lambda event payloads. PR #4311

v2.15.1

  • The default branch of the repository has been changed to main. As this changed a number of references in the repository's package.json and README.md files (e.g., for badges, links, etc.), this necessitates a release to publish those changes to npm. PR #4302

v2.15.0

  • apollo-engine-reporting: Added a reportTiming API to allow trace reporting to be enabled or disabled on a per request basis. The option takes either a boolean or a predicate function that takes a GraphQLRequestContextDidResolveOperation or GraphQLRequestContextDidEncounterErrors and returns a boolean. If the boolean is false the request will not be instrumented for tracing and no trace will be sent to Apollo Graph Manager. The default is true so all traces will get instrumented and sent, which is the same as the previous default behavior. PR #3918
  • apollo-engine-reporting: Removed GraphQLServerOptions.reporting. It isn't known whether a trace will be reported at the beginning of the request because of the above change. We believe this field was only used internally within Apollo Server; let us know if this is a problem and we can suggest alternatives. Additionally, the field requestContext.metrics.captureTraces is now initialized later in the request pipeline. PR #3918
  • apollo-engine-reporting: Make Apollo Server throw if schema reporting is enabled for a gateway or federated service. PR #4246
  • apollo-engine-reporting: Remove the experimental_ prefix from schema reporting options, and specifically rename experimental_schemaReporting option name to reportSchema. (The old option names remain functional, but are deprecated.) PR #4236

v2.14.5

  • apollo-engine-reporting: Make Apollo Server throw if schema reporting is enabled for a gateway or federated service. PR #4246

v2.14.4

  • apollo-engine-reporting: Add environment variable APOLLO_SCHEMA_REPORTING that can enable schema reporting. If experimental__schemaReporting is set it will override the environment variable. PR #4206
  • apollo-engine-reporting: The schema reporting URL has been changed to use the new dedicated sub-domain https://edge-server-reporting.api.apollographql.com. PR #4232
  • apollo-server-core: Though Apollo Server is not affected due to the way it is integrated, in response to an upstream security advisory for GraphQL Playground we have published the same patch on our @apollographql/graphql-playground-html fork and bumped Apollo Server to use it. Again, this was done out of an abundance of caution since the way that Apollo Server utilizes renderPlaygroundPage is not vulnerable as it does not allow per-request Playground configuration that could allow interpolation of user-input. PR #4231

v2.14.3

  • This release only includes patch updates to dependencies.

v2.14.2

Note: This release is is related to a GitHub Security Advisory published by the Apollo Server team. Please read the attached advisory to understand the impact.

v2.14.1

See complete versioning details.

  • apollo-server-testing: Ensure that user-provided context is cloned when using createTestClient, per the instructions in the intergration testing section of the Apollo Server documentation. Issue #4170 PR #4175

v2.14.0

See complete versioning details.

  • apollo-server-core / apollo-server-plugin-base: Add support for willResolveField and corresponding end-handler within executionDidStart. This brings the remaining bit of functionality that was previously only available from graphql-extensions to the new plugin API. The graphql-extensions API (which was never documented) will be deprecated in Apollo Server 3.x. To see the documentation for the request pipeline API, see its documentation. For more details, see the attached PR. PR #3988

  • apollo-server-core: Deprecate graphql-extensions. All internal usages of the graphql-extensions API have been migrated to the request pipeline plugin API. For any implementor-supplied extensions, a deprecation warning will be printed once per-extension, per-server-startup, notifying of the intention to deprecate. Extensions should migrate to the plugin API, which is outlined in its documentation. PR #4135

  • apollo-engine-reporting: Currently only for non-federated graphs. Added an experimental schema reporting option, experimental_schemaReporting, for Apollo Graph Manager users. During this experiment, we'd appreciate testing and feedback from current and new users of the schema registry!

    Prior to the introduction of this feature, the only way to get schemas into the schema registry in Apollo Graph Manager was to use the CLI and run apollo schema:push. Apollo schema reporting protocol is a new specification for GraphQL servers to automatically report schemas to the Apollo Graph Manager schema registry.

    To enable schema reporting, provide a Graph Manager API key (available free from Apollo Graph Manager) in the APOLLO_KEY environment variable and set the experimental_schemaReporting option to true in the Apollo Server constructor options, like so:

    const server = new ApolloServer({
      typeDefs,
      resolvers,
      engine: {
        experimental_schemaReporting: true,
        /* Other existing options can remain the same. */
      },
    });

    When enabled, a schema reporter is initiated by the apollo-engine-reporting agent. It will loop until the ApolloServer instance is stopped, periodically calling back to Apollo Graph Manager to send information. The life-cycle of this reporter is managed by the agent.

    For more details on the implementation of this new protocol, see the PR which introduced it to Apollo Server and the preview documentation.

    PR #4084

  • apollo-engine-reporting: The underlying integration of this plugin, which instruments and traces the graph's resolver performance and transmits these metrics to Apollo Graph Manager, has been changed from the (soon to be deprecated) graphql-extensions API to the new request pipeline plugins API. PR #3998

    This change should be purely an implementation detail for a majority of users. There are, however, some special considerations which are worth noting:

    • The federated tracing plugin's ftv1 response on extensions (which is present on the response from an implementing service to the gateway) is now placed on the extensions after the formatResponse hook. Anyone leveraging the extensions.ftv1 data from the formatResponse hook will find that it is no longer present at that phase.
  • apollo-tracing: This package's internal integration with Apollo Server has been switched from using the soon-to-be-deprecated graphql-extensions API to using the request pipeline plugin API. Behavior should remain otherwise the same. PR #3991

  • apollo-cache-control: This package's internal integration with Apollo Server has been switched from using the soon-to-be-deprecated graphql-extensions API to using the request pipeline plugin API. Behavior should remain otherwise the same. PR #3997

v2.13.0

See complete versioning details.

  • Allow passing a WebSocket.Server to ApolloServer.installSubscriptionHandlers. PR #2314
  • apollo-server-lambda: Support file uploads on AWS Lambda Issue #1419 Issue #1703 PR #3926
  • apollo-engine-reporting: Fix inadvertant conditional formatting which prevented automated persisted query (APQ) hits and misses from being reported to Apollo Graph Manager. PR #3986
  • apollo-engine-reporting: Deprecate the ENGINE_API_KEY environment variable in favor of its new name, APOLLO_KEY. Continued use of ENGINE_API_KEY will result in deprecation warnings and support for it will be removed in a future major version. #3923
  • apollo-engine-reporting: Deprecated the APOLLO_SCHEMA_TAG environment variable in favor of its new name, APOLLO_GRAPH_VARIANT. Similarly, within the engine configuration object, the schemaTag property has been renamed graphVariant. The functionality remains otherwise unchanged, but their new names mirror the name used within Apollo Graph Manager. Continued use of the now-deprecated names will result in deprecation warnings and support will be dropped completely in the next "major" update. To avoid misconfiguration, a runtime error will be thrown if both new and deprecated names are set. PR #3855
  • apollo-engine-reporting-protobuf: (This is a breaking change only if you directly depend on apollo-engine-reporting-protobuf.) Drop legacy fields that were never used by apollo-engine-reporting. Added new fields StatsContext to allow apollo-server to send summary stats instead of full traces, and renamed FullTracesReport to Report and Traces to TracesAndStats since reports now can include stats as well as traces.

v2.12.0

See complete versioning details.

  • apollo-server-core: Support providing a custom logger implementation (e.g. winston, bunyan, etc.) to capture server console messages. Though there has historically been limited output from Apollo Server, some messages are important to capture in the larger context of production logging facilities or can benefit from using more advanced structure, like JSON-based logging. This also introduces a logger property to the GraphQLRequestContext that is exposed to plugins, making it possible for plugins to leverage the same server-level logger, and allowing implementors to create request-specific log contexts, if desired. When not provided, these will still output to console. PR #3894
  • apollo-server-core: When operating in gateway mode using the gateway property of the Apollo Server constructor options, the failure to initialize a schema during initial start-up, e.g. connectivity problems, will no longer result in the federated executor from being assigned when the schema eventually becomes available. This precludes a state where the gateway may never become available to serve federated requests, even when failure conditions are no longer present. PR #3811
  • apollo-server-core: Prevent a condition which prefixed an error message on each request when the initial gateway initialization resulted in a Promise-rejection which was memoized and re-prepended with Invalid options provided to ApolloServer: on each request. PR #3811
  • apollo-server-express: Disable the automatic inclusion of the x-powered-by: express header. PR #3821
  • apollo-engine-reporting: Avoid creating new arrays when building trace trees. PR #3479
  • apollo-server-core: Bump graphql peerDependencies range to include ^15.0.0. PR #3944

v2.11.0

See complete versioning details.

  • The range of accepted peerDepedencies versions for graphql has been widened to include graphql@^15.0.0-rc.2 so as to accommodate the latest release-candidate of the graphql@15 package, and an intention to support it when it is finally released on the latest npm tag. While this change will subdue peer dependency warnings for Apollo Server packages, many dependencies from outside of this repository will continue to raise similar warnings until those packages own peerDependencies are updated. It is unlikely that all of those packages will update their ranges prior to the final version of graphql@15 being released, but if everything is working as expected, the warnings can be safely ignored. PR #3825

v2.10.1

See complete versioning details.

  • apollo-server-core: Update GraphQL Playground to latest version to remove a rogue curly-brace appearing in the top-right corner of the interface under certain conditions. PR #3702 Playground PR
  • apollo-server-core: Typings: Allow the cache property inside persistedQueries to be optional. This was already optional at runtime where it defaults to the top-level global cache when unspecified, but with the introduction of the ttl property, it now makes sense that one may be provided without the other. #3671

v2.10.0

See complete versioning details.

  • apollo-server-express: Support CorsOptionsDelegate type on cors parameter to applyMiddleware, to align with the supported type of the underlying cors middleware itself. #3613
  • apollo-server-core: Allow asynchronous initialization of datasources: the initialize method on datasources may now return a Promise, which will be settled before any resolvers are called. #3639
  • apollo-server-core: experimental: Allow configuration of the parsed/validated document store by introducing an experimental_approximateDocumentStoreMiB property to the ApolloServer constructor options which overrides the default cache size of 30MiB. #3755

v2.9.16

See complete versioning details.

  • apollo-server-core: Update apollo-tooling dependencies, resolve TS build error (missing types for node-fetch) #3662

v2.9.15

See complete versioning details.

  • apollo-engine-reporting: Fix regression introduced by #3614 which caused PersistedQueryNotFoundError, PersistedQueryNotSupportedError and InvalidGraphQLRequestError errors to be triggered before the requestDidStart handler triggered treeBuilder's startTiming method. This fix preserves the existing behavior by special-casing these specific errors. #3638 fixes #3627
  • apollo-server-cloud-functions: Transmit CORS headers on OPTIONS request. #3557
  • apollo-server-caching: De-compose options interface for KeyValueCache.prototype.set to accommodate better TSDoc annotations for its properties (e.g. to specify that ttl is defined in seconds). #3619
  • apollo-server-core, apollo-server-caching: Introduce a ttl property, specified in seconds, on the options for automated persisted queries (APQ) which applies specific TTL settings to the cache sets during APQ registration. Previously, all APQ cache records were set to 300 seconds. Additionally, this adds support (to the underlying apollo-server-caching mechanisms) for a time-to-live (TTL) value of null which, when supported by the cache implementation, skips the assignment of a TTL value altogether. This allows the cache's controller to determine when eviction happens (e.g. cache forever, and purge least recently used when the cache is full), which may be desireable for network cache stores (e.g. Memcached, Redis). #3623
  • apollo-server-core: Upgrade TS to 3.7.3 #3618

v2.9.14

See complete versioning details.

  • apollo-server-core: Ensure that plugin's didEncounterErrors hooks are invoked for known automated persisted query (APQ) errors. #3614
  • apollo-server-plugin-base: Move TContext generic from requestDidStart method to ApolloServerPlugin Interface. #3525

v2.9.13

See complete versioning details.

  • @apollo/gateway: Add @types/node-fetch as a regular dependency to avoid missing dependency for TypeScript consumers. #3546 fixes #3471
  • apollo-engine-reporting: Declare acceptable graphql versions ranges in peerDependencies rather than allowing it to occur implicitly (and less ideally) via its consumers (e.g. most apollo-server-* packages). #3496

v2.9.12

  • Reinstate #3530 via #3539 - after a patch release of the @apollo/protobufjs fork, the build issue for consumers should be resolved.

v2.9.11

  • Revert #3530 via #3535- the introduction of the @apollo/protobufjs fork is causing TS errors in consumer projects. Reverting this change for now, and will reintroduce it after the issue is resolved within the forked package.

v2.9.10

See complete versioning details.

  • apollo-engine-reporting: Swap usage of protobufjs for a newly published fork located at @apollo/protobufjs. This is to account for the relative uncertainty into the continued on-going maintenance of the official protobuf.js project. This should immediately resolve a bug that affected Long types in apollo-engine-reporting and other non-Apollo projects that rely on protobuf.js's Long type. #3530

v2.9.9

See complete versioning details.

  • apollo-server-core: Don't try parsing variables and extensions as JSON if they are defined but empty strings. #3501
  • apollo-server-lambda: Introduce onHealthCheck on createHandler in the same fashion as implemented in other integrations. #3458
  • apollo-server-core: Use graphql's isSchema to more defensively check the user-specified schema's type at runtime and prevent unexpected errors. #3462

v2.9.8

See complete versioning details.

  • apollo-server-core: Provide accurate type for formatResponse rather than generic Function type. #3431
  • apollo-server-core: Pass complete request context to formatResponse, rather than just context. #3431

v2.9.7

See complete versioning details.

  • apollo-server-errors: Fix ApolloError bug and GraphQLError spec compliance #3408

v2.9.6

See complete versioning details.

  • @apollo/gateway, @apollo/federation, apollo-engine-reporting: Update apollo-graphql dependency to bring in apollo-tooling's #1551 which resolve runtime errors when its source is minified. While this fixes a particular minification bug when Apollo Server packages are minified, we do not recommend minification of server code in most cases. #3387 fixes #3335
  • apollo-server-koa: Correctly declare dependency on koa-compose. #3356
  • apollo-server-core: Preserve any extensions that have been placed on the response when pre-execution errors occur. #3394

v2.9.3

See complete versioning details.

  • apollo-server-express: Add direct dependency on express to allow for usage of express.Router for getMiddleware functionality (from #2435). Previously, unlike other server integration packages, apollo-server-express did not directly need express as a dependency since it only relied on express for TypeScript typings. #3239 fixes #3238
  • apollo-server-lambda: Add @types/aws-lambda as a direct dependency to apollo-server-express to allow usage of its typings without needing to separately install it. #3242 fixes #2351

v2.9.2

See complete versioning details.

  • apollo-server-koa: Drop support for Node.js v6 within the Apollo Server Koa integration in order to update koa-bodyparser dependency from v3.0.0 to v4.2.1. #3229 fixes #3050
  • apollo-server-express: Use explicit return type for new getMiddleware method. #3230 (hopefully) fixes #3222

v2.9.1

See complete versioning details.

  • apollo-server-core: Make formatError available to subscriptions in the same spirit as the existing formatResponse. #2942
  • apollo-engine-reporting: The behavior of the engine.maxAttempts parameter previously did not match its documentation. It is documented as being the max number of attempts including the initial attempt, but until this release it was actually the number of retries excluding the initial attempt. The behavior has been changed to match the documentation (and the literal reading of the option name). #3218
  • apollo-engine-reporting: When sending the report fails with a server-side 5xx error, include the full error from the server in the logs. #3218
  • apollo-server-core: Fix regression which prevented the resizing of the schema panel in GraphQL Playground. #3224 and upstream

v2.9.0

See complete versioning details.

  • apollo-server-express, apollo-server-koa: A new getMiddleware method has been introduced, which accepts the same parameters as applyMiddleware with the exception of the app property. This allows implementors to obtain the middleware directly and "use" it within an existing app. In the near-term, this should ease some of the pain points with the previous technique. Longer-term, we are exploring what we consider to be a much more natural approach by introducing an "HTTP transport" in Apollo Server 3.x. See this proposal issue for more information. #2435
  • @apollo/federation: buildFederatedSchema's typeDefs parameter now accepts arrays of DocumentNodes (i.e. type definitions wrapped in gql) and resolvers to make the migration from a single service into a federated service easier for teams previously utilizing this pattern. #3188

v2.8.2

See complete versioning details.

  • apollo-server-koa: Update dependency koa to v2.8.1. PR #3175
  • apollo-server-express: Update types exported by the ASE package. PR #3173 PR #3172

v2.8.1

See complete versioning details.

  • apollo-engine-reporting: Fix reporting errors which have non-array path fields (eg, non-GraphQLError errors). PR #3112
  • apollo-engine-reporting: Add missing apollo-server-caching dependency. PR #3054
  • apollo-server-hapi: Revert switch from accept and boom which took place in v2.8.0. PR #3089
  • @apollo/gateway: Change the setInterval timer, which is used to continuously check for updates to a federated graph from the Apollo Graph Manager, to be an unref'd timer. Without this change, the server wouldn't terminate properly once polling had started since the event-loop would continue to have unprocessed events on it. PR #3105
  • Switch to using community @types/graphql-upload types.
  • apollo-server-fastify: Change the typing of the HTTP response from OutgoingMessage to ServerResponse. Commit
  • apollo-server-hapi: Pass the raw request and response objects to graphql-uploads processRequest method to align on the same TypeScript types. Commit

v2.8.0

See complete versioning details.

  • @apollo/federation: Add support for "value types", which are type definitions which live on multiple services' types, inputs, unions or interfaces. These common types must be identical by name, kind and field across all services. PR #3063
  • apollo-server-express: Use the Express send method, rather than calling net.Socket.prototype.end. PR #2842
  • apollo-server-hapi: Update internal dependencies to use scoped packages @hapi/accept and @hapi/boom, in place of accept and boom respectively. PR #3089

v2.7.2

See complete versioning details.

  • apollo-engine-reporting: Fix reporting errors from backend. (The support for federated metrics introduced in v2.7.0 did not properly handle GraphQL errors from the backend; all users of federated metrics should upgrade to this version.) PR #3056 Issue #3052
  • apollo-engine-reporting: Clean up SIGINT and SIGTERM handlers when EngineReportingAgent is stopped; fixes 'Possible EventEmitter memory leak detected' log. PR #3090

v2.7.1

See complete versioning details.

  • apollo-engine-reporting: If an error is thrown by a custom variable transform function passed into the reporting option sendVariableValues: { transform: ... }, all variable values will be replaced with the string [PREDICATE_FUNCTION_ERROR].
  • apollo-server-express: Typing fix for the connection property, which was missing from the ExpressContext interface. PR #2959
  • @apollo/gateway: Ensure execution of correct document within multi-operation documents by including the operationName in the cache key used when caching query plans used in federated execution. PR #3084

v2.7.0

See complete versioning details.

  • apollo-engine-reporting: Behavior change: By default, send no GraphQL variable values to Apollo's servers instead of sending all variable values. Adding the new EngineReportingOption sendVariableValues to send some or all variable values, possibly after transforming them. This replaces the privateVariables option, which is now deprecated. PR #2931

    To maintain the previous behavior of transmitting all GraphQL variable values, unfiltered, to Apollo Engine, configure engine.sendVariableValues as follows:

    engine: {
      sendVariableValues: { all: true }
    }
  • apollo-engine-reporting: Behavior change: By default, send no GraphQL request headers and values to Apollo's servers instead of sending all. Adding the new EngineReportingOption sendHeaders to send some or all header values. This replaces the privateHeaders option, which is now deprecated. PR #2931

    To maintain the previous behavior of transmitting all GraphQL request headers and values, configure engine.sendHeaders as following:

    engine: {
      sendHeaders: { all: true }
    }
  • apollo-engine-reporting: Behavior change: If the error returned from the engine.rewriteError hook has an extensions property, that property will be used instead of the original error's extensions. Document that changes to most other GraphQLError fields by engine.rewriteError are ignored. PR #2932

  • apollo-engine-reporting: Behavior change: The engine.maskErrorDetails option, deprecated by engine.rewriteError in v2.5.0, now behaves a bit more like the new option: while all error messages will be redacted, they will still show up on the appropriate nodes in a trace. PR #2932

  • apollo-server-core, @apollo/gateway: Introduced managed federation support. For more information on managed federation, see the blog post or jump to the documentation for managed federation.

  • @apollo/gateway@0.7.1: Don't print a warning about an unspecified "graph variant" (previously, and in many ways still, known as "schema tag") every few seconds. We do highly recommend specifying one when using the Apollo Platform features though! PR #3043

  • graphql-playground: Update to resolve incorrect background color on tabs when using the light theme. PR #2989 Issue #2979

  • graphql-playground: Fix "Query Planner" and "Tracing" panels which were off the edge of the viewport.

  • apollo-server-plugin-base: Fix GraphQLRequestListener type definitions to allow return void. PR #2368

v2.6.7

See complete versioning details.

  • apollo-server-core: Guard against undefined property access in isDirectiveDefined which resulted in "Cannot read property 'some' of undefined" error. PR #2924 Issue #2921

v2.6.6

See complete versioning details.

  • apollo-server-core: Avoid duplicate cacheControl directives being added via isDirectiveDefined, re-landing the implementation reverted in v2.6.1 which first surfaced in v2.6.0. PR #2762 Reversion PR #2754 Original PR #2428
  • apollo-server-testing: Add TypeScript types for apollo-server-testing client. PR #2871
  • apollo-server-plugin-response-cache: Fix undefined property access attempt which occurred when an incomplete operation was received. PR #2792 Issue #2745

v2.6.5

See complete versioning details.

  • apollo-engine-reporting: Simplify the technique for capturing operationName. PR #2899
  • apollo-server-core: Fix regression in 2.6.0 which caused engine: false not to disable Engine when the ENGINE_API_KEY environment variable was set. PR #2850
  • @apollo/federation: Introduced a README.md. PR #2883
  • @apollo/gateway: Introduced a README.md. PR #2883

v2.6.4

See complete versioning details.

  • @apollo/gateway: Pass context through to the graphql command in LocalGraphQLDataSource's process method. PR #2821
  • @apollo/gateway: Fix gateway not sending needed variables for subqueries not at the root level. PR #2867
  • @apollo/federation: Allow matching enums/scalars in separate services and validate that enums have matching values. PR #2829.
  • @apollo/federation: Strip @external fields from interface extensions. PR #2848
  • @apollo/federation: Add support for list type keys in federation. PR #2841
  • @apollo/federation: Deduplicate variable definitions for sub-queries. PR #2840

v2.6.3

See complete versioning details.

  • apollo-engine-reporting: Set forbiddenOperation and registeredOperation later in the request lifecycle. PR #2828
  • apollo-server-core: Add queryHash to GraphQLExecutor for federation. PR #2822
  • @apollo/federation: Preserve descriptions from SDL of federated services. PR #2830

v2.6.2

  • apollo-engine-reporting-protobuf: Update protobuf to include forbiddenOperations and registeredOperations. PR #2768
  • apollo-server-core: Add forbiddenOperation and registeredOperation to GraphQLRequestMetrics type. PR #2768
  • apollo-engine-reporting: Set forbiddenOperation and registeredOperation on trace if the field is true on requestContext.metrics. PR #2768
  • apollo-server-lambda: Remove Object.fromEntries usage. PR #2787

v2.6.1

  • Revert: Don't add cacheControl directive if one has already been defined. Presently, although the TypeScript don't suggest it, passing a String as typeDefs to ApolloServer is supported and this would be a breaking change for non-TypeScript users. PR #2428

v2.6.0

  • apollo-server-core: Introduce new didEncounterErrors life-cycle hook which has access to unformatted errors property on the requestContext, which is the first positional parameter that this new request life-cycle receives. PR #2719
  • apollo-server-core: Allow request pipeline life-cycle hooks (i.e. plugins) to modify the response's http.status code (an integer) in the event of an error. When combined with the new didEncounterErrors life-cycle hook (see above), this will allow modifying the HTTP status code in the event of an error. PR #2714
  • apollo-server-lambda: Set callbackWaitsForEmptyEventLoop to false for OPTIONS requests to return as soon as the callback is triggered instead of waiting for the event loop to empty. PR #2638
  • apollo-server: Support onHealthCheck in the ApolloServer constructor in the same way as cors is supported. This contrasts with the -express, -hapi, etc. variations which accept this parameter via their applyMiddleware methods and will remain as-is. PR #2672
  • core: Expose SHA-512 hex hash digest of the Engine API key to plugins, when available, as engine.apiKeyHash. PR #2685 PR #2736
  • apollo-datasource-rest: If another Content-type is already set on the response, don't overwrite it with application/json, allowing the user's initial Content-type to prevail. PR #2520
  • Don't add cacheControl directive if one has already been defined. PR #2428
  • apollo-cache-control: Do not respond with Cache-control headers if the HTTP response contains errors. PR #2715
  • apollo-server-core: Skip loading util.promisify polyfill in Node.js engines >= 8.0 PR #2278
  • apollo-server-core: Lazy load subscriptions-transport-ws in core PR #2278
  • apollo-server-cache-redis: BREAKING FOR USERS OF apollo-server-cache-redis (This is a package that must be updated separately but shares the same CHANGELOG.md with Apollo Server itself.) A new major version of this package has been published and updated to support Redis Standalone, Cluster and Sentinel modes. This is a breaking change since it is now based on ioredis instead of node_redis. Although this update is compatible with the most common uses of apollo-server-cache-redis, please check the options supported by ioredis while updating to this version. The constructor options are passed directly from RedisCache to the new Redis adapter. The pre-1.0 versions should continue to work with Apollo Server without modification. PR #1770

v2.5.1

  • Upgrade GraphQL Playground to the latest upstream release. This release also includes a new "Query Plan" panel for displaying the query planning results when running the Apollo Gateway.

v2.5.0

New

  • New plugin package apollo-server-plugin-response-cache implementing a full query response cache based on apollo-cache-control hints. The implementation added a few hooks and context fields; see the PR for details. There is a slight change to cacheControl object: previously, cacheControl.stripFormattedExtensions defaulted to false if you did not provide a cacheControl option object, but defaulted to true if you provided (eg) cacheControl: {defaultMaxAge: 10}. Now stripFormattedExtensions defaults to false unless explicitly provided as true, or if you use the legacy boolean cacheControl: true. For more information, read the documentation. PR #2437
  • Add rewriteError option to EngineReportingOptions (i.e. the engine property of the ApolloServer constructor). When defined as a function, it will receive an err property as its first argument which can be used to manipulate (e.g. redaction) an error prior to sending it to Apollo Engine by modifying, e.g., its message property. The error can also be suppressed from reporting entirely by returning an explicit null value. For more information, read the documentation and the EngineReportingOptions API reference. maskErrorDetails is now deprecated. PR #1639
  • apollo-server-azure-functions: Support @azure/functions to enable Apollo Server Typescript development in Azure Functions. PR #2487
  • Allow GraphQLRequestListener callbacks in plugins to depend on this. PR #2470
  • apollo-server-testing: Add variables and operationName to Query and Mutation types. PR #2307 Issue #2172

Bug fixes

  • Add cache-control: no-cache header to both PersistedQueryNotSupportedError and PersistedQueryNotFoundError responses as these should never be cached. PR #2452
  • apollo-datasource-rest: Don't attempt to parse "204 No Content" responses as JSON. PR #2446
  • apollo-server-express: Fix Playground URL when Apollo Server is mounted inside of another Express app by utilizing req.originalUrl. PR #2451
  • apollo-datasource-rest: Correctly allow a TTL value of 0 to represent "not-cacheable". PR #2588
  • apollo-datasource-rest: Fix Invalid argument in IE11, when this.headers is undefined. PR #2607

v2.4.8

  • No functional changes in this version. The patch version has been bumped to fix the README.md displayed on the npm package for apollo-server as a result of a broken publish. Apologies for the additional noise!

v2.4.7

  • Fix typings which incorrectly included cors as part of the constructor options for apollo-server-express (it should be defined via applyMiddleware) but, conversely, inadvertently omitted the perfectly valid cors option from the apollo-server constructor (where applyMiddleware is not used/available). PR #2373 Issue #1882

v2.4.6

v2.4.5

  • apollo-server-express: Export ExpressContext PR #2352

v2.4.4

  • Fix typing for ContextFunction incorrectly requiring the context object the function produces to match the parameters of the function PR #2350

v2.4.3

  • apollo-server-lambda: Fix typings which triggered "Module has no default export" errors. PR #2230
  • apollo-server-koa: Support OPTIONS requests PR #2288
  • Add req and res typings to the ContextFunction argument for apollo-server and apollo-server-express. Update ContextFunction return type to allow returning a value syncronously. PR #2330
  • Type the formatError function to accept an GraphQLError as an argument and return a GraphQLFormattedError PR #2343

v2.4.2

  • apollo-server-fastify is now on Apollo Server and lives within the apollo-server repository. This is being introduced in a patch version, however it's a major version bump from the last time apollo-server-fastify was published under 1.0.2. PR #1971
  • Move apollo-graphql package to the apollo-tooling repository PR #2316

v2.4.1

  • Fix inaccurate total duration in apollo-tracing PR #2298
  • Avoid importing entire crypto dependency tree if not in Node.js. PR #2304
  • Allow passing parseOptions to ApolloServerBase constructor. PR #2289
  • Rename azureFunctions.d.ts to azureFunctions.ts. PR #2287
  • Require apollo-engine-reporting only if EngineReportingAgent used. PR #2305

v2.4.0

  • Implement an in-memory cache store to save parsed and validated documents and provide performance benefits for repeat executions of the same document. PR #2111 (>=2.4.0-alpha.0)
  • Fix: Serialize arrays as JSON on fetch in RESTDataSource. PR #2219
  • Fix: The privateHeaders configuration for apollo-engine-reporting now allows headers to be specified using any case and lower-cases them prior to comparison. PR #2276
  • Fix broken apollo-server-azure-functions TypeScript definitions. PR #2287

v2.3.3

  • apollo-server (only): Stop double-invocation of serverWillStart life-cycle event. (More specific integrations - e.g. Express, Koa, Hapi, etc. - were unaffected.) PR #2239
  • Avoid traversing graphql-upload module tree in run-time environments which aren't Node.js. PR #2235

v2.3.2

  • Switch from json-stable-stringify to fast-json-stable-stringify. PR #2065

  • Fix cache hints of maxAge: 0 to mean "uncachable". #2197

  • Apply defaultMaxAge to scalar fields on the root object. #2210

  • Don't write to the persisted query cache until execution will begin. PR #2227

  • apollo-server-azure-functions: Added Azure Functions documentation and deployment examples PR #2131, Issue #2092

v2.3.1

  • Provide types for graphql-upload in a location where they can be accessed by TypeScript consumers of apollo-server packages. ccf935f9 Issue #2092

v2.3.0

  • BREAKING FOR NODE.JS <= 8.5.0 ONLY: To continue using Apollo Server 2.x in versions of Node.js prior to v8.5.0, file uploads must be disabled by setting uploads: false on the ApolloServer constructor options. Without explicitly disabling file-uploads, the server will throw at launch (with instructions and a link to our documentation).

    This early deprecation is due to changes in the third-party graphql-upload package which Apollo Server utilizes to implement out-of-the-box file upload functionality. While, in general, Apollo Server 2.x aims to support all Node.js versions which were under an LTS policy at the time of its release, we felt this required an exception. By throw-ing when uploads is not explicitly set to false, we aim to make it clear immediately (rather than surprisingly) that this deprecation has taken effect.

    While Node.js 6.x is covered by a Long Term Support agreement by the Node.js Foundation until April 2019, there are substantial performance (e.g. V8 improvements) and language changes (e.g. "modern" ECMAScript support) offered by newer Node.js engines (e.g. 8.x, 10.x). We encourage all users of Apollo Server to update to newer LTS versions of Node.js prior to the "end-of-life" dates for their current server version.

    We intend to drop support for Node.js 6.x in the next major version of Apollo Server.

    For more information, see PR #2054 and our documentation.

v2.2.7

  • apollo-engine-reporting: When multiple instances of apollo-engine-reporting are loaded (an uncommon edge case), ensure that encodedTraces are handled only once rather than once per loaded instance. PR #2040

v2.2.6

  • apollo-server-micro: Set the Content-type to text/html for GraphQL Playground. PR #2026

v2.2.5

  • Follow-up on the update to graphql-playground-html in previous release by also bumping the minor version of the graphql-playground-react dependency to 1.7.10 — which is the version requested from the from the CDN bundle by graphql-playground-html. PR #2037

v2.2.4

  • Fix GraphQL Playground documentation scrolling bug in Safari by updating to latest (rebased) fork of graphql-playground-html. PR #2037

v2.2.3

  • When generateClientInfo is not used to define the client name, client version and client reference ID, Apollo Server will now default to the values present in the HTTP headers of the request (apollographql-client-name, apollographql-client-reference-id and apollographql-client-version respectively). As a last resort, when those headers are not set, the query extensions' clientInfo values will be used. PR #1960

v2.2.2

  • Fixed TypeScript 2.2 compatibility via updated apollo-tooling dependency. Issue #1951 26d6c739
  • Throw a more specific error when asynchronous introspection query behavior is detected. PR #1955

v2.2.1

  • Added support for an array of modules on the ApolloServer constructor options. Each element of the modules can point to a module which exports typeDefs and resolvers. These modules can be used in lieu of, or in combination with, directly specifying schema or typeDefs/resolvers on the constructor options. This provides greater modularity and improved organization for logic which might be limited to a specific service. 8f6481e6.
  • Added resolveObject support to query execution. bb67584.
  • Fix broken apollo-server-cloud-functions in 2.2.0 caused by missing TypeScript project references which resulted in the package not being published to npm in compiled form. PR #1948

v2.2.0

  • New request pipeline, including support for plugins which can implement lifecycle hooks at various stages of a request. PR #1795.
  • Introduce new apollo-server-testing utilities. PR #1909
  • Fix mocks configuration to allow disabling of mocks by using mocks: false, even if mockEntireSchema is true. PR #1835
  • Update graphql-playground-html to 1.7.8. PR #1855
  • Bring back Azure functions support Issue #1752 PR #1753
  • Allow an optional function to resolve the rootValue, passing the DocumentNode AST to determine the value. PR #1555
  • Follow-up on the work in PR #1516 to also fix missing insertion cursor/caret when a custom GraphQL configuration is specified which doesn't specify its own cursorShape property. PR #1607
  • Azure functions support Issue #1752 PR #1753 PR #1948
  • Allow JSON parsing in RESTDataSource of Content Type application/hal+json. PR #185
  • Add support for a requestAgent configuration parameter within the engine configuration. This can be utilized when a proxy is necessary to transmit tracing and metrics data to Apollo Engine. It accepts either an http.Agent or https.Agent and behaves the same as the agent parameter to Node.js' http.request. PR #1879
  • Allow an optional parameter to the RESTDataSource constructor which takes a node-fetch-compatible fetch implementation that will be used for HTTP calls instead of the default fetch. PR #1807

v2.1.0

  • Updated the google-cloud-functions package to handle null paths PR #1674
  • Update link inside Authentication Docs PR #1682
  • Fix making sure all headers are getting reported to Engine properly when using privateHeaders PR #1689
  • (experimental, subject to change/removal) Provide ability to specify client info in traces #1631

v2.0.8

  • Reporting: Catch Error if JSON.Stringify Fails for Engine Trace PR #1668
  • Core: Allow context to be passed to all GraphQLExtension methods. PR #1547

v2.0.7

  • Fix #1581 apollo-server-micro top level error response #1619
  • Switch ApolloServerBase.schema from private access to protected access. #1610
  • Add toggle for including error messages in reports #1615
  • Fix apollo-server-cloud-functions tests #1611

v2.0.6

  • Update graphql-playground-html to 1.7.4 #1586
  • Add support for graphql-js v14 by augmenting typeDefs with the @cacheControl directive so SDL validation doesn't fail #1595
  • Add node-fetch extensions typing to RequestInit #1602

v2.0.5

  • Google Cloud Function support #1402 #1446
  • Switch to a fork of apollo-upload-server to fix missing core-js dependency. #1556

v2.0.4

  • apollo-server: Release due to failed build and install

v2.0.3

  • apollo-server: failed publish
  • pass payload into context function for subscriptions #1513
  • Add option to mock the entire schema(i.e. sets preserveResolvers) PR #1546

v2.0.2

  • Release with Lerna 3 due
  • Hapi: Allow additional route options to be passed to Hapi.js plugin. PR #1384
  • express, koa: remove next after playground #1436
  • Hapi: Pass the response toolkit to the context function. #1407
  • update apollo-engine-reporting-protobuf to non-beta #1429
  • playground would use its own settings as default #1516
  • Lambda: Look in event.path first when picking endpoint for GraphQL Playground #1527
  • Fix to allow enabling GraphQL Playground in production with custom config #1495

v2.0.1

  • This version failed to publish fully/correctly and should not be used.

v2.0.0-rc.10

  • Fix and Export Extension and Playground Types #1360
  • Pin internal dependencies #1361

v2.0.0-rc.9

  • This version failed to publish fully/correctly and should not be used.

v2.0.0-rc.8

  • export GraphQLUpload from integrations #1322
  • add cors to vanilla #1335
  • export bodyParser.Options to koa #1334
  • add and use playground in ApolloServer constructor #1297
  • breaking: remove calculate headers as function #1337
  • breaking: remove formatParams #1331

v2.0.0-rc.7

  • enable engine reporting from lambda #1313
  • remove flattening of errors #1288
  • dynamic url in datasourece (#1277)

v2.0.0-rc.6

  • BREAKING: errors are passed to user extensions, then engine reporting, and finally formatError (#1272)
  • formatError only called once on validation errors (#1272)
  • BREAKING: apollo-server-env does place types in global namespace (#1259)
  • export Request from apollo-datasource-rest and graphql-extensions (53d7a75 c525818)
  • Use scoped graphql-playground and centralize version (8ea36d8, 84233d2)
  • fix dependencies + exports (#1257)
  • fix data source + context cloning (7e35305)
  • use fetch instead of Node request for engine-reporting (#1274)

v2.0.0-rc.5

  • fix formatError to keep prototype of Error (#1235)

v2.0.0-rc.4

  • Add trailing slash to data source
  • allow body passed to data source
  • new apollo-engine-reporting agent

v2.0.0-rc.3

  • graphql as peerDependency (#1232)
  • APQ in batches (#1234)
  • APQ hits/misses in traces

v2.0.0-rc.2

  • Missing apollo-upload-server dependency (#1221)
  • encode trace report over each request in apollo-engine-reporting

v2.0.0-rc.1

  • BREAKING: remove logFunction (71a403d), see this commit for an implementation
  • move upload option to constructor (#1204)
  • fixed hapi gui bugs (#1211)
  • remove requirement for exModuleInterop (#1210)
  • change BadUserInputError to UserInputError (#1208)
  • add cache-control headers for CDN integration (#1138)
  • Lambda support (thanks to @adnsio, @bwlt, and @gragio #1138)

Data sources

  • add memcache and redis support (#1191)
  • add patch method (#1190)

v2.0.0-rc.0

  • Breaking: registerServer changed to server.applyMiddleware (3279991)
  • Breaking: subscriptions enabled with installSubscriptionHandlers
  • Add Data Sources (#1163)

v2.0.0-beta.4

  • Bug fix to allow async context (#1129)
  • logFunction is now an extension (#1128)
  • Allow user defined extensions and include engine reporting (#1105)

v2.0.0-beta.3

  • remove registerServer configuration from apollo-server's listen (#1090)
  • move healthcheck into variants (#1086)
  • Add file uploads, breaking requires removing scalar Upload from the typeDefs (#1071)
  • Add reporting to Engine as apollo-engine-reporting (#1105)
  • Allow users to define extensions (#1105)

v2.0.0-beta.2

ListenOptions:

  • engine -> engineProxy

  • port, host, and other http options moved under http key (#1080)

  • subscriptions moved to server.listen (#1059)

  • Add mocks to server constructor (#1017)

  • Add bodyParserConfig parameter to registerServer in apollo-server (#1059) commit

  • Hapi variant (#1058) (#1082)

  • Remove tests and guaranteed support for Node 4 PR #1024

  • Cleanup docs PR #1233

1.4.0

  • [Issue #626] Integrate apollo-fastify plugin. PR #1013
  • add hapi 16 next() invocation PR #743
  • Add skipValidation option PR #839
  • apollo-server-module-graphiql: adds an option to the constructor to disable url rewriting when editing a query PR #1047
  • Upgrade subscription-transport-ws to 0.9.9 for Graphiql

v1.3.6

  • Recognize requests with Apollo Persisted Queries and return PersistedQueryNotSupported to the client instead of a confusing error. PR #982

v1.3.5

  • apollo-server-adonis: The Content-type of an operation response will now be correctly set to application/json. PR #842 PR #910
  • apollo-server-azure-functions: Fix non-functional Azure Functions implementation and update examples in Azure Functions' README.md. PR #753 Issue #684
  • Fix TypeError on GET requests with missing query parameter. PR #964
  • The typing on the context of GraphQLServerOptions now matches the equivilent type used by graphql-tools. PR #919
  • Middleware handlers now used named (rather than anonymous) functions to enable easier identification during debugging/profiling. PR #827
  • The npm-check-updates package has been removed as a "dev dependency" which was resulting in an older version of npm being used during testing. PR #959
  • The typing on HttpQueryRequest's query attribute now enforces that its object properties' keys be Strings. PR #834
  • TypeScript types have been updated via updates to @types/node, @types/connect, @types/koa and @types/aws-lambda.

v1.3.4

  • Upgrade to apollo-cache-control@0.1.0 and allow you to specify options to it (such as the new defaultMaxAge) by passing cacheControl: {defaultMaxAge: 5} instead of cacheControl: true.

v1.3.3

  • Updated peer dependencies to support graphql@0.13.x.
  • apollo-server-express: The GraphQLOptions type is now exported from apollo-server-express in order to facilitate type checking when utilizing graphqlExpress, graphiqlExpress, graphqlConnect and graphiqlConnect. PR #871
  • Update GraphiQL version to 0.11.11. PR #914

v1.3.2

  • Updated peer dependencies and tests to support graphql@0.12.
  • Fix issue where the core runQuery method broke the ability to use the Node async_hooks feature's call stack. PR #733
  • Hoist declarations of rarely used functions out of doRunQuery to improve performance. PR# 821

v1.3.1

  • Fixed a fatal execution error with the new graphql@0.12.

v1.3.0

  • Breaking: apollo-server-hapi: now supports Hapi v17, and no longer supports Hapi v16. For information on running Apollo Server 1.x with Hapi v16, check this documentation.
  • New package: apollo-server-adonis supporting the Adonis framework!
  • The graphqlOptions parameter to server GraphQL integration functions now accepts context as a function and as an object with a prototype. PR #679
  • apollo-server-express: Send Content-Length header.
  • apollo-server-micro: Allow Micro 9 in peerDependencies. PR #671
  • GraphiQL integration:
    • Recognize Websocket endpoints with secure wss:// URLs.
    • Only include truthy values in GraphiQL URL.

v1.2.0

  • New feature: Add support for Apollo Cache Control. Enable apollo-cache-control by passing cacheControl: true to your server's GraphQL integration function.
  • Include README.md in published npm packages.

v1.1.7

  • Added support for the vhost option for Hapi PR #611
  • Fix dependency on apollo-tracing to be less strict.

v1.1.6

  • GraphiQL integration: add support for websocketConnectionParams for subscriptions. #452 PR 548

(v1.1.4 had a major bug and was immediately unpublished. v1.1.5 was identical to v1.1.6.)

v1.1.3

  • GraphiQL integration: Fixes bug where CORS would not allow Access-Control-Allow-Origin: * with credential 'include', changed to 'same-origin' Issue #514
  • Updated peer dependencies to support graphql@0.11.

v1.1.2

v1.1.1

  • Added support for Azure Functions #503

v1.1.0

  • Added ability to provide custom default field resolvers #482
  • Add tracing option to collect and expose trace data in the Apollo Tracing format
  • Add support for GraphiQL editor themes in #484 as requested in #444
  • Add support for full websocket using GraphiQL #491
  • Updated restify lib (@yucun) in #472
  • Updated package apollo-server-micro, updated micro in devDependencies and peerDependencies to ^8.0.1

v1.0.3

  • Revert #463, because it's a breaking change that shouldn't have been a patch update.

v1.0.2

  • Rename packages from graphql-server- to apollo-server- #465. We'll continue to publish graphql-server- packages that depend on the renamed apollo-server- packages for the time being, to ensure backwards compatibility.

v1.0.1

  • Fix Express package not calling the callback on completion (@chemdrew) in #463

v1.0.0

  • Add package readmes for Express, Hapi, Koa, Restify (@helfer) in #442
  • Updated & fixed typescript typings (@helfer) in #440

v0.9.0

  • Allow GraphiQLOptions to be a function (@NeoPhi) on #426

v0.8.5

  • Fix: graphql-server-micro now properly returns response promises #401

v0.8.4

v0.8.3

v0.8.2

  • Fix issue with auto-updating dependencies that caused fibers to update accidentally (@helfer) on #425

v0.8.1

  • Security Fix Ensure queries submitted via HTTP GET run through validation (@DxCx) on #424

v0.8.0

  • Persist window.location.hash on URL updates #386
  • Added support for graphql-js > 0.10.0 #407
  • Updated subscriptions-transport-ws for GraphiQL with subscriptions #407

v0.7.2

  • Fix include passHeader field that was accidentally removed

v0.7.1

  • Fix graphiql fetcher to use endpointURL parameter instead of hardcoded URI.#365

v0.7.0

  • Add Zeit Micro Integration #324
  • add support for subscriptionURL to GraphiQL (@urigo on #320
  • Restify: Fix for calling next() (@jadkap) on #285
  • Breaking: Update all dependencies #329

v0.6.0

v0.5.1

  • add support for HTTP GET Method (@DxCx) on #180

v0.5.0

  • Switch graphql typings for typescript to @types/graphql #260

v0.4.4

  • Update GraphiQL to version 0.8.0 (@DxCx) on #192
  • Upgrade to GraphQL-js 0.8.1.

v0.4.2

  • Restructure Apollo Server into 6 new packages, and rename to GraphQL Server (@DxCx) and (@stubailo) in #183 and #164.
  • There are now 6 packages that make up the GraphQL server family:
    • graphql-server-core
    • graphql-module-graphiql
    • graphql-module-operation-store
    • graphql-server-express
    • graphql-server-hapi
    • graphql-server-koa
  • Exports have been renamed. Everything that used to export apollo* now exports graphql*, for example apolloExpress has become graphqlExpress.
  • The repository is now managed using Lerna.

v0.3.3

  • Fix passHeader option in GraphiQL (Both Hapi and Koa)
  • Pass ctx instead of ctx.request to options function in Koa integration (@HriBB) in PR #154
  • Manage TypeScript declaration files using npm. (@od1k in #162)
  • Fix connect example in readme. (@conrad-vanl in #165)
  • Add try/catch to formatError. (@nicolaslopezj in #174)
  • Clone context object for each query in a batch.

v0.3.2

v0.3.1

  • Fixed dependency issue with boom package that affected the hapi integration. (@sammkj in #150)

v0.3.0

  • Refactor Hapi integration to improve the API and make the plugins more idiomatic. (@nnance) in PR #127
  • Fixed query batching with Hapi integration. Issue #123 (@nnance) in PR #127
  • Add support for route options in Hapi integration. Issue #97. (@nnance) in PR #127
  • Camelcase Hapi. Issue #129. (@nnance) in PR #132
  • Fix error handling when parsing variables parameter. Issue #130. (@nnance) in PR #131
  • Improve logging function. Issue #79. (@nnance) in PR #136
  • Output stack trace for errors in debug mode. Issue #111. (@nnance) in PR #137
  • Allow to pass custom headers in GraphiQL (@nicolaslopezj in #133).

v0.2.6

  • Expose the OperationStore as part of the public API. (@nnance)
  • Support adding parsed operations to the OperationStore. (@nnance)
  • Expose ApolloOptions as part of the public API.

v0.2.5

  • Made promise compatible with fibers (@benjamn in #92)

v0.2.2

  • Log server events such as request start etc. with logFunction (@helfer in #78)

v0.2.1

  • Complete refactor of Apollo Server using TypeScript. PR #41
  • Added Hapi integration (@nnance in #46)
  • Added Koa integration (@HriBB in #59)
  • Changed express integration to support connect as well (@helfer in #58)
  • Dropped express-graphql dependency
  • Dropped support for GET requests, only POST requests are allowed now
  • Split GraphiQL into a separate middleware
  • Factored out core to support Hapi, Koa and connect implementations
  • Added support for query batching
  • Added support for query whitelisting / stored queries
  • Removed body parsing from express integration. Body must be parsed outside of apollo now
  • Added formatRequest and formatResponse functions to apollo options.
  • Removed support for shorthand schema definitions, connectors and mocks (use graphql-tools instead)

v0.1.5

  • BUG: Fixed a spelling error with tracer.submit() from PR #26 in PR #31

v.0.1.4

  • BUG: Fixed a bug with tracer mocks that would throw a TypeError when using Ava #26

v0.1.3

  • Updated graphql dependency to 0.6.0