@cyberskill/shared 1.217.0 → 2.0.0

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

@@ -1,5 +1,5 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("lodash-es"),v=require("migrate-mongo"),q=require("mongoose"),A=require("mongoose-aggregate-paginate-v2"),b=require("mongoose-paginate-v2"),T=require("uuid"),D=require("../../util/object/object.util.cjs"),x=require("../../util/common/common.util.cjs"),y=require("../fs/fs.util.cjs"),f=require("../path/path.constant.cjs"),C=require("../../util/validate/validate.util.cjs"),S=require("../../util/string/string.util.cjs"),d=require("../../constant/response-status.cjs"),i=require("../log/log.util.cjs");var I=Object.defineProperty,M=Object.defineProperties,w=Object.getOwnPropertyDescriptors,P=Object.getOwnPropertySymbols,j=Object.prototype.hasOwnProperty,F=Object.prototype.propertyIsEnumerable,_=(n,t,e)=>t in n?I(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e,h=(n,t)=>{for(var e in t||(t={}))j.call(t,e)&&_(n,e,t[e]);if(P)for(var e of P(t))F.call(t,e)&&_(n,e,t[e]);return n},R=(n,t)=>M(n,w(t)),G=(n,t,e)=>_(n,typeof t!="symbol"?t+"":t,e),o=(n,t,e)=>new Promise((r,s)=>{var u=a=>{try{l(e.next(a))}catch(m){s(m)}},c=a=>{try{l(e.throw(a))}catch(m){s(m)}},l=a=>a.done?r(a.value):Promise.resolve(a.value).then(u,c);l((e=e.apply(n,t)).next())});const g={createGenericFields(){return{id:T.v4(),isDel:!1,createdAt:new Date,updatedAt:new Date}},applyPlugins(n,t){t.filter(e=>typeof e=="function").forEach(e=>n.plugin(e))},applyMiddlewares(n,t){t.forEach(({method:e,pre:r,post:s})=>{e&&r&&n.pre(e,r),e&&s&&n.post(e,s)})},createGenericSchema(n){return new n.Schema({id:{type:String,default:T.v4,unique:!0},isDel:{type:Boolean,default:!1}},{timestamps:!0})},createSchema({mongoose:n,schema:t,virtuals:e=[],standalone:r=!1}){const s=new n.Schema(t);return e.forEach(({name:u,options:c,get:l})=>{const a=s.virtual(u,c);l&&a.get(l)}),r||s.add(g.createGenericSchema(n)),s},createModel({mongoose:n,name:t,schema:e,pagination:r=!1,aggregate:s=!1,virtuals:u=[],middlewares:c=[]}){if(!t)throw new Error("Model name is required.");if(n.models[t])return n.models[t];const l=g.createSchema({mongoose:n,schema:e,virtuals:u});return g.applyPlugins(l,[r&&b,s&&A]),g.applyMiddlewares(l,c),n.model(t,l)},validator:{isRequired(){return function(n){return o(this,null,function*(){return!C.validate.isEmpty(n)})}},isUnique(n){return function(t){return o(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}))};return!(yield this.constructor.exists(e))})}},matchesRegex(n){return function(t){return o(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))})}}},migrate:R(h({},v),{setConfig:n=>{const t=`// This file is automatically generated by the Cyberskill CLI.
-module.exports = ${JSON.stringify(n,null,4)}`;y.writeFileSync(f.PATH.MIGRATE_MONGO_CONFIG,t);const e=`
-${f.MIGRATE_MONGO_CONFIG}
-`;y.pathExistsSync(f.PATH.GIT_IGNORE)?y.readFileSync(f.PATH.GIT_IGNORE,"utf-8").split(`
-`).includes(f.MIGRATE_MONGO_CONFIG)||y.appendFileSync(f.PATH.GIT_IGNORE,e):y.writeFileSync(f.PATH.GIT_IGNORE,e)}}),regexify(n,t){if(!n)return{};let e=p.cloneDeep(n);if(!t||t.length===0)return e;for(const r of t){const s=r.toString().split("."),u=D.getNestedValue(e,s);if(typeof u=="string"&&u.length>0){const c={$regex:`.*${x.regexSearchMapper(u)}.*`,$options:"i"};e=D.setNestedValue(e,s,c)}}return e}};class U{constructor(t,e){G(this,"collection"),this.collection=t.collection(e)}createOne(t){return o(this,null,function*(){try{const e=h(h({},g.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 i.catchError(e)}})}createMany(t){return o(this,null,function*(){try{const e=t.map(s=>h(h({},g.createGenericFields()),s)),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 i.catchError(e)}})}findOne(t){return o(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 i.catchError(e)}})}findAll(){return o(this,arguments,function*(t={}){try{return{success:!0,message:"Documents retrieved successfully",result:yield this.collection.find(t).toArray()}}catch(e){return i.catchError(e)}})}count(){return o(this,arguments,function*(t={}){try{return{success:!0,message:"Count retrieved successfully",result:yield this.collection.countDocuments(t)}}catch(e){return i.catchError(e)}})}updateOne(t,e){return o(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 i.catchError(r)}})}updateMany(t,e){return o(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 i.catchError(r)}})}deleteOne(t){return o(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 i.catchError(e)}})}deleteMany(t){return o(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 i.catchError(e)}})}}class ${constructor(t){this.model=t}getModelName(){return this.model.modelName}findOne(){return o(this,arguments,function*(t={},e={},r={},s){try{const u=this.model.findOne(t,e,r);s&&u.populate(s);const c=yield u.exec();return c?{success:!0,result:c}:{success:!1,message:`No ${this.getModelName()} found.`,code:d.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(u){return i.catchError(u)}})}findAll(){return o(this,arguments,function*(t={},e={},r={},s){try{const u=this.model.find(t,e,r);return s&&u.populate(s),{success:!0,result:yield u.exec()}}catch(u){return i.catchError(u)}})}findPaging(){return o(this,arguments,function*(t={},e={}){try{return{success:!0,result:yield this.model.paginate(t,e)}}catch(r){return i.catchError(r)}})}findPagingAggregate(t){return o(this,arguments,function*(e,r={}){try{return{success:!0,result:yield this.model.aggregatePaginate(this.model.aggregate(e),r)}}catch(s){return i.catchError(s)}})}count(){return o(this,arguments,function*(t={}){try{return{success:!0,result:yield this.model.countDocuments(t)}}catch(e){return i.catchError(e)}})}createOne(t){return o(this,null,function*(){try{return{success:!0,result:yield this.model.create(t)}}catch(e){return i.catchError(e)}})}createMany(t){return o(this,arguments,function*(e,r={}){try{return{success:!0,result:(yield this.model.insertMany(e,r)).map(c=>c instanceof q.Document?c.toObject():null).filter(c=>c!==null)}}catch(s){return i.catchError(s)}})}updateOne(){return o(this,arguments,function*(t={},e={},r={}){try{const s=yield this.model.findOneAndUpdate(t,e,h({new:!0},r)).exec();return s?{success:!0,result:s}:{success:!1,message:`Failed to update ${this.getModelName()}.`,code:d.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(s){return i.catchError(s)}})}updateMany(){return o(this,arguments,function*(t={},e={},r={}){try{return{success:!0,result:yield this.model.updateMany(t,e,r).exec()}}catch(s){return i.catchError(s)}})}deleteOne(){return o(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 i.catchError(r)}})}deleteMany(){return o(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 i.catchError(r)}})}createShortId(t,e=4){return o(this,null,function*(){try{const s=new Set;for(let u=0;u<10;u++){const c=S.generateShortId(t,u+e);if(!s.has(c)&&(s.add(c),!(yield this.model.exists({shortId:c}))))return{success:!0,result:c}}return{success:!1,message:"Failed to create a unique shortId",code:d.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}}catch(r){return i.catchError(r)}})}createSlugQuery({slug:t,field:e,isObject:r,filter:s}){const u=h({},s!=null?s:{});return r?R(h({},u),{$or:[{[`slug.${e}`]:t},{slugHistory:{$elemMatch:{[`slug.${e}`]:t}}}]}):R(h({},u),{$or:[{slug:t},{slugHistory:t}]})}createUniqueSlug(t){return o(this,arguments,function*({slug:e,field:r,isObject:s,filter:u}){const c=S.generateSlug(e);let l=c,a=1;for(;yield this.model.exists(this.createSlugQuery({slug:l,field:r,isObject:s,filter:u}));)l=`${c}-${a++}`;return l})}createSlug(t){return o(this,arguments,function*({field:e,from:r,filter:s}){try{const u=r[e];return p.isObject(u)?{success:!0,result:Object.fromEntries(yield Promise.all(Object.entries(u).map(m=>o(this,[m],function*([E,O]){const N=yield this.createUniqueSlug({slug:O,field:E,isObject:!0,filter:s});return[E,N]}))))}:{success:!0,result:yield this.createUniqueSlug({slug:u,field:e,isObject:!1,filter:s})}}catch(u){return i.catchError(u)}})}checkSlug(t){return o(this,arguments,function*({slug:e,field:r,from:s,filter:u}){try{const c=s[r];if(p.isObject(c)){for(const E of Object.values(c)){const O=S.generateSlug(E);if(yield this.model.exists(this.createSlugQuery({slug:O,field:r,isObject:!0,filter:u})))return{success:!0,result:!0}}return{success:!0,result:!1}}const a=S.generateSlug(e);return{success:!0,result:(yield this.model.exists(this.createSlugQuery({slug:a,field:r,isObject:!1,filter:u})))!==null}}catch(c){return i.catchError(c)}})}aggregate(t){return o(this,null,function*(){try{return{success:!0,result:yield this.model.aggregate(t)}}catch(e){return i.catchError(e)}})}}exports.aggregatePaginate=A;exports.mongoosePaginate=b;exports.MongoController=U;exports.MongooseController=$;exports.mongo=g;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const R=require("lodash-es"),C=require("migrate-mongo"),x=require("mongoose"),b=require("mongoose-aggregate-paginate-v2"),v=require("mongoose-paginate-v2"),P=require("uuid"),D=require("../../util/object/object.util.cjs"),I=require("../../util/common/common.util.cjs"),p=require("../fs/fs.util.cjs"),g=require("../path/path.constant.cjs"),q=require("../../util/validate/validate.util.cjs"),_=require("../../util/string/string.util.cjs"),d=require("../../constant/response-status.cjs"),i=require("../log/log.util.cjs");var M=Object.defineProperty,w=Object.defineProperties,j=Object.getOwnPropertyDescriptors,A=Object.getOwnPropertySymbols,F=Object.prototype.hasOwnProperty,G=Object.prototype.propertyIsEnumerable,N=(n,t,e)=>t in n?M(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e,f=(n,t)=>{for(var e in t||(t={}))F.call(t,e)&&N(n,e,t[e]);if(A)for(var e of A(t))G.call(t,e)&&N(n,e,t[e]);return n},T=(n,t)=>w(n,j(t)),U=(n,t,e)=>N(n,typeof t!="symbol"?t+"":t,e),o=(n,t,e)=>new Promise((r,s)=>{var c=a=>{try{l(e.next(a))}catch(m){s(m)}},u=a=>{try{l(e.throw(a))}catch(m){s(m)}},l=a=>a.done?r(a.value):Promise.resolve(a.value).then(c,u);l((e=e.apply(n,t)).next())});const y={createGenericFields(){return{id:P.v4(),isDel:!1,createdAt:new Date,updatedAt:new Date}},applyPlugins(n,t){t.filter(e=>typeof e=="function").forEach(e=>n.plugin(e))},applyMiddlewares(n,t){t.forEach(({method:e,pre:r,post:s})=>{e&&r&&n.pre(e,r),e&&s&&n.post(e,s)})},createGenericSchema(n){return new n.Schema({id:{type:String,default:P.v4,unique:!0},isDel:{type:Boolean,default:!1}},{timestamps:!0})},createSchema({mongoose:n,schema:t,virtuals:e=[],standalone:r=!1}){const s=new n.Schema(t);return e.forEach(({name:c,options:u,get:l})=>{const a=s.virtual(c,u);l&&a.get(l)}),r||s.add(y.createGenericSchema(n)),s},createModel({mongoose:n,name:t,schema:e,pagination:r=!1,aggregate:s=!1,virtuals:c=[],middlewares:u=[]}){if(!t)throw new Error("Model name is required.");if(n.models[t])return n.models[t];const l=y.createSchema({mongoose:n,schema:e,virtuals:c});return y.applyPlugins(l,[r&&v,s&&b]),y.applyMiddlewares(l,u),n.model(t,l)},validator:{isRequired(){return function(n){return o(this,null,function*(){return!q.validate.isEmpty(n)})}},isUnique(n){return function(t){return o(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}))};return!(yield this.constructor.exists(e))})}},matchesRegex(n){return function(t){return o(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))})}}},migrate:T(f({},C),{setConfig:n=>{const t=`// This file is automatically generated by the Cyberskill CLI.
+module.exports = ${JSON.stringify(n,null,4)}`;p.writeFileSync(g.PATH.MIGRATE_MONGO_CONFIG,t);const e=`
+${g.MIGRATE_MONGO_CONFIG}
+`;p.pathExistsSync(g.PATH.GIT_IGNORE)?p.readFileSync(g.PATH.GIT_IGNORE,"utf-8").split(`
+`).includes(g.MIGRATE_MONGO_CONFIG)||p.appendFileSync(g.PATH.GIT_IGNORE,e):p.writeFileSync(g.PATH.GIT_IGNORE,e)}}),regexify(n,t){if(!n)return{};let e=R.cloneDeep(n);if(!t||t.length===0)return e;for(const r of t){const s=r.toString().split("."),c=D.getNestedValue(e,s);if(typeof c=="string"&&c.length>0){const u={$regex:`.*${I.regexSearchMapper(c)}.*`,$options:"i"};e=D.setNestedValue(e,s,u)}}return e}};class ${constructor(t,e){U(this,"collection"),this.collection=t.collection(e)}createOne(t){return o(this,null,function*(){try{const e=f(f({},y.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 i.catchError(e)}})}createMany(t){return o(this,null,function*(){try{const e=t.map(s=>f(f({},y.createGenericFields()),s)),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 i.catchError(e)}})}findOne(t){return o(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 i.catchError(e)}})}findAll(){return o(this,arguments,function*(t={}){try{return{success:!0,message:"Documents retrieved successfully",result:yield this.collection.find(t).toArray()}}catch(e){return i.catchError(e)}})}count(){return o(this,arguments,function*(t={}){try{return{success:!0,message:"Count retrieved successfully",result:yield this.collection.countDocuments(t)}}catch(e){return i.catchError(e)}})}updateOne(t,e){return o(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 i.catchError(r)}})}updateMany(t,e){return o(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 i.catchError(r)}})}deleteOne(t){return o(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 i.catchError(e)}})}deleteMany(t){return o(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 i.catchError(e)}})}}class V{constructor(t){this.model=t}getModelName(){return this.model.modelName}findOne(){return o(this,arguments,function*(t={},e={},r={},s){try{const c=this.model.findOne(t,e,r);s&&c.populate(s);const u=yield c.exec();return u?{success:!0,result:u}:{success:!1,message:`No ${this.getModelName()} found.`,code:d.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(c){return i.catchError(c)}})}findAll(){return o(this,arguments,function*(t={},e={},r={},s){try{const c=this.model.find(t,e,r);return s&&c.populate(s),{success:!0,result:yield c.exec()}}catch(c){return i.catchError(c)}})}findPaging(){return o(this,arguments,function*(t={},e={}){try{return{success:!0,result:yield this.model.paginate(t,e)}}catch(r){return i.catchError(r)}})}findPagingAggregate(t){return o(this,arguments,function*(e,r={}){try{return{success:!0,result:yield this.model.aggregatePaginate(this.model.aggregate(e),r)}}catch(s){return i.catchError(s)}})}count(){return o(this,arguments,function*(t={}){try{return{success:!0,result:yield this.model.countDocuments(t)}}catch(e){return i.catchError(e)}})}createOne(t){return o(this,null,function*(){try{return{success:!0,result:yield this.model.create(t)}}catch(e){return i.catchError(e)}})}createMany(t){return o(this,arguments,function*(e,r={}){try{return{success:!0,result:(yield this.model.insertMany(e,r)).map(u=>u instanceof x.Document?u.toObject():null).filter(u=>u!==null)}}catch(s){return i.catchError(s)}})}updateOne(){return o(this,arguments,function*(t={},e={},r={}){try{const s=yield this.model.findOneAndUpdate(t,e,f({new:!0},r)).exec();return s?{success:!0,result:s}:{success:!1,message:`Failed to update ${this.getModelName()}.`,code:d.RESPONSE_STATUS.NOT_FOUND.CODE}}catch(s){return i.catchError(s)}})}updateMany(){return o(this,arguments,function*(t={},e={},r={}){try{return{success:!0,result:yield this.model.updateMany(t,e,r).exec()}}catch(s){return i.catchError(s)}})}deleteOne(){return o(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 i.catchError(r)}})}deleteMany(){return o(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 i.catchError(r)}})}createShortId(t,e=4){return o(this,null,function*(){try{const s=Array.from({length:10},(l,a)=>_.generateShortId(t,a+e)),u=(yield Promise.all(s.map(l=>this.model.exists({shortId:l})))).findIndex(l=>!l);if(u!==-1){const l=s[u];if(l)return{success:!0,result:l}}return{success:!1,message:"Failed to create a unique shortId",code:d.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}}catch(r){return i.catchError(r)}})}createSlugQuery({slug:t,field:e,isObject:r,filter:s}){const c=f({},s!=null?s:{});return r?T(f({},c),{$or:[{[`slug.${e}`]:t},{slugHistory:{$elemMatch:{[`slug.${e}`]:t}}}]}):T(f({},c),{$or:[{slug:t},{slugHistory:t}]})}createUniqueSlug(t){return o(this,arguments,function*({slug:e,field:r,isObject:s,filter:c}){const u=_.generateSlug(e),a=Array.from({length:100},(h,S)=>S===0?u:`${u}-${S}`),E=(yield Promise.all(a.map(h=>this.model.exists(this.createSlugQuery({slug:h,field:r,isObject:s,filter:c}))))).findIndex(h=>!h);if(E!==-1){const h=a[E];if(h)return h}return`${u}-${Date.now()}`})}createSlug(t){return o(this,arguments,function*({field:e,from:r,filter:s}){try{const c=r[e];return R.isObject(c)?{success:!0,result:Object.fromEntries(yield Promise.all(Object.entries(c).map(m=>o(this,[m],function*([E,h]){const S=yield this.createUniqueSlug({slug:h,field:E,isObject:!0,filter:s});return[E,S]}))))}:{success:!0,result:yield this.createUniqueSlug({slug:c,field:e,isObject:!1,filter:s})}}catch(c){return i.catchError(c)}})}checkSlug(t){return o(this,arguments,function*({slug:e,field:r,from:s,filter:c}){try{const u=s[r];if(R.isObject(u)){const h=Object.values(u).map(O=>_.generateSlug(O));return(yield Promise.all(h.map(O=>this.model.exists(this.createSlugQuery({slug:O,field:r,isObject:!0,filter:c}))))).some(O=>O)?{success:!0,result:!0}:{success:!0,result:!1}}const a=_.generateSlug(e);return{success:!0,result:(yield this.model.exists(this.createSlugQuery({slug:a,field:r,isObject:!1,filter:c})))!==null}}catch(u){return i.catchError(u)}})}aggregate(t){return o(this,null,function*(){try{return{success:!0,result:yield this.model.aggregate(t)}}catch(e){return i.catchError(e)}})}}exports.aggregatePaginate=b;exports.mongoosePaginate=v;exports.MongoController=$;exports.MongooseController=V;exports.mongo=y;

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

