xypriss 9.10.19 → 9.10.21

package/dist/src/utils/ProjectDiscovery.d.ts

@@ -1,61 +0,0 @@
-/**
- * Checks if a directory is a "Real Project" root based on hierarchical criteria.
- * Criteria:
- * 1. (package.json + node_modules) -> Strong baseline
- * 2. (package.json + src + tsconfig.json) -> High priority
- */
-export declare function isProjectRoot(dir: string): boolean;
-/**
- * Identifies the project root for a given caller path by traversing up the filesystem.
- */
-export declare function identifyProjectRoot(filePath: string): string | undefined;
-export declare function setRootInterceptor(interceptor: (callerRoot: string) => string | undefined): void;
-/**
- * Retrieves the project root of the code currently executing by analyzing the stack trace.
- */
-export declare function getCallerProjectRoot(): string | undefined;
-/**
- * Checks if a given file path belongs to the deep engine core.
- * These files are skipped during stack analysis to find the user/plugin caller.
- */
-export declare function isEngineCorePath(filePath: string): boolean;
-/**
- * Checks if a given file path belongs directly to the XyPriss Core Engine
- * or if it comes from an external plugin / user space.
- * This is used for SECURITY authorization.
- */
-export declare function isCoreFrameworkPath(filePath: string): boolean;
-/**
- * Validates a call stack to determine whether the execution trace originated
- * safely from within the core framework, dropping unauthorized usage.
- */
-export declare function isCoreStack(stack: string): boolean;
-/**
- * Checks if a given file path belongs to a trusted dependency (root node_modules).
- * Trusted dependencies are those installed in the main project's node_modules
- * but NOT inside a plugin directory.
- */
-export declare function isTrustedDependencyPath(filePath: string): boolean;
-/**
- * Checks if a given file path belongs to a plugin (resides in /mods/).
- */
-export declare function isPluginPath(filePath: string): boolean;
-/**
- * Checks if a given file path belongs to a test directory (e.g., /.private/).
- */
-export declare function isTestPath(filePath: string): boolean;
-/**
- * Loads and cleans a XyPriss configuration file (JSON or JSONC).
- * Removes comments and trailing commas to ensure compatibility with standard JSON.parse.
- */
-export declare function loadXyConfig(projectRoot: string): any | null;
-/**
- * Verifies if a given directory contains a valid XyPriss plugin contract.
- * Required: xypriss.config.json(c) with the plugin's namespace under '$internal'
- */
-export declare function verifyPluginContract(pluginRoot: string, pluginName: string): boolean;
-/**
- * Retrieves the plugin configuration if it exists and is valid.
- */
-export declare function getPluginConfig(pluginRoot: string): any | null;
-//# sourceMappingURL=ProjectDiscovery.d.ts.map

package/dist/src/utils/ProjectDiscovery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ProjectDiscovery.d.ts","sourceRoot":"","sources":["../../../src/utils/ProjectDiscovery.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA6BlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuBxE;AAGD,wBAAgB,kBAAkB,CAC9B,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,QAG1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAuDzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiB1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAe7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAkElD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAoC5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACnB,OAAO,CAUT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAE9D"}

package/dist/src/utils/ProjectDiscovery.js

