grafast 0.1.1-beta.13 → 0.1.1-beta.15

package/README.md

@@ -53,6 +53,8 @@ And please give some love to our featured sponsors 🤩:
 <td align="center"><a href="https://dovetailapp.com/"><img src="https://graphile.org/images/sponsors/dovetail.png" width="90" height="90" alt="Dovetail" /><br />Dovetail</a> *</td>
 <td align="center"><a href="https://stellate.co/"><img src="https://graphile.org/images/sponsors/Stellate.png" width="90" height="90" alt="Stellate" /><br />Stellate</a> *</td>
 <td align="center"><a href="https://gosteelhead.com/"><img src="https://graphile.org/images/sponsors/steelhead.svg" width="90" height="90" alt="Steelhead" /><br />Steelhead</a> *</td>
+</tr><tr>
+<td align="center"><a href=""><img src="https://graphile.org/images/sponsors/latchbio.jpg" width="90" height="90" alt="LatchBio" /><br />LatchBio</a> *</td>
 </tr></table>
 
 <em>\* Sponsors the entire Graphile suite</em>

package/dist/engine/OperationPlan.js

@@ -615,9 +615,7 @@ class OperationPlan {
                 const rawPlanResolver = objectField.extensions?.grafast?.plan;
                 if (rawPlanResolver) {
                     resolverEmulation = false;
-                }
-                if (rawPlanResolver?.constructor?.name === "AsyncFunction") {
-                    throw new Error(`Plans must be synchronous, but this schema has an async function at '${objectType.name}.${fieldName}.plan': ${rawPlanResolver.toString()}`);
+                    (0, utils_js_1.assertNotAsync)(rawPlanResolver, `${objectType.name}.${fieldName}.plan`);
                 }
                 const namedReturnType = getNamedType(fieldType);
                 const resolvedResolver = objectField.resolve;
@@ -848,13 +846,12 @@ class OperationPlan {
         }
         else if (isScalarType(nullableFieldType)) {
             const scalarPlanResolver = nullableFieldType.extensions?.grafast?.plan;
-            if (scalarPlanResolver?.constructor?.name === "AsyncFunction") {
-                throw new Error(`Plans must be synchronous, but this schema has an async function at '${nullableFieldType.name}.plan': ${scalarPlanResolver.toString()}`);
-            }
+            const fnDescription = `${nullableFieldType.name}.plan`;
+            (0, utils_js_1.assertNotAsync)(scalarPlanResolver, fnDescription);
             const $sideEffect = parentLayerPlan.latestSideEffectStep;
             try {
                 const $leaf = typeof scalarPlanResolver === "function"
-                    ? (0, withGlobalLayerPlan_js_1.withGlobalLayerPlan)(parentLayerPlan, polymorphicPaths, scalarPlanResolver, null, $step, this.scalarPlanInfo)
+                    ? (0, utils_js_1.assertNotPromise)((0, withGlobalLayerPlan_js_1.withGlobalLayerPlan)(parentLayerPlan, polymorphicPaths, scalarPlanResolver, null, $step, this.scalarPlanInfo), scalarPlanResolver, fnDescription)
                     : $step;
                 parentOutputPlan.addChild(parentObjectType, responseKey, {
                     type: "outputPlan",

package/dist/engine/executeBucket.js

@@ -432,7 +432,7 @@ function executeBucket(bucket, requestContext) {
                                 }
                                 // End "f2b3b1b3" block
                             }
-                            else {
+                            else if (forceIndexValue === undefined) {
                                 const depVal = depExecutionVal.at(dataIndex);
                                 let depFlags;
                                 if ((bucket.flagUnion & interfaces_js_1.FLAG_ERROR) === interfaces_js_1.FLAG_ERROR &&
@@ -768,7 +768,7 @@ function executeBucket(bucket, requestContext) {
             }
             const result = needsFiltering
                 ? reallyExecuteStepWithFiltering(step, dependencies, _rawForbiddenFlags, _rawOnReject, bucket.polymorphicPathList, extra)
-                : reallyExecuteStepWithoutFiltering(step._isUnary ? 1 : size, step, dependencies, extra);
+                : reallyExecuteStepWithoutFiltering(step._isUnary ? 1 : size, step, $sideEffect ? dependencies.slice(0, depCount) : dependencies, extra);
             if ((0, utils_js_1.isPromiseLike)(result)) {
                 return result.then(null, (error) => {
                     // Don't need to do this here, it will be done where the

package/dist/graphqlCollectFields.js

@@ -49,6 +49,12 @@ function evalDirectiveArgDirect(directive, argumentName, variableValuesStep, def
             case "IntValue": {
                 return parseInt(value.value, 10);
             }
+            case "FloatValue": {
+                return parseFloat(value.value);
+            }
+            case "StringValue": {
+                return value.value;
+            }
             case "NullValue": {
                 return null;
             }

package/dist/index.d.ts

@@ -17,6 +17,8 @@ import { grafast, grafastSync } from "./grafastGraphql.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 type { Multistep, UnwrapMultistep } from "./multistep.js";
+import { multistep } from "./multistep.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";
@@ -25,7 +27,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, 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 { __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, Multistep, multistep, 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, UnwrapMultistep, };
 export { hookArgs } from "./args.js";
 export { version } from "./version.js";
 /** @deprecated Renamed to 'applyTransforms' */

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.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;
+exports.object = exports.noop = exports.NodeStep = exports.nodeIdFromNode = exports.node = exports.newObjectTypeBuilder = exports.newInputObjectTypeBuilder = exports.newGrafastFieldConfigBuilder = exports.multistep = 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 = exports.objectFieldSpec = void 0;
 const tslib_1 = require("tslib");
 require("./thereCanBeOnlyOne.js");
 const debug_1 = tslib_1.__importDefault(require("debug"));
@@ -45,6 +45,8 @@ Object.defineProperty(exports, "$$idempotent", { enumerable: true, get: function
 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 multistep_js_1 = require("./multistep.js");
+Object.defineProperty(exports, "multistep", { enumerable: true, get: function () { return multistep_js_1.multistep; } });
 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");
@@ -288,6 +290,7 @@ Object.defineProperty(exports, "isAsyncIterable", { enumerable: true, get: funct
     flagError: error_js_1.flagError,
     SafeError: error_js_1.SafeError,
     isUnaryStep: withGlobalLayerPlan_js_1.isUnaryStep,
+    multistep: multistep_js_1.multistep,
 });
 var args_js_1 = require("./args.js");
 Object.defineProperty(exports, "hookArgs", { enumerable: true, get: function () { return args_js_1.hookArgs; } });

package/dist/multistep.d.ts

@@ -0,0 +1,19 @@
+import { ExecutableStep } from "./step.js";
+/**
+ * When using this, always use `const`! Otherwise tuples will show up as arrays
+ * and break things.
+ */
+export type Multistep = null | undefined | ExecutableStep | readonly [...(readonly ExecutableStep[])] | Record<string, ExecutableStep>;
+export type UnwrapMultistep<TMultistepSpec extends Multistep> = TMultistepSpec extends null ? null : TMultistepSpec extends undefined ? undefined : TMultistepSpec extends ExecutableStep<infer U> ? U : TMultistepSpec extends readonly [...(readonly any[])] ? {
+    [index in keyof TMultistepSpec]: TMultistepSpec[index] extends ExecutableStep<infer V> ? V : never;
+} : {
+    [key in keyof TMultistepSpec]: TMultistepSpec[key] extends ExecutableStep<infer V> ? V : never;
+};
+interface MultistepCacheConfig {
+    identifier: string;
+    cacheSize: number;
+}
+export declare function multistep<const TMultistepSpec extends Multistep>(spec: TMultistepSpec, stable?: string | true | MultistepCacheConfig): ExecutableStep<UnwrapMultistep<TMultistepSpec>>;
+export declare function isMultistep<const TMultistepSpec extends Multistep>(spec: any): spec is TMultistepSpec;
+export {};
+//# sourceMappingURL=multistep.d.ts.map

package/dist/multistep.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMultistep = exports.multistep = void 0;
+const step_js_1 = require("./step.js");
+const constant_js_1 = require("./steps/constant.js");
+const list_js_1 = require("./steps/list.js");
+const object_js_1 = require("./steps/object.js");
+const utils_js_1 = require("./utils.js");
+function multistep(spec, stable) {
+    if (spec == null) {
+        return (0, constant_js_1.constant)(spec);
+    }
+    else if (spec instanceof step_js_1.ExecutableStep) {
+        return spec;
+    }
+    else if ((0, utils_js_1.isTuple)(spec)) {
+        const config = stable === true
+            ? { identifier: `multistep` }
+            : typeof stable === "string"
+                ? { identifier: stable }
+                : stable;
+        const $step = (0, list_js_1.list)(spec, config);
+        return $step;
+    }
+    else {
+        const config = stable === true
+            ? { identifier: `multistep` }
+            : typeof stable === "string"
+                ? { identifier: stable }
+                : stable;
+        const $step = (0, object_js_1.object)(spec, config);
+        return $step;
+    }
+}
+exports.multistep = multistep;
+function isMultistep(spec) {
+    if (spec == null) {
+        return true;
+    }
+    else if (spec instanceof step_js_1.ExecutableStep) {
+        return true;
+    }
+    else if ((0, utils_js_1.isTuple)(spec) && spec.every((s) => s instanceof step_js_1.ExecutableStep)) {
+        return true;
+    }
+    else if (typeof spec === "object" &&
+        Object.values(spec).every((s) => s instanceof step_js_1.ExecutableStep)) {
+        return true;
+    }
+    else {
+        return false;
+    }
+}
+exports.isMultistep = isMultistep;
+//# sourceMappingURL=multistep.js.map

package/dist/operationPlan-input.js

@@ -6,7 +6,13 @@ const graphql = tslib_1.__importStar(require("graphql"));
 const constant_js_1 = require("./steps/constant.js");
 const list_js_1 = require("./steps/list.js");
 const object_js_1 = require("./steps/object.js");
+const utils_js_1 = require("./utils.js");
 const { getNullableType, isEnumType, isInputObjectType, isListType, isScalarType, } = graphql;
+function assertNotRuntime(operationPlan, description) {
+    if (operationPlan.phase === "ready") {
+        throw new Error(`${description} may only be called at planning time; however you have code that has attempted to call it during execution time. Please revisit your plan resolvers to locate the issue.`);
+    }
+}
 function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAfterMode, callback) {
     if (operationPlan.loc !== null)
         operationPlan.loc.push(`withFieldArgsForArguments(${field.name})`);
@@ -20,6 +26,7 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
     let explicitlyApplied = false;
     const fieldArgs = {
         getRaw(path) {
+            assertNotRuntime(operationPlan, `fieldArgs.getRaw()`);
             if (typeof path === "string") {
                 return $all.get(path);
             }
@@ -47,6 +54,7 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
             }
         },
         get(inPath) {
+            assertNotRuntime(operationPlan, `fieldArgs.get()`);
             const path = Array.isArray(inPath)
                 ? inPath
                 : inPath
@@ -111,21 +119,27 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
                 if (rest.length === 0) {
                     // Argument
                     const arg = entity;
-                    result = arg.extensions.grafast?.inputPlan
-                        ? arg.extensions.grafast.inputPlan($parent, childFieldArgs, {
+                    const argInputPlan = arg.extensions.grafast?.inputPlan;
+                    const fnDescription = `???.${field.name}(${arg.name}:).inputPlan`;
+                    (0, utils_js_1.assertNotAsync)(argInputPlan, fnDescription);
+                    result = argInputPlan
+                        ? (0, utils_js_1.assertNotPromise)(argInputPlan($parent, childFieldArgs, {
                             schema,
                             entity: arg,
-                        })
+                        }), argInputPlan, fnDescription)
                         : childFieldArgs.get();
                 }
                 else {
                     // Input field
                     const inputField = entity;
-                    result = inputField?.extensions.grafast?.inputPlan
-                        ? inputField.extensions.grafast.inputPlan(childFieldArgs, {
+                    const inputFieldInputPlan = inputField?.extensions.grafast?.inputPlan;
+                    const fnDescription = `???.${inputField?.name}.inputPlan`;
+                    (0, utils_js_1.assertNotAsync)(inputFieldInputPlan, fnDescription);
+                    result = inputFieldInputPlan
+                        ? (0, utils_js_1.assertNotPromise)(inputFieldInputPlan(childFieldArgs, {
                             schema,
                             entity: inputField,
-                        })
+                        }), inputFieldInputPlan, fnDescription)
                         : childFieldArgs.get();
                 }
                 const nullableType = getNullableType(entityType);
@@ -136,6 +150,7 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
             }
         },
         apply(targetStepOrCallback, inPath) {
+            assertNotRuntime(operationPlan, `fieldArgs.apply()`);
             const path = Array.isArray(inPath) ? inPath : inPath ? [inPath] : [];
             const pathString = path.join(".");
             const $existing = applied.get(pathString);
@@ -197,21 +212,27 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
                         if (rest.length === 0) {
                             // Argument
                             const arg = entity;
-                            result = arg.extensions.grafast?.applyPlan
-                                ? arg.extensions.grafast.applyPlan($parent, $target, childFieldArgs, {
+                            const argApplyPlan = arg.extensions.grafast?.applyPlan;
+                            const fnDescription = `???.${field.name}(${arg.name}:).applyPlan`;
+                            (0, utils_js_1.assertNotAsync)(argApplyPlan, fnDescription);
+                            result = argApplyPlan
+                                ? (0, utils_js_1.assertNotPromise)(argApplyPlan($parent, $target, childFieldArgs, {
                                     schema,
                                     entity: arg,
-                                })
+                                }), argApplyPlan, fnDescription)
                                 : undefined;
                         }
                         else if (entity) {
                             // input field
                             const inputField = entity;
-                            result = inputField.extensions.grafast?.applyPlan
-                                ? inputField.extensions.grafast.applyPlan($target, childFieldArgs, {
+                            const inputFieldApplyPlan = inputField.extensions.grafast?.applyPlan;
+                            const fnDescription = `???.${inputField.name}.applyPlan`;
+                            (0, utils_js_1.assertNotAsync)(inputFieldApplyPlan, fnDescription);
+                            result = inputFieldApplyPlan
+                                ? (0, utils_js_1.assertNotPromise)(inputFieldApplyPlan($target, childFieldArgs, {
                                     schema,
                                     entity: inputField,
-                                })
+                                }), inputFieldApplyPlan, fnDescription)
                                 : undefined;
                         }
                         else {
@@ -243,9 +264,11 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
         const nullableEntityType = getNullableType(entityType);
         const localFieldArgs = {
             getRaw(subpath) {
+                assertNotRuntime(operationPlan, `fieldArgs.getRaw()`);
                 return fieldArgs.getRaw(concatPath(path, subpath));
             },
             get(subpath) {
+                assertNotRuntime(operationPlan, `fieldArgs.get()`);
                 if (!subpath || (Array.isArray(subpath) && subpath.length === 0)) {
                     if (isListType(nullableEntityType)) {
                         if (!("evalLength" in $input)) {
@@ -265,10 +288,12 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
                     else if (isInputObjectType(nullableEntityType)) {
                         const typeResolver = nullableEntityType.extensions.grafast?.inputPlan ||
                             defaultInputObjectTypeInputPlanResolver;
-                        const resolvedResult = typeResolver(getFieldArgsForPath(path, nullableEntityType, $input, "input"), {
+                        const fnDescription = `${nullableEntityType}.inputPlan`;
+                        (0, utils_js_1.assertNotAsync)(typeResolver, fnDescription);
+                        const resolvedResult = (0, utils_js_1.assertNotPromise)(typeResolver(getFieldArgsForPath(path, nullableEntityType, $input, "input"), {
                             schema,
                             type: nullableEntityType,
-                        });
+                        }), typeResolver, fnDescription);
                         if (mode === "apply") {
                             // NOTE: if mode === 'input' then `.get()` won't need a
                             // `processAfter` since that will already have been handled in
@@ -279,11 +304,13 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
                     }
                     else if (isScalarType(nullableEntityType)) {
                         const scalarResolver = nullableEntityType.extensions.grafast?.inputPlan;
+                        const fnDescription = `${nullableEntityType}.inputPlan`;
+                        (0, utils_js_1.assertNotAsync)(scalarResolver, fnDescription);
                         if (scalarResolver !== undefined) {
-                            return scalarResolver($input, {
+                            return (0, utils_js_1.assertNotPromise)(scalarResolver($input, {
                                 schema,
                                 type: nullableEntityType,
-                            });
+                            }), scalarResolver, fnDescription);
                         }
                         else {
                             return $input;
@@ -307,6 +334,7 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
                 return fieldArgs.get(concatPath(path, subpath));
             },
             apply(targetStepOrCallback, subpath) {
+                assertNotRuntime(operationPlan, `fieldArgs.apply()`);
                 if (mode === "apply" &&
                     (!subpath || (Array.isArray(subpath) && subpath.length === 0))) {
                     if (isInputObjectType(nullableEntityType)) {
@@ -349,12 +377,16 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
                         const enumValue = nullableEntityType
                             .getValues()
                             .find((v) => v.value === value);
-                        const enumResolver = enumValue?.extensions.grafast?.applyPlan;
-                        if (enumResolver !== undefined) {
-                            const $target = typeof targetStepOrCallback === "function"
-                                ? targetStepOrCallback()
-                                : targetStepOrCallback;
-                            enumResolver($target);
+                        if (enumValue) {
+                            const enumResolver = enumValue.extensions.grafast?.applyPlan;
+                            const fnDescription = `${nullableEntityType.name}.${enumValue.name}.applyPlan`;
+                            (0, utils_js_1.assertNotAsync)(enumResolver, fnDescription);
+                            if (enumResolver !== undefined) {
+                                const $target = typeof targetStepOrCallback === "function"
+                                    ? targetStepOrCallback()
+                                    : targetStepOrCallback;
+                                (0, utils_js_1.assertNotPromise)(enumResolver($target), enumResolver, fnDescription);
+                            }
                         }
                     }
                     else {
@@ -397,6 +429,7 @@ function withFieldArgsForArguments(operationPlan, $parent, $all, field, applyAft
         return localFieldArgs;
     }
     const result = callback(fieldArgs);
+    (0, utils_js_1.assertNotPromise)(result, callback, operationPlan.loc?.join(">") ?? "???");
     if (!explicitlyApplied) {
         processAfter(fieldArgs, [], result, args, applyAfterMode);
     }

package/dist/step.js

@@ -225,6 +225,9 @@ class ExecutableStep extends BaseStep {
         const options = stepOrOptions instanceof ExecutableStep
             ? { step: stepOrOptions, skipDeduplication: false }
             : stepOrOptions;
+        if (options.step.layerPlan.id > this.layerPlan.id) {
+            throw new Error(`Cannot add dependency ${options.step} to ${this} since the former is in a deeper layerPlan (creates a catch-22)`);
+        }
         return this.operationPlan.stepTracker.addStepDependency(this, options);
     }
     /**
@@ -237,6 +240,9 @@ class ExecutableStep extends BaseStep {
         const options = stepOrOptions instanceof ExecutableStep
             ? { step: stepOrOptions }
             : stepOrOptions;
+        if (options.step.layerPlan.id > this.layerPlan.id) {
+            throw new Error(`Cannot add dependency ${options.step} to ${this} since the former is in a deeper layerPlan (creates a catch-22)`);
+        }
         return this.operationPlan.stepTracker.addStepUnaryDependency(this, options);
     }
     finalize() {

package/dist/steps/lambda.d.ts

@@ -1,4 +1,5 @@
-import type { PromiseOrDirect, UnbatchedExecutionExtra, UnwrapPlanTuple } from "../interfaces.js";
+import type { PromiseOrDirect, UnbatchedExecutionExtra } from "../interfaces.js";
+import type { Multistep, UnwrapMultistep } from "../multistep.js";
 import type { ExecutableStep } from "../step.js";
 import { UnbatchedExecutableStep } from "../step.js";
 /**
@@ -23,7 +24,6 @@ export declare class LambdaStep<TIn, TOut> extends UnbatchedExecutableStep<TOut>
  * callback. Note: if you need to pass more than one value, pass a `ListStep`
  * as the `$plan` argument.
  */
-declare function lambda<const TIn extends readonly ExecutableStep[], TOut>(plans: TIn, fn: (value: UnwrapPlanTuple<TIn>) => PromiseOrDirect<TOut>, isSyncAndSafe?: boolean): LambdaStep<UnwrapPlanTuple<TIn>, TOut>;
-declare function lambda<const TIn, TOut>($plan: ExecutableStep<TIn> | null | undefined, fn: (value: TIn) => PromiseOrDirect<TOut>, isSyncAndSafe?: boolean): LambdaStep<TIn, TOut>;
+declare function lambda<const TInMultistep extends Multistep, TOut>(spec: TInMultistep, fn: (value: UnwrapMultistep<TInMultistep>) => PromiseOrDirect<TOut>, isSyncAndSafe?: boolean): LambdaStep<UnwrapMultistep<TInMultistep>, TOut>;
 export { lambda };
 //# sourceMappingURL=lambda.d.ts.map

package/dist/steps/lambda.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.lambda = exports.LambdaStep = void 0;
+const multistep_js_1 = require("../multistep.js");
 const step_js_1 = require("../step.js");
-const list_js_1 = require("./list.js");
 const sideEffect_js_1 = require("./sideEffect.js");
 /**
  * Calls the given lambda function for each tuple
@@ -40,16 +40,20 @@ class LambdaStep extends step_js_1.UnbatchedExecutableStep {
     }
 }
 exports.LambdaStep = LambdaStep;
-function lambda(planOrPlans, fn, isSyncAndSafe = false) {
+/**
+ * A plan that takes the input `$plan` and feeds each value through the `fn`
+ * callback. Note: if you need to pass more than one value, pass a `ListStep`
+ * as the `$plan` argument.
+ */
+function lambda(spec, fn, isSyncAndSafe = false) {
     if (fn.length > 1) {
         throw new Error("lambda callback should accept one argument, perhaps you forgot to destructure the arguments?");
     }
-    const $lambda = Array.isArray(planOrPlans)
-        ? new LambdaStep((0, list_js_1.list)(planOrPlans), fn)
-        : new LambdaStep(planOrPlans, fn);
+    const $in = (0, multistep_js_1.multistep)(spec);
+    const $lambda = new LambdaStep($in, fn);
     if (fn.hasSideEffects) {
         console.trace(`You passed a function with \`hasSideEffects = true\` to \`lambda()\`, you should use \`sideEffect()\` instead (it has the same signature). We've automatically corrected this, but you should fix it in your code so the types are correct.`);
-        return (0, sideEffect_js_1.sideEffect)(planOrPlans, fn);
+        return (0, sideEffect_js_1.sideEffect)(spec, fn);
     }
     if (isSyncAndSafe) {
         if (fn.constructor.name === "AsyncFunction") {

package/dist/steps/list.d.ts

@@ -2,6 +2,10 @@ import type { ExecutionDetails, StepOptimizeOptions, UnbatchedExecutionExtra, Un
 import type { ExecutableStep } from "../step.js";
 import { UnbatchedExecutableStep } from "../step.js";
 import { ConstantStep } from "./constant.js";
+interface ListStepCacheConfig {
+    identifier?: string;
+    cacheSize?: number;
+}
 export declare class ListStep<const TPlanTuple extends readonly ExecutableStep[]> extends UnbatchedExecutableStep<UnwrapPlanTuple<TPlanTuple>> {
     static $$export: {
         moduleName: string;
@@ -10,12 +14,16 @@ export declare class ListStep<const TPlanTuple extends readonly ExecutableStep[]
     isSyncAndSafe: boolean;
     allowMultipleOptimizations: boolean;
     optimizeMetaKey: string;
-    constructor(list: TPlanTuple);
+    private cacheSize;
+    private valueCount;
+    constructor(list: TPlanTuple, cacheConfig?: ListStepCacheConfig);
     toStringMeta(): string;
     execute({ indexMap, values }: ExecutionDetails): readonly UnwrapPlanTuple<TPlanTuple>[];
     unbatchedExecute(_extra: UnbatchedExecutionExtra, ...values: any[]): UnwrapPlanTuple<TPlanTuple>;
+    deduplicatedUnbatchedExecute({ meta: inMeta }: UnbatchedExecutionExtra, ...values: any[]): UnwrapPlanTuple<TPlanTuple>;
     deduplicate(peers: ListStep<TPlanTuple>[]): ListStep<TPlanTuple>[];
     optimize(opts: StepOptimizeOptions): this | ConstantStep<any[]>;
+    finalize(): void;
     /**
      * Get the original plan at the given index back again.
      */
@@ -27,5 +35,6 @@ export declare class ListStep<const TPlanTuple extends readonly ExecutableStep[]
  * Takes a list of plans and turns it into a single plan that represents the
  * list of their values.
  */
-export declare function list<const TPlanTuple extends readonly ExecutableStep[]>(list: TPlanTuple): ListStep<TPlanTuple>;
+export declare function list<const TPlanTuple extends readonly ExecutableStep[]>(list: TPlanTuple, cacheConfig?: ListStepCacheConfig): ListStep<TPlanTuple>;
+export {};
 //# sourceMappingURL=list.d.ts.map

package/dist/steps/list.js

@@ -3,16 +3,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.list = exports.ListStep = void 0;
 const step_js_1 = require("../step.js");
 const constant_js_1 = require("./constant.js");
+const DEFAULT_CACHE_SIZE = 100;
 class ListStep extends step_js_1.UnbatchedExecutableStep {
     static { this.$$export = {
         moduleName: "grafast",
         exportName: "ListStep",
     }; }
-    constructor(list) {
+    constructor(list, cacheConfig) {
         super();
         this.isSyncAndSafe = true;
         this.allowMultipleOptimizations = true;
         this.optimizeMetaKey = "ListStep";
+        this.valueCount = list.length;
+        this.cacheSize =
+            cacheConfig?.cacheSize ??
+                (cacheConfig?.identifier ? DEFAULT_CACHE_SIZE : 0);
+        this.metaKey =
+            this.cacheSize <= 0
+                ? undefined
+                : cacheConfig?.identifier
+                    ? `list|${list.length}|${cacheConfig.identifier}`
+                    : this.id;
         for (let i = 0, l = list.length; i < l; i++) {
             this.addDependency({ step: list[i], skipDeduplication: true });
         }
@@ -27,6 +38,30 @@ class ListStep extends step_js_1.UnbatchedExecutableStep {
     ) {
         return values;
     }
+    deduplicatedUnbatchedExecute({ meta: inMeta }, ...values //UnwrapPlanTuple<TPlanTuple>,
+    ) {
+        const meta = inMeta;
+        if (meta.nextIndex !== undefined) {
+            outer: for (let i = 0, l = meta.results.length; i < l; i++) {
+                const cachedValues = meta.results[i];
+                for (let j = 0, c = this.valueCount; j < c; j++) {
+                    if (values[j] !== cachedValues[j]) {
+                        continue outer;
+                    }
+                }
+                return cachedValues;
+            }
+        }
+        else {
+            meta.nextIndex = 0;
+            meta.results = [];
+        }
+        meta.results[meta.nextIndex] = values;
+        // Only cache this.cacheSize results, use a round-robin
+        const maxIndex = this.cacheSize - 1;
+        meta.nextIndex = meta.nextIndex === maxIndex ? 0 : meta.nextIndex + 1;
+        return values;
+    }
     deduplicate(peers) {
         return peers;
     }
@@ -52,6 +87,12 @@ class ListStep extends step_js_1.UnbatchedExecutableStep {
         }
         return this;
     }
+    finalize() {
+        if (this.cacheSize > 0) {
+            this.unbatchedExecute = this.deduplicatedUnbatchedExecute;
+        }
+        super.finalize();
+    }
     /**
      * Get the original plan at the given index back again.
      */
@@ -70,8 +111,8 @@ exports.ListStep = ListStep;
  * Takes a list of plans and turns it into a single plan that represents the
  * list of their values.
  */
-function list(list) {
-    return new ListStep(list);
+function list(list, cacheConfig) {
+    return new ListStep(list, cacheConfig);
 }
 exports.list = list;
 //# sourceMappingURL=list.js.map

package/dist/steps/load.d.ts

@@ -1,5 +1,6 @@
 import type { __ItemStep, ExecutionDetails } from "../index.js";
 import type { GrafastResultsList, Maybe, PromiseOrDirect } from "../interfaces.js";
+import type { Multistep, UnwrapMultistep } from "../multistep.js";
 import { ExecutableStep } from "../step.js";
 export interface LoadOptions<TItem, TParams extends Record<string, any>, TUnarySpec = never> {
     unary: TUnarySpec;
@@ -25,7 +26,7 @@ export declare function loadManyCallback<TSpec, TItem, TParams extends Record<st
 /**
  * You shouldn't create instances of this yourself - use `loadOne` or `loadMany` instead.
  */
-export declare class LoadedRecordStep<TItem, TParams extends Record<string, any>> extends ExecutableStep<TItem> {
+export declare class LoadedRecordStep<TItem, TParams extends Record<string, any> = Record<string, any>> extends ExecutableStep<TItem> {
     private isSingle;
     private sourceDescription;
     private ioEquivalence;
@@ -43,7 +44,7 @@ export declare class LoadedRecordStep<TItem, TParams extends Record<string, any>
     optimize(): ExecutableStep<any>;
     execute({ count, values: [values0], }: ExecutionDetails<[TItem]>): GrafastResultsList<TItem>;
 }
-export declare class LoadStep<TSpec, TItem, TData extends TItem | ReadonlyArray<TItem>, TParams extends Record<string, any>, TUnarySpec = never> extends ExecutableStep {
+export declare class LoadStep<const TMultistep extends Multistep, TItem, TData extends TItem | ReadonlyArray<TItem>, TParams extends Record<string, any>, const TUnaryMultistep extends Multistep = never> extends ExecutableStep {
     private ioEquivalence;
     private load;
     static $$export: {
@@ -51,14 +52,12 @@ export declare class LoadStep<TSpec, TItem, TData extends TItem | ReadonlyArray<
         exportName: string;
     };
     isSyncAndSafe: boolean;
-    loadOptions: Omit<LoadOptions<TItem, TParams, TUnarySpec>, "unary"> | null;
+    loadOptions: Omit<LoadOptions<TItem, TParams, UnwrapMultistep<TUnaryMultistep>>, "unary"> | null;
     loadOptionsKey: string;
     attributes: Set<keyof TItem>;
     params: Partial<TParams>;
     unaryDepId: number | null;
-    constructor($spec: ExecutableStep<TSpec>, $unarySpec: ExecutableStep<TUnarySpec> | null, ioEquivalence: null | string | {
-        [key in keyof TSpec]?: string | null;
-    }, load: LoadCallback<TSpec, TItem, TData, TParams, TUnarySpec>);
+    constructor(spec: TMultistep, unarySpec: TUnaryMultistep | null, ioEquivalence: IOEquivalence<TMultistep>, load: LoadCallback<UnwrapMultistep<TMultistep>, TItem, TData, TParams, UnwrapMultistep<TUnaryMultistep>>);
     toStringMeta(): string;
     private makeAccessMap;
     listItem($item: __ItemStep<TItem>): LoadedRecordStep<TItem, TParams>;
@@ -66,27 +65,23 @@ export declare class LoadStep<TSpec, TItem, TData extends TItem | ReadonlyArray<
     setParam<TParamKey extends keyof TParams>(paramKey: TParamKey, value: TParams[TParamKey]): void;
     addAttributes(attributes: Set<keyof TItem>): void;
     finalize(): void;
-    execute({ count, values: [values0, values1], extra, }: ExecutionDetails<[TSpec, TUnarySpec]>): PromiseOrDirect<GrafastResultsList<Maybe<TData>>>;
+    execute({ count, values: [values0, values1], extra, }: ExecutionDetails<[
+        UnwrapMultistep<TMultistep>,
+        UnwrapMultistep<TUnaryMultistep>
+    ]>): PromiseOrDirect<GrafastResultsList<Maybe<TData>>>;
 }
-export declare function loadMany<TSpec, TItem, TParams extends Record<string, any> = Record<string, any>, TUnarySpec = never>($spec: ExecutableStep<TSpec>, loadCallback: LoadManyCallback<TSpec, TItem, TParams, TUnarySpec>): LoadStep<TSpec, TItem, ReadonlyArray<TItem>, TParams, TUnarySpec>;
-export declare function loadMany<TSpec, TItem, TParams extends Record<string, any> = Record<string, any>, TUnarySpec = never>($spec: ExecutableStep<TSpec>, ioEquivalence: null | string | (TSpec extends [...any[]] ? {
-    [key in keyof TSpec]: string | null;
-} : TSpec extends Record<string, any> ? {
-    [key in keyof TSpec]?: string | null;
-} : never), loadCallback: LoadManyCallback<TSpec, TItem, TParams, TUnarySpec>): LoadStep<TSpec, TItem, ReadonlyArray<TItem>, TParams, TUnarySpec>;
-export declare function loadMany<TSpec, TItem, TParams extends Record<string, any> = Record<string, any>, TUnarySpec = never>($spec: ExecutableStep<TSpec>, $unarySpec: ExecutableStep<TUnarySpec> | null, loadCallback: LoadManyCallback<TSpec, TItem, TParams, TUnarySpec>): LoadStep<TSpec, TItem, ReadonlyArray<TItem>, TParams, TUnarySpec>;
-export declare function loadMany<TSpec, TItem, TParams extends Record<string, any> = Record<string, any>, TUnarySpec = never>($spec: ExecutableStep<TSpec>, $unarySpec: ExecutableStep<TUnarySpec> | null, ioEquivalence: null | string | (TSpec extends [...any[]] ? {
-    [key in keyof TSpec]: string | null;
-} : TSpec extends Record<string, any> ? {
-    [key in keyof TSpec]?: string | null;
-} : never), loadCallback: LoadManyCallback<TSpec, TItem, TParams, TUnarySpec>): LoadStep<TSpec, TItem, ReadonlyArray<TItem>, TParams, TUnarySpec>;
-export declare function loadOne<const TSpec, TItem, TParams extends Record<string, any> = Record<string, any>, TUnarySpec = never>($spec: ExecutableStep<TSpec>, loadCallback: LoadOneCallback<TSpec, TItem, TParams, TUnarySpec>): LoadedRecordStep<TItem, TParams>;
-export declare function loadOne<const TSpec, TItem, TParams extends Record<string, any> = Record<string, any>, TUnarySpec = never>($spec: ExecutableStep<TSpec>, ioEquivalence: null | string | {
-    [key in keyof TSpec]?: string | null;
-}, loadCallback: LoadOneCallback<TSpec, TItem, TParams, TUnarySpec>): LoadedRecordStep<TItem, TParams>;
-export declare function loadOne<const TSpec, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnarySpec = never>($spec: ExecutableStep<TSpec>, $unarySpec: ExecutableStep<TUnarySpec> | null, loadCallback: LoadOneCallback<TSpec, TItem, TParams, TUnarySpec>): LoadedRecordStep<TItem, TParams>;
-export declare function loadOne<const TSpec, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnarySpec = never>($spec: ExecutableStep<TSpec>, $unarySpec: ExecutableStep<TUnarySpec> | null, ioEquivalence: null | string | {
-    [key in keyof TSpec]?: string | null;
-}, loadCallback: LoadOneCallback<TSpec, TItem, TParams, TUnarySpec>): LoadedRecordStep<TItem, TParams>;
+export declare function loadMany<const TMultistep extends Multistep, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnaryMultistep extends Multistep = never>(spec: TMultistep, loadCallback: LoadManyCallback<UnwrapMultistep<TMultistep>, TItem, TParams, UnwrapMultistep<TUnaryMultistep>>): LoadStep<UnwrapMultistep<TMultistep>, TItem, ReadonlyArray<TItem>, TParams, UnwrapMultistep<TUnaryMultistep>>;
+export declare function loadMany<const TMultistep extends Multistep, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnaryMultistep extends Multistep = never>(spec: TMultistep, ioEquivalence: IOEquivalence<TMultistep>, loadCallback: LoadManyCallback<UnwrapMultistep<TMultistep>, TItem, TParams, UnwrapMultistep<TUnaryMultistep>>): LoadStep<UnwrapMultistep<TMultistep>, TItem, ReadonlyArray<TItem>, TParams, UnwrapMultistep<TUnaryMultistep>>;
+export declare function loadMany<const TMultistep extends Multistep, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnaryMultistep extends Multistep = never>(spec: TMultistep, unarySpec: TUnaryMultistep | null, loadCallback: LoadManyCallback<UnwrapMultistep<TMultistep>, TItem, TParams, UnwrapMultistep<TUnaryMultistep>>): LoadStep<UnwrapMultistep<TMultistep>, TItem, ReadonlyArray<TItem>, TParams, UnwrapMultistep<TUnaryMultistep>>;
+export declare function loadMany<const TMultistep extends Multistep, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnaryMultistep extends Multistep = never>(spec: TMultistep, unarySpec: TUnaryMultistep | null, ioEquivalence: IOEquivalence<TMultistep>, loadCallback: LoadManyCallback<UnwrapMultistep<TMultistep>, TItem, TParams, UnwrapMultistep<TUnaryMultistep>>): LoadStep<UnwrapMultistep<TMultistep>, TItem, ReadonlyArray<TItem>, TParams, UnwrapMultistep<TUnaryMultistep>>;
+type IOEquivalence<TMultistep extends Multistep> = null | string | (UnwrapMultistep<TMultistep> extends readonly [...(readonly any[])] ? {
+    [key in Exclude<keyof UnwrapMultistep<TMultistep>, keyof any[]>]: string | null;
+} : UnwrapMultistep<TMultistep> extends Record<string, any> ? {
+    [key in keyof UnwrapMultistep<TMultistep>]?: string | null;
+} : never);
+export declare function loadOne<const TMultistep extends Multistep, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnaryMultistep extends Multistep = never>(spec: TMultistep, loadCallback: LoadOneCallback<UnwrapMultistep<TMultistep>, TItem, TParams, UnwrapMultistep<TUnaryMultistep>>): LoadedRecordStep<TItem, TParams>;
+export declare function loadOne<const TMultistep extends Multistep, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnaryMultistep extends Multistep = never>(spec: TMultistep, ioEquivalence: IOEquivalence<TMultistep>, loadCallback: LoadOneCallback<UnwrapMultistep<TMultistep>, TItem, TParams, UnwrapMultistep<TUnaryMultistep>>): LoadedRecordStep<TItem, TParams>;
+export declare function loadOne<const TMultistep extends Multistep, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnaryMultistep extends Multistep = never>(spec: TMultistep, unarySpec: TUnaryMultistep | null, loadCallback: LoadOneCallback<UnwrapMultistep<TMultistep>, TItem, TParams, UnwrapMultistep<TUnaryMultistep>>): LoadedRecordStep<TItem, TParams>;
+export declare function loadOne<const TMultistep extends Multistep, TItem, TParams extends Record<string, any> = Record<string, any>, const TUnaryMultistep extends Multistep = never>(spec: TMultistep, unarySpec: TUnaryMultistep | null, ioEquivalence: IOEquivalence<TMultistep>, loadCallback: LoadOneCallback<UnwrapMultistep<TMultistep>, TItem, TParams, UnwrapMultistep<TUnaryMultistep>>): LoadedRecordStep<TItem, TParams>;
 export {};
 //# sourceMappingURL=load.d.ts.map

package/dist/steps/load.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadOne = exports.loadMany = exports.LoadStep = exports.LoadedRecordStep = exports.loadManyCallback = exports.loadOneCallback = void 0;
 const index_js_1 = require("../index.js");
+const multistep_js_1 = require("../multistep.js");
 const step_js_1 = require("../step.js");
 const utils_js_1 = require("../utils.js");
 const access_js_1 = require("./access.js");
@@ -89,7 +90,7 @@ exports.LoadedRecordStep = LoadedRecordStep;
 class LoadStep extends step_js_1.ExecutableStep {
     /* implements ListCapableStep<TItem, LoadedRecordStep<TItem, TParams>> */
     static { this.$$export = { moduleName: "grafast", exportName: "LoadStep" }; }
-    constructor($spec, $unarySpec, ioEquivalence, load) {
+    constructor(spec, unarySpec, ioEquivalence, load) {
         super();
         this.ioEquivalence = ioEquivalence;
         this.load = load;
@@ -99,7 +100,9 @@ class LoadStep extends step_js_1.ExecutableStep {
         this.attributes = new Set();
         this.params = Object.create(null);
         this.unaryDepId = null;
+        const $spec = (0, multistep_js_1.multistep)(spec, "load");
         this.addDependency($spec);
+        const $unarySpec = unarySpec == null ? null : (0, multistep_js_1.multistep)(unarySpec, "loadUnary");
         if ($unarySpec) {
             this.unaryDepId = this.addUnaryDependency($unarySpec);
         }
@@ -117,7 +120,7 @@ class LoadStep extends step_js_1.ExecutableStep {
             map[this.ioEquivalence] = $spec;
             return map;
         }
-        else if (Array.isArray(this.ioEquivalence)) {
+        else if ((0, utils_js_1.isTuple)(this.ioEquivalence)) {
             for (let i = 0, l = this.ioEquivalence.length; i < l; i++) {
                 const key = this.ioEquivalence[i];
                 map[key] = (0, step_js_1.isListLikeStep)($spec) ? $spec.at(i) : (0, access_js_1.access)($spec, [i]);
@@ -296,41 +299,41 @@ async function executeBatches(loadBatches, load, loadOptions) {
         }
     }
 }
-function load($spec, $unarySpec, ioEquivalence, loadCallback) {
-    return new LoadStep($spec, $unarySpec, ioEquivalence, loadCallback);
+function load(spec, unarySpec, ioEquivalence, loadCallback) {
+    return new LoadStep(spec, unarySpec, ioEquivalence, loadCallback);
 }
-function loadMany($spec, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence, loadCallbackOnly) {
+function loadMany(spec, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence, loadCallbackOnly) {
     if (loadCallbackOnly) {
-        return load($spec, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence, loadCallbackOnly);
+        return load(spec, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence, loadCallbackOnly);
     }
     // At most 3 arguments
-    else if ((0, index_js_1.isExecutableStep)(loadCallbackOrIoEquivalenceOrUnarySpec)) {
-        return load($spec, loadCallbackOrIoEquivalenceOrUnarySpec, null, loadCallbackOrIoEquivalence);
+    else if ((0, multistep_js_1.isMultistep)(loadCallbackOrIoEquivalenceOrUnarySpec)) {
+        return load(spec, loadCallbackOrIoEquivalenceOrUnarySpec, null, loadCallbackOrIoEquivalence);
     }
     // Unary step is definitely null; 3 arguments
     else if (loadCallbackOrIoEquivalence) {
-        return load($spec, null, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence);
+        return load(spec, null, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence);
     }
     // 2 arguments
     else {
-        return load($spec, null, null, loadCallbackOrIoEquivalenceOrUnarySpec);
+        return load(spec, null, null, loadCallbackOrIoEquivalenceOrUnarySpec);
     }
 }
 exports.loadMany = loadMany;
-function loadOne($spec, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence, loadCallbackOnly) {
+function loadOne(spec, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence, loadCallbackOnly) {
     if (loadCallbackOnly) {
-        return load($spec, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence, loadCallbackOnly).single();
+        return load(spec, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence, loadCallbackOnly).single();
     }
     // At most 3 arguments
-    else if ((0, index_js_1.isExecutableStep)(loadCallbackOrIoEquivalenceOrUnarySpec)) {
-        return load($spec, loadCallbackOrIoEquivalenceOrUnarySpec, null, loadCallbackOrIoEquivalence).single();
+    else if ((0, multistep_js_1.isMultistep)(loadCallbackOrIoEquivalenceOrUnarySpec)) {
+        return load(spec, loadCallbackOrIoEquivalenceOrUnarySpec, null, loadCallbackOrIoEquivalence).single();
     }
     // Unary step is definitely null; 3 arguments
     else if (loadCallbackOrIoEquivalence) {
-        return load($spec, null, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence).single();
+        return load(spec, null, loadCallbackOrIoEquivalenceOrUnarySpec, loadCallbackOrIoEquivalence).single();
     }
     else {
-        return load($spec, null, null, loadCallbackOrIoEquivalenceOrUnarySpec).single();
+        return load(spec, null, null, loadCallbackOrIoEquivalenceOrUnarySpec).single();
     }
 }
 exports.loadOne = loadOne;

package/dist/steps/object.d.ts

@@ -19,6 +19,10 @@ export interface ObjectPlanMeta<TSteps extends {
 }> {
     results: Results<TSteps>;
 }
+interface ObjectStepCacheConfig {
+    identifier?: string;
+    cacheSize?: number;
+}
 /**
  * A plan that represents an object using the keys given and the values being
  * the results of the associated plans.
@@ -36,7 +40,8 @@ export declare class ObjectStep<TPlans extends {
     allowMultipleOptimizations: boolean;
     private keys;
     optimizeMetaKey: string;
-    constructor(obj: TPlans);
+    private cacheSize;
+    constructor(obj: TPlans, cacheConfig?: ObjectStepCacheConfig);
     /**
      * This key doesn't get typed, but it can be added later which can be quite
      * handy.
@@ -61,6 +66,6 @@ export declare class ObjectStep<TPlans extends {
  */
 export declare function object<TPlans extends {
     [key: string]: ExecutableStep;
-}>(obj: TPlans): ObjectStep<TPlans>;
+}>(obj: TPlans, cacheConfig?: ObjectStepCacheConfig): ObjectStep<TPlans>;
 export {};
 //# sourceMappingURL=object.d.ts.map

package/dist/steps/object.js

@@ -6,6 +6,7 @@ const tslib_1 = require("tslib");
 const tamedevil_1 = tslib_1.__importStar(require("tamedevil"));
 const step_js_1 = require("../step.js");
 const constant_js_1 = require("./constant.js");
+const DEFAULT_CACHE_SIZE = 100;
 const EMPTY_OBJECT = Object.freeze(Object.create(null));
 /**
  * A plan that represents an object using the keys given and the values being
@@ -16,13 +17,21 @@ class ObjectStep extends step_js_1.UnbatchedExecutableStep {
         moduleName: "grafast",
         exportName: "ObjectStep",
     }; }
-    constructor(obj) {
+    constructor(obj, cacheConfig) {
         super();
         this.isSyncAndSafe = true;
         this.allowMultipleOptimizations = true;
         // Optimize needs the same 'meta' for all ObjectSteps
         this.optimizeMetaKey = "ObjectStep";
-        this.metaKey = this.id;
+        this.cacheSize =
+            cacheConfig?.cacheSize ??
+                (cacheConfig?.identifier ? DEFAULT_CACHE_SIZE : 0);
+        this.metaKey =
+            this.cacheSize <= 0
+                ? undefined
+                : cacheConfig?.identifier
+                    ? `object|${JSON.stringify(Object.keys(obj))}|${cacheConfig.identifier}`
+                    : this.id;
         this.keys = Object.keys(obj);
         for (let i = 0, l = this.keys.length; i < l; i++) {
             this.addDependency({ step: obj[this.keys[i]], skipDeduplication: true });
@@ -102,9 +111,11 @@ ${tamedevil_1.default.join(this.keys.map((key, i) => (0, tamedevil_1.default) `
   const newObj = Object.create(null);
 ${tamedevil_1.default.join(this.keys.map((key, i) => (0, tamedevil_1.default) `  newObj${tamedevil_1.default.set(key, true)} = ${tamedevil_1.default.identifier(`val${i}`)};\n`), "")}\
 `;
-        return tamedevil_1.default.runInBatch((0, tamedevil_1.default) `\
-(function ({ meta }, ${tamedevil_1.default.join(this.keys.map((_k, i) => tamedevil_1.default.identifier(`val${i}`)), ", ")}) {
-  if (meta.nextIndex) {
+        const vals = tamedevil_1.default.join(this.keys.map((_k, i) => tamedevil_1.default.identifier(`val${i}`)), ", ");
+        if (this.cacheSize > 0) {
+            return tamedevil_1.default.runInBatch((0, tamedevil_1.default) `\
+(function ({ meta }, ${vals}) {
+  if (meta.nextIndex != null) {
     for (let i = 0, l = meta.results.length; i < l; i++) {
       const [values, obj] = meta.results[i];
       if (${tamedevil_1.default.join(this.keys.map((_key, i) => (0, tamedevil_1.default) `values[${tamedevil_1.default.lit(i)}] === ${tamedevil_1.default.identifier(`val${i}`)}`), " && ")}) {
@@ -113,16 +124,22 @@ ${tamedevil_1.default.join(this.keys.map((key, i) => (0, tamedevil_1.default) `
     }
   } else {
     meta.nextIndex = 0;
-    if (!meta.results) {
-      meta.results = [];
-    }
+    meta.results = [];
   }
 ${inner}
   meta.results[meta.nextIndex] = [[${tamedevil_1.default.join(this.keys.map((_key, i) => tamedevil_1.default.identifier(`val${i}`)), ",")}], newObj];
-  // Only cache 10 results, use a round-robin
-  meta.nextIndex = meta.nextIndex === 9 ? 0 : meta.nextIndex + 1;
+  // Only cache ${tamedevil_1.default.lit(this.cacheSize)} results, use a round-robin
+  meta.nextIndex = meta.nextIndex === ${tamedevil_1.default.lit(this.cacheSize - 1)} ? 0 : meta.nextIndex + 1;
+  return newObj;
+})`, callback);
+        }
+        else {
+            return tamedevil_1.default.runInBatch((0, tamedevil_1.default) `\
+(function (_, ${vals}) {
+${inner}
   return newObj;
 })`, callback);
+        }
     }
     finalize() {
         this.tupleToObjectJIT((fn) => {
@@ -184,8 +201,8 @@ exports.ObjectStep = ObjectStep;
  * A plan that represents an object using the keys given and the values being
  * the results of the associated plans.
  */
-function object(obj) {
-    return new ObjectStep(obj);
+function object(obj, cacheConfig) {
+    return new ObjectStep(obj, cacheConfig);
 }
 exports.object = object;
 //# sourceMappingURL=object.js.map

package/dist/steps/sideEffect.d.ts

@@ -1,4 +1,5 @@
-import type { PromiseOrDirect, UnbatchedExecutionExtra, UnwrapPlanTuple } from "../interfaces.js";
+import type { PromiseOrDirect, UnbatchedExecutionExtra } from "../interfaces.js";
+import type { Multistep, UnwrapMultistep } from "../multistep.js";
 import type { ExecutableStep } from "../step.js";
 import { UnbatchedExecutableStep } from "../step.js";
 /**
@@ -22,7 +23,6 @@ export declare class SideEffectStep<TIn, TOut> extends UnbatchedExecutableStep<T
  * callback. Note: if you need to pass more than one value, pass a `ListStep`
  * as the `$plan` argument.
  */
-declare function sideEffect<const TIn extends readonly ExecutableStep[], TOut>(plans: TIn, fn: (value: UnwrapPlanTuple<TIn>) => PromiseOrDirect<TOut>): SideEffectStep<UnwrapPlanTuple<TIn>, TOut>;
-declare function sideEffect<const TIn, TOut>($plan: ExecutableStep<TIn> | null | undefined, fn: (value: TIn) => PromiseOrDirect<TOut>): SideEffectStep<TIn, TOut>;
+declare function sideEffect<const TInMultistep extends Multistep, TOut>(spec: TInMultistep, fn: (value: UnwrapMultistep<TInMultistep>) => PromiseOrDirect<TOut>): SideEffectStep<UnwrapMultistep<TInMultistep>, TOut>;
 export { sideEffect };
 //# sourceMappingURL=sideEffect.d.ts.map

package/dist/steps/sideEffect.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sideEffect = exports.SideEffectStep = void 0;
+const multistep_js_1 = require("../multistep.js");
 const step_js_1 = require("../step.js");
-const list_js_1 = require("./list.js");
 /**
  * Calls the given callback function for each tuple
  */
@@ -27,13 +27,17 @@ class SideEffectStep extends step_js_1.UnbatchedExecutableStep {
     }
 }
 exports.SideEffectStep = SideEffectStep;
-function sideEffect(planOrPlans, fn) {
+/**
+ * A plan that takes the input `$plan` and feeds each value through the `fn`
+ * callback. Note: if you need to pass more than one value, pass a `ListStep`
+ * as the `$plan` argument.
+ */
+function sideEffect(spec, fn) {
     if (fn.length > 1) {
         throw new Error("sideEffect callback should accept one argument, perhaps you forgot to destructure the arguments?");
     }
-    const $result = Array.isArray(planOrPlans)
-        ? new SideEffectStep((0, list_js_1.list)(planOrPlans), fn)
-        : new SideEffectStep(planOrPlans, fn);
+    const $in = (0, multistep_js_1.multistep)(spec);
+    const $result = new SideEffectStep($in, fn);
     return $result;
 }
 exports.sideEffect = sideEffect;

package/dist/utils.d.ts

@@ -143,11 +143,13 @@ export declare function stepAMayDependOnStepB($a: ExecutableStep, $b: Executable
 export declare function stepsAreInSamePhase(ancestor: ExecutableStep, descendent: ExecutableStep): boolean;
 export declare const canonicalJSONStringify: (o: object) => string;
 export declare function assertNotAsync(fn: any, name: string): void;
+export declare function assertNotPromise<TVal>(value: TVal, fn: any, name: string): TVal;
 export declare function hasItemPlan(step: ExecutableStep & {
     itemPlan?: ($item: ExecutableStep) => ExecutableStep;
 }): step is ExecutableStep & {
     itemPlan: ($item: ExecutableStep) => ExecutableStep;
 };
 export declare function exportNameHint(obj: any, nameHint: string): void;
+export declare function isTuple<T extends readonly [...(readonly any[])]>(t: any | T): t is T;
 export {};
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.exportNameHint = exports.hasItemPlan = exports.assertNotAsync = exports.canonicalJSONStringify = exports.stepsAreInSamePhase = exports.stepAMayDependOnStepB = exports.stepADependsOnStepB = exports.writeableArray = exports.sudo = exports.isTypePlanned = exports.findVariableNamesUsed = exports.arrayOfLengthCb = exports.arrayOfLength = exports.stack = exports.sharedNull = exports.getEnumValueConfig = exports.inputObjectFieldSpec = exports.newInputObjectTypeBuilder = exports.newGrafastFieldConfigBuilder = exports.objectFieldSpec = exports.newObjectTypeBuilder = exports.objectSpec = exports.arraysMatch = exports.isDeferred = exports.isPromiseLike = exports.isPromise = exports.defaultValueToValueNode = exports.assertNullPrototype = exports.ROOT_VALUE_OBJECT = void 0;
+exports.isTuple = exports.exportNameHint = exports.hasItemPlan = exports.assertNotPromise = exports.assertNotAsync = exports.canonicalJSONStringify = exports.stepsAreInSamePhase = exports.stepAMayDependOnStepB = exports.stepADependsOnStepB = exports.writeableArray = exports.sudo = exports.isTypePlanned = exports.findVariableNamesUsed = exports.arrayOfLengthCb = exports.arrayOfLength = exports.stack = exports.sharedNull = exports.getEnumValueConfig = exports.inputObjectFieldSpec = exports.newInputObjectTypeBuilder = exports.newGrafastFieldConfigBuilder = exports.objectFieldSpec = exports.newObjectTypeBuilder = exports.objectSpec = exports.arraysMatch = exports.isDeferred = exports.isPromiseLike = exports.isPromise = exports.defaultValueToValueNode = exports.assertNullPrototype = exports.ROOT_VALUE_OBJECT = void 0;
 const tslib_1 = require("tslib");
 const graphql = tslib_1.__importStar(require("graphql"));
 const assert = tslib_1.__importStar(require("./assert.js"));
@@ -719,12 +719,21 @@ exports.stepsAreInSamePhase = stepsAreInSamePhase;
 // ENHANCE: implement this!
 const canonicalJSONStringify = (o) => JSON.stringify(o);
 exports.canonicalJSONStringify = canonicalJSONStringify;
+// PERF: only do this if isDev; otherwise replace with NOOP?
 function assertNotAsync(fn, name) {
     if (fn?.constructor?.name === "AsyncFunction") {
         throw new Error(`Plans must be synchronous, but this schema has an async function at '${name}': ${fn.toString()}`);
     }
 }
 exports.assertNotAsync = assertNotAsync;
+// PERF: only do this if isDev; otherwise replace with NOOP?
+function assertNotPromise(value, fn, name) {
+    if (isPromiseLike(value)) {
+        throw new Error(`Plans must be synchronous, but this schema has an function at '${name}' that returned a promise-like object: ${fn.toString()}`);
+    }
+    return value;
+}
+exports.assertNotPromise = assertNotPromise;
 function hasItemPlan(step) {
     return "itemPlan" in step && typeof step.itemPlan === "function";
 }
@@ -743,4 +752,8 @@ function exportNameHint(obj, nameHint) {
     }
 }
 exports.exportNameHint = exportNameHint;
+function isTuple(t) {
+    return Array.isArray(t);
+}
+exports.isTuple = isTuple;
 //# sourceMappingURL=utils.js.map

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "0.1.1-beta.13";
+export declare const version = "0.1.1-beta.15";
 //# 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.13";
+exports.version = "0.1.1-beta.15";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grafast",
-  "version": "0.1.1-beta.13",
+  "version": "0.1.1-beta.15",
   "description": "Cutting edge GraphQL planning and execution engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -59,6 +59,7 @@
     "chalk": "^4.1.2",
     "debug": "^4.3.4",
     "eventemitter3": "^5.0.1",
+    "graphile-config": "^0.0.1-beta.10",
     "graphql": "^16.1.0-experimental-stream-defer.6",
     "iterall": "^1.3.0",
     "tamedevil": "^0.0.0-beta.7",
@@ -66,16 +67,12 @@
   },
   "peerDependencies": {
     "@envelop/core": "^5.0.0",
-    "graphile-config": "^0.0.1-beta.9",
     "graphql": "^16.1.0-experimental-stream-defer.6",
     "tamedevil": "^0.0.0-beta.7"
   },
   "peerDependenciesMeta": {
     "@envelop/core": {
       "optional": true
-    },
-    "graphile-config": {
-      "optional": true
     }
   },
   "files": [