effect-dynamodb 1.36.1 → 1.37.0

package/dist/internal/BoundQuery.d.ts

@@ -1,13 +1,17 @@
 /**
  * @internal BoundQuery — Fluent query builder with pre-resolved services.
  *
- * `BoundQuery<Model, SkRemaining, A>` wraps a `Query<A>` with a pre-resolved
+ * `BoundQuery<Model, SkRemaining, A, W>` wraps a `Query<A>` with a pre-resolved
  * `provide` function so all terminals return `Effect` with `R = never`.
  *
  * - Combinators return a new `BoundQuery` (immutable).
- * - `where` consumes `SkRemaining` → `BoundQuery<Model, never, A>`.
+ * - `where` consumes `SkRemaining` → `BoundQuery<Model, never, A, never>`.
  * - `where` is only available when `SkRemaining` is not `never`.
- * - Terminals: `fetch`, `collect`, `paginate`, `count`.
+ * - `within` (#171) bounds the sort key composites `W` names; it and `where`
+ *   exclude each other. On a Z-order accessor it bounds the dimensions and
+ *   prefix composites, and `zorder` chooses how the box is read.
+ * - Terminals: `fetch`, `collect`, `paginate`, `count`; `explain` describes
+ *   the plan without sending anything.
  */
 import type { ValidationError } from "@effect-dynamodb/schema/Errors.js";
 import { Effect, Stream } from "effect";
@@ -23,13 +27,13 @@ import type { PackedPath, Path, PathBuilder } from "./PathBuilder.js";
  *   `"todo" | "done"`) widen to `string`, so open bounds and `beginsWith`
  *   prefixes that are not themselves valid values still typecheck.
  * - **Every other composite** keeps its own type. That is the point of
- *   issue #114: `serializeValue` zero-pads numbers to 16 digits and bigints
- *   to 38 on the write path, so a stringly-typed `"42"` compares against
- *   `"0000000000000042"` and sorts *after* every stored value — a silent
- *   mismatch. Requiring the composite's own type also lets the operand run
- *   through the composite's own codec, which is what makes a transformed
- *   composite (`Schema.BigIntFromString`) compare against the value that was
- *   actually stored.
+ *   issue #114: `serializeValue` encodes numbers and bigints in numeric order
+ *   on the write path (`42` as `"0000000000000042"`), so a stringly-typed
+ *   `"42"` compares against that text and sorts *after* every stored value —
+ *   a silent mismatch. Requiring the composite's own type also lets the
+ *   operand run through the composite's own codec, which is what makes a
+ *   transformed composite (`Schema.BigIntFromString`) compare against the
+ *   value that was actually stored.
  */
 export type SkOperand<V> = [V] extends [string] ? string : V;
 /**
@@ -71,11 +75,11 @@ export interface SkConditionOps<SK = Record<string, unknown>> {
     readonly between: <V extends SK[keyof SK]>(field: V, low: SkOperand<V>, high: SkOperand<V>) => RawSortKeyCondition;
     readonly beginsWith: <V extends SK[keyof SK]>(field: V, prefix: SkOperand<V>) => RawSortKeyCondition;
 }
-export interface BoundQueryBase<Model, SkRemaining, A> {
+export interface BoundQueryBase<Model, SkRemaining, A, W extends WithinSpec<any, WithinKind> = never> {
     /** Add a filter expression (post-read). Callback or shorthand. */
     readonly filter: {
-        (fn: (t: PathBuilder<Model, Model, never>, ops: ConditionOps<Model>) => Expr): BoundQuery<Model, SkRemaining, A>;
-        (shorthand: ConditionShorthand): BoundQuery<Model, SkRemaining, A>;
+        (fn: (t: PathBuilder<Model, Model, never>, ops: ConditionOps<Model>) => Expr): BoundQuery<Model, SkRemaining, A, W>;
+        (shorthand: ConditionShorthand): BoundQuery<Model, SkRemaining, A, W>;
     };
     /**
      * Add a **client-side** predicate, evaluated on the decoded item inside the
@@ -97,37 +101,58 @@ export interface BoundQueryBase<Model, SkRemaining, A> {
      *
      * Cannot be combined with `.select()` — see EDD-9054.
      */
