Merge branch 'master' into patch-1

Author: Minh Cung

.changeset/@graphql-codegen_client-preset-8757-dependencies.md

@@ -0,0 +1,5 @@
+---
+"@graphql-codegen/client-preset": patch
+---
+dependencies updates:
+  - Added dependency [`@graphql-tools/documents@^0.1.0` ↗︎](https://www.npmjs.com/package/@graphql-tools/documents/v/0.1.0) (to `dependencies`)

.changeset/big-mice-switch.md

@@ -0,0 +1,5 @@
+---
+'@graphql-codegen/cli': patch
+---
+
+fix: `gqlMagicComment` type

.changeset/lemon-zebras-hunt.md

@@ -0,0 +1,52 @@
+---
+'@graphql-codegen/client-preset': minor
+---
+
+Add support for persisted documents.
+
+You can now generate and embed a persisted documents hash for the executable documents.
+
+```ts
+/** codegen.ts */
+import { CodegenConfig } from '@graphql-codegen/cli'
+
+const config: CodegenConfig = {
+  schema: 'https://swapi-graphql.netlify.app/.netlify/functions/index',
+  documents: ['src/**/*.tsx'],
+  ignoreNoDocuments: true, // for better experience with the watcher
+  generates: {
+    './src/gql/': {
+      preset: 'client',
+      plugins: [],
+      presetConfig: {
+        persistedOperations: true,
+      }
+    }
+  }
+}
+
+export default config
+```
+
+This will generate `./src/gql/persisted-documents.json` (dictionary of hashes with their operation string).
+
+In addition to that each generated document node will have a `__meta__.hash` property.
+
+```ts
+import { gql } from './gql.js'
+
+const allFilmsWithVariablesQueryDocument = graphql(/* GraphQL */ `
+  query allFilmsWithVariablesQuery($first: Int!) {
+    allFilms(first: $first) {
+      edges {
+        node {
+          ...FilmItem
+        }
+      }
+    }
+  }
+`)
+
+console.log((allFilmsWithVariablesQueryDocument as any)["__meta__"]["hash"])
+```
+

.changeset/tasty-adults-doubt.md

@@ -0,0 +1,54 @@
+---
+'@graphql-codegen/client-preset': minor
+---
+
+Add support for embedding metadata in the document AST.
+
+It is now possible to embed metadata (e.g. for your GraphQL client within the emitted code).
+
+```ts
+/** codegen.ts */
+import { CodegenConfig } from '@graphql-codegen/cli'
+
+const config: CodegenConfig = {
+  schema: 'https://swapi-graphql.netlify.app/.netlify/functions/index',
+  documents: ['src/**/*.tsx'],
+  ignoreNoDocuments: true, // for better experience with the watcher
+  generates: {
+    './src/gql/': {
+      preset: 'client',
+      plugins: [],
+      presetConfig: {
+        onExecutableDocumentNode(documentNode) {
+          return {
+            operation: documentNode.definitions[0].operation,
+            name: documentNode.definitions[0].name.value
+          }
+        }
+      }
+    }
+  }
+}
+
+export default config
+```
+
+You can then access the metadata via the `__meta__` property on the document node.
+
+```ts
+import { gql } from './gql.js'
+
+const allFilmsWithVariablesQueryDocument = graphql(/* GraphQL */ `
+  query allFilmsWithVariablesQuery($first: Int!) {
+    allFilms(first: $first) {
+      edges {
+        node {
+          ...FilmItem
+        }
+      }
+    }
+  }
+`)
+
+console.log((allFilmsWithVariablesQueryDocument as any)["__meta__"])
+```

.changeset/unlucky-suits-pay.md

@@ -0,0 +1,5 @@
+---
+'@graphql-codegen/visitor-plugin-common': patch
+---
+
+Fix issue where visitor-plugin-common emitted ESM imports for Operations when emitLegacyCommonJSImports is true

.eslintrc.cjs

@@ -0,0 +1,55 @@
+module.exports = {
+  root: true,
+  extends: ['@theguild'],
+  rules: {
+    'no-empty': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-use-before-define': 'off',
+    '@typescript-eslint/no-namespace': 'off',
+    '@typescript-eslint/no-empty-interface': 'off',
+    '@typescript-eslint/no-empty-function': 'off',
+    '@typescript-eslint/no-var-requires': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-non-null-assertion': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/ban-ts-ignore': 'off',
+    '@typescript-eslint/ban-types': 'off',
+    'import/no-extraneous-dependencies': [
+      'error',
+      { devDependencies: ['**/*.test.ts', '**/*.spec.ts', '**/test/**/*.ts'] },
+    ],
+
+    // todo: enable
+    'unicorn/filename-case': 'off',
+    'import/extensions': 'off',
+    'import/no-default-export': 'off',
+    // todo: enable in v3
+    'unicorn/prefer-node-protocol': 'off',
+    'prefer-object-has-own': 'off',
+  },
+  env: {
+    node: true,
+  },
+  overrides: [
+    {
+      files: ['website/**'],
+      extends: '@theguild/eslint-config/react',
+    },
+    {
+      files: ['**/tests/**/*.{js,ts,tsx}', '**/graphql-codegen-testing/**/*.ts', '*.spec.ts'],
+      env: {
+        jest: true,
+      },
+      rules: {
+        'import/no-extraneous-dependencies': 'off',
+      },
+    },
+    {
+      files: '**/tests/fixtures/*.ts',
+      rules: {
+        '@typescript-eslint/no-unused-vars': 'off',
+      },
+    },
+  ],
+  ignorePatterns: ['dev-test', 'examples/front-end', 'website'],
+};

.eslintrc.json

@@ -50,21 +50,21 @@ body:
     validations:
       required: true
   - type: textarea
-    id: description
+    id: solution
     attributes:
       label: Describe the solution you'd like
       description: 'A clear and concise description of what you want to happen.'
     validations:
       required: true
   - type: textarea
-    id: description
+    id: alternatives
     attributes:
       label: Describe alternatives you've considered
       description: "A clear and concise description of any alternative solutions or features you've considered."
     validations:
       required: false
   - type: textarea
-    id: description
+    id: context
     attributes:
       label: Is your feature request related to a problem? Please describe.
       description: 'Add any other context or screenshots about the feature request here.'

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -5,17 +5,18 @@
 coverage
 *.log
 node_modules/
-temp
+temp/
 junit.xml
 dist/
 .bob/
 out.txt
 .cache
 tsconfig.tsbuildinfo
-.yarn
+.yarn/
 recompile.sh
 
 .next/
-out
+out/
 website/public/sitemap.xml
 website/public/_redirects
+.eslintcache

.gitignore

@@ -1 +1 @@
-16
+18

.nvmrc

@@ -22,3 +22,4 @@ website/src/pages/plugins/presets/near-operation-file-preset.mdx
 examples/**/gql/**
 
 website/algolia-lockfile.json
+temp/

.prettierignore

@@ -1,55 +1,59 @@
-[![CodeGen](./logo.svg)](https://graphql-code-generator.com)
+[![CodeGen](./logo.svg)](https://the-guild.dev/graphql/codegen)
 
 [![npm version](https://badge.fury.io/js/%40graphql-codegen%2Fcli.svg)](https://badge.fury.io/js/%40graphql-codegen%2Fcli)
 
-[graphql-code-generator.com](https://graphql-code-generator.com)
+[https://the-guild.dev/graphql/codegen](https://the-guild.dev/graphql/codegen)
 
 GraphQL Code Generator is a tool that generates code out of your GraphQL schema. Whether you are developing a frontend or backend, you can utilize GraphQL Code Generator to generate output from your GraphQL Schema and GraphQL Documents (query/mutation/subscription/fragment).
 
 By analyzing the schema and documents and parsing it, GraphQL Code Generator can output code at a wide variety of formats, based on pre-defined templates or based on custom user-defined ones. Regardless of the language that you're using, GraphQL Code Generator got you covered.
 
 GraphQL Code Generator lets you choose the output that you need, based on _plugins_, which are very flexible and customizable. You can also write your _plugins_ to generate custom outputs that match your needs.
 
-You can try this tool live on your browser and see some useful examples. Check out [GraphQL Code Generator Live Examples](https://graphql-code-generator.com/#live-demo).
+You can try this tool live on your browser and see some useful examples. Check out [GraphQL Code Generator Live Examples](https://the-guild.dev/graphql/codegen/#live-demo).
 
-We currently support and maintain [these plugins](https://graphql-code-generator.com/plugins) (TypeScript, Flow, React, Angular, MongoDB, Stencil, Reason, and some more), and there is an active community that writes and maintains custom plugins.
+We currently support and maintain [these plugins](https://the-guild.dev/graphql/codegen/plugins) (TypeScript, Flow, React, Angular, MongoDB, Stencil, Reason, and some more), and there is an active community that writes and maintains custom plugins.
 
-### Quick Start
+## Quick Start
 
-> You can find the complete instructions in [GraphQL-Code-Generator website](https://graphql-code-generator.com/docs/getting-started/installation).
+> You can find the complete instructions in [GraphQL Code Generator website](https://the-guild.dev/graphql/codegen/docs/getting-started/installation).
 
 Start by installing the basic deps of GraphQL Codegen;
 
-    yarn add graphql
-    yarn add -D @graphql-codegen/cli
+```bash
+yarn add graphql
+yarn add -D @graphql-codegen/cli
+```
 
 GraphQL Code Generator lets you setup everything by simply running the following command:
 
-    yarn graphql-codegen init
+```bash
+yarn graphql-codegen init
+```
 
 Question by question, it will guide you through the whole process of setting up a schema, selecting plugins, picking a destination of a generated file, and a lot more.
 
-If you wish to [manually setup codegen, follow these instructions](https://graphql-code-generator.com/docs/getting-started/installation).
+If you wish to [manually setup codegen, follow these instructions](https://the-guild.dev/graphql/codegen/docs/getting-started/installation).
 
-### Links
+## Links
 
-Besides our [docs page](https://graphql-code-generator.com/docs/getting-started), feel free to go through our published Medium articles to get a better grasp of what GraphQL Code Generator is all about:
+Besides our [docs page](https://the-guild.dev/graphql/codegen/docs/getting-started), feel free to go through our published Medium articles to get a better grasp of what GraphQL Code Generator is all about:
 
-- [All available plugins & presets](https://graphql-code-generator.com/plugins)
+- [All available plugins & presets](https://the-guild.dev/graphql/codegen/plugins)
 
-### Contributing
+## Contributing
 
 If this is your first time contributing to this project, please do read our [Contributor Workflow Guide](https://github.com/the-guild-org/Stack/blob/master/CONTRIBUTING.md) before you get started off.
 
 Feel free to open issues and pull requests. We're always welcome support from the community.
 
-For a contribution guide specific to this project, please refer to: http://graphql-code-generator.com/docs/custom-codegen/contributing
+For a contribution guide specific to this project, please refer to: http://the-guild.dev/graphql/codegen/docs/custom-codegen/contributing
 
-### Code of Conduct
+## Code of Conduct
 
-Help us keep GraphQL Codegenerator open and inclusive. Please read and follow our [Code of Conduct](https://github.com/the-guild-org/Stack/blob/master/CODE_OF_CONDUCT.md) as adopted from [Contributor Covenant](https://www.contributor-covenant.org/)
+Help us keep GraphQL Code Generator open and inclusive. Please read and follow our [Code of Conduct](https://github.com/the-guild-org/Stack/blob/master/CODE_OF_CONDUCT.md) as adopted from [Contributor Covenant](https://contributor-covenant.org)
 
-### License
+## License
 
 [![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg?maxAge=2592000)](https://raw.githubusercontent.com/apollostack/apollo-ios/master/LICENSE)