@cyberskill/shared 2.3.1 → 2.4.0

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/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@cyberskill/shared",
     "type": "module",
-    "version": "2.3.1",
+    "version": "2.4.0",
     "description": "CyberSkill Shared",
     "author": "Stephen Cheng",
     "license": "MIT",
@@ -272,7 +272,7 @@
         "@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",
+        "@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",