@cyberskill/shared 3.2.0 → 3.3.0

package/dist/node/path/path.util.js

@@ -1,20 +1,17 @@
-import r from "node:path";
 import { getEnv as e } from "../../config/env/env.util.js";
-const t = e(), o = r, c = o.dirname;
-function m(...n) {
-  return o.resolve(t.CWD, ...n);
+import t from "node:path";
+//#region src/node/path/path.util.ts
+var n = e(), r = t, i = r.dirname;
+function a(...e) {
+	return r.resolve(n.CWD, ...e);
 }
-function u(...n) {
-  return o.resolve(...n);
+function o(...e) {
+	return r.resolve(...e);
 }
-function v(...n) {
-  return o.join(...n);
+function s(...e) {
+	return r.join(...e);
 }
-export {
-  c as dirname,
-  v as join,
-  o as path,
-  u as resolve,
-  m as resolveWorkingPath
-};
-//# sourceMappingURL=path.util.js.map
+//#endregion
+export { i as dirname, s as join, r as path, o as resolve, a as resolveWorkingPath };
+
+//# sourceMappingURL=path.util.js.map

package/dist/node/path/path.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.util.js","sources":["../../../src/node/path/path.util.ts"],"sourcesContent":["import pathNode from 'node:path';\n\nimport { getEnv } from '#config/env/index.js';\n\nconst env = getEnv();\n\nexport const path = pathNode;\n\nexport const dirname = path.dirname;\n\n/**\n * Resolves a path relative to the current working directory.\n * This function creates an absolute path by combining the current working directory\n * with the provided path segments, ensuring consistent path resolution across the application.\n *\n * @param urls - Path segments to resolve relative to the current working directory.\n * @returns An absolute path string resolved from the current working directory.\n */\nexport function resolveWorkingPath(...urls: string[]): string {\n    return path.resolve(env.CWD, ...urls);\n}\n\n/**\n * Resolves an absolute path from the provided path segments.\n * This function creates an absolute path by combining the provided path segments,\n * similar to Node.js path.resolve but without using the current working directory as base.\n *\n * @param urls - Path segments to resolve into an absolute path.\n * @returns An absolute path string resolved from the provided segments.\n */\nexport function resolve(...urls: string[]): string {\n    return path.resolve(...urls);\n}\n\n/**\n * Joins path segments into a single path string.\n * This function combines multiple path segments using the appropriate path separator\n * for the current operating system, similar to Node.js path.join.\n *\n * @param urls - Path segments to join together.\n * @returns A joined path string with appropriate separators.\n */\nexport function join(...urls: string[]): string {\n    return path.join(...urls);\n}\n"],"names":["env","getEnv","path","pathNode","dirname","resolveWorkingPath","urls","resolve","join"],"mappings":";;AAIA,MAAMA,IAAMC,EAAA,GAECC,IAAOC,GAEPC,IAAUF,EAAK;AAUrB,SAASG,KAAsBC,GAAwB;AAC1D,SAAOJ,EAAK,QAAQF,EAAI,KAAK,GAAGM,CAAI;AACxC;AAUO,SAASC,KAAWD,GAAwB;AAC/C,SAAOJ,EAAK,QAAQ,GAAGI,CAAI;AAC/B;AAUO,SAASE,KAAQF,GAAwB;AAC5C,SAAOJ,EAAK,KAAK,GAAGI,CAAI;AAC5B;"}
+{"version":3,"file":"path.util.js","names":[],"sources":["../../../src/node/path/path.util.ts"],"sourcesContent":["import pathNode from 'node:path';\n\nimport { getEnv } from '#config/env/index.js';\n\nconst env = getEnv();\n\nexport const path = pathNode;\n\nexport const dirname = path.dirname;\n\n/**\n * Resolves a path relative to the current working directory.\n * This function creates an absolute path by combining the current working directory\n * with the provided path segments, ensuring consistent path resolution across the application.\n *\n * @param urls - Path segments to resolve relative to the current working directory.\n * @returns An absolute path string resolved from the current working directory.\n */\nexport function resolveWorkingPath(...urls: string[]): string {\n    return path.resolve(env.CWD, ...urls);\n}\n\n/**\n * Resolves an absolute path from the provided path segments.\n * This function creates an absolute path by combining the provided path segments,\n * similar to Node.js path.resolve but without using the current working directory as base.\n *\n * @param urls - Path segments to resolve into an absolute path.\n * @returns An absolute path string resolved from the provided segments.\n */\nexport function resolve(...urls: string[]): string {\n    return path.resolve(...urls);\n}\n\n/**\n * Joins path segments into a single path string.\n * This function combines multiple path segments using the appropriate path separator\n * for the current operating system, similar to Node.js path.join.\n *\n * @param urls - Path segments to join together.\n * @returns A joined path string with appropriate separators.\n */\nexport function join(...urls: string[]): string {\n    return path.join(...urls);\n}\n"],"mappings":";;;AAIA,IAAM,IAAM,GAAQ,EAEP,IAAO,GAEP,IAAU,EAAK;AAU5B,SAAgB,EAAmB,GAAG,GAAwB;AAC1D,QAAO,EAAK,QAAQ,EAAI,KAAK,GAAG,EAAK;;AAWzC,SAAgB,EAAQ,GAAG,GAAwB;AAC/C,QAAO,EAAK,QAAQ,GAAG,EAAK;;AAWhC,SAAgB,EAAK,GAAG,GAAwB;AAC5C,QAAO,EAAK,KAAK,GAAG,EAAK"}

package/dist/node/storage/index.js

@@ -1,10 +1,3 @@
-import { NODE_FS_DRIVER_NAME as N, STORAGE_INSTANCE_NAME as A, STORAGE_KEY_EXTENSION as S, STORAGE_STORE_NAME as O } from "./storage.constant.js";
-import { storage as T } from "./storage.util.js";
-export {
-  N as NODE_FS_DRIVER_NAME,
-  A as STORAGE_INSTANCE_NAME,
-  S as STORAGE_KEY_EXTENSION,
-  O as STORAGE_STORE_NAME,
-  T as storage
-};
-//# sourceMappingURL=index.js.map
+import { NODE_FS_DRIVER_NAME as e, STORAGE_INSTANCE_NAME as t, STORAGE_KEY_EXTENSION as n, STORAGE_STORE_NAME as r } from "./storage.constant.js";
+import { storage as i } from "./storage.util.js";
+export { e as NODE_FS_DRIVER_NAME, t as STORAGE_INSTANCE_NAME, n as STORAGE_KEY_EXTENSION, r as STORAGE_STORE_NAME, i as storage };

package/dist/node/storage/storage.constant.js

@@ -1,8 +1,6 @@
-const E = "localforage-node-fs", o = ".json", _ = "cyberskill", s = "node-storage";
-export {
-  E as NODE_FS_DRIVER_NAME,
-  _ as STORAGE_INSTANCE_NAME,
-  o as STORAGE_KEY_EXTENSION,
-  s as STORAGE_STORE_NAME
-};
-//# sourceMappingURL=storage.constant.js.map
+//#region src/node/storage/storage.constant.ts
+var e = "localforage-node-fs", t = ".json", n = "cyberskill", r = "node-storage";
+//#endregion
+export { e as NODE_FS_DRIVER_NAME, n as STORAGE_INSTANCE_NAME, t as STORAGE_KEY_EXTENSION, r as STORAGE_STORE_NAME };
+
+//# sourceMappingURL=storage.constant.js.map

package/dist/node/storage/storage.constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.constant.js","sources":["../../../src/node/storage/storage.constant.ts"],"sourcesContent":["export const NODE_FS_DRIVER_NAME = 'localforage-node-fs';\nexport const STORAGE_KEY_EXTENSION = '.json';\nexport const STORAGE_INSTANCE_NAME = 'cyberskill';\nexport const STORAGE_STORE_NAME = 'node-storage';\n"],"names":["NODE_FS_DRIVER_NAME","STORAGE_KEY_EXTENSION","STORAGE_INSTANCE_NAME","STORAGE_STORE_NAME"],"mappings":"AAAO,MAAMA,IAAsB,uBACtBC,IAAwB,SACxBC,IAAwB,cACxBC,IAAqB;"}
+{"version":3,"file":"storage.constant.js","names":[],"sources":["../../../src/node/storage/storage.constant.ts"],"sourcesContent":["export const NODE_FS_DRIVER_NAME = 'localforage-node-fs';\nexport const STORAGE_KEY_EXTENSION = '.json';\nexport const STORAGE_INSTANCE_NAME = 'cyberskill';\nexport const STORAGE_STORE_NAME = 'node-storage';\n"],"mappings":";AAAA,IAAa,IAAsB,uBACtB,IAAwB,SACxB,IAAwB,cACxB,IAAqB"}

package/dist/node/storage/storage.util.js

@@ -1,183 +1,132 @@
-import w from "localforage";
-import i from "node:fs/promises";
-import E from "node:path";
-import { STORAGE_KEY_EXTENSION as d, NODE_FS_DRIVER_NAME as v, STORAGE_STORE_NAME as R, STORAGE_INSTANCE_NAME as I } from "./storage.constant.js";
-import { catchError as s, log as h } from "../log/log.util.js";
-import { getEnv as S } from "../../config/env/env.util.js";
-const l = S(), a = {
-  baseDir: l.CYBERSKILL_STORAGE_DIRECTORY
-};
-function g(r) {
-  return `${encodeURIComponent(r)}${d}`;
+import { getEnv as e } from "../../config/env/env.util.js";
+import { catchError as t, log as n } from "../log/log.util.js";
+import { NODE_FS_DRIVER_NAME as r, STORAGE_INSTANCE_NAME as i, STORAGE_KEY_EXTENSION as a, STORAGE_STORE_NAME as o } from "./storage.constant.js";
+import s from "localforage";
+import c from "node:path";
+import l from "node:fs/promises";
+//#region src/node/storage/storage.util.ts
+var u = { baseDir: "" };
+function d(e) {
+	return `${encodeURIComponent(e)}${a}`;
 }
-function _(r) {
-  return decodeURIComponent(r.slice(0, -d.length));
+function f(e) {
+	return decodeURIComponent(e.slice(0, -a.length));
 }
-function y(r, e) {
-  return E.join(e, g(r));
+function p(e, t) {
+	return c.join(t, d(e));
 }
-const c = {
-  _driver: v,
-  _support: !0,
-  /** Ensures the storage directory exists and respects custom baseDir overrides. */
-  async _initStorage(r) {
-    try {
-      const e = typeof r == "object" && r !== null && "baseDir" in r ? r.baseDir : void 0;
-      typeof e == "string" && e.length > 0 ? a.baseDir = e : a.baseDir = l.CYBERSKILL_STORAGE_DIRECTORY, await i.mkdir(a.baseDir, { recursive: !0 });
-    } catch (e) {
-      throw h.error("[Storage:init]", e), e;
-    }
-  },
-  /** Deletes all stored entries by recreating the directory. */
-  async clear() {
-    const { baseDir: r } = a;
-    await i.rm(r, { recursive: !0, force: !0 }), await i.mkdir(r, { recursive: !0 });
-  },
-  /** Reads and parses a stored value; returns null when the file is missing. */
-  async getItem(r) {
-    const { baseDir: e } = a, t = y(r, e);
-    try {
-      const n = await i.readFile(t, "utf8");
-      return JSON.parse(n);
-    } catch (n) {
-      if (n.code === "ENOENT")
-        return null;
-      throw n;
-    }
-  },
-  /** Iterates through all keys, invoking the iterator until it returns a value. */
-  async iterate(r) {
-    const e = await c.keys();
-    let t = 1;
-    for (const n of e) {
-      const D = await c.getItem(n), f = r(D, n, t);
-      if (f !== void 0)
-        return f;
-      t += 1;
-    }
-  },
-  /** Returns the key name at the given index or null when out of bounds. */
-  async key(r) {
-    return (await c.keys())[r] ?? null;
-  },
-  /** Lists all stored keys. */
-  async keys() {
-    const { baseDir: r } = a;
-    try {
-      return (await i.readdir(r)).filter((t) => t.endsWith(d)).map(_);
-    } catch (e) {
-      if (e.code === "ENOENT")
-        return [];
-      throw e;
-    }
-  },
-  /** Returns the count of stored keys. */
-  async length() {
-    return (await c.keys()).length;
-  },
-  /** Removes a stored value for the given key. */
-  async removeItem(r) {
-    const { baseDir: e } = a, t = y(r, e);
-    await i.rm(t, { force: !0 });
-  },
-  /** Stores a value as JSON on disk. */
-  async setItem(r, e) {
-    const { baseDir: t } = a, n = y(r, t);
-    return await i.mkdir(t, { recursive: !0 }), await i.writeFile(n, JSON.stringify(e), "utf8"), e;
-  }
-};
-let o = null, m = null;
-async function u() {
-  return o ? (await o, m) : (o = (async () => {
-    await w.defineDriver(c), a.baseDir = l.CYBERSKILL_STORAGE_DIRECTORY;
-    const r = await w.getDriver(v), e = {
-      baseDir: a.baseDir,
-      name: I,
-      storeName: R
-    };
-    await r._initStorage(e), m = r;
-  })().catch((r) => {
-    throw o = null, r;
-  }), await o, m);
+var m = {
+	_driver: r,
+	_support: !0,
+	async _initStorage(t) {
+		try {
+			let n = typeof t == "object" && t && "baseDir" in t ? t.baseDir : void 0;
+			typeof n == "string" && n.length > 0 ? u.baseDir = n : u.baseDir = e().CYBERSKILL_STORAGE_DIRECTORY, await l.mkdir(u.baseDir, { recursive: !0 });
+		} catch (e) {
+			throw n.error("[Storage:init]", e), e;
+		}
+	},
+	async clear() {
+		let { baseDir: e } = u;
+		e && (await l.rm(e, {
+			recursive: !0,
+			force: !0
+		}), await l.mkdir(e, { recursive: !0 }));
+	},
+	async getItem(e) {
+		let { baseDir: t } = u, n = p(e, t);
+		try {
+			let e = await l.readFile(n, "utf8");
+			return JSON.parse(e);
+		} catch (e) {
+			if (e.code === "ENOENT") return null;
+			throw e;
+		}
+	},
+	async iterate(e) {
+		let t = await m.keys(), n = 1;
+		for (let r of t) {
+			let t = e(await m.getItem(r), r, n);
+			if (t !== void 0) return t;
+			n += 1;
+		}
+	},
+	async key(e) {
+		return (await m.keys())[e] ?? null;
+	},
+	async keys() {
+		let { baseDir: e } = u;
+		try {
+			return (await l.readdir(e)).filter((e) => e.endsWith(a)).map(f);
+		} catch (e) {
+			if (e.code === "ENOENT") return [];
+			throw e;
+		}
+	},
+	async length() {
+		return (await m.keys()).length;
+	},
+	async removeItem(e) {
+		let { baseDir: t } = u, n = p(e, t);
+		await l.rm(n, { force: !0 });
+	},
+	async setItem(e, t) {
+		let { baseDir: n } = u, r = p(e, n);
+		return await l.mkdir(n, { recursive: !0 }), await l.writeFile(r, JSON.stringify(t), "utf8"), t;
+	}
+}, h = null, g = null;
+async function _() {
+	return h ? (await h, g) : (h = (async () => {
+		await s.defineDriver(m), u.baseDir = e().CYBERSKILL_STORAGE_DIRECTORY;
+		let t = await s.getDriver(r);
+		await t._initStorage({
+			baseDir: u.baseDir,
+			name: i,
+			storeName: o
+		}), g = t;
+	})().catch((e) => {
+		throw h = null, e;
+	}), await h, g);
 }
-const A = {
-  /**
-   * Retrieves a value from persistent storage by key.
-   * This method fetches data that was previously stored using the set method.
-   * Returns null if the key doesn't exist or if an error occurs.
-   *
-   * @param key - The unique identifier for the stored value.
-   * @returns A promise that resolves to the stored value or null if not found.
-   */
-  async get(r) {
-    try {
-      return await (await u()).getItem(r) ?? null;
-    } catch (e) {
-      return s(e, { returnValue: null });
-    }
-  },
-  /**
-   * Stores a value in persistent storage with a unique key.
-   * This method saves data that can be retrieved later using the get method.
-   * The data is automatically serialized and stored in the configured storage directory.
-   *
-   * @param key - The unique identifier for the value to store.
-   * @param value - The data to store (will be automatically serialized).
-   * @returns A promise that resolves when the storage operation is complete.
-   */
-  async set(r, e) {
-    try {
-      await (await u()).setItem(r, e);
-    } catch (t) {
-      s(t);
-    }
-  },
-  /**
-   * Removes a value from persistent storage by key.
-   * This method permanently deletes the stored data associated with the specified key.
-   *
-   * @param key - The unique identifier of the value to remove.
-   * @returns A promise that resolves when the removal operation is complete.
-   */
-  async remove(r) {
-    try {
-      await (await u()).removeItem(r);
-    } catch (e) {
-      s(e);
-    }
-  },
-  /**
-   * Retrieves all storage keys.
-   * This method returns an array of all keys that currently have stored values.
-   * Returns an empty array if no keys exist or if an error occurs.
-   *
-   * @returns A promise that resolves to an array of storage keys.
-   */
-  async keys() {
-    try {
-      const e = await (await u()).keys();
-      return Array.isArray(e) ? e : (h.warn("[Storage:keys] Invalid keys response:", e), []);
-    } catch (r) {
-      return s(r, { returnValue: [] });
-    }
-  },
-  /**
-   * Gets a human-readable log link for a storage key.
-   * This method provides a formatted string that shows the storage directory path
-   * and the key name for debugging and manual inspection purposes.
-   *
-   * @param key - The storage key to generate a log link for.
-   * @returns A promise that resolves to a formatted log link string or null if an error occurs.
-   */
-  async getLogLink(r) {
-    try {
-      return `${E.join(l.CYBERSKILL_STORAGE_DIRECTORY, g(r))} (key: ${r})`;
-    } catch (e) {
-      return s(e, { returnValue: null });
-    }
-  }
-};
-export {
-  A as storage
+var v = {
+	async get(e) {
+		try {
+			return await (await _()).getItem(e) ?? null;
+		} catch (e) {
+			return t(e, { returnValue: null });
+		}
+	},
+	async set(e, n) {
+		try {
+			await (await _()).setItem(e, n);
+		} catch (e) {
+			t(e);
+		}
+	},
+	async remove(e) {
+		try {
+			await (await _()).removeItem(e);
+		} catch (e) {
+			t(e);
+		}
+	},
+	async keys() {
+		try {
+			let e = await (await _()).keys();
+			return Array.isArray(e) ? e : (n.warn("[Storage:keys] Invalid keys response:", e), []);
+		} catch (e) {
+			return t(e, { returnValue: [] });
+		}
+	},
+	async getLogLink(n) {
+		try {
+			return `${c.join(e().CYBERSKILL_STORAGE_DIRECTORY, d(n))} (key: ${n})`;
+		} catch (e) {
+			return t(e, { returnValue: null });
+		}
+	}
 };
-//# sourceMappingURL=storage.util.js.map
+//#endregion
+export { v as storage };
+
+//# sourceMappingURL=storage.util.js.map

package/dist/node/storage/storage.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.util.js","sources":["../../../src/node/storage/storage.util.ts"],"sourcesContent":["import localForage from 'localforage';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { getEnv } from '#config/env/index.js';\n\nimport type { LocalForageDriver, NodeFsDriverState, NodeLocalForageOptions } from './storage.type.js';\n\nimport { catchError, log } from '../log/index.js';\nimport { NODE_FS_DRIVER_NAME, STORAGE_INSTANCE_NAME, STORAGE_KEY_EXTENSION, STORAGE_STORE_NAME } from './storage.constant.js';\n\nconst env = getEnv();\n\nconst nodeFsDriverState: NodeFsDriverState = {\n    baseDir: env.CYBERSKILL_STORAGE_DIRECTORY,\n};\n\n/**\n * Encodes a storage key into a filename-safe string.\n */\nfunction encodeKey(key: string): string {\n    return `${encodeURIComponent(key)}${STORAGE_KEY_EXTENSION}`;\n}\n\n/**\n * Decodes a filename-safe key back to the original storage key.\n */\nfunction decodeKey(fileName: string): string {\n    return decodeURIComponent(fileName.slice(0, -STORAGE_KEY_EXTENSION.length));\n}\n\n/**\n * Maps a storage key to an absolute file path inside the storage directory.\n */\nfunction getFilePath(key: string, baseDir: string): string {\n    return path.join(baseDir, encodeKey(key));\n}\n\n/**\n * Custom localForage driver that stores JSON-encoded values on the filesystem.\n */\nconst nodeFsDriver: LocalForageDriver = {\n    _driver: NODE_FS_DRIVER_NAME,\n    _support: true,\n    /** Ensures the storage directory exists and respects custom baseDir overrides. */\n    async _initStorage(options: unknown) {\n        try {\n            const baseDirFromOptions = typeof options === 'object' && options !== null && 'baseDir' in options\n                ? (options as { baseDir?: unknown }).baseDir\n                : undefined;\n\n            if (typeof baseDirFromOptions === 'string' && baseDirFromOptions.length > 0) {\n                nodeFsDriverState.baseDir = baseDirFromOptions;\n            }\n            else {\n                nodeFsDriverState.baseDir = env.CYBERSKILL_STORAGE_DIRECTORY;\n            }\n\n            await fs.mkdir(nodeFsDriverState.baseDir, { recursive: true });\n        }\n        catch (error) {\n            log.error('[Storage:init]', error);\n            throw error;\n        }\n    },\n    /** Deletes all stored entries by recreating the directory. */\n    async clear() {\n        const { baseDir } = nodeFsDriverState;\n\n        await fs.rm(baseDir, { recursive: true, force: true });\n        await fs.mkdir(baseDir, { recursive: true });\n    },\n    /** Reads and parses a stored value; returns null when the file is missing. */\n    async getItem<T>(key: string): Promise<T | null> {\n        const { baseDir } = nodeFsDriverState;\n        const filePath = getFilePath(key, baseDir);\n\n        try {\n            const content = await fs.readFile(filePath, 'utf8');\n\n            return JSON.parse(content) as T;\n        }\n        catch (error) {\n            if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n                return null;\n            }\n            throw error;\n        }\n    },\n    /** Iterates through all keys, invoking the iterator until it returns a value. */\n    async iterate<T, U>(iterator: (value: T, key: string, iterationNumber: number) => U): Promise<U> {\n        const keys = await nodeFsDriver.keys();\n        let iterationNumber = 1;\n\n        for (const key of keys) {\n            const value = await nodeFsDriver.getItem<T>(key);\n\n            const result = iterator(value as T, key, iterationNumber);\n\n            if (result !== undefined) {\n                return result;\n            }\n            iterationNumber += 1;\n        }\n\n        return undefined as unknown as U;\n    },\n    /** Returns the key name at the given index or null when out of bounds. */\n    async key(keyIndex: number): Promise<string> {\n        const keys = await nodeFsDriver.keys();\n\n        return keys[keyIndex] ?? null as unknown as string;\n    },\n    /** Lists all stored keys. */\n    async keys(): Promise<string[]> {\n        const { baseDir } = nodeFsDriverState;\n\n        try {\n            const files = await fs.readdir(baseDir);\n\n            return files\n                .filter(file => file.endsWith(STORAGE_KEY_EXTENSION))\n                .map(decodeKey);\n        }\n        catch (error) {\n            if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n                return [];\n            }\n            throw error;\n        }\n    },\n    /** Returns the count of stored keys. */\n    async length(): Promise<number> {\n        const keys = await nodeFsDriver.keys();\n\n        return keys.length;\n    },\n    /** Removes a stored value for the given key. */\n    async removeItem(key: string): Promise<void> {\n        const { baseDir } = nodeFsDriverState;\n        const filePath = getFilePath(key, baseDir);\n\n        await fs.rm(filePath, { force: true });\n    },\n    /** Stores a value as JSON on disk. */\n    async setItem<T>(key: string, value: T): Promise<T> {\n        const { baseDir } = nodeFsDriverState;\n        const filePath = getFilePath(key, baseDir);\n\n        await fs.mkdir(baseDir, { recursive: true });\n        await fs.writeFile(filePath, JSON.stringify(value), 'utf8');\n\n        return value;\n    },\n};\n\nlet initPromise: Promise<void> | null = null;\nlet driverInstance: LocalForageDriver | null = null;\n\n/**\n * Prepares and returns the filesystem-backed localForage driver.\n * We bypass localForage's default driver selection and explicitly initialize\n * our custom driver to ensure Node compatibility.\n */\nasync function ensureLocalForageReady(): Promise<LocalForageDriver> {\n    if (initPromise) {\n        await initPromise;\n        return driverInstance as LocalForageDriver;\n    }\n\n    initPromise = (async () => {\n        await localForage.defineDriver(nodeFsDriver);\n        nodeFsDriverState.baseDir = env.CYBERSKILL_STORAGE_DIRECTORY;\n        const driver = await localForage.getDriver(NODE_FS_DRIVER_NAME);\n\n        const initOptions = {\n            baseDir: nodeFsDriverState.baseDir,\n            name: STORAGE_INSTANCE_NAME,\n            storeName: STORAGE_STORE_NAME,\n        } satisfies NodeLocalForageOptions;\n\n        await driver._initStorage(initOptions as unknown as Parameters<typeof driver._initStorage>[0]);\n        driverInstance = driver;\n    })().catch((error) => {\n        initPromise = null;\n        throw error;\n    });\n\n    await initPromise;\n\n    return driverInstance as LocalForageDriver;\n}\n\n/**\n * Persistent storage utility object for data persistence across application sessions.\n * This object provides methods for storing, retrieving, and managing data using localForage,\n * with automatic initialization and error handling.\n */\nexport const storage = {\n    /**\n     * Retrieves a value from persistent storage by key.\n     * This method fetches data that was previously stored using the set method.\n     * Returns null if the key doesn't exist or if an error occurs.\n     *\n     * @param key - The unique identifier for the stored value.\n     * @returns A promise that resolves to the stored value or null if not found.\n     */\n    async get<T = unknown>(key: string): Promise<T | null> {\n        try {\n            const driver = await ensureLocalForageReady();\n            const result = await driver.getItem<T>(key);\n\n            return result ?? null;\n        }\n        catch (error) {\n            return catchError(error, { returnValue: null });\n        }\n    },\n    /**\n     * Stores a value in persistent storage with a unique key.\n     * This method saves data that can be retrieved later using the get method.\n     * The data is automatically serialized and stored in the configured storage directory.\n     *\n     * @param key - The unique identifier for the value to store.\n     * @param value - The data to store (will be automatically serialized).\n     * @returns A promise that resolves when the storage operation is complete.\n     */\n    async set<T = unknown>(key: string, value: T): Promise<void> {\n        try {\n            const driver = await ensureLocalForageReady();\n\n            await driver.setItem(key, value);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    },\n    /**\n     * Removes a value from persistent storage by key.\n     * This method permanently deletes the stored data associated with the specified key.\n     *\n     * @param key - The unique identifier of the value to remove.\n     * @returns A promise that resolves when the removal operation is complete.\n     */\n    async remove(key: string): Promise<void> {\n        try {\n            const driver = await ensureLocalForageReady();\n\n            await driver.removeItem(key);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    },\n    /**\n     * Retrieves all storage keys.\n     * This method returns an array of all keys that currently have stored values.\n     * Returns an empty array if no keys exist or if an error occurs.\n     *\n     * @returns A promise that resolves to an array of storage keys.\n     */\n    async keys(): Promise<string[]> {\n        try {\n            const driver = await ensureLocalForageReady();\n            const keys = await driver.keys();\n\n            if (!Array.isArray(keys)) {\n                log.warn(`[Storage:keys] Invalid keys response:`, keys);\n                return [];\n            }\n\n            return keys;\n        }\n        catch (error) {\n            return catchError(error, { returnValue: [] });\n        }\n    },\n    /**\n     * Gets a human-readable log link for a storage key.\n     * This method provides a formatted string that shows the storage directory path\n     * and the key name for debugging and manual inspection purposes.\n     *\n     * @param key - The storage key to generate a log link for.\n     * @returns A promise that resolves to a formatted log link string or null if an error occurs.\n     */\n    async getLogLink(key: string): Promise<string | null> {\n        try {\n            const storagePath = path.join(env.CYBERSKILL_STORAGE_DIRECTORY, encodeKey(key));\n\n            return `${storagePath} (key: ${key})`;\n        }\n        catch (error) {\n            return catchError(error, { returnValue: null });\n        }\n    },\n\n};\n"],"names":["env","getEnv","nodeFsDriverState","encodeKey","key","STORAGE_KEY_EXTENSION","decodeKey","fileName","getFilePath","baseDir","path","nodeFsDriver","NODE_FS_DRIVER_NAME","options","baseDirFromOptions","fs","error","log","filePath","content","iterator","keys","iterationNumber","value","result","keyIndex","file","initPromise","driverInstance","ensureLocalForageReady","localForage","driver","initOptions","STORAGE_INSTANCE_NAME","STORAGE_STORE_NAME","storage","catchError"],"mappings":"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"}
+{"version":3,"file":"storage.util.js","names":[],"sources":["../../../src/node/storage/storage.util.ts"],"sourcesContent":["import localForage from 'localforage';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { getEnv } from '#config/env/index.js';\n\nimport type { LocalForageDriver, NodeFsDriverState, NodeLocalForageOptions } from './storage.type.js';\n\nimport { catchError, log } from '../log/index.js';\nimport { NODE_FS_DRIVER_NAME, STORAGE_INSTANCE_NAME, STORAGE_KEY_EXTENSION, STORAGE_STORE_NAME } from './storage.constant.js';\n\nconst nodeFsDriverState: NodeFsDriverState = {\n    baseDir: '',\n};\n\n/**\n * Encodes a storage key into a filename-safe string.\n */\nfunction encodeKey(key: string): string {\n    return `${encodeURIComponent(key)}${STORAGE_KEY_EXTENSION}`;\n}\n\n/**\n * Decodes a filename-safe key back to the original storage key.\n */\nfunction decodeKey(fileName: string): string {\n    return decodeURIComponent(fileName.slice(0, -STORAGE_KEY_EXTENSION.length));\n}\n\n/**\n * Maps a storage key to an absolute file path inside the storage directory.\n */\nfunction getFilePath(key: string, baseDir: string): string {\n    return path.join(baseDir, encodeKey(key));\n}\n\n/**\n * Custom localForage driver that stores JSON-encoded values on the filesystem.\n */\nconst nodeFsDriver: LocalForageDriver = {\n    _driver: NODE_FS_DRIVER_NAME,\n    _support: true,\n    /** Ensures the storage directory exists and respects custom baseDir overrides. */\n    async _initStorage(options: unknown) {\n        try {\n            const baseDirFromOptions = typeof options === 'object' && options !== null && 'baseDir' in options\n                ? (options as { baseDir?: unknown }).baseDir\n                : undefined;\n\n            if (typeof baseDirFromOptions === 'string' && baseDirFromOptions.length > 0) {\n                nodeFsDriverState.baseDir = baseDirFromOptions;\n            }\n            else {\n                nodeFsDriverState.baseDir = getEnv().CYBERSKILL_STORAGE_DIRECTORY;\n            }\n\n            await fs.mkdir(nodeFsDriverState.baseDir, { recursive: true });\n        }\n        catch (error) {\n            log.error('[Storage:init]', error);\n            throw error;\n        }\n    },\n    /** Deletes all stored entries by recreating the directory. Callers must ensure no concurrent operations. */\n    async clear() {\n        const { baseDir } = nodeFsDriverState;\n\n        if (!baseDir) {\n            return;\n        }\n\n        await fs.rm(baseDir, { recursive: true, force: true });\n        await fs.mkdir(baseDir, { recursive: true });\n    },\n    /** Reads and parses a stored value; returns null when the file is missing. */\n    async getItem<T>(key: string): Promise<T | null> {\n        const { baseDir } = nodeFsDriverState;\n        const filePath = getFilePath(key, baseDir);\n\n        try {\n            const content = await fs.readFile(filePath, 'utf8');\n\n            return JSON.parse(content) as T;\n        }\n        catch (error) {\n            if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n                return null;\n            }\n            throw error;\n        }\n    },\n    /** Iterates through all keys, invoking the iterator until it returns a value. */\n    async iterate<T, U>(iterator: (value: T, key: string, iterationNumber: number) => U): Promise<U> {\n        const keys = await nodeFsDriver.keys();\n        let iterationNumber = 1;\n\n        for (const key of keys) {\n            const value = await nodeFsDriver.getItem<T>(key);\n\n            const result = iterator(value as T, key, iterationNumber);\n\n            if (result !== undefined) {\n                return result;\n            }\n            iterationNumber += 1;\n        }\n\n        return undefined as unknown as U;\n    },\n    /** Returns the key name at the given index or null when out of bounds. */\n    async key(keyIndex: number): Promise<string> {\n        const keys = await nodeFsDriver.keys();\n\n        return keys[keyIndex] ?? null as unknown as string;\n    },\n    /** Lists all stored keys. */\n    async keys(): Promise<string[]> {\n        const { baseDir } = nodeFsDriverState;\n\n        try {\n            const files = await fs.readdir(baseDir);\n\n            return files\n                .filter(file => file.endsWith(STORAGE_KEY_EXTENSION))\n                .map(decodeKey);\n        }\n        catch (error) {\n            if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n                return [];\n            }\n            throw error;\n        }\n    },\n    /** Returns the count of stored keys. */\n    async length(): Promise<number> {\n        const keys = await nodeFsDriver.keys();\n\n        return keys.length;\n    },\n    /** Removes a stored value for the given key. */\n    async removeItem(key: string): Promise<void> {\n        const { baseDir } = nodeFsDriverState;\n        const filePath = getFilePath(key, baseDir);\n\n        await fs.rm(filePath, { force: true });\n    },\n    /** Stores a value as JSON on disk. */\n    async setItem<T>(key: string, value: T): Promise<T> {\n        const { baseDir } = nodeFsDriverState;\n        const filePath = getFilePath(key, baseDir);\n\n        await fs.mkdir(baseDir, { recursive: true });\n        await fs.writeFile(filePath, JSON.stringify(value), 'utf8');\n\n        return value;\n    },\n};\n\nlet initPromise: Promise<void> | null = null;\nlet driverInstance: LocalForageDriver | null = null;\n\n/**\n * Prepares and returns the filesystem-backed localForage driver.\n * We bypass localForage's default driver selection and explicitly initialize\n * our custom driver to ensure Node compatibility.\n */\nasync function ensureLocalForageReady(): Promise<LocalForageDriver> {\n    if (initPromise) {\n        await initPromise;\n        return driverInstance as LocalForageDriver;\n    }\n\n    initPromise = (async () => {\n        await localForage.defineDriver(nodeFsDriver);\n        nodeFsDriverState.baseDir = getEnv().CYBERSKILL_STORAGE_DIRECTORY;\n        const driver = await localForage.getDriver(NODE_FS_DRIVER_NAME);\n\n        const initOptions = {\n            baseDir: nodeFsDriverState.baseDir,\n            name: STORAGE_INSTANCE_NAME,\n            storeName: STORAGE_STORE_NAME,\n        } satisfies NodeLocalForageOptions;\n\n        await driver._initStorage(initOptions as unknown as Parameters<typeof driver._initStorage>[0]);\n        driverInstance = driver;\n    })().catch((error) => {\n        initPromise = null;\n        throw error;\n    });\n\n    await initPromise;\n\n    return driverInstance as LocalForageDriver;\n}\n\n/**\n * Persistent storage utility object for data persistence across application sessions.\n * This object provides methods for storing, retrieving, and managing data using localForage,\n * with automatic initialization and error handling.\n */\nexport const storage = {\n    /**\n     * Retrieves a value from persistent storage by key.\n     * This method fetches data that was previously stored using the set method.\n     * Returns null if the key doesn't exist or if an error occurs.\n     *\n     * @param key - The unique identifier for the stored value.\n     * @returns A promise that resolves to the stored value or null if not found.\n     */\n    async get<T = unknown>(key: string): Promise<T | null> {\n        try {\n            const driver = await ensureLocalForageReady();\n            const result = await driver.getItem<T>(key);\n\n            return result ?? null;\n        }\n        catch (error) {\n            return catchError(error, { returnValue: null });\n        }\n    },\n    /**\n     * Stores a value in persistent storage with a unique key.\n     * This method saves data that can be retrieved later using the get method.\n     * The data is automatically serialized and stored in the configured storage directory.\n     *\n     * @param key - The unique identifier for the value to store.\n     * @param value - The data to store (will be automatically serialized).\n     * @returns A promise that resolves when the storage operation is complete.\n     */\n    async set<T = unknown>(key: string, value: T): Promise<void> {\n        try {\n            const driver = await ensureLocalForageReady();\n\n            await driver.setItem(key, value);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    },\n    /**\n     * Removes a value from persistent storage by key.\n     * This method permanently deletes the stored data associated with the specified key.\n     *\n     * @param key - The unique identifier of the value to remove.\n     * @returns A promise that resolves when the removal operation is complete.\n     */\n    async remove(key: string): Promise<void> {\n        try {\n            const driver = await ensureLocalForageReady();\n\n            await driver.removeItem(key);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    },\n    /**\n     * Retrieves all storage keys.\n     * This method returns an array of all keys that currently have stored values.\n     * Returns an empty array if no keys exist or if an error occurs.\n     *\n     * @returns A promise that resolves to an array of storage keys.\n     */\n    async keys(): Promise<string[]> {\n        try {\n            const driver = await ensureLocalForageReady();\n            const keys = await driver.keys();\n\n            if (!Array.isArray(keys)) {\n                log.warn(`[Storage:keys] Invalid keys response:`, keys);\n                return [];\n            }\n\n            return keys;\n        }\n        catch (error) {\n            return catchError(error, { returnValue: [] });\n        }\n    },\n    /**\n     * Gets a human-readable log link for a storage key.\n     * This method provides a formatted string that shows the storage directory path\n     * and the key name for debugging and manual inspection purposes.\n     *\n     * @param key - The storage key to generate a log link for.\n     * @returns A promise that resolves to a formatted log link string or null if an error occurs.\n     */\n    async getLogLink(key: string): Promise<string | null> {\n        try {\n            const storagePath = path.join(getEnv().CYBERSKILL_STORAGE_DIRECTORY, encodeKey(key));\n\n            return `${storagePath} (key: ${key})`;\n        }\n        catch (error) {\n            return catchError(error, { returnValue: null });\n        }\n    },\n\n};\n"],"mappings":"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"}

package/dist/node/upload/index.js

@@ -1,16 +1,4 @@
-import { BYTES_PER_MB as o, DEFAULT_UPLOAD_CONFIG as t } from "./upload.constant.js";
-import { E_UploadType as i } from "./upload.type.js";
-import { createUploadConfig as d, getAndValidateFile as p, getFileSizeFromStream as F, getFileWebStream as m, upload as E, validateFileExtension as U, validateUpload as _ } from "./upload.util.js";
-export {
-  o as BYTES_PER_MB,
-  t as DEFAULT_UPLOAD_CONFIG,
-  i as E_UploadType,
-  d as createUploadConfig,
-  p as getAndValidateFile,
-  F as getFileSizeFromStream,
-  m as getFileWebStream,
-  E as upload,
-  U as validateFileExtension,
-  _ as validateUpload
-};
-//# sourceMappingURL=index.js.map
+import { E_UploadType as e } from "./upload.type.js";
+import { BYTES_PER_MB as t, DEFAULT_UPLOAD_CONFIG as n } from "./upload.constant.js";
+import { createUploadConfig as r, getAndValidateFile as i, getFileSizeFromStream as a, getFileWebStream as o, upload as s, validateFileExtension as c, validateUpload as l } from "./upload.util.js";
+export { t as BYTES_PER_MB, n as DEFAULT_UPLOAD_CONFIG, e as E_UploadType, r as createUploadConfig, i as getAndValidateFile, a as getFileSizeFromStream, o as getFileWebStream, s as upload, c as validateFileExtension, l as validateUpload };

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

@@ -1,33 +1,59 @@
-import { E_UploadType as i } from "./upload.type.js";
-const o = 1024 * 1024, s = {
-  [i.IMAGE]: {
-    allowedExtensions: ["jpg", "jpeg", "png", "gif", "webp", "svg"],
-    sizeLimit: 5 * 1024 * 1024
-    // 5MB
-  },
-  [i.VIDEO]: {
-    allowedExtensions: ["mp4", "avi", "mov", "wmv", "flv", "webm"],
-    sizeLimit: 500 * 1024 * 1024
-    // 500MB
-  },
-  [i.AUDIO]: {
-    allowedExtensions: ["mp3", "wav", "ogg", "m4a", "aac"],
-    sizeLimit: 50 * 1024 * 1024
-    // 50MB
-  },
-  [i.DOCUMENT]: {
-    allowedExtensions: ["pdf", "doc", "docx", "txt", "rtf"],
-    sizeLimit: 10 * 1024 * 1024
-    // 10MB
-  },
-  [i.OTHER]: {
-    allowedExtensions: ["zip", "rar", "tar", "gz"],
-    sizeLimit: 5 * 1024 * 1024
-    // 5MB
-  }
+import { E_UploadType as e } from "./upload.type.js";
+//#region src/node/upload/upload.constant.ts
+var t = 1024 * 1024, n = {
+	[e.IMAGE]: {
+		allowedExtensions: [
+			"jpg",
+			"jpeg",
+			"png",
+			"gif",
+			"webp",
+			"svg"
+		],
+		sizeLimit: 5 * 1024 * 1024
+	},
+	[e.VIDEO]: {
+		allowedExtensions: [
+			"mp4",
+			"avi",
+			"mov",
+			"wmv",
+			"flv",
+			"webm"
+		],
+		sizeLimit: 500 * 1024 * 1024
+	},
+	[e.AUDIO]: {
+		allowedExtensions: [
+			"mp3",
+			"wav",
+			"ogg",
+			"m4a",
+			"aac"
+		],
+		sizeLimit: 50 * 1024 * 1024
+	},
+	[e.DOCUMENT]: {
+		allowedExtensions: [
+			"pdf",
+			"doc",
+			"docx",
+			"txt",
+			"rtf"
+		],
+		sizeLimit: 10 * 1024 * 1024
+	},
+	[e.OTHER]: {
+		allowedExtensions: [
+			"zip",
+			"rar",
+			"tar",
+			"gz"
+		],
+		sizeLimit: 5 * 1024 * 1024
+	}
 };
-export {
-  o as BYTES_PER_MB,
-  s as DEFAULT_UPLOAD_CONFIG
-};
-//# sourceMappingURL=upload.constant.js.map
+//#endregion
+export { t as BYTES_PER_MB, n as DEFAULT_UPLOAD_CONFIG };
+
+//# sourceMappingURL=upload.constant.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"upload.constant.js","sources":["../../../src/node/upload/upload.constant.ts"],"sourcesContent":["import { E_UploadType } from './upload.type.js';\n\nexport const BYTES_PER_MB = 1024 * 1024;\n\nexport const DEFAULT_UPLOAD_CONFIG = {\n    [E_UploadType.IMAGE]: {\n        allowedExtensions: ['jpg', 'jpeg', 'png', 'gif', 'webp', 'svg'],\n        sizeLimit: 5 * 1024 * 1024, // 5MB\n    },\n    [E_UploadType.VIDEO]: {\n        allowedExtensions: ['mp4', 'avi', 'mov', 'wmv', 'flv', 'webm'],\n        sizeLimit: 500 * 1024 * 1024, // 500MB\n    },\n    [E_UploadType.AUDIO]: {\n        allowedExtensions: ['mp3', 'wav', 'ogg', 'm4a', 'aac'],\n        sizeLimit: 50 * 1024 * 1024, // 50MB\n    },\n    [E_UploadType.DOCUMENT]: {\n        allowedExtensions: ['pdf', 'doc', 'docx', 'txt', 'rtf'],\n        sizeLimit: 10 * 1024 * 1024, // 10MB\n    },\n    [E_UploadType.OTHER]: {\n        allowedExtensions: ['zip', 'rar', 'tar', 'gz'],\n        sizeLimit: 5 * 1024 * 1024, // 5MB\n    },\n};\n"],"names":["BYTES_PER_MB","DEFAULT_UPLOAD_CONFIG","E_UploadType"],"mappings":";AAEO,MAAMA,IAAe,OAAO,MAEtBC,IAAwB;AAAA,EACjC,CAACC,EAAa,KAAK,GAAG;AAAA,IAClB,mBAAmB,CAAC,OAAO,QAAQ,OAAO,OAAO,QAAQ,KAAK;AAAA,IAC9D,WAAW,IAAI,OAAO;AAAA;AAAA,EAAA;AAAA,EAE1B,CAACA,EAAa,KAAK,GAAG;AAAA,IAClB,mBAAmB,CAAC,OAAO,OAAO,OAAO,OAAO,OAAO,MAAM;AAAA,IAC7D,WAAW,MAAM,OAAO;AAAA;AAAA,EAAA;AAAA,EAE5B,CAACA,EAAa,KAAK,GAAG;AAAA,IAClB,mBAAmB,CAAC,OAAO,OAAO,OAAO,OAAO,KAAK;AAAA,IACrD,WAAW,KAAK,OAAO;AAAA;AAAA,EAAA;AAAA,EAE3B,CAACA,EAAa,QAAQ,GAAG;AAAA,IACrB,mBAAmB,CAAC,OAAO,OAAO,QAAQ,OAAO,KAAK;AAAA,IACtD,WAAW,KAAK,OAAO;AAAA;AAAA,EAAA;AAAA,EAE3B,CAACA,EAAa,KAAK,GAAG;AAAA,IAClB,mBAAmB,CAAC,OAAO,OAAO,OAAO,IAAI;AAAA,IAC7C,WAAW,IAAI,OAAO;AAAA;AAAA,EAAA;AAE9B;"}
+{"version":3,"file":"upload.constant.js","names":[],"sources":["../../../src/node/upload/upload.constant.ts"],"sourcesContent":["import { E_UploadType } from './upload.type.js';\n\nexport const BYTES_PER_MB = 1024 * 1024;\n\nexport const DEFAULT_UPLOAD_CONFIG = {\n    [E_UploadType.IMAGE]: {\n        allowedExtensions: ['jpg', 'jpeg', 'png', 'gif', 'webp', 'svg'],\n        sizeLimit: 5 * 1024 * 1024, // 5MB\n    },\n    [E_UploadType.VIDEO]: {\n        allowedExtensions: ['mp4', 'avi', 'mov', 'wmv', 'flv', 'webm'],\n        sizeLimit: 500 * 1024 * 1024, // 500MB\n    },\n    [E_UploadType.AUDIO]: {\n        allowedExtensions: ['mp3', 'wav', 'ogg', 'm4a', 'aac'],\n        sizeLimit: 50 * 1024 * 1024, // 50MB\n    },\n    [E_UploadType.DOCUMENT]: {\n        allowedExtensions: ['pdf', 'doc', 'docx', 'txt', 'rtf'],\n        sizeLimit: 10 * 1024 * 1024, // 10MB\n    },\n    [E_UploadType.OTHER]: {\n        allowedExtensions: ['zip', 'rar', 'tar', 'gz'],\n        sizeLimit: 5 * 1024 * 1024, // 5MB\n    },\n};\n"],"mappings":";;AAEA,IAAa,IAAe,OAAO,MAEtB,IAAwB;EAChC,EAAa,QAAQ;EAClB,mBAAmB;GAAC;GAAO;GAAQ;GAAO;GAAO;GAAQ;GAAM;EAC/D,WAAW,IAAI,OAAO;EACzB;EACA,EAAa,QAAQ;EAClB,mBAAmB;GAAC;GAAO;GAAO;GAAO;GAAO;GAAO;GAAO;EAC9D,WAAW,MAAM,OAAO;EAC3B;EACA,EAAa,QAAQ;EAClB,mBAAmB;GAAC;GAAO;GAAO;GAAO;GAAO;GAAM;EACtD,WAAW,KAAK,OAAO;EAC1B;EACA,EAAa,WAAW;EACrB,mBAAmB;GAAC;GAAO;GAAO;GAAQ;GAAO;GAAM;EACvD,WAAW,KAAK,OAAO;EAC1B;EACA,EAAa,QAAQ;EAClB,mBAAmB;GAAC;GAAO;GAAO;GAAO;GAAK;EAC9C,WAAW,IAAI,OAAO;EACzB;CACJ"}

package/dist/node/upload/upload.type.js

@@ -1,5 +1,8 @@
-var D = /* @__PURE__ */ ((O) => (O.IMAGE = "IMAGE", O.VIDEO = "VIDEO", O.AUDIO = "AUDIO", O.DOCUMENT = "DOCUMENT", O.OTHER = "OTHER", O))(D || {});
-export {
-  D as E_UploadType
-};
-//# sourceMappingURL=upload.type.js.map
+//#region src/node/upload/upload.type.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.IMAGE = "IMAGE", e.VIDEO = "VIDEO", e.AUDIO = "AUDIO", e.DOCUMENT = "DOCUMENT", e.OTHER = "OTHER", e;
+}({});
+//#endregion
+export { e as E_UploadType };
+
+//# sourceMappingURL=upload.type.js.map

package/dist/node/upload/upload.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.type.js","sources":["../../../src/node/upload/upload.type.ts"],"sourcesContent":["export enum E_UploadType {\n    IMAGE = 'IMAGE',\n    VIDEO = 'VIDEO',\n    AUDIO = 'AUDIO',\n    DOCUMENT = 'DOCUMENT',\n    OTHER = 'OTHER',\n}\n\nexport interface I_UploadValidationConfig {\n    filename: string;\n    fileSize?: number;\n}\n\nexport interface I_UploadTypeConfig {\n    allowedExtensions: string[];\n    sizeLimit: number;\n}\n\nexport interface I_UploadConfig {\n    [E_UploadType.IMAGE]: I_UploadTypeConfig;\n    [E_UploadType.VIDEO]: I_UploadTypeConfig;\n    [E_UploadType.AUDIO]: I_UploadTypeConfig;\n    [E_UploadType.DOCUMENT]: I_UploadTypeConfig;\n    [E_UploadType.OTHER]: I_UploadTypeConfig;\n}\n\nexport interface I_UploadFileData {\n    createReadStream: () => NodeJS.ReadableStream;\n    filename: string;\n}\n\nexport interface I_UploadFile {\n    file: I_UploadFileData;\n}\n\nexport interface I_UploadOptions {\n    file: Promise<I_UploadFile>;\n    path: string;\n    type: E_UploadType;\n    config?: I_UploadConfig;\n}\n"],"names":["E_UploadType"],"mappings":"AAAO,IAAKA,sBAAAA,OACRA,EAAA,QAAQ,SACRA,EAAA,QAAQ,SACRA,EAAA,QAAQ,SACRA,EAAA,WAAW,YACXA,EAAA,QAAQ,SALAA,IAAAA,KAAA,CAAA,CAAA;"}
+{"version":3,"file":"upload.type.js","names":[],"sources":["../../../src/node/upload/upload.type.ts"],"sourcesContent":["export enum E_UploadType {\n    IMAGE = 'IMAGE',\n    VIDEO = 'VIDEO',\n    AUDIO = 'AUDIO',\n    DOCUMENT = 'DOCUMENT',\n    OTHER = 'OTHER',\n}\n\nexport interface I_UploadValidationConfig {\n    filename: string;\n    fileSize?: number;\n}\n\nexport interface I_UploadTypeConfig {\n    allowedExtensions: string[];\n    sizeLimit: number;\n}\n\nexport interface I_UploadConfig {\n    [E_UploadType.IMAGE]: I_UploadTypeConfig;\n    [E_UploadType.VIDEO]: I_UploadTypeConfig;\n    [E_UploadType.AUDIO]: I_UploadTypeConfig;\n    [E_UploadType.DOCUMENT]: I_UploadTypeConfig;\n    [E_UploadType.OTHER]: I_UploadTypeConfig;\n}\n\nexport interface I_UploadFileData {\n    createReadStream: () => NodeJS.ReadableStream;\n    filename: string;\n}\n\nexport interface I_UploadFile {\n    file: I_UploadFileData;\n}\n\nexport interface I_UploadOptions {\n    file: Promise<I_UploadFile>;\n    path: string;\n    type: E_UploadType;\n    config?: I_UploadConfig;\n}\n"],"mappings":";AAAA,IAAY,IAAL,yBAAA,GAAA;QACH,EAAA,QAAA,SACA,EAAA,QAAA,SACA,EAAA,QAAA,SACA,EAAA,WAAA,YACA,EAAA,QAAA;KACH"}