Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@apollographql/apollo-tools

apollographql4.6mMIT0.5.4TypeScript support: included

null

readme

packages/apollo/README.md

changelog

CHANGELOG

Note: Apollo's GraphQL VSCode extension is no longer housed in this repository. It is now maintained separately in this repo.

vNEXT

  • Nothing yet! Stay tuned.

`apollo@2.33.11`

  • This release includes a number of updates for dependencies within this repo's projects. Behavior changes aren't expected and should be considered reportable issues.

  • apollo-language-server

    • Remove moment as a dependency #2595

`apollo@2.33.10`

`apollo@2.33.9`

`apollo@2.33.8`

`apollo@2.33.7`

`apollo@2.33.6`

`apollo@2.33.5`

`apollo@2.33.2`

`apollo@2.32.5`

`apollo@2.32.4`

  • This version should not be used as it was published without depended-on packages. Please use `apollo@2.32.5` instead.

`apollo@2.32.3`

  • This version was not actually published.

`apollo@2.32.3`

  • This version was not actually published.

`apollo@2.32.1`

  • apollo-codegen-swift
    • Fix issue where a query referencing many fragments caused type checking for queryDocument to time out #2198

`apollo@2.32.0`

  • `apollo@2.32.0`
    • Support the standard HTTP_PROXY, HTTPS_PROXY, and NO_PROXY environment variables for using an HTTP proxy. #2181

`apollo@2.31.2`

  • apollo-codegen-swift
    • Fix bug in generated compound type names that lead to structName being inconsistent throughout codegen #2170

`apollo@2.31.1`

  • Update CLI default API domain from engine-graphql.apollographql.com to graphql.api.apollographql.com. Users that have set up support for corporate proxies or firewalls may need to update configurations.
  • Accept GitLab remote URLs when fetching git info for service:check and service:push #2104
  • --commitId in service:check and service:push overrides the current commit ID otherwise read through env-ci.
  • service:push now takes --author and --branch matching service:check.

`apollo-graphql@0.6.0`

  • Rename defaultEngineReportingSignature to defaultUsageReportingSignature; the old name continues to be exported as well.

`apollo@2.30.2`

  • apollo-codegen-core
    • Add new unionTypes and interfaceTypes properties to the exported IR JSON (when using the json-modern target), that list all unions and their types, as well as all interfaces and their implementing types #2050.

`apollo@2.30.1`

`apollo@2.30.0`

  • `apollo@2.30.0`
    • Allow flags for --branch and --author in service:check command. This will permit users to group changes using the --branch flag and indicate an author, via a string value using the --author flag.

`apollo@2.29.1`

** Note: this release is an immediate follow-up to the previous release. apollo-graphql should've been updated but it was unfortunately missed. **

`apollo@2.29.0`

`apollo@2.28.3`

`apollo@2.28.2`

`apollo@2.28.1`

`apollo@2.27.3`

  • `apollo@2.27.4`
    • Change json-modern target to use legacy IR as base, similar to json target #1916.
    • Update json-modern IR to expose typeNodes on typesUsed #1916
  • `apollo-codegen-core@0.36.9`
    • Change json-modern target to use legacy IR as base, similar to json target #1916.
    • Update json-modern IR to expose typeNodes on typesUsed #1916

`apollo@2.27.2`

`apollo@2.27.0`

  • `apollo@2.27.0`
    • downgrade mkdirp to keep node 8 working as expected 63f0773
    • Remove "hidden: true" from --variant in service:push #1865
    • update ENGINE_API_KEY deprecation message to give alternative #1866
    • Add json-modern codegen target which adds typeNodes (ast type nodes) to codegen output #1846
  • `apollo-codegen-core@0.36.6`
    • Add json-modern target which adds typeNodes (ast type nodes) to codegen output #1846

