kitcn 0.16.0 → 0.16.1

package/dist/aggregate/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial, dn as ConvexTableWithColumns, tr as ConvexTextBuilderInitial } from "../where-clause-compiler-WF9UcrAB.js";
+import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial, dn as ConvexTableWithColumns, tr as ConvexTextBuilderInitial } from "../where-clause-compiler-C8UKgzTO.js";
 import * as convex_values0 from "convex/values";
 import { GenericId, Infer, Value } from "convex/values";
 import { DocumentByName, GenericDataModel, GenericDatabaseReader, GenericDatabaseWriter, TableNamesInDataModel } from "convex/server";

package/dist/auth/index.js

@@ -3,7 +3,7 @@ import { r as partial } from "../validators-C7LelqTN.js";
 import { i as defineAuth, n as createDisabledAuthRuntime, r as getGeneratedAuthDisabledReason, t as DEFAULT_AUTH_DEFINITION_PATH } from "../generated-contract-disabled-BXaz7JCE.js";
 import { n as createGeneratedFunctionReference, o as isQueryCtx, s as isRunMutationCtx } from "../api-entry-N3nBOlI2.js";
 import { n as customCtx, r as customMutation } from "../customFunctions-DxEEO4Dq.js";
-import { a as mergedStream, l as unsetToken, o as stream, t as getByIdWithOrmQueryFallback, v as eq } from "../query-context-ydn9kb6P.js";
+import { a as mergedStream, l as unsetToken, o as stream, t as getByIdWithOrmQueryFallback, v as eq } from "../query-context-B47_3n97.js";
 import { n as convex } from "../convex-plugin-BHVCqWTH.js";
 import { v } from "convex/values";
 import { internalActionGeneric, internalMutationGeneric, internalQueryGeneric, paginationOptsValidator } from "convex/server";

