xypriss 9.5.51 → 9.5.53

package/README.md

@@ -56,7 +56,7 @@ This separation allows each layer to operate in its optimal domain: compiled nat
 - **Advanced Radix Routing** — Ultra-fast routing system capable of complex path matching with microsecond latency.
 - **Real-Time System Intelligence** — Native access to CPU, memory, disk, network, battery, and process metrics directly from the application layer.
 - **Filesystem Engine & Binary Streaming** — High-performance filesystem operations, duplicate detection, and robust **Zero-Copy Ranged Streaming** via `res.sendFile()`, optimized for media delivery and large assets.
-- **File Upload Management** — Production-ready multipart/form-data handling with automatic validation and error handling.
+- **File Upload Management** — Production-ready multipart/form-data handling with automatic validation, error handling, and the `getMimes()` helper for extension-to-mime mapping.
 - **Environment Security Shield** — Military-grade protection for sensitive variables. Direct `process.env` access is masked via a native Proxy to prevent accidental leakage, forcing the use of secure, typed APIs.
 - **Built-in DotEnv Loader** — Zero-dependency, ultra-fast `.env` parser with automatic support for `.env`, `.env.local`, and `.private/.env`.
 - **Extensible Plugin System** — Permission-based plugin architecture with lifecycle hooks and security controls.

package/dist/cjs/src/index.js

@@ -18,6 +18,7 @@ var PluginHookIds = require('./plugins/const/PluginHookIds.js');
 var mergeWithDefaults = require('./utils/mergeWithDefaults.js');
 var getIp = require('./utils/getIp.js');
 var XemsPlugin = require('./plugins/modules/xems/XemsPlugin.js');
+var getMime = require('./utils/getMime.js');
 var xyprissSecurity = require('xypriss-security');
 var safeJsonMiddleware = require('./middleware/safe-json-middleware.js');
 var FiUp = require('./FiUp.js');
@@ -83,6 +84,8 @@ exports.mergeWithDefaults = mergeWithDefaults.mergeWithDefaults;
 exports.mwdef = mergeWithDefaults.mergeWithDefaults;
 exports.getIp = getIp.getIp;
 exports.xems = XemsPlugin.xems;
