Add `graphql-ws` protocol support #2168

calvincestari · 2022-02-19T00:14:22Z

This introduces support for the graphql-transport-ws WebSocket sub-protocol implemented in the graphql-ws library. This is a modern, actively maintained successor to the graphql-ws sub-protocol implemented in the subscriptions-transport-ws library.

Notable changes:

Provides the user with a number of ways to select which WebSocket protocol is used. ~~but defaults to using the graphql_ws protocol.~~ This is a breaking change that requires the user to select a protocol when initializing a WebSocket instance.
Adds a new target (SubscriptionAPI) which is built with a single test to validate the implementation of the graphql-transport-ws protocol in an end-to-end test using an Apollo Server documentation example.
Adds the required Apollo Server documentation example service to the chain of servers used in CI integration tests.
Switches to a default of node v16 to be used for integration test services, while node v12 is still used for SimpleUploadServer.

How to configure which WebSocket protocol is used:

~~Providing a URLRequest with the Sec-WebSocket-Protocol header preconfigured. WebSocket will respect this value if preset otherwise will default to using the graphql_ws protocol.~~
Use one of the initializers WebSocket(request:webSocketProtocol:), WebSocket(url:webSocketProtocol:) or WebSocket(url:writeQueueQOS:webSocketProtocol:)

Protocol differences and how we support them

All protocol messages are defined in OperationMessage and the behavior logic is in WebSocketTransport. The way this is implemented now effectively means there is no segmentation of protocol behaviour and an active web socket could receive a message from any protocol and it would process it; not ideal.

Future changes

This is an aged implementation that has served us well so far, and I've added tests where we had none before but is not scalable nor ideal. Major version 2.0 will focus on the networking stack and at that time we can completely overhaul how we support GraphQL over WebSocket protocols.

Closes #1622

…-examples

- Clone and install Apollo Server docs-examples - Move SimpleUploadServer to port 4001 and lock nvm to v12.22.10 - Stop using node v12 as default (CI installed is v16)

alexdavid · 2022-02-19T00:37:47Z

Thank you for implementing this.

Quick question though: the new graphql-transport-ws protocol specifies that clients must send a Pong event to Ping messages. Is this handled in this implementation?

calvincestari · 2022-02-19T00:42:59Z

That's a good question @alexdavid. We do have ping/pong as WebSocket infrastructure, i.e.: transport level, but nothing at the protocol level. I'm going to change this to a draft PR until I'm 100% certain about the requirement. Thanks for the heads-up!

calvincestari · 2022-02-19T00:30:18Z

.circleci/config.yml

@@ -43,18 +45,29 @@ commands:
          name: Start StarWars Server
          background: true
      - run:
-          command: cd SimpleUploadServer && npm install && npm start
+          command: cd SimpleUploadServer && nvm use && npm install && npm start


Required to tell nvm to actually use the .nvmrc file created to lock SimpleUploadServer to node v12.

calvincestari · 2022-02-19T00:30:58Z

Apollo.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved

+        }
+      },
+      {
+        "package": "Nimble",


Adding Nimble to main, currently it only exists in the 1.0 branches.

calvincestari · 2022-02-19T00:36:10Z

SimpleUploadServer/index.js

@@ -64,6 +64,8 @@ const server = new ApolloServer({
  }
 });

