@cyberskill/shared 2.3.1 → 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/node/upload/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./upload.type.cjs"),e=require("./upload.util.cjs");Object.defineProperty(exports,"E_UploadType",{enumerable:!0,get:()=>o.E_UploadType});exports.createUploadConfig=e.createUploadConfig;exports.upload=e.upload;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./upload.constant.cjs"),a=require("./upload.type.cjs"),e=require("./upload.util.cjs");exports.BYTES_PER_MB=t.BYTES_PER_MB;Object.defineProperty(exports,"E_UploadType",{enumerable:!0,get:()=>a.E_UploadType});exports.createUploadConfig=e.createUploadConfig;exports.getAndValidateFile=e.getAndValidateFile;exports.getFileSizeFromStream=e.getFileSizeFromStream;exports.getFileWebStream=e.getFileWebStream;exports.upload=e.upload;exports.validateFileExtension=e.validateFileExtension;exports.validateUpload=e.validateUpload;

package/dist/node/upload/index.d.ts

@@ -1,2 +1,3 @@
+export * from './upload.constant.js';
 export * from './upload.type.js';
 export * from './upload.util.js';

package/dist/node/upload/index.js

@@ -1,7 +1,14 @@
-import { E_UploadType as e } from "./upload.type.js";
-import { createUploadConfig as a, upload as d } from "./upload.util.js";
+import { BYTES_PER_MB as o } from "./upload.constant.js";
+import { E_UploadType as l } from "./upload.type.js";
+import { createUploadConfig as r, getAndValidateFile as d, getFileSizeFromStream as p, getFileWebStream as m, upload as F, validateFileExtension as f, validateUpload as g } from "./upload.util.js";
 export {
-  e as E_UploadType,
-  a as createUploadConfig,
-  d as upload
+  o as BYTES_PER_MB,
+  l as E_UploadType,
+  r as createUploadConfig,
+  d as getAndValidateFile,
+  p as getFileSizeFromStream,
+  m as getFileWebStream,
+  F as upload,
+  f as validateFileExtension,
+  g as validateUpload
 };

package/dist/node/upload/upload.constant.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=1024*1024;exports.BYTES_PER_MB=e;

package/dist/node/upload/upload.constant.d.ts

@@ -0,0 +1 @@
+export declare const BYTES_PER_MB: number;

package/dist/node/upload/upload.constant.js

@@ -0,0 +1,4 @@
+const o = 1048576;
+export {
+  o as BYTES_PER_MB
+};

package/dist/node/upload/upload.type.d.ts

@@ -18,19 +18,16 @@ export interface I_UploadConfig {
     [E_UploadType.DOCUMENT]: I_UploadTypeConfig;
     [E_UploadType.OTHER]: I_UploadTypeConfig;
 }
+export interface I_UploadFileData {
+    createReadStream: () => NodeJS.ReadableStream;
+    filename: string;
+}
+export interface I_UploadFile {
+    file: I_UploadFileData;
+}
 export interface I_UploadOptions {
-    file: Promise<{
-        file: {
-            createReadStream: () => NodeJS.ReadableStream;
-            filename: string;
-        };
-    }>;
+    file: Promise<I_UploadFile>;
     path: string;
     type: E_UploadType;
     config?: I_UploadConfig;
 }
-export interface I_UploadResult {
-    success: boolean;
-    message: string;
-    result: string;
-}