@@ -3,12 +3,47 @@ import { default as migrate } from 'migrate-mongo';
 import { default as aggregatePaginate } from 'mongoose-aggregate-paginate-v2';
 import { default as mongoosePaginate } from 'mongoose-paginate-v2';
 import { I_Return } from '../../typescript/index.js';
-import { C_Db, C_Document, I_CreateModelOptions, I_CreateSchemaOptions, I_DeleteOptionsExtended, I_ExtendedModel, I_GenericDocument, I_Input_CheckSlug, I_Input_CreateSlug, I_Input_GenerateSlug, I_MongooseModelMiddleware, I_UpdateOptionsExtended, T_AggregatePaginateResult, T_DeleteResult, T_Filter, T_FilterQuery, T_Input_Populate, T_InsertManyOptions, T_MongoosePlugin, T_MongooseShema, T_PaginateOptionsWithPopulate, T_PaginateResult, T_PipelineStage, T_ProjectionType, T_QueryOptions, T_UpdateQuery, T_UpdateResult, T_WithId } from './mongo.type.js';
+import { C_Db, C_Document, I_CreateModelOptions, I_CreateSchemaOptions, I_DeleteOptionsExtended, I_ExtendedModel, I_GenericDocument, I_Input_CheckSlug, I_Input_CreateSlug, I_Input_GenerateSlug, I_MongooseModelMiddleware, I_PaginateOptionsWithPopulate, I_UpdateOptionsExtended, T_AggregatePaginateResult, T_DeleteResult, T_Filter, T_FilterQuery, T_Input_Populate, T_InsertManyOptions, T_MongoosePlugin, T_MongooseShema, T_PaginateResult, T_PipelineStage, T_ProjectionType, T_QueryOptions, T_UpdateQuery, T_UpdateResult, T_WithId } from './mongo.type.js';
 export { aggregatePaginate, mongoosePaginate };