`apollo@2.26.0`

  • `apollo@2.26.0`
    • Support APOLLO_KEY and deprecate ENGINE_API_KEY for .env support #1851
    • Support --graph/-v flag for specifying graph manager id without requiring a config file #1858
    • Support graph@variant parsing under the service.name key in config files, similar to client configs #1858
    • Update all commands that supported --tag to prefer --variant and indicate a deprecation warning for --tag #1849
    • Updates of --help messages #1849
    • Bug fix of some apollo commands that did not work with graph@variant parsing within the apollo.config.js #1849
    • Improved error messaging when a graph is not specified in either apollo.config.js or within the API key. #1849
    • Added --ignoreFailures flag to service:check to exit with code 0 with check failures #1856
    • Make Update "no service found to link..." error more consistent #1847
    • Fix non-existent service message to use the actual service name that's being looked up #1834
  • `apollo-language-server@1.21.0`
    • Support APOLLO_KEY and deprecate ENGINE_API_KEY for .env support #1851
    • Support graph@variant parsing under the service.name key in config files, similar to client configs #1858
    • Improved error messaging when a graph is not specified in either apollo.config.js or within the API key. #1849
    • Make Update "no service found to link..." error more consistent #1847
    • Fix non-existent service message to use the actual service name that's being looked up #1834

`apollo@2.25.0`

`apollo@2.24.0`

`apollo@2.23.0`

  • apollo
    • Fix rendering of unexpected composition errors throwing a table cell error #1806
    • Add ability to define schema download output path that doesn't exist yet #1807

`apollo@2.22.1`

`apollo@2.22.0`

`apollo@2.21.3`

`apollo@2.21.2`

`apollo@2.21.1`

  • `apollo@2.21.1`
    • Add sdl download ability to client:download-schema #1470
    • colors: use cyan instead of blue for text highlighting #1598
    • Fix codegen --watch breaking out of watch mode on validation errors #1627
  • `apollo-env@0.6.0`
    • POTENTIALLY BREAKING: Make apollo-env a standard TS package #1611 This PR likely warrants a pre-major version bump so that it isn't accidentally upgraded to for dependents using the ^ range. If this breaks your project, please don't hesitate to let us know and revert back to v0.5.1. This PR removes the handwritten node-fetch types and instead just re-exports them. Internally, this drastically simplifies the existence of apollo-env within this monorepo, as it no longer requires a special build step that forces lerna and TS to work around it.
  • `vscode-apollo@1.12.1`
    • Fix client localSchemaFile for vscode stats command #1634

`apollo@2.21.0`

`apollo@2.20.0`

`apollo@2.19.1`

  • `apollo@2.19.1`
    • Support custom frontend and historic parameters for federated service:check
  • `apollo-codegen-swift@0.35.10`
    • Ensure fields named self don't cause compilation errors in the generated code #1533
    • Preserve leading/trailing underscores on field names #1533
    • Allow generated code to be compiled without a module umbrella header #1248

`apollo@2.19.0`

  • `apollo@2.19.0`
    • Improve performance of CLI when running projects by delaying or not calling validation unnecessarily #1559
    • Use "table" package for tabular output and word wrap support #1524
    • Use new single step mutation for checking federated service schemas #1539
    • Add support for localSchemaFile for federated service commands #1489
  • `apollo-codegen-core@0.35.4`
    • Improve performance of validation when client fields are present or not #1559
  • `apollo-codegen-swift@0.35.9`
    • Switch operations and fragments to default to printing queries as multiline strings rather than including queries as multiline comments
    • Add --suppressSwiftMultilineStringLiterals flag to allow a version which strips unnecessary whitespace.
  • `apollo-graphql@0.3.4`
    • Use reference-equality, rather than Function.prototype.name string comparison, when omitting validation rules within buildSchemaFromSDL. #1551
  • `apollo-language-server@1.16.0`
    • Replace old mutation used for checking partial service schemas to use checkPartialSchema #1539
    • Remove old federation-info provider #1489
    • Support using local schema files for checks/pushes of federated services #1489
  • `vscode-apollo@1.11.0`
    • Improve performance of validation when client fields are present or not #1559

`apollo@2.18.3`

  • apollo
    • fix bad parsing of multiple localSchemaFiles #1529

`apollo@2.18.2`

`apollo@2.18.1`

