@classytic/mongokit 3.19.0 → 3.21.0

package/dist/testkit/index.d.mts

@@ -1,7 +1,6 @@
-import { a as Repository, n as CreateRepositoryConfig } from "../create-repository-K0yft2ht.mjs";
+import { a as Repository, n as CreateRepositoryConfig } from "../create-repository-0TkQhcv-.mjs";
 import { Connection, Model, Schema } from "mongoose";
 import { MongoMemoryReplSet, MongoMemoryServer } from "mongodb-memory-server";
-
 //#region src/testkit/index.d.ts
 interface MongoMemoryOptions {
   /**

package/dist/testkit/index.mjs

@@ -1,4 +1,4 @@
-import { t as createRepository } from "../create-repository-D5YX0wGs.mjs";
+import { t as createRepository } from "../create-repository-CJATiAKX.mjs";
 import { createConnection } from "mongoose";
 //#region src/testkit/index.ts
 function idempotentStop(server) {

package/dist/{timestamp.plugin-B1A9U-P7.mjs → timestamp.plugin-nG9Z1JEk.mjs}

@@ -1,6 +1,6 @@
-import { l as OP_REGISTRY, s as ALL_OPERATIONS, t as HOOK_PRIORITY } from "./Repository-B01VW_fU.mjs";
-import { n as warn } from "./logger-B8wf-Mtb.mjs";
-import { t as createError } from "./error-BTeepSNL.mjs";
+import { l as OP_REGISTRY, s as ALL_OPERATIONS, t as HOOK_PRIORITY } from "./Repository-dbbgOGjK.mjs";
+import { n as warn } from "./logger-K7dPmu2U.mjs";
+import { t as createError } from "./error-BuByZwKU.mjs";
 import { throwIfAborted, withRetry } from "@classytic/repo-core/repository";
 import mongoose from "mongoose";
 import { cachePlugin } from "@classytic/repo-core/cache";
@@ -1233,7 +1233,7 @@ function softDeletePlugin(options = {}) {
 					};
 				}
 			};
-			const SOFT_DELETE_SPECIAL = new Set([
+			const SOFT_DELETE_SPECIAL = /* @__PURE__ */ new Set([
 				"updateMany",
 				"deleteMany",
 				"bulkWrite"

package/dist/{types-BA8oXjFe.d.mts → types-DNFMofHy.d.mts}

@@ -1,16 +1,9 @@
-import * as _$_classytic_repo_core_repository0 from "@classytic/repo-core/repository";
 import { DeleteManyResult, DeleteResult, LookupPopulateResult, RepositoryBase, UpdateManyResult } from "@classytic/repo-core/repository";
-import * as _$mongoose from "mongoose";
 import { Document, Model, PipelineStage, PopulateOptions, Types } from "mongoose";
-import * as _$_classytic_repo_core_filter0 from "@classytic/repo-core/filter";
 import { Filter } from "@classytic/repo-core/filter";
-import * as _$_classytic_repo_core_cache0 from "@classytic/repo-core/cache";
-import * as _$_classytic_repo_core_schema0 from "@classytic/repo-core/schema";
 import { ValidationResult } from "@classytic/repo-core/schema";
-import * as _$_classytic_repo_core_events0 from "@classytic/repo-core/events";
 import { AnyPaginationResult, OffsetPaginationResult } from "@classytic/repo-core/pagination";
 import { HttpError } from "@classytic/repo-core/errors";
-
 //#region src/query/LookupBuilder.d.ts
 interface LookupOptions {
   /** Collection to join with */
@@ -172,6 +165,42 @@ declare class LookupBuilder {
    */
   private static _sanitizeDeep;
 }
+/**
+ * Performance Guidelines for $lookup at Scale:
+ *
+ * 1. **Index Requirements** (Critical for millions of records):
+ *    - localField should be indexed on source collection
+ *    - foreignField should be indexed on target collection (unique index preferred)
+ *
+ *    Example:
+ *    ```typescript
+ *    // Employee collection
+ *    employeeSchema.index({ departmentSlug: 1 });
+ *
+ *    // Department collection
+ *    departmentSchema.index({ slug: 1 }, { unique: true });
+ *    ```
+ *
+ * 2. **Query Performance**:
+ *    - With proper indexes: O(log n) per lookup
+ *    - Without indexes: O(n * m) - AVOID THIS!
+ *    - Use explain() to verify index usage: IXSCAN (good) vs COLLSCAN (bad)
+ *
+ * 3. **Pipeline Optimization**:
+ *    - Place $match stages as early as possible
+ *    - Use $project to reduce field size before lookups
+ *    - Limit joined results with pipeline: [{ $match: {...} }, { $limit: n }]
+ *
+ * 4. **Memory Considerations**:
+ *    - Each lookup creates a new field in memory
+ *    - Use $project after lookup to remove unnecessary fields
+ *    - Consider allowDiskUse: true for very large datasets
+ *
+ * 5. **Alternative Approaches**:
+ *    - For 1:1 relationships with high read frequency: Consider storing ObjectId + slug
+ *    - For read-heavy workloads: Consider caching or materialized views
+ *    - For real-time dashboards: Consider separate aggregation collections
+ */
 //#endregion
 //#region src/types/controller.types.d.ts
 /**
@@ -561,20 +590,20 @@ type RequiredBy<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
  * @example
  * type StringFields = KeysOfType<User, string>; // 'name' | 'email'
  */
-type KeysOfType<T, V> = { [K in keyof T]: T[K] extends V ? K : never }[keyof T];
+type KeysOfType<T, V> = { [K in keyof T]: T[K] extends V ? K : never; }[keyof T];
 /**
  * Deep partial - makes all nested properties optional
  */
-type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]> } : T;
+type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]>; } : T;
 /**
  * Strict object type - prevents excess properties
  * Use with `satisfies` for compile-time validation
  */