+exports.getMime = getMime.getMime;
+exports.getMimes = getMime.getMimes;
 Object.defineProperty(exports, "XyPriStringify", {
     enumerable: true,
     get: function () { return xyprissSecurity.XyPriStringify; }

package/dist/cjs/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":[null],"names":["configLoader","XyPrissRouter"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;AAsBiF;AAqBjF;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;IACnCA,yBAAY,CAAC,qBAAqB,EAAE;AACxC;AAqGA;;AAEG;SACa,MAAM,GAAA;IAClB,OAAO,IAAIC,sBAAa,CAAC;AACrB,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,WAAW,EAAE,KAAK;AAClB,QAAA,MAAM,EAAE,KAAK;AAChB,KAAA,CAAC;AACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":[null],"names":["configLoader","XyPrissRouter"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;AAsBiF;AAqBjF;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;IACnCA,yBAAY,CAAC,qBAAqB,EAAE;AACxC;AAqGA;;AAEG;SACa,MAAM,GAAA;IAClB,OAAO,IAAIC,sBAAa,CAAC;AACrB,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,WAAW,EAAE,KAAK;AAClB,QAAA,MAAM,EAAE,KAAK;AAChB,KAAA,CAAC;AACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/src/utils/getMime.js

@@ -0,0 +1,96 @@
+'use strict';
+
+var MIME_MAP = require('../server/const/MIME_MAP.js');
+var config = require('../config.js');
+
+/***************************************************************************
+ * XyPriss - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ****************************************************************************/
+/**
+ * Resolves a single MIME type from a file extension.
+ *
+ * @param ext - The file extension (e.g., '.png' or 'jpg').
+ * @returns The corresponding MIME type or 'application/octet-stream' if unknown.
+ */
+const getMime = (ext) => {
+    if (!ext)
+        return "application/octet-stream";
+    const normalized = ext.startsWith(".")
+        ? ext.toLowerCase()
+        : `.${ext.toLowerCase()}`;
+    return MIME_MAP.MIME_MAP[normalized] || "application/octet-stream";
+};
+/**
+ * Advanced utility to resolve multiple MIME types from file extensions.
+ *
+ * This helper is designed to simplify server configurations, particularly for
+ * 'fileUpload' and security policies, by allowing developers to specify
+ * human-readable extensions instead of complex MIME strings.
+ *
+ * FEATURES:
+ * - Supports single extensions or arrays.
+ * - Automatically normalizes extensions (handles missing dots).
+ * - Deduplicates results to ensure a clean MIME array.
+ * - Can fall back to global 'fileUpload.allowedExtensions' if no argument is provided.
+ *
+ * @param extensions - A single extension (e.g., '.png') or an array (e.g., ['.jpg', '.pdf']).
+ *                     If omitted, the function attempts to read from global configuration.
+ * @returns A unique array of resolved MIME types.
+ *
+ * @example
+ * // 1. Map an array of extensions for file upload configuration
+ * const uploadConfig = {
+ *   allowedMimeTypes: getMimes(['.png', '.jpg', '.jpeg', '.webp'])
+ * };
+ * // Result: ['image/png', 'image/jpeg', 'image/webp']
+ *
+ * @example
+ * // 2. Map a single extension
+ * const mimes = getMimes('.pdf');
+ * // Result: ['application/pdf']
+ *
+ * @example
+ * // 3. Automatic detection from xypriss.config.json
+ * // If config has: { "fileUpload": { "allowedExtensions": [".zip", ".rar"] } }
+ * const mimes = getMimes();
+ * // Result: ['application/zip', 'application/vnd.rar']
+ */
+const getMimes = (extensions) => {
+    let targetExts = [];
+    if (extensions) {
+        targetExts = Array.isArray(extensions) ? extensions : [extensions];
+    }
+    else {
+        // Fallback to global framework configuration if available
+        try {
+            const uMimeConfig = config.__cfg__.get("fileUpload")?.allowedExtensions;
+            if (Array.isArray(uMimeConfig)) {
+                targetExts = uMimeConfig;
+            }
+        }
+        catch (e) {
+            // Config might not be initialized yet in early-loading contexts
+            return [];
+        }
+    }
+    if (targetExts.length === 0)
+        return [];
+    const mimeSet = new Set();
+    for (const ext of targetExts) {
+        if (!ext)
+            continue;
+        const mime = getMime(ext);
+        if (mime)
+            mimeSet.add(mime);
+    }
+    return Array.from(mimeSet);
+};
+
+exports.getMime = getMime;
+exports.getMimes = getMimes;
+//# sourceMappingURL=getMime.js.map

package/dist/cjs/src/utils/getMime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMime.js","sources":["../../../../src/utils/getMime.ts"],"sourcesContent":[null],"names":["MIME_MAP","__cfg__"],"mappings":";;;;;AAAA;;;;;;;AAO8E;AAK9E;;;;;AAKG;AACI,MAAM,OAAO,GAAG,CAAC,GAAW,KAAY;AAC3C,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,0BAA0B;AAC3C,IAAA,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG;AACjC,UAAE,GAAG,CAAC,WAAW;AACjB,UAAE,CAAA,CAAA,EAAI,GAAG,CAAC,WAAW,EAAE,EAAE;AAC7B,IAAA,OAAOA,iBAAQ,CAAC,UAAU,CAAC,IAAI,0BAA0B;AAC7D;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCG;AACI,MAAM,QAAQ,GAAG,CAAC,UAA8B,KAAc;IACjE,IAAI,UAAU,GAAa,EAAE;IAE7B,IAAI,UAAU,EAAE;AACZ,QAAA,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,CAAC,UAAU,CAAC;IACtE;SAAO;;AAEH,QAAA,IAAI;YACA,MAAM,WAAW,GAAGC,cAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,iBAAiB;AAChE,YAAA,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE;gBAC5B,UAAU,GAAG,WAAW;YAC5B;QACJ;QAAE,OAAO,CAAC,EAAE;;AAER,YAAA,OAAO,EAAE;QACb;IACJ;AAEA,IAAA,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;AAEtC,IAAA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU;AACjC,IAAA,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE;AAC1B,QAAA,IAAI,CAAC,GAAG;YAAE;AACV,QAAA,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;AACzB,QAAA,IAAI,IAAI;AAAE,YAAA,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAC/B;AAEA,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;AAC9B;;;;;"}

package/dist/esm/src/index.js

@@ -16,6 +16,7 @@ export { PluginHookIds } from './plugins/const/PluginHookIds.js';
 export { mergeWithDefaults, mergeWithDefaults as mwdef } from './utils/mergeWithDefaults.js';
 export { getIp } from './utils/getIp.js';
 export { xems } from './plugins/modules/xems/XemsPlugin.js';
+export { getMime, getMimes } from './utils/getMime.js';
 export { XyPriStringify, fastStringify, safeStringify } from 'xypriss-security';
 export { createCircularRefDebugger, createSafeJsonMiddleware, safeJsonStringify, sendSafeJson, setupSafeJson } from './middleware/safe-json-middleware.js';
 export { initializeFileUpload, uploadAny, uploadArray, uploadFields, uploadSingle } from './FiUp.js';

package/dist/esm/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;AAsBiF;AAqBjF;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;IACnC,YAAY,CAAC,qBAAqB,EAAE;AACxC;AAqGA;;AAEG;SACa,MAAM,GAAA;IAClB,OAAO,IAAI,aAAa,CAAC;AACrB,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,WAAW,EAAE,KAAK;AAClB,QAAA,MAAM,EAAE,KAAK;AAChB,KAAA,CAAC;AACN;;;;"}
+{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;AAsBiF;AAqBjF;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;IACnC,YAAY,CAAC,qBAAqB,EAAE;AACxC;AAqGA;;AAEG;SACa,MAAM,GAAA;IAClB,OAAO,IAAI,aAAa,CAAC;AACrB,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,WAAW,EAAE,KAAK;AAClB,QAAA,MAAM,EAAE,KAAK;AAChB,KAAA,CAAC;AACN;;;;"}

package/dist/esm/src/utils/getMime.js

@@ -0,0 +1,93 @@
+import { MIME_MAP } from '../server/const/MIME_MAP.js';
+import { __cfg__ } from '../config.js';
+
+/***************************************************************************
+ * XyPriss - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ****************************************************************************/
+/**
+ * Resolves a single MIME type from a file extension.
+ *
+ * @param ext - The file extension (e.g., '.png' or 'jpg').
+ * @returns The corresponding MIME type or 'application/octet-stream' if unknown.
+ */
+const getMime = (ext) => {
+    if (!ext)
+        return "application/octet-stream";
+    const normalized = ext.startsWith(".")
+        ? ext.toLowerCase()
+        : `.${ext.toLowerCase()}`;
+    return MIME_MAP[normalized] || "application/octet-stream";
+};
+/**
+ * Advanced utility to resolve multiple MIME types from file extensions.
+ *
+ * This helper is designed to simplify server configurations, particularly for
+ * 'fileUpload' and security policies, by allowing developers to specify
+ * human-readable extensions instead of complex MIME strings.
+ *
+ * FEATURES:
+ * - Supports single extensions or arrays.
+ * - Automatically normalizes extensions (handles missing dots).
+ * - Deduplicates results to ensure a clean MIME array.
+ * - Can fall back to global 'fileUpload.allowedExtensions' if no argument is provided.
+ *
+ * @param extensions - A single extension (e.g., '.png') or an array (e.g., ['.jpg', '.pdf']).
+ *                     If omitted, the function attempts to read from global configuration.
+ * @returns A unique array of resolved MIME types.
+ *
+ * @example
+ * // 1. Map an array of extensions for file upload configuration
+ * const uploadConfig = {
+ *   allowedMimeTypes: getMimes(['.png', '.jpg', '.jpeg', '.webp'])
+ * };
+ * // Result: ['image/png', 'image/jpeg', 'image/webp']
+ *
+ * @example
+ * // 2. Map a single extension
+ * const mimes = getMimes('.pdf');
+ * // Result: ['application/pdf']
+ *
+ * @example
+ * // 3. Automatic detection from xypriss.config.json
+ * // If config has: { "fileUpload": { "allowedExtensions": [".zip", ".rar"] } }
+ * const mimes = getMimes();
+ * // Result: ['application/zip', 'application/vnd.rar']
+ */
+const getMimes = (extensions) => {
+    let targetExts = [];
+    if (extensions) {
+        targetExts = Array.isArray(extensions) ? extensions : [extensions];
+    }
+    else {
+        // Fallback to global framework configuration if available
+        try {
+            const uMimeConfig = __cfg__.get("fileUpload")?.allowedExtensions;
+            if (Array.isArray(uMimeConfig)) {
+                targetExts = uMimeConfig;
+            }
+        }
+        catch (e) {
+            // Config might not be initialized yet in early-loading contexts
+            return [];
+        }
+    }
+    if (targetExts.length === 0)
+        return [];
+    const mimeSet = new Set();
+    for (const ext of targetExts) {
+        if (!ext)
+            continue;
+        const mime = getMime(ext);
+        if (mime)
+            mimeSet.add(mime);
+    }
+    return Array.from(mimeSet);
+};
+
+export { getMime, getMimes };
+//# sourceMappingURL=getMime.js.map

package/dist/esm/src/utils/getMime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMime.js","sources":["../../../../src/utils/getMime.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;;;AAO8E;AAK9E;;;;;AAKG;AACI,MAAM,OAAO,GAAG,CAAC,GAAW,KAAY;AAC3C,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,0BAA0B;AAC3C,IAAA,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG;AACjC,UAAE,GAAG,CAAC,WAAW;AACjB,UAAE,CAAA,CAAA,EAAI,GAAG,CAAC,WAAW,EAAE,EAAE;AAC7B,IAAA,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,0BAA0B;AAC7D;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCG;AACI,MAAM,QAAQ,GAAG,CAAC,UAA8B,KAAc;IACjE,IAAI,UAAU,GAAa,EAAE;IAE7B,IAAI,UAAU,EAAE;AACZ,QAAA,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,CAAC,UAAU,CAAC;IACtE;SAAO;;AAEH,QAAA,IAAI;YACA,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,iBAAiB;AAChE,YAAA,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE;gBAC5B,UAAU,GAAG,WAAW;YAC5B;QACJ;QAAE,OAAO,CAAC,EAAE;;AAER,YAAA,OAAO,EAAE;QACb;IACJ;AAEA,IAAA,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;AAEtC,IAAA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU;AACjC,IAAA,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE;AAC1B,QAAA,IAAI,CAAC,GAAG;YAAE;AACV,QAAA,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;AACzB,QAAA,IAAI,IAAI;AAAE,YAAA,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAC/B;AAEA,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;AAC9B;;;;"}

package/dist/index.d.ts

@@ -9088,6 +9088,58 @@ type IpSource = "cf-connecting-ip" | "true-client-ip" | "x-real-ip" | "x-forward
 declare function getIp(req: XyPrisRequest): string;
 declare function getIp(req: XyPrisRequest, enriched: true): GetIpResult;
 
+/***************************************************************************
+ * XyPriss - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ****************************************************************************/
+/**
+ * Resolves a single MIME type from a file extension.
+ *
+ * @param ext - The file extension (e.g., '.png' or 'jpg').
+ * @returns The corresponding MIME type or 'application/octet-stream' if unknown.
+ */
+declare const getMime: (ext: string) => string;
+/**
+ * Advanced utility to resolve multiple MIME types from file extensions.
+ *
+ * This helper is designed to simplify server configurations, particularly for
+ * 'fileUpload' and security policies, by allowing developers to specify
+ * human-readable extensions instead of complex MIME strings.
+ *
+ * FEATURES:
+ * - Supports single extensions or arrays.
+ * - Automatically normalizes extensions (handles missing dots).
+ * - Deduplicates results to ensure a clean MIME array.
+ * - Can fall back to global 'fileUpload.allowedExtensions' if no argument is provided.
+ *
+ * @param extensions - A single extension (e.g., '.png') or an array (e.g., ['.jpg', '.pdf']).
+ *                     If omitted, the function attempts to read from global configuration.
+ * @returns A unique array of resolved MIME types.
+ *
+ * @example
+ * // 1. Map an array of extensions for file upload configuration
+ * const uploadConfig = {
+ *   allowedMimeTypes: getMimes(['.png', '.jpg', '.jpeg', '.webp'])
+ * };
+ * // Result: ['image/png', 'image/jpeg', 'image/webp']
+ *
+ * @example
+ * // 2. Map a single extension
+ * const mimes = getMimes('.pdf');
+ * // Result: ['application/pdf']
+ *
+ * @example
+ * // 3. Automatic detection from xypriss.config.json
+ * // If config has: { "fileUpload": { "allowedExtensions": [".zip", ".rar"] } }
+ * const mimes = getMimes();
+ * // Result: ['application/zip', 'application/vnd.rar']
+ */
+declare const getMimes: (extensions?: string | string[]) => string[];
+
 /***************************************************************************
  * XyPrissJS - Fast And Secure
  *
@@ -9169,5 +9221,5 @@ declare global {
  */
 declare function Router(): XyPrissRouter;
 
-export { ConfigurationManager as CM, ConfigurationManager as Configs, FileUploadAPI as FLA, FileUploadAPI, PerformanceMonitor, Plugin, PluginHookIds, Router, SecurityMiddleware, TrustProxy, Upload, XJsonResponseHandler, MultiServerApp as XyPMS, XyPrissRouter, XyPrissSys, __cfg__, __const__, __sys__, createCircularRefDebugger, createOptimalCache, createSafeJsonMiddleware, createServer, getIp, initializeFileUpload, mergeWithDefaults, mergeWithDefaults as mwdef, quickServer, safeJsonStringify, sendSafeJson, setupSafeJson, uploadAny, uploadArray, uploadFields, uploadSingle, xems };
+export { ConfigurationManager as CM, ConfigurationManager as Configs, FileUploadAPI as FLA, FileUploadAPI, PerformanceMonitor, Plugin, PluginHookIds, Router, SecurityMiddleware, TrustProxy, Upload, XJsonResponseHandler, MultiServerApp as XyPMS, XyPrissRouter, XyPrissSys, __cfg__, __const__, __sys__, createCircularRefDebugger, createOptimalCache, createSafeJsonMiddleware, createServer, getIp, getMime, getMimes, initializeFileUpload, mergeWithDefaults, mergeWithDefaults as mwdef, quickServer, safeJsonStringify, sendSafeJson, setupSafeJson, uploadAny, uploadArray, uploadFields, uploadSingle, xems };
 export type { ArchiveOptions, BatchRenameChange, CacheConfig, FileUploadConfig as FiUpConfig, FileUploadConfig, GetIpResult, IpSource, MonitorSnapshot, MultiServerConfig, NetworkStats, NextFunction, PerformanceConfig, PluginCreator, ProcessInfo, ProcessMonitorSnapshot, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RouteConfig, RouteOptions, SecurityConfig, ServerOptions$1 as ServerOptions, TrustProxyValue$1 as TrustProxyValue, UltraFastApp, XemsTypes, XyPrisRequest, XyPrisResponse, XyPrissPlugin, XyPrisRequest as XyPrissRequest, XyPrisResponse as XyPrissResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xypriss",
-    "version": "9.5.51",
+    "version": "9.5.53",
     "description": "XyPriss is a lightweight, TypeScript-first, open-source Node.js web framework crafted for developers seeking a familiar Express-like API without Express dependencies.",
     "author": {
         "name": "Nehonix",
@@ -16,7 +16,7 @@
             "require": "./dist/cjs/src/index.js",
             "types": "./dist/index.d.ts"
         }
-    },
+    }, 
     "files": [
         "dist/",
         "shared/",