`apollo@2.18.0,apollo-language-server@1.15.0,apollo-codegen-core@0.35.0,apollo-codegen-typescript@0.35.0,vscode-apollo@1.10.0`

`apollo-language-server@1.14.3`

`apollo-language-server@1.14.2`

`apollo-codegen-swift@0.35.2`

`apollo@2.17.1,apollo-codegen-swift@0.35.1`

`apollo@2.17.0,apollo-codegen-swift@0.35.0`

  • `apollo-codegen-swift@0.35.0`
    • Fix issue where type names were not being properly escaped iOS 193
    • Fix overcorrection on removing redundant modifiers #1449
    • Added CaseIterable conformance so all known cases can be easily iterated.
    • Added comment to operationDefinition to show the original query
    • Stripped excess whitespace out of operationDefinition
    • Removed force-unwrap when the thing being unwrapped is a double optional

`vscode-apollo@1.9.1,apollo-language-server@1.14.1`

`vscode-apollo@1.9.0,apollo-language-server@1.14.0,apollo-codegen-swift@0.34.2`

`apollo@2.16.1,apollo-language-server@1.13.1,vscode-apollo@1.8.1`

`apollo@2.16.0,apollo-codegen-swift@0.34.0,apollo-language-server@1.13.0,apollo-tools@0.4.0,vscode-apollo@1.8.0`

  • `apollo@2.16.0`
    • Add service:list and tests #1358 and header #1377
    • Update service:list test to use a simulated time to prevent relative dates causing snapshot failures #1374
    • Update service:check to support --markdown and --json flags for federated schema #1378
    • Exit status code 1 after composition errors in service:push #1403
    • Update service:check to include graphCompositionId in query params for UI #1401
  • `apollo-codegen-swift@0.34.0`
    • Update Swift codegen to add operation name to generated query classes #1386
    • Append terminating newline character to generated files #531
  • `apollo-language-server@1.13.0`
    • Allow template literal placeholders that span multiple rows#1299
    • Add support for extracting GraphQL documents from Ruby source files using <<-GRAPHQL...GRAPHQL heredoc. #1304
  • `apollo-tools@0.4.0`
    • Handle subscribe in buildServiceDefinition and add type in resolverMap #1047
  • `vscode-apollo@1.8.0`
    • Add support for Ruby source files using <<-GRAPHQL...GRAPHQL heredoc. #1304

`apollo@2.15.0,apollo-language-server@1.12.0`

`apollo-graphql@0.3.3`

`apollo@2.14.0,apollo-language-server@1.11.0,vscode-apollo@1.7.4`

`apollo@2.13.1,apollo-graphql@0.3.2`

`apollo@2.13.0,apollo-language-server@1.10.0`

`apollo@2.12.4,apollo-language-server@1.9.0,vscode-apollo@1.7.0`

`apollo@2.12.3,apollo-language-server@1.8.4`

`apollo@2.12.1,apollo-language-server@1.8.3`

`apollo-codegen-flow@0.33.10,apollo-codegen-typescript@0.34.0,vscode-apollo@1.6.10`

`apollo@2.11.1,apollo-language-server@1.8.1,vscode-apollo@1.6.9`

`apollo@2.11.0,apollo-language-server@1.8.0,apollo-graphql@0.3.0,apollo-language-server@1.8.0,apollo-env@0.5.0`

  • `apollo@2.11.0`
    • Leverage updates to apollo-language-server to support federated services #1251
    • Add service:delete command for deleting federated services #1251
  • `apollo-env@0.5.0`
    • Add new utils and predicates #1251
  • `apollo-graphql@0.3.0`
    • Require graphql@^14.2.1 #1251
    • Add buildSchemaFromSDL and related utilities for constructing partial schemas #1251
    • Add transformSchema and related utilities for easily transforming schemas #1251
  • `apollo-language-server@1.8.0`
    • Fix windows file paths by normalizing all URIs to a consistent format #1213.
    • Fix positionToOffset to consider windows line endings #1213.
    • Extend Engine API for federated schema uploads and checks #1251
    • Reorganize files and exports #1251

