apollo-federation 2.0.3 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b636d94aed7966b85bb9b0b682fc534b7d1f4ef85b3c81255a4565bbbd779e36
-  data.tar.gz: 4148abf8ba0f446c63e8fd41b0f77671ec37e1a713968d7c0e9f40e0b4298698
+  metadata.gz: fc8de90dc106e25f44e0035a2e7ca3f2a4a37cc9b930d1d245317a93cd54a2f0
+  data.tar.gz: ed4a107cde1f0c1e1d4a979d4168de2c248301cf7a7a1250cd868d335fde0828
 SHA512:
-  metadata.gz: 5707a70a369a96f0c401bf538969450ef6cb223dca7b0fa62f6d4a9bea4071c0a366122980e9521d9e3d84abf708b1a44151817343389917b5bcffa48dbd32e8
-  data.tar.gz: dacb441ae9c79f41652d48e472e00bbee4dd947c8aa04f58ec10c3fa8e4eb69216edc62b8685a8119ddd9c4c0050103b893c2b33e26240d94e173c194ae2e660
+  metadata.gz: '0214196224a568813ebf0dbb3ca15a81ae902fa06c8c1c1e4fe8f9dba7232f4e0ddbc39275d8cbe8880d415861462813faa2d669d5945d775b68f8bf6ff94e06'
+  data.tar.gz: 1690599b1d8c4522cd8ebcca0c001b50b7b40ee8817cb07e0f8220c50bba39c22bdcc50907ca908ead0718989b04df5844fa958aaffb51374fb5ff3b7a8aee56

