grafast 0.1.1-beta.2 → 0.1.1-beta.21

package/dist/steps/index.js

@@ -1,17 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.applyTransforms = exports.__ValueStep = exports.__TrackedValueStep = exports.__ItemStep = exports.__InputStaticLeafStep = exports.__InputObjectStep = exports.__InputListStep = exports.SetterStep = exports.setter = exports.ReverseStep = exports.reverseArray = exports.reverse = exports.RemapKeysStep = exports.remapKeys = exports.partitionByIndex = exports.ObjectStep = exports.object = exports.specFromNodeId = exports.NodeStep = exports.node = exports.makeDecodeNodeId = exports.listTransform = exports.__ListTransformStep = exports.ListenStep = exports.listen = exports.ListStep = exports.list = exports.LastStep = exports.last = exports.LambdaStep = exports.lambda = exports.groupBy = exports.FirstStep = exports.first = exports.filter = exports.ErrorStep = exports.error = exports.each = exports.ConstantStep = exports.constant = exports.EdgeStep = exports.ConnectionStep = exports.connection = exports.assertPageInfoCapableStep = exports.assertEdgeCapableStep = exports.AccessStep = exports.access = exports.debugPlans = exports.context = exports.operationPlan = void 0;
-exports.ProxyStep = exports.proxy = exports.LoadStep = exports.loadOneCallback = exports.loadOne = exports.loadManyCallback = exports.loadMany = exports.LoadedRecordStep = exports.GraphQLResolverStep = exports.graphqlResolver = exports.graphqlItemHandler = exports.GraphQLItemHandler = exports.ApplyTransformsStep = void 0;
+exports.setter = exports.Setter = exports.createObjectAndApplyChildren = exports.ReverseStep = exports.reverseArray = exports.reverse = exports.RemapKeysStep = exports.remapKeys = exports.partitionByIndex = exports.ObjectStep = exports.object = exports.specFromNodeId = exports.NodeStep = exports.nodeIdFromNode = exports.node = exports.makeDecodeNodeIdRuntime = exports.makeDecodeNodeId = exports.listTransform = exports.__ListTransformStep = exports.ListenStep = exports.listen = exports.ListStep = exports.list = exports.LastStep = exports.last = exports.LambdaStep = exports.lambda = exports.groupBy = exports.FirstStep = exports.first = exports.filter = exports.ErrorStep = exports.error = exports.each = exports.ConstantStep = exports.constant = exports.EdgeStep = exports.ConnectionStep = exports.connection = exports.assertPageInfoCapableStep = exports.assertEdgeCapableStep = exports.AccessStep = exports.access = exports.TRAP_INHIBITED = exports.TRAP_ERROR_OR_INHIBITED = exports.TRAP_ERROR = exports.trap = exports.inhibitOnNull = exports.assertNotNull = exports.__FlagStep = void 0;
+exports.ProxyStep = exports.proxy = exports.PolymorphicBranchStep = exports.polymorphicBranch = exports.LoadStep = exports.loadOneCallback = exports.loadOne = exports.loadManyCallback = exports.loadMany = exports.LoadedRecordStep = exports.GraphQLResolverStep = exports.graphqlResolver = exports.graphqlItemHandler = exports.GraphQLItemHandler = exports.ConditionStep = exports.condition = exports.BakedInputStep = exports.bakedInputRuntime = exports.bakedInput = exports.ApplyTransformsStep = exports.applyTransforms = exports.Modifier = exports.isModifier = exports.assertModifier = exports.ApplyInputStep = exports.applyInput = exports.__ValueStep = exports.__TrackedValueStep = exports.__ItemStep = exports.__InputStaticLeafStep = exports.__InputObjectStep = exports.__InputListStep = exports.SideEffectStep = exports.sideEffect = void 0;
+exports.operationPlan = operationPlan;
+exports.context = context;
+exports.rootValue = rootValue;
+exports.trackedContext = trackedContext;
+exports.trackedRootValue = trackedRootValue;
+exports.debugPlans = debugPlans;
 const withGlobalLayerPlan_js_1 = require("../engine/lib/withGlobalLayerPlan.js");
 const global_js_1 = require("../global.js");
 function operationPlan() {
     return (0, withGlobalLayerPlan_js_1.currentLayerPlan)().operationPlan;
 }
