graphql-stitching 0.0.1 → 0.2.1

data/lib/graphql/stitching/util.rb

@@ -4,7 +4,7 @@ module GraphQL
   module Stitching
     class Util
 
-      # gets the named type at the bottom of a non-null/list wrapper chain
+      # gets the named type at the bottom of a non-null/list wrapper tree
       def self.get_named_type(type)
         while type.respond_to?(:of_type)
           type = type.of_type
@@ -12,6 +12,14 @@ module GraphQL
         type
       end
 
+      # strips non-null wrappers from a type
+      def self.unwrap_non_null(type)
+        while type.is_a?(GraphQL::Schema::NonNull)
+          type = type.of_type
+        end
+        type
+      end
+
       # gets a deep structural description of a list value type
       def self.get_list_structure(type)
         structure = []

data/lib/graphql/stitching/version.rb

@@ -2,6 +2,6 @@
 
 module GraphQL
   module Stitching
-    VERSION = "0.0.1"
+    VERSION = "0.2.1"
   end
 end

data/lib/graphql/stitching.rb

@@ -13,6 +13,10 @@ module GraphQL
       end
 
       attr_writer :stitch_directive
+
+      def stitching_directive_names
+        [stitch_directive]
+      end
     end
   end
 end
@@ -20,11 +24,11 @@ end
 require_relative "stitching/gateway"
 require_relative "stitching/supergraph"
 require_relative "stitching/composer"
-require_relative "stitching/document"
 require_relative "stitching/executor"
 require_relative "stitching/planner_operation"
 require_relative "stitching/planner"
 require_relative "stitching/remote_client"
+require_relative "stitching/request"
 require_relative "stitching/shaper"
 require_relative "stitching/util"
 require_relative "stitching/version"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: graphql-stitching
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.2.1
 platform: ruby
 authors:
 - Greg MacWilliam
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-02-09 00:00:00.000000000 Z
+date: 2023-02-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: graphql
@@ -66,7 +66,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.12'
-description: GraphQL schema stitching for Ruby
+description: Combine GraphQL services into one unified graph
 email:
 executables: []
 extensions: []
@@ -74,23 +74,20 @@ extra_rdoc_files: []
 files:
 - ".github/workflows/ci.yml"
 - ".gitignore"
-- ".ruby-version"
 - Gemfile
-- Gemfile.lock
 - LICENSE
 - Procfile
 - README.md
 - Rakefile
 - docs/README.md
 - docs/composer.md
-- docs/document.md
 - docs/executor.md
 - docs/gateway.md
 - docs/images/library.png
 - docs/images/merging.png
 - docs/images/stitching.png
 - docs/planner.md
-- docs/shaper.md
+- docs/request.md
 - docs/supergraph.md
 - example/gateway.rb
 - example/graphiql.html
@@ -102,12 +99,12 @@ files:
 - lib/graphql/stitching/composer/base_validator.rb
 - lib/graphql/stitching/composer/validate_boundaries.rb
 - lib/graphql/stitching/composer/validate_interfaces.rb
-- lib/graphql/stitching/document.rb
 - lib/graphql/stitching/executor.rb
 - lib/graphql/stitching/gateway.rb
 - lib/graphql/stitching/planner.rb
 - lib/graphql/stitching/planner_operation.rb
 - lib/graphql/stitching/remote_client.rb
+- lib/graphql/stitching/request.rb
 - lib/graphql/stitching/shaper.rb
 - lib/graphql/stitching/supergraph.rb
 - lib/graphql/stitching/util.rb
@@ -128,7 +125,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.1
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/.ruby-version

@@ -1 +0,0 @@
-3.1.1

data/Gemfile.lock