`apollo@2.10.3`

`apollo@2.10.2`

`apollo@2.10.1`

`apollo@2.10.0`

  • `apollo@2.10.0`
    • Add client:download-schema command to download schemas from engine to an output file #1108

`apollo@2.9.0,apollo-language-server@1.7.0`

`apollo@2.8.3`

`apollo@2.8.2`

  • `apollo@2.8.2`
    • Update service:check's --markdown output to include clients affected, number of operations checked, pluralization improvements, and backticks around service and schema variant #1164
    • Update service:check output to show failures before passes #1168

`apollo@2.8.1`

`apollo@2.8.0`

`apollo@2.7.0,apollo-vscode@1.6.0`

  • `apollo@2.7.0`
    • Update operation normalization technique to deterministically order fragments within operations. This update affects those users of the operation registry feature of the Apollo Platform. Anyone using the operation registry should re-register their operations with this new version of the apollo CLI via the apollo client:push command. Once all client operations are re-registered, the apollo-server-plugin-operation-manifest plugin within Apollo Server (which reads the manifest published with apollo client:push) should be updated to 0.1.0-alpha.1. #1158
  • `apollo-language-server@1.6.0`
    • Stop loadConfig from looking up the tree when a --config location is defined #1059
    • Refactored/documented/tested loadConfig #1059
    • Add .vue file support for codegen:generate #1160

`apollo-codegen-flow@0.32.11`

`apollo@2.6.2`

