@enricai/barnacle 1.12.19 → 1.12.20

package/dist/scripts/recon-generate-multicall-fixture.d.ts

@@ -16,12 +16,14 @@ export declare function buildCapture(overrides: {
     requestPostData: string | null;
     responseBody: unknown;
     timestamp: string;
+    requestHeaders?: Record<string, string>;
 }): Capture;
 export declare function buildStep(varName: string, overrides: {
     url: string;
     requestPostData: string | null;
     responseBody: unknown;
     timestamp: string;
+    requestHeaders?: Record<string, string>;
 }): MulticallFixtureStep;
 /**
  * Reproduces a listings-fixture G1/G2 recon capture set: a
@@ -45,6 +47,21 @@ export declare function buildMulticallHeterogeneousActionSteps(): MulticallFixtu
  * fired after the user picks one building from the products list).
  */
 export declare function buildMulticallHeterogeneousActionStepsWithDrillDown(): MulticallFixtureStep[];
+/**
+ * Reproduces a search-then-per-item-drill-down flow whose primary page
+ * carries multiple results, each followed by its own drill-down call — the
+ * shape {@link detectDrillDownFoldPlan} must resolve by join key rather than
+ * by position. `search`/`page 2` is re-queried (distinct body from `page 1`)
+ * so it satisfies {@link findRequeriedActions}'s relevance signal, and its
+ * response holds two items (`i-b` then `i-a`, deliberately not alphabetical)
+ * so a later merge can't assume primary-array order. The two drill-down
+ * calls are fired in the OPPOSITE order of the primary array (`i-a`'s
+ * drill-down first, `i-b`'s second) — a positional/index-based fold would
+ * pair the wrong item with the wrong drill-down response, while a join-key
+ * fold (matching each drill request's `itemId` back to the primary item that
+ * produced it) pairs them correctly regardless of call order.
+ */
+export declare function buildMulticallDependentDrillDownActionSteps(): MulticallFixtureStep[];
 /**
  * Reproduces a wizard-style checkout submission on one host: a create-order
  * call followed by a per-section save POST for each wizard step
@@ -59,4 +76,492 @@ export declare function buildMulticallHeterogeneousActionStepsWithDrillDown(): M
  * capture set).
  */
 export declare function buildWizardCheckoutCaptures(): Capture[];
