effect-dynamodb 1.22.0 → 1.23.0

package/dist/Query.d.ts

@@ -8,7 +8,7 @@
  * Implements Pipeable for ergonomic composition.
  */
 import type { AttributeValue } from "@aws-sdk/client-dynamodb";
-import type { ValidationError } from "@effect-dynamodb/schema/Errors.js";
+import { ValidationError } from "@effect-dynamodb/schema/Errors.js";
 import { Effect, Pipeable, Stream } from "effect";
 import { DynamoClient, type DynamoClientError } from "./DynamoClient.js";
 import { type Expr } from "./internal/Expr.js";
@@ -55,6 +55,11 @@ interface QueryState {
     readonly maxPagesValue: number | undefined;
     readonly scanForward: boolean;
     readonly consistentRead: boolean;
+    /**
+     * The index is a GSI, which DynamoDB only reads eventually consistently:
+     * `consistentRead` is refused before sending (#133).
+     */
+    readonly globalIndex: boolean;
     readonly ignoreOwnershipFlag: boolean;
     readonly exclusiveStartKey: Record<string, AttributeValue> | undefined;
     readonly isScan: boolean;
@@ -69,6 +74,42 @@ interface QueryState {
      * request over-reads and the surplus is discarded (see {@link limit}).
      */
     readonly keyFields: ReadonlyArray<string> | undefined;
+    /**
+     * Which rows are items (#133). An entity's version snapshots, soft-delete
+     * tombstones and time-series events keep its `__edd_e__`, so the ownership
+     * filter alone admits them to a query of the table's primary key, or a
+     * scan. Rows that fail it are dropped as they arrive, before they are
+     * decoded or counted — see {@link isExcludedRow}. (Client-side for scans
+     * too: a `FilterExpression` saves no read capacity, and no expression
+     * tells a live row from history as exactly.)
+     */
+    readonly liveRows: LiveRows | undefined;
+    /**
+     * Run once at the start of each terminal, against the resolved table: may
+     * swap the sort key `begins_with` operand and add a row filter (`keep`)
+     * applied, like {@link liveRows}, to rows before they are decoded.
+     * An entity's `versions` uses it to read history written by an earlier
+     * release alongside its own (#133).
+     */
+    readonly prepare: QueryPrepare | undefined;
+    /** @internal Set by {@link prepare}: rows outside it are dropped before decode. */
+    readonly keepRow: ((row: Record<string, AttributeValue>) => boolean) | undefined;
+}
+/** @internal See {@link QueryState.prepare}. */
+export type QueryPrepare = (tableName: string) => Effect.Effect<{
+    /** Replace a `begins_with` sort key condition on `from` with one on `to`. */
+    readonly replaceBeginsWith?: {
+        readonly from: string;
+        readonly to: string;
+    } | undefined;
+    readonly keep?: ((row: Record<string, AttributeValue>) => boolean) | undefined;
+}, DynamoClientError, DynamoClient>;
+/** @internal See {@link QueryState.liveRows}. */
+export interface LiveRows {
+    /** Whether a raw row is an item, rather than an entity's history. */
+    readonly isLive: (row: Record<string, AttributeValue>) => boolean;
+    /** The attributes `isLive` reads — kept in a request that projects. */
+    readonly reads: ReadonlyArray<string>;
 }
 declare const QueryTypeId: unique symbol;
 export type QueryTypeId = typeof QueryTypeId;
@@ -96,9 +137,15 @@ export declare const make: <A>(config: {
     readonly skField: string | undefined;
     readonly entityTypes: ReadonlyArray<string>;
     readonly decoder: (raw: Record<string, unknown>) => Effect.Effect<A, ValidationError>;
+    /** `indexName` names a GSI (see {@link QueryState.globalIndex}). */
+    readonly globalIndex?: boolean | undefined;
     readonly resolveTableName?: Effect.Effect<string, never, any> | undefined;
     /** Index key + table key attribute names (used to rebuild cursors). */
     readonly keyFields?: ReadonlyArray<string | undefined> | undefined;
+    /** Which rows are items (see {@link QueryState.liveRows}). */
+    readonly liveRows?: LiveRows | undefined;
+    /** See {@link QueryState.prepare}. */
+    readonly prepare?: QueryPrepare | undefined;
 }) => Query<A>;
 /**
  * Create a scan-mode Query. Shares all combinators and terminals with Query
@@ -110,9 +157,15 @@ export declare const makeScan: <A>(config: {
     readonly indexName: string | undefined;
     readonly entityTypes: ReadonlyArray<string>;
     readonly decoder: (raw: Record<string, unknown>) => Effect.Effect<A, ValidationError>;
+    /** `indexName` names a GSI (see {@link QueryState.globalIndex}). */
+    readonly globalIndex?: boolean | undefined;
     readonly resolveTableName?: Effect.Effect<string, never, any> | undefined;
     /** Index key + table key attribute names (used to rebuild cursors). */
     readonly keyFields?: ReadonlyArray<string | undefined> | undefined;
+    /** Which rows are items (see {@link QueryState.liveRows}). */
+    readonly liveRows?: LiveRows | undefined;
+    /** See {@link QueryState.prepare}. */
+    readonly prepare?: QueryPrepare | undefined;
 }) => Query<A>;
 /**
  * Add a sort key condition to the query.
@@ -155,7 +208,9 @@ export declare const pageSize: {
  */
 export declare const reverse: <A>(self: Query<A>) => Query<A>;
 /**
- * Enable consistent reads for this query (or scan).
+ * Enable consistent reads for this query (or scan). Refused with a
+ * `ValidationError` when it runs on a global secondary index, which DynamoDB
+ * reads only eventually consistently.
  */
 export declare const consistentRead: {
     (): <A>(self: Query<A>) => Query<A>;
@@ -194,6 +249,20 @@ export declare const select: {
     (attributes: ReadonlyArray<string>): <A>(self: Query<A>) => Query<Record<string, unknown>>;
     <A>(self: Query<A>, attributes: ReadonlyArray<string>): Query<Record<string, unknown>>;
 };
+/**
+ * @internal A projection of stored attribute paths, decoded by `decode`: what
+ * `select` becomes when the names a caller asks for are not the names stored
+ * (#133). Always numbered placeholders (`#proj0`), whatever characters the
+ * stored names hold.
+ */
+export declare const selectProjected: <A>(self: Query<A>, storedPaths: ReadonlyArray<ReadonlyArray<string | number>>, decode: (raw: Record<string, unknown>) => unknown) => Query<Record<string, unknown>>;
+/**
+ * @internal `select` / `selectPaths` of DOMAIN field names on an entity that
+ * stores some under other names (`DynamoModel.configure(..., { field })`): the
+ * projection names the stored attributes, and each item is handed back keyed
+ * by the domain names asked for (#133).
+ */
+export declare const selectRenamed: <A>(self: Query<A>, paths: ReadonlyArray<ReadonlyArray<string | number>>, resolveDbName: (domainName: string) => string) => Query<Record<string, unknown>>;
 /**
  * Add an Expr-based filter expression to the query.
  * Multiple filterExpr calls are ANDed together.
@@ -304,8 +373,11 @@ export declare const count: <A>(self: Query<A>) => Effect.Effect<number, DynamoC
 /**
  * Return the built DynamoDB command input without executing.
  * Useful for debugging, logging, or passing to DynamoClient directly.
+ * Fails with a `ValidationError` for a filter the query would refuse to send
+ * (an empty part under `or` / `not`, an `or()` with no parts, an `isIn` with
+ * no values).
  */
-export declare const asParams: <A>(self: Query<A>) => Effect.Effect<Record<string, unknown>, never, any>;
+export declare const asParams: <A>(self: Query<A>) => Effect.Effect<Record<string, unknown>, ValidationError, any>;
 export declare const isQuery: (u: unknown) => u is Query<unknown>;
 export {};
 //# sourceMappingURL=Query.d.ts.map

package/dist/Query.d.ts.map

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

package/dist/Query.js

@@ -7,10 +7,11 @@
  *
  * Implements Pipeable for ergonomic composition.
  */
+import { ValidationError } from "@effect-dynamodb/schema/Errors.js";
 import * as Projection from "@effect-dynamodb/schema/Projection.js";
 import { Effect, Function, Option, Pipeable, Stream } from "effect";
 import { DynamoClient } from "./DynamoClient.js";
-import { compileExpr } from "./internal/Expr.js";
+import { compileExpr, ExprTag, emptyPartProblem, isEmptyExpr } from "./internal/Expr.js";
 import { compilePath } from "./internal/PathBuilder.js";
 import { fromAttributeMap, toAttributeValue } from "./Marshaller.js";
 /** @internal Dedupe + drop absent entries from a caller-supplied key field list. */
@@ -42,6 +43,9 @@ class QueryImpl {
 // Constructor (internal — used by Entity and Collection)
 // ---------------------------------------------------------------------------
 export const make = (config) => new QueryImpl({
+    liveRows: config.liveRows,
+    prepare: config.prepare,
+    keepRow: undefined,
     tableName: config.tableName,
     indexName: config.indexName,
     pkField: config.pkField,
@@ -56,6 +60,7 @@ export const make = (config) => new QueryImpl({
     maxPagesValue: undefined,
     scanForward: true,
     consistentRead: false,
+    globalIndex: config.globalIndex ?? false,
     ignoreOwnershipFlag: false,
     exclusiveStartKey: undefined,
     isScan: false,
@@ -71,6 +76,9 @@ export const make = (config) => new QueryImpl({
  * No key condition — only filter expressions and entity type filter.
  */
 export const makeScan = (config) => new QueryImpl({
+    liveRows: config.liveRows,
+    prepare: config.prepare,
+    keepRow: undefined,
     tableName: config.tableName,
     indexName: config.indexName,
     pkField: "",
@@ -85,6 +93,7 @@ export const makeScan = (config) => new QueryImpl({
     maxPagesValue: undefined,
     scanForward: true,
     consistentRead: false,
+    globalIndex: config.globalIndex ?? false,
     ignoreOwnershipFlag: false,
     exclusiveStartKey: undefined,
     isScan: true,
@@ -151,7 +160,9 @@ export const reverse = (self) => new QueryImpl({
     scanForward: false,
 });
 /**
- * Enable consistent reads for this query (or scan).
+ * Enable consistent reads for this query (or scan). Refused with a
+ * `ValidationError` when it runs on a global secondary index, which DynamoDB
+ * reads only eventually consistently.
  */
 export const consistentRead = Function.dual((args) => isQuery(args[0]), (self) => new QueryImpl({
     ...self._state,
@@ -201,16 +212,52 @@ export const select = Function.dual(2, (self, attributes) => {
         decoder: (raw) => Effect.succeed(raw),
     });
 });
+/**
+ * @internal A projection of stored attribute paths, decoded by `decode`: what
+ * `select` becomes when the names a caller asks for are not the names stored
+ * (#133). Always numbered placeholders (`#proj0`), whatever characters the
+ * stored names hold.
+ */
+export const selectProjected = (self, storedPaths, decode) => {
+    if (self._state.predicates.length > 0) {
+        throw new Error(rejectPredicateWithProjection("select() after filterBy()"));
+    }
+    return new QueryImpl({
+        ...self._state,
+        projection: undefined,
+        projectionPaths: storedPaths,
+        decoder: (raw) => Effect.succeed(decode(raw)),
+    });
+};
+/**
+ * @internal `select` / `selectPaths` of DOMAIN field names on an entity that
+ * stores some under other names (`DynamoModel.configure(..., { field })`): the
+ * projection names the stored attributes, and each item is handed back keyed
+ * by the domain names asked for (#133).
+ */
+export const selectRenamed = (self, paths, resolveDbName) => {
+    const heads = [...new Set(paths.map((path) => String(path[0])))];
+    return selectProjected(self, paths.map((path) => [resolveDbName(String(path[0])), ...path.slice(1)]), (raw) => {
+        const item = {};
+        for (const head of heads) {
+            const value = raw[resolveDbName(head)];
+            if (value !== undefined)
+                item[head] = value;
+        }
+        return item;
+    });
+};
 /**
  * Add an Expr-based filter expression to the query.
  * Multiple filterExpr calls are ANDed together.
  */
 export const filterExpr = Function.dual(2, (self, expr) => {
-    // An empty shorthand (`.filter({})`) parses to an empty `and`, which
-    // compiles to the empty string — and `FilterExpression: ""` is rejected by
-    // DynamoDB. A predicate over no attributes is a no-op, so drop it here
-    // rather than emitting an unusable request.
-    if ((expr._tag === "and" || expr._tag === "or") && expr.exprs.length === 0)
+    // A filter that asserts nothing (`.filter({})`, `and()`) is no filter: it is
+    // dropped here, never sent as `FilterExpression: ""`, which DynamoDB
+    // rejects (#133). An empty part anywhere else — under `or` or `not`, or an
+    // `or()` with no parts — is kept, and refused when the query runs
+    // (`emptyPartProblem`).
+    if (isEmptyExpr(expr))
         return self;
     return new QueryImpl({
         ...self._state,
@@ -308,10 +355,18 @@ const buildFilterClauses = (state) => {
             values[`:et${i}`] = toAttributeValue(et);
         });
     }
-    // Expr-based filters (compiled from Entity.filter() callback/shorthand API)
-    for (const expr of state.exprFilters) {
-        const compiled = compileExpr(expr);
-        filterClauses.push(compiled.expression);
+    // Expr-based filters (compiled from Entity.filter() callback/shorthand API).
+    // Compiled as ONE expression: each compile numbers its placeholders from
+    // zero, so two compiled apart both wrote `#e0` and the second overwrote the
+    // first's name (#133).
+    if (state.exprFilters.length > 0) {
+        const compiled = compileExpr(state.exprFilters.length === 1
+            ? state.exprFilters[0]
+            : { [ExprTag]: ExprTag, _tag: "and", exprs: state.exprFilters });
+        // Parenthesised beside the ownership clause: a top-level `OR` would
+        // otherwise bind looser than the `AND` and admit other entities' rows
+        // (`#eddE IN (:et0) AND a OR b`).
+        filterClauses.push(filterClauses.length > 0 ? `(${compiled.expression})` : compiled.expression);
         Object.assign(names, compiled.names);
         Object.assign(values, compiled.values);
     }
@@ -419,6 +474,8 @@ const buildDynamoCommand = (state, tableName, overrides, extraProjectionFields =
 // ---------------------------------------------------------------------------
 // Internal: limit / pageSize execution helpers
 // ---------------------------------------------------------------------------
+/** The largest `Limit` a growing request asks for: DynamoDB stops at 1 MB anyway. */
+const MAX_GROWN_LIMIT = 100_000;
 /**
  * @internal DynamoDB `Limit` for the next request.
  *
@@ -432,15 +489,93 @@ const buildDynamoCommand = (state, tableName, overrides, extraProjectionFields =
  *   `pageSize` — or, unset, a natural (1 MB) page.
  * - A client-side predicate ({@link filterBy}) rejects rows even later, after
  *   decode, so it disqualifies the budget for exactly the same reason.
+ * - Rows dropped as history ({@link QueryState.liveRows}, a prepared `keep`)
+ *   are not: they can't be skipped server-side, and a run of them (an item's
+ *   versions, its tombstones) can far outnumber the items. The first request
+ *   asks for `limit`, and each later one twice the last — so a run of `n`
+ *   history rows costs about `log2(n / limit)` requests, not `n / limit` — and
+ *   the surplus past `limit` is discarded, the cursor rebuilt from the last
+ *   item returned (#133). `pageSize`, when set, is used as is.
+ *
+ * `page` is the request's 1-based number within the terminal.
  */
-const computeRequestLimit = (state, remaining) => {
+const computeRequestLimit = (state, remaining, page = 1) => {
     const pageSize = state.pageSizeValue;
     if (remaining === undefined)
         return pageSize;
     if (state.exprFilters.length > 0 || state.predicates.length > 0)
         return pageSize;
+    if (dropsRows(state)) {
+        if (pageSize !== undefined)
+            return pageSize;
+        const limit = state.limitValue ?? remaining;
+        return Math.min(limit * 2 ** (page - 1), MAX_GROWN_LIMIT);
+    }
     return pageSize === undefined ? remaining : Math.min(pageSize, remaining);
 };
+/**
+ * @internal Whether the query drops rows client-side (#133): like a predicate,
+ * it rejects rows after they are read, so the `limit` budget cannot be handed
+ * to DynamoDB, and a count has to read the rows.
+ */
+const dropsRows = (state) => state.keepRow !== undefined || state.liveRows !== undefined;
+/** @internal Is this raw row one the query leaves out (#133)? */
+const isExcludedRow = (state, row) => (state.keepRow !== undefined && !state.keepRow(row)) ||
+    (state.liveRows !== undefined && !state.liveRows.isLive(row));
+/**
+ * @internal A filter with an empty part where none may be (`emptyPartProblem`):
+ * the `ValidationError` every path that builds a request fails with, before
+ * `compileExpr` — which throws on one — ever sees it (#133).
+ */
+const refuseEmptyFilterParts = (state) => {
+    for (const filter of state.exprFilters) {
+        const problem = emptyPartProblem(filter);
+        if (problem !== undefined) {
+            return new ValidationError({
+                entityType: state.entityTypes.join(", ") || "unknown",
+                operation: "query.filter",
+                cause: `filter: ${problem} Nothing was sent.`,
+            });
+        }
+    }
+    return undefined;
+};
+/**
+ * @internal The state a terminal runs: {@link QueryState.prepare} applied
+ * against the resolved table.
+ */
+const prepared = (state, tableName) => {
+    // A consistent read of a GSI — which DynamoDB only reads eventually
+    // consistently — is refused before anything is sent (#133).
+    if (state.consistentRead && state.globalIndex) {
+        return Effect.fail(new ValidationError({
+            entityType: state.entityTypes.join(", ") || "unknown",
+            operation: "query.consistentRead",
+            cause: `consistentRead: index "${state.indexName}" is a global secondary index, which ` +
+                "DynamoDB reads only eventually consistently. Nothing was sent.",
+        }));
+    }
+    // A filter with an empty part where none may be is refused before
+    // anything is sent (#133).
+    const filterRefusal = refuseEmptyFilterParts(state);
+    if (filterRefusal !== undefined)
+        return Effect.fail(filterRefusal);
+    return state.prepare === undefined
+        ? Effect.succeed(state)
+        : Effect.map(state.prepare(tableName), (prep) => {
+            const swap = prep.replaceBeginsWith;
+            return {
+                ...state,
+                prepare: undefined,
+                keepRow: prep.keep,
+                skConditions: swap === undefined
+                    ? state.skConditions
+                    : state.skConditions.map((c) => "beginsWith" in c.condition && c.condition.beginsWith === swap.from
+                        ? { ...c, condition: { beginsWith: swap.to } }
+                        : c),
+            };
+        });
+};
 /** @internal Does the decoded item pass every client-side predicate? */
 const accepts = (state, item) => {
     for (const predicate of state.predicates) {
@@ -477,16 +612,22 @@ const cursorFromItem = (item, names) => {
  * over-reading request can still rebuild an accurate cursor. They are stripped
  * from the items handed back, so the caller sees exactly what it selected.
  */
-const cursorProjectionFields = (state) => {
-    if (state.limitValue === undefined || !state.keyFields)
-        return [];
+const cursorProjectionFields = (state, 
+/** Whether the terminal rebuilds a cursor (`execute`); `paginate` doesn't. */
+forCursor) => {
     const projected = new Set([
         ...(state.projection ?? []),
         ...(state.projectionPaths ?? []).map((segments) => String(segments[0])),
     ]);
     if (projected.size === 0)
         return [];
-    return state.keyFields.filter((field) => !projected.has(field));
+    const borrowed = new Set(!forCursor || state.limitValue === undefined || !state.keyFields ? [] : state.keyFields);
+    // A query that drops rows reads what it judges them by (#133).
+    if (state.keepRow !== undefined && state.skField !== undefined)
+        borrowed.add(state.skField);
+    for (const attr of state.liveRows?.reads ?? [])
+        borrowed.add(attr);
+    return [...borrowed].filter((field) => !projected.has(field));
 };
 // ---------------------------------------------------------------------------
 // Terminals
@@ -521,16 +662,18 @@ export const collect = (self) => Effect.gen(function* () {
  */
 export const execute = (self) => Effect.gen(function* () {
     const client = yield* DynamoClient;
-    const state = self._state;
-    const tableName = state.resolveTableName ? yield* state.resolveTableName : state.tableName;
+    const tableName = self._state.resolveTableName
+        ? yield* self._state.resolveTableName
+        : self._state.tableName;
+    const state = yield* prepared(self._state, tableName);
     const limitValue = state.limitValue;
     if (limitValue !== undefined && limitValue <= 0) {
         return { items: [], cursor: null };
     }
     // Key attributes borrowed into an active projection so an over-reading
     // request can still rebuild a cursor. Stripped again before decoding.
-    const borrowedFields = cursorProjectionFields(state);
-    const hasPredicate = state.predicates.length > 0;
+    const borrowedFields = cursorProjectionFields(state, true);
+    const hasPredicate = state.predicates.length > 0 || dropsRows(state);
     const items = [];
     let startKey = state.exclusiveStartKey;
     let pageCount = 0;
@@ -538,7 +681,7 @@ export const execute = (self) => Effect.gen(function* () {
     while (true) {
         pageCount++;
         const remaining = limitValue === undefined ? undefined : limitValue - items.length;
-        const cmd = buildDynamoCommand(state, tableName, { ExclusiveStartKey: startKey, Limit: computeRequestLimit(state, remaining) }, borrowedFields);
+        const cmd = buildDynamoCommand(state, tableName, { ExclusiveStartKey: startKey, Limit: computeRequestLimit(state, remaining, pageCount) }, borrowedFields);
         const result = state.isScan ? yield* client.scan(cmd) : yield* client.query(cmd);
         const returned = (result.Items ?? []);
         const lastEvaluatedKey = result.LastEvaluatedKey;
@@ -552,6 +695,8 @@ export const execute = (self) => Effect.gen(function* () {
         /** Index of the last row examined when the limit was reached, else -1. */
         let stoppedAt = -1;
         for (let i = 0; i < take; i++) {
+            if (isExcludedRow(state, returned[i]))
+                continue;
             const raw = fromAttributeMap(returned[i]);
             for (const field of borrowedFields)
                 delete raw[field];
@@ -596,8 +741,13 @@ export const execute = (self) => Effect.gen(function* () {
 export const paginate = (self) => paginateInternal(self);
 const paginateInternal = (self) => Effect.gen(function* () {
     const client = yield* DynamoClient;
-    const state = self._state;
-    const tableName = state.resolveTableName ? yield* state.resolveTableName : state.tableName;
+    const tableName = self._state.resolveTableName
+        ? yield* self._state.resolveTableName
+        : self._state.tableName;
+    // Prepared when the stream runs, so a failure is the stream's.
+    return Stream.unwrap(prepared(self._state, tableName).pipe(Effect.provideService(DynamoClient, client), Effect.map((state) => pageStream(client, tableName, state))));
+});
+const pageStream = (client, tableName, state) => {
     const limitValue = state.limitValue;
     if (limitValue !== undefined && limitValue <= 0) {
         return Stream.empty;
@@ -609,19 +759,28 @@ const paginateInternal = (self) => Effect.gen(function* () {
     }, (pageState) => Effect.gen(function* () {
         const pageCount = pageState.pageCount + 1;
         const remaining = limitValue === undefined ? undefined : limitValue - pageState.emitted;
+        const borrowedFields = cursorProjectionFields(state, false);
         const cmd = buildDynamoCommand(state, tableName, {
             ExclusiveStartKey: pageState.key,
-            Limit: computeRequestLimit(state, remaining),
-        });
+            Limit: computeRequestLimit(state, remaining, pageCount),
+        }, borrowedFields);
         const result = state.isScan ? yield* client.scan(cmd) : yield* client.query(cmd);
         const returned = (result.Items ?? []);
         // See `execute` — a client predicate rejects rows after decode, so
         // the budget cannot bound the examine window, only the accepted one.
-        const hasPredicate = state.predicates.length > 0;
+        const hasPredicate = state.predicates.length > 0 || dropsRows(state);
         const take = remaining === undefined || hasPredicate
             ? returned.length
             : Math.min(remaining, returned.length);
-        const examined = yield* Effect.forEach(returned.slice(0, take).map((item) => fromAttributeMap(item)), (raw) => state.decoder(raw));
+        const examined = yield* Effect.forEach(returned
+            .slice(0, take)
+            .filter((item) => !isExcludedRow(state, item))
+            .map((item) => {
+            const raw = fromAttributeMap(item);
+            for (const field of borrowedFields)
+                delete raw[field];
+            return raw;
+        }), (raw) => state.decoder(raw));
         const kept = hasPredicate ? examined.filter((item) => accepts(state, item)) : examined;
         const decoded = remaining === undefined ? kept : kept.slice(0, remaining);
         const emitted = pageState.emitted + decoded.length;
@@ -637,7 +796,7 @@ const paginateInternal = (self) => Effect.gen(function* () {
             : Option.none();
         return [[decoded], nextState];
     }));
-});
+};
 /**
  * Execute a count query. Uses `Select: "COUNT"` on DynamoDB — no items are returned.
  * Returns the total count across all requests (respects {@link maxPages}).
@@ -649,8 +808,10 @@ const paginateInternal = (self) => Effect.gen(function* () {
  */
 export const count = (self) => Effect.gen(function* () {
     const client = yield* DynamoClient;
-    const state = self._state;
-    const tableName = state.resolveTableName ? yield* state.resolveTableName : state.tableName;
+    const tableName = self._state.resolveTableName
+        ? yield* self._state.resolveTableName
+        : self._state.tableName;
+    const state = yield* prepared(self._state, tableName);
     const limitValue = state.limitValue;
     if (limitValue !== undefined && limitValue <= 0)
         return 0;
@@ -665,6 +826,37 @@ export const count = (self) => Effect.gen(function* () {
         const items = yield* collect(self);
         return items.length;
     }
+    // Rows that may be history are judged by a few attributes, so only those
+    // are read — never whole items (#133).
+    if (dropsRows(state)) {
+        const judged = [
+            ...new Set([
+                ...(state.liveRows?.reads ?? []),
+                ...(state.keepRow !== undefined && state.skField !== undefined ? [state.skField] : []),
+            ]),
+        ];
+        const judging = { ...state, projection: judged, projectionPaths: undefined };
+        let counted = 0;
+        let pages = 0;
+        let start;
+        do {
+            pages++;
+            const remaining = limitValue === undefined ? undefined : limitValue - counted;
+            const cmd = buildDynamoCommand(judging, tableName, {
+                ExclusiveStartKey: start,
+                Limit: computeRequestLimit(state, remaining, pages),
+            });
+            const result = state.isScan ? yield* client.scan(cmd) : yield* client.query(cmd);
+            const rows = (result.Items ?? []);
+            counted += rows.filter((row) => !isExcludedRow(state, row)).length;
+            start = result.LastEvaluatedKey;
+            if (limitValue !== undefined && counted >= limitValue)
+                return limitValue;
+            if (state.maxPagesValue != null && pages >= state.maxPagesValue)
+                break;
+        } while (start != null);
+        return counted;
+    }
     let total = 0;
     let pageCount = 0;
     let exclusiveStartKey;
@@ -689,9 +881,15 @@ export const count = (self) => Effect.gen(function* () {
 /**
  * Return the built DynamoDB command input without executing.
  * Useful for debugging, logging, or passing to DynamoClient directly.
+ * Fails with a `ValidationError` for a filter the query would refuse to send
+ * (an empty part under `or` / `not`, an `or()` with no parts, an `isIn` with
+ * no values).
  */
 export const asParams = (self) => Effect.gen(function* () {
     const state = self._state;
+    const refusal = refuseEmptyFilterParts(state);
+    if (refusal !== undefined)
+        return yield* refusal;
     const tableName = state.resolveTableName ? yield* state.resolveTableName : state.tableName;
     return buildDynamoCommand(state, tableName);
 });