-type Strict<T> = T & { [K in Exclude<string, keyof T>]?: never };
+type Strict<T> = T & { [K in Exclude<string, keyof T>]?: never; };
 /**
  * NonNullable fields extractor
  */
-type NonNullableFields<T> = { [K in keyof T]: NonNullable<T[K]> };
+type NonNullableFields<T> = { [K in keyof T]: NonNullable<T[K]>; };
 /**
  * Create/Update input types from document
  */
@@ -869,20 +898,20 @@ interface RepositoryOptions {
    * structured `validationErrors`. Validator output replaces the
    * payload, so schema-declared coercions/defaults flow into the write.
    */
-  schema?: _$_classytic_repo_core_schema0.StandardSchemaV1;
+  schema?: import('@classytic/repo-core/schema').StandardSchemaV1;
   /**
    * Standard Schema validator for `update` payloads. Separate slot
    * because updates are partial — derive one explicitly (e.g.
    * `schema.partial()` in Zod).
    */
-  updateSchema?: _$_classytic_repo_core_schema0.StandardSchemaV1;
+  updateSchema?: import('@classytic/repo-core/schema').StandardSchemaV1;
   /**
    * Domain-event emission. Pass any arc / `@classytic/primitives`-
    * compatible transport and every mutating op publishes
    * `<resource>.<verb>` events (`user.created`, `user.updated`, ...).
    * Omit and the wiring is inert. See `@classytic/repo-core/events`.
    */
-  events?: _$_classytic_repo_core_events0.RepositoryEventsOptions;
+  events?: import('@classytic/repo-core/events').RepositoryEventsOptions;
 }
 /** Pagination configuration */
 interface PaginationConfig {
@@ -1105,7 +1134,7 @@ interface OperationOptions extends ReadOptions {
  */
 interface CacheableOptions extends OperationOptions {
   /** Per-call cache override forwarded to the unified cache plugin. */
-  cache?: _$_classytic_repo_core_cache0.CacheOptions;
+  cache?: import('@classytic/repo-core/cache').CacheOptions;
 }
 /** withTransaction options */
 interface WithTransactionOptions {
@@ -1114,7 +1143,7 @@ interface WithTransactionOptions {
   /** Optional hook to observe fallback triggers */
   onFallback?: (error: Error) => void;
   /** MongoDB transaction options (readConcern, writeConcern, readPreference, maxCommitTimeMS) */
-  transactionOptions?: _$mongoose.mongo.TransactionOptions;
+  transactionOptions?: import('mongoose').mongo.TransactionOptions;
 }
 /** Create operation options */
 interface CreateOptions extends SessionOptions {
@@ -1200,13 +1229,13 @@ interface LookupPopulateOptions<TBase = unknown> {
    * controllers produce when typed against `StandardRepo<TDoc>`), or
    * a plain `Record<string, unknown>` for ad-hoc callers.
    */
-  filters?: _$_classytic_repo_core_filter0.Filter | (Partial<TBase> & Record<string, unknown>) | Record<string, unknown>;
+  filters?: import('@classytic/repo-core/filter').Filter | (Partial<TBase> & Record<string, unknown>) | Record<string, unknown>;
   /**
    * Portable `LookupSpec[]` (cross-kit) or mongokit-native
    * `LookupOptions[]` (with `pipeline` / `let` / `sanitize`). The
    * portable shape is a structural subset, so callers can mix.
    */
-  lookups: readonly _$_classytic_repo_core_repository0.LookupSpec[] | LookupOptions[];
+  lookups: readonly import('@classytic/repo-core/repository').LookupSpec[] | LookupOptions[];
   /** Sort specification */
   sort?: SortSpec | string;
   /** Page number (offset mode, 1-indexed) */
@@ -1338,7 +1367,7 @@ interface RepositoryContext {
    * `options.cache` onto the context so the plugin's `before:<op>`
    * hook can read it.
    */
-  cache?: _$_classytic_repo_core_cache0.CacheOptions;
+  cache?: import('@classytic/repo-core/cache').CacheOptions;
   /** Whether result was served from cache (internal — set by cache plugin) */
   _cacheHit?: boolean;
   /** Cached result (internal — set by cache plugin) */
@@ -1440,7 +1469,7 @@ type EventHandlers<TDoc = unknown> = { [K in RepositoryEvent]?: K extends `befor
   error: Error;
 }) => void | Promise<void> : (payload: {
   context: RepositoryContext;
-}) => void | Promise<void> };
+}) => void | Promise<void>; };
 /** Event payload */
 interface EventPayload {
   context: RepositoryContext;
@@ -1584,7 +1613,7 @@ interface MinMaxResult {
  */
 interface CacheOperationOptions {
   /** Per-call cache override forwarded to the unified cache plugin. */
-  cache?: _$_classytic_repo_core_cache0.CacheOptions;
+  cache?: import('@classytic/repo-core/cache').CacheOptions;
 }
 /** Cascade relation definition */
 interface CascadeRelation {
@@ -1721,7 +1750,7 @@ type AllPluginMethods<TDoc> = {
    * `CacheEngine` plus convenience invalidation helpers. `undefined` when
    * no cache plugin is wired.
    */
-  cache?: _$_classytic_repo_core_cache0.RepositoryCacheHandle;
+  cache?: import('@classytic/repo-core/cache').RepositoryCacheHandle;
 };
 /**
  * Helper type to add all plugin methods to a repository class

package/dist/{update-CvCMv5Cl.mjs → update-1Lq9OMD2.mjs}

@@ -1,6 +1,6 @@
-import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { n as warn } from "./logger-B8wf-Mtb.mjs";
-import { t as createError } from "./error-BTeepSNL.mjs";
+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 { isFilter } from "@classytic/repo-core/filter";
 //#region src/filter/compile.ts
 /**
@@ -21,7 +21,7 @@ import { isFilter } from "@classytic/repo-core/filter";
 * handles them"). This set covers every operator the arc aggregation
 * guard accepts in `parseDateRange` and `hasFilterOnField`.
 */
-const SHORTHAND_OPS = new Set([
+const SHORTHAND_OPS = /* @__PURE__ */ new Set([
 	"eq",
 	"ne",
 	"gt",
@@ -35,7 +35,7 @@ const SHORTHAND_OPS = new Set([
 	"mod"
 ]);
 /** Range operators whose string values should be coerced to Date. */
-const RANGE_OPS = new Set([
+const RANGE_OPS = /* @__PURE__ */ new Set([
 	"gt",
 	"gte",
 	"lt",

package/dist/utils/index.d.mts

@@ -1,2 +1,2 @@
-import { a as IdType, c as isObjectIdInstance, d as filterResponseData, f as getFieldsForUser, i as configureLogger, l as isValidIdForType, m as createError, n as buildCrudSchemasFromMongooseSchema, o as getSchemaIdType, p as getMongooseProjection, r as createMemoryCache, t as buildCrudSchemasFromModel, u as createFieldPreset } from "../mongooseToJsonSchema-Bz47aMfH.mjs";
+import { a as IdType, c as isObjectIdInstance, d as filterResponseData, f as getFieldsForUser, i as configureLogger, l as isValidIdForType, m as createError, n as buildCrudSchemasFromMongooseSchema, o as getSchemaIdType, p as getMongooseProjection, r as createMemoryCache, t as buildCrudSchemasFromModel, u as createFieldPreset } from "../mongooseToJsonSchema-D2CyAMIC.mjs";
 export { type IdType, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, configureLogger, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getMongooseProjection, getSchemaIdType, isObjectIdInstance, isValidIdForType };

package/dist/utils/index.mjs

@@ -1,6 +1,7 @@
-import { i as isValidIdForType, r as isObjectIdInstance, t as getSchemaIdType } from "../id-resolution-CnN0YA8t.mjs";
-import { t as configureLogger } from "../logger-B8wf-Mtb.mjs";
-import { t as createError } from "../error-BTeepSNL.mjs";
-import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "../field-selection-d1qdRiMr.mjs";
-import { n as buildCrudSchemasFromMongooseSchema, r as createMemoryCache, t as buildCrudSchemasFromModel } from "../mongooseToJsonSchema-ChtXSrLT.mjs";
+import { i as isValidIdForType, r as isObjectIdInstance, t as getSchemaIdType } from "../id-resolution-P2OzcyRl.mjs";
+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 { t as createMemoryCache } from "../memory-cache-DI1jb4dz.mjs";
+import { n as buildCrudSchemasFromMongooseSchema, t as buildCrudSchemasFromModel } from "../mongooseToJsonSchema-CVnrKFDq.mjs";
 export { buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, configureLogger, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getMongooseProjection, getSchemaIdType, isObjectIdInstance, isValidIdForType };

package/dist/{validation-chain.plugin-DHZbpb4t.mjs → validation-chain.plugin-Dn_wZYLA.mjs}

@@ -1,8 +1,8 @@
-import { s as ALL_OPERATIONS } from "./Repository-B01VW_fU.mjs";
-import { _ as upsert } from "./update-CvCMv5Cl.mjs";
-import { n as warn } from "./logger-B8wf-Mtb.mjs";
-import { t as createError } from "./error-BTeepSNL.mjs";
-import { r as getFieldsForUser } from "./field-selection-d1qdRiMr.mjs";
+import { s as ALL_OPERATIONS } from "./Repository-dbbgOGjK.mjs";
+import { _ as upsert } from "./update-1Lq9OMD2.mjs";
+import { n as warn } from "./logger-K7dPmu2U.mjs";
+import { t as createError } from "./error-BuByZwKU.mjs";
+import { r as getFieldsForUser } from "./field-selection-FSQFLpsU.mjs";
 import mongoose from "mongoose";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/plugins/aggregate-helpers.plugin.ts
@@ -681,7 +681,7 @@ function mongoOperationsPlugin() {
 			* }, { arrayFilters: [{ 'elem._id': itemId }] });
 			*/
 			repo.registerMethod("atomicUpdate", async function(id, operators, options = {}) {
-				const validOperators = new Set([
+				const validOperators = /* @__PURE__ */ new Set([
 					"$inc",
 					"$set",
 					"$unset",

package/dist/{validation-chain.plugin-CYOPfFGF.d.mts → validation-chain.plugin-buy3uvyk.d.mts}

@@ -1,8 +1,7 @@
-import { B as ObjectId, C as FieldPreset, G as Plugin, J as PopulateSpec, Q as RepositoryContext, _t as ValidationChainOptions, et as RepositoryInstance, it as SelectSpec, j as Logger, l as CascadeOptions, st as SoftDeleteOptions, ut as SortSpec, vt as ValidatorDefinition } from "./types-BA8oXjFe.mjs";
+import { B as ObjectId, C as FieldPreset, G as Plugin, J as PopulateSpec, Q as RepositoryContext, _t as ValidationChainOptions, et as RepositoryInstance, it as SelectSpec, j as Logger, l as CascadeOptions, st as SoftDeleteOptions, ut as SortSpec, vt as ValidatorDefinition } from "./types-DNFMofHy.mjs";
 import { BulkWriteResult } from "@classytic/repo-core/repository";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { OffsetPaginationResult } from "@classytic/repo-core/pagination";
-
 //#region src/plugins/aggregate-helpers.plugin.d.ts
 /**
  * Aggregate helpers plugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.19.0",
+  "version": "3.21.0",
   "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
   "type": "module",
   "sideEffects": false,
@@ -109,7 +109,7 @@
   },
   "homepage": "https://github.com/classytic/mongokit#readme",
   "peerDependencies": {
-    "@classytic/repo-core": ">=0.7.0",
+    "@classytic/repo-core": ">=0.8.0",
     "better-auth": ">=1.6.0",
     "mongodb-memory-server": ">=10.0.0",
     "mongoose": ">=9.4.1"
@@ -142,10 +142,11 @@
     "typecheck:tests": "tsc --noEmit -p tsconfig.tests.json",
     "lint": "biome check src/",
     "lint:fix": "biome check src/ --write",
+    "lint:package": "publint && attw --pack . --profile esm-only",
     "format": "biome format src/ --write",
     "check": "biome ci src/ --diagnostic-level=error",
     "push": "classytic-push",
-    "prepublishOnly": "npm run check && npm run build && npm run typecheck && npm run typecheck:tests && npm test",
+    "prepublishOnly": "npm run check && npm run build && npm run lint:package && npm run typecheck && npm run typecheck:tests && npm test",
     "publish:dry": "npm publish --dry-run --access public",
     "publish:npm": "npm publish --access public",
     "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
@@ -160,20 +161,20 @@
     "@better-auth/mongo-adapter": "^1.6.22",
     "@biomejs/biome": "^2.4.10",
     "@classytic/dev-tools": "^0.2.0",
-    "@classytic/repo-core": "^0.7.0",
+    "@classytic/repo-core": "^0.9.0",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^4.1.4",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
-    "better-auth": "^1.6.22",
+    "better-auth": "^1.6.23",
     "dotenv": "^17.4.2",
     "knip": "^6.3.0",
     "mongodb": "7.2.0",
     "mongodb-memory-server": "^10.4.3",
     "mongoose": "^9.4.1",
     "publint": "^0.3.18",
-    "tsdown": "^0.21.8",
-    "typescript": "^6.0.3",
+    "tsdown": "^0.22.5",
+    "typescript": "^7.0.2",
     "vitest": "^4.1.4"
   },
   "overrides": {

package/dist/cursor-_SbWVAn-.mjs

@@ -1,254 +0,0 @@
-import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import mongoose from "mongoose";
-//#region src/pagination/utils/filter.ts
-/**
-* Builds MongoDB filter for keyset pagination
-* Creates compound $or condition for proper cursor-based filtering
-*
-* @param baseFilters - Existing query filters
-* @param sort - Normalized sort specification
-* @param cursorValue - Primary field value from cursor
-* @param cursorId - _id value from cursor
-* @returns MongoDB filter with keyset condition
-*
-* @example
-* buildKeysetFilter(
-*   { status: 'active' },
-*   { createdAt: -1, _id: -1 },
-*   new Date('2024-01-01'),
-*   new ObjectId('...')
-* )
-* // Returns:
-* // {
-* //   status: 'active',
-* //   $or: [
-* //     { createdAt: { $lt: Date('2024-01-01') } },
-* //     { createdAt: Date('2024-01-01'), _id: { $lt: ObjectId('...') } }
-* //   ]
-* // }
-*/
-function buildKeysetFilter(baseFilters, sort, cursorValue, cursorId, cursorValues) {
-	const sortFields = Object.keys(sort).filter((k) => k !== "_id");
-	if (sortFields.length <= 1 && !cursorValues) {
-		const primaryField = sortFields[0] || "_id";
-		const direction = sort[primaryField];
-		const operator = direction === 1 ? "$gt" : "$lt";
-		if (cursorValue === null || cursorValue === void 0) if (direction === 1) return {
-			...baseFilters,
-			$or: [{
-				[primaryField]: null,
-				_id: { $gt: cursorId }
-			}, { [primaryField]: { $ne: null } }]
-		};
-		else return {
-			...baseFilters,
-			[primaryField]: null,
-			_id: { $lt: cursorId }
-		};
-		return {
-			...baseFilters,
-			$or: [{ [primaryField]: { [operator]: cursorValue } }, {
-				[primaryField]: cursorValue,
-				_id: { [operator]: cursorId }
-			}]
-		};
-	}
-	const values = cursorValues || { [sortFields[0]]: cursorValue };
-	const allFields = [...sortFields, "_id"];
-	const allValues = {
-		...values,
-		_id: cursorId
-	};
-	const orConditions = [];
-	for (let i = 0; i < allFields.length; i++) {
-		const field = allFields[i];
-		const operator = (sort[field] ?? sort[sortFields[0]]) === 1 ? "$gt" : "$lt";
-		const condition = {};
-		for (let j = 0; j < i; j++) condition[allFields[j]] = allValues[allFields[j]];
-		condition[field] = { [operator]: allValues[field] };
-		orConditions.push(condition);
-	}
-	return {
-		...baseFilters,
-		$or: orConditions
-	};
-}
-//#endregion
-//#region src/pagination/utils/cursor.ts
-/**
-* Cursor Utilities
-*
-* Encoding and decoding of cursor tokens for keyset pagination.
-* Cursors are base64-encoded JSON containing position data and metadata.
-*/
-var cursor_exports = /* @__PURE__ */ __exportAll({
-	decodeCursor: () => decodeCursor,
-	encodeCursor: () => encodeCursor,
-	resolveCursorFilter: () => resolveCursorFilter,
-	validateCursorSort: () => validateCursorSort,
-	validateCursorVersion: () => validateCursorVersion
-});
-/**
-* Encodes document values and sort metadata into a base64 cursor token
-*
-* @param doc - Document to extract cursor values from
-* @param primaryField - Primary sort field name
-* @param sort - Normalized sort specification
-* @param version - Cursor version for forward compatibility
-* @returns Base64-encoded cursor token
-*/
-function encodeCursor(doc, primaryField, sort, version = 1) {
-	const primaryValue = doc[primaryField];
-	const idValue = doc._id;
-	const sortFields = Object.keys(sort).filter((k) => k !== "_id");
-	const vals = {};
-	const types = {};
-	for (const field of sortFields) {
-		vals[field] = serializeValue(doc[field]);
-		types[field] = getValueType(doc[field]);
-	}
-	const payload = {
-		v: serializeValue(primaryValue),
-		t: getValueType(primaryValue),
-		id: serializeValue(idValue),
-		idType: getValueType(idValue),
-		sort,
-		ver: version,
-		...sortFields.length > 1 && {
-			vals,
-			types
-		}
-	};
-	return Buffer.from(JSON.stringify(payload)).toString("base64");
-}
-/**
-* Decodes a cursor token back into document values and sort metadata
-*
-* @param token - Base64-encoded cursor token
-* @returns Decoded cursor data
-* @throws Error if token is invalid or malformed
-*/
-function decodeCursor(token) {
-	let json;
-	try {
-		json = Buffer.from(token, "base64").toString("utf-8");
-	} catch {
-		throw new Error("Invalid cursor token: not valid base64");
-	}
-	let payload;
-	try {
-		payload = JSON.parse(json);
-	} catch {
-		throw new Error("Invalid cursor token: not valid JSON");
-	}
-	if (!payload || typeof payload !== "object" || !("v" in payload) || !("t" in payload) || !("id" in payload) || !("idType" in payload) || !payload.sort || typeof payload.sort !== "object" || typeof payload.ver !== "number") throw new Error("Invalid cursor token: malformed payload structure");
-	const VALID_TYPES = [
-		"date",
-		"objectid",
-		"boolean",
-		"number",
-		"string",
-		"null",
-		"unknown"
-	];
-	if (!VALID_TYPES.includes(payload.t) || !VALID_TYPES.includes(payload.idType)) throw new Error("Invalid cursor token: unrecognized value type");
-	try {
-		let values;
-		if (payload.vals && payload.types) {
-			values = {};
-			for (const [field, serialized] of Object.entries(payload.vals)) values[field] = rehydrateValue(serialized, payload.types[field]);
-		}
-		return {
-			value: rehydrateValue(payload.v, payload.t),
-			id: rehydrateValue(payload.id, payload.idType),
-			sort: payload.sort,
-			version: payload.ver,
-			...values && { values }
-		};
-	} catch {
-		throw new Error("Invalid cursor token: failed to rehydrate values");
-	}
-}
-/**
-* Validates that cursor sort matches current query sort
-*
-* @param cursorSort - Sort specification from cursor
-* @param currentSort - Sort specification from query
-* @throws Error if sorts don't match
-*/
-function validateCursorSort(cursorSort, currentSort) {
-	if (JSON.stringify(cursorSort) !== JSON.stringify(currentSort)) throw new Error("Cursor sort does not match current query sort");
-}
-/**
-* Validates cursor version against the server's expected range.
-*
-* - Cursors newer than `expectedVersion` are rejected (client ahead of server).
-* - Cursors older than `minVersion` are rejected (client cached a cursor from
-*   a pre-breaking-change deploy). Default `minVersion = 1` keeps the legacy
-*   "accept anything <= expected" behavior; bump it when you ship a breaking
-*   cursor format change so old clients restart pagination cleanly instead of
-*   silently paginating from the wrong position.
-*/
-function validateCursorVersion(cursorVersion, expectedVersion, minVersion = 1) {
-	if (cursorVersion > expectedVersion) throw new Error(`Cursor version ${cursorVersion} is newer than expected version ${expectedVersion}. Please upgrade.`);
-	if (cursorVersion < minVersion) throw new Error(`Cursor version ${cursorVersion} is older than minimum supported ${minVersion}. Pagination must restart.`);
-}
-/**
-* Serializes a value for cursor storage
-*/
-function serializeValue(value) {
-	if (value === null || value === void 0) return null;
-	if (value instanceof Date) return value.toISOString();
-	if (value instanceof mongoose.Types.ObjectId) return value.toString();
-	return value;
-}
-/**
-* Gets the type identifier for a value
-*/
-function getValueType(value) {
-	if (value === null || value === void 0) return "null";
-	if (value instanceof Date) return "date";
-	if (value instanceof mongoose.Types.ObjectId) return "objectid";
-	if (typeof value === "boolean") return "boolean";
-	if (typeof value === "number") return "number";
-	if (typeof value === "string") return "string";
-	return "unknown";
-}
-/**
-* Rehydrates a serialized value back to its original type
-*/
-function rehydrateValue(serialized, type) {
-	if (type === "null" || serialized === null) return null;
-	switch (type) {
-		case "date": return new Date(serialized);
-		case "objectid": return new mongoose.Types.ObjectId(serialized);
-		case "boolean": return serialized === true || serialized === "true";
-		case "number": return Number(serialized);
-		default: return serialized;
-	}
-}
-/**
-* Resolves cursor token into MongoDB query filters.
-* Shared by PaginationEngine.stream() and Repository.lookupPopulate() keyset path.
-*
-* Handles:
-* - Plain 24-char hex ObjectId strings (fallback cursor)
-* - Base64-encoded cursor tokens (standard cursor)
-* - Cursor version and sort validation
-*/
-function resolveCursorFilter(after, sort, cursorVersion, baseFilters = {}, minCursorVersion = 1) {
-	if (/^[a-f0-9]{24}$/i.test(after)) {
-		const objectId = new mongoose.Types.ObjectId(after);
-		const idOperator = (sort._id || -1) === 1 ? "$gt" : "$lt";
-		return {
-			...baseFilters,
-			_id: { [idOperator]: objectId }
-		};
-	}
-	const cursor = decodeCursor(after);
-	validateCursorVersion(cursor.version, cursorVersion, minCursorVersion);
-	validateCursorSort(cursor.sort, sort);
-	return buildKeysetFilter(baseFilters, sort, cursor.value, cursor.id, cursor.values);
-}
-//#endregion
-export { encodeCursor as n, resolveCursorFilter as r, cursor_exports as t };