-exports.operationPlan = operationPlan;
 function context() {
     return operationPlan().contextStep;
 }
-exports.context = context;
+function rootValue() {
+    return operationPlan().rootValueStep;
+}
+function trackedContext() {
+    return operationPlan().trackedContextStep;
+}
+function trackedRootValue() {
+    return operationPlan().trackedRootValueStep;
+}
 /**
  * Turns on debug mode, calls the callback, and then turns debug mode back off
  * again.
@@ -23,7 +36,14 @@ function debugPlans(callback) {
     (0, global_js_1.setDebug)(oldDebug);
     return result;
 }
-exports.debugPlans = debugPlans;
+var __flag_js_1 = require("./__flag.js");
+Object.defineProperty(exports, "__FlagStep", { enumerable: true, get: function () { return __flag_js_1.__FlagStep; } });
+Object.defineProperty(exports, "assertNotNull", { enumerable: true, get: function () { return __flag_js_1.assertNotNull; } });
+Object.defineProperty(exports, "inhibitOnNull", { enumerable: true, get: function () { return __flag_js_1.inhibitOnNull; } });
+Object.defineProperty(exports, "trap", { enumerable: true, get: function () { return __flag_js_1.trap; } });
+Object.defineProperty(exports, "TRAP_ERROR", { enumerable: true, get: function () { return __flag_js_1.TRAP_ERROR; } });
+Object.defineProperty(exports, "TRAP_ERROR_OR_INHIBITED", { enumerable: true, get: function () { return __flag_js_1.TRAP_ERROR_OR_INHIBITED; } });
+Object.defineProperty(exports, "TRAP_INHIBITED", { enumerable: true, get: function () { return __flag_js_1.TRAP_INHIBITED; } });
 var access_js_1 = require("./access.js");
 Object.defineProperty(exports, "access", { enumerable: true, get: function () { return access_js_1.access; } });
 Object.defineProperty(exports, "AccessStep", { enumerable: true, get: function () { return access_js_1.AccessStep; } });
@@ -65,7 +85,9 @@ Object.defineProperty(exports, "__ListTransformStep", { enumerable: true, get: f
 Object.defineProperty(exports, "listTransform", { enumerable: true, get: function () { return listTransform_js_1.listTransform; } });
 var node_js_1 = require("./node.js");
 Object.defineProperty(exports, "makeDecodeNodeId", { enumerable: true, get: function () { return node_js_1.makeDecodeNodeId; } });
+Object.defineProperty(exports, "makeDecodeNodeIdRuntime", { enumerable: true, get: function () { return node_js_1.makeDecodeNodeIdRuntime; } });
 Object.defineProperty(exports, "node", { enumerable: true, get: function () { return node_js_1.node; } });
+Object.defineProperty(exports, "nodeIdFromNode", { enumerable: true, get: function () { return node_js_1.nodeIdFromNode; } });
 Object.defineProperty(exports, "NodeStep", { enumerable: true, get: function () { return node_js_1.NodeStep; } });
 Object.defineProperty(exports, "specFromNodeId", { enumerable: true, get: function () { return node_js_1.specFromNodeId; } });
 var object_js_1 = require("./object.js");
@@ -81,8 +103,12 @@ Object.defineProperty(exports, "reverse", { enumerable: true, get: function () {
 Object.defineProperty(exports, "reverseArray", { enumerable: true, get: function () { return reverse_js_1.reverseArray; } });
 Object.defineProperty(exports, "ReverseStep", { enumerable: true, get: function () { return reverse_js_1.ReverseStep; } });
 var setter_js_1 = require("./setter.js");
+Object.defineProperty(exports, "createObjectAndApplyChildren", { enumerable: true, get: function () { return setter_js_1.createObjectAndApplyChildren; } });
+Object.defineProperty(exports, "Setter", { enumerable: true, get: function () { return setter_js_1.Setter; } });
 Object.defineProperty(exports, "setter", { enumerable: true, get: function () { return setter_js_1.setter; } });
-Object.defineProperty(exports, "SetterStep", { enumerable: true, get: function () { return setter_js_1.SetterStep; } });
+var sideEffect_js_1 = require("./sideEffect.js");
+Object.defineProperty(exports, "sideEffect", { enumerable: true, get: function () { return sideEffect_js_1.sideEffect; } });
+Object.defineProperty(exports, "SideEffectStep", { enumerable: true, get: function () { return sideEffect_js_1.SideEffectStep; } });
 // Internal plans
 var __inputList_js_1 = require("./__inputList.js");
 Object.defineProperty(exports, "__InputListStep", { enumerable: true, get: function () { return __inputList_js_1.__InputListStep; } });
@@ -96,9 +122,22 @@ var __trackedValue_js_1 = require("./__trackedValue.js");
 Object.defineProperty(exports, "__TrackedValueStep", { enumerable: true, get: function () { return __trackedValue_js_1.__TrackedValueStep; } });
 var __value_js_1 = require("./__value.js");
 Object.defineProperty(exports, "__ValueStep", { enumerable: true, get: function () { return __value_js_1.__ValueStep; } });
+var applyInput_js_1 = require("./applyInput.js");
+Object.defineProperty(exports, "applyInput", { enumerable: true, get: function () { return applyInput_js_1.applyInput; } });
+Object.defineProperty(exports, "ApplyInputStep", { enumerable: true, get: function () { return applyInput_js_1.ApplyInputStep; } });
+Object.defineProperty(exports, "assertModifier", { enumerable: true, get: function () { return applyInput_js_1.assertModifier; } });
+Object.defineProperty(exports, "isModifier", { enumerable: true, get: function () { return applyInput_js_1.isModifier; } });
+Object.defineProperty(exports, "Modifier", { enumerable: true, get: function () { return applyInput_js_1.Modifier; } });
 var applyTransforms_js_1 = require("./applyTransforms.js");
 Object.defineProperty(exports, "applyTransforms", { enumerable: true, get: function () { return applyTransforms_js_1.applyTransforms; } });
 Object.defineProperty(exports, "ApplyTransformsStep", { enumerable: true, get: function () { return applyTransforms_js_1.ApplyTransformsStep; } });
+var bakedInput_js_1 = require("./bakedInput.js");
+Object.defineProperty(exports, "bakedInput", { enumerable: true, get: function () { return bakedInput_js_1.bakedInput; } });
+Object.defineProperty(exports, "bakedInputRuntime", { enumerable: true, get: function () { return bakedInput_js_1.bakedInputRuntime; } });
+Object.defineProperty(exports, "BakedInputStep", { enumerable: true, get: function () { return bakedInput_js_1.BakedInputStep; } });
+var condition_js_1 = require("./condition.js");
+Object.defineProperty(exports, "condition", { enumerable: true, get: function () { return condition_js_1.condition; } });
+Object.defineProperty(exports, "ConditionStep", { enumerable: true, get: function () { return condition_js_1.ConditionStep; } });
 var graphqlResolver_js_1 = require("./graphqlResolver.js");
 Object.defineProperty(exports, "GraphQLItemHandler", { enumerable: true, get: function () { return graphqlResolver_js_1.GraphQLItemHandler; } });
 Object.defineProperty(exports, "graphqlItemHandler", { enumerable: true, get: function () { return graphqlResolver_js_1.graphqlItemHandler; } });
@@ -111,6 +150,9 @@ Object.defineProperty(exports, "loadManyCallback", { enumerable: true, get: func
 Object.defineProperty(exports, "loadOne", { enumerable: true, get: function () { return load_js_1.loadOne; } });
 Object.defineProperty(exports, "loadOneCallback", { enumerable: true, get: function () { return load_js_1.loadOneCallback; } });
 Object.defineProperty(exports, "LoadStep", { enumerable: true, get: function () { return load_js_1.LoadStep; } });
+var polymorphicBranch_js_1 = require("./polymorphicBranch.js");
+Object.defineProperty(exports, "polymorphicBranch", { enumerable: true, get: function () { return polymorphicBranch_js_1.polymorphicBranch; } });
+Object.defineProperty(exports, "PolymorphicBranchStep", { enumerable: true, get: function () { return polymorphicBranch_js_1.PolymorphicBranchStep; } });
 var proxy_js_1 = require("./proxy.js");
 Object.defineProperty(exports, "proxy", { enumerable: true, get: function () { return proxy_js_1.proxy; } });
 Object.defineProperty(exports, "ProxyStep", { enumerable: true, get: function () { return proxy_js_1.ProxyStep; } });

package/dist/steps/lambda.d.ts

@@ -1,10 +1,11 @@
-import type { ExecutionExtra, PromiseOrDirect, UnwrapPlanTuple } from "../interfaces.js";
-import type { ExecutableStep } from "../step.js";
-import { UnbatchedExecutableStep } from "../step.js";
+import type { PromiseOrDirect, UnbatchedExecutionExtra } from "../interfaces.js";
+import type { Multistep, UnwrapMultistep } from "../multistep.js";
+import type { Step } from "../step.js";
+import { UnbatchedStep } from "../step.js";
 /**
  * Calls the given lambda function for each tuple
  */