`apollo-graphql@0.2.0`

  • `apollo-graphql@0.2.0`
    • Change the sortAST algorithm to sort fragments at the top-level of the DocumentNode, providing a more deterministic normalization of the operation for use by apollo-engine-reporting (which consumes this package's defaultOperationRegistrySignature function). This will more correctly combine operations for Engine reporting. This also adds a defaultOperationRegistrySignature function for use by the apollo-server-plugin-operation-registry plugin to eventually consume. #1112

`apollo@2.6.1,apollo-env@0.4.0`

`apollo@2.6.0,apollo-env@0.3.4,apollo-language-server@1.5.3,apollo-codegen-flow@0.32.9,apollo-codegen-scala@0.33.5,apollo-codegen-swift@0.32.9,apollo-codegen-typescript@0.32.10,apollo-graphql@0.1.2`

`apollo-language-server@1.5.2,vscode-apollo@1.5.2`

`apollo@2.5.2,apollo-language-server@1.5.1,vscode-apollo@1.5.1`

`apollo-codegen-typescript@0.32.7,apollo-codegen-scala@0.33.2,apollo-graphql@1.0.2`

`apollo@2.5.0,apollo-language-server@1.5.0,vscode-apollo@1.5.0`

`apollo@2.4.4,apollo-codegen-scala@0.33.0`

`apollo-env@0.3.1`

`apollo-language-server@1.4.1`

  • apollo-language-server 1.4.1
    • Fix edge case for empty operations #959

`apollo@2.4.1`

  • apollo 2.4.1
    • Bump the apollo-engine-reporting version #950

`apollo@2.4.0,apollo-language-server@1.4.0,vscode-apollo@1.4.1`

  • apollo 2.4.0
    • Fix configuration loading and schema tag support #925
    • Improve client:check output #934
  • apollo-language-server 1.4.0
    • Replace checkOperations mutation with new validateOperations mutation #934
    • Include config files into a project's fileSet #897
    • Add hook into workspace for communicating out when configs are loaded or when errors are found #897
    • Add fn to workspace for reloading a project with a given config URI #897
    • Reload project when config file is changed #897
    • Update error handling from within the server (send as message). This message can be listened for and handled by the consumer #897
  • vscode-apollo 1.4.1
    • Update statusBar to reflect new possible "warning" states #897

`apollo@2.3.1`

`apollo@2.3.0`

`apollo@2.1.9`

`apollo@2.1.8`

`apollo@2.1.7`

`apollo@2.1.6`

`apollo@2.1.5`

`apollo@2.1.4`

`apollo@2.1.3`

`apollo@2.1.1`

`apollo@2.1.0`

`apollo@2.0.17`

`apollo@2.0.16`

`apollo@2.0.15`

`apollo@2.0.14`

`apollo@2.0.13`

`apollo@2.0.12`

`apollo@2.0.11`

`apollo@2.0.10`

`apollo@2.0.9`

`apollo@2.0.8`

`apollo@2.0.7`

`apollo@2.0.6`

`apollo@2.0.5`

`apollo@2.0.4`

  • `apollo@2.0.4`
    • Fixed config to only use service name from the correct key types commit
    • Adjust priority of engine api key parsing to prefer flag over env key commit

`apollo@2.0.3`

`apollo@2.0.2`

`apollo@2.0.1`

  • `apollo@2.0.1`
    • Added better errors around missing services
    • Updated config documentation
    • Fixed failures with missing service name

:tada: `apollo@2.0.0` :tada:

NOTE: Many of the updates and changes in this release came from a complete rebuild of the Apollo CLI in preparation for GraphQL summit. Many of these changes can be traced to this commit but aren't tied to a specific pull request, and won't be linked.

  • `apollo@2.0.0`
    • :rocket: Features
      • queries:register to register operations with the apollo platform #621
      • Update graphql to version 14 #624
      • Supports a .env file for engine API keys commit
    • :bug: Fixes & Changes
      • Fixed config file resolution #591
    • :boom: Breaking Changes
      • Introduced a new apollo.config.js format commit
      • Changed format of queries:extract manifest to be more extensible #611
      • Changed manifest hash encoding to SHA-256 instead of SHA-512 #611
      • Deprecated apollo schema:*, and codegen:* commands and aliased usage to new commands
        • apollo codegen:generate aliases to apollo client:codegen
        • apollo schema:check aliases to apollo service:check
        • apollo schema:download aliases to apollo service:download (added 2.0.13)
        • apollo schema:publish aliases to apollo service:push
        • apollo plugins:add aliases to apollo plugins:install
        • apollo plugins:unlink and apollo plugins:remove aliases to apollo plugins:uninstall
      • Removed apollo queries:* commands
        • apollo client:check should be used in place of apollo queries:check
        • apollo client:extract should be used in place of apollo queries:extract
      • Deprecated --queries flag in client commands in place of the --includes flag
  • `apollo-language-server@1.0.0`
    • Initial release of apollo-language-server to support vscode-apollo, and apollo
    • Supports editor features for...
      • Autocompletion of GraphQL documents
      • Hover information for fields anr arguments
      • Type definitions and references
      • Code lenses for open files
  • `vscode-apollo@1.0.0`
    • Initial Release of vscode-apollo
    • Switching of schema tags #632
    • Supports all of the editor features exposed by apollo-language-server

`apollo@1.9.2`

`apollo@1.9.1`

  • `apollo@1.9.1`
    • Fixes formatting of the schema:download response to match previous codegen schemas #573

`apollo@1.9.0`

  • `apollo@1.9.0`
    • Added queries:extract command to write a manifest of client queries #553

v1.8.3

  • apollo
  • apollo-codegen-swift
    • Treat mergeInFieldsFromFragmentSpreads as false in Swift codegen when flag isn't specified. Fixes #537. @martijnwalraven)

v1.7.1

:rocket: Feature

  • apollo-codegen-typescript
    • #535 [TS] Sort global types so order is not determined by order of appearance (@danilobuerger)

:bug: Bug Fix

  • apollo-codegen-typescript
    • #544 Prepend ./ to TS relative paths to make them valid, Closes #543 (@shadaj)
  • apollo-cli
    • #534 Allow to run apollo codegen:generate --watch on non tty devices (@trojanowski)

Committers: 3

v1.7.0

:rocket: Feature

  • apollo-language-server, apollo-vscode
    • #536 Display status of loading tasks for config and Engine stats (@shadaj)
  • apollo-cli
    • #533 Fall back to other methods of schema loading when one fails (@shadaj)
  • apollo-cli, apollo-codegen-typescript
    • #525 [TS] Elimate newlines at beginning of file and add newline at end of file (@danilobuerger)
  • apollo-cli, apollo-codegen-core
    • #526 Scan all files for queries and reduce use of default endpoints (@shadaj)
  • apollo-cli, apollo-codegen-typescript, common-test
  • apollo-codegen-typescript

:bug: Bug Fix

  • apollo-cli, apollo-language-server, apollo-vscode
    • #519 [VSCode] Fix detection of projects inside folders (@shadaj)
  • apollo-cli

:memo: Documentation

Committers: 3

v1.6.0

:rocket: Feature

  • apollo-language-server
  • apollo-language-server, apollo-vscode
    • #515 Fix missing descriptions and add more hover information for arguments (@shadaj)
  • apollo-cli, apollo-codegen-core, apollo-language-server, apollo-vscode-webview, apollo-vscode
    • #512 React UI for webviews, fix file tracking and fragment spreads (@shadaj)
  • apollo-cli, apollo-language-server, apollo-vscode
    • #508 Support jumping to definitions in schema (@shadaj)

:memo: Documentation

:house: Internal

  • apollo-cli, apollo-language-server
    • #506 Share validation logic between CLI and language server (@shadaj)

Committers: 2

v1.5.0

:rocket: Feature

  • apollo-language-server, apollo-vscode
  • apollo-cli, apollo-codegen-core
    • #497 Load config from apollo.config.js or package.json (@shadaj)

:house: Internal

  • apollo-cli
    • #492 Make TypeScript options more consistent across packages (@shadaj)

Committers: 1

v1.4.0

:rocket: Feature

  • apollo-cli
    • #484 Support file watching for codegen:generate (@shadaj)
    • #490 Assume the output is a directory when it has no extension (@shadaj)
    • #485 Support loading server-side schema from JS/TS files (@shadaj)
    • #483 Support generating based on .graphql schema files (@shadaj)

:bug: Bug Fix

  • apollo-cli, apollo-codegen-core
    • #488 Handle cases when storing server-defined models in local state (@shadaj)

:house: Internal

  • apollo-cli

Committers: 1

v1.3.0

:rocket: Feature

  • apollo-cli, apollo-codegen-core
    • #480 Initial support for client-side schemas (@shadaj)

:house: Internal

  • apollo-cli, apollo-codegen-core, apollo-codegen-flow-legacy, apollo-codegen-flow, apollo-codegen-scala, apollo-codegen-swift, apollo-codegen-typescript-legacy, apollo-codegen-typescript
    • #479 Run build before publishing to prevent uploading stale code (@shadaj)

Committers: 1

v1.2.0

:rocket: Feature

:bug: Bug Fix

  • apollo-cli, apollo-codegen-core
    • #465 Improve typing of options and add more codegen tests (@shadaj)
    • #464 Command-level unit tests for codegen (@shadaj)
  • apollo-cli
    • #470 Restore ability to put generated files in a directory relative to source (@mike-marcacci)
    • #457 Allow legacy targets to be used when manually specified (@shadaj)
  • apollo-codegen-flow
    • #461 Change generated flow files extension to .js instead of .ts (@TLadd)

:memo: Documentation

  • apollo-cli

:house: Internal

  • Other
    • #477 Add lerna-changelog to manage generating changelogs (@shadaj)
  • apollo-cli, apollo-codegen-core
    • #465 Improve typing of options and add more codegen tests (@shadaj)
    • #464 Command-level unit tests for codegen (@shadaj)

Committers: 5

Legacy Apollo Codegen Changelog

v0.20.2

  • The TypeScript and Flow targets now use block comments to better handle multiline comments in schemas
  • Fix crash when running on a version of Node that already supports Array.flatMap

v0.20.1

  • Fix issue with flow-legacy target being unusable

v0.20.0

  • BREAKING: The typescript and flow targets now refer to the modern implementations. The deprecated legacy targets are available under typescript-legacy and flow-legacy.
  • BREAKING: The --output parameter to the CLI is now required for all targets.
  • The TypeScript and Flow targets now support outputting types to either a single file or a directory, where types for each query will be separated