@classytic/mongokit 3.10.3 → 3.11.1

package/dist/{validation-chain.plugin-D-yH2f8a.mjs → validation-chain.plugin-Dllv-cml.mjs}

@@ -1,7 +1,7 @@
 import { n as debug, r as warn } from "./logger-DJ7egMnd.mjs";
-import { _ as upsert, a as count, b as LookupBuilder, c as getByQuery, d as deleteById, f as deleteByQuery, h as createMany, l as getOrCreate, m as create, n as update, o as exists, r as updateByQuery, s as getById, t as findOneAndUpdate, y as distinct } from "./update-CWXfFC6O.mjs";
-import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-CzYwrfUP.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-B93fLCcO.mjs";
+import { _ as upsert, a as count, b as LookupBuilder, c as getByQuery, d as deleteById, f as deleteByQuery, h as createMany, l as getOrCreate, m as create, n as update, o as exists, r as updateByQuery, s as getById, t as findOneAndUpdate, y as distinct } from "./update-DEJYcgfV.mjs";
+import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-B00pI7dV.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-CvDFfVXT.mjs";
 import { hasNearOperator, rewriteNearForCount } from "./query/primitives/geo.mjs";
 import { r as isValidIdForType, t as getSchemaIdType } from "./id-resolution-e4BT9zAV.mjs";
 import { a as byIdKey, c as listQueryKey, l as modelPattern, o as byQueryKey, r as getFieldsForUser, u as versionKey } from "./field-selection-dI0m4RBs.mjs";
@@ -9,6 +9,7 @@ import mongoose from "mongoose";
 import { isFilter } from "@classytic/repo-core/filter";
 import { HOOK_PRIORITY } from "@classytic/repo-core/hooks";
 import { RepositoryBase, validatePluginOrder } from "@classytic/repo-core/repository";
