refactor(lib/anyware): data type oriented builders (#1274)

Author: jasonkuhrt

examples/__outputs__/20_output/output_preset__standard-graphql.output.txt

@@ -21,7 +21,7 @@ ContextualError: There was an error in the core implementation of hook "exchange
         at new URL (node:internal/url:XX:XX)
         at new Request (node:internal/deps/undici/undici:XX:XX)
         at Object.run (/some/path/to/httpTransport.ts:XX:XX:27)
-        at Object.run (/some/path/to/builder.ts:XX:XX:53)
+        at Object.run (/some/path/to/Pipeline.ts:XX:XX:51)
         at runStep (/some/path/to/runStep.ts:XX:XX:37)
         at runPipeline (/some/path/to/runPipeline.ts:XX:XX:8)
         at runPipeline (/some/path/to/runPipeline.ts:XX:XX:20)

src/client/builderExtensions/anyware.ts

@@ -15,15 +15,13 @@ export interface Anyware<$Arguments extends Builder.Extension.Parameters<Builder
    * TODO Anyware Docs.
    */
   anyware: (
-    interceptor: AnywareLib.Interceptor.InferConstructor<
-      RequestPipeline['spec']
-    >,
+    interceptor: AnywareLib.Interceptor.InferFromPipeline<RequestPipeline>,
   ) => Builder.Definition.MaterializeWith<$Arguments['definition'], $Arguments['context']>
 }
 
 export const builderExtensionAnyware = Builder.Extension.create<BuilderExtensionAnyware>((builder, context) => {
   const properties = {
-    anyware: (interceptor: AnywareLib.Interceptor.InferConstructor<RequestPipeline['spec']>) => {
+    anyware: (interceptor: AnywareLib.Interceptor.InferFromPipeline<RequestPipeline>) => {
       return builder({
         ...context,
         extensions: [

src/client/gql/gql.ts

@@ -70,9 +70,9 @@ export const builderExtensionGql = Builder.Extension.create<BuilderExtensionGql>
             url,
             schema,
             request: analyzedRequest,
-          } as RequestPipeline['spec']['input']
+          } as RequestPipeline['input']
 
-          const result = await Anyware.Pipeline.run(requestPipeline, {
+          const result = await Anyware.PipelineDef.run(requestPipeline, {
             initialInput,
             // retryingExtension: context.retry as any,
             interceptors: context.extensions.filter(_ => _.onRequest !== undefined).map(_ => _.onRequest!) as any,

src/client/handleOutput.ts

@@ -2,6 +2,7 @@ import type { GraphQLError } from 'graphql'
 import type { Simplify } from 'type-fest'
 import type { SimplifyDeepExcept } from '../documentBuilder/Simplify.js'
 import type { RunTypeHookOnRequestResult } from '../extension/extension.js'
+import type { Anyware } from '../lib/anyware/__.js'
 import { Errors } from '../lib/errors/__.js'
 import type { Grafaid } from '../lib/grafaid/__.js'
 import type { SomeObjectData } from '../lib/grafaid/graphql.js'
@@ -13,7 +14,7 @@ import {
   type GetOrNever,
   type Values,
 } from '../lib/prelude.js'
-import type { RequestPipeline, requestPipeline } from '../requestPipeline/RequestPipeline.js'
+import type { requestPipeline, RequestPipelineSpec } from '../requestPipeline/RequestPipeline.js'
 import type { GlobalRegistry } from '../types/GlobalRegistry/GlobalRegistry.js'
 import type { TransportHttp } from '../types/Transport.js'
 import type { Context } from './context.js'
@@ -52,7 +53,7 @@ export type GraffleExecutionResultEnvelope<$Config extends Config = Config> =
 
 export const handleOutput = (
   state: Context,
-  result: RequestPipeline['output'],
+  result: Anyware.PipelineDef.Utilities.InferResult<RequestPipelineSpec>,
 ) => {
   if (isContextConfigTraditionalGraphQLOutput(state.config)) {
     if (result instanceof Error) throw result

src/documentBuilder/requestMethods/requestMethods.ts

@@ -137,7 +137,7 @@ const executeDocument = async (
     request,
   } as RequestPipeline['input']
 
-  const result = await Anyware.Pipeline.run(requestPipeline, {
+  const result = await Anyware.PipelineDef.run(requestPipeline, {
     initialInput,
     // retryingExtension: state.retry as any,
     interceptors: state.extensions.filter(_ => _.onRequest !== undefined).map(_ => _.onRequest!) as any,

src/extension/extension.ts

@@ -57,7 +57,7 @@ export interface Extension<
   /**
    * Anyware executed on every request.
    */
-  onRequest?: Anyware.Interceptor.InferConstructor<RequestPipeline['spec']>
+  onRequest?: Anyware.Interceptor.InferFromPipeline<RequestPipeline>
   /**
    * Manipulate the builder.
    * You can extend the builder with new properties at both runtime AND buildtime (types, TypeScript).
@@ -168,7 +168,7 @@ export const createExtension = <
     custom?: $Custom
     create: (params: { config: $Config }) => {
       builder?: $BuilderExtension
-      onRequest?: Anyware.Interceptor.InferConstructor<RequestPipeline['spec']>
+      onRequest?: Anyware.Interceptor.InferFromPipeline<RequestPipeline>
       typeHooks?: () => $TypeHooks
     }
   },

src/extensions/Throws/Throws.ts

@@ -40,7 +40,7 @@ interface BuilderExtension_<$Args extends Builder.Extension.Parameters<BuilderEx
    */
   throws: () => Builder.Definition.MaterializeWith<
     $Args['definition'],
-    ConfigManager.UpdateAtKey<
+    ConfigManager.SetKey<
       $Args['context'],
       'config',
       // @ts-expect-error fixme
@@ -49,7 +49,7 @@ interface BuilderExtension_<$Args extends Builder.Extension.Parameters<BuilderEx
   >
 }
 
-type ThrowsifyConfig<$BuilderConfig extends BuilderConfig> = ConfigManager.SetAtKeyPath<
+type ThrowsifyConfig<$BuilderConfig extends BuilderConfig> = ConfigManager.SetKeyAtPath<
   $BuilderConfig,
   ['output', 'errors'],
   { other: 'throw'; execution: 'throw' }

src/lib/anyware/ExecutableStep.ts

@@ -1,31 +1,40 @@
-import type { ConfigManager } from '../../config-manager/__.js'
-import type { Overload } from '../Overload/__.js'
-import type { Pipeline } from '../Pipeline/__.js'
+import { Overload } from '../Overload/__.js'
+import type { PipelineDef } from '../PipelineDef/__.js'
+import type { Extension } from './__.js'
+
+type Create = <$Pipeline extends PipelineDef>() => Builder<$Pipeline, Extension.States.Empty>
 
 export interface Builder<
-  $PipelineContext extends Pipeline.Context = Pipeline.Context,
-  $Context extends Context = Context,
+  $Pipeline extends PipelineDef = PipelineDef,
+  $Extension extends Extension = Extension,
 > {
-  context: $Context
+  type: $Extension
   /**
    * TODO
    */
-  overload: <$OverloadBuilder extends Overload.Builder<$PipelineContext>>(
-    overloadBuilder: Overload.BuilderCallback<$PipelineContext, $OverloadBuilder>,
+  overload: <$OverloadBuilder extends Overload.Builder<$Pipeline>>(
+    overloadBuilderCallback: Overload.BuilderCallback<$Pipeline, $OverloadBuilder>,
   ) => Builder<
-    $PipelineContext,
-    ConfigManager.AppendAtKey<
-      $Context,
-      'overloads',
-      $OverloadBuilder['context']
-    >
+    $Pipeline,
+    Extension.Updaters.AddOverload<$Extension, $OverloadBuilder['type']>
   >
 }
 
-export interface Context {
-  overloads: Overload.BuilderContext[]
-}
+export namespace Builder {
+  export const create: Create = () => {
+    const extension: Extension = {
+      overloads: [],
+    }
+
+    const builder: Builder = {
+      type: extension,
+      overload: (builderCallback) => {
+        const overload = builderCallback({ create: Overload.create })
+        extension.overloads.push(overload.type)
+        return builder as any
+      },
+    }
 
-export interface ContextEmpty extends Context {
-  overloads: []
+    return builder as any
+  }
 }

src/lib/anyware/Extension/Builder.ts

@@ -1,25 +0,0 @@
-import { __ } from '../../prelude.js'
-import { Overload } from '../Overload/__.js'
-import type { Pipeline } from '../Pipeline/__.js'
-import type { Builder, Context, ContextEmpty } from './Builder.js'
-
-export * from './Builder.js'
-
-export const create: Create = () => {
-  const context: Context = {
-    overloads: [],
-  }
-
-  const builder: Builder = {
-    context,
-    overload: (builderCallback) => {
-      const overload = builderCallback({ create: Overload.create })
-      context.overloads.push(overload.context)
-      return builder as any
-    },
-  }
-
-  return builder as any
-}
-
-type Create = <$PipelineContext extends Pipeline.Context>() => Builder<$PipelineContext, ContextEmpty>