zonemapdb 0.8.0

package/dist/client.js

@@ -0,0 +1,584 @@
+import { fetchIndexChunk } from "./index-fetch.js";
+import { ZonemapDbError } from "./errors.js";
+import { parseCorruptible } from "./fetch-file.js";
+import { matchesWhere } from "./filter.js";
+import { datasetCompression, fetchManifest, manifestReferences } from "./manifest.js";
+import { chunksForFilter, decodeIndexChunk, reverseString, blockIndicesForFilter, trigramsOf, } from "./secondary-index.js";
+import { fetchBlockRecords } from "./block-fetch.js";
+import { assertWhereHasPruning, compactWhere, } from "./types.js";
+import { candidateBlockIndices, pairCandidateBlockIndices, } from "./zonemap.js";
+import { fetchZonemapSidecar } from "./zonemap-fetch.js";
+/** Only equals/in/startsWith prune via the inverted index (ADR-0003 §7); other keys (e.g. `not`) don't. */
+function secondaryFilterOf(rawFilter) {
+    const { equals, in: inValues, startsWith } = rawFilter;
+    if (equals === undefined && inValues === undefined && startsWith === undefined)
+        return undefined;
+    return { equals, in: inValues, startsWith: startsWith };
+}
+/**
+ * The part of a filter a per-block [min,max] pair can prune: point lookups plus ranges. Ranges are
+ * zonemap-only — the inverted index is a dictionary of exact values, and a range has no key to look
+ * up — so they are extracted separately from `secondaryFilterOf` rather than widening it.
+ */
+function pairFilterOf(rawFilter) {
+    const { equals, in: inValues, gt, gte, lt, lte } = rawFilter;
+    if (equals === undefined && inValues === undefined && gt === undefined && gte === undefined && lt === undefined && lte === undefined) {
+        return undefined;
+    }
+    return { equals, in: inValues, gt, gte, lt, lte };
+}
+/**
+ * A multi-valued field's index is built over its elements, so pruning reads through `some`/`every`
+ * to their element filter (T7, ADR-0010): `"x"` unwraps to `{ equals: "x" }`, an object form is used
+ * as-is.
+ */
+function unwrapElementFilter(elementFilter) {
+    if (typeof elementFilter === "object" && elementFilter !== null)
+        return elementFilter;
+    return { equals: elementFilter };
+}
+/** `a ∪ b` over block ordinals. */
+function unionSets(a, b) {
+    return new Set([...a, ...b]);
+}
+/**
+ * `callerSignal` is the query's `signal` option: when it fires, the same controller that the first
+ * failure fires aborts every fetch still pending in this query.
+ */
+function makeFetchContext(basePath, fetchImpl, callerSignal) {
+    const controller = new AbortController();
+    const onCallerAbort = () => controller.abort(callerSignal.reason);
+    // An abort event has already fired for a signal that is aborted by now, so the listener would never run.
+    if (callerSignal?.aborted)
+        onCallerAbort();
+    else
+        callerSignal?.addEventListener("abort", onCallerAbort, { once: true });
+    const abortAndRethrow = (error) => {
+        controller.abort(error);
+        throw error;
+    };
+    return {
+        basePath,
+        fetchImpl,
+        chunkCache: new Map(),
+        zonemapCache: new Map(),
+        signal: controller.signal,
+        track: (promise) => promise.catch(abortAndRethrow),
+        trackSync: (fn) => {
+            try {
+                return fn();
+            }
+            catch (error) {
+                return abortAndRethrow(error);
+            }
+        },
+        dispose: () => callerSignal?.removeEventListener("abort", onCallerAbort),
+    };
+}
+function abortedError(signal) {
+    return new ZonemapDbError({
+        code: "ABORTED",
+        message: "zonemapdb: the query was cancelled by its signal, and its pending fetches were aborted. Nothing is wrong " +
+            "with the deploy; if a newer query superseded this one, ignore it.",
+        cause: signal.reason,
+    });
+}
+/**
+ * Settles with `promise`, or rejects with ABORTED as soon as `signal` fires, whichever comes first.
+ * Used for waits a query doesn't own: the shared manifest fetch keeps going for the other queries,
+ * and an injected fetch that ignores its signal can't hold a cancelled query open.
+ */
+function raceAbort(promise, signal) {
+    if (signal === undefined)
+        return promise;
+    if (signal.aborted) {
+        // Nobody else may be listening to `promise`; its later rejection mustn't surface as unhandled.
+        promise.catch(() => { });
+        return Promise.reject(abortedError(signal));
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => reject(abortedError(signal));
+        signal.addEventListener("abort", onAbort, { once: true });
+        promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", onAbort));
+    });
+}
+/**
+ * Resolves a secondary field's zonemap — already-inline `pairs`, or a lazy fetch of its sidecar
+ * the first time this query touches it (ADR-0003 §3: root stays "routing-essential only", rich
+ * pruning data is pay-on-use). `undefined` when the field carries no zonemap entry at all (e.g.
+ * it isn't indexed, or is the sort field, which is pruned separately via `splitPoints`).
+ */
+async function resolveSecondaryZonemap(manifest, ctx, field) {
+    const entry = manifest.zonemap[field];
+    if (!entry || "splitPoints" in entry)
+        return undefined;
+    if (!("sidecar" in entry))
+        return entry;
+    let promise = ctx.zonemapCache.get(entry.sidecar);
+    if (!promise) {
+        promise = ctx.track(fetchZonemapSidecar(ctx.basePath, entry.sidecar, ctx.fetchImpl, ctx.signal));
+        ctx.zonemapCache.set(entry.sidecar, promise);
+    }
+    return await promise;
+}
+/** `a ∩ b` over block ordinals — the one intersection shape every AND-combination step shares. */
+function intersectSets(a, b) {
+    return new Set([...a].filter((i) => b.has(i)));
+}
+/** Fetches+decodes the chunks a filter could touch, resolving them into a candidate block set. */
+async function candidatesFromChunkedIndex(ctx, chunks, kind, filter) {
+    const blockIndices = new Set();
+    for (const chunkDir of chunksForFilter(chunks, filter)) {
+        let chunkPromise = ctx.chunkCache.get(chunkDir.file);
+        if (!chunkPromise) {
+            chunkPromise = ctx.track(fetchIndexChunk(ctx.basePath, chunkDir.file, ctx.fetchImpl, ctx.signal));
+            ctx.chunkCache.set(chunkDir.file, chunkPromise);
+        }
+        const awaitedChunk = await chunkPromise;
+        const decoded = ctx.trackSync(() => parseCorruptible(`${ctx.basePath}/${chunkDir.file}`, () => decodeIndexChunk(awaitedChunk, kind)));
+        for (const blockIndex of blockIndicesForFilter(decoded, filter))
+            blockIndices.add(blockIndex);
+    }
+    return blockIndices;
+}
+/**
+ * `contains`'s candidate set (ADR-0003 §7): AND-intersect the block sets of
+ * every query trigram — any block truly holding a match has ALL of them
+ * present somewhere, so intersecting can only over-approximate, never miss.
+ * A query shorter than 3 chars has no trigrams to route on — `undefined`
+ * signals "can't prune via this field," same as an absent index.
+ */
+async function containsCandidates(ctx, chunks, substring) {
+    const grams = trigramsOf(substring);
+    if (grams.length === 0)
+        return undefined;
+    let result;
+    for (const gram of grams) {
+        const gramSet = await candidatesFromChunkedIndex(ctx, chunks, "string", { equals: gram });
+        result = result === undefined ? gramSet : intersectSets(result, gramSet);
+        if (result.size === 0)
+            break;
+    }
+    return result;
+}
+/**
+ * Fetches+intersects EVERY structure one secondary field's filter constrains
+ * — the base index (equals/in/startsWith), the reversed index (endsWith),
+ * and the trigram index (contains) are independent structures, so each
+ * contributes its own candidate set and they AND together (ADR-0003 §7/§9).
+ */
+async function secondaryFieldCandidates(manifest, ctx, field, rawFilter) {
+    const indexDescriptor = manifest.indexes[field];
+    if (!indexDescriptor)
+        return undefined;
+    const fieldMeta = manifest.schema.fields[field];
+    if (fieldMeta.multi)
+        return listFieldCandidates(manifest, ctx, field, indexDescriptor, rawFilter);
+    return valueFilterCandidates(manifest, ctx, field, indexDescriptor, rawFilter);
+}
+/**
+ * A multi-valued field's candidates: each list operator present contributes a set, and they AND
+ * together like any keys on one field (ADR-0010 §2/§4). An operator that can't prune contributes
+ * nothing rather than an empty set.
+ */
+async function listFieldCandidates(manifest, ctx, field, indexDescriptor, rawFilter) {
+    const { some, every, hasEvery, isEmpty } = rawFilter;
+    // Missing on a manifest built before ADR-0010: unknown, so isEmpty/every can't prune — never "none".
+    const emptyBlocks = indexDescriptor.emptyBlocks && new Set(indexDescriptor.emptyBlocks);
+    const sets = [];
+    if (some !== undefined) {
+        const someSet = await valueFilterCandidates(manifest, ctx, field, indexDescriptor, unwrapElementFilter(some));
+        if (someSet)
+            sets.push(someSet);
+    }
+    // A list passing `every: F` either has an element — which satisfies F, so it sits in `some: F`'s
+    // postings — or is empty, so it sits in an emptyBlocks block.
+    if (every !== undefined && emptyBlocks) {
+        const elementSet = await valueFilterCandidates(manifest, ctx, field, indexDescriptor, unwrapElementFilter(every));
+        if (elementSet)
+            sets.push(unionSets(elementSet, emptyBlocks));
+    }
+    // Every value must be present, so a match sits in every value's postings: intersect, not union.
+    if (hasEvery !== undefined && hasEvery.length > 0) {
+        const kind = manifest.schema.fields[field].kind;
+        for (const value of hasEvery) {
+            sets.push(await candidatesFromChunkedIndex(ctx, indexDescriptor.chunks, kind, { equals: value }));
+        }
+    }
+    if (isEmpty === true && emptyBlocks)
+        sets.push(emptyBlocks);
+    if (sets.length === 0)
+        return undefined;
+    return sets.reduce(intersectSets);
+}
+/** One value filter's candidates — a scalar field's filter, or a multi field's element filter. */
+async function valueFilterCandidates(manifest, ctx, field, indexDescriptor, effectiveFilter) {
+    const kind = manifest.schema.fields[field].kind;
+    const { endsWith, contains } = effectiveFilter;
+    const sets = [];
+    // ADR-0003 §6 step 1: free zonemap pruning before the pay-on-use index-chunk fetch. The zonemap can
+    // only over-approximate (never wrongly excludes a real match — ADR-0003 §2), so intersecting it in
+    // never changes the final (already-exact) index result; it's how a secondary field's zonemap —
+    // inline or a lazily-fetched sidecar (T13, ADR-0003 §3) — gets exercised at all, since equals/in are
+    // otherwise resolved exactly via the index alone. For a RANGE it is the only pruning available, and
+    // the pairs are exact for number/date (only string pairs are truncated), so it prunes precisely.
+    const pairFilter = pairFilterOf(effectiveFilter);
+    if (pairFilter) {
+        const zonemap = await resolveSecondaryZonemap(manifest, ctx, field);
+        const zonemapSet = zonemap && pairCandidateBlockIndices(zonemap.pairs, pairFilter);
+        if (zonemapSet)
+            sets.push(zonemapSet);
+    }
+    // Step 2: the inverted index, for the shapes that have a dictionary key to look up.
+    const baseFilter = secondaryFilterOf(effectiveFilter);
+    if (baseFilter) {
+        sets.push(await candidatesFromChunkedIndex(ctx, indexDescriptor.chunks, kind, baseFilter));
+    }
+    if (endsWith !== undefined && indexDescriptor.reversed) {
+        sets.push(await candidatesFromChunkedIndex(ctx, indexDescriptor.reversed.chunks, "string", {
+            startsWith: reverseString(endsWith),
+        }));
+    }
+    if (contains !== undefined && indexDescriptor.trigram) {
+        const trigramSet = await containsCandidates(ctx, indexDescriptor.trigram.chunks, contains);
+        if (trigramSet)
+            sets.push(trigramSet);
+    }
+    if (sets.length === 0)
+        return undefined;
+    return sets.reduce(intersectSets);
+}
+/**
+ * Block ordinals surviving zonemap + postings pruning for `where`, ascending.
+ * Free zonemap pruning on the sort field first (ADR-0003 §6 step 1), then
+ * fetch+intersect the index chunks for every equals/in/startsWith-constrained
+ * secondary field (step 2) — cheap chunk fetches before blocks.
+ */
+async function candidateIndicesForWhere(manifest, ctx, where) {
+    const sortField = manifest.dataset.sortField;
+    const sortFieldFilter = where?.[sortField];
+    const sortZonemap = manifest.zonemap[sortField];
+    const splitPoints = sortZonemap?.splitPoints ?? [];
+    let candidateSet = new Set(candidateBlockIndices(splitPoints, sortFieldFilter));
+    const secondaryEntries = Object.entries(where ?? {}).filter(([field]) => field !== sortField);
+    const secondarySets = await Promise.all(secondaryEntries.map(([field, filter]) => secondaryFieldCandidates(manifest, ctx, field, filter)));
+    for (const set of secondarySets) {
+        if (set === undefined)
+            continue;
+        candidateSet = intersectSets(candidateSet, set);
+    }
+    return [...candidateSet].sort((a, b) => a - b);
+}
+/**
+ * Approximate upper bound with zero data-block fetches (ADR-0008 §2): sum
+ * `manifest.blocks[i].count` over the blocks surviving zonemap + postings
+ * pruning. `exact: true` only for an empty where and pruned-to-zero (§3).
+ */
+async function executeCount(manifest, ctx, where) {
+    if (!where || Object.keys(where).length === 0) {
+        return { count: manifest.dataset.recordCount, exact: true };
+    }
+    const candidateIndices = await candidateIndicesForWhere(manifest, ctx, where);
+    if (candidateIndices.length === 0)
+        return { count: 0, exact: true };
+    let count = 0;
+    for (const index of candidateIndices)
+        count += manifest.blocks[index].count;
+    return { count, exact: false };
+}
+const DEFAULT_MAX_RESULTS = 10_000;
+/** The explicit-limit half of the maxResults guardrail — pure validation, runs before any fetch. */
+function assertLimitWithinCeiling(limit, maxResults) {
+    if (limit !== undefined && limit > maxResults) {
+        throw new ZonemapDbError({
+            code: "LIMIT_EXCEEDED",
+            message: `zonemapdb: limit ${limit} exceeds the maxResults ceiling ${maxResults} — ` +
+                `lower the query's limit, or raise maxResults in connect() if you truly need more.`,
+        });
+    }
+}
+/**
+ * `orderBy` may name any indexed field, not just the sort field (ADR-0001 item 42). Records are
+ * already fully materialized in memory by the time this runs, so a plain multi-key stable sort
+ * (iterating `orderBy`'s own key order for tiebreaks) is correct and doesn't disturb the exact
+ * `hasMore` accounting, which only depends on `matches.length`, not on ordering.
+ */
+function compareByOrderBy(a, b, orderBy) {
+    for (const [field, direction] of Object.entries(orderBy)) {
+        const av = a[field];
+        const bv = b[field];
+        if (av === bv)
+            continue;
+        let cmp;
+        if (av === undefined || av === null)
+            cmp = -1;
+        else if (bv === undefined || bv === null)
+            cmp = 1;
+        else if (av < bv)
+            cmp = -1;
+        else if (av > bv)
+            cmp = 1;
+        else
+            cmp = 0;
+        if (cmp !== 0)
+            return direction === "desc" ? -cmp : cmp;
+    }
+    return 0;
+}
+function fetchBlockAt(manifest, ctx, index) {
+    return ctx.track(fetchBlockRecords(ctx.basePath, manifest.blocks[index].hash, manifest.blocks.length, datasetCompression(manifest), ctx.fetchImpl, ctx.signal));
+}
+/**
+ * Blocks per round of the walk. Fetching strictly one at a time would minimise bytes but serialise a
+ * round trip per block; a small window keeps the requests parallel while still stopping within
+ * `BLOCK_WALK_BATCH - 1` blocks of the page being filled. The comparison that matters is against
+ * fetching *every* candidate, which is what this replaces.
+ */
+const BLOCK_WALK_BATCH = 4;
+/**
+ * A `scan: "block-order"` query skips the rider rule, which is only safe while the walk can stop at
+ * the first full page: a `limit`, and no ordering the blocks don't already have.
+ */
+function assertBlockOrderScan(manifest, args) {
+    const sortField = manifest.dataset.sortField;
+    if (args.scan !== "block-order") {
+        throw new ZonemapDbError({
+            code: "CONFIG",
+            message: `zonemapdb: unknown scan mode ${JSON.stringify(args.scan)} — the only one is "block-order".`,
+        });
+    }
+    if (blockWalkDirection(manifest, args) !== undefined)
+        return;
+    throw new ZonemapDbError({
+        code: "NEEDS_PRUNING",
+        message: `zonemapdb: scan: "block-order" walks the data files in sort order and stops once the page is full, so it ` +
+            `needs a \`limit\` and no \`orderBy\` other than the sort field "${sortField}"` +
+            (args.limit === undefined ? `. This query has no limit.` : `. This query's orderBy can't be answered in block order.`) +
+            ` See "Scanning in block order" in docs/query-guide.md.`,
+    });
+}
+/**
+ * Which direction to walk candidate blocks when a bounded query's requested order already matches
+ * their physical order — `undefined` when it doesn't, meaning every candidate has to be fetched
+ * before the ordering (and therefore the page) is known.
+ */
+function blockWalkDirection(manifest, args) {
+    // Without a limit every match is returned, so there is no page to stop at.
+    if (args?.limit === undefined)
+        return undefined;
+    const orderBy = args.orderBy;
+    const keys = orderBy === undefined ? [] : Object.keys(orderBy);
+    // No orderBy: the result order IS block order, so walking is exactly equivalent to the full fetch.
+    if (keys.length === 0)
+        return "asc";
+    const sortField = manifest.dataset.sortField;
+    if (keys.length !== 1 || keys[0] !== sortField)
+        return undefined;
+    // An explicit orderBy on the sort field agrees with block order only when nothing has a
+    // null/absent sort value: those sit at the HIGH end on disk (ADR-0002 §9) but compare as lowest,
+    // so the two disagree and only materialize-then-sort places them correctly.
+    const zonemap = manifest.zonemap[sortField];
+    if (zonemap !== undefined && "splitPoints" in zonemap && zonemap.missing !== undefined)
+        return undefined;
+    return orderBy[sortField] === "desc" ? "desc" : "asc";
+}
+/**
+ * ADR-0008 §5: walk candidate blocks in sort order accumulating post-filtered matches until
+ * `offset + limit + 1` exist, then stop. The `+1` is what makes `hasMore` exact without a second
+ * query. Because the accumulated matches are a prefix of the globally ordered result set, slicing
+ * the page out of them is identical to slicing it out of every match — for a fraction of the bytes
+ * when the filter is unselective (the case where fetching all candidates hurt most).
+ */
+async function findManyByBlockWalk(manifest, ctx, candidateIndices, args, direction) {
+    const limit = args.limit;
+    const offset = args.offset ?? 0;
+    const needed = offset + limit + 1;
+    const order = direction === "asc" ? candidateIndices : [...candidateIndices].reverse();
+    const matches = [];
+    // How many candidates the walk actually read. Pruning is conservative — every match lives in a
+    // candidate — so reading all of them means `matches` IS the whole match set and its size is exact.
+    let read = 0;
+    for (let i = 0; i < order.length && matches.length < needed; i += BLOCK_WALK_BATCH) {
+        const batch = order.slice(i, i + BLOCK_WALK_BATCH);
+        const fetched = await Promise.all(batch.map((index) => fetchBlockAt(manifest, ctx, index)));
+        for (const records of fetched) {
+            // Records within a block are ascending by the sort field; a descending walk reverses each
+            // block as well as the block order. Ties among equal sort values are unordered either way.
+            for (const record of direction === "asc" ? records : [...records].reverse()) {
+                if (matchesWhere(record, args.where))
+                    matches.push(record);
+            }
+        }
+        read += batch.length;
+    }
+    const windowed = matches.slice(offset);
+    return {
+        records: windowed.slice(0, limit),
+        hasMore: windowed.length > limit,
+        // Stopping early is the walk's whole point, and it means the tail was never seen — no total then.
+        ...(read === order.length ? { total: matches.length } : {}),
+    };
+}
+async function executeFindMany(manifest, ctx, args, maxResults) {
+    const candidateIndices = await candidateIndicesForWhere(manifest, ctx, args?.where);
+    const walkDirection = blockWalkDirection(manifest, args);
+    if (walkDirection !== undefined) {
+        return await findManyByBlockWalk(manifest, ctx, candidateIndices, args, walkDirection);
+    }
+    const fetched = await Promise.all(candidateIndices.map(async (index) => ({ index, records: await fetchBlockAt(manifest, ctx, index) })));
+    fetched.sort((a, b) => a.index - b.index);
+    // Fetched blocks are individually sorted ascending by the sort field, and
+    // fetched/concatenated in ascending block-index order — the concatenation
+    // is already globally ascending; filtering never reorders it.
+    let matches = [];
+    for (const { records } of fetched) {
+        for (const record of records) {
+            if (matchesWhere(record, args?.where))
+                matches.push(record);
+        }
+    }
+    // The unbounded half of the maxResults guardrail: a query with no explicit
+    // limit that would exceed the ceiling throws rather than silently truncating
+    // (ADR-0004 — partial results are indistinguishable from smaller correct ones).
+    if (args?.limit === undefined && matches.length > maxResults) {
+        throw new ZonemapDbError({
+            code: "LIMIT_EXCEEDED",
+            message: `zonemapdb: this unbounded query matched more than the maxResults ceiling of ${maxResults} records — ` +
+                `add a limit ≤ ${maxResults} to paginate, or raise maxResults in connect(). Refusing to silently truncate.`,
+        });
+    }
+    if (args?.orderBy && Object.keys(args.orderBy).length > 0) {
+        const orderBy = args.orderBy;
+        matches = [...matches].sort((a, b) => compareByOrderBy(a, b, orderBy));
+    }
+    // This path read every candidate block, so `matches` is the complete match set — the exact total
+    // comes for free, even when only one page of it is returned.
+    const total = matches.length;
+    const offset = args?.offset ?? 0;
+    const windowed = matches.slice(offset);
+    if (args?.limit === undefined) {
+        return { records: windowed, hasMore: false, total };
+    }
+    return { records: windowed.slice(0, args.limit), hasMore: windowed.length > args.limit, total };
+}
+export function createClient(schema, opts) {
+    const basePath = opts.basePath.replace(/\/+$/, "");
+    const fetchImpl = opts.fetch ?? fetch;
+    const maxResults = opts.maxResults ?? DEFAULT_MAX_RESULTS;
+    const manifestCompression = opts.manifestCompression ?? (opts.manifestGzip === true ? "gzip" : "none");
+    let manifestPromise;
+    // A failed first fetch (a 503 on page load, a dropped connection) isn't remembered either: the next
+    // query tries again rather than inheriting the rejection until reload.
+    const getManifest = () => {
+        if (manifestPromise)
+            return manifestPromise;
+        const promise = fetchManifest(basePath, fetchImpl, manifestCompression).catch((error) => {
+            if (manifestPromise === promise)
+                manifestPromise = undefined;
+            throw error;
+        });
+        return (manifestPromise = promise);
+    };
+    // The one in-flight (or finished) refetch, keyed by the manifest it replaces. Every query that
+    // failed against that same stale manifest shares it, so a burst of concurrent queries after a
+    // redeploy costs one manifest request, not one each.
+    let refresh;
+    const refreshManifest = (stale) => {
+        if (refresh?.stale === stale)
+            return refresh.promise;
+        const promise = fetchManifest(basePath, fetchImpl, manifestCompression, "reload").then((fresh) => {
+            manifestPromise = Promise.resolve(fresh);
+            return fresh;
+        }, (error) => {
+            // A failed refetch isn't remembered: the next failing query tries again.
+            if (refresh?.promise === promise)
+                refresh = undefined;
+            throw error;
+        });
+        refresh = { stale, promise };
+        return promise;
+    };
+    /**
+     * Runs one query against the manifest, recovering once from a stale cached manifest (#32).
+     *
+     * Content-hashed files never go stale, but the manifest's name is the same across deploys, and a
+     * host that caches it (despite the `no-cache` revalidation, e.g. a CDN or a caching fetch wrapper)
+     * can hand back the previous deploy's copy, which names files the new deploy removed. So a
+     * DEPLOY_INTEGRITY 404 refetches the manifest with `cache: "reload"`. If the fresh manifest no
+     * longer names the missing file it replaces the cached one and the query reruns once against it
+     * (index chunks and sidecars are cached per query, so there is nothing else to drop). If it still
+     * names the file, that's a real partial deploy and the original error is thrown. A second
+     * failure on the rerun throws as-is: the retry is bounded at one, so it can never loop.
+     *
+     * `signal` is the caller's: it aborts this query's own fetches, and a cancelled query rejects with
+     * ABORTED and never retries. The shared manifest fetch and refetch are only raced, never aborted,
+     * because other queries may be waiting on them.
+     */
+    const withManifest = async (signal, run) => {
+        const attempt = async (manifest) => {
+            // The signal can fire while the manifest resolves; don't start fetches for a cancelled query.
+            if (signal?.aborted)
+                throw abortedError(signal);
+            const ctx = makeFetchContext(basePath, fetchImpl, signal);
+            try {
+                return await raceAbort(run(manifest, ctx), signal);
+            }
+            finally {
+                ctx.dispose();
+            }
+        };
+        const manifest = await raceAbort(getManifest(), signal);
+        try {
+            return await attempt(manifest);
+        }
+        catch (error) {
+            // Whatever a cancelled query's fetches threw on the way out, the caller asked for this.
+            if (signal?.aborted)
+                throw abortedError(signal);
+            if (!(error instanceof ZonemapDbError) || error.code !== "DEPLOY_INTEGRITY" || error.url === undefined)
+                throw error;
+            // A refetch that itself fails (a 5xx, a FORMAT_VERSION from a newer build) throws its own,
+            // more telling, error.
+            const fresh = await raceAbort(refreshManifest(manifest), signal);
+            if (manifestReferences(fresh, basePath, error.url))
+                throw error;
+            return await attempt(fresh);
+        }
+    };
+    const makeCollection = (meta) => {
+        const collection = {
+            findMany: async (args) => {
+                assertLimitWithinCeiling(args?.limit, maxResults);
+                if (args?.where !== undefined)
+                    args = { ...args, where: compactWhere(args.where) };
+                return withManifest(args?.signal, (manifest, ctx) => {
+                    // After the manifest (which says what prunes on this dataset), before any index or block fetch.
+                    if (args?.scan !== undefined)
+                        assertBlockOrderScan(manifest, args);
+                    else
+                        assertWhereHasPruning(args?.where, manifest.schema);
+                    return executeFindMany(manifest, ctx, args, maxResults);
+                });
+            },
+            count: async (where, opts) => withManifest(opts?.signal, (manifest, ctx) => executeCount(manifest, ctx, compactWhere(where))),
+            getSchema: () => meta,
+        };
+        // `get(id)` is equality-on-PK through the same candidate-block machinery as
+        // `findMany` (ADR-0003 §10) — free (≤1 block) when the PK is the sort field
+        // (zonemap alone pinpoints it), else ≤1 index chunk + ≤1 block. Omitted
+        // entirely (not even a stubbed throw) when no PK was declared (T1/ADR-0004).
+        if (meta.pk !== undefined) {
+            const pkField = meta.pk;
+            collection.get = async (id, opts) => {
+                const { records } = await withManifest(opts?.signal, (manifest, ctx) => executeFindMany(manifest, ctx, { where: { [pkField]: { equals: id } }, limit: 1 }, maxResults));
+                return records[0] ?? null;
+            };
+        }
+        return collection;
+    };
+    const out = {};
+    for (const name of Object.keys(schema))
+        out[name] = makeCollection(schema[name]);
+    return out;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Every runtime failure maps to exactly one code — as fine-grained as the
+ * caller's *reaction* differs, no finer (ADR-0007 §5):
+ *
+ * - `CONFIG` — manifest.json itself 404s / is unreachable (wrong basePath). Not retryable.
+ * - `FORMAT_VERSION` — manifest major ≠ runtime major, checked when the manifest loads. Not retryable.
+ * - `DEPLOY_INTEGRITY` — a manifest-referenced content-hashed block/chunk/sidecar 404s, and a freshly
+ *   refetched manifest still names it (the client retries once past a stale cached manifest, #32). Not retryable.
+ * - `NETWORK` — fetch rejected, or resolved non-ok non-404; optional `.status`. The one maybe-transient bucket.
+ * - `CORRUPT_DATA` — 2xx body won't parse into JSON/NDJSON/domain structure. Not retryable.
+ * - `LIMIT_EXCEEDED` — the `maxResults` ceiling (fail-loud, never truncates). Not retryable.
+ * - `NEEDS_PRUNING` — a `findMany` where made only of riders, which would read every block (ADR-0013). Not retryable.
+ * - `ABORTED` — the caller's `signal` fired, and the query's pending fetches were cancelled. Not a failure:
+ *   usually a newer query superseded this one, so there is nothing to retry or log.
+ */
+export type ZonemapDbErrorCode = "CONFIG" | "FORMAT_VERSION" | "DEPLOY_INTEGRITY" | "NETWORK" | "CORRUPT_DATA" | "LIMIT_EXCEEDED" | "NEEDS_PRUNING" | "ABORTED";
+export interface ZonemapDbErrorInit {
+    readonly code: ZonemapDbErrorCode;
+    /** Human-readable, with remediation (ADR-0007 §8). */
+    readonly message: string;
+    /** The underlying thrown error, chained via native ES2022 `Error.cause`. */
+    readonly cause?: unknown;
+    /** The file being fetched when it failed — absent for LIMIT_EXCEEDED, NEEDS_PRUNING and ABORTED. */
+    readonly url?: string;
+    /** HTTP status — present on NETWORK-from-response and the two 404 codes. */
+    readonly status?: number;
+}
+/**
+ * The one error `findMany`/`count`/`get` ever throw for fetch/parse/limit
+ * failures: `catch (e) { if (e instanceof ZonemapDbError && e.code === "…") … }`.
+ * The triggering query object is deliberately NOT attached — a `where` can hold
+ * PII-ish filter values that would land in logs (ADR-0007 §8).
+ */
+export declare class ZonemapDbError extends Error {
+    readonly code: ZonemapDbErrorCode;
+    readonly url?: string;
+    readonly status?: number;
+    constructor(init: ZonemapDbErrorInit);
+}
+//# sourceMappingURL=errors.d.ts.map