+/**
+ * A search → per-item drill-down flow whose search endpoint fires exactly
+ * ONCE. {@link detectDrillDownFoldPlan} now scans every prior action as a
+ * fold-primary candidate, so a single-shot search is just as eligible as a
+ * re-queried one — but the primary response here also carries a decoy
+ * `facets[]` array ahead of the real `results[]`, so `findObjectArrayField`'s
+ * DFS first-match deliberately disagrees with the array a caller would fold
+ * onto. `resolveFoldPlan(steps)` on this fixture still returns `null`, but
+ * only because of that decoy, not because the search fires once. That
+ * decoy-vs-declared-path gap is the shape the flow-declared `foldReturn`
+ * (`FoldReturnSpec`/`resolveFoldPlan`) exists to reach.
+ *
+ * The decoy is load-bearing for a `resolveFoldPlan`/`foldReturn` test
+ * elsewhere; {@link buildMulticallSingleShotSearchDrillDownNoDecoyActionSteps}
+ * is the decoy-free sibling used to prove `detectDrillDownFoldPlan` alone
+ * detects a single-shot primary.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownActionSteps(): MulticallFixtureStep[];
+/**
+ * A search → per-item drill-down flow whose search response is unambiguous
+ * (a single `results[]` array, no decoy), but whose DRILL step's response
+ * carries a decoy `errors[]` array ahead of the real per-item `details[]`
+ * array. `findObjectArrayField`'s DFS first-match lands on `errors[]`
+ * instead of `details[]` when resolving the drill side of the fold, so a
+ * `foldReturn` declaration that only names the primary's `resultsPath`
+ * (see {@link FoldReturnSpec}) cannot fix this — the gap is on the drill
+ * side, not the primary side. Proves a drill-side results-path declaration
+ * (as opposed to {@link buildMulticallSingleShotSearchDrillDownActionSteps}'s
+ * primary-side decoy) is what a `drillResultsPath`-style flow declaration
+ * exists to reach.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownDrillDecoyActionSteps(): MulticallFixtureStep[];
+/**
+ * A decoy-free sibling of {@link buildMulticallSingleShotSearchDrillDownActionSteps}:
+ * the search endpoint still fires exactly once, but `results[]` is the sole
+ * object-array field in its response, so `findObjectArrayField`'s DFS
+ * first-match lands on the real results array with no declared `foldReturn`
+ * needed. Proves the single-shot primary is detected on structure alone.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownNoDecoyActionSteps(): MulticallFixtureStep[];
+/**
+ * A nested-join-key sibling of {@link buildMulticallSingleShotSearchDrillDownNoDecoyActionSteps}
+ * with a SECOND primary item, so a per-item fold loop is actually exercised
+ * (not just a single-item detection check): each primary `results[]` item
+ * carries its join key under a nested `identifiers` object
+ * (`{ identifiers: { sku } }`) instead of as a top-level field, while the
+ * drill-down request is still keyed by the plain `sku` value pulled out of
+ * that nested field. Proves the fold loop threads a join key found by
+ * walking INTO an item's nested objects, not only its own top-level
+ * `Object.entries`, across every primary item.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownNestedJoinFieldMultiItemActionSteps(): MulticallFixtureStep[];
+/**
+ * A search → per-item drill-down flow whose DRILL step's response carries
+ * BOTH a small real nested object-array field (`tags[]`, one primitive
+ * field per item, no join echo) AND richer flat top-level per-item fields
+ * (`name`/`price`/`brand`, none of them echoing the join either) — the
+ * shape {@link findAllObjectArrayFieldsOrWholeObject}'s old docstring
+ * ("a response that already has one [a real object-array field] is never
+ * second-guessed") resolved to the tiny `tags[]` array instead of the
+ * richer flat object. Neither candidate threads the join value in its
+ * response body (only the drill REQUEST carries `sku-a`), so selection must
+ * fall through to comparing per-item primitive-field richness, which the
+ * flat object wins 3 (`name`/`price`/`brand`) to 1 (`tags[0].id`).
+ */
+export declare function buildMulticallSingleShotSearchDrillDownRicherFlatOutranksNestedArrayActionSteps(): MulticallFixtureStep[];
+/**
+ * A decoy-free sibling of {@link buildMulticallSingleShotSearchDrillDownNoDecoyActionSteps}
+ * with a SECOND, independently-threaded per-item drill-down appended: the
+ * primary `results[]` items carry both a `sku` (joined to the pricing drill)
+ * and an `itemId` (joined to this inventory drill), and neither drill
+ * step's response overlaps the other's fields. Proves the fold loop merges
+ * fields from every independent target onto each item, not just the first.
+ */
+export declare function buildMulticallSingleShotSearchTwoIndependentDrillDownsActionSteps(): MulticallFixtureStep[];
+/**
+ * A sibling of {@link buildMulticallSingleShotSearchTwoIndependentDrillDownsActionSteps}
+ * where BOTH per-item drills are threaded off the SAME primary join field
+ * (`sku`), rather than disjoint fields (`sku`/`itemId`). Each drill's
+ * response echoes that shared `sku` value back alongside its own field —
+ * an echo of the primary's own join value, not evidence the second drill
+ * depends on the first drill's response. Proves the fold loop still emits
+ * and merges BOTH independent drills onto every primary item even when
+ * their echoed join values collide, rather than collapsing the second
+ * drill into a chain under the first.
+ */
+export declare function buildMulticallSingleShotSearchTwoIndependentDrillDownsSharedJoinFieldActionSteps(): MulticallFixtureStep[];
+/**
+ * TWO independent primary/drill-down pairs, fully disjoint in both endpoint
+ * and step range: a products search folded by a per-product reviews drill
+ * (r0/r1), and an UNRELATED vendors search folded by a per-vendor contracts
+ * drill (r2/r3). Neither primary's items reference the other pair's join key
+ * (`productId` vs `vendorId`), so this proves the fold emitter resolves and
+ * loops over every independent plan, not only the first one it finds.
+ */
+export declare function buildMulticallTwoIndependentPrimariesActionSteps(): MulticallFixtureStep[];
+/**
+ * Same disjoint two-pair shape as
+ * {@link buildMulticallTwoIndependentPrimariesActionSteps}, except the SECOND
+ * pair's join value threads only through a request HEADER
+ * (`collectRequestStringValues` never scans headers), so
+ * `detectDrillDownFoldPlan`'s structural heuristic resolves only the FIRST
+ * pair (r0/r1) on its own; the second pair (r2/r3) is only reachable via a
+ * flow-declared `foldReturn` spec naming `vendors` as its `resultsPath`.
+ * Since the second pair's primary/drill steps (2, 3) are entirely outside the
+ * first pair's own consumed indices ({@link buildMulticallTwoIndependentPrimariesActionSteps}'s
+ * r0/r1), a correctly-behaving `resolveFoldPlan` must APPEND the spec's plan
+ * as a second, independent entry rather than discarding it just because its
+ * primary differs from the one the heuristic already resolved.
+ */
+export declare function buildMulticallTwoIndependentPrimariesSecondHeaderThreadedActionSteps(): MulticallFixtureStep[];
+/** A single-shot search drilled by two INDEPENDENT later calls whose join
+ * values thread through different surfaces: the pricing step's `sku` lands
+ * in its JSON body (heuristically detectable by `collectRequestStringValues`),
+ * while the stock step's `itemId` is carried ONLY in a request header —
+ * `collectRequestStringValues` never scans headers, so that fold can only be
+ * resolved via a flow-declared `foldReturn` spec. Every downstream unit and
+ * runtime test that needs one mixed-source, two-target fold scenario should
+ * share this fixture rather than inventing its own. */
+export declare function buildMulticallSingleShotSearchHeuristicAndSpecTwoTargetActionSteps(): MulticallFixtureStep[];
+/**
+ * TWO occurrences of the SAME primary endpoint (same origin+pathname,
+ * differing only by query string), each independently drilling a
+ * DIFFERENT item into a DIFFERENT dependent call — unlike
+ * {@link buildMulticallSingleShotSearchDrillDownRequeriedPrimaryOverlapActionSteps}
+ * (whose two occurrences thread the SAME drill), these thread two distinct
+ * drills, so {@link detectDrillDownFoldPlan}'s freshest-wins collapse never
+ * applies and both occurrences resolve as their own independent
+ * {@link FoldPlan}. Both plans' primary responses share the SAME top-level
+ * array key (`results`) — the exact shape a plain `{ ...a, ...b }`
+ * object-spread silently collapses to the later plan's array alone, since
+ * the emitted return statement folds every resolved plan's own primary var
+ * together into the runtime response.
+ */
+export declare function buildMulticallTwoOccurrencesSamePrimaryDistinctDrillsActionSteps(): MulticallFixtureStep[];
+/**
+ * A grouped, nested-primary drill-down whose primary response carries TWO
+ * outer `sections[]` groups rather than the single group every other nested
+ * fixture in this file uses, with the drilled entry living in the SECOND
+ * group's `entries[]`, not the first. A fold that assumes the matched item
+ * always lives in group 0 (as a single-group fixture can never disprove)
+ * would resolve the fold onto `sections[0]` and silently attach the drill
+ * response's `description` to the wrong entry.
+ */
+export declare function buildMulticallNestedGroupedDrillDownMultiGroupActionSteps(): MulticallFixtureStep[];
+/**
+ * A single-shot search whose primary item join field (`accountId`) is a
+ * NUMBER rather than a string, threaded into the drill-down call via a URL
+ * query parameter (`?accountId=42`). `URLSearchParams` always stringifies its
+ * values, so the request-collection side already captures `"42"` as a
+ * string; the item side of the join is what must widen to accept a numeric
+ * leaf for {@link detectDrillDownFoldPlan} to resolve `accountId` as a join
+ * field at all.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownNumericJoinActionSteps(): MulticallFixtureStep[];
+/**
+ * A single-shot search whose primary item join field (`accountId`) is
+ * threaded into the drill-down call ONLY as a URL path segment
+ * (`/accounts/42/transactions`) — never as a query param or a JSON body
+ * value. REST-style APIs commonly shape drill-down calls this way, but
+ * `collectRequestStringValues` only harvested query params and JSON body
+ * leaves, so this join field was invisible to `findThreadedJoinFields` and
+ * {@link detectDrillDownFoldPlan} returned null for this shape.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownPathThreadedJoinActionSteps(): MulticallFixtureStep[];
+/**
+ * A single-shot search whose primary item join field (`sku`) sits inside a
+ * NESTED object (`{ identifiers: { sku } }`) rather than as a top-level
+ * property. `findThreadedJoinFields` must walk into nested plain objects to
+ * find it, and the resulting joinFields entry is the dot-separated path
+ * `"identifiers.sku"`, not the bare leaf name `"sku"`.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownNestedJoinFieldActionSteps(): MulticallFixtureStep[];
+/**
+ * A single-shot search whose primary items carry a COMPOSITE join key mixing
+ * a string field (`region`) and a numeric field (`accountId`), both threaded
+ * into the drill-down request. `findThreadedJoinFields` filters candidate
+ * fields independently per entry, so a numeric field dropped alongside a
+ * present string field would silently degrade the fold to a partial
+ * (string-only) join key rather than failing outright — this fixture proves
+ * both survive together, in the item's own key order.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownCompositeNumericJoinActionSteps(): MulticallFixtureStep[];
+/**
+ * A decoy-free single-shot search sibling of
+ * {@link buildMulticallSingleShotSearchDrillDownNoDecoyActionSteps} whose
+ * `results[]` has TWO items, but whose only captured drill-down call was
+ * made for the SECOND item (`sku-b`), not the first. A heuristic that always
+ * pairs the primary's `results[0]` with the sole drill step would thread
+ * `sku-a` into the fold even though the captured request body only ever
+ * mentions `sku-b` — proving the fold must select the drill call's item by
+ * matching the join field's actual value, not by array position.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownNonFirstItemSkuActionSteps(): MulticallFixtureStep[];
+/**
+ * A composite-join sibling of
+ * {@link buildMulticallSingleShotSearchDrillDownCompositeNumericJoinActionSteps}
+ * whose `accounts[]` has TWO items, but whose only captured drill-down call
+ * threads the SECOND item's composite join key (`region: "eu"`,
+ * `accountId: 9`), never the first item's (`region: "us"`, `accountId: 7`).
+ * Proves the same non-first-item selection requirement holds when the join
+ * key is composite, not just when it's a single field.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownCompositeNumericJoinNonFirstItemActionSteps(): MulticallFixtureStep[];
+/**
+ * A single-shot search whose primary item join field (`accountId`) is
+ * threaded into the drill-down call ONLY via a custom request header
+ * (`X-Account-Id`) — never a query param, JSON body value, or URL path
+ * segment. `collectRequestStringValues` deliberately never scans
+ * `requestHeaders` (recon-generate.ts:4787-4815), so this join is invisible
+ * to `findThreadedJoinFields` and {@link detectDrillDownFoldPlan} must return
+ * `null` here regardless of how many other threading channels it learns to
+ * scan — only a flow-declared `foldReturn` naming `accountId` can resolve
+ * this fold.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownHeaderThreadedJoinActionSteps(): MulticallFixtureStep[];
+/**
+ * A sibling of {@link buildMulticallSingleShotSearchDrillDownHeaderThreadedJoinActionSteps}
+ * whose primary endpoint is hit TWICE (`r0`, `r1`), each occurrence's single
+ * `accounts[]` item independently satisfying the drill-down's `X-Account-Id`
+ * join on its own — mirroring
+ * {@link buildMulticallSingleShotSearchDrillDownRequeriedPrimaryOverlapActionSteps}'s
+ * requeried-primary-overlap shape, but with the join threaded ONLY through a
+ * request header rather than a URL query param, so `detectDrillDownFoldPlan`'s
+ * structural heuristic can never see it (same blind spot documented on
+ * {@link buildMulticallSingleShotSearchDrillDownHeaderThreadedJoinActionSteps}).
+ * Only a flow-declared `foldReturn` naming `accountId` can resolve this fold,
+ * isolating `buildFoldPlanFromSpec`'s own freshest-wins primary lookahead:
+ * the resolved plan must anchor on `r1` (the LATER occurrence) and its
+ * differing `name` value ("Acme Corp"), not `r0`'s stale "Acme".
+ */
+export declare function buildMulticallSingleShotSearchDrillDownHeaderThreadedJoinRequeriedPrimaryOverlapActionSteps(): MulticallFixtureStep[];
+/**
+ * Sibling of {@link buildMulticallSingleShotSearchDrillDownHeaderThreadedJoinActionSteps}
+ * whose primary `accounts[]` array holds TWO items rather than one, so a
+ * runtime fold loop built from this capture must re-key the drill-down's
+ * request header per iteration rather than replaying the single captured
+ * header value.
+ *
+ * Threaded on `API-Token` rather than the sibling fixture's `X-Account-Id`:
+ * `emitMultiStepExecuteHttp`'s per-call header emission only ever renders a
+ * captured header back into the generated request when it recognizes the
+ * header name (`API-Token`/`Authorization`, or a base-URL-/tenant-derived
+ * header passed in separately — recon-generate.ts:4273-4279) — an arbitrary
+ * custom header like `X-Account-Id` is captured but never re-emitted, so a
+ * fold loop built from it would have nothing to re-key at runtime. `API-Token`
+ * is still a request header the join value reaches through NO OTHER channel
+ * (not the URL, which is identical on every call, and not the body, which is
+ * empty), so it still exercises the same header-threaded-join runtime path
+ * {@link buildMulticallSingleShotSearchDrillDownHeaderThreadedJoinActionSteps}
+ * demonstrates is invisible to the structural heuristic.
+ *
+ * The captured drill call was made for `accountId: 43` (the SECOND item),
+ * pinning `primaryMatchedItemIndex` away from the index-0 default.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownHeaderThreadedJoinMultiItemActionSteps(): MulticallFixtureStep[];
+/**
+ * A single-shot search whose primary results array is NOT drilled into at
+ * item 0 — only a single later drill call exists, and it threads the second
+ * item's (`itemId: "i-a"`) join value, never the first's (`itemId: "i-b"`).
+ * With no coincidental extra call re-drilling item 0 (unlike
+ * {@link buildMulticallDependentDrillDownActionSteps}, whose items are also
+ * out of order but which happens to pass a items[0]-only match because a
+ * third step re-drills item 0), this pins {@link detectDrillDownFoldPlan}'s
+ * item search to the actually-drilled item rather than an index-0 default —
+ * the search must find the match at `primaryMatchedItemIndex` 1.
+ * Named "OutOfOrder" (rather than "NonFirstItem") to avoid colliding with
+ * {@link buildMulticallSingleShotSearchDrillDownNonFirstItemSkuActionSteps}.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownOutOfOrderItemActionSteps(): MulticallFixtureStep[];
+/**
+ * A single-shot search sibling of
+ * {@link buildMulticallSingleShotSearchDrillDownNonFirstItemSkuActionSteps}
+ * whose axis is on the DRILL side rather than the primary side: the primary
+ * `results[]` has a single item (`sku-a`), but the drill-down's own
+ * `prices[]` array comes back holding TWO entries — a decoy for an unrelated
+ * sku (`sku-z`, listed first) alongside the real match (`sku-a`, listed
+ * second). A fold that merges `foldMatches[0]`/`drillItems?.[0]` would
+ * silently splice the decoy's `amount` onto the primary item; only matching
+ * the drill array's own entries against the threaded join field (`sku`)
+ * picks the correct one, at a non-zero index within that array.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownMultiMatchActionSteps(): MulticallFixtureStep[];
+/**
+ * A multi-match sibling of
+ * {@link buildMulticallSingleShotSearchDrillDownMultiMatchActionSteps} whose
+ * join field's type DIFFERS across the two sides: the primary item's
+ * `accountId` is a NUMBER, while every item in the drill-down response's
+ * array carries `accountId` as a STRING (as request-threaded values always
+ * are). A decoy entry is listed first with a string that never equals the
+ * primary's numeric value even after coercion; only the second entry's
+ * string stringifies to the primary's value. A fold that matches via strict
+ * equality (`m["accountId"] === item.accountId`, i.e. `"42" === 42`) fails
+ * for every candidate here, proving the fold must compare join values by
+ * their string representation, not by strict identity.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownTypeMismatchJoinActionSteps(): MulticallFixtureStep[];
+/**
+ * Same shape as {@link buildMulticallSingleShotSearchDrillDownChainedDependentActionSteps},
+ * but the CHAIN's second step (the price-history call `r2`, not the drill
+ * step `r1` itself) is a multipart upload rather than a JSON POST.
+ * `emitMultiStepExecuteHttp`'s fold loop re-issues EVERY chain step's
+ * request per item by re-keying its rendered JSON body template — a
+ * multipart step anywhere in `chain`, not just at `drillStepIndex`, has no
+ * such template to re-key, so `resolveFoldPlan` must disqualify the whole
+ * plan here exactly as it already does when the drill step itself is
+ * multipart.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownChainedDependentMultipartChainStepActionSteps(): MulticallFixtureStep[];
+/**
+ * A single-shot search → per-item drill-down flow whose drill step's OWN
+ * response is foldable on its own terms — it carries `prices[]`, the same
+ * per-item results shape {@link buildMulticallSingleShotSearchDrillDownNoDecoyActionSteps}
+ * would fold directly — but is ALSO depended on by a THIRD step: the drill
+ * response's `priceToken` threads into a price-history call whose response
+ * carries the real per-item array this flow means to fold. `computeFoldChain`
+ * must extend the plan's chain to `[drillStepIndex, historyStepIndex]`
+ * instead of stopping at the drill step's own array, so
+ * `emitMultiStepExecuteHttp`'s fold loop renders BOTH calls per item and
+ * shape inference ({@link foldResponseBodyForShapeInference}) folds the
+ * chain's TERMINAL (history) response, not the drill step's own `prices[]`.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownChainedDependentActionSteps(): MulticallFixtureStep[];
+/**
+ * A nested-join-key sibling of {@link buildMulticallSingleShotSearchDrillDownChainedDependentActionSteps}:
+ * each primary `results[]` item carries its join key under a nested
+ * `identifiers` object (`{ identifiers: { sku } }`, matching
+ * {@link buildMulticallSingleShotSearchDrillDownNestedJoinFieldMultiItemActionSteps})
+ * rather than as a top-level field, AND (as in the chained-dependent fixture)
+ * the drill step's own response is foldable on its own terms but is ALSO
+ * depended on by a further step whose response carries the real per-item
+ * data. The primary item that threads the nested join is the SECOND item
+ * (`sku-b`), not the first, so `primaryMatchedItemIndex` must resolve by
+ * walking into each item's nested fields rather than assuming index 0, while
+ * `computeFoldChain` must still extend the chain past the drill step to its
+ * dependent follow-up rather than stopping at the drill step's own array.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownNestedJoinFieldChainedDependentActionSteps(): MulticallFixtureStep[];
+/**
+ * A search endpoint re-queried with two distinct bodies (`page 1`/`page 2`,
+ * satisfying {@link findRequeriedActions}'s re-query signature) whose
+ * responses BOTH independently contain a `results[]` item sharing the same
+ * `sku` — but at a different `price` (10 vs 12) — followed by a pricing
+ * drill-down call threading that `sku` via its URL query param. Every prior
+ * action is a fold-primary candidate for {@link detectDrillDownFoldPlan}, so
+ * both step 0 and step 1 satisfy the drill's join; the primary-candidate
+ * scan currently commits to the FIRST match (step 0, `price: 10`) and
+ * globally consumes the drill step, so step 1 — the fresher, `price: 12`
+ * re-queried occurrence — is never considered. `amount` in the drill
+ * response is the object-array field distinct from `price` that a fold
+ * assertion reads to observe which occurrence was actually folded onto.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownRequeriedPrimaryOverlapActionSteps(): MulticallFixtureStep[];
+/**
+ * A single primary search response carrying TWO genuinely independent
+ * object-array fields — `products[]` and `vendors[]` — each drilled by its
+ * own, unrelated later step (`sku` into a pricing lookup, `vendorId` into a
+ * vendor-detail lookup). `scanPrimaryCandidate`'s old candidatePool lock
+ * (recon-generate.ts:5411-5413) resolved only whichever array its FIRST
+ * qualifying drill-down threaded from (`products[]`, via r1) and then
+ * restricted every later candidate scan to that SAME array, so r2's
+ * `vendorId` thread into `vendors[]` was silently discarded — this fixture
+ * proves BOTH arrays fold independently, one FoldPlan per distinct
+ * `primaryArrayPath`.
+ */
+export declare function buildMulticallSingleShotSearchTwoIndependentArraysActionSteps(): MulticallFixtureStep[];
+/**
+ * A single primary search response carrying TWO independent object-array
+ * fields — `products[]`, whose `sku` join threads through the pricing call's
+ * own JSON body and so is structurally detectable, and `vendors[]`, whose
+ * `vendorId` join threads ONLY through the vendor-detail call's
+ * `X-Vendor-Id` request header, invisible to `collectRequestStringValues`
+ * and resolvable only via a flow-declared `foldReturn` spec naming `vendors`
+ * as its `resultsPath`. `mergeSpecPlanOntoSamePrimary` used to key its
+ * consumed-index check off `primaryStepIndex` alone, so the spec's plan —
+ * anchored on the SAME step 0 the structural heuristic had already resolved,
+ * but naming a DIFFERENT array — was wrongly treated as already consumed and
+ * silently dropped instead of appended.
+ */
+export declare function buildMulticallStructuralPlusSpecOnlySameStepActionSteps(): MulticallFixtureStep[];
+/**
+ * A 3-step chain where the drill step (`r1`) is a bare threading step — its
+ * response carries the join value (`statusToken`) but no object-array field
+ * at all, so it can't itself be the decoy. The decoy instead sits on the
+ * chain's terminal step (`r2`): a `warnings[]` array positioned BEFORE the
+ * real per-item `entries[]` array in key order, where `entries[]`'s items
+ * thread `r2`'s own `statusToken` request value and `warnings[]`'s items do
+ * not. {@link computeFoldChain}'s `selectDisambiguatedCandidate` call on
+ * this (non-immediate) chain hop must resolve `chainArrayPath` to `entries`
+ * on the threaded-join-fields match, not `warnings` for being found first.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownChainedDecoyOnChainTerminalActionSteps(): MulticallFixtureStep[];
+/**
+ * A single-shot search → per-item drill-down flow where the drill step's
+ * OWN response (`r1`) is entirely OPAQUE — a bare array holding a single
+ * token, satisfying neither `isObjectArrayItem` nor
+ * `findAllObjectArrayFields`, so `selectDisambiguatedCandidate` finds no
+ * candidate there at all — and is depended on by a THIRD step (`r2`) whose
+ * response carries the real per-item array this flow means to fold. Unlike
+ * {@link buildMulticallSingleShotSearchDrillDownChainedDependentActionSteps},
+ * whose `r1` is ALSO independently foldable, this fixture isolates the case
+ * where `computeFoldChain` has nothing to fall back on at the immediate hop
+ * and must extend the chain past it to `r2` to find any candidate at all.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownOpaqueIntermediateChainedDependentActionSteps(): MulticallFixtureStep[];
+/**
+ * A 4-step sibling of
+ * {@link buildMulticallSingleShotSearchDrillDownOpaqueIntermediateChainedDependentActionSteps}
+ * that inserts one more chain hop between the opaque token step and the real
+ * per-item terminal: a flat confirmation object (`r2`) that echoes back the
+ * token it was called with (excluded from its richness by
+ * `directPrimitiveChildCountExcludingEchoed`) alongside a boolean status flag
+ * AND a second, non-echoed token that threads onward into the real terminal
+ * step (`r3`). Both `r2` and `r3` land on the SAME richness — two non-echoed
+ * primitive fields apiece (`held`/`receiptToken` on `r2`, `event`/`ts` on
+ * `r3`) — so `computeFoldChain`'s strict `candidateRichness > chainTerminalRichness`
+ * comparison never lets `r3` displace `r2` as the chain terminal: a tie is
+ * exactly as "not richer" as a loss. This isolates the case where a
+ * side-effect confirmation hop that merely happens to match the real
+ * terminal's field count silently masks it, as opposed to
+ * {@link buildMulticallSingleShotSearchDrillDownOpaqueIntermediateChainedDependentActionSteps}'s
+ * opaque hop, which offers no candidate at all.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownRichnessTiedConfirmationHopChainedDependentActionSteps(): MulticallFixtureStep[];
+/**
+ * An array-wrapped sibling of
+ * {@link buildMulticallSingleShotSearchDrillDownOpaqueIntermediateChainedDependentActionSteps}:
+ * the opaque intermediate hop (`r1`) is identical, but the chain's TERMINAL
+ * hop (`r2`) threads `r1`'s produced `statusToken` wrapped inside a
+ * single-element request-body ARRAY (`{"tokens":["status-token-order-a"]}`,
+ * a bulk/batch-lookup request shape) instead of as a flat top-level scalar
+ * field. `computeFoldChain`'s structural `dependsOnChain` detection (which
+ * walks every request-body leaf regardless of nesting) resolves the chain
+ * correctly either way, so this isolates a DIFFERENT failure: the
+ * request-body render must still be able to thread `statusToken` into that
+ * array slot instead of freezing the whole array as an opaque caller-payload
+ * blob (`applyStructuredValuePayloadSubstitutions`'s "swallow whole
+ * caller-supplied array/object" mechanism, which runs BEFORE state
+ * threading and has no concept of "this array actually wraps a threaded
+ * dependent-drill-down join value").
+ */
+export declare function buildMulticallSingleShotSearchDrillDownArrayWrappedChainedDependentActionSteps(): MulticallFixtureStep[];
+/**
+ * Same array-wrapped-chained shape as
+ * {@link buildMulticallSingleShotSearchDrillDownArrayWrappedChainedDependentActionSteps},
+ * but the chain-produced value threaded from `r1` into `r2` is a bare JSON
+ * NUMBER (`12345678`) rather than a string. Unlike the primary-item join
+ * field covered by
+ * {@link buildMulticallSingleShotSearchDrillDownArrayWrappedNumericImmediateJoinFieldActionSteps},
+ * a chain-produced value must first be indexed as a threadable STATE value by
+ * `indexStateValues` before any array-wrap rendering question can even arise
+ * — and `indexStateValues` walks response bodies via `walkStringLeaves`,
+ * which yields string leaves only. A bare-number response leaf is therefore
+ * never indexed and never appears in `compileActionSteps`' `produces[]` at
+ * all, so `r2`'s templated body has no accessor to substitute and renders
+ * `{"tokens":[undefined]}` — invalid JSON, thrown as a fetch failure. This is
+ * a distinct, more fundamental gap than the array-wrap fix
+ * (`applyStructuredValuePayloadSubstitutions`, bugfix-001) addresses: it sits
+ * upstream, in state INDEXING, not in payload-substitution SPARING, and
+ * reproduces identically whether or not the terminal body is array-wrapped.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownArrayWrappedNumericChainedJoinFieldActionSteps(): MulticallFixtureStep[];
+/**
+ * A different sibling of the same array-wrapped-join-field failure family:
+ * here it's the IMMEDIATE drill step (`r1`), not a later chain hop, whose
+ * request body wraps the value it threads — but that value is the PRIMARY
+ * ITEM's own join field (`orderId`), not a prior step's produced response
+ * value. `applyStructuredValuePayloadSubstitutions`'s "spare a candidate
+ * already threaded" exception only recognized prior-step state values, so it
+ * still froze `r1`'s `{"orderIds":["order-a"]}` into an opaque
+ * `${JSON.stringify(payload.orderIds)}` blob, destroying the literal
+ * `"order-a"` text the fold-loop's own per-item `parameterize` pass (which
+ * runs even later, once rendering enters the loop) needs to find and swap
+ * for `${item.orderId}` — every iteration replayed the SAME captured order
+ * instead of each primary item's own.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownArrayWrappedImmediateJoinFieldActionSteps(): MulticallFixtureStep[];
+/**
+ * Same array-wrapped-immediate-join-field shape as
+ * {@link buildMulticallSingleShotSearchDrillDownArrayWrappedImmediateJoinFieldActionSteps},
+ * but the primary item's join field is a bare JSON NUMBER (`orderId: 101`)
+ * rather than a string. `walkStringLeaves` (used by the spare check in
+ * `applyStructuredValuePayloadSubstitutions`) silently skips number leaves,
+ * so a numeric join value wrapped in `{"orderIds":[101]}` was frozen into an
+ * opaque `${JSON.stringify(payload.orderIds)}` blob instead of being spared
+ * for the fold-loop's later per-item `parameterize` pass.
+ */
+export declare function buildMulticallSingleShotSearchDrillDownArrayWrappedNumericImmediateJoinFieldActionSteps(): MulticallFixtureStep[];
 //# sourceMappingURL=recon-generate-multicall-fixture.d.ts.map

package/dist/scripts/recon-generate-multicall-fixture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recon-generate-multicall-fixture.d.ts","sourceRoot":"","sources":["../../src/scripts/recon-generate-multicall-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;qEAIqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAgBV;AAOD,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,oBAAoB,CAQtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sCAAsC,IAAI,oBAAoB,EAAE,CAmC/E;AAED;;;;;GAKG;AACH,wBAAgB,mDAAmD,IAAI,oBAAoB,EAAE,CAU5F;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,EAAE,CAkCvD"}
+{"version":3,"file":"recon-generate-multicall-fixture.d.ts","sourceRoot":"","sources":["../../src/scripts/recon-generate-multicall-fixture.ts"],"names":[],"mappings":"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"}