@cyberskill/shared 2.10.0 → 2.11.0

package/dist/node/mongo/mongo.util.cjs

@@ -1,5 +1,5 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const q=require("lodash-es"),B=require("migrate-mongo"),K=require("mongoose"),Q=require("mongoose-aggregate-paginate-v2"),W=require("mongoose-paginate-v2"),$=require("uuid"),H=require("./mongo.constant.cjs"),V=require("../../util/object/object.util.cjs"),k=require("../../util/common/common.util.cjs"),F=require("../fs/fs.util.cjs"),A=require("../path/path.constant.cjs"),J=require("../../util/validate/validate.util.cjs"),j=require("../../util/string/string.util.cjs"),D=require("../../constant/response-status.cjs"),d=require("../log/log.util.cjs");var X=Object.defineProperty,Y=Object.defineProperties,Z=Object.getOwnPropertyDescriptors,G=Object.getOwnPropertySymbols,ee=Object.prototype.hasOwnProperty,te=Object.prototype.propertyIsEnumerable,U=(s,t,e)=>t in s?X(s,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[t]=e,O=(s,t)=>{for(var e in t||(t={}))ee.call(t,e)&&U(s,e,t[e]);if(G)for(var e of G(t))te.call(t,e)&&U(s,e,t[e]);return s},P=(s,t)=>Y(s,Z(t)),re=(s,t,e)=>U(s,typeof t!="symbol"?t+"":t,e),l=(s,t,e)=>new Promise((r,n)=>{var c=i=>{try{u(e.next(i))}catch(a){n(a)}},o=i=>{try{u(e.throw(i))}catch(a){n(a)}},u=i=>i.done?r(i.value):Promise.resolve(i.value).then(c,o);u((e=e.apply(s,t)).next())});function ne(s){return s===s.toUpperCase()?s.charAt(0).toUpperCase()+s.slice(1).toLowerCase():s}const M={createGenericFields(){return{id:$.v4(),isDel:!1,createdAt:new Date,updatedAt:new Date}},applyPlugins(s,t){t.filter(e=>typeof e=="function").forEach(e=>s.plugin(e))},applyMiddlewares(s,t){t.forEach(({method:e,pre:r,post:n})=>{e&&r&&s.pre(e,r),e&&n&&s.post(e,n)})},createGenericSchema(s){return new s.Schema({id:{type:String,default:$.v4,unique:!0},isDel:{type:Boolean,default:!1}},{timestamps:!0})},createSchema({mongoose:s,schema:t,virtuals:e=[],standalone:r=!1}){const n=new s.Schema(t,{toJSON:{virtuals:!0},toObject:{virtuals:!0}});return e.forEach(({name:c,options:o,get:u})=>{if(M.isDynamicVirtual(o)){const i=n.statics;i._dynamicVirtuals||(i._dynamicVirtuals=[]),i._dynamicVirtuals.push({name:c,options:o});const a=n.virtual(c);u?a.get(u):a.get(function(){var f;return((f=this._populated)==null?void 0:f[c])||(o!=null&&o.count?0:o!=null&&o.justOne?null:[])})}else{const i=n.virtual(c,o);u&&i.get(u)}}),r||n.add(M.createGenericSchema(s)),n},createModel({mongoose:s,name:t,schema:e,virtuals:r=[],pagination:n=!0,aggregate:c=!0,middlewares:o=[]}){if(!t)throw new Error("Model name is required.");if(s.models[t])return s.models[t];const u=M.createSchema({mongoose:s,schema:e,virtuals:r});return(n||c)&&M.applyPlugins(u,[n&&W,c&&Q]),M.applyMiddlewares(u,o),s.model(t,u)},validator:{isRequired(){return function(s){return l(this,null,function*(){return!J.validate.isEmpty(s)})}},isUnique(s){return function(t){return l(this,null,function*(){if(!Array.isArray(s)||s.length===0)throw new Error("Fields must be a non-empty array of strings.");const e={$or:s.map(n=>({[n]:t}))};return!(yield this.constructor.exists(e))})}},matchesRegex(s){return function(t){return l(this,null,function*(){if(!Array.isArray(s)||s.some(e=>!(e instanceof RegExp)))throw new Error("regexArray must be an array of valid RegExp objects.");return s.every(e=>e.test(t))})}}},migrate:P(O({},B),{setConfig:s=>{const t=`// This file is automatically generated by the Cyberskill CLI.
-module.exports = ${JSON.stringify(s,null,4)}`;F.writeFileSync(A.PATH.MIGRATE_MONGO_CONFIG,t);const e=`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const $=require("lodash-es"),K=require("migrate-mongo"),Q=require("mongoose-aggregate-paginate-v2"),W=require("mongoose-paginate-v2"),G=require("uuid"),H=require("./mongo.constant.cjs"),T=require("./mongo.type.cjs"),b=require("../../util/object/object.util.cjs"),k=require("../../util/common/common.util.cjs"),P=require("../fs/fs.util.cjs"),A=require("../path/path.constant.cjs"),J=require("../../util/validate/validate.util.cjs"),I=require("../../util/string/string.util.cjs"),R=require("../../constant/response-status.cjs"),d=require("../log/log.util.cjs");var X=Object.defineProperty,Y=Object.defineProperties,Z=Object.getOwnPropertyDescriptors,z=Object.getOwnPropertySymbols,ee=Object.prototype.hasOwnProperty,te=Object.prototype.propertyIsEnumerable,U=(s,t,e)=>t in s?X(s,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[t]=e,O=(s,t)=>{for(var e in t||(t={}))ee.call(t,e)&&U(s,e,t[e]);if(z)for(var e of z(t))te.call(t,e)&&U(s,e,t[e]);return s},x=(s,t)=>Y(s,Z(t)),re=(s,t,e)=>U(s,typeof t!="symbol"?t+"":t,e),l=(s,t,e)=>new Promise((r,n)=>{var c=i=>{try{u(e.next(i))}catch(a){n(a)}},o=i=>{try{u(e.throw(i))}catch(a){n(a)}},u=i=>i.done?r(i.value):Promise.resolve(i.value).then(c,o);u((e=e.apply(s,t)).next())});function ne(s){return s===s.toUpperCase()?s.charAt(0).toUpperCase()+s.slice(1).toLowerCase():s}const M={createGenericFields(){return{id:G.v4(),isDel:!1,createdAt:new Date,updatedAt:new Date}},applyPlugins(s,t){t.filter(e=>typeof e=="function").forEach(e=>s.plugin(e))},applyMiddlewares(s,t){t.forEach(({method:e,pre:r,post:n})=>{e&&r&&s.pre(e,r),e&&n&&s.post(e,n)})},createGenericSchema(s){return new s.Schema({id:{type:String,default:G.v4,unique:!0},isDel:{type:Boolean,default:!1}},{timestamps:!0})},createSchema({mongoose:s,schema:t,virtuals:e=[],standalone:r=!1}){const n=new s.Schema(t,{toJSON:{virtuals:!0},toObject:{virtuals:!0}});return e.forEach(({name:c,options:o,get:u})=>{if(M.isDynamicVirtual(o)){const i=n.statics;i._dynamicVirtuals||(i._dynamicVirtuals=[]),i._dynamicVirtuals.push({name:c,options:o});const a=n.virtual(c);u?a.get(u):a.get(function(){var f;return((f=this._populated)==null?void 0:f[c])||(o!=null&&o.count?0:o!=null&&o.justOne?null:[])})}else{const i=n.virtual(c,o);u&&i.get(u)}}),r||n.add(M.createGenericSchema(s)),n},createModel({mongoose:s,name:t,schema:e,virtuals:r=[],pagination:n=!0,aggregate:c=!0,middlewares:o=[]}){if(!t)throw new Error("Model name is required.");if(s.models[t])return s.models[t];const u=M.createSchema({mongoose:s,schema:e,virtuals:r});return(n||c)&&M.applyPlugins(u,[n&&W,c&&Q]),M.applyMiddlewares(u,o),s.model(t,u)},validator:{isRequired(){return function(s){return l(this,null,function*(){return!J.validate.isEmpty(s)})}},isUnique(s){return function(t){return l(this,null,function*(){if(!Array.isArray(s)||s.length===0)throw new Error("Fields must be a non-empty array of strings.");const e={$or:s.map(n=>({[n]:t}))};return!(yield this.constructor.exists(e))})}},matchesRegex(s){return function(t){return l(this,null,function*(){if(!Array.isArray(s)||s.some(e=>!(e instanceof RegExp)))throw new Error("regexArray must be an array of valid RegExp objects.");return s.every(e=>e.test(t))})}}},migrate:x(O({},K),{setConfig:s=>{const t=`// This file is automatically generated by the Cyberskill CLI.
+module.exports = ${JSON.stringify(s,null,4)}`;P.writeFileSync(A.PATH.MIGRATE_MONGO_CONFIG,t);const e=`
 ${A.MIGRATE_MONGO_CONFIG}
-`;F.pathExistsSync(A.PATH.GIT_IGNORE)?F.readFileSync(A.PATH.GIT_IGNORE,"utf-8").split(`
-`).includes(A.MIGRATE_MONGO_CONFIG)||F.appendFileSync(A.PATH.GIT_IGNORE,e):F.writeFileSync(A.PATH.GIT_IGNORE,e)}}),regexify(s,t){if(!s)return{};let e=q.cloneDeep(s);if(!t||t.length===0)return e;for(const r of t){const n=r.toString().split("."),c=V.getNestedValue(e,n);if(typeof c=="string"&&c.length>0){const o={$regex:`.*${k.regexSearchMapper(c)}.*`,$options:"i"};e=V.setNestedValue(e,n,o)}}return e},isDynamicVirtual(s){return!!(s&&typeof s.ref=="function")},getNewRecords(s,t,e){return l(this,null,function*(){const r=yield s.findAll({});return r.success?t.filter(c=>!r.result.some(o=>e(o,c))):t})},getExistingRecords(s,t,e){return l(this,null,function*(){const r=yield s.findAll({});return r.success?r.result.filter(c=>t.some(o=>e(c,o))):[]})}};function se(s){return s!==null&&typeof s=="object"&&"toObject"in s&&typeof s.toObject=="function"}function I(s,t){if(!s||!t||t.length===0)return s;const e=new Set(t.map(r=>r.name));if(Array.isArray(s)){const r=s.filter(n=>{if(typeof n=="string")return!e.has(n);if(typeof n=="object"&&n!==null){const c=n;return!e.has(c.path||c.populate||"")}return!0});return r.length>0?r:void 0}if(typeof s=="string")return e.has(s)?void 0:s;if(typeof s=="object"&&s!==null){const r=s,n=r.path||r.populate||"";return e.has(n)?void 0:s}return s}function ce(s,t,e){if(!s.length||!t||!(e!=null&&e.ref))return[];const r=new Map;return s.forEach(n=>{try{const c=e.ref(n);if(c==null)return;const o=typeof c=="string"?c:String(c);if(o&&o.trim()!==""){const u=ne(o);r.has(u)||r.set(u,[]),r.get(u).push(n)}}catch(c){d.catchError(new Error(`Dynamic ref function failed for virtual "${t}": ${c instanceof Error?c.message:String(c)}`))}}),Array.from(r.entries()).map(([n,c])=>({model:n,docs:c}))}function z(s,t,e,r,n){return l(this,null,function*(){if(!t.length||!e.length||!r)return t;const c=e.filter(i=>{if(Array.isArray(r))return r.length>0&&r.some(a=>typeof a=="string"?a===i.name:a.path===i.name);if(typeof r=="string")return r===i.name;if(typeof r=="object"&&r!==null){const a=r;return a.path&&a.path===i.name||a.populate&&a.populate===i.name}return!1});if(c.length===0)return t;const o=q.cloneDeep(t.map(i=>se(i)?i.toObject():i));o.forEach(i=>{c.forEach(({name:a,options:f})=>{if(!(a in i)){const S=i;S[a]=f.count?0:f.justOne?null:[]}})});const u=new Map;for(const i of c){const{name:a,options:f}=i,S=ce(o,a,f);for(const h of S){u.has(h.model)||u.set(h.model,{virtuals:[],localValueSets:new Map,docsByLocalValue:new Map});const y=u.get(h.model);y.virtuals.find(T=>T.name===a)||(y.virtuals.push(i),y.localValueSets.set(a,new Set));const N=y.localValueSets.get(a);h.docs.forEach(T=>{const x=T[f.localField];if(x!=null){const _=String(x);N.add(_);let R=-1;const v=T;v.id!==void 0?R=o.findIndex(b=>b.id===v.id):v._id!==void 0&&(R=o.findIndex(b=>{var E,m,p,g;return((m=(E=b._id)==null?void 0:E.toString)==null?void 0:m.call(E))===((g=(p=v._id)==null?void 0:p.toString)==null?void 0:g.call(p))})),R!==-1&&(y.docsByLocalValue.has(_)||y.docsByLocalValue.set(_,[]),y.docsByLocalValue.get(_).push(R))}})}}return yield Promise.all(Array.from(u.entries()).map(i=>l(null,[i],function*([a,f]){const S=s.models[a];if(!S)return;const h=new Set;if(f.localValueSets.forEach(_=>{_.forEach(R=>h.add(R))}),h.size===0)return;const y=[...new Set(f.virtuals.map(_=>_.options.foreignField))],N=Array.from(h);let T;y.length===1?T={[String(y[0])]:{$in:N}}:T={$or:y.map(_=>({[_]:{$in:N}}))};const x=yield S.find(T,n).lean();for(const _ of f.virtuals){const{name:R,options:v}=_,b=x.filter(E=>{const m=E[v.foreignField];return m!=null&&h.has(String(m))});if(v.count){const E=new Map;b.forEach(m=>{var p;const g=(p=m[v.foreignField])==null?void 0:p.toString();g&&E.set(g,(E.get(g)||0)+1)}),f.localValueSets.get(R).forEach(m=>{const p=f.docsByLocalValue.get(m)||[],g=E.get(m)||0;p.forEach(w=>{const C=o[w];C[R]===void 0&&(C[R]=g)})})}else{const E=new Map;b.forEach(m=>{var p;const g=(p=m[v.foreignField])==null?void 0:p.toString();g&&(E.has(g)||E.set(g,[]),E.get(g).push(m))}),f.localValueSets.get(R).forEach(m=>{const p=f.docsByLocalValue.get(m)||[],g=E.get(m)||[],w=v.justOne?g[0]||null:g;p.forEach(C=>{const L=o[C];L[R]=w})})}}}))),o})}class oe{constructor(t,e){re(this,"collection"),this.collection=t.collection(e)}createOne(t){return l(this,null,function*(){try{const e=O(O({},M.createGenericFields()),t);return(yield this.collection.insertOne(e)).acknowledged?{success:!0,message:"Document created successfully",result:e}:{success:!1,message:"Document creation failed",code:D.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}}catch(e){return d.catchError(e)}})}createMany(t){return l(this,null,function*(){try{const e=t.map(n=>O(O({},M.createGenericFields()),n)),r=yield this.collection.insertMany(e);return r.insertedCount===0?{success:!1,message:"No documents were inserted",code:D.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:`${r.insertedCount} documents created successfully`,result:e}}catch(e){return d.catchError(e)}})}findOne(t){return l(this,null,function*(){try{const e=yield this.collection.findOne(t);return e?{success:!0,message:"Document found",result:e}:{success:!1,message:"Document not found",code:D.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(e){return d.catchError(e)}})}findAll(){return l(this,arguments,function*(t={}){try{return{success:!0,message:"Documents retrieved successfully",result:yield this.collection.find(t).toArray()}}catch(e){return d.catchError(e)}})}count(){return l(this,arguments,function*(t={}){try{const e=yield this.collection.countDocuments(t);return{success:!0,message:`${e} documents counted successfully`,result:e}}catch(e){return d.catchError(e)}})}updateOne(t,e){return l(this,null,function*(){try{const r=yield this.collection.updateOne(t,{$set:e});return r.matchedCount===0?{success:!1,message:"No documents matched the filter",code:D.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:"Document updated successfully",result:r}}catch(r){return d.catchError(r)}})}updateMany(t,e){return l(this,null,function*(){try{const r=yield this.collection.updateMany(t,{$set:e});return r.matchedCount===0?{success:!1,message:"No documents matched the filter",code:D.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:"Documents updated successfully",result:r}}catch(r){return d.catchError(r)}})}deleteOne(t){return l(this,null,function*(){try{const e=yield this.collection.deleteOne(t);return e.deletedCount===0?{success:!1,message:"No documents matched the filter",code:D.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:"Document deleted successfully",result:e}}catch(e){return d.catchError(e)}})}deleteMany(t){return l(this,null,function*(){try{const e=yield this.collection.deleteMany(t);return e.deletedCount===0?{success:!1,message:"No documents matched the filter",code:D.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:"Documents deleted successfully",result:e}}catch(e){return d.catchError(e)}})}}class ue{constructor(t){this.model=t}getModelName(){return this.model.modelName}getDynamicVirtuals(){return this.model.schema.statics._dynamicVirtuals}populateDynamicVirtualsForDocument(t,e){return l(this,null,function*(){const r=this.getDynamicVirtuals();if(r&&r.length>0){const n=yield z(this.model.base,[t],r,e);return n&&n[0]?n[0]:t}return t})}populateDynamicVirtualsForDocuments(t,e){return l(this,null,function*(){const r=this.getDynamicVirtuals();return r&&r.length>0&&t.length>0?yield z(this.model.base,t,r,e):t})}findOne(){return l(this,arguments,function*(t={},e={},r={},n){try{const c=V.normalizeMongoFilter(t),o=this.model.findOne(c,e,r),u=this.getDynamicVirtuals(),i=I(n,u);i&&o.populate(i);const a=yield o.exec();return a?{success:!0,result:yield this.populateDynamicVirtualsForDocument(a,n)}:{success:!1,message:`No ${this.getModelName()} found.`,code:D.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(c){return d.catchError(c)}})}findAll(){return l(this,arguments,function*(t={},e={},r={},n){try{const c=V.normalizeMongoFilter(t),o=this.model.find(c,e,r),u=this.getDynamicVirtuals(),i=I(n,u);i&&o.populate(i);const a=yield o.exec();return{success:!0,result:yield this.populateDynamicVirtualsForDocuments(a,n)}}catch(c){return d.catchError(c)}})}findPaging(){return l(this,arguments,function*(t={},e={}){try{const r=V.normalizeMongoFilter(t),n=this.getDynamicVirtuals(),c=O({},e);e.populate&&(c.populate=I(e.populate,n));const o=yield this.model.paginate(r,c),u=yield this.populateDynamicVirtualsForDocuments(o.docs,e.populate);return{success:!0,result:P(O({},o),{docs:u})}}catch(r){return d.catchError(r)}})}findPagingAggregate(t){return l(this,arguments,function*(e,r={}){try{const n=this.getDynamicVirtuals(),c=O({},r);r.populate&&(c.populate=I(r.populate,n));const o=yield this.model.aggregatePaginate(this.model.aggregate(e),c),u=yield this.populateDynamicVirtualsForDocuments(o.docs,r.populate);return{success:!0,result:P(O({},o),{docs:u})}}catch(n){return d.catchError(n)}})}count(){return l(this,arguments,function*(t={}){try{const e=V.normalizeMongoFilter(t);return{success:!0,result:yield this.model.countDocuments(e)}}catch(e){return d.catchError(e)}})}createOne(t){return l(this,null,function*(){try{return{success:!0,result:yield this.model.create(t)}}catch(e){return d.catchError(e)}})}createMany(t){return l(this,arguments,function*(e,r={}){try{return{success:!0,result:(yield this.model.insertMany(e,r)).map(o=>o instanceof K.Document?o.toObject():null).filter(o=>o!==null)}}catch(n){return d.catchError(n)}})}updateOne(){return l(this,arguments,function*(t={},e={},r={}){try{const n=V.normalizeMongoFilter(t),c=yield this.model.findOneAndUpdate(n,e,O({new:!0},r)).exec();return c?{success:!0,result:c}:{success:!1,message:`Failed to update ${this.getModelName()}.`,code:D.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(n){return d.catchError(n)}})}updateMany(){return l(this,arguments,function*(t={},e={},r={}){try{const n=V.normalizeMongoFilter(t);return{success:!0,result:yield this.model.updateMany(n,e,r).exec()}}catch(n){return d.catchError(n)}})}deleteOne(){return l(this,arguments,function*(t={},e={}){try{const r=V.normalizeMongoFilter(t),n=yield this.model.findOneAndDelete(r,e).exec();return n?{success:!0,result:n}:{success:!1,message:`No ${this.getModelName()} found to delete.`,code:D.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(r){return d.catchError(r)}})}deleteMany(){return l(this,arguments,function*(t={},e={}){try{const r=V.normalizeMongoFilter(t),n=yield this.model.deleteMany(r,e).exec();return n.deletedCount===0?{success:!1,message:"No documents found to delete.",code:D.RESPONSE_STATUS.NOT_FOUND.CODE}:{success:!0,result:n}}catch(r){return d.catchError(r)}})}createShortId(t,e=4){return l(this,null,function*(){try{const n=Array.from({length:10},(u,i)=>j.generateShortId(t,i+e)),o=(yield Promise.all(n.map(u=>this.model.exists({shortId:u})))).findIndex(u=>!u);if(o!==-1){const u=n[o];if(u)return{success:!0,result:u}}return{success:!1,message:"Failed to create a unique shortId",code:D.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}}catch(r){return d.catchError(r)}})}createSlugQuery({slug:t,field:e,isObject:r,haveHistory:n=!1,filter:c}){const o=O({},c!=null?c:{});return r?P(O({},o),{$or:[{[`slug.${e}`]:t},...n?[{slugHistory:{$elemMatch:{[`slug.${e}`]:t}}}]:[]]}):P(O({},o),{$or:[{slug:t},...n?[{slugHistory:t}]:[]]})}createUniqueSlug(t){return l(this,arguments,function*({slug:e,field:r,isObject:n,haveHistory:c,filter:o}){if(!e||typeof e!="string")throw new Error("Invalid slug provided: must be a non-empty string");const u=j.generateSlug(e);if(!(yield this.model.exists(this.createSlugQuery({slug:u,field:r,isObject:n,haveHistory:c,filter:o}))))return u;for(let S=1;S<=H.MONGO_SLUG_MAX_ATTEMPTS;S++){const h=`${u}-${S}`;if(!(yield this.model.exists(this.createSlugQuery({slug:h,field:r,isObject:n,haveHistory:c,filter:o}))))return h}const a=Date.now(),f=Math.random().toString(36).substring(2,8);return`${u}-${a}-${f}`})}createSlug(t){return l(this,arguments,function*({field:e,from:r,filter:n,haveHistory:c}){try{const o=r[e];return q.isObject(o)?{success:!0,result:Object.fromEntries(yield Promise.all(Object.entries(o).map(f=>l(this,[f],function*([S,h]){const y=yield this.createUniqueSlug({slug:h,field:S,isObject:!0,haveHistory:c,filter:n});return[S,y]}))))}:{success:!0,result:yield this.createUniqueSlug({slug:o,field:e,isObject:!1,haveHistory:c,filter:n})}}catch(o){return d.catchError(o)}})}checkSlug(t){return l(this,arguments,function*({slug:e,field:r,from:n,filter:c,haveHistory:o}){try{const u=n[r];if(q.isObject(u)){const h=Object.values(u).map(N=>j.generateSlug(N));return(yield Promise.all(h.map(N=>this.model.exists(this.createSlugQuery({slug:N,field:r,isObject:!0,haveHistory:o,filter:c}))))).some(N=>N)?{success:!0,result:!0}:{success:!0,result:!1}}const a=j.generateSlug(e);return{success:!0,result:(yield this.model.exists(this.createSlugQuery({slug:a,field:r,isObject:!1,filter:c})))!==null}}catch(u){return d.catchError(u)}})}aggregate(t){return l(this,null,function*(){try{return{success:!0,result:yield this.model.aggregate(t)}}catch(e){return d.catchError(e)}})}distinct(t){return l(this,arguments,function*(e,r={},n={}){try{return{success:!0,result:yield this.model.distinct(e,r,n)}}catch(c){return d.catchError(c)}})}}exports.MongoController=oe;exports.MongooseController=ue;exports.mongo=M;
+`;P.pathExistsSync(A.PATH.GIT_IGNORE)?P.readFileSync(A.PATH.GIT_IGNORE,"utf-8").split(`
+`).includes(A.MIGRATE_MONGO_CONFIG)||P.appendFileSync(A.PATH.GIT_IGNORE,e):P.writeFileSync(A.PATH.GIT_IGNORE,e)}}),regexify(s,t){if(!s)return{};let e=$.cloneDeep(s);if(!t||t.length===0)return e;for(const r of t){const n=r.toString().split("."),c=b.getNestedValue(e,n);if(typeof c=="string"&&c.length>0){const o={$regex:`.*${k.regexSearchMapper(c)}.*`,$options:"i"};e=b.setNestedValue(e,n,o)}}return e},isDynamicVirtual(s){return!!(s&&typeof s.ref=="function")},getNewRecords(s,t,e){return l(this,null,function*(){const r=yield s.findAll({});return r.success?t.filter(c=>!r.result.some(o=>e(o,c))):t})},getExistingRecords(s,t,e){return l(this,null,function*(){const r=yield s.findAll({});return r.success?r.result.filter(c=>t.some(o=>e(c,o))):[]})}};function q(s,t){if(!s||!t||t.length===0)return s;const e=new Set(t.map(r=>r.name));if(Array.isArray(s)){const r=s.filter(n=>{if(typeof n=="string")return!e.has(n);if(typeof n=="object"&&n!==null){const c=n;return!e.has(c.path||c.populate||"")}return!0});return r.length>0?r:void 0}if(typeof s=="string")return e.has(s)?void 0:s;if(typeof s=="object"&&s!==null){const r=s,n=r.path||r.populate||"";return e.has(n)?void 0:s}return s}function se(s,t,e){if(!s.length||!t||!(e!=null&&e.ref))return[];const r=new Map;return s.forEach(n=>{try{const c=e.ref(n);if(c==null)return;const o=typeof c=="string"?c:String(c);if(o&&o.trim()!==""){const u=ne(o);r.has(u)||r.set(u,[]),r.get(u).push(n)}}catch(c){d.catchError(new Error(`Dynamic ref function failed for virtual "${t}": ${c instanceof Error?c.message:String(c)}`))}}),Array.from(r.entries()).map(([n,c])=>({model:n,docs:c}))}function L(s,t,e,r,n){return l(this,null,function*(){if(!t.length||!e.length||!r)return t;const c=e.filter(i=>{if(Array.isArray(r))return r.length>0&&r.some(a=>typeof a=="string"?a===i.name:a.path===i.name);if(typeof r=="string")return r===i.name;if(typeof r=="object"&&r!==null){const a=r;return a.path&&a.path===i.name||a.populate&&a.populate===i.name}return!1});if(c.length===0)return t;const o=$.cloneDeep(t);o.forEach(i=>{c.forEach(({name:a,options:f})=>{a in i||(i[a]=f.count?0:f.justOne?null:[])})});const u=new Map;for(const i of c){const{name:a,options:f}=i,m=se(o,a,f);for(const h of m){u.has(h.model)||u.set(h.model,{virtuals:[],localValueSets:new Map,docsByLocalValue:new Map});const E=u.get(h.model);E.virtuals.find(V=>V.name===a)||(E.virtuals.push(i),E.localValueSets.set(a,new Set));const N=E.localValueSets.get(a);h.docs.forEach(V=>{const C=V[f.localField];if(C!=null){const _=String(C);N.add(_);let D=-1;const v=V;v.id!==void 0?D=o.findIndex(F=>F.id===v.id):v._id!==void 0&&(D=o.findIndex(F=>{var S,g,p,y;return((g=(S=F._id)==null?void 0:S.toString)==null?void 0:g.call(S))===((y=(p=v._id)==null?void 0:p.toString)==null?void 0:y.call(p))})),D!==-1&&(E.docsByLocalValue.has(_)||E.docsByLocalValue.set(_,[]),E.docsByLocalValue.get(_).push(D))}})}}return yield Promise.all(Array.from(u.entries()).map(i=>l(null,[i],function*([a,f]){const m=s.models[a];if(!m)return;const h=new Set;if(f.localValueSets.forEach(_=>{_.forEach(D=>h.add(D))}),h.size===0)return;const E=[...new Set(f.virtuals.map(_=>_.options.foreignField))],N=Array.from(h);let V;E.length===1?V={[String(E[0])]:{$in:N}}:V={$or:E.map(_=>({[_]:{$in:N}}))};const C=yield m.find(V,n).lean();for(const _ of f.virtuals){const{name:D,options:v}=_,F=C.filter(S=>{const g=S[v.foreignField];return g!=null&&h.has(String(g))});if(v.count){const S=new Map;F.forEach(g=>{var p;const y=(p=g[v.foreignField])==null?void 0:p.toString();y&&S.set(y,(S.get(y)||0)+1)}),f.localValueSets.get(D).forEach(g=>{const p=f.docsByLocalValue.get(g)||[],y=S.get(g)||0;p.forEach(w=>{const j=o[w];j[D]===void 0&&(j[D]=y)})})}else{const S=new Map;F.forEach(g=>{var p;const y=(p=g[v.foreignField])==null?void 0:p.toString();y&&(S.has(y)||S.set(y,[]),S.get(y).push(g))}),f.localValueSets.get(D).forEach(g=>{const p=f.docsByLocalValue.get(g)||[],y=S.get(g)||[],w=v.justOne?y[0]||null:y;p.forEach(j=>{const B=o[j];B[D]=w})})}}}))),o})}class ce{constructor(t,e){re(this,"collection"),this.collection=t.collection(e)}createOne(t){return l(this,null,function*(){try{const e=O(O({},M.createGenericFields()),t);return(yield this.collection.insertOne(e)).acknowledged?{success:!0,message:"Document created successfully",result:e}:{success:!1,message:"Document creation failed",code:R.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}}catch(e){return d.catchError(e)}})}createMany(t){return l(this,null,function*(){try{const e=t.map(n=>O(O({},M.createGenericFields()),n)),r=yield this.collection.insertMany(e);return r.insertedCount===0?{success:!1,message:"No documents were inserted",code:R.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:`${r.insertedCount} documents created successfully`,result:e}}catch(e){return d.catchError(e)}})}findOne(t){return l(this,null,function*(){try{const e=yield this.collection.findOne(t);return e?{success:!0,message:"Document found",result:e}:{success:!1,message:"Document not found",code:R.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(e){return d.catchError(e)}})}findAll(){return l(this,arguments,function*(t={}){try{return{success:!0,message:"Documents retrieved successfully",result:yield this.collection.find(t).toArray()}}catch(e){return d.catchError(e)}})}count(){return l(this,arguments,function*(t={}){try{const e=yield this.collection.countDocuments(t);return{success:!0,message:`${e} documents counted successfully`,result:e}}catch(e){return d.catchError(e)}})}updateOne(t,e){return l(this,null,function*(){try{const r=yield this.collection.updateOne(t,{$set:e});return r.matchedCount===0?{success:!1,message:"No documents matched the filter",code:R.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:"Document updated successfully",result:r}}catch(r){return d.catchError(r)}})}updateMany(t,e){return l(this,null,function*(){try{const r=yield this.collection.updateMany(t,{$set:e});return r.matchedCount===0?{success:!1,message:"No documents matched the filter",code:R.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:"Documents updated successfully",result:r}}catch(r){return d.catchError(r)}})}deleteOne(t){return l(this,null,function*(){try{const e=yield this.collection.deleteOne(t);return e.deletedCount===0?{success:!1,message:"No documents matched the filter",code:R.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:"Document deleted successfully",result:e}}catch(e){return d.catchError(e)}})}deleteMany(t){return l(this,null,function*(){try{const e=yield this.collection.deleteMany(t);return e.deletedCount===0?{success:!1,message:"No documents matched the filter",code:R.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}:{success:!0,message:"Documents deleted successfully",result:e}}catch(e){return d.catchError(e)}})}}class oe{constructor(t){this.model=t}getModelName(){return this.model.modelName}getDynamicVirtuals(){return this.model.schema.statics._dynamicVirtuals}populateDynamicVirtualsForDocument(t,e){return l(this,null,function*(){const r=this.getDynamicVirtuals();if(r&&r.length>0){const n=yield L(this.model.base,[t],r,e);return n&&n[0]?n[0]:t}return t})}populateDynamicVirtualsForDocuments(t,e){return l(this,null,function*(){const r=this.getDynamicVirtuals();return r&&r.length>0&&t.length>0?yield L(this.model.base,t,r,e):t})}findOne(){return l(this,arguments,function*(t={},e={},r={},n){try{const c=b.normalizeMongoFilter(t),o=this.model.findOne(c,e,r),u=this.getDynamicVirtuals(),i=q(n,u);i&&o.populate(i);const a=yield o.exec().then(m=>m instanceof T.C_Document?m.toObject():m);return a?{success:!0,result:yield this.populateDynamicVirtualsForDocument(a,n)}:{success:!1,message:`No ${this.getModelName()} found.`,code:R.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(c){return d.catchError(c)}})}findAll(){return l(this,arguments,function*(t={},e={},r={},n){try{const c=b.normalizeMongoFilter(t),o=this.model.find(c,e,r),u=this.getDynamicVirtuals(),i=q(n,u);i&&o.populate(i);const a=yield o.exec().then(m=>m==null?void 0:m.map(h=>h instanceof T.C_Document?h.toObject():h));return{success:!0,result:yield this.populateDynamicVirtualsForDocuments(a,n)}}catch(c){return d.catchError(c)}})}findPaging(){return l(this,arguments,function*(t={},e={}){try{const r=b.normalizeMongoFilter(t),n=this.getDynamicVirtuals(),c=O({},e);e.populate&&(c.populate=q(e.populate,n));const o=yield this.model.paginate(r,c),u=yield this.populateDynamicVirtualsForDocuments(o.docs.map(i=>i instanceof T.C_Document?i.toObject():i),e.populate);return{success:!0,result:x(O({},o),{docs:u})}}catch(r){return d.catchError(r)}})}findPagingAggregate(t){return l(this,arguments,function*(e,r={}){try{const n=this.getDynamicVirtuals(),c=O({},r);r.populate&&(c.populate=q(r.populate,n));const o=yield this.model.aggregatePaginate(this.model.aggregate(e),c),u=yield this.populateDynamicVirtualsForDocuments(o.docs.map(i=>i instanceof T.C_Document?i.toObject():i),r.populate);return{success:!0,result:x(O({},o),{docs:u})}}catch(n){return d.catchError(n)}})}count(){return l(this,arguments,function*(t={}){try{const e=b.normalizeMongoFilter(t);return{success:!0,result:yield this.model.countDocuments(e)}}catch(e){return d.catchError(e)}})}createOne(t){return l(this,null,function*(){try{return{success:!0,result:yield this.model.create(t).then(r=>r instanceof T.C_Document?r.toObject():r)}}catch(e){return d.catchError(e)}})}createMany(t){return l(this,arguments,function*(e,r={}){try{return{success:!0,result:yield this.model.insertMany(e,r).then(c=>c.map(o=>o instanceof T.C_Document?o.toObject():o))}}catch(n){return d.catchError(n)}})}updateOne(){return l(this,arguments,function*(t={},e={},r={}){try{const n=b.normalizeMongoFilter(t),c=yield this.model.findOneAndUpdate(n,e,O({new:!0},r)).exec().then(o=>o instanceof T.C_Document?o.toObject():o);return c?{success:!0,result:c}:{success:!1,message:`Failed to update ${this.getModelName()}.`,code:R.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(n){return d.catchError(n)}})}updateMany(){return l(this,arguments,function*(t={},e={},r={}){try{const n=b.normalizeMongoFilter(t);return{success:!0,result:yield this.model.updateMany(n,e,r).exec()}}catch(n){return d.catchError(n)}})}deleteOne(){return l(this,arguments,function*(t={},e={}){try{const r=b.normalizeMongoFilter(t),n=yield this.model.findOneAndDelete(r,e).exec().then(c=>c instanceof T.C_Document?c.toObject():c);return n?{success:!0,result:n}:{success:!1,message:`No ${this.getModelName()} found to delete.`,code:R.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(r){return d.catchError(r)}})}deleteMany(){return l(this,arguments,function*(t={},e={}){try{const r=b.normalizeMongoFilter(t),n=yield this.model.deleteMany(r,e).exec();return n.deletedCount===0?{success:!1,message:"No documents found to delete.",code:R.RESPONSE_STATUS.NOT_FOUND.CODE}:{success:!0,result:n}}catch(r){return d.catchError(r)}})}createShortId(t,e=4){return l(this,null,function*(){try{const n=Array.from({length:10},(u,i)=>I.generateShortId(t,i+e)),o=(yield Promise.all(n.map(u=>this.model.exists({shortId:u})))).findIndex(u=>!u);if(o!==-1){const u=n[o];if(u)return{success:!0,result:u}}return{success:!1,message:"Failed to create a unique shortId",code:R.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}}catch(r){return d.catchError(r)}})}createSlugQuery({slug:t,field:e,isObject:r,haveHistory:n=!1,filter:c}){const o=O({},c!=null?c:{});return r?x(O({},o),{$or:[{[`slug.${e}`]:t},...n?[{slugHistory:{$elemMatch:{[`slug.${e}`]:t}}}]:[]]}):x(O({},o),{$or:[{slug:t},...n?[{slugHistory:t}]:[]]})}createUniqueSlug(t){return l(this,arguments,function*({slug:e,field:r,isObject:n,haveHistory:c,filter:o}){if(!e||typeof e!="string")throw new Error("Invalid slug provided: must be a non-empty string");const u=I.generateSlug(e);if(!(yield this.model.exists(this.createSlugQuery({slug:u,field:r,isObject:n,haveHistory:c,filter:o}))))return u;for(let m=1;m<=H.MONGO_SLUG_MAX_ATTEMPTS;m++){const h=`${u}-${m}`;if(!(yield this.model.exists(this.createSlugQuery({slug:h,field:r,isObject:n,haveHistory:c,filter:o}))))return h}const a=Date.now(),f=Math.random().toString(36).substring(2,8);return`${u}-${a}-${f}`})}createSlug(t){return l(this,arguments,function*({field:e,from:r,filter:n,haveHistory:c}){try{const o=r[e];return $.isObject(o)?{success:!0,result:Object.fromEntries(yield Promise.all(Object.entries(o).map(f=>l(this,[f],function*([m,h]){const E=yield this.createUniqueSlug({slug:h,field:m,isObject:!0,haveHistory:c,filter:n});return[m,E]}))))}:{success:!0,result:yield this.createUniqueSlug({slug:o,field:e,isObject:!1,haveHistory:c,filter:n})}}catch(o){return d.catchError(o)}})}checkSlug(t){return l(this,arguments,function*({slug:e,field:r,from:n,filter:c,haveHistory:o}){try{const u=n[r];if($.isObject(u)){const h=Object.values(u).map(N=>I.generateSlug(N));return(yield Promise.all(h.map(N=>this.model.exists(this.createSlugQuery({slug:N,field:r,isObject:!0,haveHistory:o,filter:c}))))).some(N=>N)?{success:!0,result:!0}:{success:!0,result:!1}}const a=I.generateSlug(e);return{success:!0,result:(yield this.model.exists(this.createSlugQuery({slug:a,field:r,isObject:!1,filter:c})))!==null}}catch(u){return d.catchError(u)}})}aggregate(t){return l(this,null,function*(){try{return{success:!0,result:yield this.model.aggregate(t)}}catch(e){return d.catchError(e)}})}distinct(t){return l(this,arguments,function*(e,r={},n={}){try{return{success:!0,result:yield this.model.distinct(e,r,n)}}catch(c){return d.catchError(c)}})}}exports.MongoController=ce;exports.MongooseController=oe;exports.mongo=M;

package/dist/node/mongo/mongo.util.d.ts

@@ -1,7 +1,7 @@
 import { default as mongooseRaw } from 'mongoose';
 import { default as migrate } from 'migrate-mongo';
 import { I_Return } from '../../typescript/index.js';
-import { C_Db, C_Document, I_CreateModelOptions, I_CreateSchemaOptions, I_DeleteOptionsExtended, I_DynamicVirtualOptions, I_ExtendedModel, I_GenericDocument, I_Input_CheckSlug, I_Input_CreateSlug, I_Input_GenerateSlug, I_MongooseModelMiddleware, I_PaginateOptionsWithPopulate, I_UpdateOptionsExtended, T_AggregatePaginateResult, T_DeleteResult, T_Filter, T_FilterQuery, T_Input_Populate, T_InsertManyOptions, T_MongoosePlugin, T_MongooseShema, T_PaginateResult, T_PipelineStage, T_ProjectionType, T_QueryOptions, T_UpdateQuery, T_UpdateResult, T_VirtualOptions, T_WithId } from './mongo.type.js';
+import { C_Db, I_CreateModelOptions, I_CreateSchemaOptions, I_DeleteOptionsExtended, I_DynamicVirtualOptions, I_ExtendedModel, I_GenericDocument, I_Input_CheckSlug, I_Input_CreateSlug, I_Input_GenerateSlug, I_MongooseModelMiddleware, I_PaginateOptionsWithPopulate, I_UpdateOptionsExtended, T_AggregatePaginateResult, T_DeleteResult, T_Filter, T_FilterQuery, T_Input_Populate, T_InsertManyOptions, T_MongoosePlugin, T_MongooseShema, T_PaginateResult, T_PipelineStage, T_ProjectionType, T_QueryOptions, T_UpdateQuery, T_UpdateResult, T_VirtualOptions, T_WithId, C_Document } from './mongo.type.js';
 /**
  * MongoDB utility object providing comprehensive database operations and utilities.
  * This object contains methods for creating generic fields, applying plugins and middlewares,
@@ -412,6 +412,7 @@ export declare class MongooseController<T extends Partial<C_Document>> {
      * @param options.slug - The slug string to check for existence.
      * @param options.field - The field name for object-based slug checking.
      * @param options.isObject - Whether the slug is stored as an object with nested fields.
+     * @param options.haveHistory - Whether to check historical slug fields for existence.
      * @param options.filter - Additional filter conditions to apply to the query.
      * @returns A MongoDB query object for checking slug existence.
      */
@@ -579,6 +580,7 @@ export declare class MongooseController<T extends Partial<C_Document>> {
      * @param options.slug - The base slug string to make unique.
      * @param options.field - The field name for object-based slug checking.
      * @param options.isObject - Whether the slug is stored as an object with nested fields.
+     * @param options.haveHistory - Whether to check historical slug fields for uniqueness.
      * @param options.filter - Additional filter conditions to apply when checking slug existence.
      * @returns A promise that resolves to a unique slug string.
      */
@@ -590,6 +592,7 @@ export declare class MongooseController<T extends Partial<C_Document>> {
      * @param options - Configuration for slug creation including field, source document, and filter.
      * @param options.field - The field name to create a slug for.
      * @param options.from - The source document containing the field value.
+     * @param options.haveHistory - Whether to check historical slug fields for uniqueness.
      * @param options.filter - Additional filter conditions to apply when checking slug existence.
      * @returns A promise that resolves to a standardized response with the created slug(s).
      */
@@ -602,6 +605,7 @@ export declare class MongooseController<T extends Partial<C_Document>> {
      * @param options.slug - The slug string to check for existence.
      * @param options.field - The field name for object-based slug checking.
      * @param options.from - The source document containing the field value.
+     * @param options.haveHistory - Whether to check historical slug fields for existence.
      * @param options.filter - Additional filter conditions to apply to the query.
      * @returns A promise that resolves to a standardized response indicating whether the slug exists.
      */

package/dist/node/mongo/mongo.util.js

@@ -1,45 +1,45 @@
-import { cloneDeep as B, isObject as $ } from "lodash-es";
-import Q from "migrate-mongo";
-import { Document as W } from "mongoose";
+import { cloneDeep as K, isObject as G } from "lodash-es";
+import W from "migrate-mongo";
 import k from "mongoose-aggregate-paginate-v2";
 import J from "mongoose-paginate-v2";
-import { v4 as G } from "uuid";
+import { v4 as q } from "uuid";
 import { MONGO_SLUG_MAX_ATTEMPTS as X } from "./mongo.constant.js";
-import { getNestedValue as H, setNestedValue as Y, normalizeMongoFilter as b } from "../../util/object/object.util.js";
+import { C_Document as b } from "./mongo.type.js";
+import { getNestedValue as H, setNestedValue as Y, normalizeMongoFilter as x } from "../../util/object/object.util.js";
 import { regexSearchMapper as Z } from "../../util/common/common.util.js";
-import { writeFileSync as q, pathExistsSync as ee, readFileSync as te, appendFileSync as re } from "../fs/fs.util.js";
-import { PATH as w, MIGRATE_MONGO_CONFIG as L } from "../path/path.constant.js";
+import { writeFileSync as L, pathExistsSync as ee, readFileSync as te, appendFileSync as re } from "../fs/fs.util.js";
+import { PATH as M, MIGRATE_MONGO_CONFIG as U } from "../path/path.constant.js";
 import { validate as se } from "../../util/validate/validate.util.js";
-import { generateShortId as ne, generateSlug as I } from "../../util/string/string.util.js";
+import { generateShortId as ne, generateSlug as $ } from "../../util/string/string.util.js";
 import { RESPONSE_STATUS as R } from "../../constant/response-status.js";
 import { catchError as d } from "../log/log.util.js";
-var ue = Object.defineProperty, ce = Object.defineProperties, ie = Object.getOwnPropertyDescriptors, U = Object.getOwnPropertySymbols, oe = Object.prototype.hasOwnProperty, le = Object.prototype.propertyIsEnumerable, T = (n, t, e) => t in n ? ue(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e, S = (n, t) => {
+var ce = Object.defineProperty, ue = Object.defineProperties, oe = Object.getOwnPropertyDescriptors, z = Object.getOwnPropertySymbols, ie = Object.prototype.hasOwnProperty, le = Object.prototype.propertyIsEnumerable, T = (n, t, e) => t in n ? ce(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e, S = (n, t) => {
   for (var e in t || (t = {}))
-    oe.call(t, e) && T(n, e, t[e]);
-  if (U)
-    for (var e of U(t))
+    ie.call(t, e) && T(n, e, t[e]);
+  if (z)
+    for (var e of z(t))
       le.call(t, e) && T(n, e, t[e]);
   return n;
-}, F = (n, t) => ce(n, ie(t)), ae = (n, t, e) => T(n, typeof t != "symbol" ? t + "" : t, e), l = (n, t, e) => new Promise((r, s) => {
-  var u = (o) => {
+}, j = (n, t) => ue(n, oe(t)), ae = (n, t, e) => T(n, typeof t != "symbol" ? t + "" : t, e), l = (n, t, e) => new Promise((r, s) => {
+  var c = (i) => {
     try {
-      i(e.next(o));
+      o(e.next(i));
     } catch (a) {
       s(a);
     }
-  }, c = (o) => {
+  }, u = (i) => {
     try {
-      i(e.throw(o));
+      o(e.throw(i));
     } catch (a) {
       s(a);
     }
-  }, i = (o) => o.done ? r(o.value) : Promise.resolve(o.value).then(u, c);
-  i((e = e.apply(n, t)).next());
+  }, o = (i) => i.done ? r(i.value) : Promise.resolve(i.value).then(c, u);
+  o((e = e.apply(n, t)).next());
 });
 function de(n) {
   return n === n.toUpperCase() ? n.charAt(0).toUpperCase() + n.slice(1).toLowerCase() : n;
 }
-const x = {
+const w = {
   /**
    * Creates generic fields that are commonly used across MongoDB documents.
    * This function generates standard fields including a UUID, deletion flag, and timestamps
@@ -49,7 +49,7 @@ const x = {
    */
   createGenericFields() {
     return {
-      id: G(),
+      id: q(),
       isDel: !1,
       createdAt: /* @__PURE__ */ new Date(),
       updatedAt: /* @__PURE__ */ new Date()
@@ -89,7 +89,7 @@ const x = {
   createGenericSchema(n) {
     return new n.Schema(
       {
-        id: { type: String, default: G, unique: !0 },
+        id: { type: String, default: q, unique: !0 },
         isDel: { type: Boolean, default: !1 }
       },
       { timestamps: !0 }
@@ -119,23 +119,23 @@ const x = {
       toObject: { virtuals: !0 }
       // So `console.log()` and other functions that use `toObject()` include virtuals
     });
-    return e.forEach(({ name: u, options: c, get: i }) => {
-      if (x.isDynamicVirtual(c)) {
-        const o = s.statics;
-        o._dynamicVirtuals || (o._dynamicVirtuals = []), o._dynamicVirtuals.push({
-          name: u,
-          options: c
+    return e.forEach(({ name: c, options: u, get: o }) => {
+      if (w.isDynamicVirtual(u)) {
+        const i = s.statics;
+        i._dynamicVirtuals || (i._dynamicVirtuals = []), i._dynamicVirtuals.push({
+          name: c,
+          options: u
         });
-        const a = s.virtual(u);
-        i ? a.get(i) : a.get(function() {
+        const a = s.virtual(c);
+        o ? a.get(o) : a.get(function() {
           var f;
-          return ((f = this._populated) == null ? void 0 : f[u]) || (c != null && c.count ? 0 : c != null && c.justOne ? null : []);
+          return ((f = this._populated) == null ? void 0 : f[c]) || (u != null && u.count ? 0 : u != null && u.justOne ? null : []);
         });
       } else {
-        const o = s.virtual(u, c);
-        i && o.get(i);
+        const i = s.virtual(c, u);
+        o && i.get(o);
       }
-    }), r || s.add(x.createGenericSchema(n)), s;
+    }), r || s.add(w.createGenericSchema(n)), s;
   },
   /**
    * Creates a Mongoose model with plugins, middleware, and pagination support.
@@ -159,18 +159,18 @@ const x = {
     schema: e,
     virtuals: r = [],
     pagination: s = !0,
-    aggregate: u = !0,
-    middlewares: c = []
+    aggregate: c = !0,
+    middlewares: u = []
   }) {
     if (!t)
       throw new Error("Model name is required.");
     if (n.models[t])
       return n.models[t];
-    const i = x.createSchema({ mongoose: n, schema: e, virtuals: r });
-    return (s || u) && x.applyPlugins(i, [
+    const o = w.createSchema({ mongoose: n, schema: e, virtuals: r });
+    return (s || c) && w.applyPlugins(o, [
       s && J,
-      u && k
-    ]), x.applyMiddlewares(i, c), n.model(t, i);
+      c && k
+    ]), w.applyMiddlewares(o, u), n.model(t, o);
   },
   /**
    * Validation utilities for Mongoose schemas.
@@ -233,7 +233,7 @@ const x = {
    * Migration utilities for MongoDB.
    * This object extends the migrate-mongo library with additional configuration utilities.
    */
-  migrate: F(S({}, Q), {
+  migrate: j(S({}, W), {
     /**
      * Sets the migration configuration and updates .gitignore.
      * This function creates a migration configuration file and ensures it's properly
@@ -244,12 +244,12 @@ const x = {
     setConfig: (n) => {
       const t = `// This file is automatically generated by the Cyberskill CLI.
 module.exports = ${JSON.stringify(n, null, 4)}`;
-      q(w.MIGRATE_MONGO_CONFIG, t);
+      L(M.MIGRATE_MONGO_CONFIG, t);
       const e = `
-${L}
+${U}
 `;
-      ee(w.GIT_IGNORE) ? te(w.GIT_IGNORE, "utf-8").split(`
-`).includes(L) || re(w.GIT_IGNORE, e) : q(w.GIT_IGNORE, e);
+      ee(M.GIT_IGNORE) ? te(M.GIT_IGNORE, "utf-8").split(`
+`).includes(U) || re(M.GIT_IGNORE, e) : L(M.GIT_IGNORE, e);
     }
   }),
   /**
@@ -264,17 +264,17 @@ ${L}
   regexify(n, t) {
     if (!n)
       return {};
-    let e = B(n);
+    let e = K(n);
     if (!t || t.length === 0)
       return e;
     for (const r of t) {
-      const s = r.toString().split("."), u = H(e, s);
-      if (typeof u == "string" && u.length > 0) {
-        const c = {
-          $regex: `.*${Z(u)}.*`,
+      const s = r.toString().split("."), c = H(e, s);
+      if (typeof c == "string" && c.length > 0) {
+        const u = {
+          $regex: `.*${Z(c)}.*`,
           $options: "i"
         };
-        e = Y(e, s, c);
+        e = Y(e, s, u);
       }
     }
     return e;
@@ -299,8 +299,8 @@ ${L}
     return l(this, null, function* () {
       const r = yield n.findAll({});
       return r.success ? t.filter(
-        (u) => !r.result.some(
-          (c) => e(c, u)
+        (c) => !r.result.some(
+          (u) => e(u, c)
         )
       ) : t;
     });
@@ -316,17 +316,14 @@ ${L}
     return l(this, null, function* () {
       const r = yield n.findAll({});
       return r.success ? r.result.filter(
-        (u) => t.some(
-          (c) => e(u, c)
+        (c) => t.some(
+          (u) => e(c, u)
         )
       ) : [];
     });
   }
 };
-function fe(n) {
-  return n !== null && typeof n == "object" && "toObject" in n && typeof n.toObject == "function";
-}
-function j(n, t) {
+function I(n, t) {
   if (!n || !t || t.length === 0)
     return n;
   const e = new Set(t.map((r) => r.name));
@@ -335,8 +332,8 @@ function j(n, t) {
       if (typeof s == "string")
         return !e.has(s);
       if (typeof s == "object" && s !== null) {
-        const u = s;
-        return !e.has(u.path || u.populate || "");
+        const c = s;
+        return !e.has(c.path || c.populate || "");
       }
       return !0;
     });
@@ -350,130 +347,125 @@ function j(n, t) {
   }
   return n;
 }
-function me(n, t, e) {
+function fe(n, t, e) {
   if (!n.length || !t || !(e != null && e.ref))
     return [];
   const r = /* @__PURE__ */ new Map();
   return n.forEach((s) => {
     try {
-      const u = e.ref(s);
-      if (u == null)
+      const c = e.ref(s);
+      if (c == null)
         return;
-      const c = typeof u == "string" ? u : String(u);
-      if (c && c.trim() !== "") {
-        const i = de(c);
-        r.has(i) || r.set(i, []), r.get(i).push(s);
+      const u = typeof c == "string" ? c : String(c);
+      if (u && u.trim() !== "") {
+        const o = de(u);
+        r.has(o) || r.set(o, []), r.get(o).push(s);
       }
-    } catch (u) {
-      d(new Error(`Dynamic ref function failed for virtual "${t}": ${u instanceof Error ? u.message : String(u)}`));
+    } catch (c) {
+      d(new Error(`Dynamic ref function failed for virtual "${t}": ${c instanceof Error ? c.message : String(c)}`));
     }
-  }), Array.from(r.entries()).map(([s, u]) => ({ model: s, docs: u }));
+  }), Array.from(r.entries()).map(([s, c]) => ({ model: s, docs: c }));
 }
-function z(n, t, e, r, s) {
+function B(n, t, e, r, s) {
   return l(this, null, function* () {
     if (!t.length || !e.length || !r)
       return t;
-    const u = e.filter((o) => {
+    const c = e.filter((i) => {
       if (Array.isArray(r))
-        return r.length > 0 && r.some((a) => typeof a == "string" ? a === o.name : a.path === o.name);
+        return r.length > 0 && r.some((a) => typeof a == "string" ? a === i.name : a.path === i.name);
       if (typeof r == "string")
-        return r === o.name;
+        return r === i.name;
       if (typeof r == "object" && r !== null) {
         const a = r;
-        return a.path && a.path === o.name || a.populate && a.populate === o.name;
+        return a.path && a.path === i.name || a.populate && a.populate === i.name;
       }
       return !1;
     });
-    if (u.length === 0)
+    if (c.length === 0)
       return t;
-    const c = B(t.map(
-      (o) => fe(o) ? o.toObject() : o
-    ));
-    c.forEach((o) => {
-      u.forEach(({ name: a, options: f }) => {
-        if (!(a in o)) {
-          const O = o;
-          O[a] = f.count ? 0 : f.justOne ? null : [];
-        }
+    const u = K(t);
+    u.forEach((i) => {
+      c.forEach(({ name: a, options: f }) => {
+        a in i || (i[a] = f.count ? 0 : f.justOne ? null : []);
       });
     });
-    const i = /* @__PURE__ */ new Map();
-    for (const o of u) {
-      const { name: a, options: f } = o, O = me(c, a, f);
-      for (const m of O) {
-        i.has(m.model) || i.set(m.model, {
+    const o = /* @__PURE__ */ new Map();
+    for (const i of c) {
+      const { name: a, options: f } = i, h = fe(u, a, f);
+      for (const m of h) {
+        o.has(m.model) || o.set(m.model, {
           virtuals: [],
           localValueSets: /* @__PURE__ */ new Map(),
           docsByLocalValue: /* @__PURE__ */ new Map()
         });
-        const g = i.get(m.model);
-        g.virtuals.find((V) => V.name === a) || (g.virtuals.push(o), g.localValueSets.set(a, /* @__PURE__ */ new Set()));
-        const v = g.localValueSets.get(a);
+        const p = o.get(m.model);
+        p.virtuals.find((V) => V.name === a) || (p.virtuals.push(i), p.localValueSets.set(a, /* @__PURE__ */ new Set()));
+        const v = p.localValueSets.get(a);
         m.docs.forEach((V) => {
           const A = V[f.localField];
           if (A != null) {
-            const D = String(A);
-            v.add(D);
-            let _ = -1;
+            const _ = String(A);
+            v.add(_);
+            let D = -1;
             const N = V;
-            N.id !== void 0 ? _ = c.findIndex((M) => M.id === N.id) : N._id !== void 0 && (_ = c.findIndex((M) => {
-              var p, h, E, y;
-              return ((h = (p = M._id) == null ? void 0 : p.toString) == null ? void 0 : h.call(p)) === ((y = (E = N._id) == null ? void 0 : E.toString) == null ? void 0 : y.call(E));
-            })), _ !== -1 && (g.docsByLocalValue.has(D) || g.docsByLocalValue.set(D, []), g.docsByLocalValue.get(D).push(_));
+            N.id !== void 0 ? D = u.findIndex((F) => F.id === N.id) : N._id !== void 0 && (D = u.findIndex((F) => {
+              var O, y, E, g;
+              return ((y = (O = F._id) == null ? void 0 : O.toString) == null ? void 0 : y.call(O)) === ((g = (E = N._id) == null ? void 0 : E.toString) == null ? void 0 : g.call(E));
+            })), D !== -1 && (p.docsByLocalValue.has(_) || p.docsByLocalValue.set(_, []), p.docsByLocalValue.get(_).push(D));
           }
         });
       }
     }
-    return yield Promise.all(Array.from(i.entries()).map((o) => l(null, [o], function* ([a, f]) {
-      const O = n.models[a];
-      if (!O)
+    return yield Promise.all(Array.from(o.entries()).map((i) => l(null, [i], function* ([a, f]) {
+      const h = n.models[a];
+      if (!h)
         return;
       const m = /* @__PURE__ */ new Set();
-      if (f.localValueSets.forEach((D) => {
-        D.forEach((_) => m.add(_));
+      if (f.localValueSets.forEach((_) => {
+        _.forEach((D) => m.add(D));
       }), m.size === 0)
         return;
-      const g = [...new Set(f.virtuals.map((D) => D.options.foreignField))], v = Array.from(m);
+      const p = [...new Set(f.virtuals.map((_) => _.options.foreignField))], v = Array.from(m);
       let V;
-      g.length === 1 ? V = { [String(g[0])]: { $in: v } } : V = { $or: g.map((D) => ({ [D]: { $in: v } })) };
-      const A = yield O.find(V, s).lean();
-      for (const D of f.virtuals) {
-        const { name: _, options: N } = D, M = A.filter((p) => {
-          const h = p[N.foreignField];
-          return h != null && m.has(String(h));
+      p.length === 1 ? V = { [String(p[0])]: { $in: v } } : V = { $or: p.map((_) => ({ [_]: { $in: v } })) };
+      const A = yield h.find(V, s).lean();
+      for (const _ of f.virtuals) {
+        const { name: D, options: N } = _, F = A.filter((O) => {
+          const y = O[N.foreignField];
+          return y != null && m.has(String(y));
         });
         if (N.count) {
-          const p = /* @__PURE__ */ new Map();
-          M.forEach((h) => {
+          const O = /* @__PURE__ */ new Map();
+          F.forEach((y) => {
             var E;
-            const y = (E = h[N.foreignField]) == null ? void 0 : E.toString();
-            y && p.set(y, (p.get(y) || 0) + 1);
-          }), f.localValueSets.get(_).forEach((h) => {
-            const E = f.docsByLocalValue.get(h) || [], y = p.get(h) || 0;
-            E.forEach((P) => {
-              const C = c[P];
-              C[_] === void 0 && (C[_] = y);
+            const g = (E = y[N.foreignField]) == null ? void 0 : E.toString();
+            g && O.set(g, (O.get(g) || 0) + 1);
+          }), f.localValueSets.get(D).forEach((y) => {
+            const E = f.docsByLocalValue.get(y) || [], g = O.get(y) || 0;
+            E.forEach((C) => {
+              const P = u[C];
+              P[D] === void 0 && (P[D] = g);
             });
           });
         } else {
-          const p = /* @__PURE__ */ new Map();
-          M.forEach((h) => {
+          const O = /* @__PURE__ */ new Map();
+          F.forEach((y) => {
             var E;
-            const y = (E = h[N.foreignField]) == null ? void 0 : E.toString();
-            y && (p.has(y) || p.set(y, []), p.get(y).push(h));
-          }), f.localValueSets.get(_).forEach((h) => {
-            const E = f.docsByLocalValue.get(h) || [], y = p.get(h) || [], P = N.justOne ? y[0] || null : y;
-            E.forEach((C) => {
-              const K = c[C];
-              K[_] = P;
+            const g = (E = y[N.foreignField]) == null ? void 0 : E.toString();
+            g && (O.has(g) || O.set(g, []), O.get(g).push(y));
+          }), f.localValueSets.get(D).forEach((y) => {
+            const E = f.docsByLocalValue.get(y) || [], g = O.get(y) || [], C = N.justOne ? g[0] || null : g;
+            E.forEach((P) => {
+              const Q = u[P];
+              Q[D] = C;
             });
           });
         }
       }
-    }))), c;
+    }))), u;
   });
 }
-class Me {
+class xe {
   /**
    * Creates a new MongoDB controller instance.
    *
@@ -493,7 +485,7 @@ class Me {
   createOne(t) {
     return l(this, null, function* () {
       try {
-        const e = S(S({}, x.createGenericFields()), t);
+        const e = S(S({}, w.createGenericFields()), t);
         return (yield this.collection.insertOne(e)).acknowledged ? {
           success: !0,
           message: "Document created successfully",
@@ -518,7 +510,7 @@ class Me {
   createMany(t) {
     return l(this, null, function* () {
       try {
-        const e = t.map((s) => S(S({}, x.createGenericFields()), s)), r = yield this.collection.insertMany(e);
+        const e = t.map((s) => S(S({}, w.createGenericFields()), s)), r = yield this.collection.insertMany(e);
         return r.insertedCount === 0 ? {
           success: !1,
           message: "No documents were inserted",
@@ -727,7 +719,7 @@ class we {
     return l(this, null, function* () {
       const r = this.getDynamicVirtuals();
       if (r && r.length > 0) {
-        const s = yield z(this.model.base, [t], r, e);
+        const s = yield B(this.model.base, [t], r, e);
         return s && s[0] ? s[0] : t;
       }
       return t;
@@ -743,7 +735,7 @@ class we {
   populateDynamicVirtualsForDocuments(t, e) {
     return l(this, null, function* () {
       const r = this.getDynamicVirtuals();
-      return r && r.length > 0 && t.length > 0 ? yield z(this.model.base, t, r, e) : t;
+      return r && r.length > 0 && t.length > 0 ? yield B(this.model.base, t, r, e) : t;
     });
   }
   /**
@@ -759,16 +751,16 @@ class we {
   findOne() {
     return l(this, arguments, function* (t = {}, e = {}, r = {}, s) {
       try {
-        const u = b(t), c = this.model.findOne(u, e, r), i = this.getDynamicVirtuals(), o = j(s, i);
-        o && c.populate(o);
-        const a = yield c.exec();
+        const c = x(t), u = this.model.findOne(c, e, r), o = this.getDynamicVirtuals(), i = I(s, o);
+        i && u.populate(i);
+        const a = yield u.exec().then((h) => h instanceof b ? h.toObject() : h);
         return a ? { success: !0, result: yield this.populateDynamicVirtualsForDocument(a, s) } : {
           success: !1,
           message: `No ${this.getModelName()} found.`,
           code: R.NOT_FOUND.CODE
         };
-      } catch (u) {
-        return d(u);
+      } catch (c) {
+        return d(c);
       }
     });
   }
@@ -785,12 +777,12 @@ class we {
   findAll() {
     return l(this, arguments, function* (t = {}, e = {}, r = {}, s) {
       try {
-        const u = b(t), c = this.model.find(u, e, r), i = this.getDynamicVirtuals(), o = j(s, i);
-        o && c.populate(o);
-        const a = yield c.exec();
+        const c = x(t), u = this.model.find(c, e, r), o = this.getDynamicVirtuals(), i = I(s, o);
+        i && u.populate(i);
+        const a = yield u.exec().then((h) => h == null ? void 0 : h.map((m) => m instanceof b ? m.toObject() : m));
         return { success: !0, result: yield this.populateDynamicVirtualsForDocuments(a, s) };
-      } catch (u) {
-        return d(u);
+      } catch (c) {
+        return d(c);
       }
     });
   }
@@ -805,10 +797,10 @@ class we {
   findPaging() {
     return l(this, arguments, function* (t = {}, e = {}) {
       try {
-        const r = b(t), s = this.getDynamicVirtuals(), u = S({}, e);
-        e.populate && (u.populate = j(e.populate, s));
-        const c = yield this.model.paginate(r, u), i = yield this.populateDynamicVirtualsForDocuments(c.docs, e.populate);
-        return { success: !0, result: F(S({}, c), { docs: i }) };
+        const r = x(t), s = this.getDynamicVirtuals(), c = S({}, e);
+        e.populate && (c.populate = I(e.populate, s));
+        const u = yield this.model.paginate(r, c), o = yield this.populateDynamicVirtualsForDocuments(u.docs.map((i) => i instanceof b ? i.toObject() : i), e.populate);
+        return { success: !0, result: j(S({}, u), { docs: o }) };
       } catch (r) {
         return d(r);
       }
@@ -824,13 +816,13 @@ class we {
   findPagingAggregate(t) {
     return l(this, arguments, function* (e, r = {}) {
       try {
-        const s = this.getDynamicVirtuals(), u = S({}, r);
-        r.populate && (u.populate = j(r.populate, s));
-        const c = yield this.model.aggregatePaginate(
+        const s = this.getDynamicVirtuals(), c = S({}, r);
+        r.populate && (c.populate = I(r.populate, s));
+        const u = yield this.model.aggregatePaginate(
           this.model.aggregate(e),
-          u
-        ), i = yield this.populateDynamicVirtualsForDocuments(c.docs, r.populate);
-        return { success: !0, result: F(S({}, c), { docs: i }) };
+          c
+        ), o = yield this.populateDynamicVirtualsForDocuments(u.docs.map((i) => i instanceof b ? i.toObject() : i), r.populate);
+        return { success: !0, result: j(S({}, u), { docs: o }) };
       } catch (s) {
         return d(s);
       }
@@ -845,7 +837,7 @@ class we {
   count() {
     return l(this, arguments, function* (t = {}) {
       try {
-        const e = b(t);
+        const e = x(t);
         return { success: !0, result: yield this.model.countDocuments(e) };
       } catch (e) {
         return d(e);
@@ -861,7 +853,7 @@ class we {
   createOne(t) {
     return l(this, null, function* () {
       try {
-        return { success: !0, result: yield this.model.create(t) };
+        return { success: !0, result: yield this.model.create(t).then((r) => r instanceof b ? r.toObject() : r) };
       } catch (e) {
         return d(e);
       }
@@ -877,7 +869,7 @@ class we {
   createMany(t) {
     return l(this, arguments, function* (e, r = {}) {
       try {
-        return { success: !0, result: (yield this.model.insertMany(e, r)).map((c) => c instanceof W ? c.toObject() : null).filter((c) => c !== null) };
+        return { success: !0, result: yield this.model.insertMany(e, r).then((c) => c.map((u) => u instanceof b ? u.toObject() : u)) };
       } catch (s) {
         return d(s);
       }
@@ -894,10 +886,10 @@ class we {
   updateOne() {
     return l(this, arguments, function* (t = {}, e = {}, r = {}) {
       try {
-        const s = b(t), u = yield this.model.findOneAndUpdate(s, e, S({
+        const s = x(t), c = yield this.model.findOneAndUpdate(s, e, S({
           new: !0
-        }, r)).exec();
-        return u ? { success: !0, result: u } : {
+        }, r)).exec().then((u) => u instanceof b ? u.toObject() : u);
+        return c ? { success: !0, result: c } : {
           success: !1,
           message: `Failed to update ${this.getModelName()}.`,
           code: R.NOT_FOUND.CODE
@@ -918,7 +910,7 @@ class we {
   updateMany() {
     return l(this, arguments, function* (t = {}, e = {}, r = {}) {
       try {
-        const s = b(t);
+        const s = x(t);
         return { success: !0, result: yield this.model.updateMany(s, e, r).exec() };
       } catch (s) {
         return d(s);
@@ -935,7 +927,7 @@ class we {
   deleteOne() {
     return l(this, arguments, function* (t = {}, e = {}) {
       try {
-        const r = b(t), s = yield this.model.findOneAndDelete(r, e).exec();
+        const r = x(t), s = yield this.model.findOneAndDelete(r, e).exec().then((c) => c instanceof b ? c.toObject() : c);
         return s ? { success: !0, result: s } : {
           success: !1,
           message: `No ${this.getModelName()} found to delete.`,
@@ -956,7 +948,7 @@ class we {
   deleteMany() {
     return l(this, arguments, function* (t = {}, e = {}) {
       try {
-        const r = b(t), s = yield this.model.deleteMany(r, e).exec();
+        const r = x(t), s = yield this.model.deleteMany(r, e).exec();
         return s.deletedCount === 0 ? {
           success: !1,
           message: "No documents found to delete.",
@@ -978,13 +970,13 @@ class we {
   createShortId(t, e = 4) {
     return l(this, null, function* () {
       try {
-        const s = Array.from({ length: 10 }, (i, o) => ne(t, o + e)), c = (yield Promise.all(
-          s.map((i) => this.model.exists({ shortId: i }))
-        )).findIndex((i) => !i);
-        if (c !== -1) {
-          const i = s[c];
-          if (i)
-            return { success: !0, result: i };
+        const s = Array.from({ length: 10 }, (o, i) => ne(t, i + e)), u = (yield Promise.all(
+          s.map((o) => this.model.exists({ shortId: o }))
+        )).findIndex((o) => !o);
+        if (u !== -1) {
+          const o = s[u];
+          if (o)
+            return { success: !0, result: o };
         }
         return {
           success: !1,
@@ -1004,17 +996,18 @@ class we {
    * @param options.slug - The slug string to check for existence.
    * @param options.field - The field name for object-based slug checking.
    * @param options.isObject - Whether the slug is stored as an object with nested fields.
+   * @param options.haveHistory - Whether to check historical slug fields for existence.
    * @param options.filter - Additional filter conditions to apply to the query.
    * @returns A MongoDB query object for checking slug existence.
    */
-  createSlugQuery({ slug: t, field: e, isObject: r, haveHistory: s = !1, filter: u }) {
-    const c = S({}, u != null ? u : {});
-    return r ? F(S({}, c), {
+  createSlugQuery({ slug: t, field: e, isObject: r, haveHistory: s = !1, filter: c }) {
+    const u = S({}, c != null ? c : {});
+    return r ? j(S({}, u), {
       $or: [
         { [`slug.${e}`]: t },
         ...s ? [{ slugHistory: { $elemMatch: { [`slug.${e}`]: t } } }] : []
       ]
-    }) : F(S({}, c), {
+    }) : j(S({}, u), {
       $or: [
         { slug: t },
         ...s ? [{ slugHistory: t }] : []
@@ -1029,27 +1022,28 @@ class we {
    * @param options.slug - The base slug string to make unique.
    * @param options.field - The field name for object-based slug checking.
    * @param options.isObject - Whether the slug is stored as an object with nested fields.
+   * @param options.haveHistory - Whether to check historical slug fields for uniqueness.
    * @param options.filter - Additional filter conditions to apply when checking slug existence.
    * @returns A promise that resolves to a unique slug string.
    */
   createUniqueSlug(t) {
-    return l(this, arguments, function* ({ slug: e, field: r, isObject: s, haveHistory: u, filter: c }) {
+    return l(this, arguments, function* ({ slug: e, field: r, isObject: s, haveHistory: c, filter: u }) {
       if (!e || typeof e != "string")
         throw new Error("Invalid slug provided: must be a non-empty string");
-      const i = I(e);
+      const o = $(e);
       if (!(yield this.model.exists(
-        this.createSlugQuery({ slug: i, field: r, isObject: s, haveHistory: u, filter: c })
+        this.createSlugQuery({ slug: o, field: r, isObject: s, haveHistory: c, filter: u })
       )))
-        return i;
-      for (let O = 1; O <= X; O++) {
-        const m = `${i}-${O}`;
+        return o;
+      for (let h = 1; h <= X; h++) {
+        const m = `${o}-${h}`;
         if (!(yield this.model.exists(
-          this.createSlugQuery({ slug: m, field: r, isObject: s, haveHistory: u, filter: c })
+          this.createSlugQuery({ slug: m, field: r, isObject: s, haveHistory: c, filter: u })
         )))
           return m;
       }
       const a = Date.now(), f = Math.random().toString(36).substring(2, 8);
-      return `${i}-${a}-${f}`;
+      return `${o}-${a}-${f}`;
     });
   }
   /**
@@ -1059,35 +1053,36 @@ class we {
    * @param options - Configuration for slug creation including field, source document, and filter.
    * @param options.field - The field name to create a slug for.
    * @param options.from - The source document containing the field value.
+   * @param options.haveHistory - Whether to check historical slug fields for uniqueness.
    * @param options.filter - Additional filter conditions to apply when checking slug existence.
    * @returns A promise that resolves to a standardized response with the created slug(s).
    */
   createSlug(t) {
-    return l(this, arguments, function* ({ field: e, from: r, filter: s, haveHistory: u }) {
+    return l(this, arguments, function* ({ field: e, from: r, filter: s, haveHistory: c }) {
       try {
-        const c = r[e];
-        return $(c) ? { success: !0, result: Object.fromEntries(
+        const u = r[e];
+        return G(u) ? { success: !0, result: Object.fromEntries(
           yield Promise.all(
-            Object.entries(c).map((f) => l(this, [f], function* ([O, m]) {
-              const g = yield this.createUniqueSlug({
+            Object.entries(u).map((f) => l(this, [f], function* ([h, m]) {
+              const p = yield this.createUniqueSlug({
                 slug: m,
-                field: O,
+                field: h,
                 isObject: !0,
-                haveHistory: u,
+                haveHistory: c,
                 filter: s
               });
-              return [O, g];
+              return [h, p];
             }))
           )
         ) } : { success: !0, result: yield this.createUniqueSlug({
-          slug: c,
+          slug: u,
           field: e,
           isObject: !1,
-          haveHistory: u,
+          haveHistory: c,
           filter: s
         }) };
-      } catch (c) {
-        return d(c);
+      } catch (u) {
+        return d(u);
       }
     });
   }
@@ -1099,36 +1094,37 @@ class we {
    * @param options.slug - The slug string to check for existence.
    * @param options.field - The field name for object-based slug checking.
    * @param options.from - The source document containing the field value.
+   * @param options.haveHistory - Whether to check historical slug fields for existence.
    * @param options.filter - Additional filter conditions to apply to the query.
    * @returns A promise that resolves to a standardized response indicating whether the slug exists.
    */
   checkSlug(t) {
-    return l(this, arguments, function* ({ slug: e, field: r, from: s, filter: u, haveHistory: c }) {
+    return l(this, arguments, function* ({ slug: e, field: r, from: s, filter: c, haveHistory: u }) {
       try {
-        const i = s[r];
-        if ($(i)) {
-          const m = Object.values(i).map((v) => I(v));
+        const o = s[r];
+        if (G(o)) {
+          const m = Object.values(o).map((v) => $(v));
           return (yield Promise.all(
             m.map(
               (v) => this.model.exists(this.createSlugQuery({
                 slug: v,
                 field: r,
                 isObject: !0,
-                haveHistory: c,
-                filter: u
+                haveHistory: u,
+                filter: c
               }))
             )
           )).some((v) => v) ? { success: !0, result: !0 } : { success: !0, result: !1 };
         }
-        const a = I(e);
+        const a = $(e);
         return { success: !0, result: (yield this.model.exists(this.createSlugQuery({
           slug: a,
           field: r,
           isObject: !1,
-          filter: u
+          filter: c
         }))) !== null };
-      } catch (i) {
-        return d(i);
+      } catch (o) {
+        return d(o);
       }
     });
   }
@@ -1159,14 +1155,14 @@ class we {
     return l(this, arguments, function* (e, r = {}, s = {}) {
       try {
         return { success: !0, result: yield this.model.distinct(e, r, s) };
-      } catch (u) {
-        return d(u);
+      } catch (c) {
+        return d(c);
       }
     });
   }
 }
 export {
-  Me as MongoController,
+  xe as MongoController,
   we as MongooseController,
-  x as mongo
+  w as mongo
 };

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@cyberskill/shared",
     "type": "module",
-    "version": "2.10.0",
+    "version": "2.11.0",
     "description": "CyberSkill Shared",
     "author": "Stephen Cheng",
     "license": "MIT",