-    readonly filterBy: (predicate: (item: A) => boolean) => BoundQuery<Model, SkRemaining, A>;
+    readonly filterBy: (predicate: (item: A) => boolean) => BoundQuery<Model, SkRemaining, A, W>;
     /** Select specific attributes (projection). Callback or string array. */
     readonly select: {
-        (fn: (t: PathBuilder<Model, Model, never>) => ReadonlyArray<Path<Model, any, any> | PackedPath<Model, any, any>>): BoundQuery<Model, SkRemaining, Record<string, unknown>>;
-        (attributes: ReadonlyArray<string>): BoundQuery<Model, SkRemaining, Record<string, unknown>>;
+        (fn: (t: PathBuilder<Model, Model, never>) => ReadonlyArray<Path<Model, any, any> | PackedPath<Model, any, any>>): BoundQuery<Model, SkRemaining, Record<string, unknown>, W>;
+        (attributes: ReadonlyArray<string>): BoundQuery<Model, SkRemaining, Record<string, unknown>, W>;
     };
     /**
      * Return at most `n` items — a contract on results. The query accumulates
      * across as many requests as it takes, which is what makes it work under a
-     * `.filter()`. Use `.pageSize()` to size the requests themselves.
+     * `.filter()`, sizing each request from the pass rate the earlier ones
+     * showed. Use `.pageSize()` to size the requests themselves, or
+     * `.pageSize("natural")` for 1.36's sizing; a query with `.maxPages()` keeps
+     * 1.36's sizing too.
      */
-    readonly limit: (n: number) => BoundQuery<Model, SkRemaining, A>;
+    readonly limit: (n: number) => BoundQuery<Model, SkRemaining, A, W>;
     /**
      * Fetch in batches of `n` — sets DynamoDB's `Limit` (rows examined per
-     * request). A contract on round trips, not on what comes back.
+     * request). A contract on round trips, not on what comes back. `"natural"`
+     * sizes requests exactly as 1.36 did (natural 1 MB pages under a filter);
+     * any other string throws `[EDD-9095]`.
      */
-    readonly pageSize: (n: number) => BoundQuery<Model, SkRemaining, A>;
+    readonly pageSize: (size: number | "natural") => BoundQuery<Model, SkRemaining, A, W>;
+    /**
+     * Run `observer` after every request a terminal sends, with the `Limit` sent
+     * and the rows DynamoDB examined, the filter kept and the query accepted
+     * (`Query.QueryRequestEvent`). Its failure is a defect; DynamoDB calls it
+     * makes are not charged to the query's consumed capacity.
+     */
+    readonly onRequest: (observer: (event: Query.QueryRequestEvent) => Effect.Effect<void>) => BoundQuery<Model, SkRemaining, A, W>;
     /** Set the maximum number of DynamoDB pages to fetch. */
-    readonly maxPages: (n: number) => BoundQuery<Model, SkRemaining, A>;
+    readonly maxPages: (n: number) => BoundQuery<Model, SkRemaining, A, W>;
     /** Reverse the sort order (ScanIndexForward = false). */
-    readonly reverse: () => BoundQuery<Model, SkRemaining, A>;
-    /** Resume pagination from an opaque cursor. */
-    readonly startFrom: (cursor: string) => BoundQuery<Model, SkRemaining, A>;
+    readonly reverse: () => BoundQuery<Model, SkRemaining, A, W>;
+    /**
+     * Resume pagination from an opaque cursor. The cursor is decoded when a
+     * terminal runs: a malformed one fails it with a `ValidationError`
+     * (`[EDD-9094]`), as does a `.within()` cursor on a query without
+     * `.within()`. A `.within()` query also refuses one from another plan
+     * (other bounds, partition, direction or index declaration) or positioned
+     * outside its own. A query without `.within()` can't recognise another
+     * query's well-formed cursor: DynamoDB may reject it
+     * (`DynamoValidationError`) or the query resumes from it.
+     */
+    readonly startFrom: (cursor: string) => BoundQuery<Model, SkRemaining, A, W>;
     /**
      * Enable consistent reads. DynamoDB rejects them on a GSI, which it reads
      * only eventually consistently: the query then fails with a
      * `ValidationError` naming the index.
      */