+import { compileUpdateSpecToMongo, isUpdateSpec } from "@classytic/repo-core/update";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/operations.ts
 /**
@@ -654,7 +655,7 @@ var AuditTrailQuery = class {
 //#endregion
 //#region src/plugins/batch-operations.plugin.ts
 /**
-* Batch operations plugin
+* Batch operations plugin.
 *
 * @example
 * const repo = new Repository(Model, [
@@ -662,8 +663,12 @@ var AuditTrailQuery = class {
 *   batchOperationsPlugin(),
 * ]);
 *
+* // updateMany + deleteMany are primitives on Repository — no plugin needed.
 * await repo.updateMany({ status: 'pending' }, { status: 'active' });
 * await repo.deleteMany({ status: 'deleted' });
+*
+* // bulkWrite is what this plugin contributes.
+* await repo.bulkWrite([...ops]);
 */
 function batchOperationsPlugin() {
 	return {
@@ -671,38 +676,6 @@ function batchOperationsPlugin() {
 		apply(repo) {
 			if (!repo.registerMethod) throw new Error("batchOperationsPlugin requires methodRegistryPlugin");
 			/**
-			* Update multiple documents
-			*/
-			repo.registerMethod("updateMany", async function(query, data, options = {}) {
-				const context = await this._buildContext("updateMany", {
-					query,
-					data,
-					...options
-				});
-				try {
-					const finalQuery = context.query || query;
-					if (!finalQuery || Object.keys(finalQuery).length === 0) throw createError(400, "updateMany requires a non-empty query filter. Pass an explicit filter to prevent accidental mass updates.");
-					if (Array.isArray(data) && options.updatePipeline !== true) throw createError(400, "Update pipelines (array updates) are disabled by default; pass `{ updatePipeline: true }` to explicitly allow pipeline-style updates.");
-					const finalData = context.data || data;
-					const result = await this.Model.updateMany(finalQuery, finalData, {
-						runValidators: true,
-						session: options.session,
-						...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
-					}).exec();
-					await this.emitAsync("after:updateMany", {
-						context,
-						result
-					});
-					return result;
-				} catch (error) {
-					this.emit("error:updateMany", {
-						context,
-						error
-					});
-					throw this._handleError(error);
-				}
-			});
-			/**
 			* Execute heterogeneous bulk write operations in a single database call.
 			*
 			* Supports insertOne, updateOne, updateMany, deleteOne, deleteMany, and replaceOne
@@ -751,53 +724,6 @@ function batchOperationsPlugin() {
 					throw this._handleError(error);
 				}
 			});
-			/**
-			* Delete multiple documents matching a query.
-			*
-			* Behavior mirrors `Repository.delete`: defaults to soft-delete when
-			* `softDeletePlugin` is wired, physical delete otherwise. Pass
-			* `{ mode: 'hard' }` to bypass soft-delete for GDPR / cleanup paths —
-			* multi-tenant scoping and audit hooks still fire.
-			*
-			* Rejects empty filters even after policy hooks run, to prevent
-			* accidental collection wipes.
-			*/
-			repo.registerMethod("deleteMany", async function(query, options = {}) {
-				if (!query || Object.keys(query).length === 0) throw createError(400, "deleteMany requires a non-empty query filter. Pass an explicit filter to prevent accidental mass deletes.");
-				const mode = options.mode;
-				const context = await this._buildContext("deleteMany", {
-					query,
-					...options,
-					...mode ? { deleteMode: mode } : {}
-				});
-				try {
-					if (context.softDeleted) {
-						const result = {
-							acknowledged: true,
-							deletedCount: 0
-						};
-						await this.emitAsync("after:deleteMany", {
-							context,
-							result
-						});
-						return result;
-					}
-					const finalQuery = context.query || query;
-					if (!finalQuery || Object.keys(finalQuery).length === 0) throw createError(400, "deleteMany requires a non-empty query filter after policy hooks.");
-					const result = await this.Model.deleteMany(finalQuery, { session: options.session }).exec();
-					await this.emitAsync("after:deleteMany", {
-						context,
-						result
-					});
-					return result;
-				} catch (error) {
-					this.emit("error:deleteMany", {
-						context,
-						error
-					});
-					throw this._handleError(error);
-				}
-			});
 		}
 	};
 }
@@ -1817,22 +1743,25 @@ var Repository = class extends RepositoryBase {
 		}
 	}
 	/**
-	* Create single document
+	* Run a Repository operation under the standard envelope:
+	*   - invoke `fn`, emit `after:<op>` with `{ context, result }` on success
+	*   - emit `error:<op>` and rethrow via `_handleError` on failure
+	*
+	* Methods with branched in-try logic that emit `after:*` from multiple
+	* paths (`getById`, `update`, `delete`, `deleteMany`, `aggregatePaginate`,
+	* `lookupPopulate`) intentionally keep their inline try/catch rather than
+	* being restructured to return a single result through this helper.
 	*/
