@cyberskill/shared 2.4.0 → 2.5.0

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

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

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

@@ -160,6 +160,22 @@ export declare const mongo: {
      * @returns True if the options contain a dynamic ref function.
      */
     isDynamicVirtual<T, R extends string = string>(options?: T_VirtualOptions<T, R>): options is I_DynamicVirtualOptions<T, R>;
+    /**
+     * Generic utility function to get new records from the database
+     * @param controller - MongoController instance
+     * @param recordsToCheck - Array of records to check
+     * @param filterFn - Function to determine if a record already exists
+     * @returns Array of records that don't exist in the database
+     */
+    getNewRecords<T extends I_GenericDocument>(controller: MongoController<T>, recordsToCheck: T[], filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean): Promise<T[]>;
+    /**
+     * Generic utility function to get existing records that match the filter criteria
+     * @param controller - MongoController instance
+     * @param recordsToCheck - Array of records to check
+     * @param filterFn - Function to determine if a record exists
+     * @returns Array of existing records that match the filter criteria
+     */
+    getExistingRecords<T extends I_GenericDocument>(controller: MongoController<T>, recordsToCheck: T[], filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean): Promise<T_WithId<T>[]>;
 };
 /**
  * MongoDB native driver controller for direct database operations.

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

@@ -1,9 +1,9 @@
-import { cloneDeep as B, isObject as T } from "lodash-es";
+import { cloneDeep as B, isObject as $ } from "lodash-es";
 import K from "migrate-mongo";
 import { Document as W } from "mongoose";
 import Q from "mongoose-aggregate-paginate-v2";
 import H from "mongoose-paginate-v2";
-import { v4 as $ } from "uuid";
+import { v4 as T } from "uuid";
 import { getNestedValue as J, setNestedValue as z } from "../../util/object/object.util.js";
 import { regexSearchMapper as X } from "../../util/common/common.util.js";
 import { writeFileSync as G, pathExistsSync as Y, readFileSync as Z, appendFileSync as ee } from "../fs/fs.util.js";
@@ -12,28 +12,28 @@ import { validate as te } from "../../util/validate/validate.util.js";
 import { generateShortId as re, generateSlug as I } from "../../util/string/string.util.js";
 import { RESPONSE_STATUS as v } from "../../constant/response-status.js";
 import { catchError as d } from "../log/log.util.js";
-var se = Object.defineProperty, ne = Object.defineProperties, ue = Object.getOwnPropertyDescriptors, L = Object.getOwnPropertySymbols, ce = Object.prototype.hasOwnProperty, oe = Object.prototype.propertyIsEnumerable, j = (s, t, e) => t in s ? se(s, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : s[t] = e, S = (s, t) => {
+var se = Object.defineProperty, ne = Object.defineProperties, ue = Object.getOwnPropertyDescriptors, L = Object.getOwnPropertySymbols, ce = Object.prototype.hasOwnProperty, ie = Object.prototype.propertyIsEnumerable, j = (s, t, e) => t in s ? se(s, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : s[t] = e, S = (s, t) => {
   for (var e in t || (t = {}))
     ce.call(t, e) && j(s, e, t[e]);
   if (L)
     for (var e of L(t))
-      oe.call(t, e) && j(s, e, t[e]);
+      ie.call(t, e) && j(s, e, t[e]);
   return s;
-}, w = (s, t) => ne(s, ue(t)), ie = (s, t, e) => j(s, typeof t != "symbol" ? t + "" : t, e), l = (s, t, e) => new Promise((r, n) => {
-  var u = (o) => {
+}, w = (s, t) => ne(s, ue(t)), oe = (s, t, e) => j(s, typeof t != "symbol" ? t + "" : t, e), l = (s, t, e) => new Promise((r, n) => {
+  var u = (i) => {
     try {
-      i(e.next(o));
+      o(e.next(i));
     } catch (a) {
       n(a);
     }
-  }, c = (o) => {
+  }, c = (i) => {
     try {
-      i(e.throw(o));
+      o(e.throw(i));
     } catch (a) {
       n(a);
     }
-  }, i = (o) => o.done ? r(o.value) : Promise.resolve(o.value).then(u, c);
-  i((e = e.apply(s, t)).next());
+  }, o = (i) => i.done ? r(i.value) : Promise.resolve(i.value).then(u, c);
+  o((e = e.apply(s, t)).next());
 });
 function le(s) {
   return s === s.toUpperCase() ? s.charAt(0).toUpperCase() + s.slice(1).toLowerCase() : s;
@@ -48,7 +48,7 @@ const V = {
    */
   createGenericFields() {
     return {
-      id: $(),
+      id: T(),
       isDel: !1,
       createdAt: /* @__PURE__ */ new Date(),
       updatedAt: /* @__PURE__ */ new Date()
@@ -88,7 +88,7 @@ const V = {
   createGenericSchema(s) {
     return new s.Schema(
       {
-        id: { type: String, default: $, unique: !0 },
+        id: { type: String, default: T, unique: !0 },
         isDel: { type: Boolean, default: !1 }
       },
       { timestamps: !0 }
@@ -118,21 +118,21 @@ const V = {
       toObject: { virtuals: !0 }
       // So `console.log()` and other functions that use `toObject()` include virtuals
     });
-    return e.forEach(({ name: u, options: c, get: i }) => {
+    return e.forEach(({ name: u, options: c, get: o }) => {
       if (V.isDynamicVirtual(c)) {
-        const o = n.statics;
-        o._dynamicVirtuals || (o._dynamicVirtuals = []), o._dynamicVirtuals.push({
+        const i = n.statics;
+        i._dynamicVirtuals || (i._dynamicVirtuals = []), i._dynamicVirtuals.push({
           name: u,
           options: c
         });
         const a = n.virtual(u);
-        i ? a.get(i) : a.get(function() {
+        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 : []);
         });
       } else {
-        const o = n.virtual(u, c);
-        i && o.get(i);
+        const i = n.virtual(u, c);
+        o && i.get(o);
       }
     }), r || n.add(V.createGenericSchema(s)), n;
   },
@@ -165,11 +165,11 @@ const V = {
       throw new Error("Model name is required.");
     if (s.models[t])
       return s.models[t];
-    const i = V.createSchema({ mongoose: s, schema: e, virtuals: r });
-    return (n || u) && V.applyPlugins(i, [
+    const o = V.createSchema({ mongoose: s, schema: e, virtuals: r });
+    return (n || u) && V.applyPlugins(o, [
       n && H,
       u && Q
-    ]), V.applyMiddlewares(i, c), s.model(t, i);
+    ]), V.applyMiddlewares(o, c), s.model(t, o);
   },
   /**
    * Validation utilities for Mongoose schemas.
@@ -286,6 +286,40 @@ ${q}
    */
   isDynamicVirtual(s) {
     return !!(s && typeof s.ref == "function");
+  },
+  /**
+   * Generic utility function to get new records from the database
+   * @param controller - MongoController instance
+   * @param recordsToCheck - Array of records to check
+   * @param filterFn - Function to determine if a record already exists
+   * @returns Array of records that don't exist in the database
+   */
+  getNewRecords(s, t, e) {
+    return l(this, null, function* () {
+      const r = yield s.findAll({});
+      return r.success ? t.filter(
+        (u) => !r.result.some(
+          (c) => e(c, u)
+        )
+      ) : t;
+    });
+  },
+  /**
+   * Generic utility function to get existing records that match the filter criteria
+   * @param controller - MongoController instance
+   * @param recordsToCheck - Array of records to check
+   * @param filterFn - Function to determine if a record exists
+   * @returns Array of existing records that match the filter criteria
+   */
+  getExistingRecords(s, t, e) {
+    return l(this, null, function* () {
+      const r = yield s.findAll({});
+      return r.success ? r.result.filter(
+        (u) => t.some(
+          (c) => e(u, c)
+        )
+      ) : [];
+    });
   }
 };
 function ae(s) {
@@ -326,8 +360,8 @@ function de(s, t, e) {
         return;
       const c = typeof u == "string" ? u : String(u);
       if (c && c.trim() !== "") {
-        const i = le(c);
-        r.has(i) || r.set(i, []), r.get(i).push(n);
+        const o = le(c);
+        r.has(o) || r.set(o, []), r.get(o).push(n);
       }
     } catch (u) {
       d(new Error(`Dynamic ref function failed for virtual "${t}": ${u instanceof Error ? u.message : String(u)}`));
@@ -338,47 +372,47 @@ function U(s, t, e, r, n) {
   return l(this, null, function* () {
     if (!t.length || !e.length || !r)
       return t;
-    const u = e.filter((o) => {
+    const u = 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)
       return t;
     const c = B(t.map(
-      (o) => ae(o) ? o.toObject() : o
+      (i) => ae(i) ? i.toObject() : i
     ));
-    c.forEach((o) => {
+    c.forEach((i) => {
       u.forEach(({ name: a, options: f }) => {
-        if (!(a in o)) {
-          const m = o;
+        if (!(a in i)) {
+          const m = i;
           m[a] = f.count ? 0 : f.justOne ? null : [];
         }
       });
     });
-    const i = /* @__PURE__ */ new Map();
-    for (const o of u) {
-      const { name: a, options: f } = o, m = de(c, a, f);
+    const o = /* @__PURE__ */ new Map();
+    for (const i of u) {
+      const { name: a, options: f } = i, m = de(c, a, f);
       for (const p of m) {
-        i.has(p.model) || i.set(p.model, {
+        o.has(p.model) || o.set(p.model, {
           virtuals: [],
           localValueSets: /* @__PURE__ */ new Map(),
           docsByLocalValue: /* @__PURE__ */ new Map()
         });
-        const h = i.get(p.model);
-        h.virtuals.find((N) => N.name === a) || (h.virtuals.push(o), h.localValueSets.set(a, /* @__PURE__ */ new Set()));
-        const M = h.localValueSets.get(a);
+        const h = o.get(p.model);
+        h.virtuals.find((N) => N.name === a) || (h.virtuals.push(i), h.localValueSets.set(a, /* @__PURE__ */ new Set()));
+        const A = h.localValueSets.get(a);
         p.docs.forEach((N) => {
-          const C = N[f.localField];
-          if (C != null) {
-            const D = String(C);
-            M.add(D);
+          const M = N[f.localField];
+          if (M != null) {
+            const D = String(M);
+            A.add(D);
             let _ = -1;
             const R = N;
             R.id !== void 0 ? _ = c.findIndex((b) => b.id === R.id) : R._id !== void 0 && (_ = c.findIndex((b) => {
@@ -389,7 +423,7 @@ function U(s, t, e, r, n) {
         });
       }
     }
-    return yield Promise.all(Array.from(i.entries()).map((o) => l(null, [o], function* ([a, f]) {
+    return yield Promise.all(Array.from(o.entries()).map((i) => l(null, [i], function* ([a, f]) {
       const m = s.models[a];
       if (!m)
         return;
@@ -398,12 +432,12 @@ function U(s, t, e, r, n) {
         D.forEach((_) => p.add(_));
       }), p.size === 0)
         return;
-      const h = [...new Set(f.virtuals.map((D) => D.options.foreignField))], M = Array.from(p);
+      const h = [...new Set(f.virtuals.map((D) => D.options.foreignField))], A = Array.from(p);
       let N;
-      h.length === 1 ? N = { [String(h[0])]: { $in: M } } : N = { $or: h.map((D) => ({ [D]: { $in: M } })) };
-      const C = yield m.find(N, n).lean();
+      h.length === 1 ? N = { [String(h[0])]: { $in: A } } : N = { $or: h.map((D) => ({ [D]: { $in: A } })) };
+      const M = yield m.find(N, n).lean();
       for (const D of f.virtuals) {
-        const { name: _, options: R } = D, b = C.filter((O) => {
+        const { name: _, options: R } = D, b = M.filter((O) => {
           const y = O[R.foreignField];
           return y != null && p.has(String(y));
         });
@@ -415,8 +449,8 @@ function U(s, t, e, r, n) {
             g && O.set(g, (O.get(g) || 0) + 1);
           }), f.localValueSets.get(_).forEach((y) => {
             const E = f.docsByLocalValue.get(y) || [], g = O.get(y) || 0;
-            E.forEach((A) => {
-              const P = c[A];
+            E.forEach((C) => {
+              const P = c[C];
               P[_] === void 0 && (P[_] = g);
             });
           });
@@ -427,10 +461,10 @@ function U(s, t, e, r, n) {
             const g = (E = y[R.foreignField]) == null ? void 0 : E.toString();
             g && (O.has(g) || O.set(g, []), O.get(g).push(y));
           }), f.localValueSets.get(_).forEach((y) => {
-            const E = f.docsByLocalValue.get(y) || [], g = O.get(y) || [], A = R.justOne ? g[0] || null : g;
+            const E = f.docsByLocalValue.get(y) || [], g = O.get(y) || [], C = R.justOne ? g[0] || null : g;
             E.forEach((P) => {
               const k = c[P];
-              k[_] = A;
+              k[_] = C;
             });
           });
         }
@@ -446,7 +480,7 @@ class Ve {
    * @param collectionName - The name of the collection to operate on.
    */
   constructor(t, e) {
-    ie(this, "collection"), this.collection = t.collection(e);
+    oe(this, "collection"), this.collection = t.collection(e);
   }
   /**
    * Creates a single document in the collection.
@@ -724,10 +758,10 @@ class be {
   findOne() {
     return l(this, arguments, function* (t = {}, e = {}, r = {}, n) {
       try {
-        const u = this.model.findOne(t, e, r), c = this.getDynamicVirtuals(), i = F(n, c);
-        i && u.populate(i);
-        const o = yield u.exec();
-        return o ? { success: !0, result: yield this.populateDynamicVirtualsForDocument(o, n) } : {
+        const u = this.model.findOne(t, e, r), c = this.getDynamicVirtuals(), o = F(n, c);
+        o && u.populate(o);
+        const i = yield u.exec();
+        return i ? { success: !0, result: yield this.populateDynamicVirtualsForDocument(i, n) } : {
           success: !1,
           message: `No ${this.getModelName()} found.`,
           code: v.NOT_FOUND.CODE
@@ -750,10 +784,10 @@ class be {
   findAll() {
     return l(this, arguments, function* (t = {}, e = {}, r = {}, n) {
       try {
-        const u = this.model.find(t, e, r), c = this.getDynamicVirtuals(), i = F(n, c);
-        i && u.populate(i);
-        const o = yield u.exec();
-        return { success: !0, result: yield this.populateDynamicVirtualsForDocuments(o, n) };
+        const u = this.model.find(t, e, r), c = this.getDynamicVirtuals(), o = F(n, c);
+        o && u.populate(o);
+        const i = yield u.exec();
+        return { success: !0, result: yield this.populateDynamicVirtualsForDocuments(i, n) };
       } catch (u) {
         return d(u);
       }
@@ -794,8 +828,8 @@ class be {
         const c = yield this.model.aggregatePaginate(
           this.model.aggregate(e),
           u
-        ), i = yield this.populateDynamicVirtualsForDocuments(c.docs, r.populate);
-        return { success: !0, result: w(S({}, c), { docs: i }) };
+        ), o = yield this.populateDynamicVirtualsForDocuments(c.docs, r.populate);
+        return { success: !0, result: w(S({}, c), { docs: o }) };
       } catch (n) {
         return d(n);
       }
@@ -941,13 +975,13 @@ class be {
   createShortId(t, e = 4) {
     return l(this, null, function* () {
       try {
-        const n = Array.from({ length: 10 }, (i, o) => re(t, o + e)), c = (yield Promise.all(
-          n.map((i) => this.model.exists({ shortId: i }))
-        )).findIndex((i) => !i);
+        const n = Array.from({ length: 10 }, (o, i) => re(t, i + e)), c = (yield Promise.all(
+          n.map((o) => this.model.exists({ shortId: o }))
+        )).findIndex((o) => !o);
         if (c !== -1) {
-          const i = n[c];
-          if (i)
-            return { success: !0, result: i };
+          const o = n[c];
+          if (o)
+            return { success: !0, result: o };
         }
         return {
           success: !1,
@@ -997,13 +1031,13 @@ class be {
    */
   createUniqueSlug(t) {
     return l(this, arguments, function* ({ slug: e, field: r, isObject: n, filter: u }) {
-      const c = I(e), o = Array.from({ length: 100 }, (m, p) => p === 0 ? c : `${c}-${p}`), f = (yield Promise.all(
-        o.map(
+      const c = I(e), i = Array.from({ length: 100 }, (m, p) => p === 0 ? c : `${c}-${p}`), f = (yield Promise.all(
+        i.map(
           (m) => this.model.exists(this.createSlugQuery({ slug: m, field: r, isObject: n, filter: u }))
         )
       )).findIndex((m) => !m);
       if (f !== -1) {
-        const m = o[f];
+        const m = i[f];
         if (m)
           return m;
       }
@@ -1024,7 +1058,7 @@ class be {
     return l(this, arguments, function* ({ field: e, from: r, filter: n }) {
       try {
         const u = r[e];
-        return T(u) ? { success: !0, result: Object.fromEntries(
+        return $(u) ? { success: !0, result: Object.fromEntries(
           yield Promise.all(
             Object.entries(u).map((a) => l(this, [a], function* ([f, m]) {
               const p = yield this.createUniqueSlug({
@@ -1062,7 +1096,7 @@ class be {
     return l(this, arguments, function* ({ slug: e, field: r, from: n, filter: u }) {
       try {
         const c = n[r];
-        if (T(c)) {
+        if ($(c)) {
           const m = Object.values(c).map((h) => I(h));
           return (yield Promise.all(
             m.map(
@@ -1075,9 +1109,9 @@ class be {
             )
           )).some((h) => h) ? { success: !0, result: !0 } : { success: !0, result: !1 };
         }
-        const o = I(e);
+        const i = I(e);
         return { success: !0, result: (yield this.model.exists(this.createSlugQuery({
-          slug: o,
+          slug: i,
           field: r,
           isObject: !1,
           filter: u

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

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

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

@@ -30,13 +30,44 @@ export declare function getNestedValue<T>(obj: T, path: (string | number)[]): un
 export declare function setNestedValue<T>(obj: T, path: (string | number)[], value: unknown): T;
 /**
  * Deep merges multiple objects or arrays into a single object or array.
- * This function handles different types of merging:
+ * This function handles different types of merging with improved type safety and error handling:
  * - If all arguments are arrays, it concatenates them
  * - If all arguments are objects, it deeply merges them (concatenating arrays within objects)
- * - Throws an error if mixed types are provided
+ * - Handles null/undefined values gracefully by treating them as empty objects
+ * - Provides better type inference and safety
+ * - Throws descriptive errors for invalid input
  *
- * @param args - The objects or arrays to merge.
+ * @param args - The objects or arrays to merge. Can be empty, in which case returns an empty object.
  * @returns The merged result - either a concatenated array or a deeply merged object.
- * @throws {Error} When arguments are mixed types (some arrays, some objects).
+ * @throws {Error} When arguments are mixed types (some arrays, some objects) or when all arguments are primitive values.
+ *
+ * @example
+ * ```typescript
+ * // Merge objects
+ * deepMerge({ a: 1 }, { b: 2 }, { a: 3 }) // { a: 3, b: 2 }
+ *
+ * // Merge arrays
+ * deepMerge([1, 2], [3, 4]) // [1, 2, 3, 4]
+ *
+ * // Handle null/undefined
+ * deepMerge({ a: 1 }, null, undefined, { b: 2 }) // { a: 1, b: 2 }
+ *
+ * // Nested objects with arrays
+ * deepMerge(
+ *   { items: [1, 2], config: { theme: 'dark' } },
+ *   { items: [3, 4], config: { size: 'large' } }
+ * ) // { items: [1, 2, 3, 4], config: { theme: 'dark', size: 'large' } }
+ * ```
+ */
+/**
+ * Deep merges multiple objects into a single object.
+ * @param args - The objects to merge. Can be empty, in which case returns an empty object.
+ * @returns The merged object.
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(...args: (T | null | undefined)[]): T;
+/**
+ * Deep merges multiple arrays into a single array.
+ * @param args - The arrays to merge. Can be empty, in which case returns an empty array.
+ * @returns The merged array.
  */
-export declare function deepMerge<T = unknown>(...args: T[]): T;
+export declare function deepMerge<T extends unknown[]>(...args: (T | null | undefined)[]): T;

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

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

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@cyberskill/shared",
     "type": "module",
-    "version": "2.4.0",
+    "version": "2.5.0",
     "description": "CyberSkill Shared",
     "author": "Stephen Cheng",
     "license": "MIT",
@@ -208,11 +208,11 @@
     },
     "dependencies": {
         "@antfu/eslint-config": "5.0.0",
-        "@apollo/client": "3.13.8",
-        "@apollo/client-integration-nextjs": "0.12.2",
+        "@apollo/client": "3.13.9",
+        "@apollo/client-integration-nextjs": "0.12.3",
         "@apollo/server": "5.0.0",
         "@as-integrations/express5": "1.1.2",
-        "@dotenvx/dotenvx": "1.48.3",
+        "@dotenvx/dotenvx": "1.48.4",
         "@eddeee888/gcg-typescript-resolver-files": "0.12.1",
         "@eslint-react/eslint-plugin": "1.52.3",
         "@graphql-codegen/cli": "5.0.7",
@@ -256,8 +256,8 @@
         "node-fetch": "3.3.2",
         "node-persist": "4.0.4",
         "qs": "6.14.0",
-        "react": "19.1.0",
-        "react-dom": "19.1.0",
+        "react": "19.1.1",
+        "react-dom": "19.1.1",
         "react-hot-toast": "2.5.2",
         "react-i18next": "15.6.1",
         "slugify": "1.6.6",
@@ -271,7 +271,7 @@
         "@commitlint/cli": "19.8.1",
         "@commitlint/config-conventional": "19.8.1",
         "@eslint/config-inspector": "1.1.0",
-        "@next/eslint-plugin-next": "15.4.4",
+        "@next/eslint-plugin-next": "15.4.5",
         "@testing-library/jest-dom": "6.6.4",
         "@testing-library/react": "16.3.0",
         "@types/apollo-upload-client": "18.0.0",
@@ -289,15 +289,15 @@
         "@types/migrate-mongo": "10.0.5",
         "@types/node": "24.1.0",
         "@types/node-persist": "3.1.8",
-        "@types/react": "19.1.8",
-        "@types/react-dom": "19.1.6",
+        "@types/react": "19.1.9",
+        "@types/react-dom": "19.1.7",
         "@types/unorm": "1.3.31",
         "@types/uuid": "10.0.0",
         "@types/ws": "8.18.1",
         "@types/yargs": "17.0.33",
         "@vitest/browser": "3.2.4",
         "eslint": "9.32.0",
-        "eslint-config-next": "15.4.4",
+        "eslint-config-next": "15.4.5",
         "glob": "11.0.3",
         "lint-staged": "16.1.2",
         "node-modules-inspector": "1.0.0",