data/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [2.2.1](https://github.com/Gusto/apollo-federation-ruby/compare/v2.2.0...v2.2.1) (2022-03-08)
+
+
+### Bug Fixes
+
+* Remove to_graphql and make the interpreter runtime a requirement for older GraphQL versions ([#177](https://github.com/Gusto/apollo-federation-ruby/issues/177)) ([bfc3082](https://github.com/Gusto/apollo-federation-ruby/commit/bfc308260c34eee04c3b7a5f0e8a0bffe1cb88c4))
+
+# [2.2.0](https://github.com/Gusto/apollo-federation-ruby/compare/v2.1.0...v2.2.0) (2022-02-04)
+
+
+### Features
+
+* Get Apollo Federation to work with GraphQL 1.13.x ([#160](https://github.com/Gusto/apollo-federation-ruby/issues/160)) ([800001b](https://github.com/Gusto/apollo-federation-ruby/commit/800001baa5a54ab377998c651e7049da254c451b)), closes [#147](https://github.com/Gusto/apollo-federation-ruby/issues/147)
+
+# [2.1.0](https://github.com/Gusto/apollo-federation-ruby/compare/v2.0.3...v2.1.0) (2022-02-02)
+
+
+### Features
+
+* snake case field references ([f5506ae](https://github.com/Gusto/apollo-federation-ruby/commit/f5506aecd10ea0c4a72744be07e0a9ad5cd45b16))
+
 ## [2.0.3](https://github.com/Gusto/apollo-federation-ruby/compare/v2.0.2...v2.0.3) (2022-02-02)
 
 

data/README.md

@@ -105,10 +105,20 @@ Call `key` within your class definition:
 
 ```ruby
 class User < BaseObject
-  key fields: 'id'
+  key fields: :id
 end
 ```
 
+Compound keys are also supported:
+
+```ruby
+class User < BaseObject
+  key fields: [:id, { organization: :id }]
+end
+```
+
+See [field set syntax](#field-set-syntax) for more details on the format of the `fields` option.
+
 ### The `@external` directive
 
 [Apollo documentation](https://www.apollographql.com/docs/apollo-server/federation/core-concepts/#referencing-external-types)
@@ -131,10 +141,12 @@ Pass the `requires:` option to your field definition:
 class Product < BaseObject
   field :price, Int, null: true, external: true
   field :weight, Int, null: true, external: true
-  field :shipping_estimate, Int, null: true, requires: { fields: "price weight"}
+  field :shipping_estimate, Int, null: true, requires: { fields: [:price, :weight] }
 end
 ```
 
+See [field set syntax](#field-set-syntax) for more details on the format of the `fields` option.
+
 ### The `@provides` directive
 
 [Apollo documentation](https://www.apollographql.com/docs/apollo-server/federation/advanced-features/#using-denormalized-data)
@@ -143,9 +155,25 @@ Pass the `provides:` option to your field definition:
 
 ```ruby
 class Review < BaseObject
-  field :author, 'User', null: true, provides: { fields: 'username' }
+  field :author, 'User', null: true, provides: { fields: :username }
 end
 ```
+See [field set syntax](#field-set-syntax) for more details on the format of the `fields` option.
+
+### Field set syntax
+
+Field sets can be either strings encoded with the Apollo Field Set [syntax]((https://www.apollographql.com/docs/apollo-server/federation/federation-spec/#scalar-_fieldset)) or arrays, hashes and snake case symbols that follow the graphql-ruby conventions:
+
+```ruby
+# Equivalent to the "organizationId" field set
+:organization_id
+
+# Equivalent to the "price weight" field set
+[:price, :weight]
+
+# Equivalent to the "id organization { id }" field set
+[:id, { organization: :id }]
+```
 
 ### Reference resolvers
 
@@ -265,8 +293,9 @@ See discussion at [#74](https://github.com/Gusto/apollo-federation-ruby/issues/7
 
 ## Known Issues and Limitations
 
-- Only works with class-based schemas, the legacy `.define` API will not be supported
-- Does not add directives to the output of `Schema.to_definition`. Since `graphql-ruby` doesn't natively support schema directives, the directives will only be visible to the [Apollo Gateway](https://www.apollographql.com/docs/apollo-server/api/apollo-gateway/) through the `Query._service` field (see the [Apollo Federation specification](https://www.apollographql.com/docs/apollo-server/federation/federation-spec/)) or via [`Schema#federation_sdl`](https://github.com/Gusto/apollo-federation-ruby/blob/1d3baf4f8efcd02e7bf5bc7e3fee5b4fb963cd25/lib/apollo-federation/schema.rb#L19) as explained above.
+- For GraphQL older than 1.12, the interpreter runtime has to be used.
+- Does not add directives to the output of `Schema.to_definition`. Since `graphql-ruby` doesn't natively support schema directives, the
+  directives will only be visible to the [Apollo Gateway](https://www.apollographql.com/docs/apollo-server/api/apollo-gateway/) through the `Query._service` field (see the [Apollo Federation specification](https://www.apollographql.com/docs/apollo-server/federation/federation-spec/)) or via [`Schema#federation_sdl`](https://github.com/Gusto/apollo-federation-ruby/blob/1d3baf4f8efcd02e7bf5bc7e3fee5b4fb963cd25/lib/apollo-federation/schema.rb#L19) as explained above.
 
 ## Maintainers
 

data/lib/apollo-federation/field.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'apollo-federation/field_set_serializer'
 require 'apollo-federation/has_directives'
 
 module ApolloFederation
@@ -15,7 +16,7 @@ module ApolloFederation
           name: 'requires',
           arguments: [
             name: 'fields',
-            values: requires[:fields],
+            values: ApolloFederation::FieldSetSerializer.serialize(requires[:fields]),
           ],
         )
       end
@@ -24,7 +25,7 @@ module ApolloFederation
           name: 'provides',
           arguments: [
             name: 'fields',
-            values: provides[:fields],
+            values: ApolloFederation::FieldSetSerializer.serialize(provides[:fields]),
           ],
         )
       end

data/lib/apollo-federation/field_set_serializer.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'graphql'
+
+module ApolloFederation
+  module FieldSetSerializer
+    extend self
+
+    def serialize(fields)
+      case fields
+      when Hash
+        fields.map do |field, nested_selections|
+          "#{camelize(field)} { #{serialize(nested_selections)} }"
+        end.join(' ')
+      when Array
+        fields.map do |field|
+          serialize(field)
+        end.join(' ')
+      when String
+        fields
+      when Symbol
+        camelize(fields)
+      else
+        raise ArgumentError, "Unexpected field set type: #{fields.class}"
+      end
+    end
+
+    private
+
+    def camelize(field)
+      GraphQL::Schema::Member::BuildType.camelize(field.to_s)
+    end
+  end
+end

data/lib/apollo-federation/has_directives.rb

@@ -8,11 +8,5 @@ module ApolloFederation
       @federation_directives ||= []
       @federation_directives << { name: name, arguments: arguments }
     end
-
-    def to_graphql
-      field_defn = super # Returns a GraphQL::Field
-      field_defn.metadata[:federation_directives] = @federation_directives
-      field_defn
-    end
   end
 end

data/lib/apollo-federation/interface.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'apollo-federation/field_set_serializer'
 require 'apollo-federation/has_directives'
 
 module ApolloFederation
@@ -22,7 +23,7 @@ module ApolloFederation
           name: 'key',
           arguments: [
             name: 'fields',
-            values: fields,
+            values: ApolloFederation::FieldSetSerializer.serialize(fields),
           ],
         )
       end

data/lib/apollo-federation/object.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'apollo-federation/field_set_serializer'
 require 'apollo-federation/has_directives'
 
 module ApolloFederation
@@ -20,7 +21,7 @@ module ApolloFederation
           name: 'key',
           arguments: [
             name: 'fields',
-            values: fields,
+            values: ApolloFederation::FieldSetSerializer.serialize(fields),
           ],
         )
       end

data/lib/apollo-federation/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ApolloFederation
-  VERSION = '2.0.3'
+  VERSION = '2.2.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: apollo-federation
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.2.1
 platform: ruby
 authors:
 - Noa Elad
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-02 00:00:00.000000000 Z
+date: 2022-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: graphql
@@ -198,6 +198,7 @@ files:
 - lib/apollo-federation/entity.rb
 - lib/apollo-federation/federated_document_from_schema_definition.rb
 - lib/apollo-federation/field.rb
+- lib/apollo-federation/field_set_serializer.rb
 - lib/apollo-federation/has_directives.rb
 - lib/apollo-federation/interface.rb
 - lib/apollo-federation/object.rb