-    readonly consistentRead: () => BoundQuery<Model, SkRemaining, A>;
+    readonly consistentRead: () => BoundQuery<Model, SkRemaining, A, W>;
     /** Skip the __edd_e__ entity type filter. */
-    readonly ignoreOwnership: () => BoundQuery<Model, SkRemaining, A>;
+    readonly ignoreOwnership: () => BoundQuery<Model, SkRemaining, A, W>;
     /** Execute a single page. Returns items + opaque cursor. */
     readonly fetch: () => Effect.Effect<Query.Page<A>, DynamoClientError | ValidationError, never>;
     /** Execute and collect all pages into a single array. */
@@ -143,6 +168,14 @@ export interface BoundQueryBase<Model, SkRemaining, A> {
      * that is why the error channel carries `ValidationError` (decode can fail).
      */
     readonly count: () => Effect.Effect<number, DynamoClientError | ValidationError, never>;
+    /**
+     * Describe what the terminals would send — the plan (`key`, `skip-scan`,
+     * `filter`, or a Z-order `naive` / `jump` / `precise` / `empty`), why it
+     * was chosen, the key ranges known up front, the fields
+     * checked per row and how requests are sized — without sending anything.
+     * A `startFrom` cursor is not read: the plan is described from its start.
+     */
+    readonly explain: () => Effect.Effect<Query.QueryExplain, never, never>;
 }
 export interface BoundQueryWithWhere<Model, SkRemaining, A> {
     /**
@@ -154,9 +187,143 @@ export interface BoundQueryWithWhere<Model, SkRemaining, A> {
      * .where((t, { eq }) => eq(t.status, "done"))
      * ```
      */
-    readonly where: (fn: (t: SkRemaining, ops: SkConditionOps<SkRemaining>) => RawSortKeyCondition) => BoundQuery<Model, never, A>;
+    readonly where: (fn: (t: SkRemaining, ops: SkConditionOps<SkRemaining>) => RawSortKeyCondition) => BoundQuery<Model, never, A, never>;
 }
