grafast 0.1.1-beta.10 → 0.1.1-beta.11

package/dist/args.d.ts

@@ -1,9 +1,6 @@
 import type { ExecutionArgs } from "graphql";
-/**
- * Applies Graphile Config hooks to your GraphQL request, e.g. to
- * populate context or similar.
- *
- * @experimental
- */
-export declare function hookArgs(rawArgs: ExecutionArgs, resolvedPreset: GraphileConfig.ResolvedPreset, ctx: Partial<Grafast.RequestContext>): Grafast.ExecutionArgs | PromiseLike<Grafast.ExecutionArgs>;
+import type { GrafastExecutionArgs, PromiseOrDirect } from "./interfaces.js";
+/** @deprecated Pass `resolvedPreset` and `requestContext` via args directly */
+export declare function hookArgs(rawArgs: ExecutionArgs, resolvedPreset: GraphileConfig.ResolvedPreset, ctx: Partial<Grafast.RequestContext>): PromiseOrDirect<Grafast.ExecutionArgs>;
+export declare function hookArgs(rawArgs: GrafastExecutionArgs): PromiseOrDirect<Grafast.ExecutionArgs>;
 //# sourceMappingURL=args.d.ts.map

package/dist/args.js

@@ -1,62 +1,72 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hookArgs = void 0;
-const config_js_1 = require("./config.js");
 const interfaces_js_1 = require("./interfaces.js");
+const middleware_js_1 = require("./middleware.js");
 const utils_js_1 = require("./utils.js");
+const EMPTY_OBJECT = Object.freeze(Object.create(null));
 /**
  * Applies Graphile Config hooks to your GraphQL request, e.g. to
  * populate context or similar.
  *
  * @experimental
  */
