apollo-federation 2.2.3 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2640264c9bd136989c737d434129afc4bdf507e1e60be0bf40a7260ee87dadee
-  data.tar.gz: '088b4e6b3adf2717bc778a6022069a16ab819ac40c9bc3b3d9f8773eb3c44f6a'
+  metadata.gz: c726579bc9db4355491490baae944a9827535beec26b27c7f2800944243f312b
+  data.tar.gz: 578373ded7eecce3f8484530efc7778940605226bf055bc871940266f915ec26
 SHA512:
-  metadata.gz: a6abd4b01d28d71e2fd943dc492ab8192cc82b17c8f4f3ede5da9b0bc18846f5b52ac6b123b55f0d3b3caaa858a2d88e7ebb427f7553b0f6d14c62141b2c3244
-  data.tar.gz: 65e28108093d158475d361cf4f3524b5a72ee009aa417ba0c5704c31f84be521331ec80505a325632b205c6a3bb9f43908c12e3aa28adc7c68a38fb5cdabe0f6
+  metadata.gz: 3489a6047e4f225b376adf87a0fa4aad1e0f0c2c34100891df526fea337e75e183e0b3d0a3f63d23881384e9628e0e7ec65f34bc822a610c7285a6c30d6052a8
+  data.tar.gz: be8473595a04f6baa232d7f57c88f0d15a152ce5f8199cdae92b35328032d471545bd0b3d4e5a2cbc91d8a922d5dab9a5afd397f431702d12ad83947bc649fe1

data/CHANGELOG.md