-export type BoundQuery<Model, SkRemaining, A> = BoundQueryBase<Model, SkRemaining, A> & ([SkRemaining] extends [never] ? {} : BoundQueryWithWhere<Model, SkRemaining, A>);
+/** Which accessor a `.within()` belongs to. */
+export type WithinKind = "composite" | "zorder";
+/** What `.within()` accepts on an accessor (`bounds`), and the kind of accessor. */
+export interface WithinSpec<B, K extends WithinKind> {
+    readonly bounds: B;
+    readonly kind: K;
+}
+/** `.within()` consumed on a Z-order accessor: `.zorder()` stays available. */
+export type ZOrderApplied = WithinSpec<never, "zorder">;
+type BoundOperator = "eq" | "between" | "gt" | "gte" | "lt" | "lte" | "in";
+/**
+ * `T`, every other operator ruled out — so `{ eq, gte }` or `{ lt, lte }` is
+ * a type error rather than a union member that excess property checks pass.
+ */
+type Only<T> = T & {
+    readonly [K in Exclude<BoundOperator, keyof T>]?: never;
+};
+/** A lower bound: `gt` or `gte`, not both. */
+export type LowerBound<V> = Only<{
+    readonly gt: V;
+}> | Only<{
+    readonly gte: V;
+}>;
+/** An upper bound: `lt` or `lte`, not both. */
+export type UpperBound<V> = Only<{
+    readonly lt: V;
+}> | Only<{
+    readonly lte: V;
+}>;
+/**
+ * A `.within()` bound on one field: a value, an inclusive pair, or one or two
+ * open ends. Bounds are compared in key form — the value composed into the
+ * sort key (numbers padded, dates as stored, strings cased).
+ */
+export type RangeBound<V> = Only<{
+    readonly eq: V;
+}> | Only<{
+    readonly between: readonly [V, V];
+}> | LowerBound<V> | UpperBound<V> | Only<{
+    readonly gt: V;
+    readonly lt: V;
+}> | Only<{
+    readonly gt: V;
+    readonly lte: V;
+}> | Only<{
+    readonly gte: V;
+    readonly lt: V;
+}> | Only<{
+    readonly gte: V;
+    readonly lte: V;
+}>;
+/**
+ * The members of a literals dimension entry `D` over a field of type `V`: its
+ * declared `values`, else the field's members. `never` for any other entry (a
+ * range, a date-time window, a byte width).
+ */
+type LiteralsEntryMembers<D, V> = D extends string ? Exclude<V, undefined> : D extends {
+    readonly min: unknown;
+} | {
+    readonly max: unknown;
+} | {
+    readonly from: unknown;
+} | {
+    readonly unit: unknown;
+} | {
+    readonly bytes: unknown;
+} ? never : D extends {
+    readonly values: ReadonlyArray<infer L>;
+} ? L : Exclude<V, undefined>;
+/**
+ * A `.within()` bound on one dimension of a Z-order sort key (#171), declared
+ * as entry `D` over a field of type `V`: a {@link RangeBound} in the field's
+ * own type — for a literals dimension by its members' order — and, for a
+ * literals dimension only, a set of members.
+ */
+export type DimensionBound<D, V> = [LiteralsEntryMembers<D, V>] extends [never] ? RangeBound<V> : RangeBound<LiteralsEntryMembers<D, V>> | Only<{
+    readonly in: ReadonlyArray<LiteralsEntryMembers<D, V>>;
+}>;
+export interface WithinOptions {
+    /**
+     * Skip-scan probe budget per terminal call. After this many probes, the
+     * rest of the range is read once with the bounds checked per row. `0`
+     * never skips. Default 32.
+     */
+    readonly maxSkips?: number | undefined;
+}
+export interface BoundQueryWithin<Model, A, W extends WithinSpec<any, WithinKind>> {
+    /**
+     * Bound the sort key composites the accessor left open — any of them, not
+     * only the leading one:
+     *
+     * ```ts
+     * db.entities.Listings.byCategory({ category: "bikes" })
+     *   .within({ price: { gte: 100, lte: 500 } })
+     *   .collect()
+     * ```
+     *
+     * The bounds the key condition can reach are read by key. When open
+     * composites lie before the first bound, the query *skip-scans*: a one-row
+     * probe finds each distinct value of them (a *tuple*), and only that tuple's
+     * matching range is read — results come back in sort key order. Bounds the
+     * key condition can't express are checked on each row. A free-form string
+     * composite before the bound, or an index that also holds history rows,
+     * can't be skipped soundly: the range is read once with every bound checked
+     * per row (`explain()` says which plan runs, and why).
+     *
+     * On a Z-order accessor (#171), the dimensions bound a box — any of them, in
+     * the fields' own types (`in` for a `literals` dimension) — and the prefix
+     * composites take one exact value each. The box is read as address ranges
+     * (`.zorder()` picks how); a prefix composite left out is skip-scanned.
+     * Every bound is exact: a `FilterExpression` where DynamoDB's comparison
+     * agrees with the dimension's order, a per-row check where it doesn't.
+     *
+     * Excludes `.where()`. Values are the composites' own types.
+     */
+    readonly within: (bounds: W["bounds"], options?: WithinOptions) => BoundQuery<Model, never, A, W["kind"] extends "zorder" ? ZOrderApplied : never>;
+}
+export interface BoundQueryZOrder<Model, SkRemaining, A, W extends WithinSpec<any, WithinKind>> {
+    /**
+     * How the box `.within()` bounds is read — before or after `.within()`;
+     * later calls merge over earlier ones:
+     *
+     * ```ts
+     * db.entities.Listings.byFacets({ region: "north" })
+     *   .within({ price: { lte: 500_000 }, bedrooms: { gte: 3 } })
+     *   .zorder({ strategy: "precise", maxRanges: 32 })
+     *   .collect()
+     * ```
+     *
+     * An unknown `strategy`, or a `maxRanges` / `concurrency` that isn't a
+     * positive integer, throws `[EDD-9095]`.
+     */
+    readonly zorder: (options: Query.ZOrderOptions) => BoundQuery<Model, SkRemaining, A, W>;
+}
+export type BoundQuery<Model, SkRemaining, A, W extends WithinSpec<any, WithinKind> = never> = BoundQueryBase<Model, SkRemaining, A, W> & ([SkRemaining] extends [never] ? {} : BoundQueryWithWhere<Model, SkRemaining, A>) & ([W] extends [never] ? {} : [W["bounds"]] extends [never] ? {} : BoundQueryWithin<Model, A, W>) & ([W] extends [never] ? {} : W["kind"] extends "zorder" ? BoundQueryZOrder<Model, SkRemaining, A, W> : {});
 /** @internal */
 export interface BoundQueryConfig<Model> {
     readonly pathBuilder: PathBuilder<Model, Model, never>;
@@ -180,9 +347,26 @@ export interface BoundQueryConfig<Model> {
      *
      * `field` is the SK composite name the caller targeted (`t.status` →
      * `"status"`), or `undefined` when the callback did not go through the sk
-     * accessor.
+     * accessor. `undefined` when no stored key satisfies the condition: the
+     * query plans `empty` and sends nothing (#171).
+     */
+    readonly composeSkCondition?: (condition: RawSortKeyCondition, field: string | undefined) => Query.SortKeyCondition | undefined;
+    /**
+     * Optional: the 1.36 key `.where()`'s condition also reads (#171) — for an
+     * `eq` / `beginsWith` that extends an accessor's pins, the key 1.36
+     * composed for them. Called after {@link composeSkCondition} accepted the
+     * condition; `undefined` reads only the current key.
+     */
+    readonly where136?: (condition: RawSortKeyCondition, field: string | undefined) => Query.KeyPass | undefined;
+    /**
+     * Optional: plan `.within(bounds)` on the query (#171) — an accessor's own
+     * composites and encoders turn the bounds into key ranges and row checks.
+     * Throws `[EDD-9093]` / `[EDD-9050]` for bounds it can't use. Without it,
+     * `.within()` is refused (collections, scans).
      */
-    readonly composeSkCondition?: (condition: RawSortKeyCondition, field: string | undefined) => Query.SortKeyCondition;
+    readonly planWithin?: <X>(query: Query.Query<X>, bounds: Record<string, unknown>, options: WithinOptions | undefined) => Query.Query<X>;
+    /** Optional: the accessor reads a Z-order sort key, so `.zorder()` applies (#171). */
+    readonly zorder?: boolean | undefined;
     /**
      * Optional: how `collect()` shapes the items — a collection groups them by
      * member. Carried through every combinator, so `.filter().collect()` groups
@@ -230,13 +414,20 @@ export declare const collectionNaming: (members: ReadonlyArray<{
 export declare class BoundQueryImpl<Model, SkRemaining, A> {
     readonly _query: Query.Query<A>;
     readonly _config: BoundQueryConfig<Model>;
-    constructor(_query: Query.Query<A>, _config: BoundQueryConfig<Model>);
+    /** The sort key constraint already applied: `.where()` and `.within()` exclude each other. */
+    readonly _applied?: "where" | "within" | undefined;
+    constructor(_query: Query.Query<A>, _config: BoundQueryConfig<Model>, 
+    /** The sort key constraint already applied: `.where()` and `.within()` exclude each other. */
+    _applied?: "where" | "within" | undefined);
     where(fn: (t: SkRemaining, ops: SkConditionOps<SkRemaining>) => RawSortKeyCondition): BoundQueryImpl<Model, never, A>;
+    within(bounds: Record<string, unknown>, options?: WithinOptions): BoundQueryImpl<Model, never, A>;
+    zorder(options: Query.ZOrderOptions): BoundQueryImpl<Model, SkRemaining, A>;
     filter(fnOrShorthand: ((t: PathBuilder<Model, Model, never>, ops: ConditionOps<Model>) => Expr) | ConditionShorthand): BoundQueryImpl<Model, SkRemaining, A>;
     filterBy(predicate: (item: A) => boolean): BoundQueryImpl<Model, SkRemaining, A>;
     select(fnOrAttrs: ((t: PathBuilder<Model, Model, never>) => ReadonlyArray<Path<Model, any, any> | PackedPath<Model, any, any>>) | ReadonlyArray<string>): BoundQueryImpl<Model, SkRemaining, Record<string, unknown>>;
     limit(n: number): BoundQueryImpl<Model, SkRemaining, A>;
-    pageSize(n: number): BoundQueryImpl<Model, SkRemaining, A>;
+    pageSize(size: number | "natural"): BoundQueryImpl<Model, SkRemaining, A>;
+    onRequest(observer: (event: Query.QueryRequestEvent) => Effect.Effect<void>): BoundQueryImpl<Model, SkRemaining, A>;
     maxPages(n: number): BoundQueryImpl<Model, SkRemaining, A>;
     reverse(): BoundQueryImpl<Model, SkRemaining, A>;
     startFrom(cursor: string): BoundQueryImpl<Model, SkRemaining, A>;
@@ -252,9 +443,12 @@ export declare class BoundQueryImpl<Model, SkRemaining, A> {
     collect(): Effect.Effect<Array<A>, DynamoClientError | ValidationError, never>;
     paginate(): Stream.Stream<A, DynamoClientError | ValidationError, never>;
     count(): Effect.Effect<number, DynamoClientError | ValidationError, never>;
+    /** No I/O, so no operation, span or client: the plan is described from the query alone. */
+    explain(): Effect.Effect<Query.QueryExplain, never, never>;
 }
 /**
  * @internal Create a BoundQuery wrapping a Query with pre-resolved config.
  */
 export declare const makeBoundQuery: <Model, SkRemaining, A>(query: Query.Query<A>, config: BoundQueryConfig<Model>) => BoundQuery<Model, SkRemaining, A>;
+export {};
 //# sourceMappingURL=BoundQuery.d.ts.map

package/dist/internal/BoundQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoundQuery.d.ts","sourceRoot":"","sources":["../../src/internal/BoundQuery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BoundQuery.d.ts","sourceRoot":"","sources":["../../src/internal/BoundQuery.ts"],"names":[],"mappings":"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"}

package/dist/internal/BoundQuery.js

@@ -1,13 +1,17 @@
 /**
  * @internal BoundQuery — Fluent query builder with pre-resolved services.
  *
- * `BoundQuery<Model, SkRemaining, A>` wraps a `Query<A>` with a pre-resolved
+ * `BoundQuery<Model, SkRemaining, A, W>` wraps a `Query<A>` with a pre-resolved
  * `provide` function so all terminals return `Effect` with `R = never`.
  *
  * - Combinators return a new `BoundQuery` (immutable).
- * - `where` consumes `SkRemaining` → `BoundQuery<Model, never, A>`.
+ * - `where` consumes `SkRemaining` → `BoundQuery<Model, never, A, never>`.
  * - `where` is only available when `SkRemaining` is not `never`.
- * - Terminals: `fetch`, `collect`, `paginate`, `count`.
+ * - `within` (#171) bounds the sort key composites `W` names; it and `where`
+ *   exclude each other. On a Z-order accessor it bounds the dimensions and
+ *   prefix composites, and `zorder` chooses how the box is read.
+ * - Terminals: `fetch`, `collect`, `paginate`, `count`; `explain` describes
+ *   the plan without sending anything.
  */
 import * as KeyComposer from "@effect-dynamodb/schema/KeyComposer.js";
 import { Effect, Stream } from "effect";
@@ -50,8 +54,8 @@ const renamePaths = (node, resolve) => {
  * composing keys — and then composes, so both sides of the comparison come out
  * of one pipeline (issues #114 and the encoded/decoded gap it exposed).
  * Without a hook there is no model to consult, so `KeyComposer.serializeValue`
- * is applied directly: the same zero-padding / ISO formatting the write path
- * uses. Casing is never applied here — it belongs to key composition.
+ * is applied directly: the same numeric encoding / ISO formatting the write
+ * path uses. Casing is never applied here — it belongs to key composition.
  *
  * The callback is invoked synchronously and exactly once, so a closed-over
  * mutable slot is safe here.
@@ -252,23 +256,90 @@ const ABSENT_ATTRIBUTE = "__edd_absent__";
 // ---------------------------------------------------------------------------
 // BoundQuery implementation
 // ---------------------------------------------------------------------------
+/** `[EDD-9093]`: `.where()` and `.within()` exclude each other, and `.within()` applies once. */
+const refuseWithin = (what) => {
+    throw new Error(`[EDD-9093] .${what}: a query takes one sort key constraint — either .where() on the ` +
+        `next open composite, or one .within() bounding any of them.`);
+};
+const ZORDER_STRATEGIES = new Set(["auto", "naive", "jump", "precise"]);
+/**
+ * `.zorder(options)`'s options (#171), the ones given: library options that
+ * can't be honoured throw `[EDD-9095]`; `pageSize` is DynamoDB's `Limit`,
+ * passed on unchecked as `pageSize(n)`'s number is.
+ */
+const zorderOptions = (options) => {
+    const refuse = (what) => {
+        throw new Error(`[EDD-9095] .zorder() ${what}`);
+    };
+    if (typeof options !== "object" || options === null || Array.isArray(options)) {
+        return refuse("takes an object of options: { strategy, pageSize, maxRanges, concurrency }.");
+    }
+    const given = Object.fromEntries(Object.entries(options).filter(([, value]) => value !== undefined));
+    const unknown = Object.keys(given).filter((key) => !["strategy", "pageSize", "maxRanges", "concurrency"].includes(key));
+    if (unknown.length > 0) {
+        return refuse(`has no option ${unknown.map((key) => JSON.stringify(key)).join(", ")}.`);
+    }
+    if (given.strategy !== undefined && !ZORDER_STRATEGIES.has(given.strategy)) {
+        return refuse(`strategy ${JSON.stringify(given.strategy)} is not one of "auto", "naive", "jump", "precise".`);
+    }
+    for (const key of ["maxRanges", "concurrency"]) {
+        const value = given[key];
+        if (value !== undefined && !(Number.isInteger(value) && value > 0)) {
+            return refuse(`${key} ${JSON.stringify(value)} is not a positive integer.`);
+        }
+    }
+    return given;
+};
 /** @internal */
 export class BoundQueryImpl {
     _query;
     _config;
-    constructor(_query, _config) {
+    _applied;
+    constructor(_query, _config, 
+    /** The sort key constraint already applied: `.where()` and `.within()` exclude each other. */
+    _applied) {
         this._query = _query;
         this._config = _config;
+        this._applied = _applied;
     }
     // --- where ---
     where(fn) {
+        if (this._applied === "within")
+            refuseWithin("where() after .within()");
         const skAccessor = (this._config.skFields ? buildSkAccessor(this._config.skFields) : {});
         const { ops, targetField } = makeSkConditionOps();
         const condition = fn(skAccessor, ops);
         const finalCondition = this._config.composeSkCondition
             ? this._config.composeSkCondition(condition, targetField())
             : serializeRawCondition(condition);
-        return new BoundQueryImpl(Query.where(this._query, finalCondition), this._config);
+        if (finalCondition === undefined) {
+            return new BoundQueryImpl(Query.planEmpty(this._query), this._config, "where");
+        }
+        const key136 = this._config.where136?.(condition, targetField());
+        return new BoundQueryImpl(Query.alsoRead136(Query.where(this._query, finalCondition), key136), this._config, "where");
+    }
+    // --- within ---
+    within(bounds, options) {
+        if (this._applied !== undefined) {
+            refuseWithin(this._applied === "where" ? "within() after .where()" : "a second .within()");
+        }
+        const maxSkips = options?.maxSkips;
+        if (maxSkips !== undefined && !(Number.isInteger(maxSkips) && maxSkips >= 0)) {
+            throw new Error(`[EDD-9095] .within() maxSkips ${JSON.stringify(maxSkips)} is not a probe budget: ` +
+                `pass a non-negative integer (0 never skips; the default is 32).`);
+        }
+        const plan = this._config.planWithin;
+        if (plan === undefined)
+            refuseWithin("within() on a query without sort key composites to bound");
+        return new BoundQueryImpl(plan(this._query, bounds, options), this._config, "within");
+    }
+    // --- zorder ---
+    zorder(options) {
+        if (this._config.zorder !== true) {
+            throw new Error(`[EDD-9095] .zorder() applies only to a Z-order index accessor: this query's index ` +
+                `has no Z-order sort key.`);
+        }
+        return new BoundQueryImpl(Query.plan(this._query, { zorder: zorderOptions(options) }), this._config, this._applied);
     }
     // --- filter ---
     filter(fnOrShorthand) {
@@ -278,11 +349,11 @@ export class BoundQueryImpl {
                 parseSimpleShorthand(fnOrShorthand);
         // Paths name the stored attributes of renamed fields.
         const stored = this._config.renameExpr === undefined ? expr : this._config.renameExpr(expr);
-        return new BoundQueryImpl(Query.filterExpr(this._query, stored), this._config);
+        return new BoundQueryImpl(Query.filterExpr(this._query, stored), this._config, this._applied);
     }
     // --- filterBy ---
     filterBy(predicate) {
-        return new BoundQueryImpl(Query.filterBy(this._query, predicate), this._config);
+        return new BoundQueryImpl(Query.filterBy(this._query, predicate), this._config, this._applied);
     }
     // --- select ---
     select(fnOrAttrs) {
@@ -293,30 +364,33 @@ export class BoundQueryImpl {
             ]
             : [fnOrAttrs.map((attr) => [attr]), "attributes"];
         const select = this._config.selectAs ?? plainSelect;
-        return new BoundQueryImpl(select(this._query, paths, form), this._config);
+        return new BoundQueryImpl(select(this._query, paths, form), this._config, this._applied);
     }
     // --- pagination & ordering ---
     limit(n) {
-        return new BoundQueryImpl(Query.limit(this._query, n), this._config);
+        return new BoundQueryImpl(Query.limit(this._query, n), this._config, this._applied);
     }
-    pageSize(n) {
-        return new BoundQueryImpl(Query.pageSize(this._query, n), this._config);
+    pageSize(size) {
+        return new BoundQueryImpl(Query.pageSize(this._query, size), this._config, this._applied);
+    }
+    onRequest(observer) {
+        return new BoundQueryImpl(Query.onRequest(this._query, observer), this._config, this._applied);
     }
     maxPages(n) {
-        return new BoundQueryImpl(Query.maxPages(this._query, n), this._config);
+        return new BoundQueryImpl(Query.maxPages(this._query, n), this._config, this._applied);
     }
     reverse() {
-        return new BoundQueryImpl(Query.reverse(this._query), this._config);
+        return new BoundQueryImpl(Query.reverse(this._query), this._config, this._applied);
     }
     startFrom(cursor) {
-        return new BoundQueryImpl(Query.startFrom(this._query, cursor), this._config);
+        return new BoundQueryImpl(Query.startFrom(this._query, cursor), this._config, this._applied);
     }
     // --- read options ---
     consistentRead() {
-        return new BoundQueryImpl(Query.consistentRead(this._query), this._config);
+        return new BoundQueryImpl(Query.consistentRead(this._query), this._config, this._applied);
     }
     ignoreOwnership() {
-        return new BoundQueryImpl(Query.ignoreOwnership(this._query), this._config);
+        return new BoundQueryImpl(Query.ignoreOwnership(this._query), this._config, this._applied);
     }
     // --- terminals ---
     /**
@@ -359,6 +433,10 @@ export class BoundQueryImpl {
     count() {
         return this._run(Query.count(this._query));
     }
+    /** No I/O, so no operation, span or client: the plan is described from the query alone. */
+    explain() {
+        return Query.explain(this._query);
+    }
 }
 // ---------------------------------------------------------------------------
 // Factory functions