@classytic/mongokit 3.2.5 → 3.3.1

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/actions/index.d.mts

@@ -1,5 +1,5 @@
-import "../types-Bnwv9NV6.mjs";
-import { a as create_d_exports, i as read_d_exports, n as delete_d_exports, r as update_d_exports, t as aggregate_d_exports } from "../aggregate-D9x87vej.mjs";
+import "../types-pVY0w1Pp.mjs";
+import { a as create_d_exports, i as read_d_exports, n as delete_d_exports, r as update_d_exports, t as aggregate_d_exports } from "../aggregate-BkOG9qwr.mjs";
 
 //#region src/actions/index.d.ts
 declare namespace index_d_exports {

package/dist/actions/index.mjs

@@ -1,6 +1,5 @@
 import { t as __exportAll } from "../chunk-DQk6qfdC.mjs";
-import { r as create_exports } from "../create-BuO6xt0v.mjs";
-import { c as update_exports, m as read_exports, n as aggregate_exports, o as delete_exports } from "../aggregate-BAi4Do-X.mjs";
+import { a as delete_exports, g as create_exports, p as read_exports, s as update_exports, t as aggregate_exports } from "../aggregate-BClp040M.mjs";
 
 //#region src/actions/index.ts
 var actions_exports = /* @__PURE__ */ __exportAll({

package/dist/{aggregate-BAi4Do-X.mjs → aggregate-BClp040M.mjs}

@@ -1,6 +1,58 @@
 import { t as __exportAll } from "./chunk-DQk6qfdC.mjs";
 import { i as createError, r as warn } from "./logger-D8ily-PP.mjs";
 
+//#region src/actions/create.ts
+var create_exports = /* @__PURE__ */ __exportAll({
+	create: () => create,
+	createDefault: () => createDefault,
+	createMany: () => createMany,
+	upsert: () => upsert
+});
+/**
+* Create single document
+*/
+async function create(Model, data, options = {}) {
+	const document = new Model(data);
+	await document.save({ session: options.session });
+	return document;
+}
+/**
+* Create multiple documents
+*/
+async function createMany(Model, dataArray, options = {}) {
+	return Model.insertMany(dataArray, {
+		session: options.session,
+		ordered: options.ordered !== false
+	});
+}
+/**
+* Create with defaults (useful for initialization)
+*/
+async function createDefault(Model, overrides = {}, options = {}) {
+	const defaults = {};
+	Model.schema.eachPath((path, schemaType) => {
+		const schemaOptions = schemaType.options;
+		if (schemaOptions.default !== void 0 && path !== "_id") defaults[path] = typeof schemaOptions.default === "function" ? schemaOptions.default() : schemaOptions.default;
+	});
+	return create(Model, {
+		...defaults,
+		...overrides
+	}, options);
+}
+/**
+* Upsert (create or update)
+*/
+async function upsert(Model, query, data, options = {}) {
+	return Model.findOneAndUpdate(query, { $setOnInsert: data }, {
+		upsert: true,
+		returnDocument: "after",
+		runValidators: true,
+		session: options.session,
+		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
+	});
+}
+
+//#endregion
 //#region src/actions/read.ts
 var read_exports = /* @__PURE__ */ __exportAll({
 	count: () => count,
@@ -154,7 +206,8 @@ async function update(Model, id, data, options = {}) {
 		returnDocument: "after",
 		runValidators: true,
 		session: options.session,
-		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
+		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {},
+		...options.arrayFilters ? { arrayFilters: options.arrayFilters } : {}
 	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? false);
 	if (!document) throw createError(404, "Document not found");
 	return document;
@@ -173,7 +226,8 @@ async function updateWithConstraints(Model, id, data, constraints = {}, options
 		returnDocument: "after",
 		runValidators: true,
 		session: options.session,
-		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
+		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {},
+		...options.arrayFilters ? { arrayFilters: options.arrayFilters } : {}
 	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? false);
 }
 /**
@@ -190,7 +244,11 @@ async function updateWithValidation(Model, id, data, validationOptions = {}, opt
 			data: document
 		};
 	}
-	const existing = await Model.findById(id).select(options.select || "").lean();
+	const findQuery = {
+		_id: id,
+		...options.query
+	};
+	const existing = await Model.findOne(findQuery).select(options.select || "").session(options.session ?? null).lean();
 	if (!existing) return {
 		success: false,
 		error: {
@@ -222,7 +280,8 @@ async function updateMany(Model, query, data, options = {}) {
 	const result = await Model.updateMany(query, data, {
 		runValidators: true,
 		session: options.session,
-		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
+		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {},
+		...options.arrayFilters ? { arrayFilters: options.arrayFilters } : {}
 	});
 	return {
 		matchedCount: result.matchedCount,
@@ -238,7 +297,8 @@ async function updateByQuery(Model, query, data, options = {}) {
 		returnDocument: "after",
 		runValidators: true,
 		session: options.session,
-		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
+		...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {},
+		...options.arrayFilters ? { arrayFilters: options.arrayFilters } : {}
 	}).select(options.select || "").populate(parsePopulate(options.populate)).lean(options.lean ?? false);
 	if (!document && options.throwOnNotFound !== false) throw createError(404, "Document not found");
 	return document;
@@ -282,7 +342,8 @@ async function deleteById(Model, id, options = {}) {
 	if (!await Model.findOneAndDelete(query).session(options.session ?? null)) throw createError(404, "Document not found");
 	return {
 		success: true,
-		message: "Deleted successfully"
+		message: "Deleted successfully",
+		id: String(id)
 	};
 }
 /**
@@ -299,10 +360,12 @@ async function deleteMany(Model, query, options = {}) {
 * Delete by query
 */
 async function deleteByQuery(Model, query, options = {}) {
-	if (!await Model.findOneAndDelete(query).session(options.session ?? null) && options.throwOnNotFound !== false) throw createError(404, "Document not found");
+	const document = await Model.findOneAndDelete(query).session(options.session ?? null);
+	if (!document && options.throwOnNotFound !== false) throw createError(404, "Document not found");
 	return {
 		success: true,
-		message: "Deleted successfully"
+		message: "Deleted successfully",
+		...document ? { id: String(document._id) } : {}
 	};
 }
 /**
@@ -319,7 +382,9 @@ async function softDelete(Model, id, options = {}) {
 	})) throw createError(404, "Document not found");
 	return {
 		success: true,
-		message: "Soft deleted successfully"
+		message: "Soft deleted successfully",
+		id: String(id),
+		soft: true
 	};
 }
 /**
@@ -336,7 +401,8 @@ async function restore(Model, id, options = {}) {
 	})) throw createError(404, "Document not found");
 	return {
 		success: true,
-		message: "Restored successfully"
+		message: "Restored successfully",
+		id: String(id)
 	};
 }
 
@@ -720,7 +786,9 @@ async function facet(Model, facets, options = {}) {
 * Get distinct values
 */
 async function distinct(Model, field, query = {}, options = {}) {
-	return Model.distinct(field, query).session(options.session ?? null);
+	const q = Model.distinct(field, query).session(options.session ?? null);
+	if (options.readPreference) q.read(options.readPreference);
+	return q;
 }
 /**
 * Calculate sum
@@ -764,4 +832,4 @@ async function minMax(Model, field, query = {}, options = {}) {
 }
 
 //#endregion
-export { deleteById as a, update_exports as c, getById as d, getByQuery as f, LookupBuilder as i, count as l, read_exports as m, aggregate_exports as n, delete_exports as o, getOrCreate as p, distinct as r, update as s, aggregate as t, exists as u };
+export { upsert as _, delete_exports as a, count as c, getByQuery as d, getOrCreate as f, create_exports as g, createMany as h, deleteById as i, exists as l, create as m, distinct as n, update as o, read_exports as p, LookupBuilder as r, update_exports as s, aggregate_exports as t, getById as u };

package/dist/{aggregate-D9x87vej.d.mts → aggregate-BkOG9qwr.d.mts}

@@ -1,4 +1,4 @@
-import { C as GroupResult, F as ObjectId, G as PopulateSpec, K as ReadPreferenceType, N as MinMaxResult, R as OperationOptions, St as LookupOptions, _ as DeleteResult, at as SortSpec, ct as UpdateManyResult, et as SelectSpec, i as AnyDocument, lt as UpdateOptions, p as CreateOptions, ut as UpdateWithValidationResult } from "./types-Bnwv9NV6.mjs";
+import { C as GroupResult, F as ObjectId, G as PopulateSpec, K as ReadPreferenceType, N as MinMaxResult, R as OperationOptions, St as LookupOptions, _ as DeleteResult, at as SortSpec, ct as UpdateManyResult, et as SelectSpec, i as AnyDocument, lt as UpdateOptions, p as CreateOptions, ut as UpdateWithValidationResult } from "./types-pVY0w1Pp.mjs";
 import { ClientSession, Model, PipelineStage } from "mongoose";
 
 //#region src/actions/create.d.ts
@@ -125,6 +125,7 @@ declare function updateWithValidation<TDoc = AnyDocument>(Model: Model<TDoc>, id
 declare function updateMany(Model: Model<unknown>, query: Record<string, unknown>, data: Record<string, unknown>, options?: {
   session?: ClientSession;
   updatePipeline?: boolean;
+  arrayFilters?: Record<string, unknown>[];
 }): Promise<UpdateManyResult>;
 /**
  * Update by query
@@ -246,6 +247,7 @@ declare function facet<TResult = Record<string, unknown[]>>(Model: Model<any>, f
  */
 declare function distinct<T = unknown>(Model: Model<any>, field: string, query?: Record<string, unknown>, options?: {
   session?: ClientSession;
+  readPreference?: string;
 }): Promise<T[]>;
 /**
  * Calculate sum

package/dist/ai/index.d.mts

@@ -1,4 +1,4 @@
-import { H as Plugin } from "../types-Bnwv9NV6.mjs";
+import { H as Plugin } from "../types-pVY0w1Pp.mjs";
 import { ClientSession, PipelineStage } from "mongoose";
 
 //#region src/ai/types.d.ts

package/dist/{cache-keys-C8Z9B5sw.mjs → cache-keys-CzFwVnLy.mjs}

@@ -119,15 +119,27 @@ function stableStringify(obj) {
 }
 /**
 * Generate cache key for getById operations
-* 
-* Format: {prefix}:id:{model}:{documentId}
-* 
+*
+* Includes select/populate/lean in the key so different query shapes
+* (e.g., plain vs populated, lean vs hydrated) never collide.
+*
+* Format: {prefix}:id:{model}:{documentId} (no options)
+* Format: {prefix}:id:{model}:{documentId}:{optionsHash} (with options)
+*
 * @example
 * byIdKey('mk', 'User', '507f1f77bcf86cd799439011')
 * // => 'mk:id:User:507f1f77bcf86cd799439011'
+* byIdKey('mk', 'User', '507f1f77bcf86cd799439011', { select: 'name email' })
+* // => 'mk:id:User:507f1f77bcf86cd799439011:a1b2c3d4'
 */
-function byIdKey(prefix, model, id) {
-	return `${prefix}:id:${model}:${id}`;
+function byIdKey(prefix, model, id, options) {
+	const base = `${prefix}:id:${model}:${id}`;
+	if (!options || options.select == null && options.populate == null && options.lean == null) return base;
+	return `${base}:${hashString(stableStringify({
+		s: options.select,
+		p: options.populate,
+		l: options.lean
+	}))}`;
 }
 /**
 * Generate cache key for single-document queries
@@ -138,8 +150,8 @@ function byIdKey(prefix, model, id) {
 * byQueryKey('mk', 'User', { email: 'john@example.com' })
 * // => 'mk:one:User:a1b2c3d4'
 */
-function byQueryKey(prefix, model, query, options) {
-	return `${prefix}:one:${model}:${hashString(stableStringify({
+function byQueryKey(prefix, model, version, query, options) {
+	return `${prefix}:one:${model}:${version}:${hashString(stableStringify({
 		q: query,
 		s: options?.select,
 		p: options?.populate
@@ -166,7 +178,14 @@ function listQueryKey(prefix, model, version, params) {
 		lm: params.limit,
 		af: params.after,
 		sl: params.select,
-		pp: params.populate
+		pp: params.populate,
+		sr: params.search,
+		md: params.mode,
+		ln: params.lean,
+		rp: params.readPreference,
+		hn: params.hint,
+		mt: params.maxTimeMS,
+		cs: params.countStrategy
 	}))}`;
 }
 /**
@@ -193,7 +212,7 @@ function modelPattern(prefix, model) {
 }
 /**
 * Generate pattern for clearing all list cache keys for a model
-* 
+*
 * Format: {prefix}:list:{model}:*
 */
 function listPattern(prefix, model) {

package/dist/{custom-id.plugin-Dc4Y3Eie.d.mts → custom-id.plugin-BJ3FSnzt.d.mts}

@@ -1,4 +1,4 @@
-import { F as ObjectId, G as PopulateSpec, H as Plugin, L as OffsetPaginationResult, M as Logger, Y as RepositoryInstance, at as SortSpec, c as CacheOptions, et as SelectSpec, ft as ValidationChainOptions, l as CacheStats, mt as ValidatorDefinition, nt as SoftDeleteOptions, q as RepositoryContext, u as CascadeOptions, x as FieldPreset } from "./types-Bnwv9NV6.mjs";
+import { F as ObjectId, G as PopulateSpec, H as Plugin, L as OffsetPaginationResult, M as Logger, Y as RepositoryInstance, at as SortSpec, c as CacheOptions, et as SelectSpec, ft as ValidationChainOptions, l as CacheStats, mt as ValidatorDefinition, nt as SoftDeleteOptions, q as RepositoryContext, u as CascadeOptions, x as FieldPreset } from "./types-pVY0w1Pp.mjs";
 import mongoose, { ClientSession } from "mongoose";
 
 //#region src/plugins/field-filter.plugin.d.ts
@@ -363,6 +363,23 @@ interface MongoOperationsMethods<TDoc> {
    * @returns Updated document
    */
   setMax(id: string | ObjectId, field: string, value: unknown, options?: Record<string, unknown>): Promise<TDoc>;
+  /**
+   * Atomic update with multiple MongoDB operators in a single call.
+   * Combines $inc, $set, $push, $pull, $addToSet, $unset, $setOnInsert, etc.
+   *
+   * @param id - Document ID
+   * @param operators - MongoDB update operators (e.g. { $inc: { views: 1 }, $set: { lastViewed: new Date() } })
+   * @param options - Operation options (session, arrayFilters, etc.)
+   * @returns Updated document
+   *
+   * @example
+   * await repo.atomicUpdate(postId, {
+   *   $inc: { reactionCount: -1 },
+   *   $set: { lastActiveAt: new Date() },
+   *   $push: { history: { action: 'unreact', at: new Date() } }
+   * });
+   */
+  atomicUpdate(id: string | ObjectId, operators: Record<string, Record<string, unknown>>, options?: Record<string, unknown>): Promise<TDoc>;
 }
 //#endregion
 //#region src/plugins/batch-operations.plugin.d.ts
@@ -401,6 +418,17 @@ declare function batchOperationsPlugin(): Plugin;
  * await repo.deleteMany({ status: 'archived' });
  * ```
  */
+/** Bulk write result */
+interface BulkWriteResult {
+  ok: number;
+  insertedCount: number;
+  upsertedCount: number;
+  matchedCount: number;
+  modifiedCount: number;
+  deletedCount: number;
+  insertedIds: Record<number, unknown>;
+  upsertedIds: Record<number, unknown>;
+}
 interface BatchOperationsMethods {
   /**
    * Update multiple documents matching the query
@@ -429,6 +457,26 @@ interface BatchOperationsMethods {
     acknowledged: boolean;
     deletedCount: number;
   }>;
+  /**
+   * Execute heterogeneous bulk write operations in a single database call.
+   * Supports insertOne, updateOne, updateMany, deleteOne, deleteMany, replaceOne.
+   *
+   * @param operations - Array of bulk write operations
+   * @param options - Options (session, ordered)
+   * @returns Bulk write result with counts per operation type
+   *
+   * @example
+   * const result = await repo.bulkWrite([
+   *   { insertOne: { document: { name: 'Item', price: 10 } } },
+   *   { updateOne: { filter: { _id: id }, update: { $inc: { views: 1 } } } },
+   *   { deleteOne: { filter: { _id: oldId } } },
+   * ]);
+   * console.log(result.insertedCount, result.modifiedCount, result.deletedCount);
+   */
+  bulkWrite(operations: Record<string, unknown>[], options?: {
+    session?: ClientSession;
+    ordered?: boolean;
+  }): Promise<BulkWriteResult>;
 }
 //#endregion
 //#region src/plugins/aggregate-helpers.plugin.d.ts
@@ -920,7 +968,7 @@ interface CustomIdOptions {
  * const startSeq = await getNextSequence('invoices', 5);
  * // If current was 10, returns 15 (you use 11, 12, 13, 14, 15)
  */
-declare function getNextSequence(counterKey: string, increment?: number): Promise<number>;
+declare function getNextSequence(counterKey: string, increment?: number, connection?: mongoose.Connection): Promise<number>;
 interface SequentialIdOptions {
   /** Prefix string (e.g., 'INV', 'ORD') */
   prefix: string;
@@ -1036,4 +1084,4 @@ declare function prefixedId(options: PrefixedIdOptions): IdGenerator;
  */
 declare function customIdPlugin(options: CustomIdOptions): Plugin;
 //#endregion
-export { subdocumentPlugin as A, requireField as B, observabilityPlugin as C, CacheMethods as D, cascadePlugin as E, MongoOperationsMethods as F, SoftDeleteMethods as G, validationChainPlugin as H, mongoOperationsPlugin as I, timestampPlugin as J, softDeletePlugin as K, autoInject as L, aggregateHelpersPlugin as M, BatchOperationsMethods as N, cachePlugin as O, batchOperationsPlugin as P, blockIf as R, OperationMetric as S, multiTenantPlugin as T, MethodRegistryRepository as U, uniqueField as V, methodRegistryPlugin as W, fieldFilterPlugin as Y, AuditTrailMethods as _, SequentialIdOptions as a, auditTrailPlugin as b, getNextSequence as c, ElasticSearchOptions as d, elasticSearchPlugin as f, AuditQueryResult as g, AuditQueryOptions as h, PrefixedIdOptions as i, AggregateHelpersMethods as j, SubdocumentMethods as k, prefixedId as l, AuditOperation as m, DateSequentialIdOptions as n, customIdPlugin as o, AuditEntry as p, auditLogPlugin as q, IdGenerator as r, dateSequentialId as s, CustomIdOptions as t, sequentialId as u, AuditTrailOptions as v, MultiTenantOptions as w, ObservabilityOptions as x, AuditTrailQuery as y, immutableField as z };
+export { subdocumentPlugin as A, immutableField as B, observabilityPlugin as C, CacheMethods as D, cascadePlugin as E, batchOperationsPlugin as F, methodRegistryPlugin as G, uniqueField as H, MongoOperationsMethods as I, auditLogPlugin as J, SoftDeleteMethods as K, mongoOperationsPlugin as L, aggregateHelpersPlugin as M, BatchOperationsMethods as N, cachePlugin as O, BulkWriteResult as P, autoInject as R, OperationMetric as S, multiTenantPlugin as T, validationChainPlugin as U, requireField as V, MethodRegistryRepository as W, fieldFilterPlugin as X, timestampPlugin as Y, AuditTrailMethods as _, SequentialIdOptions as a, auditTrailPlugin as b, getNextSequence as c, ElasticSearchOptions as d, elasticSearchPlugin as f, AuditQueryResult as g, AuditQueryOptions as h, PrefixedIdOptions as i, AggregateHelpersMethods as j, SubdocumentMethods as k, prefixedId as l, AuditOperation as m, DateSequentialIdOptions as n, customIdPlugin as o, AuditEntry as p, softDeletePlugin as q, IdGenerator as r, dateSequentialId as s, CustomIdOptions as t, sequentialId as u, AuditTrailOptions as v, MultiTenantOptions as w, ObservabilityOptions as x, AuditTrailQuery as y, blockIf as z };