package/dist/orm/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as GenericOrmCtx$1, $n as unique, $r as endsWith, $t as ManyConfig, A as ConvexDateMode, An as ConvexRankIndexBuilder, Ar as ReturningResult, At as MigrationManifestEntry, B as ConvexBytesBuilderInitial, Bn as rankIndex, Br as OrmSchemaRelations, Bt as defineMigration, C as ConvexNumberBuilderInitial, Ci as ColumnBuilderWithTableName, Cn as RlsRole, Cr as MutationReturning, Ct as MigrationStatusArgs, D as id, Di as IsPrimaryKey, Dn as ConvexAggregateIndexBuilderOn, Dr as PaginatedResult, Dt as MigrationDoc, E as ConvexIdBuilderInitial, Ei as HasDefault, En as ConvexAggregateIndexBuilder, Er as OrderDirection, Et as MigrationDirection, F as custom, Fn as ConvexVectorIndexBuilder, Fr as unsetToken, Ft as MigrationStateMap, G as ConvexBigIntBuilder, Gn as ConvexCheckConfig, Gr as ExpressionVisitor, Gt as OrmReader$1, H as ConvexBooleanBuilder, Hn as uniqueIndex, Hr as TableName, Ht as detectMigrationDrift, I as json, In as ConvexVectorIndexBuilderOn, Ir as Brand, It as MigrationStep, J as CountBackfillChunkArgs, Jn as ConvexUniqueConstraintBuilder, Jr as LogicalExpression, Jt as RlsMode, K as ConvexBigIntBuilderInitial, Kn as ConvexForeignKeyBuilder, Kr as FieldReference, Kt as OrmWriter$1, L as objectOf, Ln as ConvexVectorIndexConfig, Lr as Columns, Lt as MigrationTableName, M as ConvexCustomBuilder, Mn as ConvexSearchIndexBuilder, Mr as UpdateSet, Mt as MigrationPlan, N as ConvexCustomBuilderInitial, Nn as ConvexSearchIndexBuilderOn, Nr as VectorQueryConfig, Nt as MigrationRunStatus, O as ConvexDateBuilder, Oi as IsUnique, On as ConvexIndexBuilder, Or as PredicateWhereIndexConfig, Ot as MigrationDocContext, P as arrayOf, Pn as ConvexSearchIndexConfig, Pr as VectorSearchProvider, Pt as MigrationSet, Q as GenericOrm$1, Qn as foreignKey, Qr as contains, Qt as ExtractTablesWithRelations, R as unionOf, Rn as aggregateIndex, Rr as OrmSchemaExtensionTables, Rt as MigrationWriteMode, S as ConvexNumberBuilder, Si as ColumnBuilderTypeConfig, Sn as rlsPolicy, Sr as MutationResult, St as MigrationRunChunkArgs, T as ConvexIdBuilder, Ti as DrizzleEntity, Tn as rlsRole, Tr as OrderByClause, Tt as MigrationDefinition, U as ConvexBooleanBuilderInitial, Un as vectorIndex, Ur as SystemFields, Ut as DatabaseWithMutations, V as bytes, Vn as searchIndex, Vr as OrmSchemaTriggers, Vt as defineMigrationSet, W as boolean, Wn as ConvexCheckBuilder, Wr as BinaryExpression, Wt as DatabaseWithQuery, X as CountBackfillStatusArgs, Xn as ConvexUniqueConstraintConfig, Xr as and, Xt as extractRelationsConfig, Y as CountBackfillKickoffArgs, Yn as ConvexUniqueConstraintBuilderOn, Yr as UnaryExpression, Yt as EdgeMetadata, Z as CreateOrmOptions, Zn as check, Zr as between, Zt as ExtractTablesFromSchema, _ as ConvexTimestampMode, _i as startsWith, _n as deletion, _r as MutationExecuteConfig, _t as OrmTriggerContext, a as requireSchemaRelations, ai as inArray, an as TablesRelationalConfig, ar as AggregateResult, at as OrmWriterCtx, b as ConvexTextEnumBuilderInitial, bi as ColumnBuilderBaseConfig, bn as RlsPolicyConfig, br as MutationPaginateConfig, bt as MigrationCancelArgs, c as TableConfigResult, ci as isNull, cn as ConvexDeletionBuilder, cr as CountConfig, ct as ScheduledMutationBatchArgs, d as OrmNotFoundError, di as lte, dn as ConvexTableWithColumns, dr as FilterOperators, dt as scheduledDeleteFactory, ei as eq, en as OneConfig, er as ConvexTextBuilder, et as OrmApiResult, f as ConvexVectorBuilder, fi as ne, fn as DiscriminatorBuilderConfig, fr as GetColumnData, ft as SchemaExtension, g as ConvexTimestampBuilderInitial, gi as or, gn as convexTable, gr as InsertValue, gt as OrmTriggerChange, h as ConvexTimestampBuilder, hi as notInArray, hn as TableConfig, hr as InferSelectModel, ht as OrmTableTriggers, i as getSchemaTriggers, ii as ilike, in as TableRelationalConfig, ir as AggregateFieldValue, it as OrmReaderCtx, j as date, jn as ConvexRankIndexBuilderOn, jr as ReturningSelection, jt as MigrationMigrateOne, k as ConvexDateBuilderInitial, ki as NotNull, kn as ConvexIndexBuilderOn, kr as ReturningAll, kt as MigrationDriftIssue, l as getTableColumns, li as like, ln as ConvexDeletionConfig, lr as CountResult, lt as scheduledMutationBatchFactory, m as vector, mi as notBetween, mn as OrmLifecycleOperation, mr as InferModelFromColumns, mt as OrmBeforeResult, n as defineSchema, ni as gt, nn as RelationsBuilderColumnBase, nr as text, nt as OrmClientWithApi$1, o as asc, oi as isFieldReference, on as defineRelations, or as BuildQueryResult, ot as ResolveOrmSchema, p as ConvexVectorBuilderInitial, pi as not, pn as OrmLifecycleChange, pr as InferInsertModel, pt as defineSchemaExtension, q as bigint, qn as ConvexForeignKeyConfig, qr as FilterExpression, qt as RlsContext, r as getSchemaRelations, ri as gte, rn as RelationsBuilderColumnConfig, rr as AggregateConfig, rt as OrmFunctions, s as desc, si as isNotNull, sn as defineRelationsPart, sr as BuildRelationResult, st as createOrm, t as WhereClauseResult, ti as fieldRef, tn as RelationsBuilder, tr as ConvexTextBuilderInitial, tt as OrmClientBase$1, u as getTableConfig, ui as lt, un as ConvexTable, ur as DBQueryConfig, ut as ScheduledDeleteArgs, v as timestamp, vi as AnyColumn, vn as discriminator, vr as MutationExecuteResult, vt as OrmTriggers, w as integer, wi as ColumnDataType, wn as RlsRoleConfig, wr as MutationRunMode, wt as MigrationAppliedState, x as textEnum, xi as ColumnBuilderRuntimeConfig, xn as RlsPolicyToOption, xr as MutationPaginatedResult, xt as MigrationRunArgs, y as ConvexTextEnumBuilder, yi as ColumnBuilder, yn as RlsPolicy, yr as MutationExecutionMode, yt as defineTriggers, z as ConvexBytesBuilder, zn as index, zr as OrmSchemaExtensions, zt as buildMigrationPlan } from "../where-clause-compiler-WF9UcrAB.js";
+import { $ as GenericOrmCtx$1, $n as unique, $r as endsWith, $t as ManyConfig, A as ConvexDateMode, An as ConvexRankIndexBuilder, Ar as ReturningResult, At as MigrationManifestEntry, B as ConvexBytesBuilderInitial, Bn as rankIndex, Br as OrmSchemaRelations, Bt as defineMigration, C as ConvexNumberBuilderInitial, Ci as ColumnBuilderWithTableName, Cn as RlsRole, Cr as MutationReturning, Ct as MigrationStatusArgs, D as id, Di as IsPrimaryKey, Dn as ConvexAggregateIndexBuilderOn, Dr as PaginatedResult, Dt as MigrationDoc, E as ConvexIdBuilderInitial, Ei as HasDefault, En as ConvexAggregateIndexBuilder, Er as OrderDirection, Et as MigrationDirection, F as custom, Fn as ConvexVectorIndexBuilder, Fr as unsetToken, Ft as MigrationStateMap, G as ConvexBigIntBuilder, Gn as ConvexCheckConfig, Gr as ExpressionVisitor, Gt as OrmReader$1, H as ConvexBooleanBuilder, Hn as uniqueIndex, Hr as TableName, Ht as detectMigrationDrift, I as json, In as ConvexVectorIndexBuilderOn, Ir as Brand, It as MigrationStep, J as CountBackfillChunkArgs, Jn as ConvexUniqueConstraintBuilder, Jr as LogicalExpression, Jt as RlsMode, K as ConvexBigIntBuilderInitial, Kn as ConvexForeignKeyBuilder, Kr as FieldReference, Kt as OrmWriter$1, L as objectOf, Ln as ConvexVectorIndexConfig, Lr as Columns, Lt as MigrationTableName, M as ConvexCustomBuilder, Mn as ConvexSearchIndexBuilder, Mr as UpdateSet, Mt as MigrationPlan, N as ConvexCustomBuilderInitial, Nn as ConvexSearchIndexBuilderOn, Nr as VectorQueryConfig, Nt as MigrationRunStatus, O as ConvexDateBuilder, Oi as IsUnique, On as ConvexIndexBuilder, Or as PredicateWhereIndexConfig, Ot as MigrationDocContext, P as arrayOf, Pn as ConvexSearchIndexConfig, Pr as VectorSearchProvider, Pt as MigrationSet, Q as GenericOrm$1, Qn as foreignKey, Qr as contains, Qt as ExtractTablesWithRelations, R as unionOf, Rn as aggregateIndex, Rr as OrmSchemaExtensionTables, Rt as MigrationWriteMode, S as ConvexNumberBuilder, Si as ColumnBuilderTypeConfig, Sn as rlsPolicy, Sr as MutationResult, St as MigrationRunChunkArgs, T as ConvexIdBuilder, Ti as DrizzleEntity, Tn as rlsRole, Tr as OrderByClause, Tt as MigrationDefinition, U as ConvexBooleanBuilderInitial, Un as vectorIndex, Ur as SystemFields, Ut as DatabaseWithMutations, V as bytes, Vn as searchIndex, Vr as OrmSchemaTriggers, Vt as defineMigrationSet, W as boolean, Wn as ConvexCheckBuilder, Wr as BinaryExpression, Wt as DatabaseWithQuery, X as CountBackfillStatusArgs, Xn as ConvexUniqueConstraintConfig, Xr as and, Xt as extractRelationsConfig, Y as CountBackfillKickoffArgs, Yn as ConvexUniqueConstraintBuilderOn, Yr as UnaryExpression, Yt as EdgeMetadata, Z as CreateOrmOptions, Zn as check, Zr as between, Zt as ExtractTablesFromSchema, _ as ConvexTimestampMode, _i as startsWith, _n as deletion, _r as MutationExecuteConfig, _t as OrmTriggerContext, a as requireSchemaRelations, ai as inArray, an as TablesRelationalConfig, ar as AggregateResult, at as OrmWriterCtx, b as ConvexTextEnumBuilderInitial, bi as ColumnBuilderBaseConfig, bn as RlsPolicyConfig, br as MutationPaginateConfig, bt as MigrationCancelArgs, c as TableConfigResult, ci as isNull, cn as ConvexDeletionBuilder, cr as CountConfig, ct as ScheduledMutationBatchArgs, d as OrmNotFoundError, di as lte, dn as ConvexTableWithColumns, dr as FilterOperators, dt as scheduledDeleteFactory, ei as eq, en as OneConfig, er as ConvexTextBuilder, et as OrmApiResult, f as ConvexVectorBuilder, fi as ne, fn as DiscriminatorBuilderConfig, fr as GetColumnData, ft as SchemaExtension, g as ConvexTimestampBuilderInitial, gi as or, gn as convexTable, gr as InsertValue, gt as OrmTriggerChange, h as ConvexTimestampBuilder, hi as notInArray, hn as TableConfig, hr as InferSelectModel, ht as OrmTableTriggers, i as getSchemaTriggers, ii as ilike, in as TableRelationalConfig, ir as AggregateFieldValue, it as OrmReaderCtx, j as date, jn as ConvexRankIndexBuilderOn, jr as ReturningSelection, jt as MigrationMigrateOne, k as ConvexDateBuilderInitial, ki as NotNull, kn as ConvexIndexBuilderOn, kr as ReturningAll, kt as MigrationDriftIssue, l as getTableColumns, li as like, ln as ConvexDeletionConfig, lr as CountResult, lt as scheduledMutationBatchFactory, m as vector, mi as notBetween, mn as OrmLifecycleOperation, mr as InferModelFromColumns, mt as OrmBeforeResult, n as defineSchema, ni as gt, nn as RelationsBuilderColumnBase, nr as text, nt as OrmClientWithApi$1, o as asc, oi as isFieldReference, on as defineRelations, or as BuildQueryResult, ot as ResolveOrmSchema, p as ConvexVectorBuilderInitial, pi as not, pn as OrmLifecycleChange, pr as InferInsertModel, pt as defineSchemaExtension, q as bigint, qn as ConvexForeignKeyConfig, qr as FilterExpression, qt as RlsContext, r as getSchemaRelations, ri as gte, rn as RelationsBuilderColumnConfig, rr as AggregateConfig, rt as OrmFunctions, s as desc, si as isNotNull, sn as defineRelationsPart, sr as BuildRelationResult, st as createOrm, t as WhereClauseResult, ti as fieldRef, tn as RelationsBuilder, tr as ConvexTextBuilderInitial, tt as OrmClientBase$1, u as getTableConfig, ui as lt, un as ConvexTable, ur as DBQueryConfig, ut as ScheduledDeleteArgs, v as timestamp, vi as AnyColumn, vn as discriminator, vr as MutationExecuteResult, vt as OrmTriggers, w as integer, wi as ColumnDataType, wn as RlsRoleConfig, wr as MutationRunMode, wt as MigrationAppliedState, x as textEnum, xi as ColumnBuilderRuntimeConfig, xn as RlsPolicyToOption, xr as MutationPaginatedResult, xt as MigrationRunArgs, y as ConvexTextEnumBuilder, yi as ColumnBuilder, yn as RlsPolicy, yr as MutationExecutionMode, yt as defineTriggers, z as ConvexBytesBuilder, zn as index, zr as OrmSchemaExtensions, zt as buildMigrationPlan } from "../where-clause-compiler-C8UKgzTO.js";
 import { i as pretendRequired, n as deprecated, r as pretend } from "../validators-BhsByJeg.js";
 import { a as QueryCtxWithPreferredOrmQueryTable, i as QueryCtxWithOrmQueryTable, n as LookupByIdResultByCtx, o as getByIdWithOrmQueryFallback, r as QueryCtxWithOptionalOrmQueryTable, t as DocByCtx } from "../query-context-CNo9ffvI.js";
 import { DefineSchemaOptions, GenericDatabaseReader, GenericDatabaseWriter, GenericSchema, SchemaDefinition } from "convex/server";

