Re-export all public graphql-tag exports

Make sure we're re-exporting all public `graphql-tag` exports,
while ensuring that valid types exist.

src/config/jest/setup.ts

@@ -1,6 +1,6 @@
-import { disableFragmentWarnings } from 'graphql-tag';
+import gql from 'graphql-tag';
 
 // Turn off warnings for repeated fragment names
-disableFragmentWarnings();
+gql.disableFragmentWarnings();
 
 process.on('unhandledRejection', () => {});

src/core/index.ts

@@ -71,4 +71,29 @@ export { Observable } from '../utilities/observables/Observable';
 
 /* Supporting */
 
-export { default as gql } from 'graphql-tag';
+// Note that importing `gql` by itself, then destructuring
+// additional properties separately before exporting, is intentional.
+// Due to the way the `graphql-tag` library is setup, certain bundlers
+// can't find the properties added to the exported `gql` function without
+// additional guidance (e.g. Rollup - see
+// https://rollupjs.org/guide/en/#error-name-is-not-exported-by-module).
+// Instead of having people that are using bundlers with `@apollo/client` add
+// extra bundler config to help `graphql-tag` exports be found (which would be
+// awkward since they aren't importing `graphql-tag` themselves), this
+// workaround of pulling the extra properties off the `gql` function,
+// then re-exporting them separately, helps keeps bundlers happy without any
+// additional config changes.
+import gql from 'graphql-tag';
+const {
+  resetCaches,
+  disableFragmentWarnings,
+  enableExperimentalFragmentVariables,
+  disableExperimentalFragmentVariables
+} = gql;
+export {
+  gql,
+  resetCaches,
+  disableFragmentWarnings,
+  enableExperimentalFragmentVariables,
+  disableExperimentalFragmentVariables
+};

src/types/graphql-tag.d.ts

@@ -0,0 +1,16 @@
+// The `graphql-tag` package currently ships with types that aren't quite
+// representative of how the package is setup, and its exports are handled.
+// This type file is intended to better reflect how the package is setup,
+// but should be considered temporary. At some point `graphql-tag` will
+// be fully updated to use Typescript, and these discrepancies will be fixed.
+
+declare module 'graphql-tag' {
+  function gql(literals: any, ...placeholders: any[]): any;
+  namespace gql {
+    export function resetCaches(): void;
+    export function disableFragmentWarnings(): void;
+    export function enableExperimentalFragmentVariables(): void;
+    export function disableExperimentalFragmentVariables(): void;
+  }
+  export default gql;
+}

tsconfig.json

@@ -15,7 +15,11 @@
     "esModuleInterop": true,
     "outDir": "./dist",
     "lib": ["es2015", "esnext.asynciterable", "dom"],
-    "jsx": "react"
+    "jsx": "react",
+    "typeRoots": [
+      "src/types",
+      "node_modules/@types"
+    ]
   },
   "include": ["src/**/*.ts"],
   "exclude": [