-export declare class LambdaStep<TIn, TOut> extends UnbatchedExecutableStep<TOut> {
+export declare class LambdaStep<TIn, TOut> extends UnbatchedStep<TOut> {
     private fn;
     static $$export: {
         moduleName: string;
@@ -12,18 +13,17 @@ export declare class LambdaStep<TIn, TOut> extends UnbatchedExecutableStep<TOut>
     };
     isSyncAndSafe: boolean;
     allowMultipleOptimizations: boolean;
-    private planDep;
-    constructor($plan: ExecutableStep<TIn> | null | undefined, fn: (value: TIn) => PromiseOrDirect<TOut>);
+    private depId;
+    constructor($plan: Step<TIn> | null | undefined, fn: (value: TIn) => PromiseOrDirect<TOut>);
     toStringMeta(): any;
     deduplicate(peers: LambdaStep<any, any>[]): LambdaStep<TIn, TOut>[];
-    unbatchedExecute(_extra: ExecutionExtra, value: TIn): PromiseOrDirect<TOut>;
+    unbatchedExecute(_extra: UnbatchedExecutionExtra, value: TIn): PromiseOrDirect<TOut>;
 }
 /**
  * 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.
  */
-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,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.lambda = exports.LambdaStep = void 0;
+exports.LambdaStep = void 0;
+exports.lambda = lambda;
+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
  */
-class LambdaStep extends step_js_1.UnbatchedExecutableStep {
+class LambdaStep extends step_js_1.UnbatchedStep {
     static { this.$$export = {
         moduleName: "grafast",
         exportName: "LambdaStep",
@@ -17,7 +19,7 @@ class LambdaStep extends step_js_1.UnbatchedExecutableStep {
         // Lambda is only sync and safe if the callback is; so default to false
         this.isSyncAndSafe = false;
         this.allowMultipleOptimizations = true;
-        this.planDep = $plan != null ? this.addDependency($plan) : null;
+        this.depId = $plan != null ? this.addDependency($plan) : null;
         if (fn.hasSideEffects) {
             this.hasSideEffects = true;
         }
@@ -39,13 +41,21 @@ 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)(spec, fn);
+    }
     if (isSyncAndSafe) {
         if (fn.constructor.name === "AsyncFunction") {
             throw new Error(`lambda call claims to be syncAndSafe, however the callback function is asynchronous`);
@@ -54,5 +64,4 @@ function lambda(planOrPlans, fn, isSyncAndSafe = false) {
     }
     return $lambda;
 }
-exports.lambda = lambda;
 //# sourceMappingURL=lambda.js.map

package/dist/steps/last.d.ts

@@ -1,21 +1,22 @@
-import type { ExecutionExtra } from "../interfaces.js";
-import type { ExecutableStep } from "../step.js";
-import { UnbatchedExecutableStep } from "../step.js";
-export declare class LastStep<TData> extends UnbatchedExecutableStep<TData> {
+import type { UnbatchedExecutionExtra } from "../interfaces.js";
+import type { Step } from "../step.js";
+import { UnbatchedStep } from "../step.js";
+import type { ConnectionCapableStep } from "./connection.js";
+export declare class LastStep<TData> extends UnbatchedStep<TData> {
     static $$export: {
         moduleName: string;
         exportName: string;
     };
     isSyncAndSafe: boolean;
     allowMultipleOptimizations: boolean;
-    constructor(parentPlan: ExecutableStep<ReadonlyArray<TData>>);
-    unbatchedExecute: (_extra: ExecutionExtra, list: ReadonlyArray<TData>) => TData;
+    constructor(parentPlan: Step<ReadonlyArray<TData>> | ConnectionCapableStep<Step<TData>, any>);
+    unbatchedExecute: (_extra: UnbatchedExecutionExtra, list: ReadonlyArray<TData>) => TData;
     deduplicate(peers: LastStep<TData>[]): LastStep<TData>[];
-    optimize(): ExecutableStep<any> | this;
+    optimize(): any;
 }
 /**
  * A plan that resolves to the last entry in the list returned by the given
  * plan.
  */
-export declare function last<TData>(plan: ExecutableStep<ReadonlyArray<TData>>): LastStep<TData>;
+export declare function last<TData>(plan: Step<ReadonlyArray<TData>> | ConnectionCapableStep<Step<TData>, any>): LastStep<TData>;
 //# sourceMappingURL=last.d.ts.map

package/dist/steps/last.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.last = exports.LastStep = void 0;
+exports.LastStep = void 0;
+exports.last = last;
 const step_js_1 = require("../step.js");
+const connection_js_1 = require("./connection.js");
 const list_js_1 = require("./list.js");
-class LastStep extends step_js_1.UnbatchedExecutableStep {
+class LastStep extends step_js_1.UnbatchedStep {
     static { this.$$export = {
         moduleName: "grafast",
         exportName: "LastStep",
@@ -15,7 +17,7 @@ class LastStep extends step_js_1.UnbatchedExecutableStep {
         this.unbatchedExecute = (_extra, list) => {
             return list?.[list?.length - 1];
         };
-        this.addDependency(parentPlan);
+        this.addDependency((0, connection_js_1.itemsOrStep)(parentPlan));
     }
     deduplicate(peers) {
         return peers;
@@ -24,7 +26,7 @@ class LastStep extends step_js_1.UnbatchedExecutableStep {
         const parent = this.getDep(0);
         // The last of a list plan is just the last dependency of the list plan.
         if (parent instanceof list_js_1.ListStep) {
-            return parent.getDep(parent.dependencies.length - 1);
+            return parent.last();
         }
         return this;
     }
@@ -35,7 +37,6 @@ exports.LastStep = LastStep;
  * plan.
  */
 function last(plan) {
-    return new LastStep(plan);
+    return plan.operationPlan.cacheStep(plan, "GrafastInternal:last()", "", () => new LastStep(plan));
 }
-exports.last = last;
 //# sourceMappingURL=last.js.map

package/dist/steps/list.d.ts

@@ -1,8 +1,12 @@
-import type { ExecutionExtra, StepOptimizeOptions, UnwrapPlanTuple } from "../interfaces.js";
-import type { ExecutableStep } from "../step.js";
-import { UnbatchedExecutableStep } from "../step.js";
+import type { ExecutionDetails, StepOptimizeOptions, UnbatchedExecutionExtra, UnwrapPlanTuple } from "../interfaces.js";
+import type { Step } from "../step.js";
+import { UnbatchedStep } from "../step.js";
 import { ConstantStep } from "./constant.js";
-export declare class ListStep<const TPlanTuple extends readonly ExecutableStep[]> extends UnbatchedExecutableStep<UnwrapPlanTuple<TPlanTuple>> {
+interface ListStepCacheConfig {
+    identifier?: string;
+    cacheSize?: number;
+}
+export declare class ListStep<const TPlanTuple extends readonly Step[]> extends UnbatchedStep<UnwrapPlanTuple<TPlanTuple>> {
     static $$export: {
         moduleName: string;
         exportName: string;
@@ -10,20 +14,27 @@ 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(count: number, values: any[][]): Array<UnwrapPlanTuple<TPlanTuple>>;
-    unbatchedExecute(_extra: ExecutionExtra, ...values: any[]): UnwrapPlanTuple<TPlanTuple>;
+    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.
      */
-    at<TIndex extends keyof TPlanTuple>(index: TIndex): TPlanTuple[TIndex];
+    at<TIndex extends keyof TPlanTuple & number>(index: TIndex): TPlanTuple[TIndex];
+    first(): TPlanTuple[0] | import("./__flag.js").__FlagStep<TPlanTuple[0]>;
+    last(): TPlanTuple[number] | import("./__flag.js").__FlagStep<TPlanTuple[number]>;
 }
 /**
  * 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 Step[]>(list: TPlanTuple, cacheConfig?: ListStepCacheConfig): ListStep<TPlanTuple>;
+export {};
 //# sourceMappingURL=list.d.ts.map

package/dist/steps/list.js

@@ -1,36 +1,68 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.list = exports.ListStep = void 0;
+exports.ListStep = void 0;
+exports.list = list;
 const step_js_1 = require("../step.js");
 const constant_js_1 = require("./constant.js");
-class ListStep extends step_js_1.UnbatchedExecutableStep {
+const DEFAULT_CACHE_SIZE = 100;
+class ListStep extends step_js_1.UnbatchedStep {
     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(list[i], true);
+            this.addDependency({ step: list[i], skipDeduplication: true });
         }
     }
     toStringMeta() {
         return this.dependencies.map(($dep) => $dep.id).join(",");
     }
-    execute(count, values) {
-        const result = [];
-        for (let i = 0; i < count; i++) {
-            result[i] = values.map((list) => list[i]);
-        }
-        return result;
+    execute({ indexMap, values }) {
+        return indexMap((i) => values.map((value) => value.at(i)));
     }
     unbatchedExecute(_extra, ...values //UnwrapPlanTuple<TPlanTuple>,
     ) {
         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;
     }
@@ -56,20 +88,31 @@ 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.
      */
     at(index) {
         return this.getDep(index);
     }
+    first() {
+        return this.getDep(0);
+    }
+    last() {
+        return this.getDep(this.dependencies.length - 1);
+    }
 }
 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/listTransform.d.ts

@@ -1,22 +1,21 @@
-import type { LayerPlanReasonSubroutine } from "../engine/LayerPlan.js";
-import { LayerPlan } from "../engine/LayerPlan.js";
-import type { GrafastError } from "../error.js";
-import type { ConnectionCapableStep } from "../index.js";
-import type { ExecutionExtra, GrafastResultsList, GrafastValuesList } from "../interfaces.js";
+import type { ConnectionCapableStep, ExecutionDetails } from "../index.js";
+import type { GrafastResultsList } from "../interfaces.js";
+import { $$deepDepSkip } from "../interfaces.js";
 import type { ListCapableStep } from "../step.js";
-import { $$deepDepSkip, ExecutableStep } from "../step.js";
+import { Step } from "../step.js";
 import { __ItemStep } from "./__item.js";
+import type { ItemsStep } from "./connection.js";
 export type ListTransformReduce<TMemo, TItemPlanData> = (memo: TMemo, entireItemValue: unknown, itemPlanData: TItemPlanData) => TMemo;
-export type ListTransformItemPlanCallback<TListStep extends ExecutableStep<readonly any[]>, TDepsStep extends ExecutableStep> = (listItemPlan: TListStep extends ListCapableStep<any, any> ? ReturnType<TListStep["listItem"]> : __ItemStep<any>) => TDepsStep;
-export interface ListTransformOptions<TListStep extends ExecutableStep<readonly any[]>, TDepsStep extends ExecutableStep, TMemo, TItemStep extends ExecutableStep | undefined = undefined> {
+export type ListTransformItemPlanCallback<TListStep extends Step<readonly any[]>, TDepsStep extends Step> = (listItemPlan: ItemsStep<TListStep> extends ListCapableStep<any, any> ? ReturnType<ItemsStep<TListStep>["listItem"]> : __ItemStep<any>) => TDepsStep;
+export interface ListTransformOptions<TListStep extends Step<readonly any[]> | ConnectionCapableStep<Step<any>, any>, TDepsStep extends Step, TMemo, TItemStep extends Step | undefined = undefined> {
     listStep: TListStep;
-    itemPlanCallback: ListTransformItemPlanCallback<TListStep, TDepsStep>;
+    itemPlanCallback: ListTransformItemPlanCallback<ItemsStep<TListStep>, TDepsStep>;
     initialState(): TMemo;
-    reduceCallback: ListTransformReduce<TMemo, TDepsStep extends ExecutableStep<infer U> ? U : never>;
-    listItem?(itemPlan: ExecutableStep): TItemStep;
+    reduceCallback: ListTransformReduce<TMemo, TDepsStep extends Step<infer U> ? U : never>;
+    listItem?(itemPlan: Step): TItemStep;
     finalizeCallback?(data: TMemo): TMemo;
     meta?: string;
-    optimize?: (this: __ListTransformStep<TListStep, TDepsStep, TMemo, TItemStep>) => ExecutableStep;
+    optimize?: (this: __ListTransformStep<TListStep, TDepsStep, TMemo, TItemStep>) => Step;
     connectionClone?: ConnectionCapableStep<TListStep, any>["connectionClone"];
 }
 /**
@@ -28,34 +27,31 @@ export interface ListTransformOptions<TListStep extends ExecutableStep<readonly
  * It's recommended that you don't use this directly, please use one of the
  * functions that uses this under the hood such as `filter()`.
  */
-export declare class __ListTransformStep<TListStep extends ExecutableStep<readonly any[]> = ExecutableStep<readonly any[]>, TDepsStep extends ExecutableStep = ExecutableStep, TMemo = any, TItemStep extends ExecutableStep | undefined = ExecutableStep | undefined> extends ExecutableStep<TMemo> {
+export declare class __ListTransformStep<TListStep extends Step<readonly any[]> | ConnectionCapableStep<any, any> = Step<readonly any[]> | ConnectionCapableStep<any, any>, TDepsStep extends Step = Step, TMemo = any, TItemStep extends Step | undefined = Step | undefined> extends Step<TMemo> {
     static $$export: {
         moduleName: string;
         exportName: string;
     };
     isSyncAndSafe: boolean;
     private listStepDepId;
-    itemPlanCallback: ListTransformItemPlanCallback<TListStep, TDepsStep>;
+    private rawListStepDepId;
+    itemPlanCallback: ListTransformItemPlanCallback<ItemsStep<TListStep>, TDepsStep>;
     initialState: () => TMemo;
-    reduceCallback: ListTransformReduce<TMemo, TDepsStep extends ExecutableStep<infer U> ? U : never>;
+    reduceCallback: ListTransformReduce<TMemo, TDepsStep extends Step<infer U> ? U : never>;
     finalizeCallback?: (data: TMemo) => TMemo;
     listItem?: (itemPlan: __ItemStep<this>) => TItemStep;
     private meta;
     connectionClone?: ConnectionCapableStep<TListStep, any>["connectionClone"];
     /** Set during query planning.  */
     itemStepId: number;
-    /**
-     * @internal
-     */
-    subroutineLayer: LayerPlan<LayerPlanReasonSubroutine>;
     constructor(options: ListTransformOptions<TListStep, TDepsStep, TMemo, TItemStep>);
     toStringMeta(): string | null;
     getListStep(): TListStep;
     [$$deepDepSkip](): TListStep;
     dangerouslyGetListPlan(): TListStep;
     deduplicate(peers: __ListTransformStep<any, any, any, any>[]): __ListTransformStep<TListStep, TDepsStep, TMemo, TItemStep>[];
-    optimize(): ExecutableStep;
-    execute(_count: number, values: [GrafastValuesList<any[] | null | undefined | GrafastError>], extra: ExecutionExtra): Promise<GrafastResultsList<TMemo>>;
+    optimize(): Step;
+    execute({ indexForEach, indexMap, values, extra, }: ExecutionDetails<[any[] | null | undefined | Error]>): Promise<GrafastResultsList<TMemo>>;
 }
 /**
  * **Experimental.**
@@ -65,5 +61,5 @@ export declare class __ListTransformStep<TListStep extends ExecutableStep<readon
  *
  * {@page ~grafast/steps/listTransform.md}
  */
-export declare function listTransform<TListStep extends ExecutableStep<readonly any[]>, TDepsStep extends ExecutableStep, TMemo, TItemStep extends ExecutableStep | undefined = undefined>(options: ListTransformOptions<TListStep, TDepsStep, TMemo, TItemStep>): __ListTransformStep<TListStep, TDepsStep, TMemo, TItemStep>;
+export declare function listTransform<TListStep extends Step<readonly any[]> | ConnectionCapableStep<any, any>, TDepsStep extends Step, TMemo, TItemStep extends Step | undefined = undefined>(options: ListTransformOptions<TListStep, TDepsStep, TMemo, TItemStep>): __ListTransformStep<TListStep, TDepsStep, TMemo, TItemStep>;
 //# sourceMappingURL=listTransform.d.ts.map