+/**
+ * MongoDB utility object providing comprehensive database operations and utilities.
+ * This object contains methods for creating generic fields, applying plugins and middlewares,
+ * creating schemas and models, validation functions, migration utilities, and regex filtering.
+ */
 export declare const mongo: {
+    /**
+     * Creates generic fields that are commonly used across MongoDB documents.
+     * This function generates standard fields including a UUID, deletion flag, and timestamps
+     * that can be applied to any document schema.
+     *
+     * @returns An object containing generic document fields (id, isDel, createdAt, updatedAt).
+     */
     createGenericFields(): I_GenericDocument;
+    /**
+     * Applies plugins to a Mongoose schema.
+     * This function filters out falsy plugins and applies the remaining valid plugins
+     * to the provided schema.
+     *
+     * @param schema - The Mongoose schema to apply plugins to.
+     * @param plugins - An array of plugin functions or false values to filter and apply.
+     */
     applyPlugins<T>(schema: T_MongooseShema<T>, plugins: Array<T_MongoosePlugin | false>): void;
+    /**
+     * Applies middleware functions to a Mongoose schema.
+     * This function configures pre and post middleware for specified methods on the schema.
+     *
+     * @param schema - The Mongoose schema to apply middleware to.
+     * @param middlewares - An array of middleware configurations with method, pre, and post functions.
+     */
     applyMiddlewares<T extends Partial<C_Document>>(schema: T_MongooseShema<T>, middlewares: I_MongooseModelMiddleware<T>[]): void;
+    /**
+     * Creates a generic Mongoose schema with common fields.
+     * This function creates a base schema with UUID field and deletion flag,
+     * configured with automatic timestamps.
+     *
+     * @param mongoose - The Mongoose instance to create the schema with.
+     * @returns A Mongoose schema with generic document fields.
+     */
     createGenericSchema(mongoose: typeof mongooseRaw): mongooseRaw.Schema<I_GenericDocument, mongooseRaw.Model<I_GenericDocument, any, any, any, mongooseRaw.Document<unknown, any, I_GenericDocument, any> & I_GenericDocument & Required<{
         _id: unknown;
     }> & {
@@ -18,18 +53,86 @@ export declare const mongo: {
     }> & {
         __v: number;
     }>;
+    /**
+     * Creates a Mongoose schema with optional virtual fields and generic fields.
+     * This function creates a new Mongoose schema from the provided schema definition,
+     * optionally adds virtual fields, and includes generic fields (unless standalone is true).
+     *
+     * @param options - Configuration options including mongoose instance, schema definition, virtuals, and standalone flag.
+     * @param options.mongoose - The Mongoose instance to use for schema creation.
+     * @param options.schema - The schema definition object.
+     * @param options.virtuals - Optional array of virtual field configurations.
+     * @param options.standalone - Whether to exclude generic fields (default: false).
+     * @returns A configured Mongoose schema.
+     */
     createSchema<T>({ mongoose, schema, virtuals, standalone, }: I_CreateSchemaOptions<T>): T_MongooseShema<T>;
+    /**
+     * Creates a Mongoose model with plugins, middleware, and pagination support.
+     * This function creates a model from a schema with optional pagination and aggregation plugins,
+     * and applies any specified middleware. If a model with the same name already exists, it returns the existing model.
+     *
+     * @param options - Configuration options including mongoose instance, model name, schema, and feature flags.
+     * @param options.mongoose - The Mongoose instance to use for model creation.
+     * @param options.name - The name of the model to create.
+     * @param options.schema - The schema definition for the model.
+     * @param options.pagination - Whether to enable pagination plugin (default: false).
+     * @param options.aggregate - Whether to enable aggregation pagination plugin (default: false).
+     * @param options.virtuals - Optional array of virtual field configurations.
+     * @param options.middlewares - Optional array of middleware configurations.
+     * @returns A configured Mongoose model with extended functionality.
+     * @throws {Error} When the model name is not provided.
+     */
     createModel<T extends Partial<C_Document>>({ mongoose: currentMongooseInstance, name, schema, pagination, aggregate, virtuals, middlewares, }: I_CreateModelOptions<T>): I_ExtendedModel<T>;
+    /**
+     * Validation utilities for Mongoose schemas.
+     * This object provides common validation functions that can be used in Mongoose schema definitions.
+     */
     validator: {
+        /**
+         * Creates a required field validator.
+         * This function returns a validator that checks if a field value is not empty
+         * using the validate.isEmpty utility.
+         *
+         * @returns A validation function that returns true if the field is not empty.
+         */
         isRequired<T>(): (this: T, value: unknown) => Promise<boolean>;
+        /**
+         * Creates a unique field validator.
+         * This function returns a validator that checks if a field value is unique
+         * across the specified fields in the collection.
+         *
+         * @param fields - An array of field names to check for uniqueness.
+         * @returns A validation function that returns true if the value is unique across the specified fields.
+         * @throws {Error} When fields is not a non-empty array of strings.
+         */
         isUnique<T extends {
             constructor: {
                 exists: (query: Record<string, unknown>) => Promise<unknown>;
             };
         }>(fields: string[]): (this: T, value: unknown) => Promise<boolean>;
+        /**
+         * Creates a regex pattern validator.
+         * This function returns a validator that checks if a string value matches
+         * all provided regular expressions.
+         *
+         * @param regexArray - An array of regular expressions to test against the value.
+         * @returns A validation function that returns true if the value matches all regex patterns.
+         * @throws {Error} When regexArray is not an array of valid RegExp objects.
+         */
         matchesRegex(regexArray: RegExp[]): (value: string) => Promise<boolean>;
     };
+    /**
+     * Migration utilities for MongoDB.
+     * This object extends the migrate-mongo library with additional configuration utilities.
+     */
     migrate: {
+        /**
+         * Sets the migration configuration and updates .gitignore.
+         * This function creates a migration configuration file and ensures it's properly
+         * excluded from version control.
+         *
+         * @param options - Migration configuration options to write to the config file.
+         */
         setConfig: (options: Partial<migrate.config.Config>) => void;
         init(): Promise<void>;
         create(description: string): Promise<string>;
@@ -39,37 +142,230 @@ export declare const mongo: {
         database: typeof migrate.database;
         config: typeof migrate.config;
     };
+    /**
+     * Converts string values in a filter to regex patterns for case-insensitive search.
+     * This function recursively processes a filter object and converts string values in specified fields
+     * to MongoDB regex patterns that support accented character matching.
+     *
+     * @param filter - The filter object to process.
+     * @param fields - An array of field names to convert to regex patterns.
+     * @returns A new filter object with string values converted to regex patterns.
+     */
     regexify<T>(filter?: T_FilterQuery<T>, fields?: (keyof T | string)[]): T_FilterQuery<T>;
 };
+/**
+ * MongoDB native driver controller for direct database operations.
+ * This class provides a simplified interface for MongoDB operations using the native driver,
+ * with automatic generic field generation and standardized response formatting.
+ */
 export declare class MongoController<D extends Partial<C_Document>> {
     private collection;
+    /**
+     * Creates a new MongoDB controller instance.
+     *
+     * @param db - The MongoDB database instance.
+     * @param collectionName - The name of the collection to operate on.
+     */
     constructor(db: C_Db, collectionName: string);
+    /**
+     * Creates a single document in the collection.
+     * This method adds generic fields (id, isDel, timestamps) to the document before insertion.
+     *
+     * @param document - The document to create, with or without generic fields.
+     * @returns A promise that resolves to a standardized response with the created document.
+     */
     createOne(document: D | Partial<D>): Promise<I_Return<D | Partial<D>>>;
+    /**
+     * Creates multiple documents in the collection.
+     * This method adds generic fields to each document before bulk insertion.
+     *
+     * @param documents - An array of documents to create.
+     * @returns A promise that resolves to a standardized response with the created documents.
+     */
     createMany(documents: (D | Partial<D>)[]): Promise<I_Return<(D | Partial<D>)[]>>;
+    /**
+     * Finds a single document by filter criteria.
+     *
+     * @param filter - The filter criteria to find the document.
+     * @returns A promise that resolves to a standardized response with the found document.
+     */
     findOne(filter: T_Filter<D>): Promise<I_Return<T_WithId<D>>>;
+    /**
+     * Finds all documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find documents (defaults to empty object for all documents).
+     * @returns A promise that resolves to a standardized response with the found documents.
+     */
     findAll(filter?: T_Filter<D>): Promise<I_Return<T_WithId<D>[]>>;
+    /**
+     * Counts documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to count documents (defaults to empty object for all documents).
+     * @returns A promise that resolves to a standardized response with the document count.
+     */
     count(filter?: T_Filter<D>): Promise<I_Return<number>>;
+    /**
+     * Updates a single document matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find the document to update.
+     * @param update - The update data to apply to the document.
+     * @returns A promise that resolves to a standardized response with the update result.
+     */
     updateOne(filter: T_Filter<D>, update: Partial<D>): Promise<I_Return<T_UpdateResult>>;
+    /**
+     * Updates multiple documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find documents to update.
+     * @param update - The update data to apply to the documents.
+     * @returns A promise that resolves to a standardized response with the update result.
+     */
     updateMany(filter: T_Filter<D>, update: Partial<D>): Promise<I_Return<T_UpdateResult>>;
+    /**
+     * Deletes a single document matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find the document to delete.
+     * @returns A promise that resolves to a standardized response with the delete result.
+     */
     deleteOne(filter: T_Filter<D>): Promise<I_Return<T_DeleteResult>>;
+    /**
+     * Deletes multiple documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find documents to delete.
+     * @returns A promise that resolves to a standardized response with the delete result.
+     */
     deleteMany(filter: T_Filter<D>): Promise<I_Return<T_DeleteResult>>;
 }
+/**
+ * Mongoose controller for database operations with advanced features.
+ * This class provides a comprehensive interface for Mongoose operations including
+ * pagination, aggregation, slug generation, and short ID creation.
+ */
 export declare class MongooseController<T extends Partial<C_Document>> {
     private model;
+    /**
+     * Creates a new Mongoose controller instance.
+     *
+     * @param model - The Mongoose model to operate on.
+     */
     constructor(model: I_ExtendedModel<T>);
+    /**
+     * Gets the model name for logging and error messages.
+     *
+     * @returns The name of the model.
+     */
     private getModelName;
+    /**
+     * Finds a single document with optional population and projection.
+     *
+     * @param filter - The filter criteria to find the document.
+     * @param projection - The fields to include/exclude in the result.
+     * @param options - Query options for the operation.
+     * @param populate - Population configuration for related documents.
+     * @returns A promise that resolves to a standardized response with the found document.
+     */
     findOne(filter?: T_FilterQuery<T>, projection?: T_ProjectionType<T>, options?: T_QueryOptions<T>, populate?: T_Input_Populate): Promise<I_Return<T>>;
+    /**
+     * Finds all documents with optional population and projection.
+     *
+     * @param filter - The filter criteria to find documents.
+     * @param projection - The fields to include/exclude in the result.
+     * @param options - Query options for the operation.
+     * @param populate - Population configuration for related documents.
+     * @returns A promise that resolves to a standardized response with the found documents.
+     */
     findAll(filter?: T_FilterQuery<T>, projection?: T_ProjectionType<T>, options?: T_QueryOptions<T>, populate?: T_Input_Populate): Promise<I_Return<T[]>>;
-    findPaging(filter?: T_FilterQuery<T>, options?: T_PaginateOptionsWithPopulate): Promise<I_Return<T_PaginateResult<T>>>;
-    findPagingAggregate(pipeline: T_PipelineStage[], options?: T_PaginateOptionsWithPopulate): Promise<I_Return<T_AggregatePaginateResult<T>>>;
+    /**
+     * Finds documents with pagination support.
+     *
+     * @param filter - The filter criteria to find documents.
+     * @param options - Pagination options including page, limit, and population.
+     * @returns A promise that resolves to a standardized response with paginated results.
+     */
+    findPaging(filter?: T_FilterQuery<T>, options?: I_PaginateOptionsWithPopulate): Promise<I_Return<T_PaginateResult<T>>>;
+    /**
+     * Performs aggregation with pagination support.
+     *
+     * @param pipeline - The aggregation pipeline stages.
+     * @param options - Pagination options for the aggregation result.
+     * @returns A promise that resolves to a standardized response with paginated aggregation results.
+     */
+    findPagingAggregate(pipeline: T_PipelineStage[], options?: I_PaginateOptionsWithPopulate): Promise<I_Return<T_AggregatePaginateResult<T>>>;
+    /**
+     * Counts documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to count documents.
+     * @returns A promise that resolves to a standardized response with the document count.
+     */
     count(filter?: T_FilterQuery<T>): Promise<I_Return<number>>;
+    /**
+     * Creates a single document.
+     *
+     * @param doc - The document to create.
+     * @returns A promise that resolves to a standardized response with the created document.
+     */
     createOne(doc: T | Partial<T>): Promise<I_Return<T>>;
+    /**
+     * Creates multiple documents with bulk insertion.
+     *
+     * @param docs - An array of documents to create.
+     * @param options - Options for the bulk insertion operation.
+     * @returns A promise that resolves to a standardized response with the created documents.
+     */
     createMany(docs: (T | Partial<T>)[], options?: T_InsertManyOptions): Promise<I_Return<T[]>>;
+    /**
+     * Updates a single document and returns the updated version.
+     *
+     * @param filter - The filter criteria to find the document to update.
+     * @param update - The update data to apply.
+     * @param options - Options for the update operation.
+     * @returns A promise that resolves to a standardized response with the updated document.
+     */
     updateOne(filter?: T_FilterQuery<T>, update?: T_UpdateQuery<T>, options?: I_UpdateOptionsExtended): Promise<I_Return<T>>;
+    /**
+     * Updates multiple documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find documents to update.
+     * @param update - The update data to apply.
+     * @param options - Options for the update operation.
+     * @returns A promise that resolves to a standardized response with the update result.
+     */
     updateMany(filter?: T_FilterQuery<T>, update?: T_UpdateQuery<T>, options?: I_UpdateOptionsExtended): Promise<I_Return<T_UpdateResult>>;
+    /**
+     * Deletes a single document and returns the deleted version.
+     *
+     * @param filter - The filter criteria to find the document to delete.
+     * @param options - Options for the delete operation.
+     * @returns A promise that resolves to a standardized response with the deleted document.
+     */
     deleteOne(filter?: T_FilterQuery<T>, options?: I_DeleteOptionsExtended): Promise<I_Return<T>>;
+    /**
+     * Deletes multiple documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find documents to delete.
+     * @param options - Options for the delete operation.
+     * @returns A promise that resolves to a standardized response with the delete result.
+     */
     deleteMany(filter?: T_FilterQuery<T>, options?: I_DeleteOptionsExtended): Promise<I_Return<T_DeleteResult>>;
+    /**
+     * Creates a unique short ID based on a given ID.
+     * This method generates multiple short IDs with increasing lengths and finds the first available one.
+     *
+     * @param id - The base ID to generate short IDs from.
+     * @param length - The initial length for short ID generation (default: 4).
+     * @returns A promise that resolves to a standardized response with the unique short ID.
+     */
     createShortId(id: string, length?: number): Promise<I_Return<string>>;
+    /**
+     * Creates a query for slug existence checking.
+     * This method generates a query that checks for slug existence in both current and historical slug fields.
+     *
+     * @param options - Configuration for slug query generation including slug, field, and filter.
+     * @param options.slug - The slug string to check for existence.
+     * @param options.field - The field name for object-based slug checking.
+     * @param options.isObject - Whether the slug is stored as an object with nested fields.
+     * @param options.filter - Additional filter conditions to apply to the query.
+     * @returns A MongoDB query object for checking slug existence.
+     */
     createSlugQuery({ slug, field, isObject, filter }: I_Input_GenerateSlug<T>): {
         $or: ({
             [x: string]: string;
@@ -226,8 +522,46 @@ export declare class MongooseController<T extends Partial<C_Document>> {
         $comment?: string;
         $expr?: Record<string, any>;
     };
+    /**
+     * Creates a unique slug based on a given string.
+     * This method generates multiple slug variations and finds the first available one.
+     *
+     * @param options - Configuration for slug generation including slug, field, and filter.
+     * @param options.slug - The base slug string to make unique.
+     * @param options.field - The field name for object-based slug checking.
+     * @param options.isObject - Whether the slug is stored as an object with nested fields.
+     * @param options.filter - Additional filter conditions to apply when checking slug existence.
+     * @returns A promise that resolves to a unique slug string.
+     */
     createUniqueSlug({ slug, field, isObject, filter }: I_Input_GenerateSlug<T>): Promise<string>;
+    /**
+     * Creates a slug for a document field.
+     * This method handles both simple string fields and object fields with nested slug generation.
+     *
+     * @param options - Configuration for slug creation including field, source document, and filter.
+     * @param options.field - The field name to create a slug for.
+     * @param options.from - The source document containing the field value.
+     * @param options.filter - Additional filter conditions to apply when checking slug existence.
+     * @returns A promise that resolves to a standardized response with the created slug(s).
+     */
     createSlug<R = string>({ field, from, filter }: I_Input_CreateSlug<T>): Promise<I_Return<R>>;
+    /**
+     * Checks if a slug already exists in the collection.
+     * This method verifies slug existence in both current and historical slug fields.
+     *
+     * @param options - Configuration for slug checking including slug, field, source document, and filter.
+     * @param options.slug - The slug string to check for existence.
+     * @param options.field - The field name for object-based slug checking.
+     * @param options.from - The source document containing the field value.
+     * @param options.filter - Additional filter conditions to apply to the query.
+     * @returns A promise that resolves to a standardized response indicating whether the slug exists.
+     */
     checkSlug({ slug, field, from, filter }: I_Input_CheckSlug<T>): Promise<I_Return<boolean>>;
+    /**
+     * Performs aggregation operations on the collection.
+     *
+     * @param pipeline - The aggregation pipeline stages to execute.
+     * @returns A promise that resolves to a standardized response with the aggregation results.
+     */
     aggregate(pipeline: T_PipelineStage[]): Promise<I_Return<T[]>>;
 }