@classytic/mongokit 3.3.0 → 3.3.2

package/README.md

@@ -17,7 +17,7 @@
 - **Search governance** - Text index guard (throws `400` if no index), allowlisted sort/filter fields, ReDoS protection
 - **Vector search** - MongoDB Atlas `$vectorSearch` with auto-embedding and multimodal support
 - **TypeScript first** - Full type safety with discriminated unions
-- **592 passing tests** - Battle-tested and production-ready
+- **700+ passing tests** - Battle-tested and production-ready
 
 ## Installation
 
@@ -1247,7 +1247,7 @@ Extending Repository works exactly the same with Mongoose 8 and 9. The package:
 - Uses its own event system (not Mongoose middleware)
 - Defines its own `FilterQuery` type (unaffected by Mongoose 9 rename)
 - Properly gates update pipelines (safe for Mongoose 9's stricter defaults)
-- All 597 tests pass on Mongoose 9
+- All 700+ tests pass on Mongoose 9
 
 ## License
 

package/dist/index.d.mts

@@ -945,6 +945,16 @@ declare class QueryParser {
     properties: Record<string, unknown>;
     required?: string[];
   };
+  /**
+   * Get the query schema with OpenAPI extensions (x-internal metadata).
+   * Use this when generating OpenAPI/Swagger docs — it includes a documentary
+   * `_filterOperators` property describing available filter operators.
+   * For validation-only schemas, use `getQuerySchema()` instead.
+   */
+  getOpenAPIQuerySchema(): {
+    type: "object";
+    properties: Record<string, unknown>;
+  };
   /**
    * Get the JSON Schema type for a filter operator
    */

package/dist/index.mjs

@@ -237,8 +237,11 @@ var QueryParser = class {
 				description: "Fields to include/exclude (comma-separated). Prefix with - to exclude. Example: name,email,-password"
 			},
 			populate: {
-				type: "string",
-				description: "Fields to populate/join (comma-separated). Example: author,category"
+				oneOf: [{ type: "string" }, {
+					type: "object",
+					additionalProperties: true
+				}],
+				description: "Fields to populate/join. Simple: comma-separated string (author,category). Advanced: bracket-notation object (populate[author][select]=name,email)"
 			},
 			after: {
 				type: "string",
@@ -267,17 +270,28 @@ var QueryParser = class {
 				};
 			}
 		}
-		properties["_filterOperators"] = {
-			type: "string",
-			description: this._buildOperatorDescription(availableOperators),
-			"x-internal": true
-		};
 		return {
 			type: "object",
 			properties
 		};
 	}
 	/**
+	* Get the query schema with OpenAPI extensions (x-internal metadata).
+	* Use this when generating OpenAPI/Swagger docs — it includes a documentary
+	* `_filterOperators` property describing available filter operators.
+	* For validation-only schemas, use `getQuerySchema()` instead.
+	*/
+	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"] = {
+			type: "string",
+			description: this._buildOperatorDescription(availableOperators),
+			"x-internal": true
+		};
+		return schema;
+	}
+	/**
 	* Get the JSON Schema type for a filter operator
 	*/
 	_getOperatorSchemaType(op) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "description": "Production-grade MongoDB repositories with zero dependencies - smart pagination, events, and plugins",
   "type": "module",
   "sideEffects": false,
@@ -110,4 +110,4 @@
     "typescript": "^5.7.0",
     "vitest": "^3.2.4"
   }
-}
+}