@classytic/mongokit 3.19.0 → 3.21.0

package/dist/sort-Ca1BPfvE.mjs

@@ -1,72 +0,0 @@
-import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-//#region src/pagination/utils/sort.ts
-var sort_exports = /* @__PURE__ */ __exportAll({
-	getPrimaryField: () => getPrimaryField,
-	normalizeSort: () => normalizeSort,
-	validateKeysetSort: () => validateKeysetSort
-});
-/**
-* Normalizes sort object to ensure stable key order
-* Primary fields first, _id last (not alphabetical)
-*
-* @param sort - Sort specification
-* @returns Normalized sort with stable key order
-*/
-function normalizeSort(sort) {
-	const normalized = {};
-	Object.keys(sort).forEach((key) => {
-		if (key !== "_id") normalized[key] = sort[key];
-	});
-	if (sort._id !== void 0) normalized._id = sort._id;
-	return normalized;
-}
-/**
-* Validates and normalizes sort for keyset pagination.
-* Auto-adds `_id` tie-breaker if needed; ensures `_id` direction matches the
-* primary field.
-*
-* **Known limitation (MongoDB mixed-type sort):** keyset pagination across a
-* field that can hold both typed values (Date, Number) and `null`/`undefined`
-* is lossy — `$lt/$gt` don't cross the type boundary in BSON comparison, so
-* some docs at the null/non-null boundary are unreachable. If your sort field
-* is nullable, either:
-*   - sort by `_id` alone (always safe), or
-*   - use `allowedPrimaryFields` to lock keyset sort to fields your schema
-*     guarantees non-null (see `PaginationConfig.strictKeysetSortFields`).
-*
-* @param sort - Sort specification
-* @param allowedPrimaryFields - Optional allowlist of primary (non-_id) sort
-*   field names. When set, rejects sorts whose primary field isn't listed.
-*   `_id` is always allowed.
-* @returns Validated and normalized sort
-* @throws Error if sort is invalid for keyset pagination
-*/
-function validateKeysetSort(sort, allowedPrimaryFields) {
-	const keys = Object.keys(sort);
-	if (keys.length === 0) throw new Error("Keyset pagination requires at least one sort field");
-	if (keys.length === 1 && keys[0] === "_id") return normalizeSort(sort);
-	for (const key of keys) if (sort[key] !== 1 && sort[key] !== -1) throw new Error(`Invalid sort direction for "${key}": must be 1 or -1, got ${sort[key]}`);
-	const nonIdKeys = keys.filter((k) => k !== "_id");
-	const primaryDirection = sort[nonIdKeys[0]];
-	if (allowedPrimaryFields && allowedPrimaryFields.length > 0) {
-		for (const key of nonIdKeys) if (!allowedPrimaryFields.includes(key)) throw new Error(`Keyset sort field "${key}" is not in the strictKeysetSortFields allowlist. Allowed: ${allowedPrimaryFields.join(", ")}. (See PaginationConfig.strictKeysetSortFields — protects against lossy null/non-null keyset boundaries.)`);
-	}
-	for (const key of nonIdKeys) if (sort[key] !== primaryDirection) throw new Error("All sort fields must share the same direction for keyset pagination");
-	if (keys.includes("_id") && sort._id !== primaryDirection) throw new Error("_id direction must match primary field direction");
-	if (!keys.includes("_id")) return normalizeSort({
-		...sort,
-		_id: primaryDirection
-	});
-	return normalizeSort(sort);
-}
-/**
-* Extracts primary sort field (first non-_id field)
-*
-* @param sort - Sort specification
-* @returns Primary field name
-*/
-function getPrimaryField(sort) {
-	return Object.keys(sort).find((k) => k !== "_id") || "_id";
-}
-//#endregion
-export { sort_exports as n, validateKeysetSort as r, getPrimaryField as t };