@graphql-codegen/client-preset
Version:
GraphQL Code Generator preset for client.
244 lines (243 loc) • 11.5 kB
JavaScript
import * as addPlugin from '@graphql-codegen/add';
import * as gqlTagPlugin from '@graphql-codegen/gql-tag-operations';
import * as typedDocumentNodePlugin from '@graphql-codegen/typed-document-node';
import * as typescriptPlugin from '@graphql-codegen/typescript';
import * as typescriptOperationPlugin from '@graphql-codegen/typescript-operations';
import { ClientSideBaseVisitor, DocumentMode } from '@graphql-codegen/visitor-plugin-common';
import * as fragmentMaskingPlugin from './fragment-masking-plugin.js';
import { generateDocumentHash, normalizeAndPrintDocumentNode } from './persisted-documents.js';
import { processSources } from './process-sources.js';
export { default as babelOptimizerPlugin } from './babel.js';
const isOutputFolderLike = (baseOutputDir) => baseOutputDir.endsWith('/');
export const preset = {
prepareDocuments: (outputFilePath, outputSpecificDocuments) => [...outputSpecificDocuments, `!${outputFilePath}`],
buildGeneratesSection: options => {
if (!isOutputFolderLike(options.baseOutputDir)) {
throw new Error('[client-preset] target output should be a directory, ex: "src/gql/". Make sure you add "/" at the end of the directory path');
}
if (options.plugins.length > 0 && Object.keys(options.plugins).some(p => p.startsWith('typescript'))) {
throw new Error('[client-preset] providing typescript-based `plugins` with `preset: "client" leads to duplicated generated types');
}
const isPersistedOperations = !!options.presetConfig?.persistedDocuments;
const reexports = [];
// the `client` preset is restricting the config options inherited from `typescript`, `typescript-operations` and others.
const forwardedConfig = {
scalars: options.config.scalars,
defaultScalarType: options.config.defaultScalarType,
strictScalars: options.config.strictScalars,
namingConvention: options.config.namingConvention,
useTypeImports: options.config.useTypeImports,
skipTypename: options.config.skipTypename,
arrayInputCoercion: options.config.arrayInputCoercion,
enumsAsTypes: options.config.enumsAsTypes,
enumsAsConst: options.config.enumsAsConst,
futureProofEnums: options.config.futureProofEnums,
dedupeFragments: options.config.dedupeFragments,
nonOptionalTypename: options.config.nonOptionalTypename,
avoidOptionals: options.config.avoidOptionals,
documentMode: options.config.documentMode,
skipTypeNameForRoot: options.config.skipTypeNameForRoot,
onlyOperationTypes: options.config.onlyOperationTypes,
onlyEnumTypes: options.config.onlyEnumTypes,
};
const visitor = new ClientSideBaseVisitor(options.schemaAst, [], options.config, options.config);
let fragmentMaskingConfig = null;
if (typeof options?.presetConfig?.fragmentMasking === 'object') {
fragmentMaskingConfig = options.presetConfig.fragmentMasking;
}
else if (options?.presetConfig?.fragmentMasking !== false) {
// `true` by default
fragmentMaskingConfig = {};
}
const onExecutableDocumentNodeHook = options.presetConfig.onExecutableDocumentNode ?? null;
const isMaskingFragments = fragmentMaskingConfig != null;
const persistedDocuments = options.presetConfig.persistedDocuments
? {
hashPropertyName: (typeof options.presetConfig.persistedDocuments === 'object' &&
options.presetConfig.persistedDocuments.hashPropertyName) ||
'hash',
omitDefinitions: (typeof options.presetConfig.persistedDocuments === 'object' &&
options.presetConfig.persistedDocuments.mode) === 'replaceDocumentWithHash' || false,
hashAlgorithm: (typeof options.presetConfig.persistedDocuments === 'object' &&
options.presetConfig.persistedDocuments.hashAlgorithm) ||
'sha1',
}
: null;
const sourcesWithOperations = processSources(options.documents, node => {
if (node.kind === 'FragmentDefinition') {
return visitor.getFragmentVariableName(node);
}
return visitor.getOperationVariableName(node);
});
const sources = sourcesWithOperations.map(({ source }) => source);
const tdnFinished = createDeferred();
const persistedDocumentsMap = new Map();
const pluginMap = {
...options.pluginMap,
[`add`]: addPlugin,
[`typescript`]: typescriptPlugin,
[`typescript-operations`]: typescriptOperationPlugin,
[`typed-document-node`]: {
...typedDocumentNodePlugin,
plugin: async (...args) => {
try {
return await typedDocumentNodePlugin.plugin(...args);
}
finally {
tdnFinished.resolve();
}
},
},
[`gen-dts`]: gqlTagPlugin,
};
function onExecutableDocumentNode(documentNode) {
const meta = onExecutableDocumentNodeHook?.(documentNode);
if (persistedDocuments) {
const documentString = normalizeAndPrintDocumentNode(documentNode);
const hash = generateDocumentHash(documentString, persistedDocuments.hashAlgorithm);
persistedDocumentsMap.set(hash, documentString);
return { ...meta, [persistedDocuments.hashPropertyName]: hash };
}
if (meta) {
return meta;
}
return undefined;
}
const plugins = [
{ [`add`]: { content: `/* eslint-disable */` } },
{ [`typescript`]: {} },
{ [`typescript-operations`]: {} },
{
[`typed-document-node`]: {
unstable_onExecutableDocumentNode: onExecutableDocumentNode,
unstable_omitDefinitions: persistedDocuments?.omitDefinitions ?? false,
},
},
...options.plugins,
];
const genDtsPlugins = [
{ [`add`]: { content: `/* eslint-disable */` } },
{ [`gen-dts`]: { sourcesWithOperations } },
];
const gqlArtifactFileExtension = '.ts';
reexports.push('gql');
const config = {
...options.config,
inlineFragmentTypes: isMaskingFragments ? 'mask' : options.config['inlineFragmentTypes'],
};
let fragmentMaskingFileGenerateConfig = null;
if (isMaskingFragments === true) {
const fragmentMaskingArtifactFileExtension = '.ts';
reexports.push('fragment-masking');
fragmentMaskingFileGenerateConfig = {
filename: `${options.baseOutputDir}fragment-masking${fragmentMaskingArtifactFileExtension}`,
pluginMap: {
[`add`]: addPlugin,
[`fragment-masking`]: fragmentMaskingPlugin,
},
plugins: [
{ [`add`]: { content: `/* eslint-disable */` } },
{
[`fragment-masking`]: {},
},
],
schema: options.schema,
config: {
useTypeImports: options.config.useTypeImports,
unmaskFunctionName: fragmentMaskingConfig.unmaskFunctionName,
emitLegacyCommonJSImports: options.config.emitLegacyCommonJSImports,
isStringDocumentMode: options.config.documentMode === DocumentMode.string,
},
documents: [],
documentTransforms: options.documentTransforms,
};
}
let indexFileGenerateConfig = null;
const reexportsExtension = options.config.emitLegacyCommonJSImports ? '' : '.js';
if (reexports.length) {
indexFileGenerateConfig = {
filename: `${options.baseOutputDir}index.ts`,
pluginMap: {
[`add`]: addPlugin,
},
plugins: [
{
[`add`]: {
content: reexports
.sort()
.map(moduleName => `export * from "./${moduleName}${reexportsExtension}";`)
.join('\n'),
},
},
],
schema: options.schema,
config: {},
documents: [],
documentTransforms: options.documentTransforms,
};
}
return [
{
filename: `${options.baseOutputDir}graphql.ts`,
plugins,
pluginMap,
schema: options.schema,
config: {
inlineFragmentTypes: isMaskingFragments ? 'mask' : options.config['inlineFragmentTypes'],
...forwardedConfig,
},
documents: sources,
documentTransforms: options.documentTransforms,
},
{
filename: `${options.baseOutputDir}gql${gqlArtifactFileExtension}`,
plugins: genDtsPlugins,
pluginMap,
schema: options.schema,
config: {
...config,
gqlTagName: options.presetConfig.gqlTagName || 'graphql',
},
documents: sources,
documentTransforms: options.documentTransforms,
},
...(isPersistedOperations
? [
{
filename: `${options.baseOutputDir}persisted-documents.json`,
plugins: [
{
[`persisted-operations`]: {},
},
],
pluginMap: {
[`persisted-operations`]: {
plugin: async () => {
await tdnFinished.promise;
return {
content: JSON.stringify(Object.fromEntries(persistedDocumentsMap.entries()), null, 2),
};
},
},
},
schema: options.schema,
config: {},
documents: sources,
documentTransforms: options.documentTransforms,
},
]
: []),
...(fragmentMaskingFileGenerateConfig ? [fragmentMaskingFileGenerateConfig] : []),
...(indexFileGenerateConfig ? [indexFileGenerateConfig] : []),
];
},
};
function createDeferred() {
const d = {};
d.promise = new Promise((resolve, reject) => {
d.resolve = resolve;
d.reject = reject;
});
return d;
}
export { addTypenameSelectionDocumentTransform } from './add-typename-selection-document-transform.js';