-	async create(data, options = {}) {
-		const context = await this._buildContext("create", {
-			data,
-			...options
-		});
+	async _runOp(op, context, fn) {
 		try {
-			const result = await create(this.Model, context.data || data, options);
-			await this._emitHook("after:create", {
+			const result = await fn();
+			await this._emitHook(`after:${op}`, {
 				context,
 				result
 			});
 			return result;
 		} catch (error) {
-			await this._emitErrorHook("error:create", {
+			await this._emitErrorHook(`error:${op}`, {
 				context,
 				error
 			});
@@ -1840,6 +1769,16 @@ var Repository = class extends RepositoryBase {
 		}
 	}
 	/**
+	* Create single document
+	*/
+	async create(data, options = {}) {
+		const context = await this._buildContext("create", {
+			data,
+			...options
+		});
+		return this._runOp("create", context, () => create(this.Model, context.data || data, options));
+	}
+	/**
 	* Create multiple documents
 	*/
 	async createMany(dataArray, options = {}) {
@@ -1847,20 +1786,7 @@ var Repository = class extends RepositoryBase {
 			dataArray,
 			...options
 		});
-		try {
-			const result = await createMany(this.Model, context.dataArray || dataArray, options);
-			await this._emitHook("after:createMany", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:createMany", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		return this._runOp("createMany", context, () => createMany(this.Model, context.dataArray || dataArray, options));
 	}
 	/**
 	* Get document by ID
@@ -1934,20 +1860,7 @@ var Repository = class extends RepositoryBase {
 			return cachedResult;
 		}
 		const finalQuery = context.query || query;
-		try {
-			const result = await getByQuery(this.Model, finalQuery, context);
-			await this._emitHook("after:getByQuery", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:getByQuery", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		return this._runOp("getByQuery", context, () => getByQuery(this.Model, finalQuery, context));
 	}
 	/**
 	* Get single document by arbitrary filter.
@@ -1974,20 +1887,7 @@ var Repository = class extends RepositoryBase {
 			return cachedResult;
 		}
 		const finalQuery = context.query || query;
-		try {
-			const result = await getByQuery(this.Model, finalQuery, context);
-			await this._emitHook("after:getOne", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:getOne", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		return this._runOp("getOne", context, () => getByQuery(this.Model, finalQuery, context));
 	}
 	/**
 	* Fetch ALL documents matching filters without pagination.
@@ -2003,7 +1903,7 @@ var Repository = class extends RepositoryBase {
 			...options
 		});
 		const resolvedFilters = context.query ?? filters;
-		try {
+		return this._runOp("findAll", context, async () => {
 			const query = this.Model.find(resolvedFilters);
 			const sortSpec = context.sort || options.sort;
 			if (sortSpec) query.sort(this._parseSort(sortSpec));
@@ -2013,19 +1913,8 @@ var Repository = class extends RepositoryBase {
 			if (context.lean ?? options.lean ?? true) query.lean();
 			if (options.session) query.session(options.session);
 			if (options.readPreference) query.read(options.readPreference);
-			const result = await query.exec();
-			await this._emitHook("after:findAll", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:findAll", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+			return await query.exec();
+		});
 	}
 	/**
 	* Unified pagination - auto-detects offset vs keyset based on params
@@ -2098,8 +1987,8 @@ var Repository = class extends RepositoryBase {
 			collation: context.collation ?? params.collation
 		};
 		const lookups = context.lookups ?? params.lookups;
-		if (lookups && lookups.length > 0) try {
-			const result = await this.lookupPopulate({
+		if (lookups && lookups.length > 0) return this._runOp("getAll", context, async () => {
+			return await this.lookupPopulate({
 				filters: query,
 				lookups,
 				sort: paginationOptions.sort,
@@ -2112,19 +2001,8 @@ var Repository = class extends RepositoryBase {
 				collation: paginationOptions.collation,
 				countStrategy: context.countStrategy ?? params.countStrategy
 			});
-			await this._emitHook("after:getAll", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:getAll", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
-		try {
+		});
+		return this._runOp("getAll", context, async () => {
 			let result;
 			if (useKeyset) result = await this._pagination.stream({
 				...paginationOptions,
@@ -2146,18 +2024,8 @@ var Repository = class extends RepositoryBase {
 					countStrategy: context.countStrategy ?? params.countStrategy ?? forcedCountStrategy
 				});
 			}
-			await this._emitHook("after:getAll", {
-				context,
-				result
-			});
 			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:getAll", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		});
 	}
 	/**
 	* Get or create document
@@ -2169,22 +2037,11 @@ var Repository = class extends RepositoryBase {
 			data: createData,
 			...options
 		});
-		try {
+		return this._runOp("getOrCreate", context, () => {
 			const finalQuery = context.query || query;
 			const finalData = context.data || createData;
-			const result = await getOrCreate(this.Model, finalQuery, finalData, options);
-			await this._emitHook("after:getOrCreate", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:getOrCreate", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+			return getOrCreate(this.Model, finalQuery, finalData, options);
+		});
 	}
 	/**
 	* Count documents
@@ -2195,21 +2052,7 @@ var Repository = class extends RepositoryBase {
 			query,
 			...options
 		});
-		try {
-			const finalQuery = context.query || query;
-			const result = await count(this.Model, finalQuery, options);
-			await this._emitHook("after:count", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:count", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		return this._runOp("count", context, () => count(this.Model, context.query || query, options));
 	}
 	/**
 	* Check if document exists
@@ -2220,21 +2063,7 @@ var Repository = class extends RepositoryBase {
 			query,
 			...options
 		});
-		try {
-			const finalQuery = context.query || query;
-			const result = await exists(this.Model, finalQuery, options);
-			await this._emitHook("after:exists", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:exists", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		return this._runOp("exists", context, () => exists(this.Model, context.query || query, options));
 	}
 	/**
 	* Update document by ID
@@ -2308,33 +2137,23 @@ var Repository = class extends RepositoryBase {
 	* ```
 	*/
 	async findOneAndUpdate(filter, update, options = {}) {
+		const normalizedUpdate = isUpdateSpec(update) ? compileUpdateSpecToMongo(update) : update;
 		const context = await this._buildContext("findOneAndUpdate", {
 			query: filter,
-			data: update,
+			data: normalizedUpdate,
 			...options
 		});
-		try {
+		return this._runOp("findOneAndUpdate", context, async () => {
 			const finalQuery = context.query || filter;
-			const finalUpdate = context.data || update;
-			const result = await findOneAndUpdate(this.Model, finalQuery, finalUpdate, {
+			const finalUpdate = context.data || normalizedUpdate;
+			return await findOneAndUpdate(this.Model, finalQuery, finalUpdate, {
 				...options,
 				sort: options.sort,
 				returnDocument: options.returnDocument ?? "after",
 				upsert: options.upsert ?? false,
 				session: options.session
 			});
-			await this._emitHook("after:findOneAndUpdate", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:findOneAndUpdate", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		});
 	}
 	/**
 	* Delete a document by ID.
@@ -2417,6 +2236,96 @@ var Repository = class extends RepositoryBase {
 		}
 	}
 	/**
+	* Update every document matching the filter.
+	*
+	* Promoted from `batchOperationsPlugin` to a class primitive in 3.11.0 so
+	* the surface matches sqlitekit's always-available `updateMany`. Consumers
+	* who forget to wire `batchOperationsPlugin` no longer get a runtime
+	* `TypeError: repo.updateMany is not a function` — the method is always
+	* here.
+	*
+	* Accepts three `update` forms via `UpdateInput`:
+	*   - Portable `UpdateSpec` from `@classytic/repo-core/update` (compiled to
+	*     `$set`/`$unset`/`$inc`/`$setOnInsert` before hooks run).
+	*   - Raw Mongo operator record (`{ $set, $inc, ... }`) — passed through.
+	*   - Mongo aggregation pipeline (`[...]`) — requires `updatePipeline: true`
+	*     to guard against accidental pipeline updates.
+	*
+	* Refuses empty filters (defense-in-depth against mass-update accidents)
+	* both before and after policy hooks inject tenant scope.
+	*/
+	async updateMany(filter, update, options = {}) {
+		const normalizedData = isUpdateSpec(update) ? compileUpdateSpecToMongo(update) : update;
+		const context = await this._buildContext("updateMany", {
+			query: filter,
+			data: normalizedData,
+			...options
+		});
+		return this._runOp("updateMany", context, async () => {
+			const finalQuery = context.query || filter;
+			if (!finalQuery || Object.keys(finalQuery).length === 0) throw createError(400, "updateMany requires a non-empty query filter. Pass an explicit filter to prevent accidental mass updates.");
+			if (Array.isArray(normalizedData) && options.updatePipeline !== true) throw createError(400, "Update pipelines (array updates) are disabled by default; pass `{ updatePipeline: true }` to explicitly allow pipeline-style updates.");
+			const finalData = context.data || normalizedData;
+			return await this.Model.updateMany(finalQuery, finalData, {
+				runValidators: true,
+				session: options.session,
+				...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
+			}).exec();
+		});
+	}
+	/**
+	* Delete every document matching the filter.
+	*
+	* Promoted from `batchOperationsPlugin` to a class primitive in 3.11.0 for
+	* the same reason as `updateMany` — sqlitekit parity and no silent "method
+	* is undefined" footgun when the batch plugin isn't wired.
+	*
+	* Behavior mirrors `delete()`: defaults to soft delete when
+	* `softDeletePlugin` is wired, physical delete otherwise. Pass
+	* `{ mode: 'hard' }` to bypass soft-delete — multi-tenant scoping, audit,
+	* and cache hooks still fire.
+	*
+	* Rejects empty filters up front AND after policy hooks, so a policy-plugin
+	* bug that zeroes out the query can't be exploited to wipe a collection.
+	*/
+	async deleteMany(filter, options = {}) {
+		if (!filter || Object.keys(filter).length === 0) throw createError(400, "deleteMany requires a non-empty query filter. Pass an explicit filter to prevent accidental mass deletes.");
+		const mode = options.mode;
+		const context = await this._buildContext("deleteMany", {
+			query: filter,
+			...options,
+			...mode ? { deleteMode: mode } : {}
+		});
+		try {
+			if (context.softDeleted) {
+				const result = {
+					acknowledged: true,
+					deletedCount: 0,
+					soft: true
+				};
+				await this._emitHook("after:deleteMany", {
+					context,
+					result
+				});
+				return result;
+			}
+			const finalQuery = context.query || filter;
+			if (!finalQuery || Object.keys(finalQuery).length === 0) throw createError(400, "deleteMany requires a non-empty query filter after policy hooks.");
+			const result = await this.Model.deleteMany(finalQuery, { session: options.session }).exec();
+			await this._emitHook("after:deleteMany", {
+				context,
+				result
+			});
+			return result;
+		} catch (error) {
+			await this._emitErrorHook("error:deleteMany", {
+				context,
+				error
+			});
+			throw this._handleError(error);
+		}
+	}
+	/**
 	* Kit-native aggregation pipeline — takes a MongoDB stage array and
 	* returns the raw pipeline output. Use this for `$lookup`, `$unwind`,
 	* `$facet`, `$graphLookup`, and any other mongo-specific power
@@ -2440,7 +2349,7 @@ var Repository = class extends RepositoryBase {
 		});
 		const maxStages = options.maxPipelineStages;
 		if (maxStages && pipeline.length > maxStages) throw createError(400, `Aggregation pipeline exceeds maximum allowed stages (${pipeline.length} > ${maxStages})`);
-		try {
+		return this._runOp("aggregatePipeline", context, async () => {
 			const finalPipeline = [...pipeline];
 			if (context.query && Object.keys(context.query).length > 0) finalPipeline.unshift({ $match: context.query });
 			const aggregation = this.Model.aggregate(finalPipeline);
@@ -2451,19 +2360,8 @@ var Repository = class extends RepositoryBase {
 			if (options.comment) aggregation.option({ comment: options.comment });
 			if (options.readConcern) aggregation.option({ readConcern: options.readConcern });
 			if (options.collation) aggregation.collation(options.collation);
-			const result = await aggregation.exec();
-			await this._emitHook("after:aggregatePipeline", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:aggregatePipeline", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+			return await aggregation.exec();
+		});
 	}
 	/**
 	* Paginated kit-native aggregation pipeline. Same mongo-specific
@@ -2485,20 +2383,7 @@ var Repository = class extends RepositoryBase {
 			...context,
 			pipeline: finalPipeline
 		};
-		try {
-			const result = await this._pagination.aggregatePaginate(aggOptions);
-			await this._emitHook("after:aggregatePipelinePaginate", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:aggregatePipelinePaginate", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		return this._runOp("aggregatePipelinePaginate", context, () => this._pagination.aggregatePaginate(aggOptions));
 	}
 	/**
 	* Portable aggregation. Compiles the repo-core `AggRequest` IR to
@@ -2524,21 +2409,10 @@ var Repository = class extends RepositoryBase {
 	*/
 	async aggregate(req) {
 		const context = await this._buildContext("aggregate", { aggRequest: req });
-		try {
+		return this._runOp("aggregate", context, async () => {
 			const finalReq = this._injectPolicyScopeIntoAgg(req, context);
-			const result = { rows: await executeAgg(this.Model, finalReq, { session: context.session }) };
-			await this._emitHook("after:aggregate", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:aggregate", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+			return { rows: await executeAgg(this.Model, finalReq, { session: context.session }) };
+		});
 	}
 	/**
 	* Offset-paginated portable aggregation. Same IR as `aggregate`,
@@ -2642,25 +2516,14 @@ var Repository = class extends RepositoryBase {
 			query,
 			...options
 		});
-		try {
+		return this._runOp("distinct", context, () => {
 			const finalQuery = context.query || query;
 			const readPreference = context.readPreference ?? options.readPreference;
-			const result = await distinct(this.Model, field, finalQuery, {
+			return distinct(this.Model, field, finalQuery, {
 				session: options.session,
 				readPreference
 			});
-			await this._emitHook("after:distinct", {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook("error:distinct", {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		});
 	}
 	/**
 	* Query with custom field lookups ($lookup)
@@ -2941,20 +2804,7 @@ var Repository = class extends RepositoryBase {
 	async _executeQuery(buildQuery) {
 		const operation = buildQuery.name || "custom";
 		const context = await this._buildContext(operation, {});
-		try {
-			const result = await buildQuery(this.Model);
-			await this._emitHook(`after:${operation}`, {
-				context,
-				result
-			});
-			return result;
-		} catch (error) {
-			await this._emitErrorHook(`error:${operation}`, {
-				context,
-				error
-			});
-			throw this._handleError(error);
-		}
+		return this._runOp(operation, context, () => buildQuery(this.Model));
 	}
 	/**
 	* Build operation context and run before-hooks (sorted by priority).
@@ -3042,7 +2892,22 @@ var Repository = class extends RepositoryBase {
 				];
 			} else query.$or = orConds;
 		} else if (this._hasTextIndex) query.$text = { $search: search };
-		else throw createError(400, `No text index found for ${this.model}. Cannot perform text search. Configure Repository with searchMode: 'regex' (and searchFields) or 'auto' to enable index-free search.`);
+		else {
+			const modelName = String(this.model);
+			throw createError(400, `No text index found for ${modelName}. Cannot perform text search. Configure ${modelName}'s Repository with { searchMode: 'regex', searchFields: [...] } to enable index-free search, or create a text index on the collection for searchMode: 'text'. See https://github.com/classytic/mongokit/blob/main/docs/README.md#queryparser-url--filter`, {
+				code: "SEARCH_NOT_CONFIGURED",
+				meta: {
+					model: modelName,
+					configuredMode: this.searchMode,
+					availableModes: [
+						"text",
+						"regex",
+						"auto"
+					],
+					docs: "https://github.com/classytic/mongokit/blob/main/docs/README.md#queryparser-url--filter"
+				}
+			});
+		}
 		return query;
 	}
 	/**
@@ -3787,7 +3652,7 @@ function cascadePlugin(options) {
 */
 async function cascadeViaRepoBulk(relation, parentId, ctx) {
 	const targetRepo = relation.repo;
-	if (typeof targetRepo.deleteMany !== "function") throw new Error(`cascadePlugin: target repo for '${ctx.targetModelName}' is missing deleteMany(). Wire batchOperationsPlugin() + methodRegistryPlugin() on the target repo.`);
+	if (typeof targetRepo.deleteMany !== "function") throw new Error(`cascadePlugin: target repo for '${ctx.targetModelName}' is missing deleteMany(). Ensure the target is a mongokit Repository or implements the StandardRepo deleteMany contract.`);
 	await targetRepo.deleteMany({ [relation.foreignKey]: parentId }, {
 		...ctx.scopeForward,
 		mode: ctx.shouldSoftDelete ? "soft" : "hard",
@@ -3799,7 +3664,7 @@ async function cascadeViaRepoBulk(relation, parentId, ctx) {
 */
 async function cascadeViaRepoBulkMany(relation, parentIds, ctx) {
 	const targetRepo = relation.repo;
-	if (typeof targetRepo.deleteMany !== "function") throw new Error(`cascadePlugin: target repo for '${ctx.targetModelName}' is missing deleteMany(). Wire batchOperationsPlugin() + methodRegistryPlugin() on the target repo.`);
+	if (typeof targetRepo.deleteMany !== "function") throw new Error(`cascadePlugin: target repo for '${ctx.targetModelName}' is missing deleteMany(). Ensure the target is a mongokit Repository or implements the StandardRepo deleteMany contract.`);
 	await targetRepo.deleteMany({ [relation.foreignKey]: { $in: parentIds } }, {
 		...ctx.scopeForward,
 		mode: ctx.shouldSoftDelete ? "soft" : "hard",