@scpxl/nodejs-framework 1.0.22 → 1.0.24

package/dist/util/file.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Check if a file or directory exists asynchronously
+ * @param pathToCheck - Path to check
+ * @returns Promise<boolean> - true if exists, false otherwise
+ */
+declare function pathExists(pathToCheck: string): Promise<boolean>;
+/**
+ * Ensure directory exists, create if it doesn't
+ * @param dirPath - Directory path to ensure
+ */
+declare function ensureDir(dirPath: string): Promise<void>;
+declare function convertFile({ inputFilePath, outputFilePath, format, }: {
+    inputFilePath: string;
+    outputFilePath: string;
+    format: string;
+}): Promise<void>;
+/**
+ * Copy a file or directory synchronously
+ *
+ * @param src The source path
+ * @param dest The destination path
+ */
+declare function copySync(src: string, dest: string): void;
+/**
+ * Download file from URL
+ *
+ * @param url The URL to download the file from
+ * @param destinationPath The path to save the downloaded file
+ */
+declare function downloadFile({ url, destinationPath }: {
+    url: string;
+    destinationPath: string;
+}): Promise<void>;
+/**
+ * Format file size.
+ *
+ * @param bytes The file size in bytes
+ */
+declare function formatFileSize({ bytes }: {
+    bytes: number;
+}): string;
+/**
+ * Remove a file or directory synchronously
+ *
+ * @param target The path to the file or directory to remove
+ */
+declare function removeSync(target: string): void;
+declare const _default: {
+    convertFile: typeof convertFile;
+    copySync: typeof copySync;
+    downloadFile: typeof downloadFile;
+    formatFileSize: typeof formatFileSize;
+    removeSync: typeof removeSync;
+    pathExists: typeof pathExists;
+    ensureDir: typeof ensureDir;
+};
+export default _default;
+//# sourceMappingURL=file.d.ts.map

package/dist/util/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/util/file.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,iBAAe,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;;GAGG;AACH,iBAAe,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED,iBAAe,WAAW,CAAC,EACzB,aAAa,EACb,cAAc,EACd,MAAM,GACP,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBhB;AAED;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBjD;AAED;;;;;GAKG;AACH,iBAAe,YAAY,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B7G;AAED;;;;GAIG;AACH,iBAAS,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAyB5D;AAED;;;;GAIG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAoBxC;;;;;;;;;;AAED,wBAQE"}

package/dist/util/helper.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Deep merge objects with defaults, preventing prototype pollution.
+ *
+ * This function:
+ * - Recursively merges source objects into the target
+ * - Preserves existing values in target (acts like defaults)
+ * - Sanitizes sources to remove dangerous keys (__proto__, constructor, prototype)
+ * - Prevents prototype pollution attacks
+ *
+ * @param target - The target object to merge into
+ * @param sources - Source objects providing default values
+ * @returns The merged target object (mutated)
+ *
+ * @example
+ * const userConfig = { host: 'localhost' };
+ * const defaults = { host: '0.0.0.0', port: 3001 };
+ * const merged = defaultsDeep(userConfig, defaults);
+ * // merged = { host: 'localhost', port: 3001 }
+ */
+declare function defaultsDeep<T extends object>(target: T, ...sources: Array<Partial<T>>): T;
+/**
+ * Check if a value is an object.
+ */
+declare function isObject(item: unknown): item is Record<string, unknown>;
+type AnyObject = Record<string, unknown>;
+/**
+ * Retrieves the value from an object using a dotted key path safely.
+ *
+ * @param obj - The object to retrieve the value from.
+ * @param path - The dotted key path (e.g., 'user.email').
+ * @returns The value at the specified key path or undefined if not found.
+ */
+declare function getValueFromObject(obj: AnyObject, path: string): unknown;
+/**
+ * Retrieves the value from an array of objects using a dotted key path.
+ *
+ * @param arr - The array of objects.
+ * @param path - The dotted key path (e.g., 'user.email').
+ * @returns An array of values at the specified key path from each object.
+ */
+declare function getValueFromArray(arr: AnyObject[], path: string): unknown[];
+declare function getScriptFileExtension(): string;
+declare const _default: {
+    defaultsDeep: typeof defaultsDeep;
+    isObject: typeof isObject;
+    getValueFromArray: typeof getValueFromArray;
+    getValueFromObject: typeof getValueFromObject;
+    getScriptFileExtension: typeof getScriptFileExtension;
+};
+export default _default;
+//# sourceMappingURL=helper.d.ts.map

package/dist/util/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/util/helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAgBnF;AA0HD;;GAEG;AACH,iBAAS,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhE;AAED,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,iBAAS,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAWjE;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAEpE;AAED,iBAAS,sBAAsB,IAAI,MAAM,CAExC;;;;;;;;AAED,wBAME"}

package/dist/util/helper.js

@@ -1,18 +1,80 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-import lodashDefaultsDeep from "lodash.defaultsdeep";
 function defaultsDeep(target, ...sources) {
-  const sanitizedSources = sources.map((source) => {
-    if (!isObject(source)) return source;
-    const sanitized = { ...source };
-    delete sanitized["__proto__"];
-    delete sanitized["constructor"];
-    delete sanitized["prototype"];
-    return sanitized;
-  });
-  return lodashDefaultsDeep(target, ...sanitizedSources);
+  let result = target;
+  if (target === null || target === void 0) {
+    result = {};
+  }
+  for (const source of sources) {
+    if (!isObject(source) && !Array.isArray(source)) continue;
+    mergeObjects(result, source);
+  }
+  return result;
 }
 __name(defaultsDeep, "defaultsDeep");