@@ -1,295 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { ConfigSyntaxParser } from "./ConfigSyntaxParser";
-/**
- * Checks if a directory is a "Real Project" root based on hierarchical criteria.
- * Criteria:
- * 1. (package.json + node_modules) -> Strong baseline
- * 2. (package.json + src + tsconfig.json) -> High priority
- */
-export function isProjectRoot(dir) {
-    const pkgPath = path.join(dir, "package.json");
-    if (!fs.existsSync(pkgPath))
-        return false;
-    // Strong Heuristics (Zero FS Read)
-    const hasNodeModules = fs.existsSync(path.join(dir, "node_modules"));
-    const hasTsConfig = fs.existsSync(path.join(dir, "tsconfig.json"));
-    const hasSrc = fs.existsSync(path.join(dir, "src"));
-    const hasXyConfig = fs.existsSync(path.join(dir, "xypriss.config.json")) ||
-        fs.existsSync(path.join(dir, "xypriss.config.jsonc"));
-    if (hasNodeModules || hasXyConfig || (hasSrc && hasTsConfig))
-        return true;
-    // Package Metadata Heuristic: A 'Real' package root is a unit that
-    // has an identity (name + version). This correctly identifies
-    // installed plugins even if they've been flattened or lack source configs.
-    try {
-        const pkgStr = fs.readFileSync(pkgPath, "utf-8");
-        // Fast pre-check before parsing JSON
-        if (pkgStr.includes('"name"') && pkgStr.includes('"version"')) {
-            const pkg = JSON.parse(pkgStr);
-            if (pkg.name && pkg.version)
-                return true;
-        }
-    }
-    catch {
-        // Any error in reading/parsing means it's not a valid project root
-    }
-    return false;
-}
-/**
- * Identifies the project root for a given caller path by traversing up the filesystem.
- */
-export function identifyProjectRoot(filePath) {
-    // Ensure the path is absolute and exists before traversing
-    if (!path.isAbsolute(filePath)) {
-        try {
-            filePath = path.resolve(filePath);
-        }
-        catch {
-            return undefined;
-        }
-    }
-    if (!fs.existsSync(filePath))
-        return undefined;
-    let current = path.dirname(filePath);
-    const systemRootDir = path.parse(current).root;
-    while (current !== systemRootDir) {
-        if (isProjectRoot(current)) {
-            return current;
-        }
-        current = path.dirname(current);
-    }
-    return undefined;
-}
-let rootInterceptor = null;
-export function setRootInterceptor(interceptor) {
-    rootInterceptor = interceptor;
-}
-/**
- * Retrieves the project root of the code currently executing by analyzing the stack trace.
- */
-export function getCallerProjectRoot() {
-    const stack = new Error().stack;
-    if (!stack)
-        return undefined;
-    const lines = stack.split("\n");
-    let callerFilePath = "";
-    let lastEngineFilePath = "";
-    // Line 0 is 'Error', Line 1 is the call to getCallerProjectRoot itself
-    for (let i = 2; i < lines.length; i++) {
-        const line = lines[i];
-        if (!line || line.includes(" (node:") || line.includes(" (native"))
-            continue;
-        // Robust matching for file paths (handles both absolute and relative,
-        // but filters out non-file frames like '(native)' or 'replace (unknown)')
-        const match = line.match(/\((.*\.([jt]s|[cm]js)):\d+:\d+\)$/) ||
-            line.match(/at (.*\.([jt]s|[cm]js)):\d+:\d+$/);
-        if (!match)
-            continue;
-        const filePath = match[1];
-        if (!filePath || filePath === "native" || filePath === "node:fs")
-            continue;
-        // SKIP only purely internal engine files to find the real project caller.
-        // Even internal mods (/mods/) should be considered callers if they have their own root,
-        // so we don't skip them during stack analysis, but we still trust them for security.
-        if (isEngineCorePath(filePath)) {
-            lastEngineFilePath = filePath;
-            continue;
-        }
-        // Skip specifically the property getters if they appear differently
-        if (line.includes("at get [") ||
-            line.includes("at getStrict (") ||
-            line.includes("PluginAPI.") ||
-            line.includes("Plugin."))
-            continue;
-        callerFilePath = filePath;
-        break;
-    }
-    if (!callerFilePath)
-        return undefined;
-    const root = identifyProjectRoot(callerFilePath);
-    if (root && rootInterceptor) {
-        return rootInterceptor(root) || root;
-    }
-    return root;
-}
-/**
- * Checks if a given file path belongs to the deep engine core.
- * These files are skipped during stack analysis to find the user/plugin caller.
- */
-export function isEngineCorePath(filePath) {
-    if (!filePath)
-        return false;
-    const normalizedPath = filePath.replace(/\\/g, "/");
-    // Engine Core (Standard Framework Logic)
-    if (normalizedPath.includes("/XyPriss/src/") ||
-        normalizedPath.includes("/XyPriss/dist/") ||
-        normalizedPath.includes("/node_modules/xypriss/")) {
-        // EXCEPTION: Files inside /XyPriss/src/ and /XyPriss/dist/ are core,
-        // UNLESS the caller is another specific project (like simulations).
-        // But for isolation, we want to skip them.
-        return true;
-    }
-    return false;
-}
-/**
- * Checks if a given file path belongs directly to the XyPriss Core Engine
- * or if it comes from an external plugin / user space.
- * This is used for SECURITY authorization.
- */
-export function isCoreFrameworkPath(filePath) {
-    if (!filePath)
-        return false;
-    // Normalize path just in case
-    const normalizedPath = filePath.replace(/\\/g, "/");
-    // console.log("[ProjectDiscovery:isCoreFrameworkPath]: normalizedPath: ", normalizedPath);
-    // Authorize trusted internal mods within the framework repository
-    if (normalizedPath.includes("/XyPriss/mods/"))
-        return true;
-    // Exclude other plugins even if they contain 'src' or are named 'xypriss-something'
-    if (normalizedPath.includes("/mods/"))
-        return false;
-    // Engine Core is always trusted
-    return isEngineCorePath(filePath);
-}
-/**
- * Validates a call stack to determine whether the execution trace originated
- * safely from within the core framework, dropping unauthorized usage.
- */
-export function isCoreStack(stack) {
-    if (!stack)
-        return false;
-    // Parse the stack specifically to find the originating (calling) module
-    const lines = stack.split("\n");
-    // Line 0 is Error message. Line 1 is the interception site. Line 2+ traces back.
-    for (let i = 1; i < lines.length; i++) {
-        const line = lines[i];
-        // Skip internal Node/Bun native APIs in the trace
-        if (line.includes(" (node:") ||
-            line.includes(" (bun:") ||
-            line.includes(" (internal:") ||
-            line.includes(" (native") ||
-            line.trim() === "at native")
-            continue;
-        // We look for the first real file in the trace that isn't native or our blocker script
-        // We use . (dot) to match both .ts and .js versions of the blocker
-        if (line.includes("NativeApiBlocker."))
-            continue;
-        if (line.includes("module.js") ||
-            line.includes("internal/modules/") ||
-            line.includes("node:internal"))
-            continue;
-        // If the first actionable file trace we find is outside the core, immediate rejection
-        // Skip common framework files to find the real caller
-        if (line.includes("ProjectDiscovery.") ||
-            line.includes("XyServerCreator.") ||
-            line.includes("PluginLoader.") ||
-            line.includes("PluginSecurity.") ||
-            line.includes("PluginHookRunner.") ||
-            line.includes("XPluginManager.") ||
-            line.includes("XyLifecycleManager.") ||
-            line.includes("ConfigLoader.") ||
-            line.includes("StartupProcessor.") ||
-            line.includes("System.") ||
-            line.includes("EnvApi.") ||
-            line.includes("ServerFactory.") ||
-            line.includes("sys.")) {
-            continue;
-        }
-        const match = line.match(/\((.*):\d+:\d+\)$/) ||
-            line.match(/at (.*):\d+:\d+$/) ||
-            line.match(/at (.*)$/);
-        if (match) {
-            const filePath = match[1];
-            if (filePath === "native" ||
-                filePath === "node:fs" ||
-                filePath === "fs")
-                continue;
-            const result = isCoreFrameworkPath(filePath);
-            return result;
-        }
-    }
-    return false;
-}
-/**
- * Checks if a given file path belongs to a trusted dependency (root node_modules).
- * Trusted dependencies are those installed in the main project's node_modules
- * but NOT inside a plugin directory.
- */
-export function isTrustedDependencyPath(filePath) {
-    const normalizedPath = filePath.replace(/\\/g, "/");
-    // Authorize node_modules only if NOT inside a /mods/ directory
-    return (normalizedPath.includes("/node_modules/") &&
-        !normalizedPath.includes("/mods/"));
-}
-/**
- * Checks if a given file path belongs to a plugin (resides in /mods/).
- */
-export function isPluginPath(filePath) {
-    const normalizedPath = filePath.replace(/\\/g, "/");
-    return normalizedPath.includes("/mods/");
-}
-/**
- * Checks if a given file path belongs to a test directory (e.g., /.private/).
- */
-export function isTestPath(filePath) {
-    const normalizedPath = filePath.replace(/\\/g, "/");
-    return normalizedPath.includes("/.private/");
-}
-/**
- * Loads and cleans a XyPriss configuration file (JSON or JSONC).
- * Removes comments and trailing commas to ensure compatibility with standard JSON.parse.
- */
-export function loadXyConfig(projectRoot) {
-    for (const name of ["xypriss.config.jsonc", "xypriss.config.json"]) {
-        const configPath = path.join(projectRoot, name);
-        if (fs.existsSync(configPath)) {
-            try {
-                const raw = fs.readFileSync(configPath, "utf-8");
-                const clean = raw
-                    .replace(/("(?:[^"\\]|\\.)*")|\/\/.*|\/\*[\s\S]*?\*\//g, (m, g) => (g ? g : ""))
-                    .replace(/("(?:[^"\\]|\\.)*")|,\s*([}\]])/g, (m, g1, g2) => g1 ? g1 : g2);
-                const rawJson = JSON.parse(clean);
-                // Load package.json from the same directory for resolution
-                let pkgJson = null;
-                const pkgPath = path.join(projectRoot, "package.json");
-                if (fs.existsSync(pkgPath)) {
-                    try {
-                        pkgJson = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-                    }
-                    catch { /* ignore */ }
-                }
-                // Resolve references $(pkg), $(env), etc.
-                const sys = globalThis.__sys__;
-                const parser = new ConfigSyntaxParser(pkgJson, sys?.__env__);
-                return parser.resolve(rawJson);
-            }
-            catch (e) {
-                return null;
-            }
-        }
-    }
-    return null;
-}
-/**
- * Verifies if a given directory contains a valid XyPriss plugin contract.
- * Required: xypriss.config.json(c) with the plugin's namespace under '$internal'
- */
-export function verifyPluginContract(pluginRoot, pluginName) {
-    const config = loadXyConfig(pluginRoot);
-    if (!config)
-        return false;
-    const internal = config.$internal || config.internal;
-    if (!internal)
-        return false;
-    const pluginContract = internal[pluginName];
-    // The plugin must declare itself in the $internal block WITH 'type': 'plugin'
-    return !!(pluginContract && pluginContract.type === "plugin");
-}
-/**
- * Retrieves the plugin configuration if it exists and is valid.
- */
-export function getPluginConfig(pluginRoot) {
-    return loadXyConfig(pluginRoot);
-}
-//# sourceMappingURL=ProjectDiscovery.js.map

