@cyberskill/shared 2.7.0 → 2.8.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),a=(s,t,e)=>new Promise((r,n)=>{var c=i=>{try{u(e.next(i))}catch(l){n(l)}},o=i=>{try{u(e.throw(i))}catch(l){n(l)}},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 l=n.virtual(c);u?l.get(u):l.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 a(this,null,function*(){return!J.validate.isEmpty(s)})}},isUnique(s){return function(t){return a(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 a(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.
+"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=`
 ${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 a(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 a(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 a(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(l=>typeof l=="string"?l===i.name:l.path===i.name);if(typeof r=="string")return r===i.name;if(typeof r=="object"&&r!==null){const l=r;return l.path&&l.path===i.name||l.populate&&l.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:l,options:f})=>{if(!(l in i)){const S=i;S[l]=f.count?0:f.justOne?null:[]}})});const u=new Map;for(const i of c){const{name:l,options:f}=i,S=ce(o,l,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===l)||(y.virtuals.push(i),y.localValueSets.set(l,new Set));const N=y.localValueSets.get(l);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=>a(null,[i],function*([l,f]){const S=s.models[l];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 a(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 a(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 a(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 a(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 a(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 a(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 a(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 a(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 a(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 a(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 a(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 a(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 l=yield o.exec();return l?{success:!0,result:yield this.populateDynamicVirtualsForDocument(l,n)}:{success:!1,message:`No ${this.getModelName()} found.`,code:D.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(c){return d.catchError(c)}})}findAll(){return a(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 l=yield o.exec();return{success:!0,result:yield this.populateDynamicVirtualsForDocuments(l,n)}}catch(c){return d.catchError(c)}})}findPaging(){return a(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 a(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 a(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 a(this,null,function*(){try{return{success:!0,result:yield this.model.create(t)}}catch(e){return d.catchError(e)}})}createMany(t){return a(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 a(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 a(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 a(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 a(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 a(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 a(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 l=Date.now(),f=Math.random().toString(36).substring(2,8);return`${u}-${l}-${f}`})}createSlug(t){return a(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=>a(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 a(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 l=j.generateSlug(e);return{success:!0,result:(yield this.model.exists(this.createSlugQuery({slug:l,field:r,isObject:!1,filter:c})))!==null}}catch(u){return d.catchError(u)}})}aggregate(t){return a(this,null,function*(){try{return{success:!0,result:yield this.model.aggregate(t)}}catch(e){return d.catchError(e)}})}}exports.MongoController=oe;exports.MongooseController=ue;exports.mongo=M;
+`).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;

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

@@ -613,4 +613,13 @@ export declare class MongooseController<T extends Partial<C_Document>> {
      * @returns A promise that resolves to a standardized response with the aggregation results.
      */
     aggregate(pipeline: T_PipelineStage[]): Promise<I_Return<T[]>>;
+    /**
+     * Retrieves distinct values for the specified key from the collection.
+     *
+     * @param key - The field for which to return distinct values.
+     * @param filter - The filter query to apply (optional).
+     * @param options - Additional options for the distinct operation (optional).
+     * @returns A promise that resolves to a standardized response with the array of distinct values.
+     */
+    distinct(key: string, filter?: T_FilterQuery<T>, options?: T_QueryOptions<T>): Promise<I_Return<unknown[]>>;
 }

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

@@ -20,18 +20,18 @@ var ue = Object.defineProperty, ce = Object.defineProperties, ie = Object.getOwn
     for (var e of U(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), a = (n, t, e) => new Promise((r, s) => {
+}, 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) => {
     try {
       i(e.next(o));
-    } catch (l) {
-      s(l);
+    } catch (a) {
+      s(a);
     }
   }, c = (o) => {
     try {
       i(e.throw(o));
-    } catch (l) {
-      s(l);
+    } 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());
@@ -126,8 +126,8 @@ const x = {
           name: u,
           options: c
         });
-        const l = s.virtual(u);
-        i ? l.get(i) : l.get(function() {
+        const a = s.virtual(u);
+        i ? a.get(i) : a.get(function() {
           var f;
           return ((f = this._populated) == null ? void 0 : f[u]) || (c != null && c.count ? 0 : c != null && c.justOne ? null : []);
         });
@@ -186,7 +186,7 @@ const x = {
      */
     isRequired() {
       return function(n) {
-        return a(this, null, function* () {
+        return l(this, null, function* () {
           return !se.isEmpty(n);
         });
       };
@@ -202,7 +202,7 @@ const x = {
      */
     isUnique(n) {
       return function(t) {
-        return a(this, null, function* () {
+        return l(this, null, function* () {
           if (!Array.isArray(n) || n.length === 0)
             throw new Error("Fields must be a non-empty array of strings.");
           const e = { $or: n.map((s) => ({ [s]: t })) };
@@ -221,7 +221,7 @@ const x = {
      */
     matchesRegex(n) {
       return function(t) {
-        return a(this, null, function* () {
+        return l(this, null, function* () {
           if (!Array.isArray(n) || n.some((e) => !(e instanceof RegExp)))
             throw new Error("regexArray must be an array of valid RegExp objects.");
           return n.every((e) => e.test(t));
@@ -296,7 +296,7 @@ ${L}
    * @returns Array of records that don't exist in the database
    */
   getNewRecords(n, t, e) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       const r = yield n.findAll({});
       return r.success ? t.filter(
         (u) => !r.result.some(
@@ -313,7 +313,7 @@ ${L}
    * @returns Array of existing records that match the filter criteria
    */
   getExistingRecords(n, t, e) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       const r = yield n.findAll({});
       return r.success ? r.result.filter(
         (u) => t.some(
@@ -370,17 +370,17 @@ function me(n, t, e) {
   }), Array.from(r.entries()).map(([s, u]) => ({ model: s, docs: u }));
 }
 function z(n, t, e, r, s) {
-  return a(this, null, function* () {
+  return l(this, null, function* () {
     if (!t.length || !e.length || !r)
       return t;
     const u = e.filter((o) => {
       if (Array.isArray(r))
-        return r.length > 0 && r.some((l) => typeof l == "string" ? l === o.name : l.path === o.name);
+        return r.length > 0 && r.some((a) => typeof a == "string" ? a === o.name : a.path === o.name);
       if (typeof r == "string")
         return r === o.name;
       if (typeof r == "object" && r !== null) {
-        const l = r;
-        return l.path && l.path === o.name || l.populate && l.populate === o.name;
+        const a = r;
+        return a.path && a.path === o.name || a.populate && a.populate === o.name;
       }
       return !1;
     });
@@ -390,16 +390,16 @@ function z(n, t, e, r, s) {
       (o) => fe(o) ? o.toObject() : o
     ));
     c.forEach((o) => {
-      u.forEach(({ name: l, options: f }) => {
-        if (!(l in o)) {
+      u.forEach(({ name: a, options: f }) => {
+        if (!(a in o)) {
           const O = o;
-          O[l] = f.count ? 0 : f.justOne ? null : [];
+          O[a] = f.count ? 0 : f.justOne ? null : [];
         }
       });
     });
     const i = /* @__PURE__ */ new Map();
     for (const o of u) {
-      const { name: l, options: f } = o, O = me(c, l, f);
+      const { name: a, options: f } = o, O = me(c, a, f);
       for (const m of O) {
         i.has(m.model) || i.set(m.model, {
           virtuals: [],
@@ -407,8 +407,8 @@ function z(n, t, e, r, s) {
           docsByLocalValue: /* @__PURE__ */ new Map()
         });
         const g = i.get(m.model);
-        g.virtuals.find((V) => V.name === l) || (g.virtuals.push(o), g.localValueSets.set(l, /* @__PURE__ */ new Set()));
-        const v = g.localValueSets.get(l);
+        g.virtuals.find((V) => V.name === a) || (g.virtuals.push(o), g.localValueSets.set(a, /* @__PURE__ */ new Set()));
+        const v = g.localValueSets.get(a);
         m.docs.forEach((V) => {
           const A = V[f.localField];
           if (A != null) {
@@ -424,8 +424,8 @@ function z(n, t, e, r, s) {
         });
       }
     }
-    return yield Promise.all(Array.from(i.entries()).map((o) => a(null, [o], function* ([l, f]) {
-      const O = n.models[l];
+    return yield Promise.all(Array.from(i.entries()).map((o) => l(null, [o], function* ([a, f]) {
+      const O = n.models[a];
       if (!O)
         return;
       const m = /* @__PURE__ */ new Set();
@@ -491,7 +491,7 @@ class Me {
    * @returns A promise that resolves to a standardized response with the created document.
    */
   createOne(t) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       try {
         const e = S(S({}, x.createGenericFields()), t);
         return (yield this.collection.insertOne(e)).acknowledged ? {
@@ -516,7 +516,7 @@ class Me {
    * @returns A promise that resolves to a standardized response with the created documents.
    */
   createMany(t) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       try {
         const e = t.map((s) => S(S({}, x.createGenericFields()), s)), r = yield this.collection.insertMany(e);
         return r.insertedCount === 0 ? {
@@ -540,7 +540,7 @@ class Me {
    * @returns A promise that resolves to a standardized response with the found document.
    */
   findOne(t) {
-    return a(this, null, function* () {
+    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.NOT_FOUND.CODE };
@@ -556,7 +556,7 @@ class Me {
    * @returns A promise that resolves to a standardized response with the found documents.
    */
   findAll() {
-    return a(this, arguments, function* (t = {}) {
+    return l(this, arguments, function* (t = {}) {
       try {
         return {
           success: !0,
@@ -575,7 +575,7 @@ class Me {
    * @returns A promise that resolves to a standardized response with the document count.
    */
   count() {
-    return a(this, arguments, function* (t = {}) {
+    return l(this, arguments, function* (t = {}) {
       try {
         const e = yield this.collection.countDocuments(t);
         return {
@@ -596,7 +596,7 @@ class Me {
    * @returns A promise that resolves to a standardized response with the update result.
    */
   updateOne(t, e) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       try {
         const r = yield this.collection.updateOne(t, {
           $set: e
@@ -623,7 +623,7 @@ class Me {
    * @returns A promise that resolves to a standardized response with the update result.
    */
   updateMany(t, e) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       try {
         const r = yield this.collection.updateMany(t, {
           $set: e
@@ -649,7 +649,7 @@ class Me {
    * @returns A promise that resolves to a standardized response with the delete result.
    */
   deleteOne(t) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       try {
         const e = yield this.collection.deleteOne(t);
         return e.deletedCount === 0 ? {
@@ -673,7 +673,7 @@ class Me {
    * @returns A promise that resolves to a standardized response with the delete result.
    */
   deleteMany(t) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       try {
         const e = yield this.collection.deleteMany(t);
         return e.deletedCount === 0 ? {
@@ -724,7 +724,7 @@ class we {
    * @returns The document with dynamic virtuals populated.
    */
   populateDynamicVirtualsForDocument(t, e) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       const r = this.getDynamicVirtuals();
       if (r && r.length > 0) {
         const s = yield z(this.model.base, [t], r, e);
@@ -741,7 +741,7 @@ class we {
    * @returns The documents with dynamic virtuals populated.
    */
   populateDynamicVirtualsForDocuments(t, e) {
-    return a(this, null, function* () {
+    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;
     });
@@ -757,12 +757,12 @@ class we {
    * @returns A promise that resolves to a standardized response with the found document.
    */
   findOne() {
-    return a(this, arguments, function* (t = {}, e = {}, r = {}, s) {
+    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 l = yield c.exec();
-        return l ? { success: !0, result: yield this.populateDynamicVirtualsForDocument(l, s) } : {
+        const a = yield c.exec();
+        return a ? { success: !0, result: yield this.populateDynamicVirtualsForDocument(a, s) } : {
           success: !1,
           message: `No ${this.getModelName()} found.`,
           code: R.NOT_FOUND.CODE
@@ -783,12 +783,12 @@ class we {
    * @returns A promise that resolves to a standardized response with the found documents.
    */
   findAll() {
-    return a(this, arguments, function* (t = {}, e = {}, r = {}, s) {
+    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 l = yield c.exec();
-        return { success: !0, result: yield this.populateDynamicVirtualsForDocuments(l, s) };
+        const a = yield c.exec();
+        return { success: !0, result: yield this.populateDynamicVirtualsForDocuments(a, s) };
       } catch (u) {
         return d(u);
       }
@@ -803,7 +803,7 @@ class we {
    * @returns A promise that resolves to a standardized response with paginated results.
    */
   findPaging() {
-    return a(this, arguments, function* (t = {}, e = {}) {
+    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));
@@ -822,7 +822,7 @@ class we {
    * @returns A promise that resolves to a standardized response with paginated aggregation results.
    */
   findPagingAggregate(t) {
-    return a(this, arguments, function* (e, r = {}) {
+    return l(this, arguments, function* (e, r = {}) {
       try {
         const s = this.getDynamicVirtuals(), u = S({}, r);
         r.populate && (u.populate = j(r.populate, s));
@@ -843,7 +843,7 @@ class we {
    * @returns A promise that resolves to a standardized response with the document count.
    */
   count() {
-    return a(this, arguments, function* (t = {}) {
+    return l(this, arguments, function* (t = {}) {
       try {
         const e = b(t);
         return { success: !0, result: yield this.model.countDocuments(e) };
@@ -859,7 +859,7 @@ class we {
    * @returns A promise that resolves to a standardized response with the created document.
    */
   createOne(t) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       try {
         return { success: !0, result: yield this.model.create(t) };
       } catch (e) {
@@ -875,7 +875,7 @@ class we {
    * @returns A promise that resolves to a standardized response with the created documents.
    */
   createMany(t) {
-    return a(this, arguments, function* (e, r = {}) {
+    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) };
       } catch (s) {
@@ -892,7 +892,7 @@ class we {
    * @returns A promise that resolves to a standardized response with the updated document.
    */
   updateOne() {
-    return a(this, arguments, function* (t = {}, e = {}, r = {}) {
+    return l(this, arguments, function* (t = {}, e = {}, r = {}) {
       try {
         const s = b(t), u = yield this.model.findOneAndUpdate(s, e, S({
           new: !0
@@ -916,7 +916,7 @@ class we {
    * @returns A promise that resolves to a standardized response with the update result.
    */
   updateMany() {
-    return a(this, arguments, function* (t = {}, e = {}, r = {}) {
+    return l(this, arguments, function* (t = {}, e = {}, r = {}) {
       try {
         const s = b(t);
         return { success: !0, result: yield this.model.updateMany(s, e, r).exec() };
@@ -933,7 +933,7 @@ class we {
    * @returns A promise that resolves to a standardized response with the deleted document.
    */
   deleteOne() {
-    return a(this, arguments, function* (t = {}, e = {}) {
+    return l(this, arguments, function* (t = {}, e = {}) {
       try {
         const r = b(t), s = yield this.model.findOneAndDelete(r, e).exec();
         return s ? { success: !0, result: s } : {
@@ -954,7 +954,7 @@ class we {
    * @returns A promise that resolves to a standardized response with the delete result.
    */
   deleteMany() {
-    return a(this, arguments, function* (t = {}, e = {}) {
+    return l(this, arguments, function* (t = {}, e = {}) {
       try {
         const r = b(t), s = yield this.model.deleteMany(r, e).exec();
         return s.deletedCount === 0 ? {
@@ -976,7 +976,7 @@ class we {
    * @returns A promise that resolves to a standardized response with the unique short ID.
    */
   createShortId(t, e = 4) {
-    return a(this, null, function* () {
+    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 }))
@@ -1033,7 +1033,7 @@ class we {
    * @returns A promise that resolves to a unique slug string.
    */
   createUniqueSlug(t) {
-    return a(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: u, filter: c }) {
       if (!e || typeof e != "string")
         throw new Error("Invalid slug provided: must be a non-empty string");
       const i = I(e);
@@ -1048,8 +1048,8 @@ class we {
         )))
           return m;
       }
-      const l = Date.now(), f = Math.random().toString(36).substring(2, 8);
-      return `${i}-${l}-${f}`;
+      const a = Date.now(), f = Math.random().toString(36).substring(2, 8);
+      return `${i}-${a}-${f}`;
     });
   }
   /**
@@ -1063,12 +1063,12 @@ class we {
    * @returns A promise that resolves to a standardized response with the created slug(s).
    */
   createSlug(t) {
-    return a(this, arguments, function* ({ field: e, from: r, filter: s, haveHistory: u }) {
+    return l(this, arguments, function* ({ field: e, from: r, filter: s, haveHistory: u }) {
       try {
         const c = r[e];
         return $(c) ? { success: !0, result: Object.fromEntries(
           yield Promise.all(
-            Object.entries(c).map((f) => a(this, [f], function* ([O, m]) {
+            Object.entries(c).map((f) => l(this, [f], function* ([O, m]) {
               const g = yield this.createUniqueSlug({
                 slug: m,
                 field: O,
@@ -1103,7 +1103,7 @@ class we {
    * @returns A promise that resolves to a standardized response indicating whether the slug exists.
    */
   checkSlug(t) {
-    return a(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: u, haveHistory: c }) {
       try {
         const i = s[r];
         if ($(i)) {
@@ -1120,9 +1120,9 @@ class we {
             )
           )).some((v) => v) ? { success: !0, result: !0 } : { success: !0, result: !1 };
         }
-        const l = I(e);
+        const a = I(e);
         return { success: !0, result: (yield this.model.exists(this.createSlugQuery({
-          slug: l,
+          slug: a,
           field: r,
           isObject: !1,
           filter: u
@@ -1139,7 +1139,7 @@ class we {
    * @returns A promise that resolves to a standardized response with the aggregation results.
    */
   aggregate(t) {
-    return a(this, null, function* () {
+    return l(this, null, function* () {
       try {
         return { success: !0, result: yield this.model.aggregate(t) };
       } catch (e) {
@@ -1147,6 +1147,23 @@ class we {
       }
     });
   }
+  /**
+   * Retrieves distinct values for the specified key from the collection.
+   *
+   * @param key - The field for which to return distinct values.
+   * @param filter - The filter query to apply (optional).
+   * @param options - Additional options for the distinct operation (optional).
+   * @returns A promise that resolves to a standardized response with the array of distinct values.
+   */
+  distinct(t) {
+    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);
+      }
+    });
+  }
 }
 export {
   Me as MongoController,

package/dist/util/object/object.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("lodash-es");var m=Object.defineProperty,v=Object.defineProperties,b=Object.getOwnPropertyDescriptors,a=Object.getOwnPropertySymbols,g=Object.prototype.hasOwnProperty,O=Object.prototype.propertyIsEnumerable,u=(r,e,n)=>e in r?m(r,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):r[e]=n,l=(r,e)=>{for(var n in e||(e={}))g.call(e,n)&&u(r,n,e[n]);if(a)for(var n of a(e))O.call(e,n)&&u(r,n,e[n]);return r},c=(r,e)=>v(r,b(e));function _(r){try{return JSON.parse(r),!0}catch(e){return!1}}function h(r,e){return e.reduce((n,o)=>{if(n&&typeof n=="object"&&o in n)return n[o]},r)}function f(r,e,n){if(e.length===0)return r;const[o,...t]=e;if(t.length===0)return c(l({},r),{[o]:n});const s=r[o];return c(l({},r),{[o]:f(typeof s=="object"&&s!==null?s:{},t,n)})}function j(...r){if(r.length===0)return{};const e=r.filter(t=>t!=null).map(t=>typeof t!="object"?{}:t);if(e.length===0)return{};if(e.length===1)return e[0];if(e.every(i.isArray))return[].concat(...e);if(e.every(t=>typeof t=="object"&&t!==null&&!i.isArray(t)))return i.mergeWith({},...e,(t,s)=>{if(i.isArray(t)&&i.isArray(s))return t.concat(s)});if(e.every(t=>typeof t!="object"||t===null))throw new Error("deepMerge: Cannot merge primitive values. All arguments must be objects or arrays.");const n=e.some(i.isArray),o=e.some(t=>typeof t=="object"&&t!==null&&!i.isArray(t));throw n&&o?new Error("deepMerge: Cannot mix arrays and objects. All arguments must be either arrays or objects."):new Error("deepMerge: Invalid arguments provided. All arguments must be objects or arrays of the same type.")}function p(r){if(!r||typeof r!="object")return r;const e={};for(const[n,o]of Object.entries(r))if(o&&typeof o=="object"&&!Array.isArray(o)){const t=p(o);for(const[s,y]of Object.entries(t)){const d=`${n}.${s}`;e[d]=y}}else e[n]=o;return e}exports.deepMerge=j;exports.getNestedValue=h;exports.isJSON=_;exports.normalizeMongoFilter=p;exports.setNestedValue=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("lodash-es");var g=Object.defineProperty,v=Object.defineProperties,O=Object.getOwnPropertyDescriptors,u=Object.getOwnPropertySymbols,b=Object.prototype.hasOwnProperty,h=Object.prototype.propertyIsEnumerable,l=(r,e,t)=>e in r?g(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t,c=(r,e)=>{for(var t in e||(e={}))b.call(e,t)&&l(r,t,e[t]);if(u)for(var t of u(e))h.call(e,t)&&l(r,t,e[t]);return r},f=(r,e)=>v(r,O(e));function _(r){try{return JSON.parse(r),!0}catch(e){return!1}}function j(r,e){return e.reduce((t,n)=>{if(t&&typeof t=="object"&&n in t)return t[n]},r)}function p(r,e,t){if(e.length===0)return r;const[n,...o]=e;if(o.length===0)return f(c({},r),{[n]:t});const s=r[n];return f(c({},r),{[n]:p(typeof s=="object"&&s!==null?s:{},o,t)})}function w(...r){if(r.length===0)return{};const e=r.filter(o=>o!=null).map(o=>typeof o!="object"?{}:o);if(e.length===0)return{};if(e.length===1)return e[0];if(e.every(i.isArray))return[].concat(...e);if(e.every(o=>typeof o=="object"&&o!==null&&!i.isArray(o)))return i.mergeWith({},...e,(o,s)=>{if(i.isArray(o)&&i.isArray(s))return o.concat(s)});if(e.every(o=>typeof o!="object"||o===null))throw new Error("deepMerge: Cannot merge primitive values. All arguments must be objects or arrays.");const t=e.some(i.isArray),n=e.some(o=>typeof o=="object"&&o!==null&&!i.isArray(o));throw t&&n?new Error("deepMerge: Cannot mix arrays and objects. All arguments must be either arrays or objects."):new Error("deepMerge: Invalid arguments provided. All arguments must be objects or arrays of the same type.")}function a(r){if(!r||typeof r!="object")return r;const e={};for(const[t,n]of Object.entries(r))if(n&&typeof n=="object"&&!Array.isArray(n))if(Object.keys(n).some(s=>s.startsWith("$")))e[t]=a(n);else{const s=a(n);for(const[y,d]of Object.entries(s)){const m=`${t}.${y}`;e[m]=d}}else e[t]=n;return e}exports.deepMerge=w;exports.getNestedValue=j;exports.isJSON=_;exports.normalizeMongoFilter=a;exports.setNestedValue=p;

package/dist/util/object/object.util.d.ts

@@ -73,11 +73,12 @@ export declare function deepMerge<T extends Record<string, unknown>>(...args: (T
 export declare function deepMerge<T extends unknown[]>(...args: (T | null | undefined)[]): T;
 /**
  * Normalizes MongoDB filters to support both dot notation strings and nested objects.
- * This function converts nested object filters to dot notation format to ensure
- * consistent behavior across different filter input formats.
+ * This function converts nested object filters to dot notation format while preserving
+ * MongoDB operators to ensure consistent behavior across different filter input formats.
  *
  * @param filter - The filter object to normalize.
- * @returns A normalized filter object with nested objects converted to dot notation.
+ * @returns A normalized filter object with nested objects converted to dot notation,
+ *          while preserving MongoDB operators as nested objects.
  *
  * @example
  * ```typescript
@@ -85,6 +86,10 @@ export declare function deepMerge<T extends unknown[]>(...args: (T | null | unde
  * normalizeMongoFilter({ "location.countryId": "240" })
  * normalizeMongoFilter({ location: { countryId: "240" } })
  * // Both return: { "location.countryId": "240" }
+ *
+ * // MongoDB operators are preserved:
+ * normalizeMongoFilter({ id: { $in: ["240", "59"] } })
+ * // Returns: { id: { $in: ["240", "59"] } }
  * ```
  */
 export declare function normalizeMongoFilter<T extends Record<string, unknown>>(filter: T): T;

package/dist/util/object/object.util.js

@@ -1,46 +1,46 @@
-import { isArray as i, mergeWith as y } from "lodash-es";
-var d = Object.defineProperty, m = Object.defineProperties, v = Object.getOwnPropertyDescriptors, u = Object.getOwnPropertySymbols, b = Object.prototype.hasOwnProperty, _ = Object.prototype.propertyIsEnumerable, a = (r, e, n) => e in r ? d(r, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : r[e] = n, f = (r, e) => {
-  for (var n in e || (e = {}))
-    b.call(e, n) && a(r, n, e[n]);
-  if (u)
-    for (var n of u(e))
-      _.call(e, n) && a(r, n, e[n]);
+import { isArray as i, mergeWith as m } from "lodash-es";
+var v = Object.defineProperty, O = Object.defineProperties, b = Object.getOwnPropertyDescriptors, a = Object.getOwnPropertySymbols, h = Object.prototype.hasOwnProperty, _ = Object.prototype.propertyIsEnumerable, u = (r, e, t) => e in r ? v(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t, f = (r, e) => {
+  for (var t in e || (e = {}))
+    h.call(e, t) && u(r, t, e[t]);
+  if (a)
+    for (var t of a(e))
+      _.call(e, t) && u(r, t, e[t]);
   return r;
-}, c = (r, e) => m(r, v(e));
-function j(r) {
+}, c = (r, e) => O(r, b(e));
+function w(r) {
   try {
     return JSON.parse(r), !0;
   } catch (e) {
     return !1;
   }
 }
-function w(r, e) {
-  return e.reduce((n, o) => {
-    if (n && typeof n == "object" && o in n)
-      return n[o];
+function P(r, e) {
+  return e.reduce((t, n) => {
+    if (t && typeof t == "object" && n in t)
+      return t[n];
   }, r);
 }
-function O(r, e, n) {
+function g(r, e, t) {
   if (e.length === 0)
     return r;
-  const [o, ...t] = e;
-  if (t.length === 0)
+  const [n, ...o] = e;
+  if (o.length === 0)
     return c(f({}, r), {
-      [o]: n
+      [n]: t
     });
-  const s = r[o];
+  const s = r[n];
   return c(f({}, r), {
-    [o]: O(
+    [n]: g(
       typeof s == "object" && s !== null ? s : {},
-      t,
-      n
+      o,
+      t
     )
   });
 }
-function P(...r) {
+function A(...r) {
   if (r.length === 0)
     return {};
-  const e = r.filter((t) => t != null).map((t) => typeof t != "object" ? {} : t);
+  const e = r.filter((o) => o != null).map((o) => typeof o != "object" ? {} : o);
   if (e.length === 0)
     return {};
   if (e.length === 1)
@@ -48,44 +48,50 @@ function P(...r) {
   if (e.every(i))
     return [].concat(...e);
   if (e.every(
-    (t) => typeof t == "object" && t !== null && !i(t)
+    (o) => typeof o == "object" && o !== null && !i(o)
   ))
-    return y({}, ...e, (t, s) => {
-      if (i(t) && i(s))
-        return t.concat(s);
+    return m({}, ...e, (o, s) => {
+      if (i(o) && i(s))
+        return o.concat(s);
     });
-  if (e.every((t) => typeof t != "object" || t === null))
+  if (e.every((o) => typeof o != "object" || o === null))
     throw new Error(
       "deepMerge: Cannot merge primitive values. All arguments must be objects or arrays."
     );
-  const n = e.some(i), o = e.some(
-    (t) => typeof t == "object" && t !== null && !i(t)
+  const t = e.some(i), n = e.some(
+    (o) => typeof o == "object" && o !== null && !i(o)
   );
-  throw n && o ? new Error(
+  throw t && n ? new Error(
     "deepMerge: Cannot mix arrays and objects. All arguments must be either arrays or objects."
   ) : new Error(
     "deepMerge: Invalid arguments provided. All arguments must be objects or arrays of the same type."
   );
 }
-function h(r) {
+function l(r) {
   if (!r || typeof r != "object")
     return r;
   const e = {};
-  for (const [n, o] of Object.entries(r))
-    if (o && typeof o == "object" && !Array.isArray(o)) {
-      const t = h(o);
-      for (const [s, l] of Object.entries(t)) {
-        const p = `${n}.${s}`;
-        e[p] = l;
+  for (const [t, n] of Object.entries(r))
+    if (n && typeof n == "object" && !Array.isArray(n))
+      if (Object.keys(n).some(
+        (s) => s.startsWith("$")
+      ))
+        e[t] = l(n);
+      else {
+        const s = l(n);
+        for (const [p, y] of Object.entries(s)) {
+          const d = `${t}.${p}`;
+          e[d] = y;
+        }
       }
-    } else
-      e[n] = o;
+    else
+      e[t] = n;
   return e;
 }
 export {
-  P as deepMerge,
-  w as getNestedValue,
-  j as isJSON,
-  h as normalizeMongoFilter,
-  O as setNestedValue
+  A as deepMerge,
+  P as getNestedValue,
+  w as isJSON,
+  l as normalizeMongoFilter,
+  g as setNestedValue
 };

package/package.json

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