+function mergeObjects(target, source) {
+  if (Array.isArray(source)) {
+    if (!Array.isArray(target)) {
+      for (let i = 0; i < source.length; i++) {
+        const key = String(i);
+        if (key === "__proto__" || key === "constructor" || key === "prototype") continue;
+        const sourceValue = source[i];
+        const targetValue = target[key];
+        const keyExists = key in target;
+        if (keyExists && isObject(targetValue) && isObject(sourceValue)) {
+          mergeObjects(targetValue, sourceValue);
+        } else if (!keyExists || targetValue === void 0) {
+          target[key] = isObject(sourceValue) ? deepClone(sourceValue) : sourceValue;
+        }
+      }
+      return;
+    }
+    for (let i = 0; i < source.length; i++) {
+      const sourceValue = source[i];
+      const targetValue = target[i];
+      const indexExists = i in target;
+      if (indexExists && isObject(targetValue) && isObject(sourceValue)) {
+        mergeObjects(targetValue, sourceValue);
+      } else if (!indexExists || targetValue === void 0) {
+        target[i] = isObject(sourceValue) ? deepClone(sourceValue) : sourceValue;
+      }
+    }
+    return;
+  }
+  for (const key of Object.keys(source)) {
+    if (key === "__proto__" || key === "constructor" || key === "prototype") {
+      continue;
+    }
+    if (!Object.prototype.hasOwnProperty.call(source, key)) {
+      continue;
+    }
+    const sourceValue = source[key];
+    const targetValue = target[key];
+    if (Array.isArray(targetValue) && Array.isArray(sourceValue)) {
+      mergeObjects(targetValue, sourceValue);
+    } else if (isObject(targetValue) && Array.isArray(sourceValue)) {
+      mergeObjects(targetValue, sourceValue);
+    } else if (targetValue !== void 0 && isObject(targetValue) && isObject(sourceValue)) {
+      mergeObjects(targetValue, sourceValue);
+    } else if (targetValue === void 0) {
+      target[key] = isObject(sourceValue) || Array.isArray(sourceValue) ? deepClone(sourceValue) : sourceValue;
+    }
+  }
+}
+__name(mergeObjects, "mergeObjects");
+function deepClone(obj) {
+  if (!isObject(obj)) return obj;
+  const cloned = Array.isArray(obj) ? [] : {};
+  for (const key of Object.keys(obj)) {
+    if (key === "__proto__" || key === "constructor" || key === "prototype") {
+      continue;
+    }
+    const value = obj[key];
+    cloned[key] = isObject(value) ? deepClone(value) : value;
+  }
+  return cloned;
+}
+__name(deepClone, "deepClone");
 function isObject(item) {
   return item !== null && typeof item === "object" && !Array.isArray(item);
 }