package/dist/src/utils/ProjectDiscovery.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ProjectDiscovery.js","sourceRoot":"","sources":["../../../src/utils/ProjectDiscovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,mCAAmC;IACnC,MAAM,cAAc,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACpD,MAAM,WAAW,GACb,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QACpD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAE1D,IAAI,cAAc,IAAI,WAAW,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1E,mEAAmE;IACnE,8DAA8D;IAC9D,2EAA2E;IAC3E,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,qCAAqC;QACrC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;QAC7C,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,mEAAmE;IACvE,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAChD,2DAA2D;IAC3D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAE/C,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAE/C,OAAO,OAAO,KAAK,aAAa,EAAE,CAAC;QAC/B,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC;QACnB,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,IAAI,eAAe,GAAwD,IAAI,CAAC;AAChF,MAAM,UAAU,kBAAkB,CAC9B,WAAuD;IAEvD,eAAe,GAAG,WAAW,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAChC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,kBAAkB,GAAG,EAAE,CAAC;IAE5B,uEAAuE;IACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC9D,SAAS;QAEb,sEAAsE;QACtE,0EAA0E;QAC1E,MAAM,KAAK,GACP,IAAI,CAAC,KAAK,CAAC,mCAAmC,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAEnD,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS;YAC5D,SAAS;QAEb,0EAA0E;QAC1E,wFAAwF;QACxF,qFAAqF;QACrF,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,kBAAkB,GAAG,QAAQ,CAAC;YAC9B,SAAS;QACb,CAAC;QAED,oEAAoE;QACpE,IACI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAExB,SAAS;QAEb,cAAc,GAAG,QAAQ,CAAC;QAC1B,MAAM;IACV,CAAC;IAED,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEtC,MAAM,IAAI,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAEjD,IAAI,IAAI,IAAI,eAAe,EAAE,CAAC;QAC1B,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEpD,yCAAyC;IACzC,IACI,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC;QACxC,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACzC,cAAc,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EACnD,CAAC;QACC,qEAAqE;QACrE,oEAAoE;QACpE,2CAA2C;QAC3C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAChD,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,8BAA8B;IAC9B,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,2FAA2F;IAE3F,kEAAkE;IAClE,IAAI,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3D,oFAAoF;IACpF,IAAI,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpD,gCAAgC;IAChC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,wEAAwE;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,iFAAiF;IACjF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,kDAAkD;QAClD,IACI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YACzB,IAAI,CAAC,IAAI,EAAE,KAAK,WAAW;YAE3B,SAAS;QAEb,uFAAuF;QACvF,mEAAmE;QACnE,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAAE,SAAS;QACjD,IACI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;YAE9B,SAAS;QAEb,sFAAsF;QACtF,sDAAsD;QACtD,IACI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACpC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EACvB,CAAC;YACC,SAAS;QACb,CAAC;QAED,MAAM,KAAK,GACP,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3B,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,IACI,QAAQ,KAAK,QAAQ;gBACrB,QAAQ,KAAK,SAAS;gBACtB,QAAQ,KAAK,IAAI;gBAEjB,SAAS;YACb,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAC7C,OAAO,MAAM,CAAC;QAClB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACpD,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,+DAA+D;IAC/D,OAAO,CACH,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACzC,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CACrC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IACzC,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACvC,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC5C,KAAK,MAAM,IAAI,IAAI,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,EAAE,CAAC;QACjE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACjD,MAAM,KAAK,GAAG,GAAG;qBACZ,OAAO,CACJ,8CAA8C,EAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CACzB;qBACA,OAAO,CAAC,kCAAkC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CACvD,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CACf,CAAC;gBAEN,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAElC,2DAA2D;gBAC3D,IAAI,OAAO,GAAG,IAAI,CAAC;gBACnB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;gBACvD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC;wBACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC5D,CAAC;oBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBAC5B,CAAC;gBAED,0CAA0C;gBAC1C,MAAM,GAAG,GAAI,UAAkB,CAAC,OAAO,CAAC;gBACxC,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;gBAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAChC,UAAkB,EAClB,UAAkB;IAElB,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC;IACrD,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,cAAc,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC5C,8EAA8E;IAC9E,OAAO,CAAC,CAAC,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAC9C,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/utils/getIp.d.ts