package/dist/orm/index.js

@@ -1,6 +1,6 @@
 import { A as vectorIndex, B as ConvexColumnBuilder, C as RlsPolicy, D as rankIndex, E as index, F as arrayOf, I as custom, L as json, M as createSystemFields, N as integer, O as searchIndex, P as id, R as objectOf, S as TablePolymorphic, T as aggregateIndex, V as entityKind, _ as OrmSchemaRelations, a as deletion, b as TableDeleteConfig, c as Columns, d as OrmSchemaDefinition, f as OrmSchemaExtensionRelations, g as OrmSchemaOptions, h as OrmSchemaExtensions, i as convexTable, j as text, k as uniqueIndex, l as EnableRLS, m as OrmSchemaExtensionTriggers, o as discriminator, p as OrmSchemaExtensionTables, s as Brand, t as DirectAggregate, u as OrmContext, v as OrmSchemaTriggers, w as rlsPolicy, x as TableName, y as RlsPolicies, z as unionOf } from "../runtime-DmVSOe24.js";
 import { a as pretendRequired, i as pretend, n as deprecated } from "../validators-C7LelqTN.js";
-import { A as ne, C as inArray, D as like, E as isNull, F as notLike, I as or, L as startsWith, M as notBetween, N as notIlike, O as lt, P as notInArray, S as ilike, T as isNotNull, _ as endsWith, a as mergedStream, b as gt, c as isUnsetToken, d as arrayContained, f as arrayContains, g as contains, h as column, i as getIndexFields, j as not, k as lte, l as unsetToken, m as between, n as EmptyStream, o as stream, p as arrayOverlaps, r as QueryStream, s as streamIndexRange, t as getByIdWithOrmQueryFallback, u as and, v as eq, w as isFieldReference, x as gte, y as fieldRef } from "../query-context-ydn9kb6P.js";
+import { A as ne, C as inArray, D as like, E as isNull, F as notLike, I as or, L as startsWith, M as notBetween, N as notIlike, O as lt, P as notInArray, S as ilike, T as isNotNull, _ as endsWith, a as mergedStream, b as gt, c as isUnsetToken, d as arrayContained, f as arrayContains, g as contains, h as column, i as getIndexFields, j as not, k as lte, l as unsetToken, m as between, n as EmptyStream, o as stream, p as arrayOverlaps, r as QueryStream, s as streamIndexRange, t as getByIdWithOrmQueryFallback, u as and, v as eq, w as isFieldReference, x as gte, y as fieldRef } from "../query-context-B47_3n97.js";
 import { v } from "convex/values";
 import { defineSchema as defineSchema$1, internalActionGeneric, internalMutationGeneric } from "convex/server";
 
