@classytic/mongokit 3.0.0 → 3.0.2

package/dist/pagination/PaginationEngine.d.ts

@@ -1,5 +1,5 @@
 import { Model } from 'mongoose';
-import { A as AnyDocument, P as PaginationConfig, O as OffsetPaginationOptions, a as OffsetPaginationResult, K as KeysetPaginationOptions, b as KeysetPaginationResult, c as AggregatePaginationOptions, d as AggregatePaginationResult } from '../types-Nxhmi1aI.js';
+import { A as AnyDocument, P as PaginationConfig, O as OffsetPaginationOptions, a as OffsetPaginationResult, K as KeysetPaginationOptions, b as KeysetPaginationResult, c as AggregatePaginationOptions, d as AggregatePaginationResult } from '../types-B3dPUKjs.js';
 
 /**
  * Pagination Engine

package/dist/pagination/PaginationEngine.js

@@ -365,5 +365,3 @@ var PaginationEngine = class {
 };
 
 export { PaginationEngine };
-//# sourceMappingURL=PaginationEngine.js.map
-//# sourceMappingURL=PaginationEngine.js.map

package/dist/plugins/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FieldPreset, p as Plugin, L as Logger, B as SoftDeleteOptions, r as RepositoryInstance, y as ValidatorDefinition, z as ValidationChainOptions, R as RepositoryContext, Q as CacheOptions } from '../types-Nxhmi1aI.js';
+import { F as FieldPreset, r as Plugin, L as Logger, I as SoftDeleteOptions, t as RepositoryInstance, B as ValidatorDefinition, G as ValidationChainOptions, i as RepositoryContext, W as CacheOptions, _ as CascadeOptions } from '../types-B3dPUKjs.js';
 import 'mongoose';
 
 /**
@@ -272,4 +272,39 @@ declare function subdocumentPlugin(): Plugin;
  */
 declare function cachePlugin(options: CacheOptions): Plugin;
 
