@eddeee888/gcg-typescript-resolver-files 0.16.0 → 0.18.0

package/{src → dist}/validateAndMergeParsedConfigs/validateAndMergeParsedConfigs.js

@@ -1,19 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateAndMergeParsedConfigs = void 0;
-const utils_1 = require("../utils");
+import { fmt } from '../utils/index.js';
 /**
  * validateAndMergeParsedConfigs is used to make sure all parsed configs do not incorrectly override each other.
  * Use this to ensure there's only one way of doing something. e.g.
  *   - scalarsOverrides must be used over externalResolvers to override scalars
  */
-const validateAndMergeParsedConfigs = ({ unmanagedNonScalarResolvers, parsedGraphQLSchemaMeta: { userDefinedSchemaTypeMap, pluginsConfig: { scalarsModuleResolvers, unmanagedScalarResolvers, defaultScalarTypesMap, defaultTypeMappers, }, }, }) => {
+export const validateAndMergeParsedConfigs = ({ unmanagedNonScalarResolvers, parsedGraphQLSchemaMeta: { userDefinedSchemaTypeMap, pluginsConfig: { scalarsModuleResolvers, unmanagedScalarResolvers, defaultScalarTypesMap, defaultTypeMappers, }, }, }) => {
     Object.keys(scalarsModuleResolvers).forEach((schemaType) => {
-        var _a;
         if (
         // If the scalar is defined on the filesystem, it means user wants to use their custom definition.
         // This means we should use it, instead of importing it from scalar module
-        (_a = userDefinedSchemaTypeMap.scalar[schemaType]) === null || _a === void 0 ? void 0 : _a.resolverFile.isOnFilesystem) {
+        userDefinedSchemaTypeMap.scalar[schemaType]?.resolverFile.isOnFilesystem) {
             delete scalarsModuleResolvers[schemaType];
         }
     });
@@ -27,15 +23,22 @@ const validateAndMergeParsedConfigs = ({ unmanagedNonScalarResolvers, parsedGrap
     }, {});
     Object.keys(unmanagedNonScalarResolvers).forEach((schemaType) => {
         if (userDefinedSchemaTypeMap.scalar[schemaType]) {
-            throw new Error(utils_1.fmt.error(`Scalar "${schemaType}" found in presetConfig.externalResolvers. Use presetConfig.scalarsOverrides to override scalar implementation and type. Remove "${schemaType}" from presetConfig.externalResolvers.`, 'Validation'));
+            throw new Error(fmt.error(`Scalar "${schemaType}" found in presetConfig.externalResolvers. Use presetConfig.scalarsOverrides to override scalar implementation and type. Remove "${schemaType}" from presetConfig.externalResolvers.`, 'Validation'));
         }
     });
     return {
         userDefinedSchemaTypeMap,
-        scalarTypes: Object.assign({}, defaultScalarTypesMap),
-        typeMappers: Object.assign(Object.assign({}, schemaEnumTypeMappers), defaultTypeMappers),
-        unmanagedResolvers: Object.assign(Object.assign(Object.assign({}, unmanagedNonScalarResolvers), scalarsModuleResolvers), unmanagedScalarResolvers),
+        scalarTypes: {
+            ...defaultScalarTypesMap,
+        },
+        typeMappers: {
+            ...schemaEnumTypeMappers,
+            ...defaultTypeMappers,
+        },
+        unmanagedResolvers: {
+            ...unmanagedNonScalarResolvers,
+            ...scalarsModuleResolvers,
+            ...unmanagedScalarResolvers,
+        },
     };
 };
-exports.validateAndMergeParsedConfigs = validateAndMergeParsedConfigs;
-//# sourceMappingURL=validateAndMergeParsedConfigs.js.map

package/dist/validatePresetConfig/index.d.ts

@@ -0,0 +1 @@
+export * from './validatePresetConfig.js';

package/dist/validatePresetConfig/index.js

@@ -0,0 +1 @@
+export * from './validatePresetConfig.js';

package/{src → dist}/validatePresetConfig/validatePresetConfig.d.ts

@@ -1,9 +1,9 @@
-import type { AddPluginConfig } from '@graphql-codegen/add/typings/config';
+import type { AddPluginConfig } from '@graphql-codegen/add';
 import type * as typeScriptPlugin from '@graphql-codegen/typescript';
 import type * as typeScriptResolversPlugin from '@graphql-codegen/typescript-resolvers';
 import type * as schemaAstPlugin from '@graphql-codegen/schema-ast';
 import type { ProjectOptions } from 'ts-morph';
-import { type ImportExtension } from '../utils';
+import { type ImportExtension } from '../utils/index.js';
 type ParsedTypesPluginsConfig = Omit<typeScriptPlugin.TypeScriptPluginConfig & typeScriptResolversPlugin.TypeScriptResolversPluginConfig, 'scalars' | 'emitLegacyCommonJSImports' | 'importExtension'>;
 type ConfigMode = 'merged' | 'modules';
 type ResolverMainFileMode = 'merged' | 'modules';

package/{src → dist}/validatePresetConfig/validatePresetConfig.js

@@ -1,75 +1,70 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validatePresetConfig = void 0;
-const tslib_1 = require("tslib");
-const path = tslib_1.__importStar(require("path"));
-const fs = tslib_1.__importStar(require("fs"));
-const utils_1 = require("../utils");
+import * as path from 'path';
+import * as fs from 'fs';
+import { cwd, fmt, logger, normalizeImportExtension, } from '../utils/index.js';
 const defaultResolverRelativeTargetDirMap = {
     modules: 'resolvers',
     merged: '',
 };
 const defaultTypeDefsFilePath = './typeDefs.generated.ts';
 const defaultScalarsModule = 'graphql-scalars';
-const validatePresetConfig = ({ add, resolverTypesPath = './types.generated.ts', resolverRelativeTargetDir, resolverMainFile = 'resolvers.generated.ts', resolverMainFileMode = 'merged', resolverGeneration = 'recommended', typeDefsFilePath = defaultTypeDefsFilePath, typeDefsFileMode: inputTypeDefsFileMode = 'merged', mappersRelativeTargetDir = './', mappersFileExtension = '.mappers.ts', mappersSuffix = 'Mapper', moduleNamingMode = 'last', mergeSchema, scalarsModule = 'graphql-scalars', scalarsOverrides = {}, mode = 'modules', whitelistedModules, blacklistedModules, externalResolvers = {}, typesPluginsConfig = {}, tsConfigFilePath = './tsconfig.json', fixObjectTypeResolvers = 'fast', emitLegacyCommonJSImports, importExtension, }, baseConfig) => {
-    var _a;
-    const finalEmitLegacyCommonJSImports = (_a = emitLegacyCommonJSImports !== null && emitLegacyCommonJSImports !== void 0 ? emitLegacyCommonJSImports : baseConfig === null || baseConfig === void 0 ? void 0 : baseConfig.emitLegacyCommonJSImports) !== null && _a !== void 0 ? _a : true;
-    const baseImportExtension = (baseConfig === null || baseConfig === void 0 ? void 0 : baseConfig.importExtension) || undefined;
-    const finalImportExtension = importExtension !== null && importExtension !== void 0 ? importExtension : baseImportExtension;
+export const validatePresetConfig = ({ add, resolverTypesPath = './types.generated.ts', resolverRelativeTargetDir, resolverMainFile = 'resolvers.generated.ts', resolverMainFileMode = 'merged', resolverGeneration = 'recommended', typeDefsFilePath = defaultTypeDefsFilePath, typeDefsFileMode: inputTypeDefsFileMode = 'merged', mappersRelativeTargetDir = './', mappersFileExtension = '.mappers.ts', mappersSuffix = 'Mapper', moduleNamingMode = 'last', mergeSchema, scalarsModule = 'graphql-scalars', scalarsOverrides = {}, mode = 'modules', whitelistedModules, blacklistedModules, externalResolvers = {}, typesPluginsConfig = {}, tsConfigFilePath = './tsconfig.json', fixObjectTypeResolvers = 'fast', emitLegacyCommonJSImports, importExtension, }, baseConfig) => {
+    const finalEmitLegacyCommonJSImports = emitLegacyCommonJSImports ?? baseConfig?.emitLegacyCommonJSImports ?? true;
+    const baseImportExtension = baseConfig?.importExtension || undefined;
+    const finalImportExtension = importExtension ?? baseImportExtension;
     if (mode !== 'merged' && mode !== 'modules') {
-        throw new Error(utils_1.fmt.error('presetConfig.mode must be "merged" or "modules" (default is "modules")', 'Validation'));
+        throw new Error(fmt.error('presetConfig.mode must be "merged" or "modules" (default is "modules")', 'Validation'));
     }
     if (typeof fixObjectTypeResolvers !== 'object' &&
         fixObjectTypeResolvers !== 'smart' &&
         fixObjectTypeResolvers !== 'fast' &&
         fixObjectTypeResolvers !== 'disabled') {
-        throw new Error(utils_1.fmt.error('presetConfig.fixObjectTypeResolvers must be an object, "smart", "fast" or "disabled" (default is "fast")', 'Validation'));
+        throw new Error(fmt.error('presetConfig.fixObjectTypeResolvers must be an object, "smart", "fast" or "disabled" (default is "fast")', 'Validation'));
     }
     if (typeof resolverGeneration !== 'object' &&
         resolverGeneration !== 'disabled' &&
         resolverGeneration !== 'recommended' &&
         resolverGeneration !== 'minimal' &&
         resolverGeneration !== 'all') {
-        throw new Error(utils_1.fmt.error('presetConfig.resolverGeneration must be an object, "disabled", "recommended", "minimal" or "all" (default is "recommended")', 'Validation'));
+        throw new Error(fmt.error('presetConfig.resolverGeneration must be an object, "disabled", "recommended", "minimal" or "all" (default is "recommended")', 'Validation'));
     }
     if (resolverMainFileMode !== 'merged' && resolverMainFileMode !== 'modules') {
-        throw new Error(utils_1.fmt.error('presetConfig.resolverMainFileMode must be "merged" or "modules" (default is "merged")', 'Validation'));
+        throw new Error(fmt.error('presetConfig.resolverMainFileMode must be "merged" or "modules" (default is "merged")', 'Validation'));
     }
     let typeDefsFileMode = inputTypeDefsFileMode;
     if (mode === 'merged') {
         // If mode is `merged`, `typeDefsFileMode` is also `merged` because there's no whitelisted or modules concepts
         typeDefsFileMode = 'merged';
-        utils_1.logger.warn(`presetConfig.typeDefsFileMode has automatically been set to "merged" because presetConfig.mode is "merged"`);
+        logger.warn(`presetConfig.typeDefsFileMode has automatically been set to "merged" because presetConfig.mode is "merged"`);
     }
     if (typeDefsFileMode !== 'merged' &&
         typeDefsFileMode !== 'modules' &&
         typeDefsFileMode !== 'mergedWhitelisted') {
-        throw new Error(utils_1.fmt.error('presetConfig.typeDefsFileMode must be "merged", "mergedWhitelisted" or "modules" (default is "merged")', 'Validation'));
+        throw new Error(fmt.error('presetConfig.typeDefsFileMode must be "merged", "mergedWhitelisted" or "modules" (default is "merged")', 'Validation'));
     }
     const finalModuleNamingMode = parseModuleNamingMode(moduleNamingMode);
     if (!resolverTypesPath) {
-        throw new Error(utils_1.fmt.error('presetConfig.resolverTypesPath is required', 'Validation'));
+        throw new Error(fmt.error('presetConfig.resolverTypesPath is required', 'Validation'));
     }
     const finalResolverRelativeTargetDir = resolverRelativeTargetDir === undefined
         ? defaultResolverRelativeTargetDirMap[mode]
         : resolverRelativeTargetDir;
     if (path.extname(resolverMainFile) === '') {
-        throw new Error(utils_1.fmt.error('presetConfig.mainFile must be a valid file name', 'Validation'));
+        throw new Error(fmt.error('presetConfig.mainFile must be a valid file name', 'Validation'));
     }
     if (whitelistedModules) {
         if (!Array.isArray(whitelistedModules)) {
-            throw new Error(utils_1.fmt.error('presetConfig.whitelistedModules must be an array if provided', 'Validation'));
+            throw new Error(fmt.error('presetConfig.whitelistedModules must be an array if provided', 'Validation'));
         }
         if (mode !== 'modules') {
-            throw new Error(utils_1.fmt.error('presetConfig.whitelistedModules can only be used with presetConfig.mode == "modules"', 'Validation'));
+            throw new Error(fmt.error('presetConfig.whitelistedModules can only be used with presetConfig.mode == "modules"', 'Validation'));
         }
     }
     if (blacklistedModules) {
         if (!Array.isArray(blacklistedModules)) {
-            throw new Error(utils_1.fmt.error('presetConfig.blacklistedModules must be an array if provided', 'Validation'));
+            throw new Error(fmt.error('presetConfig.blacklistedModules must be an array if provided', 'Validation'));
         }
         if (mode !== 'modules') {
-            throw new Error(utils_1.fmt.error('presetConfig.blacklistedModules can only be used with presetConfig.mode == "modules"', 'Validation'));
+            throw new Error(fmt.error('presetConfig.blacklistedModules can only be used with presetConfig.mode == "modules"', 'Validation'));
         }
     }
     const validatedTypesPluginsConfig = validateTypesPluginsConfig(typesPluginsConfig);
@@ -85,16 +80,16 @@ const validatePresetConfig = ({ add, resolverTypesPath = './types.generated.ts',
         skipAddingFilesFromTsConfig: true, // avoid long startup time by NOT loading files included by tsconfig.json. We only use this virtually anyways so we don't need all the files
     };
     if (tsConfigFilePath) {
-        const absoluteTsConfigFilePath = path.join((0, utils_1.cwd)(), tsConfigFilePath);
+        const absoluteTsConfigFilePath = path.join(cwd(), tsConfigFilePath);
         if (fs.existsSync(absoluteTsConfigFilePath)) {
             tsMorphProjectOptions.tsConfigFilePath = absoluteTsConfigFilePath;
         }
         else {
-            utils_1.logger.warn(`Unable to find TypeScript config at ${absoluteTsConfigFilePath}. Use presetConfig.tsConfigFilePath to set a custom value. Otherwise, type analysis may not work correctly.`);
+            logger.warn(`Unable to find TypeScript config at ${absoluteTsConfigFilePath}. Use presetConfig.tsConfigFilePath to set a custom value. Otherwise, type analysis may not work correctly.`);
         }
     }
     const validatedAdd = validateAddOption(add);
-    const normalizedImportExtension = (0, utils_1.normalizeImportExtension)(finalImportExtension, finalEmitLegacyCommonJSImports);
+    const normalizedImportExtension = normalizeImportExtension(finalImportExtension, finalEmitLegacyCommonJSImports);
     return {
         add: validatedAdd,
         resolverTypesPath,
@@ -122,18 +117,17 @@ const validatePresetConfig = ({ add, resolverTypesPath = './types.generated.ts',
         importExtension: normalizedImportExtension,
     };
 };
-exports.validatePresetConfig = validatePresetConfig;
 const validateTypesPluginsConfig = (config) => {
     if ('scalars' in config) {
-        throw new Error(utils_1.fmt.error('presetConfig.typesPluginsConfig.scalars is not supported. Use presetConfig.scalarsOverrides instead.', 'Validation'));
+        throw new Error(fmt.error('presetConfig.typesPluginsConfig.scalars is not supported. Use presetConfig.scalarsOverrides instead.', 'Validation'));
     }
     if ('emitLegacyCommonJSImports' in config) {
-        throw new Error(utils_1.fmt.error('presetConfig.typesPluginsConfig.emitLegacyCommonJSImports is not supported. Use presetConfig.emitLegacyCommonJSImports instead.', 'Validation'));
+        throw new Error(fmt.error('presetConfig.typesPluginsConfig.emitLegacyCommonJSImports is not supported. Use presetConfig.emitLegacyCommonJSImports instead.', 'Validation'));
     }
     if ('importExtension' in config) {
-        throw new Error(utils_1.fmt.error('presetConfig.typesPluginsConfig.importExtension is not supported. Use presetConfig.importExtension instead.', 'Validation'));
+        throw new Error(fmt.error('presetConfig.typesPluginsConfig.importExtension is not supported. Use presetConfig.importExtension instead.', 'Validation'));
     }
-    const { scalars: _, emitLegacyCommonJSImports: __ } = config, rest = tslib_1.__rest(config, ["scalars", "emitLegacyCommonJSImports"]);
+    const { scalars: _, emitLegacyCommonJSImports: __, ...rest } = config;
     return rest;
 };
 const parseResolverGeneration = (resolverGeneration) => {
@@ -219,10 +213,10 @@ const validateAddOption = (add) => {
     }
     Object.entries(add).forEach(([_, pluginConfig]) => {
         if (typeof pluginConfig !== 'object' || pluginConfig === null) {
-            throw new Error(utils_1.fmt.error('presetConfig.add must be an object', 'Validation'));
+            throw new Error(fmt.error('presetConfig.add must be an object', 'Validation'));
         }
         if (!('content' in pluginConfig)) {
-            throw new Error(utils_1.fmt.error('presetConfig.add must contain a "content" property', 'Validation'));
+            throw new Error(fmt.error('presetConfig.add must contain a "content" property', 'Validation'));
         }
     });
     // TODO: a bit hacky here but what's a good way to coerce this type? 🤔
@@ -269,6 +263,5 @@ const parseModuleNamingMode = (moduleNamingMode) => {
     if (typeof moduleNamingMode === 'number') {
         return moduleNamingMode;
     }
-    throw new Error(utils_1.fmt.error('presetConfig.moduleNamingMode must be "first" or "last" or a number (default is "last")', 'Validation'));
+    throw new Error(fmt.error('presetConfig.moduleNamingMode must be "first" or "last" or a number (default is "last")', 'Validation'));
 };
-//# sourceMappingURL=validatePresetConfig.js.map

package/eslint.config.mjs

@@ -0,0 +1,22 @@
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: [
+            '{projectRoot}/eslint.config.mjs',
+            '{projectRoot}/vite.config.ts',
+          ],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eddeee888/gcg-typescript-resolver-files",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/eddeee888/graphql-code-generator-plugins.git",
@@ -23,26 +23,33 @@
   ],
   "author": "Eddy Nguyen <ch@eddeee888.me>",
   "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@workspace/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
   "peerDependencies": {
-    "graphql": "^15.0.0 || ^16.0.0"
+    "graphql": "^15.0.0 || ^16.0.0 || ^17.0.0"
   },
   "dependencies": {
-    "@eddeee888/gcg-server-config": "0.4.0",
-    "@graphql-codegen/add": "^7.0.0",
-    "@graphql-codegen/plugin-helpers": "^7.0.0",
-    "@graphql-codegen/schema-ast": "^6.0.0",
-    "@graphql-codegen/typescript": "^6.0.0",
-    "@graphql-codegen/typescript-resolvers": "^6.0.0",
-    "@graphql-tools/merge": "^9.1.8",
-    "@graphql-tools/utils": "^11.0.1",
+    "@graphql-codegen/add": "^7.1.0",
+    "@graphql-codegen/plugin-helpers": "^7.1.0",
+    "@graphql-codegen/schema-ast": "^6.1.0",
+    "@graphql-codegen/typescript": "^6.1.0",
+    "@graphql-codegen/typescript-resolvers": "^6.1.0",
+    "@graphql-tools/merge": "^9.2.2",
+    "@graphql-tools/utils": "^11.2.2",
     "micromatch": "^4.0.0",
     "ts-morph": "^22.0.0",
-    "tslib": "^2.8.0"
-  },
-  "publishConfig": {
-    "directory": "../../dist/packages/typescript-resolver-files"
-  },
-  "types": "./src/index.d.ts",
-  "main": "./src/index.js",
-  "type": "commonjs"
+    "tslib": "^2.8.0",
+    "@eddeee888/gcg-server-config": "0.6.0"
+  }
 }

package/project.json

@@ -0,0 +1,8 @@
+{
+  "name": "typescript-resolver-files",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/typescript-resolver-files/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {}
+}

package/src/addVirtualTypesFileToTsMorphProject/addVirtualTypesFileToTsMorphProject.ts

@@ -0,0 +1,109 @@
+import type { Types } from '@graphql-codegen/plugin-helpers';
+import * as addPlugin from '@graphql-codegen/add';
+import type { AddPluginConfig } from '@graphql-codegen/add';
+import * as typeScriptPlugin from '@graphql-codegen/typescript';
+import * as typeScriptResolversPlugin from '@graphql-codegen/typescript-resolvers';
+import type { GraphQLSchema } from 'graphql';
+import type { SourceFile, Project } from 'ts-morph';
+import type { ServerConfig } from '@eddeee888/gcg-server-config';
+import type { GeneratedTypesFileMeta } from '../generateResolverFiles/index.js';
+
+export const addVirtualTypesFileToTsMorphProject = async ({
+  tsMorphProject,
+  schemaAst,
+  resolverTypesPath,
+  resolverTypesConfig,
+  addConfig,
+}: {
+  tsMorphProject: Project;
+  schemaAst: GraphQLSchema;
+  resolverTypesPath: string;
+  resolverTypesConfig: ServerConfig;
+  addConfig?: AddPluginConfig;
+}): Promise<{
+  typesSourceFile: SourceFile;
+  meta: GeneratedTypesFileMeta;
+}> => {
+  const typesFile = await generateVirtualTypesFile({
+    schemaAst,
+    resolverTypesPath,
+    resolverTypesConfig,
+    addConfig,
+  });
+
+  const typesSourceFile = tsMorphProject.createSourceFile(
+    typesFile.filePath,
+    typesFile.content,
+    { overwrite: true }
+  );
+
+  return { typesSourceFile, meta: typesFile.meta };
+};
+
+/**
+ * getVirtualTypesFile generates a virtual types.generated.ts file
+ * This is used to statically detect and compare types in the parse and post-process steps
+ */
+const generateVirtualTypesFile = async ({
+  schemaAst,
+  resolverTypesPath,
+  resolverTypesConfig,
+  addConfig,
+}: {
+  schemaAst: GraphQLSchema;
+  resolverTypesPath: string;
+  resolverTypesConfig: ServerConfig;
+  addConfig?: AddPluginConfig;
+}): Promise<{
+  filePath: string;
+  content: string;
+  meta: GeneratedTypesFileMeta;
+}> => {
+  const [typescriptResult, typescriptResolversResult, addResult] =
+    await Promise.all([
+      typeScriptPlugin.plugin(schemaAst, [], resolverTypesConfig),
+      typeScriptResolversPlugin.plugin(schemaAst, [], resolverTypesConfig),
+      addConfig ? addPlugin.plugin(schemaAst, [], addConfig) : '',
+    ]);
+
+  const addResultAsComplextOutput =
+    convertPluginOutputToComplextPluginOutput(addResult);
+
+  const print = (value: string[] | undefined): string =>
+    value ? value.join('\n') : '';
+
+  return {
+    filePath: resolverTypesPath,
+    content: `
+    ${print(addResultAsComplextOutput.prepend)}
+    ${print(typescriptResult.prepend)}
+    ${print(typescriptResolversResult.prepend)}
+    ${typescriptResult.content}
+    ${typescriptResolversResult.content}
+    ${addResultAsComplextOutput.content}
+    ${print(addResultAsComplextOutput.append)}
+    `,
+    meta: {
+      generatedResolverTypes: typescriptResolversResult.meta
+        ?.generatedResolverTypes || {
+        resolversMap: { name: 'Resolvers' },
+        userDefined: {},
+      },
+    },
+  };
+};
+
+const convertPluginOutputToComplextPluginOutput = (
+  output: Types.PluginOutput
+): Types.ComplexPluginOutput => {
+  if (typeof output === 'string') {
+    return {
+      content: output || '',
+    };
+  }
+
+  if (Array.isArray(output.content)) {
+    output.content = output.content.join('\n');
+  }
+  return output;
+};

package/src/addVirtualTypesFileToTsMorphProject/index.ts

@@ -0,0 +1 @@
+export * from './addVirtualTypesFileToTsMorphProject.js';

package/src/defineConfig.spec.ts

@@ -0,0 +1,76 @@
+import { defineConfig } from './defineConfig.js';
+import { preset as defaultPreset } from './preset.js';
+
+describe('defineConfig()', () => {
+  it('returns default values correctly', () => {
+    const result = defineConfig();
+
+    expect(result).toEqual({
+      preset: defaultPreset,
+      presetConfig: {},
+      watchPattern: ['**/*.mappers.ts'],
+    });
+  });
+
+  it('returns default values correctly with baseOutputDir', () => {
+    const result = defineConfig({}, { baseOutputDir: 'src/schema' });
+
+    expect(result).toEqual({
+      preset: defaultPreset,
+      presetConfig: {},
+      watchPattern: ['src/schema/**/*.mappers.ts'],
+    });
+  });
+
+  it('returns schema value correctly when set', () => {
+    const result = defineConfig({}, { schema: ['src/**/*.graphqls'] });
+
+    expect(result).toEqual({
+      preset: defaultPreset,
+      presetConfig: {},
+      watchPattern: ['**/*.mappers.ts'],
+      schema: ['src/**/*.graphqls'],
+    });
+  });
+
+  it('returns hooks value correctly when set', () => {
+    const result = defineConfig(
+      {},
+      { hooks: { afterAllFileWrite: ['prettier --write'] } }
+    );
+
+    expect(result).toEqual({
+      preset: defaultPreset,
+      presetConfig: {},
+      watchPattern: ['**/*.mappers.ts'],
+      hooks: { afterAllFileWrite: ['prettier --write'] },
+    });
+  });
+
+  it('returns presetConfig with declared config', () => {
+    const { presetConfig } = defineConfig({
+      mode: 'merged',
+      fixObjectTypeResolvers: 'disabled',
+      typesPluginsConfig: {
+        defaultMapper: 'Partial<{T}>',
+      },
+    });
+    expect(presetConfig).toEqual({
+      mode: 'merged',
+      fixObjectTypeResolvers: 'disabled',
+      typesPluginsConfig: {
+        defaultMapper: 'Partial<{T}>',
+      },
+    });
+  });
+
+  it('returns updated watchPattern if custom presetConfig.mappersFileExtension is used', () => {
+    const { presetConfig, watchPattern } = defineConfig({
+      mappersFileExtension: '.model.ts',
+    });
+    expect(presetConfig).toEqual({
+      mappersFileExtension: '.model.ts',
+    });
+    expect(watchPattern).toEqual(['**/*.model.ts']);
+  });
+});

package/src/defineConfig.ts

@@ -0,0 +1,37 @@
+import * as path from 'path';
+import type { Types } from '@graphql-codegen/plugin-helpers';
+import type { TypedPresetConfig } from './validatePresetConfig/index.js';
+import { preset } from './preset.js';
+
+export const defineConfig = (
+  presetConfig: TypedPresetConfig = {},
+  context: {
+    baseOutputDir?: string;
+    schema?: Types.ConfiguredOutput['schema'];
+    hooks?: Types.ConfiguredOutput['hooks'];
+  } = {}
+): Pick<
+  Types.ConfiguredOutput,
+  'preset' | 'presetConfig' | 'watchPattern' | 'schema' | 'hooks'
+> => {
+  const { schema, baseOutputDir = '', hooks } = context;
+
+  const mappersFileExtension =
+    presetConfig.mappersFileExtension || '.mappers.ts';
+
+  const watchPattern: string[] = [];
+  const mapperWatchPattern = path.posix.join(
+    baseOutputDir,
+    '**',
+    `*${mappersFileExtension}`
+  );
+  watchPattern.push(mapperWatchPattern);
+
+  return {
+    preset,
+    presetConfig,
+    watchPattern,
+    schema,
+    hooks,
+  };
+};