@@ -3849,11 +3849,11 @@ var WhereClauseCompiler = class {
 		const selectedIndex = this.findLeadingIndex(operand.fieldName);
 		if (!selectedIndex) return null;
 		return {
-			strategy: "singleIndex",
+			strategy: "rangeIndex",
 			selectedIndex,
-			indexFilters: [eq(fieldRef(operand.fieldName), null)],
+			indexFilters: [lte(fieldRef(operand.fieldName), null)],
 			probeFilters: [],
-			postFilters: []
+			postFilters: [expression]
 		};
 	}
 	tryCompileIsNotNull(expression) {
@@ -4255,6 +4255,24 @@ var WhereClauseCompiler = class {
 
 //#endregion
 //#region src/orm/query.ts
+/**
+* Operators that Convex's `.filter()` cannot express, so `_toConvexExpression`
+* compiles them to a `() => true` placeholder and `_evaluatePostFetchFilter`
+* applies the real predicate in JavaScript after the rows are read.
+* Keep in sync with the string/array cases in `_toConvexExpression`.
+*/
+const POST_FETCH_ONLY_OPERATORS = new Set([
+	"like",
+	"ilike",
+	"notLike",
+	"notIlike",
+	"startsWith",
+	"endsWith",
+	"contains",
+	"arrayContains",
+	"arrayContained",
+	"arrayOverlaps"
+]);
 const DEFAULT_RELATION_FAN_OUT_MAX_KEYS = 1e3;
 const DEFAULT_AGGREGATE_CARTESIAN_MAX_KEYS = 4096;
 const DEFAULT_AGGREGATE_WORK_BUDGET = 16384;
@@ -4531,6 +4549,28 @@ var GelRelationalQuery = class extends QueryPromise {
 		return targetValue === targetPattern;
 	}
 	/**
+	* True when the expression can be fully enforced by Convex's own `.filter()`.
+	*
+	* `_toConvexExpression` compiles the string/array operators to `() => true`
+	* because Convex filters cannot run JavaScript string methods; those are
+	* evaluated later by `_evaluatePostFetchFilter`. Pushing such an expression
+	* into `.filter()` is not merely useless, it is wrong in two ways: a `take()`
+	* downstream spends its budget on rows that have not been filtered yet, and a
+	* surrounding `NOT` turns the `true` placeholder into `q.not(true)`, which
+	* matches nothing. So the caller must know whether Convex can carry the whole
+	* expression before relying on it.
+	*/
+	_isConvexEnforceableFilter(filter) {
+		if (filter.type === "binary") return !POST_FETCH_ONLY_OPERATORS.has(filter.operator);
+		if (filter.type === "unary") {
+			const [operand] = filter.operands;
+			if (isFieldReference(operand)) return true;
+			return this._isConvexEnforceableFilter(operand);
+		}
+		if (filter.type === "logical") return filter.operands.every((operand) => this._isConvexEnforceableFilter(operand));
+		return true;
+	}
+	/**
 	* Evaluate a filter expression against a fetched row
 	* Used for post-fetch filtering (string operators, etc.)
 	*/
@@ -5340,6 +5380,38 @@ var GelRelationalQuery = class extends QueryPromise {
 		});
 		return streamQuery;
 	}
