@classytic/mongokit 3.3.2 → 3.4.0

package/dist/index.mjs

@@ -1,87 +1,13 @@
-import { i as createError, r as warn, t as configureLogger } from "./logger-D8ily-PP.mjs";
-import { r as LookupBuilder } from "./aggregate-BClp040M.mjs";
-import { PaginationEngine } from "./pagination/PaginationEngine.mjs";
-import { A as AggregationBuilder, C as methodRegistryPlugin, D as fieldFilterPlugin, E as timestampPlugin, O as HOOK_PRIORITY, S as validationChainPlugin, T as auditLogPlugin, _ as autoInject, a as sequentialId, b as requireField, c as auditTrailPlugin, d as cascadePlugin, f as cachePlugin, g as mongoOperationsPlugin, h as batchOperationsPlugin, i as prefixedId, k as Repository, l as observabilityPlugin, m as aggregateHelpersPlugin, n as dateSequentialId, o as elasticSearchPlugin, p as subdocumentPlugin, r as getNextSequence, s as AuditTrailQuery, t as customIdPlugin, u as multiTenantPlugin, v as blockIf, w as softDeletePlugin, x as uniqueField, y as immutableField } from "./custom-id.plugin-FInXDsUX.mjs";
-import { c as filterResponseData, l as getFieldsForUser, s as createFieldPreset, u as getMongooseProjection } from "./cache-keys-CzFwVnLy.mjs";
-import { a as isFieldUpdateAllowed, i as getSystemManagedFields, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-D_i2Am_O.mjs";
+import { a as warn, n as parseDuplicateKeyError, r as configureLogger, t as createError } from "./error-Bpbi_NKo.mjs";
+import { _ as LookupBuilder } from "./update-DXwVh6M1.mjs";
 import { t as actions_exports } from "./actions/index.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-PLyDhrO7.mjs";
+import { A as aggregateHelpersPlugin, C as HOOK_PRIORITY, D as AuditTrailQuery, E as batchOperationsPlugin, O as auditTrailPlugin, S as cachePlugin, T as AggregationBuilder, _ as dateSequentialId, a as uniqueField, b as sequentialId, c as subdocumentPlugin, d as multiTenantPlugin, f as mongoOperationsPlugin, g as customIdPlugin, h as elasticSearchPlugin, i as requireField, k as auditLogPlugin, l as softDeletePlugin, m as fieldFilterPlugin, n as blockIf, o as validationChainPlugin, p as methodRegistryPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as observabilityPlugin, v as getNextSequence, w as Repository, x as cascadePlugin, y as prefixedId } from "./validation-chain.plugin-Ow6EUIoo.mjs";
+import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-CalOB7yM.mjs";
+import { a as isFieldUpdateAllowed, i as getSystemManagedFields, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-OmdmnHtx.mjs";
 import mongoose from "mongoose";
-
 //#region src/query/QueryParser.ts
 /**
-* Modern Query Parser - URL to MongoDB Query Transpiler
-*
-* Next-generation query parser that converts URL parameters to MongoDB aggregation pipelines.
-* Smarter than Prisma/tRPC for MongoDB with support for:
-* - Custom field lookups ($lookup)
-* - Complex filtering with operators
-* - Full-text search
-* - Aggregations via URL
-* - Security hardening
-*
-* @example
-* ```typescript
-* // Simple usage
-* const parser = new QueryParser();
-* const query = parser.parse(req.query);
-*
-* // URL: ?status=active&lookup[department]=slug&sort=-createdAt&page=1&limit=20
-* // Result: Complete MongoDB query with $lookup, filters, sort, pagination
-* ```
-*
-* ## SECURITY CONSIDERATIONS FOR PRODUCTION
-*
-* ### Aggregation Security (enableAggregations option)
-*
-* **IMPORTANT:** The `enableAggregations` option exposes powerful MongoDB aggregation
-* pipeline capabilities via URL parameters. While this feature includes sanitization
-* (blocks $where, $function, $accumulator), it should be used with caution:
-*
-* **Recommended security practices:**
-* 1. **Disable by default for public endpoints:**
-*    ```typescript
-*    const parser = new QueryParser({
-*      enableAggregations: false  // Default: disabled
-*    });
-*    ```
-*
-* 2. **Use per-route allowlists for trusted clients:**
-*    ```typescript
-*    // Admin/internal routes only
-*    if (req.user?.role === 'admin') {
-*      const allowedStages = ['$match', '$project', '$sort', '$limit'];
-*      // Validate aggregate parameter against allowlist
-*    }
-*    ```
-*
-* 3. **Validate stage structure:** Even with sanitization, complex pipelines can
-*    cause performance issues. Consider limiting:
-*    - Number of pipeline stages (e.g., max 5)
-*    - Specific allowed operators per stage
-*    - Allowed fields in $project/$match
-*
-* 4. **Monitor resource usage:** Aggregation pipelines can be expensive.
-*    Use MongoDB profiling to track slow operations.
-*
-* ### Lookup Security
-*
-* Lookup pipelines are sanitized by default:
-* - Dangerous stages blocked ($out, $merge, $unionWith, $collStats, $currentOp, $listSessions)
-* - Dangerous operators blocked inside $match/$addFields/$set ($where, $function, $accumulator, $expr)
-* - Optional collection whitelist via `allowedLookupCollections`
-* For maximum security, use per-collection field allowlists in your controller layer.
-*
-* ### Filter Security
-*
-* All filters are sanitized:
-* - Dangerous operators blocked ($where, $function, $accumulator, $expr)
-* - Regex patterns validated (ReDoS protection)
-* - Max filter depth enforced (prevents filter bombs)
-* - Max limit enforced (prevents resource exhaustion)
-*
-* @see {@link https://github.com/classytic/mongokit/blob/main/docs/SECURITY.md}
-*/
-/**
 * Modern Query Parser
 * Converts URL parameters to MongoDB queries with $lookup support
 */
@@ -113,7 +39,7 @@ var QueryParser = class {
 	* - Backreferences: \1, \2, etc.
 	* - Complex character classes: [...]...[...]
 	*/
-	dangerousRegexPatterns = /(\{[0-9,]+\}|\*\+|\+\+|\?\+|(\(.+\))\+|\(\?\:|\\[0-9]|(\[.+\]).+(\[.+\]))/;
+	dangerousRegexPatterns = /(\{[0-9,]+\}|\*\+|\+\+|\?\+|(\(.+\))\+|\(\?:|\\[0-9]|(\[.+\]).+(\[.+\]))/;
 	constructor(options = {}) {
 		this.options = {
 			maxRegexLength: options.maxRegexLength ?? 500,
@@ -155,7 +81,7 @@ var QueryParser = class {
 	parse(query) {
 		const { page, limit = 20, sort = "-createdAt", populate, search, after, cursor, select, lookup, aggregate, ...filters } = query || {};
 		let parsedLimit = parseInt(String(limit), 10);
-		if (isNaN(parsedLimit) || parsedLimit < 1) parsedLimit = 20;
+		if (Number.isNaN(parsedLimit) || parsedLimit < 1) parsedLimit = 20;
 		if (parsedLimit > this.options.maxLimit) {
 			warn(`[mongokit] Limit ${parsedLimit} exceeds maximum ${this.options.maxLimit}, capping to max`);
 			parsedLimit = this.options.maxLimit;
@@ -248,15 +174,15 @@ var QueryParser = class {
 				description: "Cursor value for keyset pagination"
 			}
 		};
-		if (this.options.enableLookups) properties["lookup"] = {
+		if (this.options.enableLookups) properties.lookup = {
 			type: "object",
 			description: "Custom field lookups ($lookup). Example: lookup[department]=slug or lookup[department][localField]=deptId&lookup[department][foreignField]=_id"
 		};
-		if (this.options.enableAggregations) properties["aggregate"] = {
+		if (this.options.enableAggregations) properties.aggregate = {
 			type: "object",
 			description: "Aggregation pipeline stages. Supports: group, match, sort, project. Example: aggregate[group][_id]=$status"
 		};
-		const availableOperators = this.options.allowedOperators ? Object.entries(this.operators).filter(([key]) => this.options.allowedOperators.includes(key)) : Object.entries(this.operators);
+		const availableOperators = this.options.allowedOperators ? Object.entries(this.operators).filter(([key]) => this.options.allowedOperators?.includes(key)) : Object.entries(this.operators);
 		if (this.options.allowedFilterFields && this.options.allowedFilterFields.length > 0) for (const field of this.options.allowedFilterFields) {
 			properties[field] = {
 				type: "string",
@@ -283,8 +209,8 @@ var QueryParser = class {
 	*/
 	getOpenAPIQuerySchema() {
 		const schema = this.getQuerySchema();
-		const availableOperators = this.options.allowedOperators ? Object.entries(this.operators).filter(([key]) => this.options.allowedOperators.includes(key)) : Object.entries(this.operators);
-		schema.properties["_filterOperators"] = {
+		const availableOperators = this.options.allowedOperators ? Object.entries(this.operators).filter(([key]) => this.options.allowedOperators?.includes(key)) : Object.entries(this.operators);
+		schema.properties._filterOperators = {
 			type: "string",
 			description: this._buildOperatorDescription(availableOperators),
 			"x-internal": true
@@ -420,6 +346,7 @@ var QueryParser = class {
 				foreignField,
 				as: opts.as || collectionName,
 				single: opts.single === true || opts.single === "true",
+				...opts.select ? { select: String(opts.select) } : {},
 				...opts.pipeline && Array.isArray(opts.pipeline) ? { pipeline: this._sanitizePipeline(opts.pipeline) } : {}
 			};
 		}
@@ -525,7 +452,7 @@ var QueryParser = class {
 			if (opts.match && typeof opts.match === "object") option.match = this._convertPopulateMatch(opts.match);
 			if (opts.limit !== void 0) {
 				const limit = parseInt(String(opts.limit), 10);
-				if (!isNaN(limit) && limit > 0) {
+				if (!Number.isNaN(limit) && limit > 0) {
 					option.options = option.options || {};
 					option.options.limit = limit;
 				}
@@ -539,7 +466,7 @@ var QueryParser = class {
 			}
 			if (opts.skip !== void 0) {
 				const skip = parseInt(String(opts.skip), 10);
-				if (!isNaN(skip) && skip >= 0) {
+				if (!Number.isNaN(skip) && skip >= 0) {
 					option.options = option.options || {};
 					option.options.skip = skip;
 				}
@@ -603,7 +530,7 @@ var QueryParser = class {
 			}
 			if (operatorMatch) {
 				const [, , operator] = operatorMatch;
-				if (this.dangerousOperators.includes("$" + operator)) {
+				if (this.dangerousOperators.includes(`$${operator}`)) {
 					warn(`[mongokit] Blocked dangerous operator: ${operator}`);
 					continue;
 				}
@@ -662,7 +589,7 @@ var QueryParser = class {
 				"size"
 			].includes(op)) {
 				processedValue = parseFloat(String(value));
-				if (isNaN(processedValue)) return;
+				if (Number.isNaN(processedValue)) return;
 			} else if (op === "in" || op === "nin") processedValue = Array.isArray(value) ? value : String(value).split(",").map((v) => v.trim());
 			else processedValue = this._convertValue(value);
 			if (typeof filters[field] !== "object" || filters[field] === null || Array.isArray(filters[field])) filters[field] = {};
@@ -699,7 +626,7 @@ var QueryParser = class {
 					"size"
 				].includes(operator)) {
 					processedValue = parseFloat(String(value));
-					if (isNaN(processedValue)) continue;
+					if (Number.isNaN(processedValue)) continue;
 				} else if (operator === "in" || operator === "nin") processedValue = Array.isArray(value) ? value : String(value).split(",").map((v) => v.trim());
 				else if (operator === "like" || operator === "contains" || operator === "regex") {
 					const safeRegex = this._createSafeRegex(value);
@@ -741,7 +668,7 @@ var QueryParser = class {
 	}
 	_toMongoOperator(operator) {
 		const op = operator.toLowerCase();
-		return op.startsWith("$") ? op : "$" + op;
+		return op.startsWith("$") ? op : `$${op}`;
 	}
 	_createSafeRegex(pattern, flags = "i") {
 		if (pattern === null || pattern === void 0) return null;
@@ -890,22 +817,21 @@ var QueryParser = class {
 			const fromDate = from ? new Date(from) : void 0;
 			const toDate = to ? new Date(to) : void 0;
 			const range = {};
-			if (fromDate && !isNaN(fromDate.getTime())) range.$gte = fromDate;
-			if (toDate && !isNaN(toDate.getTime())) range.$lte = toDate;
+			if (fromDate && !Number.isNaN(fromDate.getTime())) range.$gte = fromDate;
+			if (toDate && !Number.isNaN(toDate.getTime())) range.$lte = toDate;
 			output[key] = range;
 		}
 		return output;
 	}
 	_pluralize(str) {
-		if (str.endsWith("y")) return str.slice(0, -1) + "ies";
+		if (str.endsWith("y")) return `${str.slice(0, -1)}ies`;
 		if (str.endsWith("s")) return str;
-		return str + "s";
+		return `${str}s`;
 	}
 	_capitalize(str) {
 		return str.charAt(0).toUpperCase() + str.slice(1);
 	}
 };
-
 //#endregion
 //#region src/index.ts
 /**
@@ -922,6 +848,5 @@ function createRepository(Model, plugins = [], paginationConfig = {}, options =
 	return new Repository(Model, plugins, paginationConfig, options);
 }
 var src_default = Repository;
-
 //#endregion
-export { AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, LookupBuilder, PaginationEngine, QueryParser, Repository, actions_exports as actions, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, configureLogger, createError, createFieldPreset, createMemoryCache, createRepository, customIdPlugin, dateSequentialId, src_default as default, elasticSearchPlugin, fieldFilterPlugin, filterResponseData, getFieldsForUser, getImmutableFields, getMongooseProjection, getNextSequence, getSystemManagedFields, immutableField, isFieldUpdateAllowed, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validateUpdateBody, validationChainPlugin };
+export { AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, LookupBuilder, PaginationEngine, QueryParser, Repository, actions_exports as actions, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, configureLogger, createError, createFieldPreset, createMemoryCache, createRepository, customIdPlugin, dateSequentialId, src_default as default, elasticSearchPlugin, fieldFilterPlugin, filterResponseData, getFieldsForUser, getImmutableFields, getMongooseProjection, getNextSequence, getSystemManagedFields, immutableField, isFieldUpdateAllowed, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, parseDuplicateKeyError, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validateUpdateBody, validationChainPlugin };

package/dist/{mongooseToJsonSchema-B6O2ED3n.d.mts → mongooseToJsonSchema-BqgVOlrR.d.mts}

@@ -1,6 +1,28 @@
-import { $ as SchemaBuilderOptions, T as HttpError, dt as UserContext, m as CrudSchemas, o as CacheAdapter, pt as ValidationResult, x as FieldPreset } from "./types-pVY0w1Pp.mjs";
+import { $ as SchemaBuilderOptions, T as HttpError, dt as UserContext, m as CrudSchemas, o as CacheAdapter, pt as ValidationResult, x as FieldPreset } from "./types-BlCwDszq.mjs";
 import mongoose, { Schema } from "mongoose";
 
+//#region src/utils/error.d.ts
+/**
+ * Creates an error with HTTP status code
+ *
+ * @param status - HTTP status code
+ * @param message - Error message
+ * @returns Error with status property
+ *
+ * @example
+ * throw createError(404, 'Document not found');
+ * throw createError(400, 'Invalid input');
+ * throw createError(403, 'Access denied');
+ */
+declare function createError(status: number, message: string): HttpError;
+/**
+ * Detect and convert a MongoDB E11000 duplicate-key error into
+ * a 409 HttpError with an actionable message.
+ *
+ * Returns `null` when the error is not a duplicate-key error.
+ */
+declare function parseDuplicateKeyError(error: unknown): HttpError | null;
+//#endregion
 //#region src/utils/field-selection.d.ts
 /**
  * Get allowed fields for a user based on their context
@@ -69,21 +91,6 @@ declare function filterResponseData<T extends Record<string, unknown>>(data: T |
  */
 declare function createFieldPreset(config: Partial<FieldPreset>): FieldPreset;
 //#endregion
-//#region src/utils/error.d.ts
-/**
- * Creates an error with HTTP status code
- *
- * @param status - HTTP status code
- * @param message - Error message
- * @returns Error with status property
- *
- * @example
- * throw createError(404, 'Document not found');
- * throw createError(400, 'Invalid input');
- * throw createError(403, 'Access denied');
- */
-declare function createError(status: number, message: string): HttpError;
-//#endregion
 //#region src/utils/logger.d.ts
 /**
  * Internal Logger
@@ -155,4 +162,4 @@ declare function isFieldUpdateAllowed(fieldName: string, options?: SchemaBuilder
  */
 declare function validateUpdateBody(body?: Record<string, unknown>, options?: SchemaBuilderOptions): ValidationResult;
 //#endregion
-export { isFieldUpdateAllowed as a, configureLogger as c, filterResponseData as d, getFieldsForUser as f, getSystemManagedFields as i, createError as l, buildCrudSchemasFromMongooseSchema as n, validateUpdateBody as o, getMongooseProjection as p, getImmutableFields as r, createMemoryCache as s, buildCrudSchemasFromModel as t, createFieldPreset as u };
+export { isFieldUpdateAllowed as a, configureLogger as c, getFieldsForUser as d, getMongooseProjection as f, getSystemManagedFields as i, createFieldPreset as l, parseDuplicateKeyError as m, buildCrudSchemasFromMongooseSchema as n, validateUpdateBody as o, createError as p, getImmutableFields as r, createMemoryCache as s, buildCrudSchemasFromModel as t, filterResponseData as u };

package/dist/{mongooseToJsonSchema-D_i2Am_O.mjs → mongooseToJsonSchema-OmdmnHtx.mjs}

@@ -1,14 +1,13 @@
-import mongoose, { Schema } from "mongoose";
-
+import "mongoose";
 //#region src/utils/memory-cache.ts
 /**
 * Creates an in-memory cache adapter
-* 
+*
 * Features:
 * - Automatic TTL expiration
 * - Pattern-based clearing (simple glob with *)
 * - Max entries limit to prevent memory leaks
-* 
+*
 * @param maxEntries - Maximum cache entries before oldest are evicted (default: 1000)
 */
 function createMemoryCache(maxEntries = 1e3) {
@@ -60,12 +59,11 @@ function createMemoryCache(maxEntries = 1e3) {
 				return;
 			}
 			const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
-			const regex = new RegExp("^" + escaped + "$");
+			const regex = new RegExp(`^${escaped}$`);
 			for (const key of cache.keys()) if (regex.test(key)) cache.delete(key);
 		}
 	};
 }
-
 //#endregion
 //#region src/utils/mongooseToJsonSchema.ts
 /**
@@ -91,7 +89,7 @@ function buildCrudSchemasFromMongooseSchema(mongooseSchema, options = {}) {
 * Build CRUD schemas from Mongoose model
 */
 function buildCrudSchemasFromModel(mongooseModel, options = {}) {
-	if (!mongooseModel || !mongooseModel.schema) throw new Error("Invalid mongoose model");
+	if (!mongooseModel?.schema) throw new Error("Invalid mongoose model");
 	return buildCrudSchemasFromMongooseSchema(mongooseModel.schema, options);
 }
 /**
@@ -161,7 +159,7 @@ function buildJsonSchemaFromPaths(mongooseSchema, options) {
 		if (path === "_id" || path === "__v") continue;
 		const rootField = path.split(".")[0];
 		if (!rootFields.has(rootField)) rootFields.set(rootField, []);
-		rootFields.get(rootField).push({
+		rootFields.get(rootField)?.push({
 			path,
 			schemaType
 		});
@@ -185,7 +183,9 @@ function buildJsonSchemaFromPaths(mongooseSchema, options) {
 		"updatedAt",
 		"__v"
 	]);
-	(options?.create?.omitFields || []).forEach((f) => fieldsToOmit.add(f));
+	(options?.create?.omitFields || []).forEach((f) => {
+		fieldsToOmit.add(f);
+	});
 	const fieldRules = options?.fieldRules || {};
 	Object.entries(fieldRules).forEach(([field, rules]) => {
 		if (rules.systemManaged) fieldsToOmit.add(field);
@@ -281,7 +281,9 @@ function buildJsonSchemaForUpdate(createJson, options) {
 	const clone = JSON.parse(JSON.stringify(createJson));
 	delete clone.required;
 	const fieldsToOmit = /* @__PURE__ */ new Set();
-	(options?.update?.omitFields || []).forEach((f) => fieldsToOmit.add(f));
+	(options?.update?.omitFields || []).forEach((f) => {
+		fieldsToOmit.add(f);
+	});
 	const fieldRules = options?.fieldRules || {};
 	Object.entries(fieldRules).forEach(([field, rules]) => {
 		if (rules.immutable || rules.immutableAfterCreate) fieldsToOmit.add(field);
@@ -312,6 +314,5 @@ function buildJsonSchemaForQuery(_tree, options) {
 	for (const [k, v] of Object.entries(filterable)) if (basePagination.properties) basePagination.properties[k] = v && typeof v === "object" && "type" in v ? v : { type: "string" };
 	return basePagination;
 }
-
 //#endregion
-export { isFieldUpdateAllowed as a, getSystemManagedFields as i, buildCrudSchemasFromMongooseSchema as n, validateUpdateBody as o, getImmutableFields as r, createMemoryCache as s, buildCrudSchemasFromModel as t };
+export { isFieldUpdateAllowed as a, getSystemManagedFields as i, buildCrudSchemasFromMongooseSchema as n, validateUpdateBody as o, getImmutableFields as r, createMemoryCache as s, buildCrudSchemasFromModel as t };

package/dist/pagination/PaginationEngine.d.mts

@@ -1,4 +1,4 @@
-import { A as KeysetPaginationOptions, I as OffsetPaginationOptions, L as OffsetPaginationResult, i as AnyDocument, j as KeysetPaginationResult, n as AggregatePaginationResult, t as AggregatePaginationOptions, z as PaginationConfig } from "../types-pVY0w1Pp.mjs";
+import { A as KeysetPaginationOptions, I as OffsetPaginationOptions, L as OffsetPaginationResult, i as AnyDocument, j as KeysetPaginationResult, n as AggregatePaginationResult, t as AggregatePaginationOptions, z as PaginationConfig } from "../types-BlCwDszq.mjs";
 import { Model } from "mongoose";
 
 //#region src/pagination/PaginationEngine.d.ts

package/dist/pagination/PaginationEngine.mjs

@@ -1,209 +1,2 @@
-import { i as createError, r as warn } from "../logger-D8ily-PP.mjs";
-import { a as validatePage, c as validateKeysetSort, d as validateCursorSort, f as validateCursorVersion, i as validateLimit, l as decodeCursor, n as calculateTotalPages, o as buildKeysetFilter, r as shouldWarnDeepPagination, s as getPrimaryField, t as calculateSkip, u as encodeCursor } from "../limits-s1-d8rWb.mjs";
-
-//#region src/pagination/PaginationEngine.ts
-/**
-* Production-grade pagination engine for MongoDB
-* Supports offset, keyset (cursor), and aggregate pagination
-*/
-var PaginationEngine = class {
-	Model;
-	config;
-	/**
-	* Create a new pagination engine
-	*
-	* @param Model - Mongoose model to paginate
-	* @param config - Pagination configuration
-	*/
-	constructor(Model, config = {}) {
-		this.Model = Model;
-		this.config = {
-			defaultLimit: config.defaultLimit || 10,
-			maxLimit: config.maxLimit || 100,
-			maxPage: config.maxPage || 1e4,
-			deepPageThreshold: config.deepPageThreshold || 100,
-			cursorVersion: config.cursorVersion || 1,
-			useEstimatedCount: config.useEstimatedCount || false
-		};
-	}
-	/**
-	* Offset-based pagination using skip/limit
-	* Best for small datasets and when users need random page access
-	* O(n) performance - slower for deep pages
-	*
-	* @param options - Pagination options
-	* @returns Pagination result with total count
-	*
-	* @example
-	* const result = await engine.paginate({
-	*   filters: { status: 'active' },
-	*   sort: { createdAt: -1 },
-	*   page: 1,
-	*   limit: 20
-	* });
-	* console.log(result.docs, result.total, result.hasNext);
-	*/
-	async paginate(options = {}) {
-		const { filters = {}, sort = { _id: -1 }, page = 1, limit = this.config.defaultLimit, select, populate = [], lean = true, session, hint, maxTimeMS, countStrategy = "exact", readPreference } = options;
-		const sanitizedPage = validatePage(page, this.config);
-		const sanitizedLimit = validateLimit(limit, this.config);
-		const skip = calculateSkip(sanitizedPage, sanitizedLimit);
-		const fetchLimit = countStrategy === "none" ? sanitizedLimit + 1 : sanitizedLimit;
-		let query = this.Model.find(filters);
-		if (select) query = query.select(select);
-		if (populate && (Array.isArray(populate) ? populate.length : populate)) query = query.populate(populate);
-		query = query.sort(sort).skip(skip).limit(fetchLimit).lean(lean);
-		if (session) query = query.session(session);
-		if (hint) query = query.hint(hint);
-		if (maxTimeMS) query = query.maxTimeMS(maxTimeMS);
-		if (readPreference) query = query.read(readPreference);
-		const hasFilters = Object.keys(filters).length > 0;
-		const useEstimated = this.config.useEstimatedCount && !hasFilters;
-		let total = 0;
-		if (countStrategy === "estimated" || useEstimated && countStrategy !== "exact") total = await this.Model.estimatedDocumentCount();
-		else if (countStrategy === "exact") {
-			const countQuery = this.Model.countDocuments(filters).session(session ?? null);
-			if (hint) countQuery.hint(hint);
-			if (maxTimeMS) countQuery.maxTimeMS(maxTimeMS);
-			if (readPreference) countQuery.read(readPreference);
-			total = await countQuery;
-		}
-		const [docs] = await Promise.all([query.exec()]);
-		const totalPages = countStrategy === "none" ? 0 : calculateTotalPages(total, sanitizedLimit);
-		let hasNext;
-		if (countStrategy === "none") {
-			hasNext = docs.length > sanitizedLimit;
-			if (hasNext) docs.pop();
-		} else hasNext = sanitizedPage < totalPages;
-		const warning = shouldWarnDeepPagination(sanitizedPage, this.config.deepPageThreshold) ? `Deep pagination (page ${sanitizedPage}). Consider getAll({ after, sort, limit }) for better performance.` : void 0;
-		return {
-			method: "offset",
-			docs,
-			page: sanitizedPage,
-			limit: sanitizedLimit,
-			total,
-			pages: totalPages,
-			hasNext,
-			hasPrev: sanitizedPage > 1,
-			...warning && { warning }
-		};
-	}
-	/**
-	* Keyset (cursor-based) pagination for high-performance streaming
-	* Best for large datasets, infinite scroll, real-time feeds
-	* O(1) performance - consistent speed regardless of position
-	*
-	* @param options - Pagination options (sort is required)
-	* @returns Pagination result with next cursor
-	*
-	* @example
-	* // First page
-	* const page1 = await engine.stream({
-	*   sort: { createdAt: -1 },
-	*   limit: 20
-	* });
-	*
-	* // Next page using cursor
-	* const page2 = await engine.stream({
-	*   sort: { createdAt: -1 },
-	*   after: page1.next,
-	*   limit: 20
-	* });
-	*/
-	async stream(options) {
-		const { filters = {}, sort, after, limit = this.config.defaultLimit, select, populate = [], lean = true, session, hint, maxTimeMS, readPreference } = options;
-		if (!sort) throw createError(400, "sort is required for keyset pagination");
-		const sanitizedLimit = validateLimit(limit, this.config);
-		const normalizedSort = validateKeysetSort(sort);
-		const filterKeys = Object.keys(filters).filter((k) => !k.startsWith("$"));
-		const sortFields = Object.keys(normalizedSort);
-		if (filterKeys.length > 0 && sortFields.length > 0) {
-			const indexFields = [...filterKeys.map((f) => `${f}: 1`), ...sortFields.map((f) => `${f}: ${normalizedSort[f]}`)];
-			warn(`[mongokit] Keyset pagination with filters [${filterKeys.join(", ")}] and sort [${sortFields.join(", ")}] requires a compound index for O(1) performance. Ensure index exists: { ${indexFields.join(", ")} }`);
-		}
-		let query = { ...filters };
-		if (after) {
-			const cursor = decodeCursor(after);
-			validateCursorVersion(cursor.version, this.config.cursorVersion);
-			validateCursorSort(cursor.sort, normalizedSort);
-			query = buildKeysetFilter(query, normalizedSort, cursor.value, cursor.id);
-		}
-		let mongoQuery = this.Model.find(query);
-		if (select) mongoQuery = mongoQuery.select(select);
-		if (populate && (Array.isArray(populate) ? populate.length : populate)) mongoQuery = mongoQuery.populate(populate);
-		mongoQuery = mongoQuery.sort(normalizedSort).limit(sanitizedLimit + 1).lean(lean);
-		if (session) mongoQuery = mongoQuery.session(session);
-		if (hint) mongoQuery = mongoQuery.hint(hint);
-		if (maxTimeMS) mongoQuery = mongoQuery.maxTimeMS(maxTimeMS);
-		if (readPreference) mongoQuery = mongoQuery.read(readPreference);
-		const docs = await mongoQuery.exec();
-		const hasMore = docs.length > sanitizedLimit;
-		if (hasMore) docs.pop();
-		const primaryField = getPrimaryField(normalizedSort);
-		return {
-			method: "keyset",
-			docs,
-			limit: sanitizedLimit,
-			hasMore,
-			next: hasMore && docs.length > 0 ? encodeCursor(docs[docs.length - 1], primaryField, normalizedSort, this.config.cursorVersion) : null
-		};
-	}
-	/**
-	* Aggregate pipeline with pagination
-	* Best for complex queries requiring aggregation stages
-	* Uses $facet to combine results and count in single query
-	*
-	* @param options - Aggregation options
-	* @returns Pagination result with total count
-	*
-	* @example
-	* const result = await engine.aggregatePaginate({
-	*   pipeline: [
-	*     { $match: { status: 'active' } },
-	*     { $group: { _id: '$category', count: { $sum: 1 } } },
-	*     { $sort: { count: -1 } }
-	*   ],
-	*   page: 1,
-	*   limit: 20
-	* });
-	*/
-	async aggregatePaginate(options = {}) {
-		const { pipeline = [], page = 1, limit = this.config.defaultLimit, session, hint, maxTimeMS, countStrategy = "exact", readPreference } = options;
-		const sanitizedPage = validatePage(page, this.config);
-		const sanitizedLimit = validateLimit(limit, this.config);
-		const skip = calculateSkip(sanitizedPage, sanitizedLimit);
-		const fetchLimit = countStrategy === "none" ? sanitizedLimit + 1 : sanitizedLimit;
-		const facetStages = { docs: [{ $skip: skip }, { $limit: fetchLimit }] };
-		if (countStrategy !== "none") facetStages.total = [{ $count: "count" }];
-		const facetPipeline = [...pipeline, { $facet: facetStages }];
-		const aggregation = this.Model.aggregate(facetPipeline);
-		if (session) aggregation.session(session);
-		if (hint) aggregation.hint(hint);
-		if (maxTimeMS) aggregation.option({ maxTimeMS });
-		if (readPreference) aggregation.read(readPreference);
-		const [result] = await aggregation.exec();
-		const docs = result.docs;
-		const total = result.total?.[0]?.count || 0;
-		const totalPages = countStrategy === "none" ? 0 : calculateTotalPages(total, sanitizedLimit);
-		let hasNext;
-		if (countStrategy === "none") {
-			hasNext = docs.length > sanitizedLimit;
-			if (hasNext) docs.pop();
-		} else hasNext = sanitizedPage < totalPages;
-		const warning = shouldWarnDeepPagination(sanitizedPage, this.config.deepPageThreshold) ? `Deep pagination in aggregate (page ${sanitizedPage}). Uses $skip internally.` : void 0;
-		return {
-			method: "aggregate",
-			docs,
-			page: sanitizedPage,
-			limit: sanitizedLimit,
-			total,
-			pages: totalPages,
-			hasNext,
-			hasPrev: sanitizedPage > 1,
-			...warning && { warning }
-		};
-	}
-};
-
-//#endregion
-export { PaginationEngine };
+import { t as PaginationEngine } from "../PaginationEngine-PLyDhrO7.mjs";
+export { PaginationEngine };

package/dist/plugins/index.d.mts

@@ -1,3 +1,2 @@
-import "../types-pVY0w1Pp.mjs";
-import { A as subdocumentPlugin, B as immutableField, C as observabilityPlugin, D as CacheMethods, E as cascadePlugin, F as batchOperationsPlugin, G as methodRegistryPlugin, H as uniqueField, I as MongoOperationsMethods, J as auditLogPlugin, K as SoftDeleteMethods, L as mongoOperationsPlugin, M as aggregateHelpersPlugin, N as BatchOperationsMethods, O as cachePlugin, R as autoInject, S as OperationMetric, T as multiTenantPlugin, U as validationChainPlugin, V as requireField, W as MethodRegistryRepository, X as fieldFilterPlugin, Y as timestampPlugin, _ as AuditTrailMethods, a as SequentialIdOptions, b as auditTrailPlugin, c as getNextSequence, d as ElasticSearchOptions, f as elasticSearchPlugin, g as AuditQueryResult, h as AuditQueryOptions, i as PrefixedIdOptions, j as AggregateHelpersMethods, k as SubdocumentMethods, l as prefixedId, m as AuditOperation, n as DateSequentialIdOptions, o as customIdPlugin, p as AuditEntry, q as softDeletePlugin, r as IdGenerator, s as dateSequentialId, t as CustomIdOptions, u as sequentialId, v as AuditTrailOptions, w as MultiTenantOptions, x as ObservabilityOptions, y as AuditTrailQuery, z as blockIf } from "../custom-id.plugin-BJ3FSnzt.mjs";
+import { A as dateSequentialId, B as AuditEntry, C as elasticSearchPlugin, D as PrefixedIdOptions, E as IdGenerator, F as CacheMethods, G as AuditTrailOptions, H as AuditQueryOptions, I as cachePlugin, J as auditLogPlugin, K as AuditTrailQuery, L as BatchOperationsMethods, M as prefixedId, N as sequentialId, O as SequentialIdOptions, P as cascadePlugin, S as ElasticSearchOptions, T as DateSequentialIdOptions, U as AuditQueryResult, V as AuditOperation, W as AuditTrailMethods, X as aggregateHelpersPlugin, Y as AggregateHelpersMethods, _ as MongoOperationsMethods, a as uniqueField, b as methodRegistryPlugin, c as SubdocumentMethods, d as softDeletePlugin, f as ObservabilityOptions, g as multiTenantPlugin, h as MultiTenantOptions, i as requireField, j as getNextSequence, k as customIdPlugin, l as subdocumentPlugin, m as observabilityPlugin, n as blockIf, o as validationChainPlugin, p as OperationMetric, q as auditTrailPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as SoftDeleteMethods, v as mongoOperationsPlugin, w as CustomIdOptions, x as fieldFilterPlugin, y as MethodRegistryRepository, z as batchOperationsPlugin } from "../validation-chain.plugin-DxqiHv-E.mjs";
 export { type AggregateHelpersMethods, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BatchOperationsMethods, type CacheMethods, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type IdGenerator, type MethodRegistryRepository, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.mjs

@@ -1,3 +1,2 @@
-import { C as methodRegistryPlugin, D as fieldFilterPlugin, E as timestampPlugin, S as validationChainPlugin, T as auditLogPlugin, _ as autoInject, a as sequentialId, b as requireField, c as auditTrailPlugin, d as cascadePlugin, f as cachePlugin, g as mongoOperationsPlugin, h as batchOperationsPlugin, i as prefixedId, l as observabilityPlugin, m as aggregateHelpersPlugin, n as dateSequentialId, o as elasticSearchPlugin, p as subdocumentPlugin, r as getNextSequence, s as AuditTrailQuery, t as customIdPlugin, u as multiTenantPlugin, v as blockIf, w as softDeletePlugin, x as uniqueField, y as immutableField } from "../custom-id.plugin-FInXDsUX.mjs";
-
-export { AuditTrailQuery, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+import { A as aggregateHelpersPlugin, D as AuditTrailQuery, E as batchOperationsPlugin, O as auditTrailPlugin, S as cachePlugin, _ as dateSequentialId, a as uniqueField, b as sequentialId, c as subdocumentPlugin, d as multiTenantPlugin, f as mongoOperationsPlugin, g as customIdPlugin, h as elasticSearchPlugin, i as requireField, k as auditLogPlugin, l as softDeletePlugin, m as fieldFilterPlugin, n as blockIf, o as validationChainPlugin, p as methodRegistryPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as observabilityPlugin, v as getNextSequence, x as cascadePlugin, y as prefixedId } from "../validation-chain.plugin-Ow6EUIoo.mjs";
+export { AuditTrailQuery, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };