@classytic/mongokit 3.39.0 → 3.40.1

package/dist/{update-c_01A0if.mjs → update-WgeAUJ_I.mjs}

@@ -1,6 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { t as createError } from "./error-BuByZwKU.mjs";
+import { i as applyToQuery } from "./query-defaults-BxUcSOoF.mjs";
 import { coerceFilterDates, isFilter } from "@classytic/repo-core/filter";
 //#region src/actions/create.ts
 var create_exports = /* @__PURE__ */ __exportAll({
@@ -15,7 +16,16 @@ var create_exports = /* @__PURE__ */ __exportAll({
 */
 async function create(Model, data, options = {}) {
 	const document = new Model(data);
-	await document.save({ session: options.session });
+	const saveOptions = { session: options.session };
+	const bound = options.queryOptions?.maxTimeMS;
+	if (bound !== void 0) Object.assign(saveOptions, { timeoutMS: bound });
+	const wc = options.queryOptions?.writeConcern;
+	if (wc) Object.assign(saveOptions, { writeConcern: {
+		...wc.w !== void 0 ? { w: wc.w } : {},
+		...wc.j !== void 0 ? { j: wc.j } : {},
+		...wc.wtimeoutMS !== void 0 ? { wtimeout: wc.wtimeoutMS } : {}
+	} });
+	await document.save(saveOptions);
 	return document;
 }
 /** Narrow a caught error to one carrying a partial-write report. */
@@ -54,10 +64,15 @@ function readFailures(err, dataArray) {
 */
 async function createMany(Model, dataArray, options = {}) {
 	try {
-		return await Model.insertMany(dataArray, {
+		const insertOptions = {
 			session: options.session,
 			ordered: options.ordered === true
-		});
+		};
+		const wc = options.queryOptions?.writeConcern;
+		if (wc) Object.assign(insertOptions, { writeConcern: wc });
+		const bound = options.queryOptions?.maxTimeMS;
+		if (bound !== void 0) Object.assign(insertOptions, { timeoutMS: bound });
+		return await Model.insertMany(dataArray, insertOptions);
 	} catch (err) {
 		const inserted = err.insertedDocs;
 		const failed = readFailures(err, dataArray);
@@ -95,6 +110,122 @@ async function upsert(Model, query, data, options = {}) {
 	});
 }
 //#endregion
+//#region src/filter/cast-schema.ts
+/** Operators whose operand is a single scalar to cast. */
+const SCALAR_OPS = /* @__PURE__ */ new Set([
+	"$eq",
+	"$ne",
+	"$gt",
+	"$gte",
+	"$lt",
+	"$lte"
+]);
+/** Operators whose operand is an array of scalars to cast element-wise. */
+const ARRAY_OPS = /* @__PURE__ */ new Set(["$in", "$nin"]);
+/** Logical operators whose operand is an ARRAY of sub-filters. */
+const LOGICAL_ARRAY_OPS$1 = /* @__PURE__ */ new Set([
+	"$and",
+	"$or",
+	"$nor"
+]);
+/** Logical operators whose operand is a SINGLE nested sub-filter. */
+const LOGICAL_OBJECT_OPS = /* @__PURE__ */ new Set(["$not"]);
+function isPlainObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date);
+}
+/**
+* Cast one value through a schema path. Returns the original value when the
+* path is unknown, the value is nullish, or the cast throws — never raises.
+*/
+function castValue(schema, field, value) {
+	if (value === null || value === void 0) return value;
+	if (typeof value === "object" && !(value instanceof Date)) return value;
+	let schemaType;
+	try {
+		schemaType = schema.path(field);
+	} catch {
+		return value;
+	}
+	if (!schemaType || typeof schemaType.cast !== "function") return value;
+	try {
+		return schemaType.cast(value);
+	} catch {
+		return value;
+	}
+}
+/**
+* Cast the operand(s) of a field-level operator object, leaving operators we
+* don't understand (`$regex`, `$exists`, `$size`, `$elemMatch`, …) alone.
+*/
+function castOperatorObject(schema, field, ops) {
+	let changed = false;
+	const out = {};
+	for (const [op, operand] of Object.entries(ops)) if (SCALAR_OPS.has(op)) {
+		const next = castValue(schema, field, operand);
+		out[op] = next;
+		if (next !== operand) changed = true;
+	} else if (ARRAY_OPS.has(op) && Array.isArray(operand)) {
+		const arr = operand.map((entry) => castValue(schema, field, entry));
+		out[op] = arr;
+		if (arr.some((v, i) => v !== operand[i])) changed = true;
+	} else out[op] = operand;
+	return changed ? out : ops;
+}
+/**
+* Cast a record-shape Mongo filter against a Mongoose schema so it is safe to
+* hand to a `$match` stage. Recurses `$and` / `$or` / `$nor` / `$not`, since a
+* policy/tenant scope conjoined with a caller filter nests one level down.
+*
+* Filter IR nodes and non-objects pass through untouched — IR values are built
+* in code (already correctly typed) and carry no schema paths to resolve.
+*
+* @example
+* ```ts
+* // organizationId is an ObjectId column; arc supplies the scope id as a string
+* castFilterToSchema({ organizationId: '6a6a…' }, Order.schema)
+* // → { organizationId: ObjectId('6a6a…') }
+* ```
+*/
+function castFilterToSchema(filter, schema) {
+	if (!isPlainObject(filter)) return filter;
+	if (typeof filter.op === "string") return filter;
+	let changed = false;
+	const out = {};
+	for (const [key, value] of Object.entries(filter)) {
+		if (LOGICAL_ARRAY_OPS$1.has(key) && Array.isArray(value)) {
+			const arr = value.map((entry) => castFilterToSchema(entry, schema));
+			out[key] = arr;
+			if (arr.some((v, i) => v !== value[i])) changed = true;
+			continue;
+		}
+		if (LOGICAL_OBJECT_OPS.has(key) && isPlainObject(value)) {
+			const nested = castFilterToSchema(value, schema);
+			out[key] = nested;
+			if (nested !== value) changed = true;
+			continue;
+		}
+		if (key.startsWith("$")) {
+			out[key] = value;
+			continue;
+		}
+		if (isPlainObject(value)) {
+			const keys = Object.keys(value);
+			if (keys.length > 0 && keys.every((k) => k.startsWith("$"))) {
+				const nextOps = castOperatorObject(schema, key, value);
+				out[key] = nextOps;
+				if (nextOps !== value) changed = true;
+				continue;
+			}
+			out[key] = value;
+			continue;
+		}
+		const next = castValue(schema, key, value);
+		out[key] = next;
+		if (next !== value) changed = true;
+	}
+	return changed ? out : filter;
+}
+//#endregion
 //#region src/filter/compile.ts
 /**
 * Compile a Filter IR node to a MongoDB query object. Returns `{}`
@@ -114,6 +245,12 @@ async function upsert(Model, query, data, options = {}) {
 * handles them"). This set covers every operator the arc aggregation
 * guard accepts in `parseDateRange` and `hasFilterOnField`.
 */
+/**
+* The query-shorthand vocabulary, shared with `compileFilterToMongoExpr` so
+* both filter surfaces recognise the same operator names. Exported because a
+* second private copy is how the two compilers drifted apart in the first
+* place: one accepted `{ f: { eq: 'x' } }` and the other read it as a literal.
+*/
 const SHORTHAND_OPS = /* @__PURE__ */ new Set([
 	"eq",
 	"ne",
@@ -191,7 +328,10 @@ function schemaDateOracle(schema) {
 }
 function compileFilterToMongo(input, schema) {
 	if (!input) return {};
-	if (!isFilter(input)) return coerceFilterDates(expandShorthands(input), schema ? { isDateField: schemaDateOracle(schema) } : void 0);
+	if (!isFilter(input)) {
+		const expanded = expandShorthands(input);
+		return coerceFilterDates(schema ? castFilterToSchema(expanded, schema) : expanded, schema ? { isDateField: schemaDateOracle(schema) } : void 0);
+	}
 	return compile(input);
 }
 function compile(filter) {
@@ -199,7 +339,7 @@ function compile(filter) {
 		case "true": return {};
 		case "false": return { $expr: false };
 		case "eq": return { [filter.field]: filter.value };
-		case "ne": return filter.value === null ? { [filter.field]: { $ne: null } } : { $and: [{ [filter.field]: { $ne: filter.value } }, { [filter.field]: { $ne: null } }] };
+		case "ne": return filter.value === null ? { [filter.field]: { $ne: null } } : { [filter.field]: { $nin: [filter.value, null] } };
 		case "gt": return { [filter.field]: { $gt: filter.value } };
 		case "gte": return { [filter.field]: { $gte: filter.value } };
 		case "lt": return { [filter.field]: { $lt: filter.value } };
@@ -209,7 +349,7 @@ function compile(filter) {
 			return { [filter.field]: { $in: [...filter.values] } };
 		case "nin":
 			if (filter.values.length === 0) return {};
-			return { [filter.field]: { $nin: [...filter.values] } };
+			return { [filter.field]: { $nin: filter.values.includes(null) ? [...filter.values] : [...filter.values, null] } };
 		case "exists": return filter.exists ? { [filter.field]: { $ne: null } } : { [filter.field]: null };
 		case "like": return { [filter.field]: likeToRegex(filter.pattern, filter.caseSensitivity) };
 		/**
@@ -233,10 +373,10 @@ function compile(filter) {
 			$options: filter.flags
 		} : { $regex: filter.pattern } };
 		case "and": {
-			if (filter.children.length === 0) return {};
-			const parts = filter.children.map(compile);
+			const parts = filter.children.map(compile).filter((part) => Object.keys(part).length > 0);
+			if (parts.length === 0) return {};
 			if (parts.length === 1) return parts[0];
-			return { $and: parts };
+			return mergeConjunction(parts) ?? { $and: parts };
 		}
 		case "or": {
 			if (filter.children.length === 0) return { $expr: false };
@@ -268,7 +408,7 @@ function compile(filter) {
 * same way sqlitekit's `LIKE` semantically does.
 */
 function likeToRegex(pattern, caseSensitivity) {
-	let out = "^";
+	let out = "";
 	for (let i = 0; i < pattern.length; i++) {
 		const ch = pattern[i];
 		if (ch === "\\" && i + 1 < pattern.length) {
@@ -283,12 +423,44 @@ function likeToRegex(pattern, caseSensitivity) {
 		else if (ch === "_") out += ".";
 		else out += escapeRegexChar(ch);
 	}
-	out += "$";
-	return caseSensitivity === "sensitive" ? { $regex: out } : {
-		$regex: out,
+	const source = `${out.startsWith(".*") ? out.slice(2) : `^${out}`}`;
+	const anchored = source.endsWith(".*") && !source.endsWith("\\.*") ? source.slice(0, -2) : `${source}$`;
+	return caseSensitivity === "sensitive" ? { $regex: anchored } : {
+		$regex: anchored,
 		$options: "i"
 	};
 }
+/**
+* Merge an AND of field conditions into one object (`{ price: { $gte, $lte } }`) when no field
+* repeats an operator; `undefined` when a merge would change meaning, so the caller keeps `$and`.
+*/
+function mergeConjunction(parts) {
+	const merged = {};
+	for (const part of parts) for (const [field, condition] of Object.entries(part)) {
+		if (field.startsWith("$")) return void 0;
+		if (!(field in merged)) {
+			merged[field] = condition;
+			continue;
+		}
+		const left = asOperators(merged[field]);
+		const right = asOperators(condition);
+		if (!left || !right || Object.keys(right).some((op) => op in left)) return void 0;
+		merged[field] = {
+			...left,
+			...right
+		};
+	}
+	return merged;
+}
+/** A field condition as an operator object — an equality value becomes `{ $eq }`. */
+function asOperators(condition) {
+	if (condition instanceof RegExp || Array.isArray(condition)) return void 0;
+	if (condition !== null && typeof condition === "object" && !(condition instanceof Date)) {
+		const keys = Object.keys(condition);
+		return keys.length > 0 && keys.every((k) => k.startsWith("$")) ? condition : void 0;
+	}
+	return condition === null ? void 0 : { $eq: condition };
+}
 function escapeRegexChar(ch) {
 	return /[.*+?^${}()|[\]\\]/.test(ch) ? `\\${ch}` : ch;
 }
@@ -808,7 +980,7 @@ async function facet(Model, facets, options = {}) {
 */
 async function distinct(Model, field, query = {}, options = {}) {
 	const q = Model.distinct(field, query).session(options.session ?? null);
-	if (options.readPreference) q.read(options.readPreference);
+	applyToQuery(q, options.queryOptions ?? {});
 	return q;
 }
 /**
@@ -869,7 +1041,9 @@ async function deleteById(Model, id, options = {}) {
 		...options.query,
 		_id: id
 	};
-	if (!await Model.findOneAndDelete(query).session(options.session ?? null)) return null;
+	const q = Model.findOneAndDelete(query).session(options.session ?? null);
+	applyToQuery(q, options.queryOptions ?? {});
+	if (!await q) return null;
 	return {
 		message: "Deleted successfully",
 		id: String(id)
@@ -890,7 +1064,9 @@ async function deleteMany(Model, query, options = {}) {
 * Delete by query. Returns `null` on miss unless `throwOnNotFound: true`.
 */
 async function deleteByQuery(Model, query, options = {}) {
-	const document = await Model.findOneAndDelete(query).session(options.session ?? null);
+	const q = Model.findOneAndDelete(query).session(options.session ?? null);
+	applyToQuery(q, options.queryOptions ?? {});
+	const document = await q;
 	if (!document) {
 		if (options.throwOnNotFound === true) throw createError(404, "Document not found");
 		return null;
@@ -975,7 +1151,7 @@ async function getById(Model, id, options = {}) {
 	if (options.populate) query.populate(parsePopulate$1(options.populate));
 	if (options.lean) query.lean();
 	if (options.session) query.session(options.session);
-	if (options.readPreference) query.read(options.readPreference);
+	applyToQuery(query, options.queryOptions ?? {});
 	const document = await query.exec();
 	if (!document && options.throwOnNotFound === true) throw createError(404, "Document not found");
 	return document;
@@ -996,7 +1172,7 @@ async function getByQuery(Model, query, options = {}) {
 	if (options.sort) mongoQuery.sort(options.sort);
 	if (options.lean) mongoQuery.lean();
 	if (options.session) mongoQuery.session(options.session);
-	if (options.readPreference) mongoQuery.read(options.readPreference);
+	applyToQuery(mongoQuery, options.queryOptions ?? {});
 	const document = await mongoQuery.exec();
 	if (!document && options.throwOnNotFound === true) throw createError(404, "Document not found");
 	return document;
@@ -1023,7 +1199,7 @@ async function getAll(Model, query = {}, options = {}) {
 	if (options.skip) mongoQuery = mongoQuery.skip(options.skip);
 	if (options.lean !== false) mongoQuery = mongoQuery.lean();
 	if (options.session) mongoQuery = mongoQuery.session(options.session);
-	if (options.readPreference) mongoQuery = mongoQuery.read(options.readPreference);
+	applyToQuery(mongoQuery, options.queryOptions ?? {});
 	return mongoQuery.exec();
 }
 /**
@@ -1064,7 +1240,7 @@ async function getOrCreate(Model, query, createData, options = {}) {
 */
 async function count(Model, query = {}, options = {}) {
 	const q = Model.countDocuments(query).session(options.session ?? null);
-	if (options.readPreference) q.read(options.readPreference);
+	applyToQuery(q, options.queryOptions ?? {});
 	return q;
 }
 /**
@@ -1072,7 +1248,7 @@ async function count(Model, query = {}, options = {}) {
 */
 async function exists(Model, query, options = {}) {
 	const q = Model.exists(query).session(options.session ?? null);
-	if (options.readPreference) q.read(options.readPreference);
+	applyToQuery(q, options.queryOptions ?? {});
 	return q;
 }
 //#endregion
@@ -1088,6 +1264,10 @@ var update_exports = /* @__PURE__ */ __exportAll({
 	updateWithConstraints: () => updateWithConstraints,
 	updateWithValidation: () => updateWithValidation
 });
+function withQueryOptions(query, queryOptions) {
+	applyToQuery(query, queryOptions ?? {});
+	return query;
+}
 function assertUpdatePipelineAllowed(update, updatePipeline) {
 	if (Array.isArray(update) && updatePipeline !== true) throw createError(400, "Update pipelines (array updates) are disabled by default; pass `{ updatePipeline: true }` to explicitly allow pipeline-style updates.");
 }
@@ -1109,13 +1289,13 @@ async function update(Model, id, data, options = {}) {
 		...options.query,
 		_id: id
 	};
-	return await Model.findOneAndUpdate(query, data, {
+	return await withQueryOptions(Model.findOneAndUpdate(query, data, {
 		returnDocument: "after",
 		runValidators: true,
 		session: options.session,
 		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {},
 		...options.arrayFilters ? { arrayFilters: options.arrayFilters } : {}
-	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? false) ?? null;
+	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? false), options.queryOptions) ?? null;
 }
 /**
 * Update with query constraints (optimized)
@@ -1127,13 +1307,13 @@ async function updateWithConstraints(Model, id, data, constraints = {}, options
 		...constraints,
 		_id: id
 	};
-	return await Model.findOneAndUpdate(query, data, {
+	return await withQueryOptions(Model.findOneAndUpdate(query, data, {
 		returnDocument: "after",
 		runValidators: true,
 		session: options.session,
 		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {},
 		...options.arrayFilters ? { arrayFilters: options.arrayFilters } : {}
-	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? false);
+	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? false), options.queryOptions);
 }
 /**
 * Update with validation (smart optimization)
@@ -1190,12 +1370,12 @@ async function updateWithValidation(Model, id, data, validationOptions = {}, opt
 */
 async function updateMany(Model, query, data, options = {}) {
 	assertUpdatePipelineAllowed(data, options.updatePipeline);
-	const result = await Model.updateMany(query, data, {
+	const result = await withQueryOptions(Model.updateMany(query, data, {
 		runValidators: true,
 		session: options.session,
 		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {},
 		...options.arrayFilters ? { arrayFilters: options.arrayFilters } : {}
-	});
+	}), options.queryOptions);
 	return {
 		matchedCount: result.matchedCount,
 		modifiedCount: result.modifiedCount
@@ -1206,13 +1386,13 @@ async function updateMany(Model, query, data, options = {}) {
 */
 async function updateByQuery(Model, query, data, options = {}) {
 	assertUpdatePipelineAllowed(data, options.updatePipeline);
-	const document = await Model.findOneAndUpdate(query, data, {
+	const document = await withQueryOptions(Model.findOneAndUpdate(query, data, {
 		returnDocument: "after",
 		runValidators: true,
 		session: options.session,
 		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {},
 		...options.arrayFilters ? { arrayFilters: options.arrayFilters } : {}
-	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? false);
+	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? false), options.queryOptions);
 	if (!document && options.throwOnNotFound === true) throw createError(404, "Document not found");
 	return document;
 }
@@ -1226,7 +1406,7 @@ async function updateByQuery(Model, query, data, options = {}) {
 async function findOneAndUpdate(Model, filter, update, options = {}) {
 	assertUpdatePipelineAllowed(update, options.updatePipeline);
 	const returnDocument = options.returnDocument ?? "after";
-	return await Model.findOneAndUpdate(filter, update, {
+	return await withQueryOptions(Model.findOneAndUpdate(filter, update, {
 		returnDocument,
 		upsert: options.upsert ?? false,
 		runValidators: options.runValidators ?? true,
@@ -1234,9 +1414,8 @@ async function findOneAndUpdate(Model, filter, update, options = {}) {
 		...options.sort ? { sort: options.sort } : {},
 		...options.arrayFilters ? { arrayFilters: options.arrayFilters } : {},
 		...options.collation ? { collation: options.collation } : {},
-		...options.maxTimeMS ? { maxTimeMS: options.maxTimeMS } : {},
 		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
-	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? true);
+	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? true), options.queryOptions);
 }
 /**
 * Increment field
@@ -1257,4 +1436,4 @@ async function pullFromArray(Model, id, field, value, options = {}) {
 	return update(Model, id, { $pull: { [field]: value } }, options);
 }
 //#endregion
-export { upsert as S, compileFilterToMongo as _, count as a, create_exports as b, getByQuery as c, deleteById as d, deleteByQuery as f, LookupBuilder as g, distinct as h, update_exports as i, getOrCreate as l, aggregate_exports as m, update as n, exists as o, delete_exports as p, updateByQuery as r, getById as s, findOneAndUpdate as t, read_exports as u, create as v, isCreateManyPartialError as x, createMany as y };
+export { isCreateManyPartialError as C, create_exports as S, SHORTHAND_OPS as _, count as a, create as b, getByQuery as c, deleteById as d, deleteByQuery as f, LookupBuilder as g, distinct as h, update_exports as i, getOrCreate as l, aggregate_exports as m, update as n, exists as o, delete_exports as p, updateByQuery as r, getById as s, findOneAndUpdate as t, read_exports as u, compileFilterToMongo as v, upsert as w, createMany as x, castFilterToSchema as y };

package/dist/utils/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as getMongooseProjection, a as createMemoryCache, b as createError, c as IdType, d as isObjectIdInstance, f as isValidIdForType, g as getFieldsForUser, h as filterResponseData, i as buildCrudSchemasFromMongooseSchema, l as getSchemaIdType, m as createFieldPreset, n as CrudSchemasFramework, o as LoggerConfig, p as toObjectId, r as buildCrudSchemasFromModel, s as configureLogger, t as toPlain, v as CreateErrorOptions, y as ParseDuplicateKeyOptions } from "../to-plain-B8ufk3Qz.mjs";
+import { _ as getMongooseProjection, a as createMemoryCache, b as createError, c as IdType, d as isObjectIdInstance, f as isValidIdForType, g as getFieldsForUser, h as filterResponseData, i as buildCrudSchemasFromMongooseSchema, l as getSchemaIdType, m as createFieldPreset, n as CrudSchemasFramework, o as LoggerConfig, p as toObjectId, r as buildCrudSchemasFromModel, s as configureLogger, t as toPlain, v as CreateErrorOptions, y as ParseDuplicateKeyOptions } from "../to-plain-CjgEInWV.mjs";
 import { ClientSession, Model } from "mongoose";
 //#region src/utils/id-chunks.d.ts
 /**

package/dist/utils/index.mjs

@@ -4,5 +4,5 @@ import { t as configureLogger } from "../logger-K7dPmu2U.mjs";
 import { t as createError } from "../error-BuByZwKU.mjs";
 import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "../field-selection-FSQFLpsU.mjs";
 import { n as createMemoryCache, t as toPlain } from "../to-plain-vksRrLtc.mjs";
-import { n as buildCrudSchemasFromMongooseSchema, t as buildCrudSchemasFromModel } from "../mongooseToJsonSchema-waUVQwK4.mjs";
+import { n as buildCrudSchemasFromMongooseSchema, t as buildCrudSchemasFromModel } from "../mongooseToJsonSchema-C3k4ide0.mjs";
 export { DEFAULT_ID_CHUNK, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, collectIds, configureLogger, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getMongooseProjection, getSchemaIdType, idChunks, isObjectIdInstance, isValidIdForType, keysetFilter, narrowToIds, selectKeysetChunk, toObjectId, toPlain };