@@ -1,53 +0,0 @@
-/***************************************************************************
- * XyPrissJS - Fast And Secure
- *
- * @author Nehonix
- * @license Nehonix OSL (NOSL)
- *
- * Copyright (c) 2025 Nehonix. All rights reserved.
- *
- * This License governs the use, modification, and distribution of software
- * provided by NEHONIX under its open source projects.
- * NEHONIX is committed to fostering collaborative innovation while strictly
- * protecting its intellectual property rights.
- * Violation of any term of this License will result in immediate termination of all granted rights
- * and may subject the violator to legal action.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
- * AND NON-INFRINGEMENT.
- * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
- * OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
- *
- ***************************************************************************** */
-import { XyPrisRequest } from "../types/httpServer.type";
-/** Result enriched with metadata for observability / debugging. */
-export interface GetIpResult {
-    /** Resolved IP address (IPv4 or IPv6, normalised). */
-    ip: string;
-    /** Header / source that provided the IP. */
-    source: IpSource;
-}
-export type IpSource = "cf-connecting-ip" | "true-client-ip" | "x-real-ip" | "x-forwarded-for" | "forwarded" | "x-client-ip" | "x-cluster-client-ip" | "req.ip" | "socket" | "fallback";
-/**
- * Robustly extracts the **real** client IP from a request.
- *
- * Resolution order (most-specific / trustworthy first):
- *  1. `CF-Connecting-IP`     – Cloudflare; single, authoritative value
- *  2. `True-Client-IP`       – Akamai / Cloudflare enterprise
- *  3. `X-Real-IP`            – Nginx single-proxy setups
- *  4. `X-Client-IP`          – Some load balancers / Apache mod_remoteip
- *  5. `X-Cluster-Client-IP`  – Rackspace, some Nginx configs
- *  6. `Forwarded`            – RFC 7239 standard header
- *  7. `X-Forwarded-For`      – De-facto standard (picks first public IP)
- *  8. `req.ip`               – XyPrisRequest parsed value
- *  9. `socket.remoteAddress` – Raw TCP socket
- * 10. `"127.0.0.1"`          – Ultimate fallback (never throws)
- *
- * @param req       - The request object (XyPrisRequest-compatible).
- * @param enriched  - When `true`, returns `{ ip, source }` for observability.
- */
-export declare function getIp(req: XyPrisRequest): string;
-export declare function getIp(req: XyPrisRequest, enriched: true): GetIpResult;
-//# sourceMappingURL=getIp.d.ts.map