@@ -1,3 +1,31 @@
+# [3.1.0](https://github.com/Gusto/apollo-federation-ruby/compare/v3.0.0...v3.1.0) (2022-06-21)
+
+
+### Features
+
+* Support Federation v2 ([#196](https://github.com/Gusto/apollo-federation-ruby/issues/196)) ([238736c](https://github.com/Gusto/apollo-federation-ruby/commit/238736cdb6f12121ce2a295c7a28fba3990012b9)), closes [/www.apollographql.com/docs/federation/federation-2/moving-to-federation-2/#opt-in-to-federation-2](https://github.com//www.apollographql.com/docs/federation/federation-2/moving-to-federation-2//issues/opt-in-to-federation-2)
+
+# [3.0.0](https://github.com/Gusto/apollo-federation-ruby/compare/v2.2.4...v3.0.0) (2022-04-05)
+
+
+### Bug Fixes
+
+* camelize string fields to match sym behavior ([8f0382b](https://github.com/Gusto/apollo-federation-ruby/commit/8f0382b346d2cde5be252138275d67373b36acd7))
+
+
+### BREAKING CHANGES
+
+* string fields will be camelized by default rather than passed as is.
+
+## [2.2.4](https://github.com/Gusto/apollo-federation-ruby/compare/v2.2.3...v2.2.4) (2022-04-01)
+
+
+### Bug Fixes
+
+* add linux and darwin platforms to lockfile ([#188](https://github.com/Gusto/apollo-federation-ruby/issues/188)) ([fbbb856](https://github.com/Gusto/apollo-federation-ruby/commit/fbbb856b315400f21c189c26488efbf030792ae1))
+* bump circleci cache version ([#189](https://github.com/Gusto/apollo-federation-ruby/issues/189)) ([1b6c9d8](https://github.com/Gusto/apollo-federation-ruby/commit/1b6c9d8fc647c19a7eb4c95ab76b276aae9131c5))
+* set env variables for release step ([#191](https://github.com/Gusto/apollo-federation-ruby/issues/191)) ([db0d1e6](https://github.com/Gusto/apollo-federation-ruby/commit/db0d1e688b93bfa2114eb91248d2f507a50fca8a))
+
 ## [2.2.3](https://github.com/Gusto/apollo-federation-ruby/compare/v2.2.2...v2.2.3) (2022-03-22)
 
 

data/README.md

@@ -61,6 +61,15 @@ class MySchema < GraphQL::Schema
 end
 ```
 
+**Optional:** To opt in to Federation v2, specify the version in your schema:
+
+```ruby
+class MySchema < GraphQL::Schema
+  include ApolloFederation::Schema
+  federation version: '2.0'
+end
+```
+
 ## Example
 
 The [`example`](./example/) folder contains a Ruby implementation of Apollo's [`federation-demo`](https://github.com/apollographql/federation-demo). To run it locally, install the Ruby dependencies:
@@ -160,6 +169,59 @@ end
 ```
 See [field set syntax](#field-set-syntax) for more details on the format of the `fields` option.
 
+### The `@shareable` directive (Apollo Federation v2)
+
+[Apollo documentation](https://www.apollographql.com/docs/federation/federated-types/federated-directives/#shareable)
+
+Call `shareable` within your class definition:
+
+```ruby
+class User < BaseObject
+  shareable
+end
+```
+
+Pass the `shareable: true` option to your field definition:
+
+```ruby
+class User < BaseObject
+  field :id, ID, null: false, shareable: true
+end
+```
+
+### The `@inaccessible` directive (Apollo Federation v2)
+
+[Apollo documentation](https://www.apollographql.com/docs/federation/federated-types/federated-directives/#inaccessible)
+
+Call `inaccessible` within your class definition:
+
+```ruby
+class User < BaseObject
+  inaccessible
+end
+```
+
+Pass the `inaccessible: true` option to your field definition:
+
+```ruby
+class User < BaseObject
+  field :id, ID, null: false, inaccessible: true
+end
+```
+
+### The `@override` directive (Apollo Federation v2)
+
+[Apollo documentation](https://www.apollographql.com/docs/federation/federated-types/federated-directives/#override)
+
+Pass the `override:` option to your field definition:
+
+```ruby
+class Product < BaseObject
+  field :id, ID, null: false
+  field :inStock, Boolean, null: false, override: { from: 'Products' }
+end
+```
+
 ### 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:

data/lib/apollo-federation/federated_document_from_schema_definition.rb

@@ -55,14 +55,14 @@ module ApolloFederation
 
     def merge_directives(node, type)
       if type.is_a?(ApolloFederation::HasDirectives)
-        directives = type.federation_directives
+        directives = type.federation_directives || []
       else
         directives = []
       end
 
-      (directives || []).each do |directive|
+      directives.each do |directive|
         node = node.merge_directive(
-          name: directive[:name],
+          name: schema.federation_2? ? "federation__#{directive[:name]}" : directive[:name],
           arguments: build_arguments_node(directive[:arguments]),
         )
       end

data/lib/apollo-federation/field.rb

@@ -7,31 +7,78 @@ module ApolloFederation
   module Field
     include HasDirectives
 
-    def initialize(*args, external: false, requires: nil, provides: nil, **kwargs, &block)
+    VERSION_1_DIRECTIVES = %i[external requires provides].freeze
+    VERSION_2_DIRECTIVES = %i[shareable inaccessible override].freeze
+
+    def initialize(*args, **kwargs, &block)
+      add_v1_directives(**kwargs)
+      add_v2_directives(**kwargs)
+
+      # Remove the custom kwargs
+      kwargs = kwargs.delete_if do |k, _|
+        VERSION_1_DIRECTIVES.include?(k) || VERSION_2_DIRECTIVES.include?(k)
+      end
+
+      # Pass on the default args:
+      super(*args, **kwargs, &block)
+    end
+
+    private
+
+    def add_v1_directives(external: nil, requires: nil, provides: nil, **_kwargs)
       if external
         add_directive(name: 'external')
       end
+
       if requires
         add_directive(
           name: 'requires',
           arguments: [
             name: 'fields',
-            values: ApolloFederation::FieldSetSerializer.serialize(requires[:fields]),
+            values: ApolloFederation::FieldSetSerializer.serialize(
+              requires[:fields],
+              camelize: requires.fetch(:camelize, true),
+            ),
           ],
         )
       end
+
       if provides
         add_directive(
           name: 'provides',
           arguments: [
             name: 'fields',
-            values: ApolloFederation::FieldSetSerializer.serialize(provides[:fields]),
+            values: ApolloFederation::FieldSetSerializer.serialize(
+              provides[:fields],
+              camelize: provides.fetch(:camelize, true),
+            ),
           ],
         )
       end
 
-      # Pass on the default args:
-      super(*args, **kwargs, &block)
+      nil
+    end
+
+    def add_v2_directives(shareable: nil, inaccessible: nil, override: nil, **_kwargs)
+      if shareable
+        add_directive(name: 'shareable')
+      end
+
+      if inaccessible
+        add_directive(name: 'inaccessible')
+      end
+
+      if override
+        add_directive(
+          name: 'override',
+          arguments: [
+            name: 'from',
+            values: override[:from],
+          ],
+        )
+      end
+
+      nil
     end
   end
 end

data/lib/apollo-federation/field_set_serializer.rb

@@ -6,20 +6,18 @@ module ApolloFederation
   module FieldSetSerializer
     extend self
 
-    def serialize(fields)
+    def serialize(fields, camelize: true)
       case fields
       when Hash
         fields.map do |field, nested_selections|
-          "#{camelize(field)} { #{serialize(nested_selections)} }"
+          "#{camelize(field, camelize)} { #{serialize(nested_selections, camelize: camelize)} }"
         end.join(' ')
       when Array
         fields.map do |field|
-          serialize(field)
+          serialize(field, camelize: camelize)
         end.join(' ')
-      when String
-        fields
-      when Symbol
-        camelize(fields)
+      when Symbol, String
+        camelize(fields, camelize)
       else
         raise ArgumentError, "Unexpected field set type: #{fields.class}"
       end
@@ -27,8 +25,8 @@ module ApolloFederation
 
     private
 
-    def camelize(field)
-      GraphQL::Schema::Member::BuildType.camelize(field.to_s)
+    def camelize(field, camelize)
+      camelize ? GraphQL::Schema::Member::BuildType.camelize(field.to_s) : field.to_s
     end
   end
 end

data/lib/apollo-federation/interface.rb

@@ -18,12 +18,16 @@ module ApolloFederation
         add_directive(name: 'extends')
       end
 
-      def key(fields:)
+      def inaccessible
+        add_directive(name: 'inaccessible')
+      end
+
+      def key(fields:, camelize: true)
         add_directive(
           name: 'key',
           arguments: [
             name: 'fields',
-            values: ApolloFederation::FieldSetSerializer.serialize(fields),
+            values: ApolloFederation::FieldSetSerializer.serialize(fields, camelize: camelize),
           ],
         )
       end

data/lib/apollo-federation/object.rb

@@ -16,12 +16,20 @@ module ApolloFederation
         add_directive(name: 'extends')
       end
 
-      def key(fields:)
+      def shareable
+        add_directive(name: 'shareable')
+      end
+
+      def inaccessible
+        add_directive(name: 'inaccessible')
+      end
+
+      def key(fields:, camelize: true)
         add_directive(
           name: 'key',
           arguments: [
             name: 'fields',
-            values: ApolloFederation::FieldSetSerializer.serialize(fields),
+            values: ApolloFederation::FieldSetSerializer.serialize(fields, camelize: camelize),
           ],
         )
       end

data/lib/apollo-federation/schema.rb

@@ -12,9 +12,30 @@ module ApolloFederation
     end
 
     module CommonMethods
+      FEDERATION_2_PREFIX = <<~SCHEMA
+        extend schema
+          @link(url: "https://specs.apollo.dev/federation/v2.0")
+
+      SCHEMA
+
+      def federation(version: '1.0')
+        @federation_version = version
+      end
+
+      def federation_version
+        @federation_version || '1.0'
+      end
+
+      def federation_2?
+        Gem::Version.new(federation_version.to_s) >= Gem::Version.new('2.0.0')
+      end
+
       def federation_sdl(context: nil)
         document_from_schema = FederatedDocumentFromSchemaDefinition.new(self, context: context)
-        GraphQL::Language::Printer.new.print(document_from_schema.document)
+
+        output = GraphQL::Language::Printer.new.print(document_from_schema.document)
+        output.prepend(FEDERATION_2_PREFIX) if federation_2?
+        output
       end
 
       def query(new_query_object = nil)

data/lib/apollo-federation/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: apollo-federation
 version: !ruby/object:Gem::Version
-  version: 2.2.3
+  version: 3.1.0
 platform: ruby
 authors:
 - Noa Elad
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-22 00:00:00.000000000 Z
+date: 2022-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: graphql