Tool to merge schema with @import directive

change/@graphitation-cli-279920a9-57d9-41b8-8f1c-b268a7b9b96f.json

@@ -0,0 +1,7 @@
+{
+  "type": "minor",
+  "comment": "Added a tool and CLI command to merge schema using @import dependency resolution",
+  "packageName": "@graphitation/cli",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

change/@graphitation-merge-schemas-2a4d0a24-90a3-4236-a085-a166eaac52de.json

@@ -0,0 +1,7 @@
+{
+  "type": "minor",
+  "comment": "Added a tool and CLI command to merge schema using @import dependency resolution",
+  "packageName": "@graphitation/merge-schemas",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

change/@graphitation-supermassive-c97c9fae-90fd-4117-ae11-534420fa5b5e.json

@@ -0,0 +1,7 @@
+{
+  "type": "minor",
+  "comment": "Added a tool and CLI command to merge schema using @import dependency resolution",
+  "packageName": "@graphitation/supermassive",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

change/@graphitation-ts-codegen-430a3d13-06fd-4918-87de-0b9e7b8e4e8b.json

@@ -0,0 +1,7 @@
+{
+  "type": "minor",
+  "comment": "Added a tool and CLI command to merge schema using @import dependency resolution",
+  "packageName": "@graphitation/ts-codegen",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

packages/cli/.eslintrc.json

@@ -1,4 +1,4 @@
 {
-  "extends": ["../../.eslintrc.json"],
+  "extends": ["../../.eslintrc.json", "plugin:@typescript-eslint/recommended"],
   "root": true
 }

packages/cli/bin/graphitation.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+(function () {
+  require("@graphitation/cli/lib/graphitation")
+    .graphitation()
+    .parseAsync(process.argv);
+})();

packages/cli/bin/supermassive.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 
 (function () {
-  require("@graphitation/cli/lib/supermassive")
-    .supermassive()
+  console.warn("DEPRECATED - use graphitation command");
+  require("@graphitation/cli/lib/graphitation")
+    .graphitation()
     .parseAsync(process.argv);
 })();

packages/cli/package.json

@@ -3,6 +3,7 @@
   "license": "MIT",
   "version": "1.5.5",
   "bin": {
+    "graphitation": "./bin/graphitation.js",
     "supermassive": "./bin/supermassive.js"
   },
   "repository": {
@@ -23,6 +24,7 @@
   },
   "dependencies": {
     "@graphitation/supermassive-extractors": "^2.1.0",
+    "@graphitation/merge-schemas": "^0.1.0",
     "@graphitation/ts-codegen": "^2.4.0",
     "commander": "^8.3.0",
     "typescript": "^4.4.3 <4.5.0",

packages/cli/src/__tests__/__snapshots__/mergeSchemas.ts.snap

@@ -0,0 +1,82 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`graphitation complains about missing imports, but allows passing with a flag 1`] = `
+"# This file was automatically generated (by @graphitation/cli) and should not be edited.
+extend type NonType {
+  foo: DateTime
+}
+"
+`;
+
+exports[`graphitation generates from glob 1`] = `
+"# This file was automatically generated (by @graphitation/cli) and should not be edited.
+type Person implements Node {
+  id: ID!
+}
+
+"""ISO8601 Date Time"""
+scalar DateTime
+
+"""
+Define a type to be compliant with the Global Object Identification best-practice spec.
+https://graphql.org/learn/global-object-identification/
+"""
+interface Node {
+  id: ID!
+}
+
+type Bar implements Node {
+  id: ID!
+}
+
+type Foo implements Node {
+  id: ID!
+  timestamp: DateTime
+}
+
+type Frobnar implements Node {
+  id: ID!
+}
+
+extend type Person {
+  foo: Foo
+}
+"
+`;
+
+exports[`graphitation generates from single file 1`] = `
+"# This file was automatically generated (by @graphitation/cli) and should not be edited.
+type Baz implements Node {
+  id: ID!
+  foo: Foo
+}
+
+type Person implements Node {
+  id: ID!
+}
+
+"""ISO8601 Date Time"""
+scalar DateTime
+
+"""
+Define a type to be compliant with the Global Object Identification best-practice spec.
+https://graphql.org/learn/global-object-identification/
+"""
+interface Node {
+  id: ID!
+}
+
+type Bar implements Node {
+  id: ID!
+}
+
+type Foo implements Node {
+  id: ID!
+  timestamp: DateTime
+}
+
+extend type Person {
+  foo: Foo
+}
+"
+`;

packages/cli/src/__tests__/__snapshots__/typeDefsToImplicitResolvers.test.ts.snap

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`supermassive should generate 1`] = `
+exports[`graphitation should generate 1`] = `
 "import { GraphQLList, GraphQLNonNull, GraphQLID, GraphQLString, GraphQLInt, GraphQLFloat, GraphQLBoolean, GraphQLEnumType } from "graphql";
 import { Resolvers, UnionTypeResolver, EnumTypeResolver, ObjectTypeResolver, InterfaceTypeResolver } from "@graphitation/supermassive";
 const SearchResult: UnionTypeResolver = { __types: ["Person", "Starship", "Transport", "Species", "Vehicle", "Planet", "Film"], __resolveType: undefined };

packages/cli/src/__tests__/fixtures/mergeSchemas/FirstClassTypes.graphql

@@ -0,0 +1,5 @@
+extend schema @import(from: "./FoundationalTypes.graphql", defs: ["Node"])
+
+type Person implements Node {
+  id: ID!
+}

packages/cli/src/__tests__/fixtures/mergeSchemas/FoundationalTypes.graphql

@@ -0,0 +1,121 @@
+"""
+@oneOf is a proposed directive currently in RFC stage: https://github.com/graphql/graphql-spec/pull/825
+OneOf Input Objects are a special variant of Input Objects where the type system asserts
+that exactly one of the fields must be set and non-null, all others being omitted.
+Below is a placeholder definition of the directive until it is part of the spec
+"""
+directive @oneOf on INPUT_OBJECT
+
+type Query {
+  noop: Boolean # TODO: Needs to be removed during schema merging.
+}
+
+type Mutation {
+  noop: Boolean # TODO: Needs to be removed during schema merging.
+}
+
+"""
+Define a type to be compliant with the Global Object Identification best-practice spec.
+https://graphql.org/learn/global-object-identification/
+"""
+interface Node {
+  id: ID!
+}
+
+"""
+A type describing a relationship between Nodes.
+"""
+interface ConnectionEdge {
+  """
+  The Node that this edge points to
+  """
+  node: Node!
+}
+
+"""
+A ConnectionEdge with Cursor Pagination
+"""
+interface ConnectionEdgeWithCursorPagination implements ConnectionEdge {
+  """
+  The 'cursor' of this edge in the list of edges,
+  used to paginate relative to this item when performing
+  future queries.
+
+  See https://graphql.org/learn/pagination/
+  """
+  cursor: String!
+
+  """
+  The Node that this edge points to
+  """
+  node: Node!
+}
+
+"""
+The base Connection type.
+
+See https://www.apollographql.com/blog/explaining-graphql-connections-c48b7c3d6976
+"""
+interface Connection {
+  """
+  Edges to the member nodes of this collection
+  """
+  edges: [ConnectionEdge!]!
+}
+
+interface ConnectionWithCursorPagination {
+  """
+  Edges to the member nodes of this collection
+  """
+  edges: [ConnectionEdgeWithCursorPagination!]!
+
+  """
+  Information about cursors and pagination in the list of
+  edges above.
+  """
+  pageInfo: PageInfoWithCursorPagination!
+}
+
+"""
+The Cursor Pagination PageInfo type.
+
+https://relay.dev/graphql/connections.htm#sec-undefined.PageInfo
+"""
+type PageInfoWithCursorPagination {
+  """
+  True if there is another page after this one
+  """
+  hasNextPage: Boolean!
+
+  """
+  True if there is another page before this one
+  """
+  hasPreviousPage: Boolean!
+
+  """
+  Identifier of the first edge in this page
+  """
+  startCursor: String
+
+  """
+  Identifier of the last edge in this page
+  """
+  endCursor: String
+}
+
+interface MutationFailure {
+  failureCode: String!
+  """
+  Localized error message
+  """
+  errorMessage: String!
+}
+
+"""
+ISO8601 Date Time
+"""
+scalar DateTime
+
+scalar Cursor
+
+scalar BigInt

packages/cli/src/__tests__/fixtures/mergeSchemas/core.graphql

@@ -0,0 +1,20 @@
+extend schema
+  @import(
+    from: "./FoundationalTypes"
+    defs: [
+      "Query"
+      "Mutation"
+      "Subscription"
+      "Node"
+      "oneOf"
+      "ConnectionEdge"
+      "ConnectionEdgeWithCursorPagination"
+      "Connection"
+      "ConnectionWithCursorPagination"
+      "MutationFailure"
+      "DateTime"
+      "Cursor"
+      "BigInt"
+    ]
+  )
+  @import(from: "./FirstClassTypes", defs: ["Person"])

packages/cli/src/__tests__/fixtures/mergeSchemas/entry-point.graphql

@@ -0,0 +1,8 @@
+extend schema
+  @import(from: "./test-import", defs: ["Foo", "Bar"], extends: ["Person"])
+  @import(from: "./core", defs: ["Node", "Person"])
+
+type Baz implements Node {
+  id: ID!
+  foo: Foo
+}

packages/cli/src/__tests__/fixtures/mergeSchemas/missing-types-entry-point.graphql

@@ -0,0 +1,3 @@
+extend type NonType {
+  foo: DateTime
+}

packages/cli/src/__tests__/fixtures/mergeSchemas/missing-types.graphql

@@ -0,0 +1,5 @@
+extend schema @import(from: "./core", defs: ["Nodeee"])
+
+extend type NonType {
+  foo: DateTime
+}

packages/cli/src/__tests__/fixtures/mergeSchemas/test-import.graphql

@@ -0,0 +1,18 @@
+extend schema @import(from: "./core", defs: ["Node", "DateTime", "Person"])
+
+type Foo implements Node {
+  id: ID!
+  timestamp: DateTime
+}
+
+type Bar implements Node {
+  id: ID!
+}
+
+extend type Person {
+  foo: Foo
+}
+
+type Frobnar implements Node {
+  id: ID!
+}