package/dist/src/utils/getIp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getIp.d.ts","sourceRoot":"","sources":["../../../src/utils/getIp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;iFAsBiF;AAIjF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIzD,mEAAmE;AACnE,MAAM,WAAW,WAAW;IACxB,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,MAAM,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,MAAM,QAAQ,GACd,kBAAkB,GAClB,gBAAgB,GAChB,WAAW,GACX,iBAAiB,GACjB,WAAW,GACX,aAAa,GACb,qBAAqB,GACrB,QAAQ,GACR,QAAQ,GACR,UAAU,CAAC;AAuGjB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC;AAClD,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,GAAG,WAAW,CAAC"}

package/dist/src/utils/getIp.js

@@ -1,160 +0,0 @@
-/***************************************************************************
- * XyPrissJS - Fast And Secure
- *
- * @author Nehonix
- * @license Nehonix OSL (NOSL)
- *
- * Copyright (c) 2025 Nehonix. All rights reserved.
- *
- * This License governs the use, modification, and distribution of software
- * provided by NEHONIX under its open source projects.
- * NEHONIX is committed to fostering collaborative innovation while strictly
- * protecting its intellectual property rights.
- * Violation of any term of this License will result in immediate termination of all granted rights
- * and may subject the violator to legal action.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
- * AND NON-INFRINGEMENT.
- * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
- * OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
- *
- ***************************************************************************** */
-// ─── Constants ────────────────────────────────────────────────────────────────
-/** Regex that validates a raw IPv4 or IPv6 string (no port, no brackets). */
-const IPV4_RE = /^(25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.(25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.(25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.(25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/;
-const IPV6_RE = /^[\da-f:]+$/i;
-/** Private / loopback ranges we never want to return as the *real* client IP. */
-const PRIVATE_RANGES = [
-    /^127\./, // 127.0.0.0/8  – loopback
-    /^10\./, // 10.0.0.0/8   – RFC 1918
-    /^172\.(1[6-9]|2\d|3[01])\./, // 172.16.0.0/12 – RFC 1918
-    /^192\.168\./, // 192.168.0.0/16 – RFC 1918
-    /^169\.254\./, // 169.254.0.0/16 – link-local
-    /^::1$/, // IPv6 loopback
-    /^fe80:/i, // IPv6 link-local
-    /^fc|^fd/i, // IPv6 unique local
-];
-const FALLBACK_IP = "127.0.0.1";
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-/**
- * Strips an IPv6-mapped IPv4 prefix ("::ffff:") and surrounding brackets.
- * "::ffff:1.2.3.4" → "1.2.3.4"
- * "[::1]"          → "::1"
- */
-function normaliseIp(raw) {
-    let ip = raw.trim();
-    // Strip brackets used in URLs: [::1]:3000 → ::1
-    if (ip.startsWith("[")) {
-        ip = ip.replace(/^\[([^\]]+)\].*$/, "$1");
-    }
-    // Strip port from IPv4: 1.2.3.4:3000 → 1.2.3.4
-    const v4WithPort = ip.match(/^(\d{1,3}(?:\.\d{1,3}){3}):\d+$/);
-    if (v4WithPort)
-        ip = v4WithPort[1];
-    // Strip IPv6-mapped IPv4 prefix
-    if (/^::ffff:/i.test(ip))
-        ip = ip.slice(7);
-    return ip;
-}
-/** Returns true only for syntactically valid, non-private IPv4 / IPv6. */
-function isValidPublicIp(raw) {
-    const ip = normaliseIp(raw);
-    if (!ip)
-        return false;
-    const isIpv4 = IPV4_RE.test(ip);
-    const isIpv6 = !isIpv4 && IPV6_RE.test(ip);
-    if (!isIpv4 && !isIpv6)
-        return false;
-    return !PRIVATE_RANGES.some((re) => re.test(ip));
-}
-/** Safely reads a header value – returns undefined for missing / empty. */
-function header(headers, name) {
-    const val = headers[name.toLowerCase()];
-    if (!val)
-        return undefined;
-    const str = Array.isArray(val) ? val[0] : val;
-    return str?.trim() || undefined;
-}
-/**
- * Parses the RFC 7239 `Forwarded` header.
- * `Forwarded: for=1.2.3.4;proto=https, for=5.6.7.8`
- * → ["1.2.3.4", "5.6.7.8"]
- */
-function parseForwardedHeader(value) {
-    return value
-        .split(",")
-        .map((part) => {
-        const match = part.match(/for=["[]?([^\]",;]+)/i);
-        return match ? normaliseIp(match[1]) : "";
-    })
-        .filter(Boolean);
-}
-/**
- * Given a comma-separated (or array) `X-Forwarded-For` header,
- * returns the first *valid public* IP, or the first entry as fallback.
- */
-function pickFromXff(raw) {
-    const entries = (Array.isArray(raw) ? raw.flatMap((v) => v.split(",")) : raw.split(",")).map((s) => normaliseIp(s));
-    // Prefer first valid public IP (leftmost = original client in standard chains)
-    const pub = entries.find(isValidPublicIp);
-    if (pub)
-        return pub;
-    // Accept first private IP rather than nothing (intranet / dev env)
-    const first = entries[0];
-    return first && (IPV4_RE.test(first) || IPV6_RE.test(first))
-        ? first
-        : undefined;
-}
-export function getIp(req, enriched) {
-    const headers = (req.headers ?? {});
-    const resolve = (ip, source) => {
-        const normalised = normaliseIp(ip);
-        return enriched ? { ip: normalised, source } : normalised;
-    };
-    // 1. CF-Connecting-IP
-    const cfIp = header(headers, "cf-connecting-ip");
-    if (cfIp)
-        return resolve(cfIp, "cf-connecting-ip");
-    // 2. True-Client-IP
-    const trueClientIp = header(headers, "true-client-ip");
-    if (trueClientIp)
-        return resolve(trueClientIp, "true-client-ip");
-    // 3. X-Real-IP
-    const xRealIp = header(headers, "x-real-ip");
-    if (xRealIp)
-        return resolve(xRealIp, "x-real-ip");
-    // 4. X-Client-IP
-    const xClientIp = header(headers, "x-client-ip");
-    if (xClientIp)
-        return resolve(xClientIp, "x-client-ip");
-    // 5. X-Cluster-Client-IP
-    const xClusterIp = header(headers, "x-cluster-client-ip");
-    if (xClusterIp)
-        return resolve(xClusterIp, "x-cluster-client-ip");
-    // 6. Forwarded (RFC 7239)
-    const forwarded = header(headers, "forwarded");
-    if (forwarded) {
-        const [first] = parseForwardedHeader(forwarded);
-        if (first)
-            return resolve(first, "forwarded");
-    }
-    // 7. X-Forwarded-For
-    const xForwardedFor = headers["x-forwarded-for"];
-    if (xForwardedFor) {
-        const picked = pickFromXff(xForwardedFor);
-        if (picked)
-            return resolve(picked, "x-forwarded-for");
-    }
-    // 8. req.ip (framework-level, e.g. XyPrisRequest with trust proxy)
-    if (req.ip)
-        return resolve(req.ip, "req.ip");
-    // 9. Raw socket
-    const socketAddr = req.socket?.remoteAddress;
-    if (socketAddr)
-        return resolve(socketAddr, "socket");
-    // 10. Last-resort fallback
-    return resolve(FALLBACK_IP, "fallback");
-}
-//# sourceMappingURL=getIp.js.map

package/dist/src/utils/getIp.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getIp.js","sourceRoot":"","sources":["../../../src/utils/getIp.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/getMime.d.ts

@@ -1,52 +0,0 @@
-/***************************************************************************
- * 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.
- */
-export 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']
- */
-export declare const getMimes: (extensions?: string | string[]) => string[];
-//# sourceMappingURL=getMime.d.ts.map

package/dist/src/utils/getMime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getMime.d.ts","sourceRoot":"","sources":["../../../src/utils/getMime.ts"],"names":[],"mappings":"AAAA;;;;;;;8EAO8E;AAK9E;;;;;GAKG;AACH,eAAO,MAAM,OAAO,QAAS,MAAM,KAAG,MAMrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,QAAQ,gBAAiB,MAAM,GAAG,MAAM,EAAE,KAAG,MAAM,EA4B/D,CAAC"}