package/dist/util/helper.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/helper.ts"],
-  "sourcesContent": ["import lodashDefaultsDeep from 'lodash.defaultsdeep';\n\n/**\n * Deep merge objects with defaults, preventing prototype pollution.\n *\n * This is a secure wrapper around lodash.defaultsdeep that:\n * - Sanitizes sources to remove dangerous keys (__proto__, constructor, prototype)\n * - Delegates to battle-tested lodash.defaultsdeep for merge logic\n * - Maintains backward compatibility with existing usage\n *\n * @param target - The target object to merge into\n * @param sources - Source objects providing default values\n * @returns The merged target object (mutated)\n *\n * @example\n * const userConfig = { host: 'localhost' };\n * const defaults = { host: '0.0.0.0', port: 3001 };\n * const merged = defaultsDeep(userConfig, defaults);\n * // merged = { host: 'localhost', port: 3001 }\n */\nfunction defaultsDeep<T extends object>(target: T, ...sources: Array<Partial<T>>): T {\n  // Sanitize sources to prevent prototype pollution\n  const sanitizedSources = sources.map(source => {\n    if (!isObject(source)) return source;\n\n    // Create a copy and remove dangerous properties\n    const sanitized: Record<string, unknown> = { ...source };\n    delete sanitized['__proto__'];\n    delete sanitized['constructor'];\n    delete sanitized['prototype'];\n    return sanitized;\n  });\n\n  // Delegate to lodash.defaultsdeep with sanitized sources\n  return lodashDefaultsDeep(target, ...sanitizedSources) as T;\n}\n\n/**\n * Check if a value is an object.\n */\nfunction isObject(item: unknown): item is Record<string, unknown> {\n  return item !== null && typeof item === 'object' && !Array.isArray(item);\n}\n\ntype AnyObject = Record<string, unknown>;\n\n/**\n * Retrieves the value from an object using a dotted key path safely.\n *\n * @param obj - The object to retrieve the value from.\n * @param path - The dotted key path (e.g., 'user.email').\n * @returns The value at the specified key path or undefined if not found.\n */\nfunction getValueFromObject(obj: AnyObject, path: string): unknown {\n  const parts = path.split('.');\n  let current: any = obj;\n  for (const part of parts) {\n    if (part === '__proto__' || part === 'constructor' || part === 'prototype') return undefined;\n    if (!current || !Object.prototype.hasOwnProperty.call(current, part)) return undefined;\n    // Access guarded by ownProperty check and blocked prototype keys\n    // eslint-disable-next-line security/detect-object-injection\n    current = (current as Record<string, any>)[part];\n  }\n  return current;\n}\n\n/**\n * Retrieves the value from an array of objects using a dotted key path.\n *\n * @param arr - The array of objects.\n * @param path - The dotted key path (e.g., 'user.email').\n * @returns An array of values at the specified key path from each object.\n */\nfunction getValueFromArray(arr: AnyObject[], path: string): unknown[] {\n  return arr.map(obj => getValueFromObject(obj, path));\n}\n\nfunction getScriptFileExtension(): string {\n  return process.env.NODE_ENV === 'development' ? 'ts' : 'js';\n}\n\nexport default {\n  defaultsDeep,\n  isObject,\n  getValueFromArray,\n  getValueFromObject,\n  getScriptFileExtension,\n};\n"],
-  "mappings": ";;AAAA,OAAO,wBAAwB;AAoB/B,SAAS,aAA+B,WAAc,SAA+B;AAEnF,QAAM,mBAAmB,QAAQ,IAAI,YAAU;AAC7C,QAAI,CAAC,SAAS,MAAM,EAAG,QAAO;AAG9B,UAAM,YAAqC,EAAE,GAAG,OAAO;AACvD,WAAO,UAAU,WAAW;AAC5B,WAAO,UAAU,aAAa;AAC9B,WAAO,UAAU,WAAW;AAC5B,WAAO;AAAA,EACT,CAAC;AAGD,SAAO,mBAAmB,QAAQ,GAAG,gBAAgB;AACvD;AAfS;AAoBT,SAAS,SAAS,MAAgD;AAChE,SAAO,SAAS,QAAQ,OAAO,SAAS,YAAY,CAAC,MAAM,QAAQ,IAAI;AACzE;AAFS;AAaT,SAAS,mBAAmB,KAAgB,MAAuB;AACjE,QAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,MAAI,UAAe;AACnB,aAAW,QAAQ,OAAO;AACxB,QAAI,SAAS,eAAe,SAAS,iBAAiB,SAAS,YAAa,QAAO;AACnF,QAAI,CAAC,WAAW,CAAC,OAAO,UAAU,eAAe,KAAK,SAAS,IAAI,EAAG,QAAO;AAG7E,cAAW,QAAgC,IAAI;AAAA,EACjD;AACA,SAAO;AACT;AAXS;AAoBT,SAAS,kBAAkB,KAAkB,MAAyB;AACpE,SAAO,IAAI,IAAI,SAAO,mBAAmB,KAAK,IAAI,CAAC;AACrD;AAFS;AAIT,SAAS,yBAAiC;AACxC,SAAO,QAAQ,IAAI,aAAa,gBAAgB,OAAO;AACzD;AAFS;AAIT,IAAO,iBAAQ;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
+  "sourcesContent": ["/**\n * Deep merge objects with defaults, preventing prototype pollution.\n *\n * This function:\n * - Recursively merges source objects into the target\n * - Preserves existing values in target (acts like defaults)\n * - Sanitizes sources to remove dangerous keys (__proto__, constructor, prototype)\n * - Prevents prototype pollution attacks\n *\n * @param target - The target object to merge into\n * @param sources - Source objects providing default values\n * @returns The merged target object (mutated)\n *\n * @example\n * const userConfig = { host: 'localhost' };\n * const defaults = { host: '0.0.0.0', port: 3001 };\n * const merged = defaultsDeep(userConfig, defaults);\n * // merged = { host: 'localhost', port: 3001 }\n */\nfunction defaultsDeep<T extends object>(target: T, ...sources: Array<Partial<T>>): T {\n  // Handle null/undefined target by converting to empty object\n  let result = target;\n  if (target === null || target === undefined) {\n    result = {} as T;\n  }\n\n  // Process each source\n  for (const source of sources) {\n    if (!isObject(source) && !Array.isArray(source)) continue;\n\n    // Recursively merge source into target\n    mergeObjects(result, source);\n  }\n\n  return result;\n}\n\n/**\n * Recursively merge source into target, preserving target values.\n * This acts like defaultsDeep - only fills in missing values from source.\n */\nfunction mergeObjects(target: any, source: any): void {\n  // Handle arrays specially - merge by index\n  if (Array.isArray(source)) {\n    // If target is not an array but source is, treat target as object with numeric keys\n    if (!Array.isArray(target)) {\n      // Merge array into object-like target\n      for (let i = 0; i < source.length; i++) {\n        const key = String(i);\n        if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue;\n\n        // eslint-disable-next-line security/detect-object-injection\n        const sourceValue = source[i];\n        // eslint-disable-next-line security/detect-object-injection\n        const targetValue = target[key];\n\n        // Check if key exists in target\n        const keyExists = key in target;\n\n        if (keyExists && isObject(targetValue) && isObject(sourceValue)) {\n          mergeObjects(targetValue, sourceValue);\n        } else if (!keyExists || targetValue === undefined) {\n          // eslint-disable-next-line security/detect-object-injection\n          target[key] = isObject(sourceValue) ? deepClone(sourceValue) : sourceValue;\n        }\n      }\n      return;\n    }\n\n    // Both are arrays - merge by index\n    for (let i = 0; i < source.length; i++) {\n      // eslint-disable-next-line security/detect-object-injection\n      const sourceValue = source[i];\n      // eslint-disable-next-line security/detect-object-injection\n      const targetValue = target[i];\n\n      // Check if index exists in target (not just if value is undefined)\n      const indexExists = i in target;\n\n      // If index exists and both values are objects, merge them\n      if (indexExists && isObject(targetValue) && isObject(sourceValue)) {\n        mergeObjects(targetValue, sourceValue);\n      }\n      // If index doesn't exist or value is undefined, fill from source\n      else if (!indexExists || targetValue === undefined) {\n        // eslint-disable-next-line security/detect-object-injection\n        target[i] = isObject(sourceValue) ? deepClone(sourceValue) : sourceValue;\n      }\n      // Otherwise, keep target's existing value\n    }\n    return;\n  }\n\n  // Regular object merging\n  for (const key of Object.keys(source)) {\n    // Block dangerous keys to prevent prototype pollution\n    if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n      continue;\n    }\n\n    // Only use hasOwnProperty for safer property access\n    if (!Object.prototype.hasOwnProperty.call(source, key)) {\n      continue;\n    }\n\n    // Access guarded by ownProperty check and blocked prototype keys\n    // eslint-disable-next-line security/detect-object-injection\n    const sourceValue = source[key];\n\n    // eslint-disable-next-line security/detect-object-injection\n    const targetValue = target[key];\n\n    // If both are arrays, merge them by index\n    if (Array.isArray(targetValue) && Array.isArray(sourceValue)) {\n      mergeObjects(targetValue, sourceValue);\n    }\n    // If target is object and source is array, merge array into object by numeric keys\n    else if (isObject(targetValue) && Array.isArray(sourceValue)) {\n      mergeObjects(targetValue, sourceValue);\n    }\n    // If target value exists and both are objects (not arrays), recurse\n    else if (targetValue !== undefined && isObject(targetValue) && isObject(sourceValue)) {\n      mergeObjects(targetValue, sourceValue);\n    }\n    // If target doesn't have this key, set it from source\n    else if (targetValue === undefined) {\n      // eslint-disable-next-line security/detect-object-injection\n      target[key] = isObject(sourceValue) || Array.isArray(sourceValue) ? deepClone(sourceValue) : sourceValue;\n    }\n    // Otherwise, keep target's existing value (defaultsDeep behavior)\n  }\n}\n\n/**\n * Deep clone an object to avoid reference sharing.\n */\nfunction deepClone<T>(obj: T): T {\n  if (!isObject(obj)) return obj;\n\n  const cloned: any = Array.isArray(obj) ? [] : {};\n\n  for (const key of Object.keys(obj)) {\n    // Block dangerous keys\n    if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n      continue;\n    }\n\n    // eslint-disable-next-line security/detect-object-injection\n    const value = (obj as any)[key];\n\n    // eslint-disable-next-line security/detect-object-injection\n    cloned[key] = isObject(value) ? deepClone(value) : value;\n  }\n\n  return cloned;\n}\n\n/**\n * Check if a value is an object.\n */\nfunction isObject(item: unknown): item is Record<string, unknown> {\n  return item !== null && typeof item === 'object' && !Array.isArray(item);\n}\n\ntype AnyObject = Record<string, unknown>;\n\n/**\n * Retrieves the value from an object using a dotted key path safely.\n *\n * @param obj - The object to retrieve the value from.\n * @param path - The dotted key path (e.g., 'user.email').\n * @returns The value at the specified key path or undefined if not found.\n */\nfunction getValueFromObject(obj: AnyObject, path: string): unknown {\n  const parts = path.split('.');\n  let current: any = obj;\n  for (const part of parts) {\n    if (part === '__proto__' || part === 'constructor' || part === 'prototype') return undefined;\n    if (!current || !Object.prototype.hasOwnProperty.call(current, part)) return undefined;\n    // Access guarded by ownProperty check and blocked prototype keys\n    // eslint-disable-next-line security/detect-object-injection\n    current = (current as Record<string, any>)[part];\n  }\n  return current;\n}\n\n/**\n * Retrieves the value from an array of objects using a dotted key path.\n *\n * @param arr - The array of objects.\n * @param path - The dotted key path (e.g., 'user.email').\n * @returns An array of values at the specified key path from each object.\n */\nfunction getValueFromArray(arr: AnyObject[], path: string): unknown[] {\n  return arr.map(obj => getValueFromObject(obj, path));\n}\n\nfunction getScriptFileExtension(): string {\n  return process.env.NODE_ENV === 'development' ? 'ts' : 'js';\n}\n\nexport default {\n  defaultsDeep,\n  isObject,\n  getValueFromArray,\n  getValueFromObject,\n  getScriptFileExtension,\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/util/image.d.ts

@@ -0,0 +1,12 @@
+declare function extractMimeType({ base64 }: {
+    base64: string;
+}): string | undefined;
+declare function mimeTypeToExtension({ mimeType }: {
+    mimeType: string;
+}): string | undefined;
+declare const _default: {
+    extractMimeType: typeof extractMimeType;
+    mimeTypeToExtension: typeof mimeTypeToExtension;
+};
+export default _default;
+//# sourceMappingURL=image.d.ts.map

package/dist/util/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/util/image.ts"],"names":[],"mappings":"AAAA,iBAAS,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAO3E;AAED,iBAAS,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAenF;;;;;AAED,wBAGE"}

package/dist/util/index.d.ts

@@ -0,0 +1,11 @@
+export { default as Time } from './time.js';
+export { default as Timing } from './timing.js';
+export { default as File } from './file.js';
+export { default as Helper } from './helper.js';
+export { default as Image } from './image.js';
+export { default as Loader } from './loader.js';
+export { default as Num } from './num.js';
+export { default as OS } from './os.js';
+export { default as Str } from './str.js';
+export { default as URL } from './url.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/util/loader.d.ts

@@ -0,0 +1,21 @@
+export interface ModuleMap<T = unknown> {
+    [key: string]: T;
+}
+export type EntityClass<T = unknown> = new (...args: unknown[]) => T;
+declare const _default: {
+    loadModulesInDirectory: <T = unknown>({ directory, extensions, }: {
+        directory: string;
+        extensions?: string[];
+    }) => Promise<ModuleMap<T>>;
+    loadEntityModule: <T = unknown>({ entitiesDirectory, entityName, }: {
+        entitiesDirectory: string;
+        entityName: string;
+    }) => Promise<EntityClass<T>>;
+    clearModuleCache: () => void;
+    getCacheStats: () => {
+        modulesCached: number;
+        entitiesCached: number;
+    };
+};
+export default _default;
+//# sourceMappingURL=loader.d.ts.map

package/dist/util/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/util/loader.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;CAClB;AAgFD,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;;6BAlE/B,CAAC,wCAGpC;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,KAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;uBA8DO,CAAC,gDAG9B;QACD,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;KACpB,KAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;4BAkCE,IAAI;yBAKP;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;;AAO3E,wBAKE"}

package/dist/util/loader.js

@@ -41,10 +41,13 @@ const loadModulesInDirectory = /* @__PURE__ */ __name(async ({
     }
     const moduleName = path.basename(file, ext);
     const filePath = path.join(directory, file);
+    const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+    const fileUrl = `file://${absolutePath.replace(/\\/g, "/")}`;
     try {
-      const importedModule = await import(filePath);
+      const importedModule = await import(fileUrl);
       if (moduleName !== "__proto__" && moduleName !== "constructor" && moduleName !== "prototype") {
-        Reflect.set(loadedModules, moduleName, importedModule.default);
+        const moduleExport = importedModule.default ?? importedModule;
+        Reflect.set(loadedModules, moduleName, moduleExport);
       }
     } catch (error) {
       console.error(`Failed to import module ${filePath}:`, error);

package/dist/util/loader.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/loader.ts"],
-  "sourcesContent": ["import fs from 'fs';\nimport path from 'path';\nimport { LRUCache } from 'lru-cache';\nimport { Helper } from './index.js';\n\n// Type for a map of loaded modules\nexport interface ModuleMap<T = unknown> {\n  [key: string]: T;\n}\n\n// Cache for loaded modules to avoid repeated imports\n// Using LRU cache to prevent unbounded memory growth in long-running processes\nconst moduleCache = new LRUCache<string, ModuleMap>({\n  max: 100, // Max 100 directories cached\n  ttl: 1000 * 60 * 10, // 10 minutes\n});\n\nconst entityCache = new LRUCache<string, EntityClass>({\n  max: 500, // Max 500 entities cached (accessed more frequently than modules)\n  ttl: 1000 * 60 * 10, // 10 minutes\n});\n\nconst loadModulesInDirectory = async <T = unknown>({\n  directory,\n  extensions,\n}: {\n  directory: string;\n  extensions?: string[];\n}): Promise<ModuleMap<T>> => {\n  // Create cache key based on directory and extensions\n  const cacheKey = `${directory}:${extensions?.join(',') ?? 'all'}`;\n\n  // Check cache first\n  if (moduleCache.has(cacheKey)) {\n    const cachedModule = moduleCache.get(cacheKey);\n    if (cachedModule) {\n      return cachedModule as ModuleMap<T>;\n    }\n  }\n\n  const loadedModules: ModuleMap<T> = {};\n\n  // Use readdir with withFileTypes option to avoid separate stat calls\n  const dirents = await fs.promises.readdir(directory, { withFileTypes: true });\n\n  for (const dirent of dirents) {\n    // Skip directories without needing stat call\n    if (dirent.isDirectory()) {\n      continue;\n    }\n\n    const file = dirent.name;\n    const ext = path.extname(file);\n    const isDeclarationFile = file.endsWith('.d.ts');\n\n    // Skip files that are not in the specified extensions or are .d.ts files\n    if ((extensions && extensions.length > 0 && !extensions.includes(ext)) || isDeclarationFile) {\n      continue;\n    }\n\n    const moduleName = path.basename(file, ext);\n    const filePath = path.join(directory, file);\n\n    try {\n      const importedModule = await import(filePath);\n\n      // Use safe property assignment to prevent prototype pollution\n      if (moduleName !== '__proto__' && moduleName !== 'constructor' && moduleName !== 'prototype') {\n        Reflect.set(loadedModules, moduleName, importedModule.default);\n      }\n    } catch (error) {\n      console.error(`Failed to import module ${filePath}:`, error);\n    }\n  }\n\n  // Cache the results for future use\n  moduleCache.set(cacheKey, loadedModules);\n\n  return loadedModules;\n};\n\n// Type constraint for entity classes (must be constructable)\nexport type EntityClass<T = unknown> = new (...args: unknown[]) => T;\n\nconst loadEntityModule = async <T = unknown>({\n  entitiesDirectory,\n  entityName,\n}: {\n  entitiesDirectory: string;\n  entityName: string;\n}): Promise<EntityClass<T>> => {\n  // Create cache key based on directory and entity name\n  const cacheKey = `${entitiesDirectory}:${entityName}`;\n\n  // Check cache first\n  if (entityCache.has(cacheKey)) {\n    return entityCache.get(cacheKey) as EntityClass<T>;\n  }\n\n  // Define entity module path\n  const entityModulePath = path.join(entitiesDirectory, `${entityName}.${Helper.getScriptFileExtension()}`);\n\n  // Import entity module\n  const entityModule = await import(entityModulePath);\n\n  // Safe property access to prevent prototype pollution\n  if (entityName === '__proto__' || entityName === 'constructor' || entityName === 'prototype') {\n    throw new Error(`Invalid entity name (Entity: ${entityName})`);\n  }\n\n  if (!entityModule || !Object.prototype.hasOwnProperty.call(entityModule, entityName)) {\n    throw new Error(`Entity not found (Entity: ${entityName})`);\n  }\n\n  // Get entity class\n  const EntityClass = Reflect.get(entityModule, entityName);\n\n  // Cache the entity for future use\n  entityCache.set(cacheKey, EntityClass);\n\n  return EntityClass;\n};\n\n// Cache management functions for development/testing\nconst clearModuleCache = (): void => {\n  moduleCache.clear();\n  entityCache.clear();\n};\n\nconst getCacheStats = (): { modulesCached: number; entitiesCached: number } => {\n  return {\n    modulesCached: moduleCache.size,\n    entitiesCached: entityCache.size,\n  };\n};\n\nexport default {\n  loadModulesInDirectory,\n  loadEntityModule,\n  clearModuleCache,\n  getCacheStats,\n};\n"],
-  "mappings": ";;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,gBAAgB;AACzB,SAAS,cAAc;AASvB,MAAM,cAAc,IAAI,SAA4B;AAAA,EAClD,KAAK;AAAA;AAAA,EACL,KAAK,MAAO,KAAK;AAAA;AACnB,CAAC;AAED,MAAM,cAAc,IAAI,SAA8B;AAAA,EACpD,KAAK;AAAA;AAAA,EACL,KAAK,MAAO,KAAK;AAAA;AACnB,CAAC;AAED,MAAM,yBAAyB,8BAAoB;AAAA,EACjD;AAAA,EACA;AACF,MAG6B;AAE3B,QAAM,WAAW,GAAG,SAAS,IAAI,YAAY,KAAK,GAAG,KAAK,KAAK;AAG/D,MAAI,YAAY,IAAI,QAAQ,GAAG;AAC7B,UAAM,eAAe,YAAY,IAAI,QAAQ;AAC7C,QAAI,cAAc;AAChB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,gBAA8B,CAAC;AAGrC,QAAM,UAAU,MAAM,GAAG,SAAS,QAAQ,WAAW,EAAE,eAAe,KAAK,CAAC;AAE5E,aAAW,UAAU,SAAS;AAE5B,QAAI,OAAO,YAAY,GAAG;AACxB;AAAA,IACF;AAEA,UAAM,OAAO,OAAO;AACpB,UAAM,MAAM,KAAK,QAAQ,IAAI;AAC7B,UAAM,oBAAoB,KAAK,SAAS,OAAO;AAG/C,QAAK,cAAc,WAAW,SAAS,KAAK,CAAC,WAAW,SAAS,GAAG,KAAM,mBAAmB;AAC3F;AAAA,IACF;AAEA,UAAM,aAAa,KAAK,SAAS,MAAM,GAAG;AAC1C,UAAM,WAAW,KAAK,KAAK,WAAW,IAAI;AAE1C,QAAI;AACF,YAAM,iBAAiB,MAAM,OAAO;AAGpC,UAAI,eAAe,eAAe,eAAe,iBAAiB,eAAe,aAAa;AAC5F,gBAAQ,IAAI,eAAe,YAAY,eAAe,OAAO;AAAA,MAC/D;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,2BAA2B,QAAQ,KAAK,KAAK;AAAA,IAC7D;AAAA,EACF;AAGA,cAAY,IAAI,UAAU,aAAa;AAEvC,SAAO;AACT,GAzD+B;AA8D/B,MAAM,mBAAmB,8BAAoB;AAAA,EAC3C;AAAA,EACA;AACF,MAG+B;AAE7B,QAAM,WAAW,GAAG,iBAAiB,IAAI,UAAU;AAGnD,MAAI,YAAY,IAAI,QAAQ,GAAG;AAC7B,WAAO,YAAY,IAAI,QAAQ;AAAA,EACjC;AAGA,QAAM,mBAAmB,KAAK,KAAK,mBAAmB,GAAG,UAAU,IAAI,OAAO,uBAAuB,CAAC,EAAE;AAGxG,QAAM,eAAe,MAAM,OAAO;AAGlC,MAAI,eAAe,eAAe,eAAe,iBAAiB,eAAe,aAAa;AAC5F,UAAM,IAAI,MAAM,gCAAgC,UAAU,GAAG;AAAA,EAC/D;AAEA,MAAI,CAAC,gBAAgB,CAAC,OAAO,UAAU,eAAe,KAAK,cAAc,UAAU,GAAG;AACpF,UAAM,IAAI,MAAM,6BAA6B,UAAU,GAAG;AAAA,EAC5D;AAGA,QAAM,cAAc,QAAQ,IAAI,cAAc,UAAU;AAGxD,cAAY,IAAI,UAAU,WAAW;AAErC,SAAO;AACT,GArCyB;AAwCzB,MAAM,mBAAmB,6BAAY;AACnC,cAAY,MAAM;AAClB,cAAY,MAAM;AACpB,GAHyB;AAKzB,MAAM,gBAAgB,6BAAyD;AAC7E,SAAO;AAAA,IACL,eAAe,YAAY;AAAA,IAC3B,gBAAgB,YAAY;AAAA,EAC9B;AACF,GALsB;AAOtB,IAAO,iBAAQ;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
+  "sourcesContent": ["import fs from 'fs';\nimport path from 'path';\nimport { LRUCache } from 'lru-cache';\nimport { Helper } from './index.js';\n\n// Type for a map of loaded modules\nexport interface ModuleMap<T = unknown> {\n  [key: string]: T;\n}\n\n// Cache for loaded modules to avoid repeated imports\n// Using LRU cache to prevent unbounded memory growth in long-running processes\nconst moduleCache = new LRUCache<string, ModuleMap>({\n  max: 100, // Max 100 directories cached\n  ttl: 1000 * 60 * 10, // 10 minutes\n});\n\nconst entityCache = new LRUCache<string, EntityClass>({\n  max: 500, // Max 500 entities cached (accessed more frequently than modules)\n  ttl: 1000 * 60 * 10, // 10 minutes\n});\n\nconst loadModulesInDirectory = async <T = unknown>({\n  directory,\n  extensions,\n}: {\n  directory: string;\n  extensions?: string[];\n}): Promise<ModuleMap<T>> => {\n  // Create cache key based on directory and extensions\n  const cacheKey = `${directory}:${extensions?.join(',') ?? 'all'}`;\n\n  // Check cache first\n  if (moduleCache.has(cacheKey)) {\n    const cachedModule = moduleCache.get(cacheKey);\n    if (cachedModule) {\n      return cachedModule as ModuleMap<T>;\n    }\n  }\n\n  const loadedModules: ModuleMap<T> = {};\n\n  // Use readdir with withFileTypes option to avoid separate stat calls\n  const dirents = await fs.promises.readdir(directory, { withFileTypes: true });\n\n  for (const dirent of dirents) {\n    // Skip directories without needing stat call\n    if (dirent.isDirectory()) {\n      continue;\n    }\n\n    const file = dirent.name;\n    const ext = path.extname(file);\n    const isDeclarationFile = file.endsWith('.d.ts');\n\n    // Skip files that are not in the specified extensions or are .d.ts files\n    if ((extensions && extensions.length > 0 && !extensions.includes(ext)) || isDeclarationFile) {\n      continue;\n    }\n\n    const moduleName = path.basename(file, ext);\n    const filePath = path.join(directory, file);\n    // Convert to absolute path for ESM import\n    const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);\n    // Use file:// URL for Windows compatibility\n    const fileUrl = `file://${absolutePath.replace(/\\\\/g, '/')}`;\n\n    try {\n      const importedModule = await import(fileUrl);\n\n      // Use safe property assignment to prevent prototype pollution\n      if (moduleName !== '__proto__' && moduleName !== 'constructor' && moduleName !== 'prototype') {\n        // Prefer default export, but fall back to the entire module if no default\n        const moduleExport = importedModule.default ?? importedModule;\n        Reflect.set(loadedModules, moduleName, moduleExport);\n      }\n    } catch (error) {\n      console.error(`Failed to import module ${filePath}:`, error);\n    }\n  }\n\n  // Cache the results for future use\n  moduleCache.set(cacheKey, loadedModules);\n\n  return loadedModules;\n};\n\n// Type constraint for entity classes (must be constructable)\nexport type EntityClass<T = unknown> = new (...args: unknown[]) => T;\n\nconst loadEntityModule = async <T = unknown>({\n  entitiesDirectory,\n  entityName,\n}: {\n  entitiesDirectory: string;\n  entityName: string;\n}): Promise<EntityClass<T>> => {\n  // Create cache key based on directory and entity name\n  const cacheKey = `${entitiesDirectory}:${entityName}`;\n\n  // Check cache first\n  if (entityCache.has(cacheKey)) {\n    return entityCache.get(cacheKey) as EntityClass<T>;\n  }\n\n  // Define entity module path\n  const entityModulePath = path.join(entitiesDirectory, `${entityName}.${Helper.getScriptFileExtension()}`);\n\n  // Import entity module\n  const entityModule = await import(entityModulePath);\n\n  // Safe property access to prevent prototype pollution\n  if (entityName === '__proto__' || entityName === 'constructor' || entityName === 'prototype') {\n    throw new Error(`Invalid entity name (Entity: ${entityName})`);\n  }\n\n  if (!entityModule || !Object.prototype.hasOwnProperty.call(entityModule, entityName)) {\n    throw new Error(`Entity not found (Entity: ${entityName})`);\n  }\n\n  // Get entity class\n  const EntityClass = Reflect.get(entityModule, entityName);\n\n  // Cache the entity for future use\n  entityCache.set(cacheKey, EntityClass);\n\n  return EntityClass;\n};\n\n// Cache management functions for development/testing\nconst clearModuleCache = (): void => {\n  moduleCache.clear();\n  entityCache.clear();\n};\n\nconst getCacheStats = (): { modulesCached: number; entitiesCached: number } => {\n  return {\n    modulesCached: moduleCache.size,\n    entitiesCached: entityCache.size,\n  };\n};\n\nexport default {\n  loadModulesInDirectory,\n  loadEntityModule,\n  clearModuleCache,\n  getCacheStats,\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/util/num.d.ts

@@ -0,0 +1,13 @@
+declare const _default: {
+    getRandomNumber: ({ min, max }: {
+        min: number;
+        max: number;
+    }) => number;
+    clamp: ({ value, min, max }: {
+        value: number;
+        min: number;
+        max: number;
+    }) => number;
+};
+export default _default;
+//# sourceMappingURL=num.d.ts.map

package/dist/util/num.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"num.d.ts","sourceRoot":"","sources":["../../src/util/num.ts"],"names":[],"mappings":";oCAAuC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAG,MAAM;iCAIxC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAG,MAAM;;AAIxF,wBAGE"}

package/dist/util/os.d.ts

@@ -0,0 +1,6 @@
+declare function getUniqueComputerId(): string;
+declare const _default: {
+    getUniqueComputerId: typeof getUniqueComputerId;
+};
+export default _default;
+//# sourceMappingURL=os.d.ts.map

package/dist/util/os.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os.d.ts","sourceRoot":"","sources":["../../src/util/os.ts"],"names":[],"mappings":"AAGA,iBAAS,mBAAmB,IAAI,MAAM,CAarC;;;;AAED,wBAEE"}

package/dist/util/str.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Generate a unique id.
+ */
+declare function generateUniqueId(): string;
+/**
+ * Slugify string.
+ */
+declare function slugify({ text }: {
+    text: string;
+}): string;
+/**
+ * Make text title case.
+ */
+declare function titleCase({ text }: {
+    text: string;
+}): string;
+/**
+ * Remove file extension from filename.
+ */
+declare function removeFileExtension({ filename }: {
+    filename: string;
+}): string;
+/**
+ * Get file extension from filename.
+ * @param filename
+ * @returns File extension
+ */
+declare function getFileExtension({ filename }: {
+    filename: string;
+}): string;
+declare const _default: {
+    generateUniqueId: typeof generateUniqueId;
+    slugify: typeof slugify;
+    titleCase: typeof titleCase;
+    removeFileExtension: typeof removeFileExtension;
+    getFileExtension: typeof getFileExtension;
+};
+export default _default;
+//# sourceMappingURL=str.d.ts.map

package/dist/util/str.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"str.d.ts","sourceRoot":"","sources":["../../src/util/str.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,iBAAS,gBAAgB,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,iBAAS,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQnD;AAED;;GAEG;AACH,iBAAS,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAMrD;AAED;;GAEG;AACH,iBAAS,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEvE;AAED;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpE;;;;;;;;AAED,wBAME"}

package/dist/util/time.d.ts

@@ -0,0 +1,19 @@
+import type { FormatRelativeTimeOptions, FormatTimeOptions } from './time.interface.js';
+import Timing from './timing.js';
+declare const _default: {
+    calculateElapsedTimeMs: ({ startTime }: {
+        startTime: number;
+    }) => number;
+    formatTime: ({ time, format, numDecimals, showUnit }: FormatTimeOptions) => string;
+    formatRelativeTime: ({ date, baseDate, includeSeconds, }: FormatRelativeTimeOptions) => string;
+    sleep: ({ seconds }: {
+        seconds: number;
+    }) => Promise<void>;
+    now: typeof Timing.now;
+    start: typeof Timing.start;
+    measure: typeof Timing.measure;
+    measureSync: typeof Timing.measureSync;
+    duration: typeof Timing.duration;
+};
+export default _default;
+//# sourceMappingURL=time.d.ts.map

package/dist/util/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/util/time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,MAAM,MAAM,aAAa,CAAC;;4CAMc;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAG,MAAM;0DAOI,iBAAiB,KAAG,MAAM;8DA4CxG,yBAAyB,KAAG,MAAM;yBAbT;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,IAAI,CAAC;;;;;;;AA6D/D,wBAWE"}

package/dist/util/time.interface.d.ts

@@ -0,0 +1,12 @@
+export interface FormatTimeOptions {
+    time: number;
+    format?: 'ms' | 's' | 'auto' | 'hh:mm:ss';
+    numDecimals?: number;
+    showUnit?: boolean;
+}
+export interface FormatRelativeTimeOptions {
+    date: Date;
+    baseDate?: Date;
+    includeSeconds?: boolean;
+}
+//# sourceMappingURL=time.interface.d.ts.map

package/dist/util/time.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.interface.d.ts","sourceRoot":"","sources":["../../src/util/time.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,IAAI,GAAG,GAAG,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/util/timing.d.ts

@@ -0,0 +1,36 @@
+import type { MeasureOptions, Timer, TimingResult } from './timing.interface.js';
+/**
+ * Modern high-resolution timing utility using performance.now()
+ *
+ * Provides simple APIs for measuring function execution time and manual timing.
+ * All durations are returned in milliseconds with decimal precision.
+ */
+declare class Timing {
+    /**
+     * Get current high-resolution timestamp in milliseconds.
+     * Uses performance.now() which provides sub-millisecond precision.
+     */
+    static now(): number;
+    /**
+     * Start a timer and return a Timer instance.
+     * Call timer.stop() to get elapsed time in milliseconds.
+     */
+    static start(): Timer;
+    /**
+     * Measure the execution time of a function (async or sync).
+     * Returns both the function result and timing information.
+     */
+    static measure<T>(fn: () => T | Promise<T>, options?: MeasureOptions): Promise<TimingResult<T>>;
+    /**
+     * Measure the execution time of a synchronous function.
+     * Returns both the function result and timing information.
+     */
+    static measureSync<T>(fn: () => T, options?: MeasureOptions): TimingResult<T>;
+    /**
+     * Calculate duration between two timestamps in milliseconds.
+     * Both timestamps should be from performance.now().
+     */
+    static duration(startTime: number, endTime: number): number;
+}
+export default Timing;
+//# sourceMappingURL=timing.d.ts.map

package/dist/util/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/util/timing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAqBjF;;;;;GAKG;AACH,cAAM,MAAM;IACV;;;OAGG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IAIpB;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,KAAK;IAIrB;;;OAGG;WACU,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAwBzG;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,YAAY,CAAC,CAAC,CAAC;IAwBjF;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAG5D;AAED,eAAe,MAAM,CAAC"}

package/dist/util/timing.interface.d.ts

@@ -0,0 +1,47 @@
+export interface Timer {
+    /**
+     * Stop the timer and return elapsed time in milliseconds with decimal precision.
+     */
+    stop(): number;
+    /**
+     * Get elapsed time since timer start without stopping the timer.
+     */
+    elapsed(): number;
+    /**
+     * The start timestamp in milliseconds (performance.now() format).
+     */
+    readonly startTime: number;
+}
+export interface TimingResult<T = unknown> {
+    /**
+     * Duration in milliseconds with decimal precision.
+     */
+    duration: number;
+    /**
+     * The result returned by the measured function.
+     */
+    result: T;
+    /**
+     * Start timestamp in milliseconds (performance.now() format).
+     */
+    startTime: number;
+    /**
+     * End timestamp in milliseconds (performance.now() format).
+     */
+    endTime: number;
+}
+export interface MeasureOptions {
+    /**
+     * Optional name for the measurement (useful for logging/debugging).
+     */
+    name?: string;
+    /**
+     * Whether to log the timing result automatically.
+     */
+    log?: boolean;
+    /**
+     * Custom logger function to use if log is true.
+     */
+    logger?: (message: string, duration: number) => void;
+}
+//# sourceMappingURL=timing.interface.d.ts.map

package/dist/util/timing.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.interface.d.ts","sourceRoot":"","sources":["../../src/util/timing.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,IAAI,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD"}

package/dist/util/url.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    buildQueryString: (params: {
+        [key: string]: string | number | boolean;
+    }) => string;
+};
+export default _default;
+//# sourceMappingURL=url.d.ts.map

package/dist/util/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/util/url.ts"],"names":[],"mappings":";+BAAkC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;KAAE,KAAG,MAAM;;AAOvF,wBAEE"}

package/dist/webserver/controller/auth-middleware.d.ts

@@ -0,0 +1,21 @@
+import type { FastifyReply, FastifyRequest } from 'fastify';
+import type { AuthenticatedUser } from './base.js';
+export type { AuthenticatedUser } from './base.js';
+export interface AuthenticatedRequest extends FastifyRequest {
+    user: AuthenticatedUser;
+}
+export type AuthenticatedRouteHandler = (request: AuthenticatedRequest, reply: FastifyReply) => Promise<void>;
+export type RouteHandler = (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+/**
+ * Higher-order function that wraps a route handler with authentication
+ * @param handler The route handler that requires authentication
+ * @param authenticateRequest The authentication method from the controller
+ * @returns A new route handler with authentication built-in
+ */
+export declare function withAuth(handler: AuthenticatedRouteHandler, authenticateRequest: (request: FastifyRequest, reply: FastifyReply) => Promise<AuthenticatedUser | null>): RouteHandler;
+/**
+ * Method decorator for class-based controllers
+ * Usage: @requiresAuth()
+ */
+export declare function requiresAuth(): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=auth-middleware.d.ts.map

package/dist/webserver/controller/auth-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-middleware.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/auth-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9G,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3F;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,yBAAyB,EAClC,mBAAmB,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,GACvG,YAAY,CAed;AAED;;;GAGG;AACH,wBAAgB,YAAY,KACT,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAoBlF"}