@classytic/mongokit 3.1.0 → 3.1.1

package/dist/index.js

@@ -1,873 +1,15 @@
+import { getById, getByQuery, getOrCreate, count, exists, update, deleteById, aggregate, distinct } from './chunks/chunk-SAKSLT47.js';
+export { actions_exports as actions } from './chunks/chunk-SAKSLT47.js';
+import { PaginationEngine } from './chunks/chunk-M2XHQGZB.js';
+export { PaginationEngine } from './chunks/chunk-M2XHQGZB.js';
+export { aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, fieldFilterPlugin, immutableField, methodRegistryPlugin, mongoOperationsPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin } from './chunks/chunk-CSLJ2PL2.js';
+import { create, createMany } from './chunks/chunk-CF6FLC2G.js';
+export { buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, createMemoryCache, getImmutableFields, getSystemManagedFields, isFieldUpdateAllowed, validateUpdateBody } from './chunks/chunk-IT7DCOKR.js';
+export { createFieldPreset, filterResponseData, getFieldsForUser, getMongooseProjection } from './chunks/chunk-2ZN65ZOP.js';
+import { createError } from './chunks/chunk-VJXDGP3C.js';
+export { createError } from './chunks/chunk-VJXDGP3C.js';
 import mongoose from 'mongoose';
 
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// src/utils/error.ts
-function createError(status, message) {
-  const error = new Error(message);
-  error.status = status;
-  return error;
-}
-
-// src/actions/create.ts
-var create_exports = {};
-__export(create_exports, {
-  create: () => create,
-  createDefault: () => createDefault,
-  createMany: () => createMany,
-  upsert: () => upsert
-});
-async function create(Model, data, options = {}) {
-  const document = new Model(data);
-  await document.save({ session: options.session });
-  return document;
-}
-async function createMany(Model, dataArray, options = {}) {
-  return Model.insertMany(dataArray, {
-    session: options.session,
-    ordered: options.ordered !== false
-  });
-}
-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);
-}
-async function upsert(Model, query, data, options = {}) {
-  return Model.findOneAndUpdate(
-    query,
-    { $setOnInsert: data },
-    {
-      upsert: true,
-      new: true,
-      runValidators: true,
-      session: options.session,
-      ...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
-    }
-  );
-}
-
-// src/actions/read.ts
-var read_exports = {};
-__export(read_exports, {
-  count: () => count,
-  exists: () => exists,
-  getAll: () => getAll,
-  getById: () => getById,
-  getByQuery: () => getByQuery,
-  getOrCreate: () => getOrCreate,
-  tryGetByQuery: () => tryGetByQuery
-});
-function parsePopulate(populate) {
-  if (!populate) return [];
-  if (typeof populate === "string") {
-    return populate.split(",").map((p) => p.trim());
-  }
-  if (Array.isArray(populate)) {
-    return populate.map((p) => typeof p === "string" ? p.trim() : p);
-  }
-  return [populate];
-}
-async function getById(Model, id, options = {}) {
-  const query = options.query ? Model.findOne({ _id: id, ...options.query }) : Model.findById(id);
-  if (options.select) query.select(options.select);
-  if (options.populate) query.populate(parsePopulate(options.populate));
-  if (options.lean) query.lean();
-  if (options.session) query.session(options.session);
-  const document = await query.exec();
-  if (!document && options.throwOnNotFound !== false) {
-    throw createError(404, "Document not found");
-  }
-  return document;
-}
-async function getByQuery(Model, query, options = {}) {
-  const mongoQuery = Model.findOne(query);
-  if (options.select) mongoQuery.select(options.select);
-  if (options.populate) mongoQuery.populate(parsePopulate(options.populate));
-  if (options.lean) mongoQuery.lean();
-  if (options.session) mongoQuery.session(options.session);
-  const document = await mongoQuery.exec();
-  if (!document && options.throwOnNotFound !== false) {
-    throw createError(404, "Document not found");
-  }
-  return document;
-}
-async function tryGetByQuery(Model, query, options = {}) {
-  return getByQuery(Model, query, { ...options, throwOnNotFound: false });
-}
-async function getAll(Model, query = {}, options = {}) {
-  let mongoQuery = Model.find(query);
-  if (options.select) mongoQuery = mongoQuery.select(options.select);
-  if (options.populate) mongoQuery = mongoQuery.populate(parsePopulate(options.populate));
-  if (options.sort) mongoQuery = mongoQuery.sort(options.sort);
-  if (options.limit) mongoQuery = mongoQuery.limit(options.limit);
-  if (options.skip) mongoQuery = mongoQuery.skip(options.skip);
-  mongoQuery = mongoQuery.lean(options.lean !== false);
-  if (options.session) mongoQuery = mongoQuery.session(options.session);
-  return mongoQuery.exec();
-}
-async function getOrCreate(Model, query, createData, options = {}) {
-  return Model.findOneAndUpdate(
-    query,
-    { $setOnInsert: createData },
-    {
-      upsert: true,
-      new: true,
-      runValidators: true,
-      session: options.session,
-      ...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
-    }
-  );
-}
-async function count(Model, query = {}, options = {}) {
-  return Model.countDocuments(query).session(options.session ?? null);
-}
-async function exists(Model, query, options = {}) {
-  return Model.exists(query).session(options.session ?? null);
-}
-
-// src/actions/update.ts
-var update_exports = {};
-__export(update_exports, {
-  increment: () => increment,
-  pullFromArray: () => pullFromArray,
-  pushToArray: () => pushToArray,
-  update: () => update,
-  updateByQuery: () => updateByQuery,
-  updateMany: () => updateMany,
-  updateWithConstraints: () => updateWithConstraints,
-  updateWithValidation: () => updateWithValidation
-});
-function assertUpdatePipelineAllowed(update2, updatePipeline) {
-  if (Array.isArray(update2) && updatePipeline !== true) {
-    throw createError(
-      400,
-      "Update pipelines (array updates) are disabled by default; pass `{ updatePipeline: true }` to explicitly allow pipeline-style updates."
-    );
-  }
-}
-function parsePopulate2(populate) {
-  if (!populate) return [];
-  if (typeof populate === "string") {
-    return populate.split(",").map((p) => p.trim());
-  }
-  if (Array.isArray(populate)) {
-    return populate.map((p) => typeof p === "string" ? p.trim() : p);
-  }
-  return [populate];
-}
-async function update(Model, id, data, options = {}) {
-  assertUpdatePipelineAllowed(data, options.updatePipeline);
-  const document = await Model.findByIdAndUpdate(id, data, {
-    new: true,
-    runValidators: true,
-    session: options.session,
-    ...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
-  }).select(options.select || "").populate(parsePopulate2(options.populate)).lean(options.lean ?? false);
-  if (!document) {
-    throw createError(404, "Document not found");
-  }
-  return document;
-}
-async function updateWithConstraints(Model, id, data, constraints = {}, options = {}) {
-  assertUpdatePipelineAllowed(data, options.updatePipeline);
-  const query = { _id: id, ...constraints };
-  const document = await Model.findOneAndUpdate(query, data, {
-    new: true,
-    runValidators: true,
-    session: options.session,
-    ...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
-  }).select(options.select || "").populate(parsePopulate2(options.populate)).lean(options.lean ?? false);
-  return document;
-}
-async function updateWithValidation(Model, id, data, validationOptions = {}, options = {}) {
-  const { buildConstraints, validateUpdate } = validationOptions;
-  assertUpdatePipelineAllowed(data, options.updatePipeline);
-  if (buildConstraints) {
-    const constraints = buildConstraints(data);
-    const document = await updateWithConstraints(Model, id, data, constraints, options);
-    if (document) {
-      return { success: true, data: document };
-    }
-  }
-  const existing = await Model.findById(id).select(options.select || "").lean();
-  if (!existing) {
-    return {
-      success: false,
-      error: {
-        code: 404,
-        message: "Document not found"
-      }
-    };
-  }
-  if (validateUpdate) {
-    const validation = validateUpdate(existing, data);
-    if (!validation.valid) {
-      return {
-        success: false,
-        error: {
-          code: 403,
-          message: validation.message || "Update not allowed",
-          violations: validation.violations
-        }
-      };
-    }
-  }
-  const updated = await update(Model, id, data, options);
-  return { success: true, data: updated };
-}
-async function updateMany(Model, query, data, options = {}) {
-  assertUpdatePipelineAllowed(data, options.updatePipeline);
-  const result = await Model.updateMany(query, data, {
-    runValidators: true,
-    session: options.session,
-    ...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
-  });
-  return {
-    matchedCount: result.matchedCount,
-    modifiedCount: result.modifiedCount
-  };
-}
-async function updateByQuery(Model, query, data, options = {}) {
-  assertUpdatePipelineAllowed(data, options.updatePipeline);
-  const document = await Model.findOneAndUpdate(query, data, {
-    new: true,
-    runValidators: true,
-    session: options.session,
-    ...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
-  }).select(options.select || "").populate(parsePopulate2(options.populate)).lean(options.lean ?? false);
-  if (!document && options.throwOnNotFound !== false) {
-    throw createError(404, "Document not found");
-  }
-  return document;
-}
-async function increment(Model, id, field, value = 1, options = {}) {
-  return update(Model, id, { $inc: { [field]: value } }, options);
-}
-async function pushToArray(Model, id, field, value, options = {}) {
-  return update(Model, id, { $push: { [field]: value } }, options);
-}
-async function pullFromArray(Model, id, field, value, options = {}) {
-  return update(Model, id, { $pull: { [field]: value } }, options);
-}
-
-// src/actions/delete.ts
-var delete_exports = {};
-__export(delete_exports, {
-  deleteById: () => deleteById,
-  deleteByQuery: () => deleteByQuery,
-  deleteMany: () => deleteMany,
-  restore: () => restore,
-  softDelete: () => softDelete
-});
-async function deleteById(Model, id, options = {}) {
-  const document = await Model.findByIdAndDelete(id).session(options.session ?? null);
-  if (!document) {
-    throw createError(404, "Document not found");
-  }
-  return { success: true, message: "Deleted successfully" };
-}
-async function deleteMany(Model, query, options = {}) {
-  const result = await Model.deleteMany(query).session(options.session ?? null);
-  return {
-    success: true,
-    count: result.deletedCount,
-    message: "Deleted successfully"
-  };
-}
-async function deleteByQuery(Model, query, options = {}) {
-  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" };
-}
-async function softDelete(Model, id, options = {}) {
-  const document = await Model.findByIdAndUpdate(
-    id,
-    {
-      deleted: true,
-      deletedAt: /* @__PURE__ */ new Date(),
-      deletedBy: options.userId
-    },
-    { new: true, session: options.session }
-  );
-  if (!document) {
-    throw createError(404, "Document not found");
-  }
-  return { success: true, message: "Soft deleted successfully" };
-}
-async function restore(Model, id, options = {}) {
-  const document = await Model.findByIdAndUpdate(
-    id,
-    {
-      deleted: false,
-      deletedAt: null,
-      deletedBy: null
-    },
-    { new: true, session: options.session }
-  );
-  if (!document) {
-    throw createError(404, "Document not found");
-  }
-  return { success: true, message: "Restored successfully" };
-}
-
-// src/actions/aggregate.ts
-var aggregate_exports = {};
-__export(aggregate_exports, {
-  aggregate: () => aggregate,
-  aggregatePaginate: () => aggregatePaginate,
-  average: () => average,
-  countBy: () => countBy,
-  distinct: () => distinct,
-  facet: () => facet,
-  groupBy: () => groupBy,
-  lookup: () => lookup,
-  minMax: () => minMax,
-  sum: () => sum,
-  unwind: () => unwind
-});
-async function aggregate(Model, pipeline, options = {}) {
-  const aggregation = Model.aggregate(pipeline);
-  if (options.session) {
-    aggregation.session(options.session);
-  }
-  return aggregation.exec();
-}
-async function aggregatePaginate(Model, pipeline, options = {}) {
-  const page = parseInt(String(options.page || 1), 10);
-  const limit = parseInt(String(options.limit || 10), 10);
-  const skip = (page - 1) * limit;
-  const SAFE_LIMIT = 1e3;
-  if (limit > SAFE_LIMIT) {
-    console.warn(
-      `[mongokit] Large aggregation limit (${limit}). $facet results must be <16MB. Consider using Repository.aggregatePaginate() for safer handling of large datasets.`
-    );
-  }
-  const facetPipeline = [
-    ...pipeline,
-    {
-      $facet: {
-        docs: [{ $skip: skip }, { $limit: limit }],
-        total: [{ $count: "count" }]
-      }
-    }
-  ];
-  const aggregation = Model.aggregate(facetPipeline);
-  if (options.session) {
-    aggregation.session(options.session);
-  }
-  const [result] = await aggregation.exec();
-  const docs = result.docs || [];
-  const total = result.total[0]?.count || 0;
-  const pages = Math.ceil(total / limit);
-  return {
-    docs,
-    total,
-    page,
-    limit,
-    pages,
-    hasNext: page < pages,
-    hasPrev: page > 1
-  };
-}
-async function groupBy(Model, field, options = {}) {
-  const pipeline = [
-    { $group: { _id: `$${field}`, count: { $sum: 1 } } },
-    { $sort: { count: -1 } }
-  ];
-  if (options.limit) {
-    pipeline.push({ $limit: options.limit });
-  }
-  return aggregate(Model, pipeline, options);
-}
-async function countBy(Model, field, query = {}, options = {}) {
-  const pipeline = [];
-  if (Object.keys(query).length > 0) {
-    pipeline.push({ $match: query });
-  }
-  pipeline.push(
-    { $group: { _id: `$${field}`, count: { $sum: 1 } } },
-    { $sort: { count: -1 } }
-  );
-  return aggregate(Model, pipeline, options);
-}
-async function lookup(Model, lookupOptions) {
-  const { from, localField, foreignField, as, pipeline = [], let: letVars, query = {}, options = {} } = lookupOptions;
-  const aggPipeline = [];
-  if (Object.keys(query).length > 0) {
-    aggPipeline.push({ $match: query });
-  }
-  const usePipelineForm = pipeline.length > 0 || letVars;
-  if (usePipelineForm) {
-    if (pipeline.length === 0 && localField && foreignField) {
-      const autoPipeline = [
-        {
-          $match: {
-            $expr: {
-              $eq: [`$${foreignField}`, `$$${localField}`]
-            }
-          }
-        }
-      ];
-      aggPipeline.push({
-        $lookup: {
-          from,
-          let: { [localField]: `$${localField}`, ...letVars || {} },
-          pipeline: autoPipeline,
-          as
-        }
-      });
-    } else {
-      aggPipeline.push({
-        $lookup: {
-          from,
-          ...letVars && { let: letVars },
-          pipeline,
-          as
-        }
-      });
-    }
-  } else {
-    aggPipeline.push({
-      $lookup: {
-        from,
-        localField,
-        foreignField,
-        as
-      }
-    });
-  }
-  return aggregate(Model, aggPipeline, options);
-}
-async function unwind(Model, field, options = {}) {
-  const pipeline = [
-    {
-      $unwind: {
-        path: `$${field}`,
-        preserveNullAndEmptyArrays: options.preserveEmpty !== false
-      }
-    }
-  ];
-  return aggregate(Model, pipeline, { session: options.session });
-}
-async function facet(Model, facets, options = {}) {
-  const pipeline = [{ $facet: facets }];
-  return aggregate(Model, pipeline, options);
-}
-async function distinct(Model, field, query = {}, options = {}) {
-  return Model.distinct(field, query).session(options.session ?? null);
-}
-async function sum(Model, field, query = {}, options = {}) {
-  const pipeline = [];
-  if (Object.keys(query).length > 0) {
-    pipeline.push({ $match: query });
-  }
-  pipeline.push({
-    $group: {
-      _id: null,
-      total: { $sum: `$${field}` }
-    }
-  });
-  const result = await aggregate(Model, pipeline, options);
-  return result[0]?.total || 0;
-}
-async function average(Model, field, query = {}, options = {}) {
-  const pipeline = [];
-  if (Object.keys(query).length > 0) {
-    pipeline.push({ $match: query });
-  }
-  pipeline.push({
-    $group: {
-      _id: null,
-      average: { $avg: `$${field}` }
-    }
-  });
-  const result = await aggregate(Model, pipeline, options);
-  return result[0]?.average || 0;
-}
-async function minMax(Model, field, query = {}, options = {}) {
-  const pipeline = [];
-  if (Object.keys(query).length > 0) {
-    pipeline.push({ $match: query });
-  }
-  pipeline.push({
-    $group: {
-      _id: null,
-      min: { $min: `$${field}` },
-      max: { $max: `$${field}` }
-    }
-  });
-  const result = await aggregate(Model, pipeline, options);
-  return result[0] || { min: null, max: null };
-}
-function encodeCursor(doc, primaryField, sort, version = 1) {
-  const primaryValue = doc[primaryField];
-  const idValue = doc._id;
-  const payload = {
-    v: serializeValue(primaryValue),
-    t: getValueType(primaryValue),
-    id: serializeValue(idValue),
-    idType: getValueType(idValue),
-    sort,
-    ver: version
-  };
-  return Buffer.from(JSON.stringify(payload)).toString("base64");
-}
-function decodeCursor(token) {
-  try {
-    const json = Buffer.from(token, "base64").toString("utf-8");
-    const payload = JSON.parse(json);
-    return {
-      value: rehydrateValue(payload.v, payload.t),
-      id: rehydrateValue(payload.id, payload.idType),
-      sort: payload.sort,
-      version: payload.ver
-    };
-  } catch {
-    throw new Error("Invalid cursor token");
-  }
-}
-function validateCursorSort(cursorSort, currentSort) {
-  const cursorSortStr = JSON.stringify(cursorSort);
-  const currentSortStr = JSON.stringify(currentSort);
-  if (cursorSortStr !== currentSortStr) {
-    throw new Error("Cursor sort does not match current query sort");
-  }
-}
-function validateCursorVersion(cursorVersion, expectedVersion) {
-  if (cursorVersion !== expectedVersion) {
-    throw new Error(`Cursor version ${cursorVersion} does not match expected version ${expectedVersion}`);
-  }
-}
-function serializeValue(value) {
-  if (value instanceof Date) return value.toISOString();
-  if (value instanceof mongoose.Types.ObjectId) return value.toString();
-  return value;
-}
-function getValueType(value) {
-  if (value instanceof Date) return "date";
-  if (value instanceof mongoose.Types.ObjectId) return "objectid";
-  if (typeof value === "boolean") return "boolean";
-  if (typeof value === "number") return "number";
-  if (typeof value === "string") return "string";
-  return "unknown";
-}
-function rehydrateValue(serialized, type) {
-  switch (type) {
-    case "date":
-      return new Date(serialized);
-    case "objectid":
-      return new mongoose.Types.ObjectId(serialized);
-    case "boolean":
-      return Boolean(serialized);
-    case "number":
-      return Number(serialized);
-    default:
-      return serialized;
-  }
-}
-
-// src/pagination/utils/sort.ts
-function normalizeSort(sort) {
-  const normalized = {};
-  Object.keys(sort).forEach((key) => {
-    if (key !== "_id") normalized[key] = sort[key];
-  });
-  if (sort._id !== void 0) {
-    normalized._id = sort._id;
-  }
-  return normalized;
-}
-function validateKeysetSort(sort) {
-  const keys = Object.keys(sort);
-  if (keys.length === 1 && keys[0] !== "_id") {
-    const field = keys[0];
-    const direction = sort[field];
-    return normalizeSort({ [field]: direction, _id: direction });
-  }
-  if (keys.length === 1 && keys[0] === "_id") {
-    return normalizeSort(sort);
-  }
-  if (keys.length === 2) {
-    if (!keys.includes("_id")) {
-      throw new Error("Keyset pagination requires _id as tie-breaker");
-    }
-    const primaryField = keys.find((k) => k !== "_id");
-    const primaryDirection = sort[primaryField];
-    const idDirection = sort._id;
-    if (primaryDirection !== idDirection) {
-      throw new Error("_id direction must match primary field direction");
-    }
-    return normalizeSort(sort);
-  }
-  throw new Error("Keyset pagination only supports single field + _id");
-}
-function getPrimaryField(sort) {
-  const keys = Object.keys(sort);
-  return keys.find((k) => k !== "_id") || "_id";
-}
-
-// src/pagination/utils/filter.ts
-function buildKeysetFilter(baseFilters, sort, cursorValue, cursorId) {
-  const primaryField = Object.keys(sort).find((k) => k !== "_id") || "_id";
-  const direction = sort[primaryField];
-  const operator = direction === 1 ? "$gt" : "$lt";
-  return {
-    ...baseFilters,
-    $or: [
-      { [primaryField]: { [operator]: cursorValue } },
-      {
-        [primaryField]: cursorValue,
-        _id: { [operator]: cursorId }
-      }
-    ]
-  };
-}
-
-// src/pagination/utils/limits.ts
-function validateLimit(limit, config) {
-  const parsed = Number(limit);
-  if (!Number.isFinite(parsed) || parsed < 1) {
-    return config.defaultLimit || 10;
-  }
-  return Math.min(Math.floor(parsed), config.maxLimit || 100);
-}
-function validatePage(page, config) {
-  const parsed = Number(page);
-  if (!Number.isFinite(parsed) || parsed < 1) {
-    return 1;
-  }
-  const sanitized = Math.floor(parsed);
-  if (sanitized > (config.maxPage || 1e4)) {
-    throw new Error(`Page ${sanitized} exceeds maximum ${config.maxPage || 1e4}`);
-  }
-  return sanitized;
-}
-function shouldWarnDeepPagination(page, threshold) {
-  return page > threshold;
-}
-function calculateSkip(page, limit) {
-  return (page - 1) * limit;
-}
-function calculateTotalPages(total, limit) {
-  return Math.ceil(total / limit);
-}
-
-// src/pagination/PaginationEngine.ts
-var PaginationEngine = class {
-  Model;
-  config;
-  /**
-   * Create a new pagination engine
-   *
-   * @param Model - Mongoose model to paginate
-   * @param config - Pagination configuration
-   */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  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
-    } = options;
-    const sanitizedPage = validatePage(page, this.config);
-    const sanitizedLimit = validateLimit(limit, this.config);
-    const skip = calculateSkip(sanitizedPage, 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(sanitizedLimit).lean(lean);
-    if (session) query = query.session(session);
-    const hasFilters = Object.keys(filters).length > 0;
-    const useEstimated = this.config.useEstimatedCount && !hasFilters;
-    const [docs, total] = await Promise.all([
-      query.exec(),
-      useEstimated ? this.Model.estimatedDocumentCount() : this.Model.countDocuments(filters).session(session ?? null)
-    ]);
-    const totalPages = calculateTotalPages(total, sanitizedLimit);
-    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: sanitizedPage < totalPages,
-      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
-    } = options;
-    if (!sort) {
-      throw createError(400, "sort is required for keyset pagination");
-    }
-    const sanitizedLimit = validateLimit(limit, this.config);
-    const normalizedSort = validateKeysetSort(sort);
-    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);
-    const docs = await mongoQuery.exec();
-    const hasMore = docs.length > sanitizedLimit;
-    if (hasMore) docs.pop();
-    const primaryField = getPrimaryField(normalizedSort);
-    const nextCursor = hasMore && docs.length > 0 ? encodeCursor(docs[docs.length - 1], primaryField, normalizedSort, this.config.cursorVersion) : null;
-    return {
-      method: "keyset",
-      docs,
-      limit: sanitizedLimit,
-      hasMore,
-      next: nextCursor
-    };
-  }
-  /**
-   * 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
-    } = options;
-    const sanitizedPage = validatePage(page, this.config);
-    const sanitizedLimit = validateLimit(limit, this.config);
-    const skip = calculateSkip(sanitizedPage, sanitizedLimit);
-    const facetPipeline = [
-      ...pipeline,
-      {
-        $facet: {
-          docs: [{ $skip: skip }, { $limit: sanitizedLimit }],
-          total: [{ $count: "count" }]
-        }
-      }
-    ];
-    const aggregation = this.Model.aggregate(facetPipeline);
-    if (session) aggregation.session(session);
-    const [result] = await aggregation.exec();
-    const docs = result.docs;
-    const total = result.total[0]?.count || 0;
-    const totalPages = calculateTotalPages(total, sanitizedLimit);
-    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: sanitizedPage < totalPages,
-      hasPrev: sanitizedPage > 1,
-      ...warning && { warning }
-    };
-  }
-};
-
 // src/query/LookupBuilder.ts
 var LookupBuilder = class _LookupBuilder {
   options = {};
@@ -1043,12 +185,12 @@ var LookupBuilder = class _LookupBuilder {
    * ```
    */
   static multiple(lookups) {
-    return lookups.flatMap((lookup2) => {
-      const builder = new _LookupBuilder(lookup2.from).localField(lookup2.localField).foreignField(lookup2.foreignField);
-      if (lookup2.as) builder.as(lookup2.as);
-      if (lookup2.single) builder.single(lookup2.single);
-      if (lookup2.pipeline) builder.pipeline(lookup2.pipeline);
-      if (lookup2.let) builder.let(lookup2.let);
+    return lookups.flatMap((lookup) => {
+      const builder = new _LookupBuilder(lookup.from).localField(lookup.localField).foreignField(lookup.foreignField);
+      if (lookup.as) builder.as(lookup.as);
+      if (lookup.single) builder.single(lookup.single);
+      if (lookup.pipeline) builder.pipeline(lookup.pipeline);
+      if (lookup.let) builder.let(lookup.let);
       return builder.build();
     });
   }
@@ -1066,12 +208,12 @@ var LookupBuilder = class _LookupBuilder {
    * ```
    */
   static nested(lookups) {
-    return lookups.flatMap((lookup2, index) => {
-      const builder = new _LookupBuilder(lookup2.from).localField(lookup2.localField).foreignField(lookup2.foreignField);
-      if (lookup2.as) builder.as(lookup2.as);
-      if (lookup2.single !== void 0) builder.single(lookup2.single);
-      if (lookup2.pipeline) builder.pipeline(lookup2.pipeline);
-      if (lookup2.let) builder.let(lookup2.let);
+    return lookups.flatMap((lookup, index) => {
+      const builder = new _LookupBuilder(lookup.from).localField(lookup.localField).foreignField(lookup.foreignField);
+      if (lookup.as) builder.as(lookup.as);
+      if (lookup.single !== void 0) builder.single(lookup.single);
+      if (lookup.pipeline) builder.pipeline(lookup.pipeline);
+      if (lookup.let) builder.let(lookup.let);
       return builder.build();
     });
   }
@@ -1630,7 +772,8 @@ var Repository = class {
     if (context._cacheHit) {
       return context._cachedResult;
     }
-    const result = await getByQuery(this.Model, query, context);
+    const finalQuery = context.query || query;
+    const result = await getByQuery(this.Model, finalQuery, context);
     await this._emitHook("after:getByQuery", { context, result });
     return result;
   }
@@ -2011,1494 +1154,23 @@ var Repository = class {
     return createError(500, error.message || "Internal Server Error");
   }
 };
-
-// src/utils/field-selection.ts
-function getFieldsForUser(user, preset) {
-  if (!preset) {
-    throw new Error("Field preset is required");
-  }
-  const fields = [...preset.public || []];
-  if (user) {
-    fields.push(...preset.authenticated || []);
-    const roles = Array.isArray(user.roles) ? user.roles : user.roles ? [user.roles] : [];
-    if (roles.includes("admin") || roles.includes("superadmin")) {
-      fields.push(...preset.admin || []);
-    }
-  }
-  return [...new Set(fields)];
-}
-function getMongooseProjection(user, preset) {
-  const fields = getFieldsForUser(user, preset);
-  return fields.join(" ");
-}
-function filterObject(obj, allowedFields) {
-  if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
-    return obj;
-  }
-  const filtered = {};
-  for (const field of allowedFields) {
-    if (field in obj) {
-      filtered[field] = obj[field];
-    }
-  }
-  return filtered;
-}
-function filterResponseData(data, preset, user = null) {
-  const allowedFields = getFieldsForUser(user, preset);
-  if (Array.isArray(data)) {
-    return data.map((item) => filterObject(item, allowedFields));
-  }
-  return filterObject(data, allowedFields);
-}
-function createFieldPreset(config) {
-  return {
-    public: config.public || [],
-    authenticated: config.authenticated || [],
-    admin: config.admin || []
-  };
-}
-
-// src/plugins/field-filter.plugin.ts
-function fieldFilterPlugin(fieldPreset) {
-  return {
-    name: "fieldFilter",
-    apply(repo) {
-      const applyFieldFiltering = (context) => {
-        if (!fieldPreset) return;
-        const user = context.context?.user || context.user;
-        const fields = getFieldsForUser(user, fieldPreset);
-        const presetSelect = fields.join(" ");
-        if (context.select) {
-          context.select = `${presetSelect} ${context.select}`;
-        } else {
-          context.select = presetSelect;
-        }
-      };
-      repo.on("before:getAll", applyFieldFiltering);
-      repo.on("before:getById", applyFieldFiltering);
-      repo.on("before:getByQuery", applyFieldFiltering);
-    }
-  };
-}
-
-// src/plugins/timestamp.plugin.ts
-function timestampPlugin() {
-  return {
-    name: "timestamp",
-    apply(repo) {
-      repo.on("before:create", (context) => {
-        if (!context.data) return;
-        const now = /* @__PURE__ */ new Date();
-        if (!context.data.createdAt) context.data.createdAt = now;
-        if (!context.data.updatedAt) context.data.updatedAt = now;
-      });
-      repo.on("before:update", (context) => {
-        if (!context.data) return;
-        context.data.updatedAt = /* @__PURE__ */ new Date();
-      });
-    }
-  };
-}
-
-// src/plugins/audit-log.plugin.ts
-function auditLogPlugin(logger) {
-  return {
-    name: "auditLog",
-    apply(repo) {
-      repo.on("after:create", ({ context, result }) => {
-        logger?.info?.("Document created", {
-          model: context.model || repo.model,
-          id: result?._id,
-          userId: context.user?._id || context.user?.id,
-          organizationId: context.organizationId
-        });
-      });
-      repo.on("after:update", ({ context, result }) => {
-        logger?.info?.("Document updated", {
-          model: context.model || repo.model,
-          id: context.id || result?._id,
-          userId: context.user?._id || context.user?.id,
-          organizationId: context.organizationId
-        });
-      });
-      repo.on("after:delete", ({ context }) => {
-        logger?.info?.("Document deleted", {
-          model: context.model || repo.model,
-          id: context.id,
-          userId: context.user?._id || context.user?.id,
-          organizationId: context.organizationId
-        });
-      });
-      repo.on("error:create", ({ context, error }) => {
-        logger?.error?.("Create failed", {
-          model: context.model || repo.model,
-          error: error.message,
-          userId: context.user?._id || context.user?.id
-        });
-      });
-      repo.on("error:update", ({ context, error }) => {
-        logger?.error?.("Update failed", {
-          model: context.model || repo.model,
-          id: context.id,
-          error: error.message,
-          userId: context.user?._id || context.user?.id
-        });
-      });
-      repo.on("error:delete", ({ context, error }) => {
-        logger?.error?.("Delete failed", {
-          model: context.model || repo.model,
-          id: context.id,
-          error: error.message,
-          userId: context.user?._id || context.user?.id
-        });
-      });
-    }
-  };
-}
-
-// src/plugins/soft-delete.plugin.ts
-function buildDeletedFilter(deletedField, filterMode, includeDeleted) {
-  if (includeDeleted) {
-    return {};
-  }
-  if (filterMode === "exists") {
-    return { [deletedField]: { $exists: false } };
-  }
-  return { [deletedField]: null };
-}
-function buildGetDeletedFilter(deletedField, filterMode) {
-  if (filterMode === "exists") {
-    return { [deletedField]: { $exists: true, $ne: null } };
-  }
-  return { [deletedField]: { $ne: null } };
-}
-function softDeletePlugin(options = {}) {
-  const deletedField = options.deletedField || "deletedAt";
-  const deletedByField = options.deletedByField || "deletedBy";
-  const filterMode = options.filterMode || "null";
-  const addRestoreMethod = options.addRestoreMethod !== false;
-  const addGetDeletedMethod = options.addGetDeletedMethod !== false;
-  const ttlDays = options.ttlDays;
-  return {
-    name: "softDelete",
-    apply(repo) {
-      if (ttlDays !== void 0 && ttlDays > 0) {
-        const ttlSeconds = ttlDays * 24 * 60 * 60;
-        repo.Model.collection.createIndex(
-          { [deletedField]: 1 },
-          {
-            expireAfterSeconds: ttlSeconds,
-            partialFilterExpression: { [deletedField]: { $type: "date" } }
-          }
-        ).catch((err) => {
-          if (!err.message.includes("already exists")) {
-            console.warn(`[softDeletePlugin] Failed to create TTL index: ${err.message}`);
-          }
-        });
-      }
-      repo.on("before:delete", async (context) => {
-        if (options.soft !== false) {
-          const updateData = {
-            [deletedField]: /* @__PURE__ */ new Date()
-          };
-          if (context.user) {
-            updateData[deletedByField] = context.user._id || context.user.id;
-          }
-          await repo.Model.findByIdAndUpdate(context.id, updateData, { session: context.session });
-          context.softDeleted = true;
-        }
-      });
-      repo.on("before:getAll", (context) => {
-        if (options.soft !== false) {
-          const deleteFilter = buildDeletedFilter(deletedField, filterMode, !!context.includeDeleted);
-          if (Object.keys(deleteFilter).length > 0) {
-            const existingFilters = context.filters || {};
-            context.filters = {
-              ...existingFilters,
-              ...deleteFilter
-            };
-          }
-        }
-      });
-      repo.on("before:getById", (context) => {
-        if (options.soft !== false) {
-          const deleteFilter = buildDeletedFilter(deletedField, filterMode, !!context.includeDeleted);
-          if (Object.keys(deleteFilter).length > 0) {
-            context.query = {
-              ...context.query || {},
-              ...deleteFilter
-            };
-          }
-        }
-      });
-      repo.on("before:getByQuery", (context) => {
-        if (options.soft !== false) {
-          const deleteFilter = buildDeletedFilter(deletedField, filterMode, !!context.includeDeleted);
-          if (Object.keys(deleteFilter).length > 0) {
-            context.query = {
-              ...context.query || {},
-              ...deleteFilter
-            };
-          }
-        }
-      });
-      if (addRestoreMethod) {
-        const restoreMethod = async function(id, restoreOptions = {}) {
-          const updateData = {
-            [deletedField]: null,
-            [deletedByField]: null
-          };
-          const result = await this.Model.findByIdAndUpdate(id, { $set: updateData }, {
-            new: true,
-            session: restoreOptions.session
-          });
-          if (!result) {
-            const error = new Error(`Document with id '${id}' not found`);
-            error.status = 404;
-            throw error;
-          }
-          await this.emitAsync("after:restore", { id, result });
-          return result;
-        };
-        if (typeof repo.registerMethod === "function") {
-          repo.registerMethod("restore", restoreMethod);
-        } else {
-          repo.restore = restoreMethod.bind(repo);
-        }
-      }
-      if (addGetDeletedMethod) {
-        const getDeletedMethod = async function(params = {}, getDeletedOptions = {}) {
-          const deletedFilter = buildGetDeletedFilter(deletedField, filterMode);
-          const combinedFilters = {
-            ...params.filters || {},
-            ...deletedFilter
-          };
-          const page = params.page || 1;
-          const limit = params.limit || 20;
-          const skip = (page - 1) * limit;
-          let sortSpec = { [deletedField]: -1 };
-          if (params.sort) {
-            if (typeof params.sort === "string") {
-              const sortOrder = params.sort.startsWith("-") ? -1 : 1;
-              const sortField = params.sort.startsWith("-") ? params.sort.substring(1) : params.sort;
-              sortSpec = { [sortField]: sortOrder };
-            } else {
-              sortSpec = params.sort;
-            }
-          }
-          let query = this.Model.find(combinedFilters).sort(sortSpec).skip(skip).limit(limit);
-          if (getDeletedOptions.session) {
-            query = query.session(getDeletedOptions.session);
-          }
-          if (getDeletedOptions.select) {
-            const selectValue = Array.isArray(getDeletedOptions.select) ? getDeletedOptions.select.join(" ") : getDeletedOptions.select;
-            query = query.select(selectValue);
-          }
-          if (getDeletedOptions.populate) {
-            const populateSpec = getDeletedOptions.populate;
-            if (typeof populateSpec === "string") {
-              query = query.populate(populateSpec.split(",").map((p) => p.trim()));
-            } else if (Array.isArray(populateSpec)) {
-              query = query.populate(populateSpec);
-            } else {
-              query = query.populate(populateSpec);
-            }
-          }
-          if (getDeletedOptions.lean !== false) {
-            query = query.lean();
-          }
-          const [docs, total] = await Promise.all([
-            query.exec(),
-            this.Model.countDocuments(combinedFilters)
-          ]);
-          const pages = Math.ceil(total / limit);
-          return {
-            method: "offset",
-            docs,
-            page,
-            limit,
-            total,
-            pages,
-            hasNext: page < pages,
-            hasPrev: page > 1
-          };
-        };
-        if (typeof repo.registerMethod === "function") {
-          repo.registerMethod("getDeleted", getDeletedMethod);
-        } else {
-          repo.getDeleted = getDeletedMethod.bind(repo);
-        }
-      }
-    }
-  };
-}
-
-// src/plugins/method-registry.plugin.ts
-function methodRegistryPlugin() {
-  return {
-    name: "method-registry",
-    apply(repo) {
-      const registeredMethods = [];
-      repo.registerMethod = function(name, fn) {
-        if (repo[name]) {
-          throw new Error(
-            `Cannot register method '${name}': Method already exists on repository. Choose a different name or use a plugin that doesn't conflict.`
-          );
-        }
-        if (!name || typeof name !== "string") {
-          throw new Error("Method name must be a non-empty string");
-        }
-        if (typeof fn !== "function") {
-          throw new Error(`Method '${name}' must be a function`);
-        }
-        repo[name] = fn.bind(repo);
-        registeredMethods.push(name);
-        repo.emit("method:registered", { name, fn });
-      };
-      repo.hasMethod = function(name) {
-        return typeof repo[name] === "function";
-      };
-      repo.getRegisteredMethods = function() {
-        return [...registeredMethods];
-      };
-    }
-  };
-}
-
-// src/plugins/validation-chain.plugin.ts
-function validationChainPlugin(validators = [], options = {}) {
-  const { stopOnFirstError = true } = options;
-  validators.forEach((v, idx) => {
-    if (!v.name || typeof v.name !== "string") {
-      throw new Error(`Validator at index ${idx} missing 'name' (string)`);
-    }
-    if (typeof v.validate !== "function") {
-      throw new Error(`Validator '${v.name}' missing 'validate' function`);
-    }
-  });
-  const validatorsByOperation = {
-    create: [],
-    update: [],
-    delete: [],
-    createMany: []
-  };
-  const allOperationsValidators = [];
-  validators.forEach((v) => {
-    if (!v.operations || v.operations.length === 0) {
-      allOperationsValidators.push(v);
-    } else {
-      v.operations.forEach((op) => {
-        if (validatorsByOperation[op]) {
-          validatorsByOperation[op].push(v);
-        }
-      });
-    }
-  });
-  return {
-    name: "validation-chain",
-    apply(repo) {
-      const getValidatorsForOperation = (operation) => {
-        const specific = validatorsByOperation[operation] || [];
-        return [...allOperationsValidators, ...specific];
-      };
-      const runValidators = async (operation, context) => {
-        const operationValidators = getValidatorsForOperation(operation);
-        const errors = [];
-        for (const validator of operationValidators) {
-          try {
-            await validator.validate(context, repo);
-          } catch (error) {
-            if (stopOnFirstError) {
-              throw error;
-            }
-            errors.push({
-              validator: validator.name,
-              error: error.message || String(error)
-            });
-          }
-        }
-        if (errors.length > 0) {
-          const err = createError(
-            400,
-            `Validation failed: ${errors.map((e) => `[${e.validator}] ${e.error}`).join("; ")}`
-          );
-          err.validationErrors = errors;
-          throw err;
-        }
-      };
-      repo.on("before:create", async (context) => runValidators("create", context));
-      repo.on("before:createMany", async (context) => runValidators("createMany", context));
-      repo.on("before:update", async (context) => runValidators("update", context));
-      repo.on("before:delete", async (context) => runValidators("delete", context));
-    }
-  };
-}
-function blockIf(name, operations, condition, errorMessage) {
-  return {
-    name,
-    operations,
-    validate: (context) => {
-      if (condition(context)) {
-        throw createError(403, errorMessage);
-      }
-    }
-  };
-}
-function requireField(field, operations = ["create"]) {
-  return {
-    name: `require-${field}`,
-    operations,
-    validate: (context) => {
-      if (!context.data || context.data[field] === void 0 || context.data[field] === null) {
-        throw createError(400, `Field '${field}' is required`);
-      }
-    }
-  };
-}
-function autoInject(field, getter, operations = ["create"]) {
-  return {
-    name: `auto-inject-${field}`,
-    operations,
-    validate: (context) => {
-      if (context.data && !(field in context.data)) {
-        const value = getter(context);
-        if (value !== null && value !== void 0) {
-          context.data[field] = value;
-        }
-      }
-    }
-  };
-}
-function immutableField(field) {
-  return {
-    name: `immutable-${field}`,
-    operations: ["update"],
-    validate: (context) => {
-      if (context.data && field in context.data) {
-        throw createError(400, `Field '${field}' cannot be modified`);
-      }
-    }
-  };
-}
-function uniqueField(field, errorMessage) {
-  return {
-    name: `unique-${field}`,
-    operations: ["create", "update"],
-    validate: async (context, repo) => {
-      if (!context.data || !context.data[field] || !repo) return;
-      const query = { [field]: context.data[field] };
-      const getByQuery2 = repo.getByQuery;
-      if (typeof getByQuery2 !== "function") return;
-      const existing = await getByQuery2.call(repo, query, {
-        select: "_id",
-        lean: true,
-        throwOnNotFound: false
-      });
-      if (existing && String(existing._id) !== String(context.id)) {
-        throw createError(409, errorMessage || `${field} already exists`);
-      }
-    }
-  };
-}
-
-// src/plugins/mongo-operations.plugin.ts
-function mongoOperationsPlugin() {
-  return {
-    name: "mongo-operations",
-    apply(repo) {
-      if (!repo.registerMethod) {
-        throw new Error(
-          "mongoOperationsPlugin requires methodRegistryPlugin. Add methodRegistryPlugin() before mongoOperationsPlugin() in plugins array."
-        );
-      }
-      repo.registerMethod("upsert", async function(query, data, options = {}) {
-        return upsert(this.Model, query, data, options);
-      });
-      const validateAndUpdateNumeric = async function(id, field, value, operator, operationName, options) {
-        if (typeof value !== "number") {
-          throw createError(400, `${operationName} value must be a number`);
-        }
-        return this.update(id, { [operator]: { [field]: value } }, options);
-      };
-      repo.registerMethod("increment", async function(id, field, value = 1, options = {}) {
-        return validateAndUpdateNumeric.call(this, id, field, value, "$inc", "Increment", options);
-      });
-      repo.registerMethod("decrement", async function(id, field, value = 1, options = {}) {
-        return validateAndUpdateNumeric.call(this, id, field, -value, "$inc", "Decrement", options);
-      });
-      const applyOperator = function(id, field, value, operator, options) {
-        return this.update(id, { [operator]: { [field]: value } }, options);
-      };
-      repo.registerMethod("pushToArray", async function(id, field, value, options = {}) {
-        return applyOperator.call(this, id, field, value, "$push", options);
-      });
-      repo.registerMethod("pullFromArray", async function(id, field, value, options = {}) {
-        return applyOperator.call(this, id, field, value, "$pull", options);
-      });
-      repo.registerMethod("addToSet", async function(id, field, value, options = {}) {
-        return applyOperator.call(this, id, field, value, "$addToSet", options);
-      });
-      repo.registerMethod("setField", async function(id, field, value, options = {}) {
-        return applyOperator.call(this, id, field, value, "$set", options);
-      });
-      repo.registerMethod("unsetField", async function(id, fields, options = {}) {
-        const fieldArray = Array.isArray(fields) ? fields : [fields];
-        const unsetObj = fieldArray.reduce((acc, field) => {
-          acc[field] = "";
-          return acc;
-        }, {});
-        return this.update(id, { $unset: unsetObj }, options);
-      });
-      repo.registerMethod("renameField", async function(id, oldName, newName, options = {}) {
-        return this.update(id, { $rename: { [oldName]: newName } }, options);
-      });
-      repo.registerMethod("multiplyField", async function(id, field, multiplier, options = {}) {
-        return validateAndUpdateNumeric.call(this, id, field, multiplier, "$mul", "Multiplier", options);
-      });
-      repo.registerMethod("setMin", async function(id, field, value, options = {}) {
-        return applyOperator.call(this, id, field, value, "$min", options);
-      });
-      repo.registerMethod("setMax", async function(id, field, value, options = {}) {
-        return applyOperator.call(this, id, field, value, "$max", options);
-      });
-    }
-  };
-}
-
-// src/plugins/batch-operations.plugin.ts
-function batchOperationsPlugin() {
-  return {
-    name: "batch-operations",
-    apply(repo) {
-      if (!repo.registerMethod) {
-        throw new Error("batchOperationsPlugin requires methodRegistryPlugin");
-      }
-      repo.registerMethod("updateMany", async function(query, data, options = {}) {
-        const _buildContext = this._buildContext;
-        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,
-            ...options.updatePipeline !== void 0 ? { updatePipeline: options.updatePipeline } : {}
-          }).exec();
-          this.emit("after:updateMany", { context, result });
-          return result;
-        } catch (error) {
-          this.emit("error:updateMany", { context, error });
-          const _handleError = this._handleError;
-          throw _handleError.call(this, error);
-        }
-      });
-      repo.registerMethod("deleteMany", async function(query, options = {}) {
-        const _buildContext = this._buildContext;
-        const context = await _buildContext.call(this, "deleteMany", { query, options });
-        try {
-          this.emit("before:deleteMany", context);
-          const result = await this.Model.deleteMany(query, {
-            session: options.session
-          }).exec();
-          this.emit("after:deleteMany", { context, result });
-          return result;
-        } catch (error) {
-          this.emit("error:deleteMany", { context, error });
-          const _handleError = this._handleError;
-          throw _handleError.call(this, error);
-        }
-      });
-    }
-  };
-}
-
-// src/plugins/aggregate-helpers.plugin.ts
-function aggregateHelpersPlugin() {
-  return {
-    name: "aggregate-helpers",
-    apply(repo) {
-      if (!repo.registerMethod) {
-        throw new Error("aggregateHelpersPlugin requires methodRegistryPlugin");
-      }
-      repo.registerMethod("groupBy", async function(field, options = {}) {
-        const pipeline = [
-          { $group: { _id: `$${field}`, count: { $sum: 1 } } },
-          { $sort: { count: -1 } }
-        ];
-        if (options.limit) {
-          pipeline.push({ $limit: options.limit });
-        }
-        const aggregate2 = this.aggregate;
-        return aggregate2.call(this, pipeline, options);
-      });
-      const aggregateOperation = async function(field, operator, resultKey, query = {}, options = {}) {
-        const pipeline = [
-          { $match: query },
-          { $group: { _id: null, [resultKey]: { [operator]: `$${field}` } } }
-        ];
-        const aggregate2 = this.aggregate;
-        const result = await aggregate2.call(this, pipeline, options);
-        return result[0]?.[resultKey] || 0;
-      };
-      repo.registerMethod("sum", async function(field, query = {}, options = {}) {
-        return aggregateOperation.call(this, field, "$sum", "total", query, options);
-      });
-      repo.registerMethod("average", async function(field, query = {}, options = {}) {
-        return aggregateOperation.call(this, field, "$avg", "avg", query, options);
-      });
-      repo.registerMethod("min", async function(field, query = {}, options = {}) {
-        return aggregateOperation.call(this, field, "$min", "min", query, options);
-      });
-      repo.registerMethod("max", async function(field, query = {}, options = {}) {
-        return aggregateOperation.call(this, field, "$max", "max", query, options);
-      });
-    }
-  };
-}
-
-// src/plugins/subdocument.plugin.ts
-function subdocumentPlugin() {
-  return {
-    name: "subdocument",
-    apply(repo) {
-      if (!repo.registerMethod) {
-        throw new Error("subdocumentPlugin requires methodRegistryPlugin");
-      }
-      repo.registerMethod("addSubdocument", async function(parentId, arrayPath, subData, options = {}) {
-        const update2 = this.update;
-        return update2.call(this, parentId, { $push: { [arrayPath]: subData } }, options);
-      });
-      repo.registerMethod("getSubdocument", async function(parentId, arrayPath, subId, options = {}) {
-        const _executeQuery = this._executeQuery;
-        return _executeQuery.call(this, async (Model) => {
-          const parent = await Model.findById(parentId).session(options.session).exec();
-          if (!parent) throw createError(404, "Parent not found");
-          const parentObj = parent;
-          const arrayField = parentObj[arrayPath];
-          if (!arrayField || typeof arrayField.id !== "function") {
-            throw createError(404, "Array field not found");
-          }
-          const sub = arrayField.id(subId);
-          if (!sub) throw createError(404, "Subdocument not found");
-          return options.lean && typeof sub.toObject === "function" ? sub.toObject() : sub;
-        });
-      });
-      repo.registerMethod("updateSubdocument", async function(parentId, arrayPath, subId, updateData, options = {}) {
-        const _executeQuery = this._executeQuery;
-        return _executeQuery.call(this, async (Model) => {
-          const query = { _id: parentId, [`${arrayPath}._id`]: subId };
-          const update2 = { $set: { [`${arrayPath}.$`]: { ...updateData, _id: subId } } };
-          const result = await Model.findOneAndUpdate(query, update2, {
-            new: true,
-            runValidators: true,
-            session: options.session
-          }).exec();
-          if (!result) throw createError(404, "Parent or subdocument not found");
-          return result;
-        });
-      });
-      repo.registerMethod("deleteSubdocument", async function(parentId, arrayPath, subId, options = {}) {
-        const update2 = this.update;
-        return update2.call(this, parentId, { $pull: { [arrayPath]: { _id: subId } } }, options);
-      });
-    }
-  };
-}
-
-// src/utils/cache-keys.ts
-function hashString(str) {
-  let hash = 5381;
-  for (let i = 0; i < str.length; i++) {
-    hash = (hash << 5) + hash ^ str.charCodeAt(i);
-  }
-  return (hash >>> 0).toString(16);
-}
-function stableStringify(obj) {
-  if (obj === null || obj === void 0) return "";
-  if (typeof obj !== "object") return String(obj);
-  if (Array.isArray(obj)) {
-    return "[" + obj.map(stableStringify).join(",") + "]";
-  }
-  const sorted = Object.keys(obj).sort().map((key) => `${key}:${stableStringify(obj[key])}`);
-  return "{" + sorted.join(",") + "}";
-}
-function byIdKey(prefix, model, id) {
-  return `${prefix}:id:${model}:${id}`;
-}
-function byQueryKey(prefix, model, query, options) {
-  const hashInput = stableStringify({ q: query, s: options?.select, p: options?.populate });
-  return `${prefix}:one:${model}:${hashString(hashInput)}`;
-}
-function listQueryKey(prefix, model, version, params) {
-  const hashInput = stableStringify({
-    f: params.filters,
-    s: params.sort,
-    pg: params.page,
-    lm: params.limit,
-    af: params.after,
-    sl: params.select,
-    pp: params.populate
-  });
-  return `${prefix}:list:${model}:${version}:${hashString(hashInput)}`;
-}
-function versionKey(prefix, model) {
-  return `${prefix}:ver:${model}`;
-}
-function modelPattern(prefix, model) {
-  return `${prefix}:*:${model}:*`;
-}
-
-// src/plugins/cache.plugin.ts
-function cachePlugin(options) {
-  const config = {
-    adapter: options.adapter,
-    ttl: options.ttl ?? 60,
-    byIdTtl: options.byIdTtl ?? options.ttl ?? 60,
-    queryTtl: options.queryTtl ?? options.ttl ?? 60,
-    prefix: options.prefix ?? "mk",
-    debug: options.debug ?? false,
-    skipIfLargeLimit: options.skipIf?.largeLimit ?? 100
-  };
-  const stats = {
-    hits: 0,
-    misses: 0,
-    sets: 0,
-    invalidations: 0
-  };
-  let collectionVersion = 0;
-  const log = (msg, data) => {
-    if (config.debug) {
-      console.log(`[mongokit:cache] ${msg}`, data ?? "");
-    }
-  };
-  return {
-    name: "cache",
-    apply(repo) {
-      const model = repo.model;
-      (async () => {
-        try {
-          const cached = await config.adapter.get(versionKey(config.prefix, model));
-          if (cached !== null) {
-            collectionVersion = cached;
-            log(`Initialized version for ${model}:`, collectionVersion);
-          }
-        } catch (e) {
-          log(`Failed to initialize version for ${model}:`, e);
-        }
-      })();
-      async function bumpVersion() {
-        collectionVersion++;
-        try {
-          await config.adapter.set(versionKey(config.prefix, model), collectionVersion, config.ttl * 10);
-          stats.invalidations++;
-          log(`Bumped version for ${model} to:`, collectionVersion);
-        } catch (e) {
-          log(`Failed to bump version for ${model}:`, e);
-        }
-      }
-      async function invalidateById(id) {
-        const key = byIdKey(config.prefix, model, id);
-        try {
-          await config.adapter.del(key);
-          stats.invalidations++;
-          log(`Invalidated byId cache:`, key);
-        } catch (e) {
-          log(`Failed to invalidate byId cache:`, e);
-        }
-      }
-      repo.on("before:getById", async (context) => {
-        if (context.skipCache) {
-          log(`Skipping cache for getById: ${context.id}`);
-          return;
-        }
-        const id = String(context.id);
-        const key = byIdKey(config.prefix, model, id);
-        try {
-          const cached = await config.adapter.get(key);
-          if (cached !== null) {
-            stats.hits++;
-            log(`Cache HIT for getById:`, key);
-            context._cacheHit = true;
-            context._cachedResult = cached;
-          } else {
-            stats.misses++;
-            log(`Cache MISS for getById:`, key);
-          }
-        } catch (e) {
-          log(`Cache error for getById:`, e);
-          stats.misses++;
-        }
-      });
-      repo.on("before:getByQuery", async (context) => {
-        if (context.skipCache) {
-          log(`Skipping cache for getByQuery`);
-          return;
-        }
-        const query = context.query || {};
-        const key = byQueryKey(config.prefix, model, query, {
-          select: context.select,
-          populate: context.populate
-        });
-        try {
-          const cached = await config.adapter.get(key);
-          if (cached !== null) {
-            stats.hits++;
-            log(`Cache HIT for getByQuery:`, key);
-            context._cacheHit = true;
-            context._cachedResult = cached;
-          } else {
-            stats.misses++;
-            log(`Cache MISS for getByQuery:`, key);
-          }
-        } catch (e) {
-          log(`Cache error for getByQuery:`, e);
-          stats.misses++;
-        }
-      });
-      repo.on("before:getAll", async (context) => {
-        if (context.skipCache) {
-          log(`Skipping cache for getAll`);
-          return;
-        }
-        const limit = context.limit;
-        if (limit && limit > config.skipIfLargeLimit) {
-          log(`Skipping cache for large query (limit: ${limit})`);
-          return;
-        }
-        const params = {
-          filters: context.filters,
-          sort: context.sort,
-          page: context.page,
-          limit,
-          after: context.after,
-          select: context.select,
-          populate: context.populate
-        };
-        const key = listQueryKey(config.prefix, model, collectionVersion, params);
-        try {
-          const cached = await config.adapter.get(key);
-          if (cached !== null) {
-            stats.hits++;
-            log(`Cache HIT for getAll:`, key);
-            context._cacheHit = true;
-            context._cachedResult = cached;
-          } else {
-            stats.misses++;
-            log(`Cache MISS for getAll:`, key);
-          }
-        } catch (e) {
-          log(`Cache error for getAll:`, e);
-          stats.misses++;
-        }
-      });
-      repo.on("after:getById", async (payload) => {
-        const { context, result } = payload;
-        if (context._cacheHit) return;
-        if (context.skipCache) return;
-        if (result === null) return;
-        const id = String(context.id);
-        const key = byIdKey(config.prefix, model, id);
-        const ttl = context.cacheTtl ?? config.byIdTtl;
-        try {
-          await config.adapter.set(key, result, ttl);
-          stats.sets++;
-          log(`Cached getById result:`, key);
-        } catch (e) {
-          log(`Failed to cache getById:`, e);
-        }
-      });
-      repo.on("after:getByQuery", async (payload) => {
-        const { context, result } = payload;
-        if (context._cacheHit) return;
-        if (context.skipCache) return;
-        if (result === null) return;
-        const query = context.query || {};
-        const key = byQueryKey(config.prefix, model, query, {
-          select: context.select,
-          populate: context.populate
-        });
-        const ttl = context.cacheTtl ?? config.queryTtl;
-        try {
-          await config.adapter.set(key, result, ttl);
-          stats.sets++;
-          log(`Cached getByQuery result:`, key);
-        } catch (e) {
-          log(`Failed to cache getByQuery:`, e);
-        }
-      });
-      repo.on("after:getAll", async (payload) => {
-        const { context, result } = payload;
-        if (context._cacheHit) return;
-        if (context.skipCache) return;
-        const limit = context.limit;
-        if (limit && limit > config.skipIfLargeLimit) return;
-        const params = {
-          filters: context.filters,
-          sort: context.sort,
-          page: context.page,
-          limit,
-          after: context.after,
-          select: context.select,
-          populate: context.populate
-        };
-        const key = listQueryKey(config.prefix, model, collectionVersion, params);
-        const ttl = context.cacheTtl ?? config.queryTtl;
-        try {
-          await config.adapter.set(key, result, ttl);
-          stats.sets++;
-          log(`Cached getAll result:`, key);
-        } catch (e) {
-          log(`Failed to cache getAll:`, e);
-        }
-      });
-      repo.on("after:create", async () => {
-        await bumpVersion();
-      });
-      repo.on("after:createMany", async () => {
-        await bumpVersion();
-      });
-      repo.on("after:update", async (payload) => {
-        const { context } = payload;
-        const id = String(context.id);
-        await Promise.all([
-          invalidateById(id),
-          bumpVersion()
-        ]);
-      });
-      repo.on("after:updateMany", async () => {
-        await bumpVersion();
-      });
-      repo.on("after:delete", async (payload) => {
-        const { context } = payload;
-        const id = String(context.id);
-        await Promise.all([
-          invalidateById(id),
-          bumpVersion()
-        ]);
-      });
-      repo.on("after:deleteMany", async () => {
-        await bumpVersion();
-      });
-      repo.invalidateCache = async (id) => {
-        await invalidateById(id);
-        log(`Manual invalidation for ID:`, id);
-      };
-      repo.invalidateListCache = async () => {
-        await bumpVersion();
-        log(`Manual list cache invalidation for ${model}`);
-      };
-      repo.invalidateAllCache = async () => {
-        if (config.adapter.clear) {
-          try {
-            await config.adapter.clear(modelPattern(config.prefix, model));
-            stats.invalidations++;
-            log(`Full cache invalidation for ${model}`);
-          } catch (e) {
-            log(`Failed full cache invalidation for ${model}:`, e);
-          }
-        } else {
-          await bumpVersion();
-          log(`Partial cache invalidation for ${model} (adapter.clear not available)`);
-        }
-      };
-      repo.getCacheStats = () => ({ ...stats });
-      repo.resetCacheStats = () => {
-        stats.hits = 0;
-        stats.misses = 0;
-        stats.sets = 0;
-        stats.invalidations = 0;
-      };
-    }
-  };
-}
-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);
-            }
-          }
-        }
-      ]);
-    }
-  };
-}
-
-// src/utils/memory-cache.ts
-function createMemoryCache(maxEntries = 1e3) {
-  const cache = /* @__PURE__ */ new Map();
-  function cleanup() {
-    const now = Date.now();
-    for (const [key, entry] of cache) {
-      if (entry.expiresAt < now) {
-        cache.delete(key);
-      }
-    }
-  }
-  function evictOldest() {
-    if (cache.size >= maxEntries) {
-      const firstKey = cache.keys().next().value;
-      if (firstKey) cache.delete(firstKey);
-    }
-  }
-  return {
-    async get(key) {
-      cleanup();
-      const entry = cache.get(key);
-      if (!entry) return null;
-      if (entry.expiresAt < Date.now()) {
-        cache.delete(key);
-        return null;
-      }
-      return entry.value;
-    },
-    async set(key, value, ttl) {
-      cleanup();
-      evictOldest();
-      cache.set(key, {
-        value,
-        expiresAt: Date.now() + ttl * 1e3
-      });
-    },
-    async del(key) {
-      cache.delete(key);
-    },
-    async clear(pattern) {
-      if (!pattern) {
-        cache.clear();
-        return;
-      }
-      const regex = new RegExp(
-        "^" + pattern.replace(/\*/g, ".*").replace(/\?/g, ".") + "$"
-      );
-      for (const key of cache.keys()) {
-        if (regex.test(key)) {
-          cache.delete(key);
-        }
-      }
-    }
-  };
-}
-function buildCrudSchemasFromMongooseSchema(mongooseSchema, options = {}) {
-  const jsonCreate = buildJsonSchemaFromPaths(mongooseSchema, options);
-  const jsonUpdate = buildJsonSchemaForUpdate(jsonCreate, options);
-  const jsonParams = {
-    type: "object",
-    properties: { id: { type: "string", pattern: "^[0-9a-fA-F]{24}$" } },
-    required: ["id"]
-  };
-  const tree = mongooseSchema?.obj || {};
-  const jsonQuery = buildJsonSchemaForQuery(tree, options);
-  return { createBody: jsonCreate, updateBody: jsonUpdate, params: jsonParams, listQuery: jsonQuery };
-}
-function buildCrudSchemasFromModel(mongooseModel, options = {}) {
-  if (!mongooseModel || !mongooseModel.schema) {
-    throw new Error("Invalid mongoose model");
-  }
-  return buildCrudSchemasFromMongooseSchema(mongooseModel.schema, options);
-}
-function getImmutableFields(options = {}) {
-  const immutable = [];
-  const fieldRules = options?.fieldRules || {};
-  Object.entries(fieldRules).forEach(([field, rules]) => {
-    if (rules.immutable || rules.immutableAfterCreate) {
-      immutable.push(field);
-    }
-  });
-  (options?.update?.omitFields || []).forEach((f) => {
-    if (!immutable.includes(f)) immutable.push(f);
-  });
-  return immutable;
-}
-function getSystemManagedFields(options = {}) {
-  const systemManaged = [];
-  const fieldRules = options?.fieldRules || {};
-  Object.entries(fieldRules).forEach(([field, rules]) => {
-    if (rules.systemManaged) {
-      systemManaged.push(field);
-    }
-  });
-  return systemManaged;
-}
-function isFieldUpdateAllowed(fieldName, options = {}) {
-  const immutableFields = getImmutableFields(options);
-  const systemManagedFields = getSystemManagedFields(options);
-  return !immutableFields.includes(fieldName) && !systemManagedFields.includes(fieldName);
-}
-function validateUpdateBody(body = {}, options = {}) {
-  const violations = [];
-  const immutableFields = getImmutableFields(options);
-  const systemManagedFields = getSystemManagedFields(options);
-  Object.keys(body).forEach((field) => {
-    if (immutableFields.includes(field)) {
-      violations.push({ field, reason: "Field is immutable" });
-    } else if (systemManagedFields.includes(field)) {
-      violations.push({ field, reason: "Field is system-managed" });
-    }
-  });
-  return {
-    valid: violations.length === 0,
-    violations
-  };
-}
-function buildJsonSchemaFromPaths(mongooseSchema, options) {
-  const properties = {};
-  const required = [];
-  const paths = mongooseSchema.paths;
-  const rootFields = /* @__PURE__ */ new Map();
-  for (const [path, schemaType] of Object.entries(paths)) {
-    if (path === "_id" || path === "__v") continue;
-    const parts = path.split(".");
-    const rootField = parts[0];
-    if (!rootFields.has(rootField)) {
-      rootFields.set(rootField, []);
-    }
-    rootFields.get(rootField).push({ path, schemaType });
-  }
-  for (const [rootField, fieldPaths] of rootFields.entries()) {
-    if (fieldPaths.length === 1 && fieldPaths[0].path === rootField) {
-      const schemaType = fieldPaths[0].schemaType;
-      properties[rootField] = schemaTypeToJsonSchema(schemaType);
-      if (schemaType.isRequired) {
-        required.push(rootField);
-      }
-    } else {
-      const nestedSchema = buildNestedJsonSchema(fieldPaths, rootField);
-      properties[rootField] = nestedSchema.schema;
-      if (nestedSchema.required) {
-        required.push(rootField);
-      }
-    }
-  }
-  const schema = { type: "object", properties };
-  if (required.length) schema.required = required;
-  const fieldsToOmit = /* @__PURE__ */ new Set(["createdAt", "updatedAt", "__v"]);
-  (options?.create?.omitFields || []).forEach((f) => fieldsToOmit.add(f));
-  const fieldRules = options?.fieldRules || {};
-  Object.entries(fieldRules).forEach(([field, rules]) => {
-    if (rules.systemManaged) {
-      fieldsToOmit.add(field);
-    }
-  });
-  fieldsToOmit.forEach((field) => {
-    if (schema.properties?.[field]) {
-      delete schema.properties[field];
-    }
-    if (schema.required) {
-      schema.required = schema.required.filter((k) => k !== field);
-    }
-  });
-  const reqOv = options?.create?.requiredOverrides || {};
-  const optOv = options?.create?.optionalOverrides || {};
-  schema.required = schema.required || [];
-  for (const [k, v] of Object.entries(reqOv)) {
-    if (v && !schema.required.includes(k)) schema.required.push(k);
-  }
-  for (const [k, v] of Object.entries(optOv)) {
-    if (v && schema.required) schema.required = schema.required.filter((x) => x !== k);
-  }
-  Object.entries(fieldRules).forEach(([field, rules]) => {
-    if (rules.optional && schema.required) {
-      schema.required = schema.required.filter((x) => x !== field);
-    }
-  });
-  const schemaOverrides = options?.create?.schemaOverrides || {};
-  for (const [k, override] of Object.entries(schemaOverrides)) {
-    if (schema.properties?.[k]) {
-      schema.properties[k] = override;
-    }
-  }
-  if (options?.strictAdditionalProperties === true) {
-    schema.additionalProperties = false;
-  }
-  return schema;
-}
-function buildNestedJsonSchema(fieldPaths, rootField) {
-  const properties = {};
-  const required = [];
-  let hasRequiredFields = false;
-  for (const { path, schemaType } of fieldPaths) {
-    const relativePath = path.substring(rootField.length + 1);
-    const parts = relativePath.split(".");
-    if (parts.length === 1) {
-      properties[parts[0]] = schemaTypeToJsonSchema(schemaType);
-      if (schemaType.isRequired) {
-        required.push(parts[0]);
-        hasRequiredFields = true;
-      }
-    } else {
-      const fieldName = parts[0];
-      if (!properties[fieldName]) {
-        properties[fieldName] = { type: "object", properties: {} };
-      }
-      const nestedObj = properties[fieldName];
-      if (!nestedObj.properties) nestedObj.properties = {};
-      const deepPath = parts.slice(1).join(".");
-      nestedObj.properties[deepPath] = schemaTypeToJsonSchema(schemaType);
-    }
-  }
-  const schema = { type: "object", properties };
-  if (required.length) schema.required = required;
-  return { schema, required: hasRequiredFields };
-}
-function schemaTypeToJsonSchema(schemaType) {
-  const result = {};
-  const instance = schemaType.instance;
-  const options = schemaType.options || {};
-  if (instance === "String") {
-    result.type = "string";
-    if (typeof options.minlength === "number") result.minLength = options.minlength;
-    if (typeof options.maxlength === "number") result.maxLength = options.maxlength;
-    if (options.match instanceof RegExp) result.pattern = options.match.source;
-    if (options.enum && Array.isArray(options.enum)) result.enum = options.enum;
-  } else if (instance === "Number") {
-    result.type = "number";
-    if (typeof options.min === "number") result.minimum = options.min;
-    if (typeof options.max === "number") result.maximum = options.max;
-  } else if (instance === "Boolean") {
-    result.type = "boolean";
-  } else if (instance === "Date") {
-    result.type = "string";
-    result.format = "date-time";
-  } else if (instance === "ObjectId" || instance === "ObjectID") {
-    result.type = "string";
-    result.pattern = "^[0-9a-fA-F]{24}$";
-  } else if (instance === "Array") {
-    result.type = "array";
-    result.items = { type: "string" };
-  } else {
-    result.type = "object";
-    result.additionalProperties = true;
-  }
-  return result;
-}
-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));
-  const fieldRules = options?.fieldRules || {};
-  Object.entries(fieldRules).forEach(([field, rules]) => {
-    if (rules.immutable || rules.immutableAfterCreate) {
-      fieldsToOmit.add(field);
-    }
-  });
-  fieldsToOmit.forEach((field) => {
-    if (clone.properties?.[field]) {
-      delete clone.properties[field];
-    }
-  });
-  if (options?.strictAdditionalProperties === true) {
-    clone.additionalProperties = false;
-  }
-  if (options?.update?.requireAtLeastOne === true) {
-    clone.minProperties = 1;
-  }
-  return clone;
-}
-function buildJsonSchemaForQuery(_tree, options) {
-  const basePagination = {
-    type: "object",
-    properties: {
-      page: { type: "string" },
-      limit: { type: "string" },
-      sort: { type: "string" },
-      populate: { type: "string" },
-      search: { type: "string" },
-      select: { type: "string" },
-      lean: { type: "string" },
-      includeDeleted: { type: "string" }
-    },
-    additionalProperties: true
-  };
-  const filterable = options?.query?.filterableFields || {};
-  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;
-}
-var QueryParser = class {
-  options;
-  operators = {
-    eq: "$eq",
-    ne: "$ne",
-    gt: "$gt",
-    gte: "$gte",
-    lt: "$lt",
-    lte: "$lte",
-    in: "$in",
-    nin: "$nin",
-    like: "$regex",
-    contains: "$regex",
-    regex: "$regex",
-    exists: "$exists",
-    size: "$size",
-    type: "$type"
+var QueryParser = class {
+  options;
+  operators = {
+    eq: "$eq",
+    ne: "$ne",
+    gt: "$gt",
+    gte: "$gte",
+    lt: "$lt",
+    lte: "$lte",
+    in: "$in",
+    nin: "$nin",
+    like: "$regex",
+    contains: "$regex",
+    regex: "$regex",
+    exists: "$exists",
+    size: "$size",
+    type: "$type"
   };
   dangerousOperators;
   /**
@@ -3549,7 +1221,7 @@ var QueryParser = class {
       after,
       cursor,
       select,
-      lookup: lookup2,
+      lookup,
       aggregate: aggregate2,
       ...filters
     } = query || {};
@@ -3571,8 +1243,8 @@ var QueryParser = class {
     if (select) {
       parsed.select = this._parseSelect(select);
     }
-    if (this.options.enableLookups && lookup2) {
-      parsed.lookups = this._parseLookups(lookup2);
+    if (this.options.enableLookups && lookup) {
+      parsed.lookups = this._parseLookups(lookup);
     }
     if (this.options.enableAggregations && aggregate2) {
       parsed.aggregation = this._parseAggregation(aggregate2);
@@ -3616,10 +1288,10 @@ var QueryParser = class {
    * // Returns: [{ from: 'departments', localField: 'deptSlug', foreignField: 'slug', single: true }]
    * ```
    */
-  _parseLookups(lookup2) {
-    if (!lookup2 || typeof lookup2 !== "object") return [];
+  _parseLookups(lookup) {
+    if (!lookup || typeof lookup !== "object") return [];
     const lookups = [];
-    const lookupObj = lookup2;
+    const lookupObj = lookup;
     for (const [collectionName, config] of Object.entries(lookupObj)) {
       try {
         const lookupConfig = this._parseSingleLookup(collectionName, config);
@@ -3994,16 +1666,6 @@ var QueryParser = class {
   }
 };
 
-// src/actions/index.ts
-var actions_exports = {};
-__export(actions_exports, {
-  aggregate: () => aggregate_exports,
-  create: () => create_exports,
-  deleteActions: () => delete_exports,
-  read: () => read_exports,
-  update: () => update_exports
-});
-
 // src/index.ts
 function createRepository(Model, plugins = [], paginationConfig = {}, options = {}) {
   return new Repository(Model, plugins, paginationConfig, options);
@@ -4016,7 +1678,7 @@ var index_default = Repository;
  * smart pagination, events, and plugins.
  * 
  * @module @classytic/mongokit
- * @author Sadman Chowdhury (Github: @siam923)
+ * @author Classytic (https://github.com/classytic)
  * @license MIT
  * 
  * @example
@@ -4048,4 +1710,4 @@ var index_default = Repository;
  * ```
  */
 
-export { AggregationBuilder, LookupBuilder, PaginationEngine, QueryParser, Repository, actions_exports as actions, aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, createError, createFieldPreset, createMemoryCache, createRepository, index_default as default, fieldFilterPlugin, filterResponseData, getFieldsForUser, getImmutableFields, getMongooseProjection, getSystemManagedFields, immutableField, isFieldUpdateAllowed, methodRegistryPlugin, mongoOperationsPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validateUpdateBody, validationChainPlugin };
+export { AggregationBuilder, LookupBuilder, QueryParser, Repository, createRepository, index_default as default };