-server.listen().then(({ url }) => {
+server.listen({
+  port: 4001


The Apollo Server documentation example defaults to port 4000. Since it's maintained by other teams and serves as a documentation example it's easier for us to move the SimpleUploadServer service to port 4001.

calvincestari · 2022-02-19T00:37:29Z

Sources/ApolloWebSocket/OperationMessage.swift

@@ -7,6 +7,7 @@ final class OperationMessage {
  enum Types : String {
    case connectionInit = "connection_init"            // Client -> Server
    case connectionTerminate = "connection_terminate"  // Client -> Server
+    case subscribe = "subscribe"                       // Client -> Server


Messages that are additive so that we can continue to support both protocols.

Sources/ApolloWebSocket/DefaultImplementation/WebSocket.swift

…ated initializer.

…n libraries

calvincestari · 2022-02-24T20:58:51Z

Thank you for implementing this.

Quick question though: the new graphql-transport-ws protocol specifies that clients must send a Pong event to Ping messages. Is this handled in this implementation?

@alexdavid I've added message support for ping/pong in 348dcf0 and it's tested in 6edea9b. Thanks for calling that out.

calvincestari · 2022-02-24T21:00:40Z

SimpleUploadServer/.nvmrc

@@ -0,0 +1 @@
+v12.22.10


SimpleUploadServer needs to be upgraded to the latest Apollo Server at some point but for now we have to do this. ☹️

calvincestari · 2022-02-24T21:03:20Z

Tests/ApolloTests/WebSocket/GraphqlTransportWsProtocolTests.swift

+import SubscriptionAPI
+
+class GraphqlTransportWsProtocolTests: XCTestCase {
+  private let asyncTimeout: DispatchTimeInterval = .seconds(3)


A longer async wait interval for slower environments such as CI.

These tests look great, but I'm really confused why CI would need a 3 second time out. If we are mocking the Socket and the Transport, it shouldn't need all that time. These are unit tests, not integration tests, right?

If it's taking that long, I'm wondering if there is something going wrong with a locking thread or something?

The longer timeout is my 'easy' fix attempt at resolving failed CI test. It's not that though, still working on resolving the failed tests. Yes these are unit tests with mocking.

AnthonyMDev

All protocol messages are defined in OperationMessage and the behavior logic is in WebSocketTransport. The way this is implemented now effectively means there is no segmentation of protocol behaviour and an active web socket could receive a message from any protocol and it would process it; not ideal.

Yeah, we should separate our concerns better when we refactor all of this in 2.0. But this behavior shouldn't be likely to cause any tangible problems for the time being, right? Are you just calling this out to be thorough, or are you concerned about this?

Sources/ApolloWebSocket/DefaultImplementation/WebSocket.swift

AnthonyMDev · 2022-02-24T23:49:38Z

Tests/ApolloTests/WebSocket/GraphqlTransportWsProtocolTests.swift

+import SubscriptionAPI
+
+class GraphqlTransportWsProtocolTests: XCTestCase {
+  private let asyncTimeout: DispatchTimeInterval = .seconds(3)


These tests look great, but I'm really confused why CI would need a 3 second time out. If we are mocking the Socket and the Transport, it shouldn't need all that time. These are unit tests, not integration tests, right?

If it's taking that long, I'm wondering if there is something going wrong with a locking thread or something?

calvincestari · 2022-02-24T23:56:15Z

Yeah, we should separate our concerns better when we refactor all of this in 2.0. But this behavior shouldn't be likely to cause any tangible problems for the time being, right? Are you just calling this out to be thorough, or are you concerned about this?

Not concerned since servers implement a single protocol. Calling it out as behaviour we should not carry forward into 2.0.

Move OperationMessageMatchers to correct target and remove Nimble linking from ApolloTestSupport

This reverts commit d63d078.

AnthonyMDev

Awesome job!

* Update version number * Update changelog * Update SourceDocsLib dependecy * Update generated documentation * Update changelog with cache key caveat * Update changelog for merging of #2147 * Update changelog for #2177 and #2168 * Update documentation

* Implement graphql-transport-ws protocol support * Add graphql-transport-ws integration test based on Apollo Server docs-examples * Add CI step for Apollo Server graphql-transport-ws tests * After installing node v12 switch to use v16 * Instruct nvm to use version in .nvmrc * Update documentation and tutorial * Change WSProtocol cases to closer match library names * Remove initializer defaults and require web socket protocol on designated initializer. * Update Subscriptions documentation * Add WSProtocol option for AWS AppSync * Add ping/pong message support required by graphql-ws * Update documentation and tutorial * Add tests for subscriptionWsProtocol * Add tests for graphqlWSProtocol * Revert to naming aligned with the protocols and not the implementation libraries * Use longer async timeout for slower environments like CI * Fix test names * Fix project configuration * Rename protocol parameter on WebSocket initializers * Revert "Use longer async timeout for slower environments like CI" * Fix async timing bug and refactor websocket protocol tests

* Update version number * Update changelog * Update SourceDocsLib dependecy * Update generated documentation * Update changelog with cache key caveat * Update changelog for merging of apollographql#2147 * Update changelog for apollographql#2177 and apollographql#2168 * Update documentation

@designatednerd

* Attempted fix for integration test failing on CI (apollographql#2024) * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.6 (apollographql#2026) Co-authored-by: Renovate Bot <[email protected]> * Update apollo-tooling to v2.33.9 (apollographql#2028) * Update to v2.33.9 of the CLI tooling * Update StarWarsAPI output generated by updated tooling * Update test with expected output * Keep the parameter spacing * Gateway clarification based on license change * Update SQLite.swift to version 13.0 (apollographql#2015) * Update Package.swift and podspec * Updated XcodeProj * Bump SQLite.swift minimum required version to 0.13.1 Co-authored-by: Calvin Cestari <[email protected]> * Release `0.50.0` (apollographql#2031) * Update version number for release * Updated changelog for release * Update documentation for release changes * Update changelog for apollographql#2015 * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.8 (apollographql#2038) Co-authored-by: Renovate Bot <[email protected]> * Update caching.mdx (apollographql#2042) fixed typo * Update ROADMAP.md (apollographql#2053) * Clean up Github API for performance tests * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.9 (apollographql#2062) Co-authored-by: Renovate Bot <[email protected]> * Make filesystem diagram a bit easier to understand (apollographql#2063) * Update ASCII art for filesystem, clarify where Apollo Codegen folder goes * update spacing to make comments clearer, fix missing file emoji * Allow periods in arguments to be ignored when parsing cacheKeys (apollographql#2057) * Allow commas in arguments to be ignored when parsing cacheKeys * Update * More tests * No-split case * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.11 (apollographql#2068) Co-authored-by: Renovate Bot <[email protected]> * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.12 (apollographql#2074) Co-authored-by: Renovate Bot <[email protected]> * Add tutorial on subscriptions to match Android (apollographql#2072) * Remove bits from under construction that are going to be handled with blog posts, update versions * Get rid of fragments and cache, bring over android subscriptions stuff * this is actually part 9 on iOS * bring over screenshots from Android tutorial * Correct link * Update everything for iOS * update index and link from prior step to include subscriptions * Fix link to subscriptions * add missing image * fix borked link * be clearer about replacing the print statement * remove "unnecessary" quotation marks * add missing sentence, make image less ginormous * Fix direction I definitely know my left from my right! :woman-facepaming: Co-authored-by: Calvin Cestari <[email protected]> * add missing word Co-authored-by: Calvin Cestari <[email protected]> * Bump mermaid from 8.13.6 to 8.13.8 in /docs (apollographql#2083) Bumps [mermaid](https://github.com/knsv/mermaid) from 8.13.6 to 8.13.8. - [Release notes](https://github.com/knsv/mermaid/releases) - [Changelog](https://github.com/mermaid-js/mermaid/blob/develop/docs/CHANGELOG.md) - [Commits](mermaid-js/mermaid@8.13.6...8.13.8) --- updated-dependencies: - dependency-name: mermaid dependency-type: indirect ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * chore(deps): update dependency engine.io to 4.1.2 [security] (apollographql#2094) Co-authored-by: Renovate Bot <[email protected]> * chore(deps): update dependency follow-redirects to 1.14.7 [security] (apollographql#2092) Co-authored-by: Renovate Bot <[email protected]> * chore(deps): update dependency node-forge to 1.0.0 [security] (apollographql#2095) Co-authored-by: Renovate Bot <[email protected]> * Add note about acceptable extensions for types of schema file. (apollographql#2059) * Docs: Bump to Gatsby v3 (apollographql#2104) * Bump gatsby to v3, bump docs theme to version that supports v3 * Bump docs theme to latest prerelease for gatsby v3 * Bump docs theme to new major version * fix(deps): pin dependency gatsby-theme-apollo-docs to 6.0.0 (apollographql#2113) Co-authored-by: Renovate Bot <[email protected]> * fix(deps): pin dependency gatsby to 3.14.6 (apollographql#2123) Co-authored-by: Renovate Bot <[email protected]> * Edits to intro and installation docs (apollographql#2125) * Edits to intro and installation docs * Fix broken links * Edits from @designatednerd plus new screenshots * Fix tutorial URL and tweak downloading a schema article (apollographql#2133) * Split advanced "Creating a client" content into separate article (apollographql#2143) * WIP on revamp to Creating a client article * Break request chain content into separate article * Fix broken links * Incorporate feedback * Disable flaky integration test Will go back and fix this during WebSocket updates after 1.0 alpha * Update gatsby config to deploy 1.0 alpha docs * Update roadmap after 1.0.0-alpha.1 release (apollographql#2145) * [v1.0.0 Alpha 1] JavascriptError @unchecked Sendable (apollographql#2147) * fix: added unchecked sendable to JavascriptError to be able to compile with Swift 5.6 * Update CircleCI to use latest images * Change JavaScriptError properties to read-only * Fix typo in header doc Co-authored-by: TizianoCoroneo <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> * Update documentation to clarify schema download format and filename (apollographql#2160) * Update documentation to clarify schema download format and filename * Fix documentation link * chore(deps): update dependency follow-redirects to 1.14.8 [security] (apollographql#2161) Co-authored-by: Renovate Bot <[email protected]> * Update license copyright notice * Delete Jazzy config - not supported * Update list of active maintainers * [Fix apollographql#2170] Do not refetch query watcher from server after cache miss when cache policy is cache only (apollographql#2177) * [Fix apollographql#2170] Do not refetch query watcher from server after cache miss when cache policy is cache only * Revert test broken test infra change * Add `graphql-ws` protocol support (apollographql#2168) * Implement graphql-transport-ws protocol support * Add graphql-transport-ws integration test based on Apollo Server docs-examples * Add CI step for Apollo Server graphql-transport-ws tests * After installing node v12 switch to use v16 * Instruct nvm to use version in .nvmrc * Update documentation and tutorial * Change WSProtocol cases to closer match library names * Remove initializer defaults and require web socket protocol on designated initializer. * Update Subscriptions documentation * Add WSProtocol option for AWS AppSync * Add ping/pong message support required by graphql-ws * Update documentation and tutorial * Add tests for subscriptionWsProtocol * Add tests for graphqlWSProtocol * Revert to naming aligned with the protocols and not the implementation libraries * Use longer async timeout for slower environments like CI * Fix test names * Fix project configuration * Rename protocol parameter on WebSocket initializers * Revert "Use longer async timeout for slower environments like CI" * Fix async timing bug and refactor websocket protocol tests * chore(deps): update dependency prismjs to 1.27.0 [security] (apollographql#2179) Co-authored-by: Renovate Bot <[email protected]> * Release 0.51.0 (apollographql#2086) * Update version number * Update changelog * Update SourceDocsLib dependecy * Update generated documentation * Update changelog with cache key caveat * Update changelog for merging of apollographql#2147 * Update changelog for apollographql#2177 and apollographql#2168 * Update documentation * Enable lazy access to the request body creation for leverage in custom built interceptors (apollographql#2184) * Release `0.51.1` (apollographql#2188) * Update project version * Update changelog for apollographql#2184 * Update documentation * Updates for new docs infra (apollographql#2197) * Prepare ios docs for new infra * Add sidebar config * Update ExpansionPanelList components * Update code fences * Move _redirects file * Fix links * Update docset title * Update sidebar config * Add version to ios docs config * Remove imports and fix links * Remove mb from homepage button * Add algolia filters * Remove files from old Gatsby docs theme (apollographql#2202) * Remove files from old Gatsby docs theme * Remove netlify.toml * Clear body on APQ retry in JSONRequest (apollographql#2206) * Release 0.51.2 (apollographql#2207) * Release 0.51.2 * Fix Package file * Fix changelog version. * Add netlify config for deploy previews (apollographql#2208) * Add netlify config for deploy previews * Trigger deploy * Remove circle config * Update docs repo branch * Use buttonlink component * Add codegen option for excludes (apollographql#2205) * Add exclude options * Add test case * Fix typo (apollographql#2212) * Start a docs production deploy when docs changes get merged (apollographql#2211) * Create docs-publish.yml * Tweak ignore command * Bump minimist from 1.2.5 to 1.2.6 in /SimpleUploadServer (apollographql#2214) Bumps [minimist](https://github.com/substack/minimist) from 1.2.5 to 1.2.6. - [Release notes](https://github.com/substack/minimist/releases) - [Commits](https://github.com/substack/minimist/compare/1.2.5...1.2.6) --- updated-dependencies: - dependency-name: minimist dependency-type: indirect ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Bump node-fetch from 2.6.6 to 2.6.7 in /SimpleUploadServer (apollographql#2215) Bumps [node-fetch](https://github.com/node-fetch/node-fetch) from 2.6.6 to 2.6.7. - [Release notes](https://github.com/node-fetch/node-fetch/releases) - [Commits](node-fetch/node-fetch@v2.6.6...v2.6.7) --- updated-dependencies: - dependency-name: node-fetch dependency-type: indirect ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Add note to tutorial about the `graphql-ws` subscription library (apollographql#2219) * Add note to tutorial about new subscription library * tweak spacing * tweak phrasing * Add links and clarify which library is not maintained Co-authored-by: Calvin Cestari <[email protected]> * Update tutorial-obtain-schema.md (apollographql#2225) Change extension of the downloaded schema file. * Update tutorial-execute-query.md (apollographql#2228) * Update tutorial-execute-query.md * Change the schema file type to json. * chore: Update Xcode build tool versions on CircleCI (apollographql#2242) * chose: update xcode build environment versions * fix: update Node version to match CircleCI image * chore: Update roadmap * fix: Sandbox documentation links (apollographql#2254) * ci: Update xcode image to fix Node version mismatch * ci: Update Node version to match what is installed with Xcode 13.3.1 image * chore: updates roadmap (apollographql#2258) * chore: updates roadmap * Update ROADMAP.md Co-authored-by: Calvin Cestari <[email protected]> * Update ROADMAP.md Co-authored-by: Calvin Cestari <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> * Update build phases example to propagate errors to Xcode (apollographql#2260) Without the explicit propagation I wasn't seeing errors in Xcode. Build phase shell env: `/bin/sh` Xcode version: `Version 13.2.1 (13C100)` * Add a comment about a new use of the X-APOLLO-OPERATION-NAME header (apollographql#2267) * Set permissions for GitHub actions (apollographql#2248) * updates roadmap for june 2022 (apollographql#2295) * Update CircleCI tool versions (apollographql#2304) * ci: Update Xcode and iOS simulator versions * ci: Update Node version * fix: `graphql_transport_ws` protocol should send 'complete' to end subscription (apollographql#2320) * fix: graphql_transport_ws protocol should send 'complete' to end subscription * fix: Require MockWebSocket to be initialized with a graphql subscriptions protocol * tests: Fix StarWarsSubscriptionTests to use updated MockWebSocket initializer * Replace print statement with CodegenLogger.log (apollographql#2348) * Fix buttons on docs root (apollographql#2369) * Expose GraphQLResultError Path String (apollographql#2361) * Expose the path as a String * tests: Add unit tests for ResponsePath Co-authored-by: Calvin Cestari <[email protected]> * Revert "Fix buttons on docs root (apollographql#2369)" (apollographql#2371) This reverts commit d26751a. * release: 0.52.0 (apollographql#2370) * chore: Update release version number * chore: Update changelog * dep: Update packages * docs: Update API reference * Fix typo (apollographql#2379) Removed duplicate "the" * Fix incorrect parameter name (apollographql#2380) `id` was set as a parameter, but the query expects `launchId`. * chore: Update ROADMAP for Beta release cycle (apollographql#2393) * Remove all instances of bitcode as not supported in Xcode 14 (apollographql#2398) https://developer.apple.com/documentation/xcode-release-notes/xcode-14-release-notes * Release 0.53.0 (apollographql#2406) * chore: Update version number * chore: Update CHANGELOG * fix: checkout at tag with legacy optionals behavior (apollographql#2412) * Update version in Swift Scripting docs (apollographql#2416) * Re-added support for iOS 11 Co-authored-by: Anthony Miller <[email protected]> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> Co-authored-by: Renovate Bot <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> Co-authored-by: hwillson <[email protected]> Co-authored-by: Hesham Salman <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> Co-authored-by: bogdanbeczkowski <[email protected]> Co-authored-by: Ellen Shapiro <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Janessa Garrow <[email protected]> Co-authored-by: Stephen Barlow <[email protected]> Co-authored-by: TizianoCoroneo <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> Co-authored-by: Rick Fast <[email protected]> Co-authored-by: Trevor Blades <[email protected]> Co-authored-by: bannzai <[email protected]> Co-authored-by: Ayden Lee <[email protected]> Co-authored-by: Rose M Koron <[email protected]> Co-authored-by: Carrione <[email protected]> Co-authored-by: Martin Bonnin <[email protected]> Co-authored-by: JV <[email protected]> Co-authored-by: Adam Zethraeus <[email protected]> Co-authored-by: David Glasser <[email protected]> Co-authored-by: neilnaveen <[email protected]> Co-authored-by: Hilton Campbell <[email protected]> Co-authored-by: Joshua Shroyer <[email protected]> Co-authored-by: Mischa Hildebrand <[email protected]> Co-authored-by: stareque-atlassian <[email protected]> Co-authored-by: Yuki Yamamoto <[email protected]>

@designatednerd

* Attempted fix for integration test failing on CI (apollographql#2024) * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.6 (apollographql#2026) Co-authored-by: Renovate Bot <[email protected]> * Update apollo-tooling to v2.33.9 (apollographql#2028) * Update to v2.33.9 of the CLI tooling * Update StarWarsAPI output generated by updated tooling * Update test with expected output * Keep the parameter spacing * Gateway clarification based on license change * Update SQLite.swift to version 13.0 (apollographql#2015) * Update Package.swift and podspec * Updated XcodeProj * Bump SQLite.swift minimum required version to 0.13.1 Co-authored-by: Calvin Cestari <[email protected]> * Release `0.50.0` (apollographql#2031) * Update version number for release * Updated changelog for release * Update documentation for release changes * Update changelog for apollographql#2015 * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.8 (apollographql#2038) Co-authored-by: Renovate Bot <[email protected]> * Update caching.mdx (apollographql#2042) fixed typo * Update ROADMAP.md (apollographql#2053) * Clean up Github API for performance tests * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.9 (apollographql#2062) Co-authored-by: Renovate Bot <[email protected]> * Make filesystem diagram a bit easier to understand (apollographql#2063) * Update ASCII art for filesystem, clarify where Apollo Codegen folder goes * update spacing to make comments clearer, fix missing file emoji * Allow periods in arguments to be ignored when parsing cacheKeys (apollographql#2057) * Allow commas in arguments to be ignored when parsing cacheKeys * Update * More tests * No-split case * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.11 (apollographql#2068) Co-authored-by: Renovate Bot <[email protected]> * fix(deps): update dependency gatsby-theme-apollo-docs to v5.3.12 (apollographql#2074) Co-authored-by: Renovate Bot <[email protected]> * Add tutorial on subscriptions to match Android (apollographql#2072) * Remove bits from under construction that are going to be handled with blog posts, update versions * Get rid of fragments and cache, bring over android subscriptions stuff * this is actually part 9 on iOS * bring over screenshots from Android tutorial * Correct link * Update everything for iOS * update index and link from prior step to include subscriptions * Fix link to subscriptions * add missing image * fix borked link * be clearer about replacing the print statement * remove "unnecessary" quotation marks * add missing sentence, make image less ginormous * Fix direction I definitely know my left from my right! :woman-facepaming: Co-authored-by: Calvin Cestari <[email protected]> * add missing word Co-authored-by: Calvin Cestari <[email protected]> * Bump mermaid from 8.13.6 to 8.13.8 in /docs (apollographql#2083) Bumps [mermaid](https://github.com/knsv/mermaid) from 8.13.6 to 8.13.8. - [Release notes](https://github.com/knsv/mermaid/releases) - [Changelog](https://github.com/mermaid-js/mermaid/blob/develop/docs/CHANGELOG.md) - [Commits](mermaid-js/mermaid@8.13.6...8.13.8) --- updated-dependencies: - dependency-name: mermaid dependency-type: indirect ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * chore(deps): update dependency engine.io to 4.1.2 [security] (apollographql#2094) Co-authored-by: Renovate Bot <[email protected]> * chore(deps): update dependency follow-redirects to 1.14.7 [security] (apollographql#2092) Co-authored-by: Renovate Bot <[email protected]> * chore(deps): update dependency node-forge to 1.0.0 [security] (apollographql#2095) Co-authored-by: Renovate Bot <[email protected]> * Add note about acceptable extensions for types of schema file. (apollographql#2059) * Docs: Bump to Gatsby v3 (apollographql#2104) * Bump gatsby to v3, bump docs theme to version that supports v3 * Bump docs theme to latest prerelease for gatsby v3 * Bump docs theme to new major version * fix(deps): pin dependency gatsby-theme-apollo-docs to 6.0.0 (apollographql#2113) Co-authored-by: Renovate Bot <[email protected]> * fix(deps): pin dependency gatsby to 3.14.6 (apollographql#2123) Co-authored-by: Renovate Bot <[email protected]> * Edits to intro and installation docs (apollographql#2125) * Edits to intro and installation docs * Fix broken links * Edits from @designatednerd plus new screenshots * Fix tutorial URL and tweak downloading a schema article (apollographql#2133) * Split advanced "Creating a client" content into separate article (apollographql#2143) * WIP on revamp to Creating a client article * Break request chain content into separate article * Fix broken links * Incorporate feedback * Disable flaky integration test Will go back and fix this during WebSocket updates after 1.0 alpha * Update gatsby config to deploy 1.0 alpha docs * Update roadmap after 1.0.0-alpha.1 release (apollographql#2145) * [v1.0.0 Alpha 1] JavascriptError @unchecked Sendable (apollographql#2147) * fix: added unchecked sendable to JavascriptError to be able to compile with Swift 5.6 * Update CircleCI to use latest images * Change JavaScriptError properties to read-only * Fix typo in header doc Co-authored-by: TizianoCoroneo <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> * Update documentation to clarify schema download format and filename (apollographql#2160) * Update documentation to clarify schema download format and filename * Fix documentation link * chore(deps): update dependency follow-redirects to 1.14.8 [security] (apollographql#2161) Co-authored-by: Renovate Bot <[email protected]> * Update license copyright notice * Delete Jazzy config - not supported * Update list of active maintainers * [Fix apollographql#2170] Do not refetch query watcher from server after cache miss when cache policy is cache only (apollographql#2177) * [Fix apollographql#2170] Do not refetch query watcher from server after cache miss when cache policy is cache only * Revert test broken test infra change * Add `graphql-ws` protocol support (apollographql#2168) * Implement graphql-transport-ws protocol support * Add graphql-transport-ws integration test based on Apollo Server docs-examples * Add CI step for Apollo Server graphql-transport-ws tests * After installing node v12 switch to use v16 * Instruct nvm to use version in .nvmrc * Update documentation and tutorial * Change WSProtocol cases to closer match library names * Remove initializer defaults and require web socket protocol on designated initializer. * Update Subscriptions documentation * Add WSProtocol option for AWS AppSync * Add ping/pong message support required by graphql-ws * Update documentation and tutorial * Add tests for subscriptionWsProtocol * Add tests for graphqlWSProtocol * Revert to naming aligned with the protocols and not the implementation libraries * Use longer async timeout for slower environments like CI * Fix test names * Fix project configuration * Rename protocol parameter on WebSocket initializers * Revert "Use longer async timeout for slower environments like CI" * Fix async timing bug and refactor websocket protocol tests * chore(deps): update dependency prismjs to 1.27.0 [security] (apollographql#2179) Co-authored-by: Renovate Bot <[email protected]> * Release 0.51.0 (apollographql#2086) * Update version number * Update changelog * Update SourceDocsLib dependecy * Update generated documentation * Update changelog with cache key caveat * Update changelog for merging of apollographql#2147 * Update changelog for apollographql#2177 and apollographql#2168 * Update documentation * Enable lazy access to the request body creation for leverage in custom built interceptors (apollographql#2184) * Release `0.51.1` (apollographql#2188) * Update project version * Update changelog for apollographql#2184 * Update documentation * Updates for new docs infra (apollographql#2197) * Prepare ios docs for new infra * Add sidebar config * Update ExpansionPanelList components * Update code fences * Move _redirects file * Fix links * Update docset title * Update sidebar config * Add version to ios docs config * Remove imports and fix links * Remove mb from homepage button * Add algolia filters * Remove files from old Gatsby docs theme (apollographql#2202) * Remove files from old Gatsby docs theme * Remove netlify.toml * Clear body on APQ retry in JSONRequest (apollographql#2206) * Release 0.51.2 (apollographql#2207) * Release 0.51.2 * Fix Package file * Fix changelog version. * Add netlify config for deploy previews (apollographql#2208) * Add netlify config for deploy previews * Trigger deploy * Remove circle config * Update docs repo branch * Use buttonlink component * Add codegen option for excludes (apollographql#2205) * Add exclude options * Add test case * Fix typo (apollographql#2212) * Start a docs production deploy when docs changes get merged (apollographql#2211) * Create docs-publish.yml * Tweak ignore command * Bump minimist from 1.2.5 to 1.2.6 in /SimpleUploadServer (apollographql#2214) Bumps [minimist](https://github.com/substack/minimist) from 1.2.5 to 1.2.6. - [Release notes](https://github.com/substack/minimist/releases) - [Commits](https://github.com/substack/minimist/compare/1.2.5...1.2.6) --- updated-dependencies: - dependency-name: minimist dependency-type: indirect ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Bump node-fetch from 2.6.6 to 2.6.7 in /SimpleUploadServer (apollographql#2215) Bumps [node-fetch](https://github.com/node-fetch/node-fetch) from 2.6.6 to 2.6.7. - [Release notes](https://github.com/node-fetch/node-fetch/releases) - [Commits](node-fetch/node-fetch@v2.6.6...v2.6.7) --- updated-dependencies: - dependency-name: node-fetch dependency-type: indirect ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Add note to tutorial about the `graphql-ws` subscription library (apollographql#2219) * Add note to tutorial about new subscription library * tweak spacing * tweak phrasing * Add links and clarify which library is not maintained Co-authored-by: Calvin Cestari <[email protected]> * Update tutorial-obtain-schema.md (apollographql#2225) Change extension of the downloaded schema file. * Update tutorial-execute-query.md (apollographql#2228) * Update tutorial-execute-query.md * Change the schema file type to json. * chore: Update Xcode build tool versions on CircleCI (apollographql#2242) * chose: update xcode build environment versions * fix: update Node version to match CircleCI image * chore: Update roadmap * fix: Sandbox documentation links (apollographql#2254) * ci: Update xcode image to fix Node version mismatch * ci: Update Node version to match what is installed with Xcode 13.3.1 image * chore: updates roadmap (apollographql#2258) * chore: updates roadmap * Update ROADMAP.md Co-authored-by: Calvin Cestari <[email protected]> * Update ROADMAP.md Co-authored-by: Calvin Cestari <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> * Update build phases example to propagate errors to Xcode (apollographql#2260) Without the explicit propagation I wasn't seeing errors in Xcode. Build phase shell env: `/bin/sh` Xcode version: `Version 13.2.1 (13C100)` * Add a comment about a new use of the X-APOLLO-OPERATION-NAME header (apollographql#2267) * Set permissions for GitHub actions (apollographql#2248) * updates roadmap for june 2022 (apollographql#2295) * Update CircleCI tool versions (apollographql#2304) * ci: Update Xcode and iOS simulator versions * ci: Update Node version * fix: `graphql_transport_ws` protocol should send 'complete' to end subscription (apollographql#2320) * fix: graphql_transport_ws protocol should send 'complete' to end subscription * fix: Require MockWebSocket to be initialized with a graphql subscriptions protocol * tests: Fix StarWarsSubscriptionTests to use updated MockWebSocket initializer * Replace print statement with CodegenLogger.log (apollographql#2348) * Fix buttons on docs root (apollographql#2369) * Expose GraphQLResultError Path String (apollographql#2361) * Expose the path as a String * tests: Add unit tests for ResponsePath Co-authored-by: Calvin Cestari <[email protected]> * Revert "Fix buttons on docs root (apollographql#2369)" (apollographql#2371) This reverts commit d26751a. * release: 0.52.0 (apollographql#2370) * chore: Update release version number * chore: Update changelog * dep: Update packages * docs: Update API reference * Fix typo (apollographql#2379) Removed duplicate "the" * Fix incorrect parameter name (apollographql#2380) `id` was set as a parameter, but the query expects `launchId`. * chore: Update ROADMAP for Beta release cycle (apollographql#2393) * Remove all instances of bitcode as not supported in Xcode 14 (apollographql#2398) https://developer.apple.com/documentation/xcode-release-notes/xcode-14-release-notes * Release 0.53.0 (apollographql#2406) * chore: Update version number * chore: Update CHANGELOG * fix: checkout at tag with legacy optionals behavior (apollographql#2412) * Update version in Swift Scripting docs (apollographql#2416) * Re-added support for iOS 11 * Update to 0.53.0 Co-authored-by: Anthony Miller <[email protected]> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> Co-authored-by: Renovate Bot <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> Co-authored-by: hwillson <[email protected]> Co-authored-by: Hesham Salman <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> Co-authored-by: bogdanbeczkowski <[email protected]> Co-authored-by: Ellen Shapiro <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Janessa Garrow <[email protected]> Co-authored-by: Stephen Barlow <[email protected]> Co-authored-by: TizianoCoroneo <[email protected]> Co-authored-by: Calvin Cestari <[email protected]> Co-authored-by: Rick Fast <[email protected]> Co-authored-by: Trevor Blades <[email protected]> Co-authored-by: bannzai <[email protected]> Co-authored-by: Ayden Lee <[email protected]> Co-authored-by: Rose M Koron <[email protected]> Co-authored-by: Carrione <[email protected]> Co-authored-by: Martin Bonnin <[email protected]> Co-authored-by: JV <[email protected]> Co-authored-by: Adam Zethraeus <[email protected]> Co-authored-by: David Glasser <[email protected]> Co-authored-by: neilnaveen <[email protected]> Co-authored-by: Hilton Campbell <[email protected]> Co-authored-by: Joshua Shroyer <[email protected]> Co-authored-by: Mischa Hildebrand <[email protected]> Co-authored-by: stareque-atlassian <[email protected]> Co-authored-by: Yuki Yamamoto <[email protected]>

* Implement graphql-transport-ws protocol support * Add graphql-transport-ws integration test based on Apollo Server docs-examples * Add CI step for Apollo Server graphql-transport-ws tests * After installing node v12 switch to use v16 * Instruct nvm to use version in .nvmrc * Update documentation and tutorial * Change WSProtocol cases to closer match library names * Remove initializer defaults and require web socket protocol on designated initializer. * Update Subscriptions documentation * Add WSProtocol option for AWS AppSync * Add ping/pong message support required by graphql-ws * Update documentation and tutorial * Add tests for subscriptionWsProtocol * Add tests for graphqlWSProtocol * Revert to naming aligned with the protocols and not the implementation libraries * Use longer async timeout for slower environments like CI * Fix test names * Fix project configuration * Rename protocol parameter on WebSocket initializers * Revert "Use longer async timeout for slower environments like CI" * Fix async timing bug and refactor websocket protocol tests

* Update version number * Update changelog * Update SourceDocsLib dependecy * Update generated documentation * Update changelog with cache key caveat * Update changelog for merging of apollographql#2147 * Update changelog for apollographql#2177 and apollographql#2168 * Update documentation

calvincestari added 6 commits February 18, 2022 09:39

Implement graphql-transport-ws protocol support

6e7af18

Add graphql-transport-ws integration test based on Apollo Server docs…

d60ae4a

…-examples

Add CI step for Apollo Server graphql-transport-ws tests

685d359

- Clone and install Apollo Server docs-examples - Move SimpleUploadServer to port 4001 and lock nvm to v12.22.10 - Stop using node v12 as default (CI installed is v16)

After installing node v12 switch to use v16

c36b779

Instruct nvm to use version in .nvmrc

b1fc644

Update documentation and tutorial

6768fde

calvincestari mentioned this pull request Feb 19, 2022

graphql-ws Protocol Support #1622

Closed

calvincestari requested a review from AnthonyMDev February 19, 2022 00:28

calvincestari marked this pull request as draft February 19, 2022 00:43

calvincestari commented Feb 19, 2022

View reviewed changes

phanikavi reviewed Feb 21, 2022

View reviewed changes

Sources/ApolloWebSocket/DefaultImplementation/WebSocket.swift Show resolved Hide resolved

calvincestari added 3 commits February 21, 2022 12:51

Change WSProtocol cases to closer match library names

e8d1123

Remove initializer defaults and require web socket protocol on design…

7f6c4b6

…ated initializer.

Update Subscriptions documentation

ad9fbb5

phanikavi approved these changes Feb 22, 2022

View reviewed changes

calvincestari added 2 commits February 21, 2022 23:05

Add WSProtocol option for AWS AppSync

37336c5

Add ping/pong message support required by graphql-ws

348dcf0

calvincestari mentioned this pull request Feb 22, 2022

Updates to work with App Sync Subscriptions #1919

Merged

calvincestari added 5 commits February 22, 2022 16:44

Update documentation and tutorial

3391f33

Add tests for subscriptionWsProtocol

5b3aafb

Add tests for graphqlWSProtocol

6edea9b

Revert to naming aligned with the protocols and not the implementatio…

4178c66

…n libraries

Use longer async timeout for slower environments like CI

d63d078

calvincestari commented Feb 24, 2022

View reviewed changes

Fix test names

fa3f459

calvincestari marked this pull request as ready for review February 24, 2022 22:43

AnthonyMDev reviewed Feb 24, 2022

View reviewed changes

calvincestari added 4 commits February 24, 2022 22:22

Fix project configuration

118745d

Move OperationMessageMatchers to correct target and remove Nimble linking from ApolloTestSupport

Rename protocol parameter on WebSocket initializers

3589cad

Revert "Use longer async timeout for slower environments like CI"

2a92350

This reverts commit d63d078.

Fix async timing bug and refactor websocket protocol tests

9c92529

calvincestari force-pushed the update/graphql-ws-protocol branch from 209c7a0 to 9c92529 Compare February 25, 2022 20:25

AnthonyMDev approved these changes Feb 25, 2022

View reviewed changes

calvincestari merged commit bf86e01 into main Feb 25, 2022

calvincestari deleted the update/graphql-ws-protocol branch February 25, 2022 21:08

calvincestari added a commit that referenced this pull request Feb 25, 2022

Update changelog for #2177 and #2168

613e870

calvincestari mentioned this pull request Feb 25, 2022

Release 0.51.0 #2086

Merged

13 tasks

calvincestari added a commit that referenced this pull request Feb 25, 2022

Update changelog for #2177 and #2168

438b224

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add `graphql-ws` protocol support #2168

Add `graphql-ws` protocol support #2168

calvincestari commented Feb 19, 2022 •

edited

Loading

alexdavid commented Feb 19, 2022

calvincestari commented Feb 19, 2022

calvincestari Feb 19, 2022

calvincestari Feb 19, 2022

calvincestari Feb 19, 2022

calvincestari Feb 19, 2022

calvincestari commented Feb 24, 2022

calvincestari Feb 24, 2022

calvincestari Feb 24, 2022

AnthonyMDev Feb 24, 2022

calvincestari Feb 24, 2022 •

edited

Loading

AnthonyMDev left a comment

AnthonyMDev Feb 24, 2022

calvincestari commented Feb 24, 2022

AnthonyMDev left a comment

Add graphql-ws protocol support #2168

Add graphql-ws protocol support #2168

Conversation

calvincestari commented Feb 19, 2022 • edited Loading

Notable changes:

How to configure which WebSocket protocol is used:

Protocol differences and how we support them

Future changes

alexdavid commented Feb 19, 2022

calvincestari commented Feb 19, 2022

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

calvincestari commented Feb 24, 2022

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

calvincestari Feb 24, 2022 • edited Loading

Choose a reason for hiding this comment

AnthonyMDev left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

calvincestari commented Feb 24, 2022

AnthonyMDev left a comment

Choose a reason for hiding this comment

Add `graphql-ws` protocol support #2168

Add `graphql-ws` protocol support #2168

calvincestari commented Feb 19, 2022 •

edited

Loading

calvincestari Feb 24, 2022 •

edited

Loading