feat: introduce configuration resolvers ++ (#1314)

Author: jasonkuhrt

.github/actions/setup/action.yaml

@@ -19,7 +19,7 @@ runs:
     - name: Install pnpm
       uses: pnpm/action-setup@v4
       with:
-        version: '9.15.3'
+        version: '10.2.1'
         run_install: false
     # Cannot use corepack because it doesn't permit global package installs.
     # @see https://github.com/pnpm/action-setup/issues/105#issuecomment-2468689290

.github/workflows/pr.yml

@@ -88,7 +88,9 @@ jobs:
       - name: Install Examples Dependencies
         working-directory: examples
         run: pnpm install
-      - run: pnpm test:examples -- --environment ${{ matrix.environment }}
+      - run: pnpm test -- --environment ${{ matrix.environment }}
+        working-directory: examples
+
   test-e2e:
     runs-on: ubuntu-latest
     strategy:

eslint.config.js

@@ -1,40 +1,40 @@
 import configPrisma from 'eslint-config-prisma'
 import tsEslint from 'typescript-eslint'
 
-export default tsEslint.config({
-  ignores: [
-    'playground/**/*',
-    'graffle/**/*',
-    'project/**/*',
-    'examples/35_custom-scalar/custom-scalar.ts',
-    'eslint.config.js',
-    'vite.config.ts',
-    'vitest*.config.ts',
-    '**/generated/**/*',
-    'tests/_/schemas/*/graffle/**/*',
-    'tests/e2e/github/graffle/**/*',
-    '**/tests/fixture/graffle/**/*',
-    'src/layers/1_Schema/Hybrid/types/Scalar/Scalar.ts', // There is an ESLint error that goes away when ignored leading to a circular issue of either lint error or unused lint disable.
-    '**/$/**/*',
-    'legacy/**/*',
-    '**/build/**/*',
-    'website/**/*',
-    'bundle-sizes/**/*.{js,json}',
-  ],
-  extends: configPrisma,
-  languageOptions: {
-    parserOptions: {
-      project: true,
-      tsconfigRootDir: import.meta.dirname,
-    },
+export default tsEslint.config(
+  {
+    ignores: [
+      'src/extensions/DocumentBuilder/__tests__/fixtures/**/*',
+      'src/extensions/SchemaErrors/__tests__/fixture/**/*',
+      'graffle/**/*',
+      'examples/35_custom-scalar/custom-scalar.ts',
+      'eslint.config.js',
+      'vite.config.ts',
+      'vitest*.config.ts',
+      '**/generated/**/*',
+      'tests/e2e/github/graffle/**/*',
+      'examples/$/**/*',
+      'build/**/*',
+      'website/**/*',
+      'bundle-sizes/**/*.{js,json}',
+    ],
   },
-  rules: {
-    ['prefer-arrow/prefer-arrow-functions']: 'off',
-    ['@typescript-eslint/only-throw-error']: 'off',
-    ['@typescript-eslint/no-unsafe-assignment']: 'off',
-    ['@typescript-eslint/no-unsafe-call']: 'off',
-    ['@typescript-eslint/no-unsafe-member-access']: 'off',
-    ['@typescript-eslint/ban-types']: 'off',
-    ['@typescript-eslint/no-unnecessary-condition']: 'off',
+  {
+    extends: configPrisma,
+    languageOptions: {
+      parserOptions: {
+        project: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      ['prefer-arrow/prefer-arrow-functions']: 'off',
+      ['@typescript-eslint/only-throw-error']: 'off',
+      ['@typescript-eslint/no-unsafe-assignment']: 'off',
+      ['@typescript-eslint/no-unsafe-call']: 'off',
+      ['@typescript-eslint/no-unsafe-member-access']: 'off',
+      ['@typescript-eslint/ban-types']: 'off',
+      ['@typescript-eslint/no-unnecessary-condition']: 'off',
+    },
   },
-})
+)

examples/$/graffle/_.ts renamed to examples/$/graffle/_exports.ts

@@ -5,6 +5,7 @@
 import './modules/global.js'
 
 export { create } from './modules/client.js'
+export { Name } from './modules/data.js'
 export { schemaDrivenDataMap as schemaMap } from './modules/schema-driven-data-map.js'
 export { Select } from './modules/select.js'
 export * as SelectionSets from './modules/selection-sets.js'

examples/$/graffle/__.ts renamed to examples/$/graffle/_namespace.ts

@@ -1,2 +1,2 @@
-export * as Graffle from './_.js'
+export * as Graffle from './_exports.js'
 export { schemaDrivenDataMap as schemaMap } from './modules/schema-driven-data-map.js'

examples/$/graffle/modules/client.ts

@@ -5,21 +5,18 @@ import * as $$Data from './data.js'
 import * as $$Scalar from './scalar.js'
 import * as $$SchemaDrivenDataMap from './schema-driven-data-map.js'
 
-const context = $$Utilities.useReducer(
-  $$Utilities.useReducer(
-    {
-      ...$$Utilities.Context.States.empty,
-      name: $$Data.Name,
-      schemaMap: $$SchemaDrivenDataMap.schemaDrivenDataMap,
-      scalars: $$Scalar.$registry,
-    },
-    TransportHttp({
-      url: $$Data.defaultSchemaUrl,
+const context = $$Utilities.pipe(
+  $$Utilities.contextEmpty,
+  ctx => $$Utilities.Extensions.addAndApplyMany(ctx, [TransportHttp, DocumentBuilder]),
+  ctx => $$Utilities.Transports.configureCurrentOrThrow(ctx, { url: $$Data.defaultSchemaUrl }),
+  ctx =>
+    $$Utilities.Configuration.add(ctx, {
+      schema: {
+        name: $$Data.Name,
+        map: $$SchemaDrivenDataMap.schemaDrivenDataMap,
+      },
     }),
-  ),
-  DocumentBuilder(),
+  ctx => $$Utilities.Scalars.set(ctx, { scalars: $$Scalar.$registry }),
 )
 
-export const create = $$Utilities.createConstructorWithContext(
-  context,
-)
+export const create = $$Utilities.createConstructorWithContext(context)

examples/$/graffle/modules/methods-document.ts

@@ -11,7 +11,7 @@ export interface Document<$Context> {
         $Context['scalars']
       >
     >,
-  ): $$Utilities.DocumentBuilder.DocumentRunner<
+  ): $$Utilities.DocumentBuilderKit.DocumentRunner<
     $Context,
     $$Schema.Schema,
     // @ts-expect-error We use Exact instead of constraint on this function. TypeScript does not see that as

examples/$/graffle/modules/methods-root.ts

@@ -1,24 +1,24 @@
 import type * as $$Utilities from 'graffle/utilities-for-generated'
-import * as $$Schema from './schema.js'
-import * as $$SelectionSets from './selection-sets.js'
+import type * as $$Schema from './schema.js'
+import type * as $$SelectionSets from './selection-sets.js'
 
 export interface QueryMethods<$Context extends $$Utilities.Context> {
-  $batch: $$Utilities.ClientTransports.PreflightCheck<
+  $batch: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     <$SelectionSet>(
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
       & $$Utilities.HandleOutput<
         $Context,
-        $$Utilities.DocumentBuilder.InferResult.OperationQuery<
+        $$Utilities.DocumentBuilderKit.InferResult.OperationQuery<
           $$Utilities.AssertExtendsObject<$SelectionSet>,
           $$Schema.Schema<$Context['scalars']>
         >
       >
     >
   >
-  __typename: $$Utilities.ClientTransports.PreflightCheck<
+  __typename: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     () => Promise<
       & (null | {})
@@ -30,15 +30,15 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
     >
   >
 
-  battles: $$Utilities.ClientTransports.PreflightCheck<
+  battles: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     <$SelectionSet>(
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.battles<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
       & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
-        $$Utilities.DocumentBuilder.InferResult.OperationQuery<
+        $$Utilities.DocumentBuilderKit.InferResult.OperationQuery<
           { battles: $SelectionSet },
           $$Schema.Schema<$Context['scalars']>
         >,
@@ -47,15 +47,15 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
     >
   >
 
-  beings: $$Utilities.ClientTransports.PreflightCheck<
+  beings: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     <$SelectionSet>(
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.beings<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
       & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
-        $$Utilities.DocumentBuilder.InferResult.OperationQuery<
+        $$Utilities.DocumentBuilderKit.InferResult.OperationQuery<
           { beings: $SelectionSet },
           $$Schema.Schema<$Context['scalars']>
         >,
@@ -64,15 +64,15 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
     >
   >
 
-  pokemonByName: $$Utilities.ClientTransports.PreflightCheck<
+  pokemonByName: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     <$SelectionSet>(
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.pokemonByName<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
       & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
-        $$Utilities.DocumentBuilder.InferResult.OperationQuery<
+        $$Utilities.DocumentBuilderKit.InferResult.OperationQuery<
           { pokemonByName: $SelectionSet },
           $$Schema.Schema<$Context['scalars']>
         >,
@@ -81,15 +81,15 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
     >
   >
 
-  pokemons: $$Utilities.ClientTransports.PreflightCheck<
+  pokemons: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     <$SelectionSet>(
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.pokemons<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
       & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
-        $$Utilities.DocumentBuilder.InferResult.OperationQuery<
+        $$Utilities.DocumentBuilderKit.InferResult.OperationQuery<
           { pokemons: $SelectionSet },
           $$Schema.Schema<$Context['scalars']>
         >,
@@ -98,15 +98,15 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
     >
   >
 
-  trainerByName: $$Utilities.ClientTransports.PreflightCheck<
+  trainerByName: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     <$SelectionSet>(
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.trainerByName<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
       & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
-        $$Utilities.DocumentBuilder.InferResult.OperationQuery<
+        $$Utilities.DocumentBuilderKit.InferResult.OperationQuery<
           { trainerByName: $SelectionSet },
           $$Schema.Schema<$Context['scalars']>
         >,
@@ -115,15 +115,15 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
     >
   >
 
-  trainers: $$Utilities.ClientTransports.PreflightCheck<
+  trainers: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     <$SelectionSet>(
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.trainers<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
       & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
-        $$Utilities.DocumentBuilder.InferResult.OperationQuery<
+        $$Utilities.DocumentBuilderKit.InferResult.OperationQuery<
           { trainers: $SelectionSet },
           $$Schema.Schema<$Context['scalars']>
         >,
@@ -134,22 +134,22 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
 }
 
 export interface MutationMethods<$Context extends $$Utilities.Context> {
-  $batch: $$Utilities.ClientTransports.PreflightCheck<
+  $batch: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     <$SelectionSet>(
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Mutation<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
       & $$Utilities.HandleOutput<
         $Context,
-        $$Utilities.DocumentBuilder.InferResult.OperationMutation<
+        $$Utilities.DocumentBuilderKit.InferResult.OperationMutation<
           $$Utilities.AssertExtendsObject<$SelectionSet>,
           $$Schema.Schema<$Context['scalars']>
         >
       >
     >
   >
-  __typename: $$Utilities.ClientTransports.PreflightCheck<
+  __typename: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     () => Promise<
       & (null | {})
@@ -161,15 +161,15 @@ export interface MutationMethods<$Context extends $$Utilities.Context> {
     >
   >
 
-  addPokemon: $$Utilities.ClientTransports.PreflightCheck<
+  addPokemon: $$Utilities.GraffleKit.Context.Configuration.Check.Preflight<
     $Context,
     <$SelectionSet>(
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Mutation.addPokemon<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
       & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
-        $$Utilities.DocumentBuilder.InferResult.OperationMutation<
+        $$Utilities.DocumentBuilderKit.InferResult.OperationMutation<
           { addPokemon: $SelectionSet },
           $$Schema.Schema<$Context['scalars']>
         >,