+	/**
+	* Stream equivalent of the `db.query(...)` chain, used when a post-fetch
+	* filter has to run in JavaScript before `limit` or a page boundary can be
+	* applied. `filterWith` evaluates the predicate as rows are pulled, so
+	* `take`/`paginate` size by matches instead of by scanned rows.
+	*
+	* It deliberately mirrors the index and order decisions the caller already
+	* made for the plain query rather than re-deriving them, so switching to the
+	* stream cannot change which index is scanned or in what direction.
+	*
+	* Returns null when the schema definition needed by `stream()` is missing;
+	* the caller then falls back to its plain-query path.
+	*/
+	_buildResidualFilterStream(params) {
+		const schemaDefinition = this.schema[OrmSchemaDefinition];
+		if (!schemaDefinition) return null;
+		const { queryConfig, configuredIndex, membershipFilter, orderIndexName, primaryOrder, fallbackOrder } = params;
+		let streamQuery = stream(this.db, schemaDefinition).query(this.tableConfig.name);
+		if (queryConfig.index) streamQuery = streamQuery.withIndex(queryConfig.index.name, (q) => {
+			let indexQuery = q;
+			for (const filter of queryConfig.index.filters) indexQuery = this._applyFilterToQuery(indexQuery, filter);
+			return indexQuery;
+		});
+		else if (configuredIndex?.name) streamQuery = streamQuery.withIndex(configuredIndex.name, configuredIndex.range ? configuredIndex.range : (q) => q);
+		else if (orderIndexName) streamQuery = streamQuery.withIndex(orderIndexName, (q) => q);
+		streamQuery = streamQuery.order(primaryOrder ? primaryOrder.direction : fallbackOrder);
+		streamQuery = streamQuery.filterWith(async (row) => {
+			for (const filter of queryConfig.postFilters) if (!this._evaluatePostFetchFilter(row, filter)) return false;
+			return membershipFilter ? await membershipFilter(row) : true;
+		});
+		return streamQuery;
+	}
 	_buildUnionSourceStream(source, fallbackOrder) {
 		const configuredIndex = this.configuredIndex;
 		this._assertWhereIndexRequirement({
@@ -6652,6 +6724,12 @@ var GelRelationalQuery = class extends QueryPromise {
 			const selectedRows = await this._finalizeRows(rows);
 			return this._returnSelectedRows(selectedRows);
 		}
+		const matchesPostFetchMembership = async (row) => {
+			const visibleRows = await this._applyRlsSelectFilter([row], this.tableConfig);
+			if (visibleRows.length === 0) return false;
+			if (!whereFilter) return true;
+			return (await this._applyRelationsFilterToRows(visibleRows, this.tableConfig, whereFilter, this.edgeMetadata, 0, 3, this.config.with)).length > 0;
+		};
 		if (isCursorPaginated) {
 			if (queryConfig.strategy === "multiProbe") if (maxScan === void 0) {
 				if (strict) throw new Error("Pagination with multi-probe index-union filters requires maxScan when strict=true. Add maxScan or make the query indexable.");
@@ -6716,9 +6794,40 @@ var GelRelationalQuery = class extends QueryPromise {
 					splitCursor: paginationResult.splitCursor
 				};
 			}
-			if (queryConfig.postFilters.length > 0) query = query.filter((q) => {
+			const convexPostFilters = queryConfig.postFilters.filter((filter) => this._isConvexEnforceableFilter(filter));
+			const hasResidualPostFilter = convexPostFilters.length !== queryConfig.postFilters.length;
+			const residualPageStream = hasResidualPostFilter ? this._buildResidualFilterStream({
+				queryConfig,
+				configuredIndex,
+				membershipFilter: matchesPostFetchMembership,
+				orderIndexName,
+				primaryOrder,
+				fallbackOrder: "desc"
+			}) : null;
+			if (hasResidualPostFilter && !residualPageStream) this._getSchemaDefinitionOrThrow();
+			if (residualPageStream) {
+				if (queryConfig.order && primaryOrder) {
+					if (needsPostFetchSortForPrimary && strict) throw new Error(`Pagination: Field '${primaryOrder.field}' has no index. Add an index or disable strict.`);
+					if (needsPostFetchSortForPrimary) console.warn(`Pagination: Field '${primaryOrder.field}' has no index. Falling back to _creationTime ordering.`);
+					if (hasSecondaryOrders) console.warn("Pagination: Only the first orderBy field is used for cursor ordering. Secondary orderBy fields are applied per page and may be unstable across pages.");
+				}
+				const paginationResult = await residualPageStream.paginate({
+					cursor: cursor ?? null,
+					endCursor: endCursor ?? void 0,
+					limit: config.limit,
+					maxScan
+				});
+				return {
+					page: await this._finalizeRows(paginationResult.page),
+					continueCursor: paginationResult.continueCursor,
+					isDone: paginationResult.isDone,
+					pageStatus: paginationResult.pageStatus,
+					splitCursor: paginationResult.splitCursor
+				};
+			}
+			if (convexPostFilters.length > 0) query = query.filter((q) => {
 				let result = null;
-				for (const filter of queryConfig.postFilters) {
+				for (const filter of convexPostFilters) {
 					const expr = this._toConvexExpression(filter)(q);
 					result = result ? q.and(result, expr) : expr;
 				}
@@ -6745,9 +6854,11 @@ var GelRelationalQuery = class extends QueryPromise {
 				isDone: paginationResult.isDone
 			};
 		}
-		if (queryConfig.postFilters.length > 0) query = query.filter((q) => {
+		const convexPostFilters = queryConfig.postFilters.filter((filter) => this._isConvexEnforceableFilter(filter));
+		const hasResidualPostFilter = convexPostFilters.length !== queryConfig.postFilters.length;
+		if (convexPostFilters.length > 0) query = query.filter((q) => {
 			let result = null;
-			for (const filter of queryConfig.postFilters) {
+			for (const filter of convexPostFilters) {
 				const expr = this._toConvexExpression(filter)(q);
 				result = result ? q.and(result, expr) : expr;
 			}
@@ -6757,11 +6868,29 @@ var GelRelationalQuery = class extends QueryPromise {
 		if (typeof offset !== "number") throw new Error("Only numeric offset is supported in kitcn ORM.");
 		const limit = this._resolveNonPaginatedLimit(config);
 		const paginateAfterPostFetchSort = usePostFetchSort && postFetchOrders.length > 0;
-		let rows = limit === void 0 || paginateAfterPostFetchSort ? await query.collect() : await query.take(offset > 0 ? offset + limit : limit);
-		if (!paginateAfterPostFetchSort && offset > 0) rows = rows.slice(offset);
+		const sizeAfterPostFilter = hasResidualPostFilter && !paginateAfterPostFetchSort;
+		const residualLimitStream = sizeAfterPostFilter && limit !== void 0 ? this._buildResidualFilterStream({
+			queryConfig,
+			configuredIndex,
+			membershipFilter: matchesPostFetchMembership,
+			orderIndexName,
+			primaryOrder,
+			fallbackOrder: "asc"
+		}) : null;
+		let rows;
+		if (residualLimitStream) rows = await residualLimitStream.take(offset > 0 ? offset + limit : limit);
+		else if (limit === void 0 || paginateAfterPostFetchSort || hasResidualPostFilter) rows = await query.collect();
+		else rows = await query.take(offset > 0 ? offset + limit : limit);
+		if (!(paginateAfterPostFetchSort || sizeAfterPostFilter) && offset > 0) rows = rows.slice(offset);
 		if (queryConfig.postFilters.length > 0) rows = rows.filter((row) => queryConfig.postFilters.every((filter) => this._evaluatePostFetchFilter(row, filter)));
-		rows = await this._applyRlsSelectFilter(rows, this.tableConfig);
-		if (whereFilter) rows = await this._applyRelationsFilterToRows(rows, this.tableConfig, whereFilter, this.edgeMetadata, 0, 3, this.config.with);
+		if (!residualLimitStream) {
+			rows = await this._applyRlsSelectFilter(rows, this.tableConfig);
+			if (whereFilter) rows = await this._applyRelationsFilterToRows(rows, this.tableConfig, whereFilter, this.edgeMetadata, 0, 3, this.config.with);
+		}
+		if (sizeAfterPostFilter) {
+			if (offset > 0) rows = rows.slice(offset);
+			if (limit !== void 0) rows = rows.slice(0, limit);
+		}
 		if (usePostFetchSort && postFetchOrders.length > 0) rows = rows.sort((a, b) => this._compareByOrderSpecs(a, b, postFetchOrders));
 		if (paginateAfterPostFetchSort) {
 			if (offset > 0) rows = rows.slice(offset);
@@ -10122,6 +10251,8 @@ function scheduledDeleteFactory(schema, edgeMetadata, scheduledMutationBatch) {
 
 //#endregion
 //#region src/orm/scheduled-mutation-batch.ts
+/** Column stamped by `softDeleteRow`; see mutation-utils.ts. */
+const DELETION_TIME_FIELD = "deletionTime";
 const isRecord = (value) => !!value && typeof value === "object" && !Array.isArray(value);
 function scheduledMutationBatchFactory(schema, edgeMetadata, scheduledMutationBatch) {
 	const tableByName = /* @__PURE__ */ new Map();
@@ -10185,12 +10316,17 @@ function scheduledMutationBatchFactory(schema, edgeMetadata, scheduledMutationBa
 		const targetValues = decodeUndefinedDeep(args.targetValues);
 		if (!targetValues || !Array.isArray(targetValues)) throw new Error("scheduledMutationBatch: targetValues are required for cascade work.");
 		if (!args.foreignIndexName) throw new Error("scheduledMutationBatch: foreignIndexName is required for cascade work.");
-		const queryWithIndex = () => ctx.db.query(args.table).withIndex(args.foreignIndexName, (q) => {
-			let builder = q.eq(sourceColumns[0], targetValues[0]);
-			for (let i = 1; i < sourceColumns.length; i += 1) builder = builder.eq(sourceColumns[i], targetValues[i]);
-			return builder;
-		});
 		const action = args.foreignAction ?? "no action";
+		const skipSoftDeletedRows = workType === "cascade-delete" && action === "cascade" && (args.cascadeMode ?? "hard") === "soft";
+		const queryWithIndex = () => {
+			const indexed = ctx.db.query(args.table).withIndex(args.foreignIndexName, (q) => {
+				let builder = q.eq(sourceColumns[0], targetValues[0]);
+				for (let i = 1; i < sourceColumns.length; i += 1) builder = builder.eq(sourceColumns[i], targetValues[i]);
+				return builder;
+			});
+			if (!skipSoftDeletedRows) return indexed;
+			return indexed.filter((q) => q.or(q.eq(q.field(DELETION_TIME_FIELD), void 0), q.eq(q.field(DELETION_TIME_FIELD), null)));
+		};
 		const paged = await queryWithIndex().paginate({
 			cursor: null,
 			numItems: args.batchSize

package/dist/{query-context-ydn9kb6P.js → query-context-B47_3n97.js}

@@ -1136,7 +1136,7 @@ var FlatMapStreamIterator = class {
 		let innerStream;
 		if (t === null) innerStream = this.singletonSkipInnerStream();
 		else {
-			innerStream = await this.#mapper(t);
+			innerStream = await this.#mapper(t, indexKey);
 			if (!equalIndexFields(innerStream.getIndexFields(), this.#mappedIndexFields)) throw new Error(`FlatMapStream: inner stream has different index fields than expected: ${JSON.stringify(innerStream.getIndexFields())} vs ${JSON.stringify(this.#mappedIndexFields)}`);
 			if (innerStream.getOrder() !== this.#outerStream.getOrder()) throw new Error(`FlatMapStream: inner stream has different order than outer stream: ${innerStream.getOrder()} vs ${this.#outerStream.getOrder()}`);
 		}
@@ -1210,14 +1210,32 @@ var FlatMapStream = class FlatMapStream extends QueryStream {
 			upperBound: outerUpperBound,
 			upperBoundInclusive: innerUpperBound.length === 0 ? indexBounds.upperBoundInclusive : true
 		};
-		const innerIndexBounds = {
-			lowerBound: innerLowerBound,
-			lowerBoundInclusive: innerLowerBound.length === 0 ? true : indexBounds.lowerBoundInclusive,
-			upperBound: innerUpperBound,
-			upperBoundInclusive: innerUpperBound.length === 0 ? true : indexBounds.upperBoundInclusive
+		const unrestricted = {
+			lowerBound: [],
+			lowerBoundInclusive: true,
+			upperBound: [],
+			upperBoundInclusive: true
 		};
-		return new FlatMapStream(this.#stream.narrow(outerIndexBounds), async (t) => {
-			return (await this.#mapper(t)).narrow(innerIndexBounds);
+		const isBoundaryParent = (parentKey, bound) => bound.length === outerLength && compareKeys({
+			value: parentKey,
+			kind: "exact"
+		}, {
+			value: bound,
+			kind: "exact"
+		}) === 0;
+		const innerBoundsForParent = (parentKey) => {
+			const atLowerBound = innerLowerBound.length > 0 && isBoundaryParent(parentKey, outerLowerBound);
+			const atUpperBound = innerUpperBound.length > 0 && isBoundaryParent(parentKey, outerUpperBound);
+			if (!(atLowerBound || atUpperBound)) return unrestricted;
+			return {
+				lowerBound: atLowerBound ? innerLowerBound : unrestricted.lowerBound,
+				lowerBoundInclusive: atLowerBound ? indexBounds.lowerBoundInclusive : true,
+				upperBound: atUpperBound ? innerUpperBound : unrestricted.upperBound,
+				upperBoundInclusive: atUpperBound ? indexBounds.upperBoundInclusive : true
+			};
+		};
+		return new FlatMapStream(this.#stream.narrow(outerIndexBounds), async (t, parentKey) => {
+			return (await this.#mapper(t, parentKey)).narrow(innerBoundsForParent(parentKey));
 		}, this.#mappedIndexFields);
 	}
 };

package/dist/{where-clause-compiler-WF9UcrAB.d.ts → where-clause-compiler-C8UKgzTO.d.ts}

@@ -2436,6 +2436,19 @@ declare class GelRelationalQuery<TSchema extends TablesRelationalConfig, TTableC
   private _compareByOrderSpecs;
   private _getTableConfigByDbName;
   private _matchLike;
+  /**
+   * True when the expression can be fully enforced by Convex's own `.filter()`.
+   *
+   * `_toConvexExpression` compiles the string/array operators to `() => true`
+   * because Convex filters cannot run JavaScript string methods; those are
+   * evaluated later by `_evaluatePostFetchFilter`. Pushing such an expression
+   * into `.filter()` is not merely useless, it is wrong in two ways: a `take()`
+   * downstream spends its budget on rows that have not been filtered yet, and a
+   * surrounding `NOT` turns the `true` placeholder into `q.not(true)`, which
+   * matches nothing. So the caller must know whether Convex can carry the whole
+   * expression before relying on it.
+   */
+  private _isConvexEnforceableFilter;
   /**
    * Evaluate a filter expression against a fetched row
    * Used for post-fetch filtering (string operators, etc.)
@@ -2471,6 +2484,20 @@ declare class GelRelationalQuery<TSchema extends TablesRelationalConfig, TTableC
   private _createFilterOperators;
   private _resolveWhereCallbackExpression;
   private _buildBasePipelineStream;
+  /**
+   * Stream equivalent of the `db.query(...)` chain, used when a post-fetch
+   * filter has to run in JavaScript before `limit` or a page boundary can be
+   * applied. `filterWith` evaluates the predicate as rows are pulled, so
+   * `take`/`paginate` size by matches instead of by scanned rows.
+   *
+   * It deliberately mirrors the index and order decisions the caller already
+   * made for the plain query rather than re-deriving them, so switching to the
+   * stream cannot change which index is scanned or in what direction.
+   *
+   * Returns null when the schema definition needed by `stream()` is missing;
+   * the caller then falls back to its plain-query path.
+   */
+  private _buildResidualFilterStream;
   private _buildUnionSourceStream;
   private _applyFlatMapStage;
   private _applyPipelineStages;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitcn",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "kitcn - React Query integration and CLI tools for Convex",
   "keywords": [
     "convex",