-function hookArgs(rawArgs, resolvedPreset, ctx) {
+function hookArgs(rawArgs, legacyResolvedPreset, legacyCtx) {
+    if (legacyResolvedPreset !== undefined) {
+        rawArgs.resolvedPreset = legacyResolvedPreset;
+    }
+    if (legacyCtx !== undefined) {
+        rawArgs.requestContext = rawArgs.requestContext ?? legacyCtx;
+    }
+    const { middleware: rawMiddleware, resolvedPreset, contextValue: rawContextValue, } = rawArgs;
+    // Make context mutable
+    rawArgs.contextValue = Object.assign(Object.create(null), rawContextValue);
+    const middleware = rawMiddleware === undefined && resolvedPreset != null
+        ? (0, middleware_js_1.getGrafastMiddleware)(resolvedPreset)
+        : rawMiddleware ?? null;
+    if (rawMiddleware === undefined) {
+        rawArgs.middleware = middleware;
+    }
     const args = rawArgs;
     // Assert that args haven't already been hooked
     if (args[interfaces_js_1.$$hooked]) {
         throw new Error("Must not call hookArgs twice!");
     }
     args[interfaces_js_1.$$hooked] = true;
-    // Make context mutable
-    args.contextValue = Object.assign(Object.create(null), args.contextValue);
-    // finalize(args): args is deliberately shadowed
-    const finalize = (args) => {
-        const userContext = resolvedPreset.grafast?.context;
-        if (typeof userContext === "function") {
-            const result = userContext(ctx, args);
-            if ((0, utils_js_1.isPromiseLike)(result)) {
-                // Deliberately shadowed 'result'
-                return result.then((result) => {
-                    Object.assign(args.contextValue, result);
-                    return args;
-                });
-            }
-            else {
-                Object.assign(args.contextValue, result);
+    if (middleware != null) {
+        return middleware.run("prepareArgs", { args }, finalizeWithEvent);
+    }
+    else {
+        return finalize(args);
+    }
+}
+exports.hookArgs = hookArgs;
+function finalize(args) {
+    const userContext = args.resolvedPreset?.grafast?.context;
+    const contextValue = args.contextValue;
+    if (typeof userContext === "function") {
+        const result = userContext(args.requestContext ?? EMPTY_OBJECT, args);
+        if ((0, utils_js_1.isPromiseLike)(result)) {
+            // Deliberately shadowed 'result'
+            return result.then((result) => {
+                Object.assign(contextValue, result);
                 return args;
-            }
-        }
-        else if (typeof userContext === "object" && userContext !== null) {
-            Object.assign(args.contextValue, userContext);
-            return args;
+            });
         }
         else {
+            Object.assign(contextValue, result);
             return args;
         }
-    };
-    if (resolvedPreset !== config_js_1.NULL_PRESET &&
-        resolvedPreset.plugins &&
-        resolvedPreset.plugins.length > 0) {
-        const event = { args, ctx, resolvedPreset };
-        const result = (0, config_js_1.hook)(resolvedPreset, "args", event);
-        if ((0, utils_js_1.isPromiseLike)(result)) {
-            return result.then(() => finalize(event.args));
-        }
-        else {
-            return finalize(event.args);
-        }
     }
-    return finalize(args);
+    else if (typeof userContext === "object" && userContext !== null) {
+        Object.assign(contextValue, userContext);
+        return args;
+    }
+    else {
+        return args;
+    }
+}
+function finalizeWithEvent(event) {
+    return finalize(event.args);
 }
-exports.hookArgs = hookArgs;
 //# sourceMappingURL=args.js.map

package/dist/config.d.ts

@@ -1,19 +1,2 @@
-import type { AsyncHooks, PluginHook } from "graphile-config";
 export declare const NULL_PRESET: GraphileConfig.ResolvedPreset;
-type GraphileConfigModule = typeof import("graphile-config");
-type PromiseOrValue<T> = T | Promise<T>;
-export declare function withGraphileConfig<T>(callback: (graphileConfig: GraphileConfigModule | null) => PromiseOrValue<T>): PromiseOrValue<T>;
-declare const $$skipHooks: unique symbol;
-declare const $$hooksForPreset: unique symbol;
-declare global {
-    namespace GraphileConfig {
-        interface ResolvedPreset {
-            [$$hooksForPreset]?: null | AsyncHooks<GraphileConfig.GrafastHooks>;
-            [$$skipHooks]?: Record<string, boolean>;
-        }
-    }
-}
-export declare function withHooks<TResult>(resolvedPreset: GraphileConfig.ResolvedPreset, callback: (hooks: AsyncHooks<GraphileConfig.GrafastHooks> | null) => PromiseOrValue<TResult>): PromiseOrValue<TResult>;
-export declare function hook<THookName extends keyof GraphileConfig.GrafastHooks>(resolvedPreset: GraphileConfig.ResolvedPreset, hookName: THookName, ...args: Parameters<GraphileConfig.GrafastHooks[THookName] extends PluginHook<infer U> ? U : never>): PromiseOrValue<void>;
-export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -1,99 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hook = exports.withHooks = exports.withGraphileConfig = exports.NULL_PRESET = void 0;
+exports.NULL_PRESET = void 0;
 exports.NULL_PRESET = Object.freeze(Object.create(null));
-let graphileConfig = undefined;
-let graphileConfigLoaded = false;
-function withGraphileConfig(callback) {
-    if (graphileConfig === undefined) {
-        // ESM:
-        // This should be
-        //     graphileConfig = import("graphile-config").then(
-        // but that causes a segfault in jest/node when testing third party
-        // modules. So we had to convert everything to CommonJS.
-        graphileConfig = new Promise((resolve, reject) => {
-            try {
-                resolve(require("graphile-config"));
-            }
-            catch (e) {
-                if (e.code === "ERR_REQUIRE_ESM") {
-                    return import("graphile-config").then(resolve, reject);
-                }
-                else {
-                    reject(e);
-                }
-            }
-        }).then((GC) => {
-            graphileConfig = GC;
-            graphileConfigLoaded = true;
-            return GC;
-        }, () => {
-            graphileConfig = null;
-            graphileConfigLoaded = true;
-            return null;
-        });
-    }
-    if (graphileConfigLoaded) {
-        return callback(graphileConfig);
-    }
-    else {
-        return graphileConfig.then(callback);
-    }
-}
-exports.withGraphileConfig = withGraphileConfig;
-const $$skipHooks = Symbol("skipHooks");
-const $$hooksForPreset = Symbol("grafastHooks");
-function withHooks(resolvedPreset, callback) {
-    const existing = resolvedPreset[$$hooksForPreset];
-    if (existing !== undefined) {
-        return callback(existing);
-    }
-    if (!resolvedPreset.plugins || resolvedPreset.plugins.length === 0) {
-        resolvedPreset[$$hooksForPreset] = null;
-        return callback(null);
-    }
-    const plugins = resolvedPreset.plugins;
-    return withGraphileConfig((gc) => {
-        if (gc !== null) {
-            const hooks = new gc.AsyncHooks();
-            gc.applyHooks(plugins, (p) => p.grafast?.hooks, (name, fn, _plugin) => {
-                hooks.hook(name, fn);
-            });
-            resolvedPreset[$$hooksForPreset] = hooks;
-            return callback(hooks);
-        }
-        else {
-            resolvedPreset[$$hooksForPreset] = null;
-            return callback(null);
-        }
-    });
-}
-exports.withHooks = withHooks;
-function hook(resolvedPreset, hookName, ...args) {
-    if (resolvedPreset[$$skipHooks]?.[hookName]) {
-        return;
-    }
-    return withHooks(resolvedPreset, (hooks) => {
-        if (hooks !== null) {
-            if (hooks.callbacks[hookName] !== undefined) {
-                return hooks.process(hookName, ...args);
-            }
-            else {
-                if (!resolvedPreset[$$skipHooks]) {
-                    resolvedPreset[$$skipHooks] = Object.create(null);
-                }
-                resolvedPreset[$$skipHooks][hookName] = true;
-                return;
-            }
-        }
-        else {
-            if (!resolvedPreset[$$skipHooks]) {
-                resolvedPreset[$$skipHooks] = Object.create(null);
-            }
-            resolvedPreset[$$skipHooks][hookName] = true;
-            return;
-        }
-    });
-}
-exports.hook = hook;
 //# sourceMappingURL=config.js.map

package/dist/dev.js

@@ -19,9 +19,7 @@ if (typeof process !== "undefined" &&
     typeof nodeEnv === "undefined") {
     console.warn(`The GRAPHILE_ENV environmental variable is not set; Grafast will run in production mode. In your development environments, it's recommended that you set \`GRAPHILE_ENV=development\` to opt in to additional checks that will provide guidance and help you to catch issues in your code earlier, and other changes such as formatting to improve your development experience.`);
 }
-else if (exports.isDev && !exports.isTest) {
-    console.warn(`Grafast is running in development mode due to \`${graphileEnv !== undefined
-        ? `GRAPHILE_ENV=${graphileEnv}`
-        : `NODE_ENV=${nodeEnv}`}\`; this is recommended for development environments (and strongly discouraged in production), but will impact on performance - in particular, planning will be significantly more expensive.`);
+else if (exports.isDev && !exports.isTest && typeof graphileEnv === "undefined") {
+    console.warn(`Grafast is running in development mode due to \`NODE_ENV=${nodeEnv}\`; this is recommended for development environments (and strongly discouraged in production), but will impact on performance - in particular, planning will be significantly more expensive. To remove this warning, make this explicit with \`GRAPHILE_ENV=development\` envvar.`);
 }
 //# sourceMappingURL=dev.js.map

package/dist/engine/executeBucket.js

@@ -62,7 +62,8 @@ function executeBucket(bucket, requestContext) {
             return { flags, results };
         }
     }
-    const { stopTime, eventEmitter } = requestContext;
+    const { stopTime, eventEmitter, args } = requestContext;
+    const { middleware } = args;
     const { metaByMetaKey, size, store, layerPlan: { phases, children: childLayerPlans }, } = bucket;
     const phaseCount = phases.length;
     let sideEffectStepsWithErrors = null;
@@ -574,26 +575,38 @@ function executeBucket(bucket, requestContext) {
             if (step.stream.length > 1) {
                 throw new Error(`${step} is using a legacy form of 'stream' which accepts multiple arguments, please see https://err.red/gev2`);
             }
-            return step.stream({
+            const streamDetails = {
                 indexMap: makeIndexMap(count),
                 indexForEach: makeIndexForEach(count),
                 count,
                 values,
                 extra,
                 streamOptions,
-            });
+            };
+            if (!step.isSyncAndSafe && middleware != null) {
+                return middleware.run("streamStep", { args, step, streamDetails }, streamStepFromEvent);
+            }
+            else {
+                return step.stream(streamDetails);
+            }
         }
         else {
             if (step.execute.length > 1) {
                 throw new Error(`${step} is using a legacy form of 'execute' which accepts multiple arguments, please see https://err.red/gev2`);
             }
-            return step.execute({
+            const executeDetails = {
                 indexMap: makeIndexMap(count),
                 indexForEach: makeIndexForEach(count),
                 count,
                 values,
                 extra,
-            });
+            };
+            if (!step.isSyncAndSafe && middleware != null) {
+                return middleware.run("executeStep", { args, step, executeDetails }, executeStepFromEvent);
+            }
+            else {
+                return step.execute(executeDetails);
+            }
         }
     }
     // Slow mode...
@@ -1080,4 +1093,10 @@ function makeIndexForEach(count) {
     }
     return result;
 }
+function streamStepFromEvent(event) {
+    return event.step.stream(event.streamDetails);
+}
+function executeStepFromEvent(event) {
+    return event.step.execute(event.executeDetails);
+}
 //# sourceMappingURL=executeBucket.js.map

package/dist/execute.d.ts

@@ -5,10 +5,10 @@ import type { GrafastExecutionArgs } from "./interfaces.js";
  * @deprecated Second and third parameters should be passed as part of args,
  * specifically `resolvedPreset` and `outputDataAsString`.
  */
-export declare function execute(args: GrafastExecutionArgs, resolvedPreset: GraphileConfig.ResolvedPreset | undefined, outputDataAsString?: boolean): PromiseOrValue<ExecutionResult | AsyncGenerator<AsyncExecutionResult, void, undefined>>;
+export declare function execute(args: ExecutionArgs, resolvedPreset: GraphileConfig.ResolvedPreset | undefined, outputDataAsString?: boolean): PromiseOrValue<ExecutionResult | AsyncGenerator<AsyncExecutionResult, void, undefined>>;
 /**
  * Use this instead of GraphQL.js' execute method and we'll automatically
  * run grafastPrepare for you and handle the result.
  */
-export declare function execute(args: ExecutionArgs): PromiseOrValue<ExecutionResult | AsyncGenerator<AsyncExecutionResult, void, undefined>>;
+export declare function execute(args: GrafastExecutionArgs): PromiseOrValue<ExecutionResult | AsyncGenerator<AsyncExecutionResult, void, undefined>>;
 //# sourceMappingURL=execute.d.ts.map

package/dist/execute.js

@@ -3,18 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.execute = exports.withGrafastArgs = void 0;
 const tslib_1 = require("tslib");
 const eventemitter3_1 = tslib_1.__importDefault(require("eventemitter3"));
-const config_js_1 = require("./config.js");
 const dev_js_1 = require("./dev.js");
 const inspect_js_1 = require("./inspect.js");
 const interfaces_js_1 = require("./interfaces.js");
+const middleware_js_1 = require("./middleware.js");
 const prepare_js_1 = require("./prepare.js");
 const utils_js_1 = require("./utils.js");
 /**
  * Used by `execute` and `subscribe`.
  * @internal
  */
-function withGrafastArgs(args, resolvedPreset, outputDataAsString) {
-    const options = resolvedPreset?.grafast;
+function withGrafastArgs(args) {
+    const options = args.resolvedPreset?.grafast;
     if (dev_js_1.isDev) {
         if (args.rootValue != null &&
             (typeof args.rootValue !== "object" ||
@@ -54,8 +54,9 @@ function withGrafastArgs(args, resolvedPreset, outputDataAsString) {
     }
     const rootValue = (0, prepare_js_1.grafastPrepare)(args, {
         explain: options?.explain,
-        outputDataAsString,
         timeouts: options?.timeouts,
+        // TODO: Delete this
+        outputDataAsString: args.outputDataAsString,
     });
     if (unlisten !== null) {
         Promise.resolve(rootValue).then(unlisten, unlisten);
@@ -69,8 +70,28 @@ function withGrafastArgs(args, resolvedPreset, outputDataAsString) {
     }
 }
 exports.withGrafastArgs = withGrafastArgs;
-function execute(args, resolvedPreset, outputDataAsString) {
-    return withGrafastArgs(args, args.resolvedPreset ?? resolvedPreset ?? config_js_1.NULL_PRESET, args.outputDataAsString ?? outputDataAsString ?? false);
+function execute(args, legacyResolvedPreset, legacyOutputDataAsString) {
+    // TODO: remove legacy compatibility
+    if (legacyResolvedPreset !== undefined) {
+        args.resolvedPreset = legacyResolvedPreset;
+    }
+    if (legacyOutputDataAsString !== undefined) {
+        args.outputDataAsString = legacyOutputDataAsString;
+    }
+    const { resolvedPreset } = args;
+    const middleware = args.middleware === undefined && resolvedPreset != null
+        ? (0, middleware_js_1.getGrafastMiddleware)(resolvedPreset)
+        : args.middleware ?? null;
+    if (args.middleware === undefined) {
+        args.middleware = middleware;
+    }
+    if (middleware !== null) {
+        return middleware.run("execute", { args }, executeMiddlewareCallback);
+    }
+    else {
+        return withGrafastArgs(args);
+    }
 }
 exports.execute = execute;
+const executeMiddlewareCallback = (event) => withGrafastArgs(event.args);
 //# sourceMappingURL=execute.js.map

package/dist/grafastGraphql.d.ts

@@ -1,10 +1,15 @@
 import type { AsyncExecutionResult, ExecutionResult } from "graphql";
 import type { PromiseOrValue } from "graphql/jsutils/PromiseOrValue";
 import type { GrafastArgs } from "./interfaces.js";
+/**
+ * @deprecated Second and third parameters should be passed as part of args,
+ * specifically `resolvedPreset` and `requestContext`.
+ */
+export declare function grafast(args: GrafastArgs, legacyResolvedPreset?: GraphileConfig.ResolvedPreset, legacyCtx?: Partial<Grafast.RequestContext>): PromiseOrValue<ExecutionResult | AsyncGenerator<AsyncExecutionResult, void, undefined>>;
 /**
  * A replacement for GraphQL.js' `graphql` method that calls Grafast's
  * execute instead
  */
-export declare function grafast(args: GrafastArgs, legacyResolvedPreset?: GraphileConfig.ResolvedPreset, legacyCtx?: Partial<Grafast.RequestContext>): PromiseOrValue<ExecutionResult | AsyncGenerator<AsyncExecutionResult, void, undefined>>;
+export declare function grafast(args: GrafastArgs): PromiseOrValue<ExecutionResult | AsyncGenerator<AsyncExecutionResult, void, undefined>>;
 export declare function grafastSync(args: GrafastArgs, legacyResolvedPreset?: GraphileConfig.ResolvedPreset, legacyRequestContext?: Partial<Grafast.RequestContext>): ExecutionResult;
 //# sourceMappingURL=grafastGraphql.d.ts.map

package/dist/grafastGraphql.js

@@ -8,6 +8,7 @@ const error_js_1 = require("./error.js");
 const execute_js_1 = require("./execute.js");
 const index_js_1 = require("./index.js");
 const interfaces_js_1 = require("./interfaces.js");
+const middleware_js_1 = require("./middleware.js");
 const utils_js_1 = require("./utils.js");
 const { GraphQLError, parse, Source, validate, validateSchema } = graphql;
 /** Rough average size per query */
@@ -79,19 +80,31 @@ const parseAndValidate = (gqlSchema, stringOrSource) => {
         }
     }
 };
-/**
- * A replacement for GraphQL.js' `graphql` method that calls Grafast's
- * execute instead
- */
 function grafast(args, legacyResolvedPreset, legacyCtx) {
-    const { schema, source, rootValue, contextValue, variableValues, operationName, fieldResolver, typeResolver, resolvedPreset = legacyResolvedPreset, requestContext = legacyCtx, } = args;
+    // Convert legacy args to properties on `args`:
+    if (legacyResolvedPreset !== undefined) {
+        args.resolvedPreset = args.resolvedPreset ?? legacyResolvedPreset;
+    }
+    if (legacyCtx !== undefined) {
+        args.requestContext = args.requestContext ?? legacyCtx;
+    }
+    const { schema, source, rootValue, contextValue, variableValues, operationName, fieldResolver, typeResolver, resolvedPreset, requestContext, middleware: rawMiddleware, } = args;
+    const middleware = rawMiddleware !== undefined
+        ? rawMiddleware
+        : resolvedPreset != null
+            ? (0, middleware_js_1.getGrafastMiddleware)(resolvedPreset)
+            : null;
     // Validate Schema
-    const schemaValidationErrors = validateSchema(schema);
+    const schemaValidationErrors = middleware != null && resolvedPreset != null
+        ? middleware.runSync("validateSchema", { schema, resolvedPreset }, validateSchemaWithEvent)
+        : validateSchema(schema);
     if (schemaValidationErrors.length > 0) {
         return { errors: schemaValidationErrors };
     }
     // Cached parse and validate
-    const documentOrErrors = parseAndValidate(schema, source);
+    const documentOrErrors = middleware != null && resolvedPreset != null
+        ? middleware.runSync("parseAndValidate", { resolvedPreset, schema, source }, parseAndValidateWithEvent)
+        : parseAndValidate(schema, source);
     if (Array.isArray(documentOrErrors)) {
         return { errors: documentOrErrors };
     }
@@ -105,20 +118,21 @@ function grafast(args, legacyResolvedPreset, legacyCtx) {
         operationName,
         fieldResolver,
         typeResolver,
+        middleware,
+        resolvedPreset,
+        requestContext,
     };
     if (resolvedPreset && requestContext) {
-        const argsOrPromise = (0, index_js_1.hookArgs)(executionArgs, resolvedPreset, requestContext);
+        const argsOrPromise = (0, index_js_1.hookArgs)(executionArgs);
         if ((0, utils_js_1.isPromiseLike)(argsOrPromise)) {
-            return Promise.resolve(argsOrPromise).then((hookedArgs) => (0, execute_js_1.execute)(hookedArgs, resolvedPreset));
+            return Promise.resolve(argsOrPromise).then(execute_js_1.execute);
         }
         else {
-            // Execute
-            return (0, execute_js_1.execute)(argsOrPromise, resolvedPreset);
+            return (0, execute_js_1.execute)(argsOrPromise);
         }
     }
     else {
-        // Execute
-        return (0, execute_js_1.execute)(executionArgs, resolvedPreset);
+        return (0, execute_js_1.execute)(executionArgs);
     }
 }
 exports.grafast = grafast;
@@ -130,4 +144,10 @@ function grafastSync(args, legacyResolvedPreset, legacyRequestContext) {
     return result;
 }
 exports.grafastSync = grafastSync;
+function validateSchemaWithEvent(event) {
+    return validateSchema(event.schema);
+}
+function parseAndValidateWithEvent(event) {
+    return parseAndValidate(event.schema, event.source);
+}
 //# sourceMappingURL=grafastGraphql.js.map

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import "./thereCanBeOnlyOne.js";
 import type LRU from "@graphile/lru";
-import type { PluginHook } from "graphile-config";
-import type { DocumentNode, ExecutionArgs as GraphQLExecutionArgs, GraphQLError, OperationDefinitionNode } from "graphql";
+import type { CallbackOrDescriptor, MiddlewareNext } from "graphile-config";
+import type { DocumentNode, GraphQLError, OperationDefinitionNode } from "graphql";
 import type { DataFromObjectSteps } from "./steps/object.js";
 type PromiseOrValue<T> = T | Promise<T>;
 import { exportAs, exportAsMany } from "./exportAs.js";
@@ -14,8 +14,9 @@ import { OperationPlan } from "./engine/OperationPlan.js";
 import { $$inhibit, flagError, isSafeError, SafeError } from "./error.js";
 import { execute } from "./execute.js";
 import { grafast, grafastSync } from "./grafastGraphql.js";
-import type { $$cacheByOperation, $$hooked, $$queryCache, CacheByOperationEntry, DataFromStep, GrafastExecutionArgs, GrafastTimeouts, ScalarInputPlanResolver } from "./interfaces.js";
+import type { $$cacheByOperation, $$hooked, $$queryCache, CacheByOperationEntry, DataFromStep, EstablishOperationPlanEvent, ExecuteEvent, ExecuteStepEvent, GrafastExecutionArgs, GrafastTimeouts, ParseAndValidateEvent, PrepareArgsEvent, ScalarInputPlanResolver, StreamStepEvent, ValidateSchemaEvent } from "./interfaces.js";
 import { $$bypassGraphQL, $$eventEmitter, $$extensions, $$idempotent, $$verbatim, ArgumentApplyPlanResolver, ArgumentInputPlanResolver, BaseEventMap, BaseGraphQLArguments, BaseGraphQLRootValue, BaseGraphQLVariables, EnumValueApplyPlanResolver, EventCallback, EventMapKey, ExecutionDetails, ExecutionEventEmitter, ExecutionEventMap, ExecutionExtra, FieldArgs, FieldInfo, FieldPlanResolver, GrafastArgumentConfig, GrafastFieldConfig, GrafastFieldConfigArgumentMap, GrafastInputFieldConfig, GrafastPlanJSON, GrafastResultsList, GrafastResultStreamList, GrafastSubscriber, GrafastValuesList, InputObjectFieldApplyPlanResolver, InputObjectFieldInputPlanResolver, InputObjectTypeInputPlanResolver, InputStep, JSONArray, JSONObject, JSONValue, Maybe, NodeIdCodec, NodeIdHandler, OutputPlanForType, PolymorphicData, PromiseOrDirect, ScalarPlanResolver, StepOptimizeOptions, StepStreamOptions, TypedEventEmitter, UnbatchedExecutionExtra } from "./interfaces.js";
+import { getGrafastMiddleware } from "./middleware.js";
 import { polymorphicWrap } from "./polymorphic.js";
 import { assertExecutableStep, assertListCapableStep, assertModifierStep, BaseStep, ExecutableStep, isExecutableStep, isListCapableStep, isListLikeStep, isModifierStep, isObjectLikeStep, isStreamableStep, ListCapableStep, ListLikeStep, ModifierStep, ObjectLikeStep, PolymorphicStep, StreamableStep, UnbatchedExecutableStep } from "./step.js";
 import { __FlagStep, __InputListStep, __InputObjectStep, __InputObjectStepWithDollars, __InputStaticLeafStep, __ItemStep, __ListTransformStep, __TrackedValueStep, __TrackedValueStepWithDollars, __ValueStep, access, AccessStep, ActualKeyByDesiredKey, applyTransforms, ApplyTransformsStep, assertEdgeCapableStep, assertNotNull, assertPageInfoCapableStep, condition, ConditionStep, connection, ConnectionCapableStep, ConnectionStep, constant, ConstantStep, context, debugPlans, each, EdgeCapableStep, EdgeStep, error, ErrorStep, filter, FilterPlanMemo, first, FirstStep, GraphQLItemHandler, graphqlItemHandler, graphqlResolver, GraphQLResolverStep, groupBy, GroupByPlanMemo, inhibitOnNull, lambda, LambdaStep, last, LastStep, list, listen, ListenStep, ListStep, listTransform, ListTransformItemPlanCallback, ListTransformOptions, ListTransformReduce, LoadedRecordStep, loadMany, LoadManyCallback, loadManyCallback, loadOne, LoadOneCallback, loadOneCallback, LoadOptions, LoadStep, makeDecodeNodeId, node, nodeIdFromNode, NodeStep, object, ObjectPlanMeta, ObjectStep, operationPlan, PageInfoCapableStep, partitionByIndex, polymorphicBranch, PolymorphicBranchMatcher, PolymorphicBranchMatchers, PolymorphicBranchStep, proxy, ProxyStep, remapKeys, RemapKeysStep, reverse, reverseArray, ReverseStep, rootValue, setter, SetterCapableStep, SetterStep, sideEffect, SideEffectStep, specFromNodeId, trackedContext, trackedRootValue, trap, TRAP_ERROR, TRAP_ERROR_OR_INHIBITED, TRAP_INHIBITED } from "./steps/index.js";
@@ -24,7 +25,7 @@ import { stripAnsi } from "./stripAnsi.js";
 import { subscribe } from "./subscribe.js";
 import { arrayOfLength, arraysMatch, getEnumValueConfig, GrafastInputFieldConfigMap, GrafastInputObjectType, GrafastObjectType, inputObjectFieldSpec, InputObjectTypeSpec, isPromiseLike, newGrafastFieldConfigBuilder, newInputObjectTypeBuilder, newObjectTypeBuilder, objectFieldSpec, objectSpec, ObjectTypeFields, ObjectTypeSpec, stepADependsOnStepB, stepAMayDependOnStepB, stepsAreInSamePhase } from "./utils.js";
 export { isAsyncIterable } from "iterall";
-export { __FlagStep, __InputListStep, __InputObjectStep, __InputObjectStepWithDollars, __InputStaticLeafStep, __ItemStep, __ListTransformStep, __TrackedValueStep, __TrackedValueStepWithDollars, __ValueStep, $$bypassGraphQL, $$eventEmitter, $$extensions, $$idempotent, $$inhibit, $$verbatim, access, AccessStep, ActualKeyByDesiredKey, applyTransforms, ApplyTransformsStep, ArgumentApplyPlanResolver, ArgumentInputPlanResolver, arrayOfLength, arraysMatch, assertEdgeCapableStep, assertExecutableStep, assertListCapableStep, assertModifierStep, assertNotNull, assertPageInfoCapableStep, BaseEventMap, BaseGraphQLArguments, BaseGraphQLRootValue, BaseGraphQLVariables, BaseStep, condition, ConditionStep, connection, ConnectionCapableStep, ConnectionStep, constant, ConstantStep, context, DataFromObjectSteps, DataFromStep, debugPlans, defer, Deferred, each, EdgeCapableStep, EdgeStep, EnumPlans, EnumValueApplyPlanResolver, error, ErrorStep, EventCallback, EventMapKey, ExecutableStep, execute, ExecutionDetails, ExecutionEventEmitter, ExecutionEventMap, ExecutionExtra, exportAs, exportAsMany, FieldArgs, FieldInfo, FieldPlanResolver, FieldPlans, filter, FilterPlanMemo, first, FirstStep, flagError, getEnumValueConfig, grafast, GrafastArgumentConfig, GrafastExecutionArgs, GrafastFieldConfig, GrafastFieldConfigArgumentMap, grafast as grafastGraphql, grafastSync as grafastGraphqlSync, GrafastInputFieldConfig, GrafastInputFieldConfigMap, GrafastInputObjectType, GrafastObjectType, GrafastPlanJSON, GrafastPlans, grafastPrint, GrafastResultsList, GrafastResultStreamList, GrafastSubscriber, grafastSync, GrafastValuesList, GraphQLItemHandler, graphqlItemHandler, graphqlResolver, GraphQLResolverStep, groupBy, GroupByPlanMemo, inhibitOnNull, InputObjectFieldApplyPlanResolver, InputObjectFieldInputPlanResolver, inputObjectFieldSpec, InputObjectPlans, InputObjectTypeInputPlanResolver, InputObjectTypeSpec, InputStep, InterfaceOrUnionPlans, isDev, isExecutableStep, isListCapableStep, isListLikeStep, isModifierStep, isObjectLikeStep, isPromiseLike, isSafeError, isStreamableStep, isUnaryStep, JSONArray, JSONObject, JSONValue, lambda, LambdaStep, last, LastStep, list, ListCapableStep, listen, ListenStep, ListLikeStep, ListStep, listTransform, ListTransformItemPlanCallback, ListTransformOptions, ListTransformReduce, LoadedRecordStep, loadMany, LoadManyCallback, loadManyCallback, loadOne, LoadOneCallback, loadOneCallback, LoadOptions, LoadStep, makeDecodeNodeId, makeGrafastSchema, Maybe, ModifierStep, newGrafastFieldConfigBuilder, newInputObjectTypeBuilder, newObjectTypeBuilder, node, NodeIdCodec, nodeIdFromNode, NodeIdHandler, NodeStep, noop, object, objectFieldSpec, ObjectLikeStep, ObjectPlanMeta, ObjectPlans, objectSpec, ObjectStep, ObjectTypeFields, ObjectTypeSpec, OperationPlan, operationPlan, OutputPlanForType, PageInfoCapableStep, partitionByIndex, polymorphicBranch, PolymorphicBranchMatcher, PolymorphicBranchMatchers, PolymorphicBranchStep, PolymorphicData, PolymorphicStep, polymorphicWrap, PromiseOrDirect, proxy, ProxyStep, remapKeys, RemapKeysStep, reverse, reverseArray, ReverseStep, rootValue, SafeError, ScalarPlanResolver, ScalarPlans, setter, SetterCapableStep, SetterStep, sideEffect, SideEffectStep, specFromNodeId, stepADependsOnStepB, stepAMayDependOnStepB, StepOptimizeOptions, stepsAreInSamePhase, StepStreamOptions, StreamableStep, stringifyPayload, stripAnsi, subscribe, trackedContext, trackedRootValue, trap, TRAP_ERROR, TRAP_ERROR_OR_INHIBITED, TRAP_INHIBITED, TypedEventEmitter, UnbatchedExecutableStep, UnbatchedExecutionExtra, };
+export { __FlagStep, __InputListStep, __InputObjectStep, __InputObjectStepWithDollars, __InputStaticLeafStep, __ItemStep, __ListTransformStep, __TrackedValueStep, __TrackedValueStepWithDollars, __ValueStep, $$bypassGraphQL, $$eventEmitter, $$extensions, $$idempotent, $$inhibit, $$verbatim, access, AccessStep, ActualKeyByDesiredKey, applyTransforms, ApplyTransformsStep, ArgumentApplyPlanResolver, ArgumentInputPlanResolver, arrayOfLength, arraysMatch, assertEdgeCapableStep, assertExecutableStep, assertListCapableStep, assertModifierStep, assertNotNull, assertPageInfoCapableStep, BaseEventMap, BaseGraphQLArguments, BaseGraphQLRootValue, BaseGraphQLVariables, BaseStep, condition, ConditionStep, connection, ConnectionCapableStep, ConnectionStep, constant, ConstantStep, context, DataFromObjectSteps, DataFromStep, debugPlans, defer, Deferred, each, EdgeCapableStep, EdgeStep, EnumPlans, EnumValueApplyPlanResolver, error, ErrorStep, EventCallback, EventMapKey, ExecutableStep, execute, ExecutionDetails, ExecutionEventEmitter, ExecutionEventMap, ExecutionExtra, exportAs, exportAsMany, FieldArgs, FieldInfo, FieldPlanResolver, FieldPlans, filter, FilterPlanMemo, first, FirstStep, flagError, getEnumValueConfig, getGrafastMiddleware, grafast, GrafastArgumentConfig, GrafastExecutionArgs, GrafastFieldConfig, GrafastFieldConfigArgumentMap, grafast as grafastGraphql, grafastSync as grafastGraphqlSync, GrafastInputFieldConfig, GrafastInputFieldConfigMap, GrafastInputObjectType, GrafastObjectType, GrafastPlanJSON, GrafastPlans, grafastPrint, GrafastResultsList, GrafastResultStreamList, GrafastSubscriber, grafastSync, GrafastValuesList, GraphQLItemHandler, graphqlItemHandler, graphqlResolver, GraphQLResolverStep, groupBy, GroupByPlanMemo, inhibitOnNull, InputObjectFieldApplyPlanResolver, InputObjectFieldInputPlanResolver, inputObjectFieldSpec, InputObjectPlans, InputObjectTypeInputPlanResolver, InputObjectTypeSpec, InputStep, InterfaceOrUnionPlans, isDev, isExecutableStep, isListCapableStep, isListLikeStep, isModifierStep, isObjectLikeStep, isPromiseLike, isSafeError, isStreamableStep, isUnaryStep, JSONArray, JSONObject, JSONValue, lambda, LambdaStep, last, LastStep, list, ListCapableStep, listen, ListenStep, ListLikeStep, ListStep, listTransform, ListTransformItemPlanCallback, ListTransformOptions, ListTransformReduce, LoadedRecordStep, loadMany, LoadManyCallback, loadManyCallback, loadOne, LoadOneCallback, loadOneCallback, LoadOptions, LoadStep, makeDecodeNodeId, makeGrafastSchema, Maybe, ModifierStep, newGrafastFieldConfigBuilder, newInputObjectTypeBuilder, newObjectTypeBuilder, node, NodeIdCodec, nodeIdFromNode, NodeIdHandler, NodeStep, noop, object, objectFieldSpec, ObjectLikeStep, ObjectPlanMeta, ObjectPlans, objectSpec, ObjectStep, ObjectTypeFields, ObjectTypeSpec, OperationPlan, operationPlan, OutputPlanForType, PageInfoCapableStep, partitionByIndex, polymorphicBranch, PolymorphicBranchMatcher, PolymorphicBranchMatchers, PolymorphicBranchStep, PolymorphicData, PolymorphicStep, polymorphicWrap, PromiseOrDirect, proxy, ProxyStep, remapKeys, RemapKeysStep, reverse, reverseArray, ReverseStep, rootValue, SafeError, ScalarPlanResolver, ScalarPlans, setter, SetterCapableStep, SetterStep, sideEffect, SideEffectStep, specFromNodeId, stepADependsOnStepB, stepAMayDependOnStepB, StepOptimizeOptions, stepsAreInSamePhase, StepStreamOptions, StreamableStep, stringifyPayload, stripAnsi, subscribe, trackedContext, trackedRootValue, trap, TRAP_ERROR, TRAP_ERROR_OR_INHIBITED, TRAP_INHIBITED, TypedEventEmitter, UnbatchedExecutableStep, UnbatchedExecutionExtra, };
 export { hookArgs } from "./args.js";
 export { version } from "./version.js";
 /** @deprecated Renamed to 'applyTransforms' */
@@ -33,7 +34,7 @@ export declare const deepEval: typeof applyTransforms;
 export declare const DeepEvalStep: typeof ApplyTransformsStep;
 declare global {
     namespace Grafast {
-        type ExecutionArgs = Pick<GraphQLExecutionArgs, "schema" | "document" | "rootValue" | "variableValues" | "operationName"> & {
+        type ExecutionArgs = Pick<GrafastExecutionArgs, "schema" | "document" | "rootValue" | "variableValues" | "operationName" | "resolvedPreset" | "middleware" | "requestContext" | "outputDataAsString"> & {
             [$$hooked]?: boolean;
             contextValue: Grafast.Context;
         };
@@ -142,16 +143,24 @@ declare global {
              */
             grafast?: GraphileConfig.GrafastOptions;
         }
-        interface GrafastHooks {
-            args: PluginHook<(event: {
-                args: Grafast.ExecutionArgs;
-                ctx: Grafast.RequestContext;
-                resolvedPreset: GraphileConfig.ResolvedPreset;
-            }) => PromiseOrValue<void>>;
+        interface GrafastMiddleware {
+            /** Synchronous! */
+            validateSchema(event: ValidateSchemaEvent): readonly GraphQLError[];
+            /** Synchronous! */
+            parseAndValidate(event: ParseAndValidateEvent): DocumentNode | readonly GraphQLError[];
+            prepareArgs(event: PrepareArgsEvent): PromiseOrDirect<Grafast.ExecutionArgs>;
+            execute(event: ExecuteEvent): ReturnType<typeof execute>;
+            subscribe(event: ExecuteEvent): ReturnType<typeof subscribe>;
+            /** Synchronous! */
+            establishOperationPlan(event: EstablishOperationPlanEvent): OperationPlan;
+            executeStep(event: ExecuteStepEvent): PromiseOrDirect<GrafastResultsList<any>>;
+            streamStep(event: StreamStepEvent): PromiseOrDirect<GrafastResultStreamList<unknown>>;
         }
         interface Plugin {
             grafast?: {
-                hooks?: GrafastHooks;
+                middleware?: {
+                    [key in keyof GrafastMiddleware]?: CallbackOrDescriptor<GrafastMiddleware[key] extends (...args: infer UArgs) => infer UResult ? (next: MiddlewareNext<Awaited<UResult>>, ...args: UArgs) => UResult : never>;
+                };
             };
         }
     }

package/dist/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEnumValueConfig = exports.flagError = exports.FirstStep = exports.first = exports.filter = exports.exportAsMany = exports.exportAs = exports.execute = exports.ExecutableStep = exports.ErrorStep = exports.error = exports.EdgeStep = exports.each = exports.defer = exports.debugPlans = exports.context = exports.ConstantStep = exports.constant = exports.ConnectionStep = exports.connection = exports.ConditionStep = exports.condition = exports.BaseStep = exports.assertPageInfoCapableStep = exports.assertNotNull = exports.assertModifierStep = exports.assertListCapableStep = exports.assertExecutableStep = exports.assertEdgeCapableStep = exports.arraysMatch = exports.arrayOfLength = exports.ApplyTransformsStep = exports.applyTransforms = exports.AccessStep = exports.access = exports.$$verbatim = exports.$$inhibit = exports.$$idempotent = exports.$$extensions = exports.$$eventEmitter = exports.$$bypassGraphQL = exports.__ValueStep = exports.__TrackedValueStep = exports.__ListTransformStep = exports.__ItemStep = exports.__InputStaticLeafStep = exports.__InputObjectStep = exports.__InputListStep = exports.__FlagStep = exports.isAsyncIterable = void 0;
-exports.objectSpec = exports.objectFieldSpec = exports.object = exports.noop = exports.NodeStep = exports.nodeIdFromNode = exports.node = exports.newObjectTypeBuilder = exports.newInputObjectTypeBuilder = exports.newGrafastFieldConfigBuilder = exports.ModifierStep = exports.makeGrafastSchema = exports.makeDecodeNodeId = exports.LoadStep = exports.loadOneCallback = exports.loadOne = exports.loadManyCallback = exports.loadMany = exports.LoadedRecordStep = exports.listTransform = exports.ListStep = exports.ListenStep = exports.listen = exports.list = exports.LastStep = exports.last = exports.LambdaStep = exports.lambda = exports.isUnaryStep = exports.isStreamableStep = exports.isSafeError = exports.isPromiseLike = exports.isObjectLikeStep = exports.isModifierStep = exports.isListLikeStep = exports.isListCapableStep = exports.isExecutableStep = exports.isDev = exports.inputObjectFieldSpec = exports.inhibitOnNull = exports.groupBy = exports.GraphQLResolverStep = exports.graphqlResolver = exports.graphqlItemHandler = exports.GraphQLItemHandler = exports.grafastSync = exports.grafastPrint = exports.grafastGraphqlSync = exports.grafastGraphql = exports.grafast = void 0;
-exports.DeepEvalStep = exports.deepEval = exports.version = exports.hookArgs = exports.UnbatchedExecutableStep = exports.TRAP_INHIBITED = exports.TRAP_ERROR_OR_INHIBITED = exports.TRAP_ERROR = exports.trap = exports.trackedRootValue = exports.trackedContext = exports.subscribe = exports.stripAnsi = exports.stringifyPayload = exports.stepsAreInSamePhase = exports.stepAMayDependOnStepB = exports.stepADependsOnStepB = exports.specFromNodeId = exports.SideEffectStep = exports.sideEffect = exports.SetterStep = exports.setter = exports.SafeError = exports.rootValue = exports.ReverseStep = exports.reverseArray = exports.reverse = exports.RemapKeysStep = exports.remapKeys = exports.ProxyStep = exports.proxy = exports.polymorphicWrap = exports.PolymorphicBranchStep = exports.polymorphicBranch = exports.partitionByIndex = exports.operationPlan = exports.OperationPlan = exports.ObjectStep = void 0;
+exports.objectFieldSpec = exports.object = exports.noop = exports.NodeStep = exports.nodeIdFromNode = exports.node = exports.newObjectTypeBuilder = exports.newInputObjectTypeBuilder = exports.newGrafastFieldConfigBuilder = exports.ModifierStep = exports.makeGrafastSchema = exports.makeDecodeNodeId = exports.LoadStep = exports.loadOneCallback = exports.loadOne = exports.loadManyCallback = exports.loadMany = exports.LoadedRecordStep = exports.listTransform = exports.ListStep = exports.ListenStep = exports.listen = exports.list = exports.LastStep = exports.last = exports.LambdaStep = exports.lambda = exports.isUnaryStep = exports.isStreamableStep = exports.isSafeError = exports.isPromiseLike = exports.isObjectLikeStep = exports.isModifierStep = exports.isListLikeStep = exports.isListCapableStep = exports.isExecutableStep = exports.isDev = exports.inputObjectFieldSpec = exports.inhibitOnNull = exports.groupBy = exports.GraphQLResolverStep = exports.graphqlResolver = exports.graphqlItemHandler = exports.GraphQLItemHandler = exports.grafastSync = exports.grafastPrint = exports.grafastGraphqlSync = exports.grafastGraphql = exports.grafast = exports.getGrafastMiddleware = void 0;
+exports.DeepEvalStep = exports.deepEval = exports.version = exports.hookArgs = exports.UnbatchedExecutableStep = exports.TRAP_INHIBITED = exports.TRAP_ERROR_OR_INHIBITED = exports.TRAP_ERROR = exports.trap = exports.trackedRootValue = exports.trackedContext = exports.subscribe = exports.stripAnsi = exports.stringifyPayload = exports.stepsAreInSamePhase = exports.stepAMayDependOnStepB = exports.stepADependsOnStepB = exports.specFromNodeId = exports.SideEffectStep = exports.sideEffect = exports.SetterStep = exports.setter = exports.SafeError = exports.rootValue = exports.ReverseStep = exports.reverseArray = exports.reverse = exports.RemapKeysStep = exports.remapKeys = exports.ProxyStep = exports.proxy = exports.polymorphicWrap = exports.PolymorphicBranchStep = exports.polymorphicBranch = exports.partitionByIndex = exports.operationPlan = exports.OperationPlan = exports.ObjectStep = exports.objectSpec = void 0;
 const tslib_1 = require("tslib");
 require("./thereCanBeOnlyOne.js");
 const debug_1 = tslib_1.__importDefault(require("debug"));
@@ -43,6 +43,8 @@ Object.defineProperty(exports, "$$eventEmitter", { enumerable: true, get: functi
 Object.defineProperty(exports, "$$extensions", { enumerable: true, get: function () { return interfaces_js_1.$$extensions; } });
 Object.defineProperty(exports, "$$idempotent", { enumerable: true, get: function () { return interfaces_js_1.$$idempotent; } });
 Object.defineProperty(exports, "$$verbatim", { enumerable: true, get: function () { return interfaces_js_1.$$verbatim; } });
+const middleware_js_1 = require("./middleware.js");
+Object.defineProperty(exports, "getGrafastMiddleware", { enumerable: true, get: function () { return middleware_js_1.getGrafastMiddleware; } });
 const polymorphic_js_1 = require("./polymorphic.js");
 Object.defineProperty(exports, "polymorphicWrap", { enumerable: true, get: function () { return polymorphic_js_1.polymorphicWrap; } });
 const step_js_1 = require("./step.js");
@@ -170,6 +172,7 @@ Object.defineProperty(exports, "isAsyncIterable", { enumerable: true, get: funct
     OperationPlan: OperationPlan_js_1.OperationPlan,
     defer: deferred_js_1.defer,
     execute: execute_js_1.execute,
+    getGrafastMiddleware: middleware_js_1.getGrafastMiddleware,
     grafast: grafastGraphql_js_1.grafast,
     grafastSync: grafastGraphql_js_1.grafastSync,
     subscribe: subscribe_js_1.subscribe,

package/dist/interfaces.d.ts

@@ -1,8 +1,10 @@
 import type EventEmitter from "eventemitter3";
-import type { ASTNode, ExecutionArgs, FragmentDefinitionNode, GraphQLArgs, GraphQLArgument, GraphQLArgumentConfig, GraphQLField, GraphQLFieldConfig, GraphQLInputField, GraphQLInputFieldConfig, GraphQLInputObjectType, GraphQLInputType, GraphQLList, GraphQLNonNull, GraphQLOutputType, GraphQLScalarType, GraphQLSchema, GraphQLType, ValueNode, VariableNode } from "graphql";
+import type { Middleware } from "graphile-config";
+import type { ASTNode, ExecutionArgs, FragmentDefinitionNode, GraphQLArgs, GraphQLArgument, GraphQLArgumentConfig, GraphQLField, GraphQLFieldConfig, GraphQLInputField, GraphQLInputFieldConfig, GraphQLInputObjectType, GraphQLInputType, GraphQLList, GraphQLNonNull, GraphQLOutputType, GraphQLScalarType, GraphQLSchema, GraphQLType, OperationDefinitionNode, Source, ValueNode, VariableNode } from "graphql";
+import type { ObjMap } from "graphql/jsutils/ObjMap.js";
 import type { OperationPlan } from "./engine/OperationPlan.js";
 import type { FlaggedValue, SafeError } from "./error.js";
-import type { ExecutableStep, ListCapableStep, ModifierStep } from "./step.js";
+import type { ExecutableStep, ListCapableStep, ModifierStep, StreamableStep } from "./step.js";
 import type { __InputDynamicScalarStep } from "./steps/__inputDynamicScalar.js";
 import type { __InputListStep, __InputObjectStepWithDollars, __InputStaticLeafStep, __TrackedValueStep, __TrackedValueStepWithDollars, ConstantStep } from "./steps/index.js";
 import type { GrafastInputObjectType, GrafastObjectType } from "./utils.js";
@@ -461,6 +463,7 @@ export type StreamMoreableArray<T = any> = Array<T> & {
 export interface GrafastArgs extends GraphQLArgs {
     resolvedPreset?: GraphileConfig.ResolvedPreset;
     requestContext?: Partial<Grafast.RequestContext>;
+    middleware?: Middleware<GraphileConfig.GrafastMiddleware> | null;
 }
 export type Maybe<T> = T | null | undefined;
 export * from "./planJSONInterfaces.js";
@@ -474,6 +477,46 @@ export interface AddDependencyOptions {
 export type DataFromStep<TStep extends ExecutableStep> = TStep extends ExecutableStep<infer TData> ? TData : never;
 export interface GrafastExecutionArgs extends ExecutionArgs {
     resolvedPreset?: GraphileConfig.ResolvedPreset;
+    middleware?: Middleware<GraphileConfig.GrafastMiddleware> | null;
+    requestContext?: Partial<Grafast.RequestContext>;
     outputDataAsString?: boolean;
 }
+export interface ValidateSchemaEvent {
+    resolvedPreset: GraphileConfig.ResolvedPreset;
+    schema: GraphQLSchema;
+}
+export interface ParseAndValidateEvent {
+    resolvedPreset: GraphileConfig.ResolvedPreset;
+    schema: GraphQLSchema;
+    source: string | Source;
+}
+export interface PrepareArgsEvent {
+    args: Grafast.ExecutionArgs;
+}
+export interface ExecuteEvent {
+    args: GrafastExecutionArgs;
+}
+export interface SubscribeEvent {
+    args: GrafastExecutionArgs;
+}
+export interface EstablishOperationPlanEvent {
+    schema: GraphQLSchema;
+    operation: OperationDefinitionNode;
+    fragments: ObjMap<FragmentDefinitionNode>;
+    variableValues: Record<string, any>;
+    context: any;
+    rootValue: any;
+    planningTimeout: number | undefined;
+    args: GrafastExecutionArgs;
+}
+export interface ExecuteStepEvent {
+    args: GrafastExecutionArgs;
+    step: ExecutableStep;
+    executeDetails: ExecutionDetails;
+}
+export interface StreamStepEvent {
+    args: GrafastExecutionArgs;
+    step: StreamableStep<unknown>;
+    streamDetails: StreamDetails;
+}
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/middleware.d.ts

@@ -0,0 +1,7 @@
+import { Middleware } from "graphile-config";
+declare const $$middleware: unique symbol;
+export declare function getGrafastMiddleware(resolvedPreset: GraphileConfig.ResolvedPreset & {
+    [$$middleware]?: Middleware<GraphileConfig.GrafastMiddleware> | null;
+}): Middleware<GraphileConfig.GrafastMiddleware> | null;
+export {};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGrafastMiddleware = void 0;
+const graphile_config_1 = require("graphile-config");
+const $$middleware = Symbol("middleware");
+function getGrafastMiddleware(resolvedPreset) {
+    if (resolvedPreset[$$middleware] !== undefined) {
+        return resolvedPreset[$$middleware];
+    }
+    let middleware = null;
+    (0, graphile_config_1.orderedApply)(resolvedPreset.plugins, (p) => p.grafast?.middleware, (name, fn, _plugin) => {
+        if (!middleware)
+            middleware = new graphile_config_1.Middleware();
+        middleware.register(name, fn);
+    });
+    try {
+        resolvedPreset[$$middleware] = middleware;
+    }
+    catch {
+        // Ignore - preset must be readonly
+    }
+    return middleware;
+}
+exports.getGrafastMiddleware = getGrafastMiddleware;
+//# sourceMappingURL=middleware.js.map

package/dist/prepare.js

@@ -171,7 +171,7 @@ function outputBucket(outputPlan, rootBucket, rootBucketIndex, requestContext, p
         releaseUnusedIterators(rootBucket, rootBucketIndex, ctx.root.streams);
     }
 }
-function executePreemptive(operationPlan, variableValues, context, rootValue, outputDataAsString, executionTimeout) {
+function executePreemptive(args, operationPlan, variableValues, context, rootValue, outputDataAsString, executionTimeout) {
     const rootBucketIndex = 0;
     const size = 1;
     const polymorphicPathList = [OperationPlan_js_1.POLYMORPHIC_ROOT_PATH];
@@ -191,6 +191,7 @@ function executePreemptive(operationPlan, variableValues, context, rootValue, ou
     const startTime = timeSource_js_1.timeSource.now();
     const stopTime = executionTimeout !== null ? startTime + executionTimeout : null;
     const requestContext = {
+        args,
         startTime,
         stopTime,
         // toSerialize: [],
@@ -338,14 +339,17 @@ function executePreemptive(operationPlan, variableValues, context, rootValue, ou
         return output();
     }
 }
+function establishOperationPlanFromEvent(event) {
+    return (0, establishOperationPlan_js_1.establishOperationPlan)(event.schema, event.operation, event.fragments, event.variableValues, event.context, event.rootValue, event.planningTimeout);
+}
 /**
  * @internal
  */
 function grafastPrepare(args, options = {}) {
-    const { schema, contextValue: context, rootValue = Object.create(null),
+    const { schema, contextValue: context, rootValue = Object.create(null), 
     // operationName,
     // document,
-     } = args;
+    middleware, } = args;
     const exeContext = (0, execute_1.buildExecutionContext)(args);
     // If a list of errors was returned, abort
     if (Array.isArray(exeContext) || "length" in exeContext) {
@@ -358,7 +362,21 @@ function grafastPrepare(args, options = {}) {
     const planningTimeout = options.timeouts?.planning;
     let operationPlan;
     try {
-        operationPlan = (0, establishOperationPlan_js_1.establishOperationPlan)(schema, operation, fragments, variableValues, context, rootValue, planningTimeout);
+        if (middleware != null) {
+            operationPlan = middleware.runSync("establishOperationPlan", {
+                schema,
+                operation,
+                fragments,
+                variableValues,
+                context: context,
+                rootValue,
+                planningTimeout,
+                args,
+            }, establishOperationPlanFromEvent);
+        }
+        else {
+            operationPlan = (0, establishOperationPlan_js_1.establishOperationPlan)(schema, operation, fragments, variableValues, context, rootValue, planningTimeout);
+        }
     }
     catch (error) {
         const graphqlError = error instanceof GraphQLError
@@ -379,7 +397,7 @@ function grafastPrepare(args, options = {}) {
         });
     }
     const executionTimeout = options.timeouts?.execution ?? null;
-    return executePreemptive(operationPlan, variableValues, context, rootValue, options.outputDataAsString ?? false, executionTimeout);
+    return executePreemptive(args, operationPlan, variableValues, context, rootValue, options.outputDataAsString ?? false, executionTimeout);
 }
 exports.grafastPrepare = grafastPrepare;
 function newIterator(abort) {

package/dist/subscribe.js

@@ -1,10 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.subscribe = void 0;
-const config_js_1 = require("./config.js");
 const execute_js_1 = require("./execute.js");
-function subscribe(args, resolvedPreset, outputDataAsString) {
-    return (0, execute_js_1.withGrafastArgs)(args, args.resolvedPreset ?? resolvedPreset ?? config_js_1.NULL_PRESET, args.outputDataAsString ?? outputDataAsString ?? false);
+const middleware_js_1 = require("./middleware.js");
+function subscribe(args, legacyResolvedPreset, legacyOutputDataAsString) {
+    // TODO: remove legacy compatibility
+    if (legacyResolvedPreset !== undefined) {
+        args.resolvedPreset = legacyResolvedPreset;
+    }
+    if (legacyOutputDataAsString !== undefined) {
+        args.outputDataAsString = legacyOutputDataAsString;
+    }
+    const { resolvedPreset } = args;
+    const middleware = args.middleware === undefined && resolvedPreset != null
+        ? (0, middleware_js_1.getGrafastMiddleware)(resolvedPreset)
+        : args.middleware ?? null;
+    if (args.middleware === undefined) {
+        args.middleware = middleware;
+    }
+    if (middleware !== null) {
+        return middleware.run("subscribe", { args }, subscribeMiddlewareCallback);
+    }
+    else {
+        return (0, execute_js_1.withGrafastArgs)(args);
+    }
 }
 exports.subscribe = subscribe;
+const subscribeMiddlewareCallback = (event) => (0, execute_js_1.withGrafastArgs)(event.args);
 //# sourceMappingURL=subscribe.js.map

package/dist/utils.d.ts

@@ -21,7 +21,7 @@ export declare function isPromise<T>(t: T | Promise<T>): t is Promise<T>;
 /**
  * Is "thenable".
  */
-export declare function isPromiseLike<T>(t: T | Promise<T> | PromiseLike<T>): t is PromiseLike<T>;
+export declare function isPromiseLike<T>(t: T | Promise<T> | PromiseLike<T>): t is PromiseLike<T> | Promise<T>;
 /**
  * Is a promise that can be externally resolved.
  */

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "0.1.1-beta.10";
+export declare const version = "0.1.1-beta.11";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // This file is autogenerated by /scripts/postversion.mjs
-exports.version = "0.1.1-beta.10";
+exports.version = "0.1.1-beta.11";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grafast",
-  "version": "0.1.1-beta.10",
+  "version": "0.1.1-beta.11",
   "description": "Cutting edge GraphQL planning and execution engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -66,7 +66,7 @@
   },
   "peerDependencies": {
     "@envelop/core": "^5.0.0",
-    "graphile-config": "^0.0.1-beta.8",
+    "graphile-config": "^0.0.1-beta.9",
     "graphql": "^16.1.0-experimental-stream-defer.6",
     "tamedevil": "^0.0.0-beta.7"
   },