-export { type MethodRegistryRepository, aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, fieldFilterPlugin, immutableField, methodRegistryPlugin, mongoOperationsPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+/**
+ * Cascade Delete Plugin
+ * Automatically deletes related documents when a parent document is deleted
+ *
+ * @example
+ * ```typescript
+ * import mongoose from 'mongoose';
+ * import { Repository, cascadePlugin, methodRegistryPlugin } from '@classytic/mongokit';
+ *
+ * const productRepo = new Repository(Product, [
+ *   methodRegistryPlugin(),
+ *   cascadePlugin({
+ *     relations: [
+ *       { model: 'StockEntry', foreignKey: 'product' },
+ *       { model: 'StockMovement', foreignKey: 'product' },
+ *     ]
+ *   })
+ * ]);
+ *
+ * // When a product is deleted, all related StockEntry and StockMovement docs are also deleted
+ * await productRepo.delete(productId);
+ * ```
+ */
+
+/**
+ * Cascade delete plugin
+ *
+ * Deletes related documents after the parent document is deleted.
+ * Works with both hard delete and soft delete scenarios.
+ *
+ * @param options - Cascade configuration
+ * @returns Plugin
+ */
+declare function cascadePlugin(options: CascadeOptions): Plugin;
+
+export { type MethodRegistryRepository, aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, fieldFilterPlugin, immutableField, methodRegistryPlugin, mongoOperationsPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.js

@@ -1,3 +1,5 @@
+import mongoose from 'mongoose';
+
 // src/utils/field-selection.ts
 function getFieldsForUser(user, preset) {
   if (!preset) {
@@ -420,9 +422,16 @@ function batchOperationsPlugin() {
         const context = await _buildContext.call(this, "updateMany", { query, data, options });
         try {
           this.emit("before:updateMany", context);
+          if (Array.isArray(data) && options.updatePipeline !== true) {
+            throw createError(
+              400,
+              "Update pipelines (array updates) are disabled by default; pass `{ updatePipeline: true }` to explicitly allow pipeline-style updates."
+            );
+          }
           const result = await this.Model.updateMany(query, data, {
             runValidators: true,
-            session: options.session
+            session: options.session,
+            ...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
           }).exec();
           this.emit("after:updateMany", { context, result });
           return result;
@@ -851,7 +860,175 @@ function cachePlugin(options) {
     }
   };
 }
+function cascadePlugin(options) {
+  const { relations, parallel = true, logger } = options;
+  if (!relations || relations.length === 0) {
+    throw new Error("cascadePlugin requires at least one relation");
+  }
+  return {
+    name: "cascade",
+    apply(repo) {
+      repo.on("after:delete", async (payload) => {
+        const { context } = payload;
+        const deletedId = context.id;
+        if (!deletedId) {
+          logger?.warn?.("Cascade delete skipped: no document ID in context", {
+            model: context.model
+          });
+          return;
+        }
+        const isSoftDelete = context.softDeleted === true;
+        const cascadeDelete = async (relation) => {
+          const RelatedModel = mongoose.models[relation.model];
+          if (!RelatedModel) {
+            logger?.warn?.(`Cascade delete skipped: model '${relation.model}' not found`, {
+              parentModel: context.model,
+              parentId: String(deletedId)
+            });
+            return;
+          }
+          const query = { [relation.foreignKey]: deletedId };
+          try {
+            const shouldSoftDelete = relation.softDelete ?? isSoftDelete;
+            if (shouldSoftDelete) {
+              const updateResult = await RelatedModel.updateMany(
+                query,
+                {
+                  deletedAt: /* @__PURE__ */ new Date(),
+                  ...context.user ? { deletedBy: context.user._id || context.user.id } : {}
+                },
+                { session: context.session }
+              );
+              logger?.info?.(`Cascade soft-deleted ${updateResult.modifiedCount} documents`, {
+                parentModel: context.model,
+                parentId: String(deletedId),
+                relatedModel: relation.model,
+                foreignKey: relation.foreignKey,
+                count: updateResult.modifiedCount
+              });
+            } else {
+              const deleteResult = await RelatedModel.deleteMany(query, {
+                session: context.session
+              });
+              logger?.info?.(`Cascade deleted ${deleteResult.deletedCount} documents`, {
+                parentModel: context.model,
+                parentId: String(deletedId),
+                relatedModel: relation.model,
+                foreignKey: relation.foreignKey,
+                count: deleteResult.deletedCount
+              });
+            }
+          } catch (error) {
+            logger?.error?.(`Cascade delete failed for model '${relation.model}'`, {
+              parentModel: context.model,
+              parentId: String(deletedId),
+              relatedModel: relation.model,
+              foreignKey: relation.foreignKey,
+              error: error.message
+            });
+            throw error;
+          }
+        };
+        if (parallel) {
+          await Promise.all(relations.map(cascadeDelete));
+        } else {
+          for (const relation of relations) {
+            await cascadeDelete(relation);
+          }
+        }
+      });
+      repo.on("after:deleteMany", async (payload) => {
+        const { context, result } = payload;
+        const query = context.query;
+        if (!query || Object.keys(query).length === 0) {
+          logger?.warn?.("Cascade deleteMany skipped: empty query", {
+            model: context.model
+          });
+          return;
+        }
+        logger?.warn?.("Cascade deleteMany: use before:deleteMany hook for complete cascade support", {
+          model: context.model
+        });
+      });
+      repo.on("before:deleteMany", async (context) => {
+        const query = context.query;
+        if (!query || Object.keys(query).length === 0) {
+          return;
+        }
+        const docs = await repo.Model.find(query, { _id: 1 }).lean().session(context.session ?? null);
+        const ids = docs.map((doc) => doc._id);
+        context._cascadeIds = ids;
+      });
+      const originalAfterDeleteMany = repo._hooks.get("after:deleteMany") || [];
+      repo._hooks.set("after:deleteMany", [
+        ...originalAfterDeleteMany,
+        async (payload) => {
+          const { context } = payload;
+          const ids = context._cascadeIds;
+          if (!ids || ids.length === 0) {
+            return;
+          }
+          const isSoftDelete = context.softDeleted === true;
+          const cascadeDeleteMany = async (relation) => {
+            const RelatedModel = mongoose.models[relation.model];
+            if (!RelatedModel) {
+              logger?.warn?.(`Cascade deleteMany skipped: model '${relation.model}' not found`, {
+                parentModel: context.model
+              });
+              return;
+            }
+            const query = { [relation.foreignKey]: { $in: ids } };
+            const shouldSoftDelete = relation.softDelete ?? isSoftDelete;
+            try {
+              if (shouldSoftDelete) {
+                const updateResult = await RelatedModel.updateMany(
+                  query,
+                  {
+                    deletedAt: /* @__PURE__ */ new Date(),
+                    ...context.user ? { deletedBy: context.user._id || context.user.id } : {}
+                  },
+                  { session: context.session }
+                );
+                logger?.info?.(`Cascade soft-deleted ${updateResult.modifiedCount} documents (bulk)`, {
+                  parentModel: context.model,
+                  parentCount: ids.length,
+                  relatedModel: relation.model,
+                  foreignKey: relation.foreignKey,
+                  count: updateResult.modifiedCount
+                });
+              } else {
+                const deleteResult = await RelatedModel.deleteMany(query, {
+                  session: context.session
+                });
+                logger?.info?.(`Cascade deleted ${deleteResult.deletedCount} documents (bulk)`, {
+                  parentModel: context.model,
+                  parentCount: ids.length,
+                  relatedModel: relation.model,
+                  foreignKey: relation.foreignKey,
+                  count: deleteResult.deletedCount
+                });
+              }
+            } catch (error) {
+              logger?.error?.(`Cascade deleteMany failed for model '${relation.model}'`, {
+                parentModel: context.model,
+                relatedModel: relation.model,
+                foreignKey: relation.foreignKey,
+                error: error.message
+              });
+              throw error;
+            }
+          };
+          if (parallel) {
+            await Promise.all(relations.map(cascadeDeleteMany));
+          } else {
+            for (const relation of relations) {
+              await cascadeDeleteMany(relation);
+            }
+          }
+        }
+      ]);
+    }
+  };
+}
 
-export { aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, fieldFilterPlugin, immutableField, methodRegistryPlugin, mongoOperationsPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+export { aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, fieldFilterPlugin, immutableField, methodRegistryPlugin, mongoOperationsPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/{types-Nxhmi1aI.d.ts → types-B3dPUKjs.d.ts}

@@ -24,6 +24,13 @@ type PopulateSpec = string | string[] | PopulateOptions | PopulateOptions[];
 type SelectSpec = string | string[] | Record<string, 0 | 1>;
 /** Filter query type for MongoDB queries (compatible with Mongoose 8 & 9) */
 type FilterQuery<T> = Record<string, unknown>;
+/** Hook execution mode */
+type HookMode = 'sync' | 'async';
+/** Repository options */
+interface RepositoryOptions {
+    /** Whether repository event hooks are awaited */
+    hooks?: HookMode;
+}
 /** Pagination configuration */
 interface PaginationConfig {
     /** Default number of documents per page (default: 10) */
@@ -253,12 +260,13 @@ interface RepositoryInstance {
     use(plugin: PluginType): this;
     on(event: string, listener: (data: any) => void | Promise<void>): this;
     emit(event: string, data: unknown): void;
+    emitAsync(event: string, data: unknown): Promise<void>;
     registerMethod?(name: string, fn: Function): void;
     hasMethod?(name: string): boolean;
     [key: string]: unknown;
 }
 /** Repository event names */
-type RepositoryEvent = 'before:create' | 'after:create' | 'error:create' | 'before:createMany' | 'after:createMany' | 'error:createMany' | 'before:update' | 'after:update' | 'error:update' | 'before:updateMany' | 'after:updateMany' | 'error:updateMany' | 'before:delete' | 'after:delete' | 'error:delete' | 'before:deleteMany' | 'after:deleteMany' | 'error:deleteMany' | 'before:getById' | 'after:getById' | 'before:getByQuery' | 'after:getByQuery' | 'before:getAll' | 'after:getAll' | 'before:aggregatePaginate' | 'method:registered';
+type RepositoryEvent = 'before:create' | 'after:create' | 'error:create' | 'before:createMany' | 'after:createMany' | 'error:createMany' | 'before:update' | 'after:update' | 'error:update' | 'before:updateMany' | 'after:updateMany' | 'error:updateMany' | 'before:delete' | 'after:delete' | 'error:delete' | 'before:deleteMany' | 'after:deleteMany' | 'error:deleteMany' | 'before:getById' | 'after:getById' | 'before:getByQuery' | 'after:getByQuery' | 'before:getAll' | 'after:getAll' | 'before:aggregatePaginate' | 'method:registered' | 'error:hook';
 /** Event payload */
 interface EventPayload {
     context: RepositoryContext;
@@ -498,6 +506,24 @@ interface CacheStats {
     sets: number;
     invalidations: number;
 }
+/** Cascade relation definition */
+interface CascadeRelation {
+    /** Model name to cascade delete to */
+    model: string;
+    /** Foreign key field in the related model that references the deleted document */
+    foreignKey: string;
+    /** Whether to use soft delete if available (default: follows parent behavior) */
+    softDelete?: boolean;
+}
+/** Cascade delete plugin options */
+interface CascadeOptions {
+    /** Relations to cascade delete */
+    relations: CascadeRelation[];
+    /** Run cascade deletes in parallel (default: true) */
+    parallel?: boolean;
+    /** Logger for cascade operations */
+    logger?: Logger;
+}
 /** HTTP Error with status code */
 interface HttpError extends Error {
     status: number;
@@ -507,4 +533,4 @@ interface HttpError extends Error {
     }>;
 }
 
-export type { AnyDocument as A, SoftDeleteOptions as B, CreateOptions as C, DeleteResult as D, EventPayload as E, FieldPreset as F, LookupOptions as G, HttpError as H, GroupResult as I, JsonSchema as J, KeysetPaginationOptions as K, Logger as L, MinMaxResult as M, CacheAdapter as N, OffsetPaginationOptions as O, PaginationConfig as P, CacheOptions as Q, RepositoryContext as R, SelectSpec as S, CacheOperationOptions as T, UpdateOptions as U, ValidationResult as V, CacheStats as W, OffsetPaginationResult as a, KeysetPaginationResult as b, AggregatePaginationOptions as c, AggregatePaginationResult as d, PluginType as e, PopulateSpec as f, SortSpec as g, ObjectId as h, AnyModel as i, SortDirection as j, PaginationResult as k, OperationOptions as l, UpdateManyResult as m, UpdateWithValidationResult as n, UserContext as o, Plugin as p, PluginFunction as q, RepositoryInstance as r, RepositoryEvent as s, ParsedQuery as t, FieldRules as u, SchemaBuilderOptions as v, CrudSchemas as w, DecodedCursor as x, ValidatorDefinition as y, ValidationChainOptions as z };
+export type { AnyDocument as A, ValidatorDefinition as B, CreateOptions as C, DeleteResult as D, EventPayload as E, FieldPreset as F, ValidationChainOptions as G, HttpError as H, SoftDeleteOptions as I, JsonSchema as J, KeysetPaginationOptions as K, Logger as L, LookupOptions as M, GroupResult as N, OffsetPaginationOptions as O, PaginationConfig as P, MinMaxResult as Q, RepositoryOptions as R, SelectSpec as S, CacheAdapter as T, UpdateOptions as U, ValidationResult as V, CacheOptions as W, CacheOperationOptions as X, CacheStats as Y, CascadeRelation as Z, CascadeOptions as _, OffsetPaginationResult as a, KeysetPaginationResult as b, AggregatePaginationOptions as c, AggregatePaginationResult as d, PluginType as e, ObjectId as f, PopulateSpec as g, SortSpec as h, RepositoryContext as i, AnyModel as j, SortDirection as k, HookMode as l, PaginationResult as m, OperationOptions as n, UpdateManyResult as o, UpdateWithValidationResult as p, UserContext as q, Plugin as r, PluginFunction as s, RepositoryInstance as t, RepositoryEvent as u, ParsedQuery as v, FieldRules as w, SchemaBuilderOptions as x, CrudSchemas as y, DecodedCursor as z };

package/dist/utils/index.d.ts

@@ -1,5 +1,5 @@
-export { b as createError, c as createFieldPreset, d as createMemoryCache, f as filterResponseData, g as getFieldsForUser, a as getMongooseProjection } from '../memory-cache-DG2oSSbx.js';
-import { t as ParsedQuery, v as SchemaBuilderOptions, w as CrudSchemas, V as ValidationResult, S as SelectSpec, f as PopulateSpec, g as SortSpec } from '../types-Nxhmi1aI.js';
+export { b as createError, c as createFieldPreset, d as createMemoryCache, f as filterResponseData, g as getFieldsForUser, a as getMongooseProjection } from '../memory-cache-Bn_-Kk-0.js';
+import { v as ParsedQuery, x as SchemaBuilderOptions, y as CrudSchemas, V as ValidationResult, S as SelectSpec, g as PopulateSpec, h as SortSpec } from '../types-B3dPUKjs.js';
 import mongoose__default, { Schema } from 'mongoose';
 
 /**

package/dist/utils/index.js

@@ -639,5 +639,3 @@ function listPattern(prefix, model) {
 }
 
 export { buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, byIdKey, byQueryKey, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getImmutableFields, getMongooseProjection, getSystemManagedFields, isFieldUpdateAllowed, listPattern, listQueryKey, modelPattern, queryParser_default as queryParser, validateUpdateBody, versionKey };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Production-grade MongoDB repositories with zero dependencies - smart pagination, events, and plugins",
   "type": "module",
   "main": "./dist/index.js",
@@ -91,6 +91,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^3.2.4",
+    "mongodb-memory-server": "^10.2.3",
     "mongoose": "^9.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",

package/dist/actions/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/actions/create.ts","../../src/actions/read.ts","../../src/utils/error.ts","../../src/actions/update.ts","../../src/actions/delete.ts","../../src/actions/aggregate.ts"],"names":["parsePopulate"],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Create Actions\r\n * Pure functions for document creation\r\n */\r\n\r\nimport type { Model, ClientSession, SchemaType } from 'mongoose';\r\nimport type { CreateOptions, AnyDocument } from '../types.js';\r\n\r\n/**\r\n * Create single document\r\n */\r\nexport async function create<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  data: Record<string, unknown>,\r\n  options: CreateOptions = {}\r\n): Promise<TDoc> {\r\n  const document = new Model(data);\r\n  await document.save({ session: options.session });\r\n  return document as TDoc;\r\n}\r\n\r\n/**\r\n * Create multiple documents\r\n */\r\nexport async function createMany<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  dataArray: Record<string, unknown>[],\r\n  options: CreateOptions = {}\r\n): Promise<TDoc[]> {\r\n  return Model.insertMany(dataArray, {\r\n    session: options.session,\r\n    ordered: options.ordered !== false,\r\n  }) as Promise<TDoc[]>;\r\n}\r\n\r\n/**\r\n * Create with defaults (useful for initialization)\r\n */\r\nexport async function createDefault<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  overrides: Record<string, unknown> = {},\r\n  options: CreateOptions = {}\r\n): Promise<TDoc> {\r\n  const defaults: Record<string, unknown> = {};\r\n\r\n  // Extract defaults from schema\r\n  Model.schema.eachPath((path: string, schemaType: SchemaType) => {\r\n    const schemaOptions = schemaType.options as { default?: unknown };\r\n    if (schemaOptions.default !== undefined && path !== '_id') {\r\n      defaults[path] = typeof schemaOptions.default === 'function'\r\n        ? schemaOptions.default()\r\n        : schemaOptions.default;\r\n    }\r\n  });\r\n\r\n  return create(Model, { ...defaults, ...overrides }, options);\r\n}\r\n\r\n/**\r\n * Upsert (create or update)\r\n */\r\nexport async function upsert<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  query: Record<string, unknown>,\r\n  data: Record<string, unknown>,\r\n  options: { session?: ClientSession; updatePipeline?: boolean } = {}\r\n): Promise<TDoc | null> {\r\n  return Model.findOneAndUpdate(\r\n    query,\r\n    { $setOnInsert: data },\r\n    {\r\n      upsert: true,\r\n      new: true,\r\n      runValidators: true,\r\n      session: options.session,\r\n      ...(options.updatePipeline !== undefined ? { updatePipeline: options.updatePipeline } : {}),\r\n    }\r\n  );\r\n}\r\n","/**\r\n * Read Actions\r\n * Pure functions for document retrieval\r\n */\r\n\r\nimport type { Model, ClientSession, PopulateOptions } from 'mongoose';\r\nimport { createError } from '../utils/error.js';\r\nimport type { AnyDocument, SelectSpec, PopulateSpec, SortSpec, OperationOptions } from '../types.js';\r\n\r\n/**\r\n * Parse populate specification into consistent format\r\n */\r\nfunction parsePopulate(populate: PopulateSpec | undefined): (string | PopulateOptions)[] {\r\n  if (!populate) return [];\r\n  if (typeof populate === 'string') {\r\n    return populate.split(',').map(p => p.trim());\r\n  }\r\n  if (Array.isArray(populate)) {\r\n    return populate.map(p => typeof p === 'string' ? p.trim() : p);\r\n  }\r\n  return [populate];\r\n}\r\n\r\n/**\r\n * Get document by ID\r\n *\r\n * @param Model - Mongoose model\r\n * @param id - Document ID\r\n * @param options - Query options\r\n * @returns Document or null\r\n * @throws Error if document not found and throwOnNotFound is true\r\n */\r\nexport async function getById<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  id: string,\r\n  options: OperationOptions = {}\r\n): Promise<TDoc | null> {\r\n  // If additional query filters are provided (e.g., soft delete filter), use findOne\r\n  const query = options.query\r\n    ? Model.findOne({ _id: id, ...options.query })\r\n    : Model.findById(id);\r\n\r\n  if (options.select) query.select(options.select);\r\n  if (options.populate) query.populate(parsePopulate(options.populate));\r\n  if (options.lean) query.lean();\r\n  if (options.session) query.session(options.session);\r\n\r\n  const document = await query.exec();\r\n  if (!document && options.throwOnNotFound !== false) {\r\n    throw createError(404, 'Document not found');\r\n  }\r\n\r\n  return document;\r\n}\r\n\r\n/**\r\n * Get document by query\r\n *\r\n * @param Model - Mongoose model\r\n * @param query - MongoDB query\r\n * @param options - Query options\r\n * @returns Document or null\r\n * @throws Error if document not found and throwOnNotFound is true\r\n */\r\nexport async function getByQuery<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  query: Record<string, unknown>,\r\n  options: OperationOptions = {}\r\n): Promise<TDoc | null> {\r\n  const mongoQuery = Model.findOne(query);\r\n\r\n  if (options.select) mongoQuery.select(options.select);\r\n  if (options.populate) mongoQuery.populate(parsePopulate(options.populate));\r\n  if (options.lean) mongoQuery.lean();\r\n  if (options.session) mongoQuery.session(options.session);\r\n\r\n  const document = await mongoQuery.exec();\r\n  if (!document && options.throwOnNotFound !== false) {\r\n    throw createError(404, 'Document not found');\r\n  }\r\n\r\n  return document;\r\n}\r\n\r\n/**\r\n * Get document by query without throwing (returns null if not found)\r\n */\r\nexport async function tryGetByQuery<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  query: Record<string, unknown>,\r\n  options: Omit<OperationOptions, 'throwOnNotFound'> = {}\r\n): Promise<TDoc | null> {\r\n  return getByQuery(Model, query, { ...options, throwOnNotFound: false });\r\n}\r\n\r\n/**\r\n * Get all documents (basic query without pagination)\r\n * For pagination, use Repository.paginate() or Repository.stream()\r\n */\r\nexport async function getAll<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  query: Record<string, unknown> = {},\r\n  options: {\r\n    select?: SelectSpec;\r\n    populate?: PopulateSpec;\r\n    sort?: SortSpec;\r\n    limit?: number;\r\n    skip?: number;\r\n    lean?: boolean;\r\n    session?: ClientSession;\r\n  } = {}\r\n): Promise<TDoc[]> {\r\n  let mongoQuery = Model.find(query);\r\n\r\n  if (options.select) mongoQuery = mongoQuery.select(options.select);\r\n  if (options.populate) mongoQuery = mongoQuery.populate(parsePopulate(options.populate));\r\n  if (options.sort) mongoQuery = mongoQuery.sort(options.sort);\r\n  if (options.limit) mongoQuery = mongoQuery.limit(options.limit);\r\n  if (options.skip) mongoQuery = mongoQuery.skip(options.skip);\r\n\r\n  mongoQuery = mongoQuery.lean(options.lean !== false);\r\n  if (options.session) mongoQuery = mongoQuery.session(options.session);\r\n\r\n  return mongoQuery.exec() as Promise<TDoc[]>;\r\n}\r\n\r\n/**\r\n * Get or create document (upsert)\r\n */\r\nexport async function getOrCreate<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  query: Record<string, unknown>,\r\n  createData: Record<string, unknown>,\r\n  options: { session?: ClientSession; updatePipeline?: boolean } = {}\r\n): Promise<TDoc | null> {\r\n  return Model.findOneAndUpdate(\r\n    query,\r\n    { $setOnInsert: createData },\r\n    {\r\n      upsert: true,\r\n      new: true,\r\n      runValidators: true,\r\n      session: options.session,\r\n      ...(options.updatePipeline !== undefined ? { updatePipeline: options.updatePipeline } : {}),\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Count documents matching query\r\n */\r\nexport async function count(\r\n  Model: Model<any>,\r\n  query: Record<string, unknown> = {},\r\n  options: { session?: ClientSession } = {}\r\n): Promise<number> {\r\n  return Model.countDocuments(query).session(options.session ?? null);\r\n}\r\n\r\n/**\r\n * Check if document exists\r\n */\r\nexport async function exists(\r\n  Model: Model<any>,\r\n  query: Record<string, unknown>,\r\n  options: { session?: ClientSession } = {}\r\n): Promise<{ _id: unknown } | null> {\r\n  return Model.exists(query).session(options.session ?? null);\r\n}\r\n","/**\r\n * Error Utilities\r\n * \r\n * HTTP-compatible error creation for repository operations\r\n */\r\n\r\nimport type { HttpError } from '../types.js';\r\n\r\n/**\r\n * Creates an error with HTTP status code\r\n *\r\n * @param status - HTTP status code\r\n * @param message - Error message\r\n * @returns Error with status property\r\n * \r\n * @example\r\n * throw createError(404, 'Document not found');\r\n * throw createError(400, 'Invalid input');\r\n * throw createError(403, 'Access denied');\r\n */\r\nexport function createError(status: number, message: string): HttpError {\r\n  const error = new Error(message) as HttpError;\r\n  error.status = status;\r\n  return error;\r\n}\r\n","/**\r\n * Update Actions\r\n * Pure functions for document updates with optimizations\r\n */\r\n\r\nimport type { Model, ClientSession, PopulateOptions } from 'mongoose';\r\nimport { createError } from '../utils/error.js';\r\nimport type { AnyDocument, UpdateOptions, UpdateManyResult, UpdateWithValidationResult } from '../types.js';\r\n\r\n/**\r\n * Parse populate specification into consistent format\r\n */\r\nfunction parsePopulate(populate: unknown): (string | PopulateOptions)[] {\r\n  if (!populate) return [];\r\n  if (typeof populate === 'string') {\r\n    return populate.split(',').map(p => p.trim());\r\n  }\r\n  if (Array.isArray(populate)) {\r\n    return populate.map(p => typeof p === 'string' ? p.trim() : p as PopulateOptions);\r\n  }\r\n  return [populate as PopulateOptions];\r\n}\r\n\r\n/**\r\n * Update by ID\r\n */\r\nexport async function update<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  id: string,\r\n  data: Record<string, unknown>,\r\n  options: UpdateOptions = {}\r\n): Promise<TDoc> {\r\n  const document = await Model.findByIdAndUpdate(id, data, {\r\n    new: true,\r\n    runValidators: true,\r\n    session: options.session,\r\n    ...(options.updatePipeline !== undefined ? { updatePipeline: options.updatePipeline } : {}),\r\n  })\r\n    .select(options.select || '')\r\n    .populate(parsePopulate(options.populate))\r\n    .lean(options.lean ?? false);\r\n\r\n  if (!document) {\r\n    throw createError(404, 'Document not found');\r\n  }\r\n\r\n  return document as TDoc;\r\n}\r\n\r\n/**\r\n * Update with query constraints (optimized)\r\n * Returns null if constraints not met (not an error)\r\n */\r\nexport async function updateWithConstraints<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  id: string,\r\n  data: Record<string, unknown>,\r\n  constraints: Record<string, unknown> = {},\r\n  options: UpdateOptions = {}\r\n): Promise<TDoc | null> {\r\n  const query = { _id: id, ...constraints };\r\n\r\n  const document = await Model.findOneAndUpdate(query, data, {\r\n    new: true,\r\n    runValidators: true,\r\n    session: options.session,\r\n    ...(options.updatePipeline !== undefined ? { updatePipeline: options.updatePipeline } : {}),\r\n  })\r\n    .select(options.select || '')\r\n    .populate(parsePopulate(options.populate))\r\n    .lean(options.lean ?? false);\r\n\r\n  return document as TDoc | null;\r\n}\r\n\r\n/**\r\n * Validation options for smart update\r\n */\r\ninterface ValidationOptions {\r\n  buildConstraints?: (data: Record<string, unknown>) => Record<string, unknown>;\r\n  validateUpdate?: (\r\n    existing: Record<string, unknown>,\r\n    data: Record<string, unknown>\r\n  ) => { valid: boolean; message?: string; violations?: Array<{ field: string; reason: string }> };\r\n}\r\n\r\n/**\r\n * Update with validation (smart optimization)\r\n * 1-query on success, 2-queries for detailed errors\r\n */\r\nexport async function updateWithValidation<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  id: string,\r\n  data: Record<string, unknown>,\r\n  validationOptions: ValidationOptions = {},\r\n  options: UpdateOptions = {}\r\n): Promise<UpdateWithValidationResult<TDoc>> {\r\n  const { buildConstraints, validateUpdate } = validationOptions;\r\n\r\n  // Try optimized update with constraints\r\n  if (buildConstraints) {\r\n    const constraints = buildConstraints(data);\r\n    const document = await updateWithConstraints(Model, id, data, constraints, options);\r\n\r\n    if (document) {\r\n      return { success: true, data: document };\r\n    }\r\n  }\r\n\r\n  // Fetch for validation\r\n  const existing = await Model.findById(id).select(options.select || '').lean();\r\n\r\n  if (!existing) {\r\n    return {\r\n      success: false,\r\n      error: {\r\n        code: 404,\r\n        message: 'Document not found',\r\n      },\r\n    };\r\n  }\r\n\r\n  // Run custom validation\r\n  if (validateUpdate) {\r\n    const validation = validateUpdate(existing as Record<string, unknown>, data);\r\n    if (!validation.valid) {\r\n      return {\r\n        success: false,\r\n        error: {\r\n          code: 403,\r\n          message: validation.message || 'Update not allowed',\r\n          violations: validation.violations,\r\n        },\r\n      };\r\n    }\r\n  }\r\n\r\n  // Validation passed - perform update\r\n  const updated = await update(Model, id, data, options);\r\n  return { success: true, data: updated };\r\n}\r\n\r\n/**\r\n * Update many documents\r\n */\r\nexport async function updateMany(\r\n  Model: Model<unknown>,\r\n  query: Record<string, unknown>,\r\n  data: Record<string, unknown>,\r\n  options: { session?: ClientSession; updatePipeline?: boolean } = {}\r\n): Promise<UpdateManyResult> {\r\n  const result = await Model.updateMany(query, data, {\r\n    runValidators: true,\r\n    session: options.session,\r\n    ...(options.updatePipeline !== undefined ? { updatePipeline: options.updatePipeline } : {}),\r\n  });\r\n\r\n  return {\r\n    matchedCount: result.matchedCount,\r\n    modifiedCount: result.modifiedCount,\r\n  };\r\n}\r\n\r\n/**\r\n * Update by query\r\n */\r\nexport async function updateByQuery<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  query: Record<string, unknown>,\r\n  data: Record<string, unknown>,\r\n  options: UpdateOptions = {}\r\n): Promise<TDoc | null> {\r\n  const document = await Model.findOneAndUpdate(query, data, {\r\n    new: true,\r\n    runValidators: true,\r\n    session: options.session,\r\n    ...(options.updatePipeline !== undefined ? { updatePipeline: options.updatePipeline } : {}),\r\n  })\r\n    .select(options.select || '')\r\n    .populate(parsePopulate(options.populate))\r\n    .lean(options.lean ?? false);\r\n\r\n  if (!document && options.throwOnNotFound !== false) {\r\n    throw createError(404, 'Document not found');\r\n  }\r\n\r\n  return document as TDoc | null;\r\n}\r\n\r\n/**\r\n * Increment field\r\n */\r\nexport async function increment<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  id: string,\r\n  field: string,\r\n  value: number = 1,\r\n  options: UpdateOptions = {}\r\n): Promise<TDoc> {\r\n  return update(Model, id, { $inc: { [field]: value } }, options);\r\n}\r\n\r\n/**\r\n * Push to array\r\n */\r\nexport async function pushToArray<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  id: string,\r\n  field: string,\r\n  value: unknown,\r\n  options: UpdateOptions = {}\r\n): Promise<TDoc> {\r\n  return update(Model, id, { $push: { [field]: value } }, options);\r\n}\r\n\r\n/**\r\n * Pull from array\r\n */\r\nexport async function pullFromArray<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  id: string,\r\n  field: string,\r\n  value: unknown,\r\n  options: UpdateOptions = {}\r\n): Promise<TDoc> {\r\n  return update(Model, id, { $pull: { [field]: value } }, options);\r\n}\r\n","/**\r\n * Delete Actions\r\n * Pure functions for document deletion\r\n */\r\n\r\nimport type { Model, ClientSession } from 'mongoose';\r\nimport { createError } from '../utils/error.js';\r\nimport type { DeleteResult, AnyDocument } from '../types.js';\r\n\r\n/**\r\n * Delete by ID\r\n */\r\nexport async function deleteById(\r\n  Model: Model<any>,\r\n  id: string,\r\n  options: { session?: ClientSession } = {}\r\n): Promise<DeleteResult> {\r\n  const document = await Model.findByIdAndDelete(id).session(options.session ?? null);\r\n\r\n  if (!document) {\r\n    throw createError(404, 'Document not found');\r\n  }\r\n\r\n  return { success: true, message: 'Deleted successfully' };\r\n}\r\n\r\n/**\r\n * Delete many documents\r\n */\r\nexport async function deleteMany(\r\n  Model: Model<any>,\r\n  query: Record<string, unknown>,\r\n  options: { session?: ClientSession } = {}\r\n): Promise<DeleteResult> {\r\n  const result = await Model.deleteMany(query).session(options.session ?? null);\r\n\r\n  return {\r\n    success: true,\r\n    count: result.deletedCount,\r\n    message: 'Deleted successfully',\r\n  };\r\n}\r\n\r\n/**\r\n * Delete by query\r\n */\r\nexport async function deleteByQuery(\r\n  Model: Model<any>,\r\n  query: Record<string, unknown>,\r\n  options: { session?: ClientSession; throwOnNotFound?: boolean } = {}\r\n): Promise<DeleteResult> {\r\n  const document = await Model.findOneAndDelete(query).session(options.session ?? null);\r\n\r\n  if (!document && options.throwOnNotFound !== false) {\r\n    throw createError(404, 'Document not found');\r\n  }\r\n\r\n  return { success: true, message: 'Deleted successfully' };\r\n}\r\n\r\n/**\r\n * Soft delete (set deleted flag)\r\n */\r\nexport async function softDelete<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  id: string,\r\n  options: { session?: ClientSession; userId?: string } = {}\r\n): Promise<DeleteResult> {\r\n  const document = await Model.findByIdAndUpdate(\r\n    id,\r\n    {\r\n      deleted: true,\r\n      deletedAt: new Date(),\r\n      deletedBy: options.userId,\r\n    },\r\n    { new: true, session: options.session }\r\n  );\r\n\r\n  if (!document) {\r\n    throw createError(404, 'Document not found');\r\n  }\r\n\r\n  return { success: true, message: 'Soft deleted successfully' };\r\n}\r\n\r\n/**\r\n * Restore soft deleted document\r\n */\r\nexport async function restore<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  id: string,\r\n  options: { session?: ClientSession } = {}\r\n): Promise<DeleteResult> {\r\n  const document = await Model.findByIdAndUpdate(\r\n    id,\r\n    {\r\n      deleted: false,\r\n      deletedAt: null,\r\n      deletedBy: null,\r\n    },\r\n    { new: true, session: options.session }\r\n  );\r\n\r\n  if (!document) {\r\n    throw createError(404, 'Document not found');\r\n  }\r\n\r\n  return { success: true, message: 'Restored successfully' };\r\n}\r\n","/**\r\n * Aggregate Actions\r\n * MongoDB aggregation pipeline operations\r\n */\r\n\r\nimport type { Model, ClientSession, PipelineStage } from 'mongoose';\r\nimport type { AnyDocument, LookupOptions, GroupResult, MinMaxResult } from '../types.js';\r\n\r\n/**\r\n * Execute aggregation pipeline\r\n */\r\nexport async function aggregate<TResult = unknown>(\r\n  Model: Model<any>,\r\n  pipeline: PipelineStage[],\r\n  options: { session?: ClientSession } = {}\r\n): Promise<TResult[]> {\r\n  const aggregation = Model.aggregate(pipeline);\r\n\r\n  if (options.session) {\r\n    aggregation.session(options.session);\r\n  }\r\n\r\n  return aggregation.exec() as Promise<TResult[]>;\r\n}\r\n\r\n/**\r\n * Aggregate with pagination using native MongoDB $facet\r\n * WARNING: $facet results must be <16MB. For larger results (limit >1000),\r\n * consider using Repository.aggregatePaginate() or splitting into separate queries.\r\n */\r\nexport async function aggregatePaginate<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  pipeline: PipelineStage[],\r\n  options: { page?: number; limit?: number; session?: ClientSession } = {}\r\n): Promise<{\r\n  docs: TDoc[];\r\n  total: number;\r\n  page: number;\r\n  limit: number;\r\n  pages: number;\r\n  hasNext: boolean;\r\n  hasPrev: boolean;\r\n}> {\r\n  const page = parseInt(String(options.page || 1), 10);\r\n  const limit = parseInt(String(options.limit || 10), 10);\r\n  const skip = (page - 1) * limit;\r\n\r\n  // 16MB MongoDB document size limit safety check\r\n  const SAFE_LIMIT = 1000;\r\n  if (limit > SAFE_LIMIT) {\r\n    console.warn(\r\n      `[mongokit] Large aggregation limit (${limit}). $facet results must be <16MB. ` +\r\n      `Consider using Repository.aggregatePaginate() for safer handling of large datasets.`\r\n    );\r\n  }\r\n\r\n  const facetPipeline: PipelineStage[] = [\r\n    ...pipeline,\r\n    {\r\n      $facet: {\r\n        docs: [{ $skip: skip }, { $limit: limit }],\r\n        total: [{ $count: 'count' }],\r\n      },\r\n    },\r\n  ];\r\n\r\n  const aggregation = Model.aggregate(facetPipeline);\r\n  if (options.session) {\r\n    aggregation.session(options.session);\r\n  }\r\n\r\n  const [result] = await aggregation.exec() as [{ docs: TDoc[]; total: { count: number }[] }];\r\n  const docs = result.docs || [];\r\n  const total = result.total[0]?.count || 0;\r\n  const pages = Math.ceil(total / limit);\r\n\r\n  return {\r\n    docs,\r\n    total,\r\n    page,\r\n    limit,\r\n    pages,\r\n    hasNext: page < pages,\r\n    hasPrev: page > 1,\r\n  };\r\n}\r\n\r\n/**\r\n * Group documents by field value\r\n */\r\nexport async function groupBy(\r\n  Model: Model<any>,\r\n  field: string,\r\n  options: { limit?: number; session?: ClientSession } = {}\r\n): Promise<GroupResult[]> {\r\n  const pipeline: PipelineStage[] = [\r\n    { $group: { _id: `$${field}`, count: { $sum: 1 } } },\r\n    { $sort: { count: -1 } },\r\n  ];\r\n\r\n  if (options.limit) {\r\n    pipeline.push({ $limit: options.limit });\r\n  }\r\n\r\n  return aggregate(Model, pipeline, options);\r\n}\r\n\r\n/**\r\n * Count by field values\r\n */\r\nexport async function countBy(\r\n  Model: Model<any>,\r\n  field: string,\r\n  query: Record<string, unknown> = {},\r\n  options: { session?: ClientSession } = {}\r\n): Promise<GroupResult[]> {\r\n  const pipeline: PipelineStage[] = [];\r\n\r\n  if (Object.keys(query).length > 0) {\r\n    pipeline.push({ $match: query });\r\n  }\r\n\r\n  pipeline.push(\r\n    { $group: { _id: `$${field}`, count: { $sum: 1 } } },\r\n    { $sort: { count: -1 } }\r\n  );\r\n\r\n  return aggregate(Model, pipeline, options);\r\n}\r\n\r\n/**\r\n * Lookup (join) with another collection\r\n */\r\nexport async function lookup<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  lookupOptions: LookupOptions\r\n): Promise<TDoc[]> {\r\n  const { from, localField, foreignField, as, pipeline = [], query = {}, options = {} } = lookupOptions;\r\n\r\n  const aggPipeline: PipelineStage[] = [];\r\n\r\n  if (Object.keys(query).length > 0) {\r\n    aggPipeline.push({ $match: query });\r\n  }\r\n\r\n  aggPipeline.push({\r\n    $lookup: {\r\n      from,\r\n      localField,\r\n      foreignField,\r\n      as,\r\n      ...(pipeline.length > 0 ? { pipeline: pipeline as any } : {}),\r\n    },\r\n  } as any);\r\n\r\n  return aggregate(Model, aggPipeline, options);\r\n}\r\n\r\n/**\r\n * Unwind array field\r\n */\r\nexport async function unwind<TDoc = AnyDocument>(\r\n  Model: Model<TDoc>,\r\n  field: string,\r\n  options: { preserveEmpty?: boolean; session?: ClientSession } = {}\r\n): Promise<TDoc[]> {\r\n  const pipeline: PipelineStage[] = [\r\n    {\r\n      $unwind: {\r\n        path: `$${field}`,\r\n        preserveNullAndEmptyArrays: options.preserveEmpty !== false,\r\n      },\r\n    },\r\n  ];\r\n\r\n  return aggregate(Model, pipeline, { session: options.session });\r\n}\r\n\r\n/**\r\n * Facet search (multiple aggregations in one query)\r\n */\r\nexport async function facet<TResult = Record<string, unknown[]>>(\r\n  Model: Model<any>,\r\n  facets: Record<string, PipelineStage[]>,\r\n  options: { session?: ClientSession } = {}\r\n): Promise<TResult[]> {\r\n  const pipeline: PipelineStage[] = [{ $facet: facets as any } as any];\r\n\r\n  return aggregate(Model, pipeline, options);\r\n}\r\n\r\n/**\r\n * Get distinct values\r\n */\r\nexport async function distinct<T = unknown>(\r\n  Model: Model<any>,\r\n  field: string,\r\n  query: Record<string, unknown> = {},\r\n  options: { session?: ClientSession } = {}\r\n): Promise<T[]> {\r\n  return Model.distinct(field, query).session(options.session ?? null) as Promise<T[]>;\r\n}\r\n\r\n/**\r\n * Calculate sum\r\n */\r\nexport async function sum(\r\n  Model: Model<any>,\r\n  field: string,\r\n  query: Record<string, unknown> = {},\r\n  options: { session?: ClientSession } = {}\r\n): Promise<number> {\r\n  const pipeline: PipelineStage[] = [];\r\n\r\n  if (Object.keys(query).length > 0) {\r\n    pipeline.push({ $match: query });\r\n  }\r\n\r\n  pipeline.push({\r\n    $group: {\r\n      _id: null,\r\n      total: { $sum: `$${field}` },\r\n    },\r\n  });\r\n\r\n  const result = await aggregate<{ total: number }>(Model, pipeline, options);\r\n  return result[0]?.total || 0;\r\n}\r\n\r\n/**\r\n * Calculate average\r\n */\r\nexport async function average(\r\n  Model: Model<any>,\r\n  field: string,\r\n  query: Record<string, unknown> = {},\r\n  options: { session?: ClientSession } = {}\r\n): Promise<number> {\r\n  const pipeline: PipelineStage[] = [];\r\n\r\n  if (Object.keys(query).length > 0) {\r\n    pipeline.push({ $match: query });\r\n  }\r\n\r\n  pipeline.push({\r\n    $group: {\r\n      _id: null,\r\n      average: { $avg: `$${field}` },\r\n    },\r\n  });\r\n\r\n  const result = await aggregate<{ average: number }>(Model, pipeline, options);\r\n  return result[0]?.average || 0;\r\n}\r\n\r\n/**\r\n * Min/Max\r\n */\r\nexport async function minMax(\r\n  Model: Model<any>,\r\n  field: string,\r\n  query: Record<string, unknown> = {},\r\n  options: { session?: ClientSession } = {}\r\n): Promise<MinMaxResult> {\r\n  const pipeline: PipelineStage[] = [];\r\n\r\n  if (Object.keys(query).length > 0) {\r\n    pipeline.push({ $match: query });\r\n  }\r\n\r\n  pipeline.push({\r\n    $group: {\r\n      _id: null,\r\n      min: { $min: `$${field}` },\r\n      max: { $max: `$${field}` },\r\n    },\r\n  });\r\n\r\n  const result = await aggregate<MinMaxResult>(Model, pipeline, options);\r\n  return result[0] || { min: null, max: null };\r\n}\r\n"]}