@@ -1,49 +0,0 @@
-PATH
-  remote: .
-  specs:
-    graphql-stitching (0.0.1)
-      graphql (~> 2.0.16)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    byebug (11.1.3)
-    coderay (1.1.3)
-    foreman (0.87.2)
-    graphql (2.0.16)
-    method_source (1.0.0)
-    minitest (5.17.0)
-    pry (0.14.2)
-      coderay (~> 1.1)
-      method_source (~> 1.0)
-    pry-byebug (3.10.1)
-      byebug (~> 11.0)
-      pry (>= 0.13, < 0.15)
-    rack (3.0.4.1)
-    rackup (2.1.0)
-      rack (>= 3)
-      webrick (~> 1.8)
-    rake (12.3.3)
-    warning (1.3.0)
-    webrick (1.8.1)
-
-PLATFORMS
-  arm64-darwin-21
-  ruby
-  x86_64-darwin-21
-  x86_64-linux
-
-DEPENDENCIES
-  bundler (~> 2.0)
-  foreman
-  graphql-stitching!
-  minitest (~> 5.12)
-  pry
-  pry-byebug
-  rack
-  rackup
-  rake (~> 12.0)
-  warning
-
-BUNDLED WITH
-   2.4.1

data/docs/document.md

@@ -1,15 +0,0 @@
-## GraphQL::Stitching::Document
-
-A `Document` wraps a parsed GraphQL request, and handles the logistics of extracting its appropriate operation, variable definitions, and fragments. A `Document` should be built once for a request and passed through to other stitching components that utilize document information.
-
-```ruby
-query = "query FetchMovie($id: ID!) { movie(id:$id) { id genre } }"
-document = GraphQL::Stitching::Document.new(query, operation_name: "FetchMovie")
-
-document.ast # parsed AST via GraphQL.parse
-document.string # normalized printed string
-document.digest # SHA digest of the normalized string
-
-document.variables # mapping of variable names to type definitions
-document.fragments # mapping of fragment names to fragment definitions
-```

data/docs/shaper.md

@@ -1,20 +0,0 @@
-## GraphQL::Stitching::Shaper
-
-The `Shaper` takes the raw output generated by the `GraphQL::Stitching::Executor` and does the final shaping and
-cleaning. It removes data that was added while building the result, it also handles cleaning up violations that can
-only occur at the end, such as bubbling up null violoations.
-
-See the [Executor](./docs/executor.md)
-
-```ruby
-raw_result = GraphQL::Stitching::Executor.new(
-  supergraph: supergraph,
-  plan: plan.to_h,
-  variables: variables,
-).perform(document)
-
-final_result = GraphQL::Stitching::Shaper.new(
-  supergraph: supergraph,
-  document: document,
-  raw: raw_result).perform!
-```

data/lib/graphql/stitching/document.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-module GraphQL
-  module Stitching
-    class Document
-      SUPPORTED_OPERATIONS = ["query", "mutation"].freeze
-
-      attr_reader :ast, :operation_name
-
-      def initialize(string_or_ast, operation_name: nil)
-        @ast = if string_or_ast.is_a?(String)
-          GraphQL.parse(string_or_ast)
-        else
-          string_or_ast
-        end
-
-        @operation_name = operation_name
-      end
-
-      def string
-        @string ||= GraphQL::Language::Printer.new.print(@ast)
-      end
-
-      def digest
-        @digest ||= Digest::SHA2.hexdigest(string)
-      end
-
-      def operation
-        @operation ||= begin
-          operation_defs = @ast.definitions.select do |d|
-            next unless d.is_a?(GraphQL::Language::Nodes::OperationDefinition)
-            next unless SUPPORTED_OPERATIONS.include?(d.operation_type)
-            @operation_name ? d.name == @operation_name : true
-          end
-
-          if operation_defs.length < 1
-            raise GraphQL::ExecutionError, "Invalid root operation."
-          elsif operation_defs.length > 1
-            raise GraphQL::ExecutionError, "An operation name is required when sending multiple operations."
-          end
-
-          operation_defs.first
-        end
-      end
-
-      def variable_definitions
-        @variable_definitions ||= operation.variables.each_with_object({}) do |v, memo|
-          memo[v.name] = v.type
-        end
-      end
-
-      def fragment_definitions
-        @fragment_definitions ||= @ast.definitions.each_with_object({}) do |d, memo|
-          memo[d.name] = d if d.is_a?(GraphQL::Language::Nodes::FragmentDefinition)
-        end
-      end
-    end
-  end
-end