package/dist/node/upload/upload.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("./upload.type.cjs"),_=require("../path/path.util.cjs"),m=require("../fs/fs.util.cjs");var x=Object.defineProperty,v=Object.getOwnPropertySymbols,h=Object.prototype.hasOwnProperty,z=Object.prototype.propertyIsEnumerable,E=(t,r,e)=>r in t?x(t,r,{enumerable:!0,configurable:!0,writable:!0,value:e}):t[r]=e,g=(t,r)=>{for(var e in r||(r={}))h.call(r,e)&&E(t,e,r[e]);if(v)for(var e of v(r))z.call(r,e)&&E(t,e,r[e]);return t},w=(t,r,e)=>new Promise((i,l)=>{var n=o=>{try{a(e.next(o))}catch(u){l(u)}},s=o=>{try{a(e.throw(o))}catch(u){l(u)}},a=o=>o.done?i(o.value):Promise.resolve(o.value).then(n,s);a((e=e.apply(t,r)).next())});function O(t){return w(this,null,function*(){return new Promise((r,e)=>{let i=0;t.on("data",l=>{i+=l.length}),t.on("end",()=>r(i)),t.on("error",e)})})}function S(t,r){const e=t.lastIndexOf(".");if(e===-1)return!1;const i=t.substring(e+1).toLowerCase();return r.includes(i)}function T(t,r,e){const{filename:i,fileSize:l}=t,n=r[e],{allowedExtensions:s,sizeLimit:a}=n;if(!S(i,s))return{isValid:!1,error:`File extension not allowed for ${e.toLowerCase()} files. Allowed extensions: ${s.join(", ")}`};if(l!==void 0&&l>a){const o=Math.round(a/1048576);return{isValid:!1,error:`File size exceeds limit for ${e.toLowerCase()} files. Maximum size: ${o}MB`}}return{isValid:!0}}function U(t){const r={[f.E_UploadType.IMAGE]:{allowedExtensions:["jpg","jpeg","png","gif","webp","svg"],sizeLimit:5242880},[f.E_UploadType.VIDEO]:{allowedExtensions:["mp4","avi","mov","wmv","flv","webm"],sizeLimit:524288e3},[f.E_UploadType.DOCUMENT]:{allowedExtensions:["pdf","doc","docx","txt","rtf"],sizeLimit:10485760},[f.E_UploadType.OTHER]:{allowedExtensions:["zip","rar","tar","gz"],sizeLimit:5242880}};return g(g({},r),t)}function I(t){return w(this,null,function*(){const{path:r,file:e,config:i,type:l}=t;if(!r||typeof r!="string")return{success:!1,message:"Invalid path provided",result:""};if(!e||typeof e!="object")return{success:!1,message:"Invalid file provided",result:""};if(i){const n=[f.E_UploadType.IMAGE,f.E_UploadType.VIDEO,f.E_UploadType.DOCUMENT,f.E_UploadType.OTHER];for(const s of n){if(!i[s]||!Array.isArray(i[s].allowedExtensions)||i[s].allowedExtensions.length===0)return{success:!1,message:`Invalid config for ${s.toLowerCase()} files`,result:""};if(typeof i[s].sizeLimit!="number"||i[s].sizeLimit<=0)return{success:!1,message:`Invalid size limit for ${s.toLowerCase()} files`,result:""}}}try{const n=yield(yield e).file,{filename:s,createReadStream:a}=n;if(i){const p=a(),d=yield O(p),y=T({filename:s,fileSize:d},i,l);if(!y.isValid)return{success:!1,message:y.error||"File validation failed",result:""}}const o=_.dirname(r);m.pathExistsSync(o)||m.mkdirSync(o,{recursive:!0});const u=a(),c=m.createWriteStream(r);return u.pipe(c),yield new Promise((p,d)=>{c.on("finish",()=>p()),c.on("error",d),u.on("error",d)}),{success:!0,message:"File uploaded successfully",result:r}}catch(n){return{success:!1,message:n instanceof Error?n.message:"File upload failed",result:""}}})}exports.createUploadConfig=U;exports.upload=I;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const z=require("node:buffer"),C=require("node:stream"),x=require("node:stream/web"),A=require("./upload.constant.cjs"),c=require("./upload.type.cjs"),D=require("../path/path.util.cjs"),S=require("../fs/fs.util.cjs"),f=require("../../constant/response-status.cjs");var P=Object.defineProperty,v=Object.getOwnPropertySymbols,h=Object.prototype.hasOwnProperty,F=Object.prototype.propertyIsEnumerable,T=(r,t,e)=>t in r?P(r,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[t]=e,O=(r,t)=>{for(var e in t||(t={}))h.call(t,e)&&T(r,e,t[e]);if(v)for(var e of v(t))F.call(t,e)&&T(r,e,t[e]);return r},m=(r,t,e)=>new Promise((i,a)=>{var s=l=>{try{o(e.next(l))}catch(d){a(d)}},n=l=>{try{o(e.throw(l))}catch(d){a(d)}},o=l=>l.done?i(l.value):Promise.resolve(l.value).then(s,n);o((e=e.apply(r,t)).next())});function w(r){return m(this,null,function*(){return new Promise((t,e)=>{let i=0;r.on("data",a=>{i+=a.length}),r.on("end",()=>t(i)),r.on("error",e)})})}function _(r,t,e){return m(this,null,function*(){const i=yield(yield t).file,a=i.createReadStream(),s=yield w(a),n=e!=null?e:y(),o=U({filename:i.filename,fileSize:s},n,r);return o.isValid?{success:!0,result:i,message:"File validated successfully"}:{success:!1,message:o.error||"File validation failed",code:f.RESPONSE_STATUS.BAD_REQUEST.CODE}})}function L(r,t,e){return m(this,null,function*(){const a=(e!=null?e:y())[r],s=yield _(r,t,e);if(!s.success)return s;const{createReadStream:n}=s.result;let o=a.sizeLimit;const l=new C.Transform({transform(u,p,g){o-=u.length,o<0?g(new Error(`File size exceeds limit of ${a.sizeLimit/A.BYTES_PER_MB}MB`)):g(null,u)}}),E=n().pipe(l);return{success:!0,result:new x.ReadableStream({start(u){E.on("data",p=>{u.enqueue(typeof p=="string"?z.Buffer.from(p):p)}),E.on("end",()=>u.close()),E.on("error",p=>u.error(p))}})}})}function R(r,t){const e=r.lastIndexOf(".");if(e===-1)return!1;const i=r.substring(e+1).toLowerCase();return t.includes(i)}function U(r,t,e){const{filename:i,fileSize:a}=r,s=t[e],{allowedExtensions:n,sizeLimit:o}=s;if(!R(i,n))return{isValid:!1,error:`File extension not allowed for ${e.toLowerCase()} files. Allowed extensions: ${n.join(", ")}`};if(a!==void 0&&a>o){const l=Math.round(o/1048576);return{isValid:!1,error:`File size exceeds limit for ${e.toLowerCase()} files. Maximum size: ${l}MB`}}return{isValid:!0}}function y(r){const t={[c.E_UploadType.IMAGE]:{allowedExtensions:["jpg","jpeg","png","gif","webp","svg"],sizeLimit:5242880},[c.E_UploadType.VIDEO]:{allowedExtensions:["mp4","avi","mov","wmv","flv","webm"],sizeLimit:524288e3},[c.E_UploadType.DOCUMENT]:{allowedExtensions:["pdf","doc","docx","txt","rtf"],sizeLimit:10485760},[c.E_UploadType.OTHER]:{allowedExtensions:["zip","rar","tar","gz"],sizeLimit:5242880}};return O(O({},t),r)}function b(r){return m(this,null,function*(){const{path:t,file:e,config:i,type:a}=r;if(!t||typeof t!="string")return{success:!1,message:"Invalid path provided",code:f.RESPONSE_STATUS.BAD_REQUEST.CODE};if(!e||typeof e!="object")return{success:!1,message:"Invalid file provided",code:f.RESPONSE_STATUS.BAD_REQUEST.CODE};if(i){const s=[c.E_UploadType.IMAGE,c.E_UploadType.VIDEO,c.E_UploadType.DOCUMENT,c.E_UploadType.OTHER];for(const n of s){if(!i[n]||!Array.isArray(i[n].allowedExtensions)||i[n].allowedExtensions.length===0)return{success:!1,message:`Invalid config for ${n.toLowerCase()} files`,code:f.RESPONSE_STATUS.BAD_REQUEST.CODE};if(typeof i[n].sizeLimit!="number"||i[n].sizeLimit<=0)return{success:!1,message:`Invalid size limit for ${n.toLowerCase()} files`,code:f.RESPONSE_STATUS.BAD_REQUEST.CODE}}}try{const s=yield _(a,yield e,i);if(!s.success)return s;const{createReadStream:n}=s.result,o=D.dirname(t);S.pathExistsSync(o)||S.mkdirSync(o,{recursive:!0});const l=n(),d=S.createWriteStream(t);return l.pipe(d),yield new Promise((E,u)=>{d.on("finish",()=>E()),d.on("error",u),l.on("error",u)}),{success:!0,result:t,message:"File uploaded successfully",code:f.RESPONSE_STATUS.OK.CODE}}catch(s){return{success:!1,message:s instanceof Error?s.message:"File upload failed",code:f.RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE}}})}exports.createUploadConfig=y;exports.getAndValidateFile=_;exports.getFileSizeFromStream=w;exports.getFileWebStream=L;exports.upload=b;exports.validateFileExtension=R;exports.validateUpload=U;

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

@@ -1,4 +1,71 @@
-import { I_UploadConfig, I_UploadOptions, I_UploadResult } from './upload.type.js';
+import { ReadableStream } from 'node:stream/web';
+import { I_Return } from '../../typescript/index.js';
+import { I_UploadConfig, I_UploadFile, I_UploadFileData, I_UploadOptions, I_UploadValidationConfig, E_UploadType } from './upload.type.js';
+/**
+ * Calculates the size of a file from a readable stream.
+ * This function reads through the entire stream to determine the total byte size
+ * by accumulating the length of each data chunk.
+ *
+ * @param stream - The readable stream to calculate the size for.
+ * @returns A promise that resolves to the total size of the stream in bytes.
+ */
+export declare function getFileSizeFromStream(stream: NodeJS.ReadableStream): Promise<number>;
+/**
+ * Extracts and validates file data from an upload file.
+ * This function processes upload files by:
+ * - Extracting file metadata and creating a readable stream
+ * - Calculating the file size from the stream
+ * - Validating file size and extension against upload configuration
+ * - Returning a standardized response with success status and error codes
+ * - Providing validated file data for further processing
+ *
+ * @param type - The type of upload being processed (IMAGE, VIDEO, DOCUMENT, OTHER).
+ * @param file - The upload file object containing file metadata and stream creation method.
+ * @param config - Optional upload configuration. If not provided, uses default configuration.
+ * @returns A promise that resolves to a standardized response containing validated file data or error information.
+ */
+export declare function getAndValidateFile(type: E_UploadType, file: I_UploadFile, config?: I_UploadConfig): Promise<I_Return<I_UploadFileData>>;
+/**
+ * Creates a validated web-readable stream from an upload file with size validation.
+ * This function processes file uploads for web environments by:
+ * - Validating file data using getAndValidateFile function
+ * - Creating a size validation transform stream to monitor upload progress
+ * - Returning a web-compatible ReadableStream with real-time validation
+ * - Providing standardized error responses for validation failures
+ * - Wrapping the stream in a standardized response format
+ *
+ * @param type - The type of upload being processed (IMAGE, VIDEO, DOCUMENT, OTHER).
+ * @param file - The upload file object containing file metadata and stream creation method.
+ * @param config - Optional upload configuration. If not provided, uses default configuration.
+ * @returns A promise that resolves to a standardized response containing either a web ReadableStream or error information.
+ */
+export declare function getFileWebStream(type: E_UploadType, file: I_UploadFile, config?: I_UploadConfig): Promise<I_Return<ReadableStream<Uint8Array>>>;
+/**
+ * Validates if a file has an allowed extension.
+ * This function extracts the file extension from the filename and checks if it's
+ * included in the list of allowed extensions (case-insensitive comparison).
+ *
+ * @param filename - The filename to check for valid extension.
+ * @param allowedExtensions - An array of allowed file extensions (without dots).
+ * @returns True if the file extension is allowed, false otherwise.
+ */
+export declare function validateFileExtension(filename: string, allowedExtensions: string[]): boolean;
+/**
+ * Validates an upload against the specified configuration.
+ * This function performs comprehensive validation including:
+ * - File extension validation against allowed extensions
+ * - File size validation against size limits
+ * - Returns detailed error messages for validation failures
+ *
+ * @param config - The validation configuration including filename and optional file size.
+ * @param uploadConfig - The upload configuration containing allowed extensions and size limits.
+ * @param uploadType - The type of upload being validated.
+ * @returns An object indicating validation success and optional error message.
+ */
+export declare function validateUpload(config: I_UploadValidationConfig, uploadConfig: I_UploadConfig, uploadType: E_UploadType): {
+    isValid: boolean;
+    error?: string;
+};
 /**
  * Creates a default upload configuration with predefined settings for different file types.
  * This function provides sensible defaults for image, video, document, and other file types,
@@ -13,12 +80,12 @@ export declare function createUploadConfig(overrides?: Partial<I_UploadConfig>):
  * This function processes file uploads with the following features:
  * - Input validation for path and file parameters
  * - Configuration validation for all upload types
- * - File size and extension validation
+ * - File validation using getAndValidateFile function
  * - Automatic directory creation
  * - Stream-based file writing
- * - Comprehensive error handling and reporting
+ * - Comprehensive error handling with standardized response codes
  *
  * @param options - Upload configuration including file, path, type, and optional validation config.
- * @returns A promise that resolves to an upload result with success status, message, and file path.
+ * @returns A promise that resolves to a standardized response with success status, message, file path, and response codes.
  */
-export declare function upload(options: I_UploadOptions): Promise<I_UploadResult>;
+export declare function upload(options: I_UploadOptions): Promise<I_Return<string>>;

package/dist/node/upload/upload.util.js

@@ -1,154 +1,196 @@
-import { E_UploadType as f } from "./upload.type.js";
-import { dirname as E } from "../path/path.util.js";
-import { pathExistsSync as x, mkdirSync as z, createWriteStream as h } from "../fs/fs.util.js";
-var O = Object.defineProperty, v = Object.getOwnPropertySymbols, _ = Object.prototype.hasOwnProperty, I = Object.prototype.propertyIsEnumerable, w = (i, r, e) => r in i ? O(i, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[r] = e, y = (i, r) => {
+import { Buffer as O } from "node:buffer";
+import { Transform as x } from "node:stream";
+import { ReadableStream as z } from "node:stream/web";
+import { BYTES_PER_MB as C } from "./upload.constant.js";
+import { E_UploadType as u } from "./upload.type.js";
+import { dirname as D } from "../path/path.util.js";
+import { pathExistsSync as R, mkdirSync as h, createWriteStream as L } from "../fs/fs.util.js";
+import { RESPONSE_STATUS as d } from "../../constant/response-status.js";
+var T = Object.defineProperty, v = Object.getOwnPropertySymbols, A = Object.prototype.hasOwnProperty, I = Object.prototype.propertyIsEnumerable, y = (t, r, e) => r in t ? T(t, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : t[r] = e, S = (t, r) => {
   for (var e in r || (r = {}))
-    _.call(r, e) && w(i, e, r[e]);
+    A.call(r, e) && y(t, e, r[e]);
   if (v)
     for (var e of v(r))
-      I.call(r, e) && w(i, e, r[e]);
-  return i;
-}, g = (i, r, e) => new Promise((t, l) => {
-  var n = (o) => {
+      I.call(r, e) && y(t, e, r[e]);
+  return t;
+}, E = (t, r, e) => new Promise((i, a) => {
+  var s = (l) => {
     try {
-      a(e.next(o));
+      n(e.next(l));
     } catch (c) {
-      l(c);
+      a(c);
     }
-  }, s = (o) => {
+  }, o = (l) => {
     try {
-      a(e.throw(o));
+      n(e.throw(l));
     } catch (c) {
-      l(c);
+      a(c);
     }
-  }, a = (o) => o.done ? t(o.value) : Promise.resolve(o.value).then(n, s);
-  a((e = e.apply(i, r)).next());
+  }, n = (l) => l.done ? i(l.value) : Promise.resolve(l.value).then(s, o);
+  n((e = e.apply(t, r)).next());
 });
-function L(i) {
-  return g(this, null, function* () {
+function P(t) {
+  return E(this, null, function* () {
     return new Promise((r, e) => {
-      let t = 0;
-      i.on("data", (l) => {
-        t += l.length;
-      }), i.on("end", () => r(t)), i.on("error", e);
+      let i = 0;
+      t.on("data", (a) => {
+        i += a.length;
+      }), t.on("end", () => r(i)), t.on("error", e);
     });
   });
 }
-function S(i, r) {
-  const e = i.lastIndexOf(".");
+function w(t, r, e) {
+  return E(this, null, function* () {
+    const i = yield (yield r).file, a = i.createReadStream(), s = yield P(a), o = e != null ? e : _(), n = F(
+      { filename: i.filename, fileSize: s },
+      o,
+      t
+    );
+    return n.isValid ? {
+      success: !0,
+      result: i,
+      message: "File validated successfully"
+    } : {
+      success: !1,
+      message: n.error || "File validation failed",
+      code: d.BAD_REQUEST.CODE
+    };
+  });
+}
+function q(t, r, e) {
+  return E(this, null, function* () {
+    const a = (e != null ? e : _())[t], s = yield w(t, r, e);
+    if (!s.success)
+      return s;
+    const { createReadStream: o } = s.result;
+    let n = a.sizeLimit;
+    const l = new x({
+      transform(f, m, g) {
+        n -= f.length, n < 0 ? g(new Error(`File size exceeds limit of ${a.sizeLimit / C}MB`)) : g(null, f);
+      }
+    }), p = o().pipe(l);
+    return {
+      success: !0,
+      result: new z({
+        start(f) {
+          p.on("data", (m) => {
+            f.enqueue(typeof m == "string" ? O.from(m) : m);
+          }), p.on("end", () => f.close()), p.on("error", (m) => f.error(m));
+        }
+      })
+    };
+  });
+}
+function B(t, r) {
+  const e = t.lastIndexOf(".");
   if (e === -1)
     return !1;
-  const t = i.substring(e + 1).toLowerCase();
-  return r.includes(t);
+  const i = t.substring(e + 1).toLowerCase();
+  return r.includes(i);
 }
-function P(i, r, e) {
-  const { filename: t, fileSize: l } = i, n = r[e], { allowedExtensions: s, sizeLimit: a } = n;
-  if (!S(t, s))
+function F(t, r, e) {
+  const { filename: i, fileSize: a } = t, s = r[e], { allowedExtensions: o, sizeLimit: n } = s;
+  if (!B(i, o))
     return {
       isValid: !1,
-      error: `File extension not allowed for ${e.toLowerCase()} files. Allowed extensions: ${s.join(", ")}`
+      error: `File extension not allowed for ${e.toLowerCase()} files. Allowed extensions: ${o.join(", ")}`
     };
-  if (l !== void 0 && l > a) {
-    const o = Math.round(a / 1048576);
+  if (a !== void 0 && a > n) {
+    const l = Math.round(n / 1048576);
     return {
       isValid: !1,
-      error: `File size exceeds limit for ${e.toLowerCase()} files. Maximum size: ${o}MB`
+      error: `File size exceeds limit for ${e.toLowerCase()} files. Maximum size: ${l}MB`
     };
   }
   return { isValid: !0 };
 }
-function b(i) {
+function _(t) {
   const r = {
-    [f.IMAGE]: {
+    [u.IMAGE]: {
       allowedExtensions: ["jpg", "jpeg", "png", "gif", "webp", "svg"],
       sizeLimit: 5242880
       // 5MB
     },
-    [f.VIDEO]: {
+    [u.VIDEO]: {
       allowedExtensions: ["mp4", "avi", "mov", "wmv", "flv", "webm"],
       sizeLimit: 524288e3
       // 500MB
     },
-    [f.DOCUMENT]: {
+    [u.DOCUMENT]: {
       allowedExtensions: ["pdf", "doc", "docx", "txt", "rtf"],
       sizeLimit: 10485760
       // 10MB
     },
-    [f.OTHER]: {
+    [u.OTHER]: {
       allowedExtensions: ["zip", "rar", "tar", "gz"],
       sizeLimit: 5242880
       // 5MB
     }
   };
-  return y(y({}, r), i);
+  return S(S({}, r), t);
 }
-function V(i) {
-  return g(this, null, function* () {
-    const { path: r, file: e, config: t, type: l } = i;
+function G(t) {
+  return E(this, null, function* () {
+    const { path: r, file: e, config: i, type: a } = t;
     if (!r || typeof r != "string")
       return {
         success: !1,
         message: "Invalid path provided",
-        result: ""
+        code: d.BAD_REQUEST.CODE
       };
     if (!e || typeof e != "object")
       return {
         success: !1,
         message: "Invalid file provided",
-        result: ""
+        code: d.BAD_REQUEST.CODE
       };
-    if (t) {
-      const n = [f.IMAGE, f.VIDEO, f.DOCUMENT, f.OTHER];
-      for (const s of n) {
-        if (!t[s] || !Array.isArray(t[s].allowedExtensions) || t[s].allowedExtensions.length === 0)
+    if (i) {
+      const s = [u.IMAGE, u.VIDEO, u.DOCUMENT, u.OTHER];
+      for (const o of s) {
+        if (!i[o] || !Array.isArray(i[o].allowedExtensions) || i[o].allowedExtensions.length === 0)
           return {
             success: !1,
-            message: `Invalid config for ${s.toLowerCase()} files`,
-            result: ""
+            message: `Invalid config for ${o.toLowerCase()} files`,
+            code: d.BAD_REQUEST.CODE
           };
-        if (typeof t[s].sizeLimit != "number" || t[s].sizeLimit <= 0)
+        if (typeof i[o].sizeLimit != "number" || i[o].sizeLimit <= 0)
           return {
             success: !1,
-            message: `Invalid size limit for ${s.toLowerCase()} files`,
-            result: ""
+            message: `Invalid size limit for ${o.toLowerCase()} files`,
+            code: d.BAD_REQUEST.CODE
           };
       }
     }
     try {
-      const n = yield (yield e).file, { filename: s, createReadStream: a } = n;
-      if (t) {
-        const m = a(), u = yield L(m), p = P(
-          { filename: s, fileSize: u },
-          t,
-          l
-        );
-        if (!p.isValid)
-          return {
-            success: !1,
-            message: p.error || "File validation failed",
-            result: ""
-          };
-      }
-      const o = E(r);
-      x(o) || z(o, { recursive: !0 });
-      const c = a(), d = h(r);
-      return c.pipe(d), yield new Promise((m, u) => {
-        d.on("finish", () => m()), d.on("error", u), c.on("error", u);
+      const s = yield w(a, yield e, i);
+      if (!s.success)
+        return s;
+      const { createReadStream: o } = s.result, n = D(r);
+      R(n) || h(n, { recursive: !0 });
+      const l = o(), c = L(r);
+      return l.pipe(c), yield new Promise((p, f) => {
+        c.on("finish", () => p()), c.on("error", f), l.on("error", f);
       }), {
         success: !0,
+        result: r,
         message: "File uploaded successfully",
-        result: r
+        code: d.OK.CODE
       };
-    } catch (n) {
+    } catch (s) {
       return {
         success: !1,
-        message: n instanceof Error ? n.message : "File upload failed",
-        result: ""
+        message: s instanceof Error ? s.message : "File upload failed",
+        code: d.INTERNAL_SERVER_ERROR.CODE
       };
     }
   });
 }
 export {
-  b as createUploadConfig,
-  V as upload
+  _ as createUploadConfig,
+  w as getAndValidateFile,
+  P as getFileSizeFromStream,
+  q as getFileWebStream,
+  G as upload,
+  B as validateFileExtension,
+  F as validateUpload
 };

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.3.1",
+    "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,8 +271,8 @@
         "@commitlint/cli": "19.8.1",
         "@commitlint/config-conventional": "19.8.1",
         "@eslint/config-inspector": "1.1.0",
-        "@next/eslint-plugin-next": "15.4.4",
-        "@testing-library/jest-dom": "6.6.3",
+        "@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",
         "@types/body-parser": "1.19.6",
@@ -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",