xypriss 9.14.11 → 9.14.13

package/dist/esm/src/xhsc/utils/Discovery.js

@@ -30,8 +30,15 @@ class Discovery {
                     for (const name of candidates) {
                         const fullPath = path__default.join(dir, name);
                         try {
-                            if (fs__default.existsSync(fullPath))
+                            if (fs__default.existsSync(fullPath)) {
+                                if (process.platform !== "win32") {
+                                    try {
+                                        fs__default.chmodSync(fullPath, 0o755);
+                                    }
+                                    catch { }
+                                }
                                 return fullPath;
+                            }
                         }
                         catch {
                             /* skip permission or access errors */

package/dist/esm/src/xhsc/utils/Discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"Discovery.js","sources":["../../../../../src/xhsc/utils/Discovery.ts"],"sourcesContent":[null],"names":["path","fs"],"mappings":";;;;AAIA;;;;;;AAMG;MACU,SAAS,CAAA;AAclB;;;;;;;;;AASG;IACI,OAAO,aAAa,CACvB,UAAoB,EACpB,WAAqB,EACrB,OAAA,GAAoB,SAAS,CAAC,cAAc,EAAA;AAE5C,QAAA,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE;YAC5B,IAAI,OAAO,GAAG,IAAI;;AAElB,YAAA,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE;AACpC,gBAAA,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE;oBAC5B,MAAM,GAAG,GAAGA,aAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;AACxC,oBAAA,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;wBAC3B,MAAM,QAAQ,GAAGA,aAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;AACrC,wBAAA,IAAI;AACA,4BAAA,IAAIC,WAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;AAAE,gCAAA,OAAO,QAAQ;wBAChD;AAAE,wBAAA,MAAM;;wBAER;oBACJ;gBACJ;gBAEA,MAAM,MAAM,GAAGD,aAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBACpC,IAAI,MAAM,KAAK,OAAO;oBAAE;gBACxB,OAAO,GAAG,MAAM;YACpB;QACJ;;QAGA,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;AACtC,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,GAAG,GAAG,GAAG,GAAG;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;AAEzC,QAAA,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE;AACxB,YAAA,IAAI,CAAC,GAAG;gBAAE;AACV,YAAA,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;gBAC3B,MAAM,QAAQ,GAAGA,aAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;AACrC,gBAAA,IAAI;AACA,oBAAA,IAAIC,WAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;AAAE,wBAAA,OAAO,QAAQ;gBAChD;AAAE,gBAAA,MAAM;;gBAER;YACJ;QACJ;AAEA,QAAA,OAAO,IAAI;IACf;AAEA;;;;;AAKG;AACI,IAAA,OAAO,YAAY,GAAA;AACtB,QAAA,IAAI;;AAEA,YAAA,MAAM,SAAS,GACX,OAAO,UAAU,KAAK;AAClB,kBAAE;kBACA,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AACxC,YAAA,OAAOD,aAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAClC;AAAE,QAAA,MAAM;AACJ,YAAA,OAAO,IAAI;QACf;IACJ;AAEA;;;;AAIG;IACI,OAAO,UAAU,CAAC,MAAc,EAAA;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;AAC/B,QAAA,IAAI,GAAG,IAAIC,WAAE,CAAC,UAAU,CAAC,GAAG,CAAC;AAAE,YAAA,OAAO,GAAG;AACzC,QAAA,OAAO,IAAI;IACf;;AAlGA;;;;;AAKG;AACoB,SAAA,CAAA,cAAc,GAAG;IACpC,KAAK;IACLD,aAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,KAAK,CAAC;AAC3C,IAAAA,aAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC;IACjCA,aAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;CACrC;;;;"}
+{"version":3,"file":"Discovery.js","sources":["../../../../../src/xhsc/utils/Discovery.ts"],"sourcesContent":[null],"names":["path","fs"],"mappings":"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"}

package/dist/index.d.ts

@@ -2782,145 +2782,14 @@ declare class PathApi extends BaseApi {
      * // Output: "/home/user/project" (Back to root)
      */
     resolve: (...paths: string[]) => string;
-    /**
-     * **Join Path Segments**
-     *
-     * Joins all given path segments together using the platform-specific separator as a delimiter,
-     * then normalizes the resulting path. This is the preferred way to construct paths
-     * to ensure validity across different operating systems.
-     *
-     * @param {...string[]} paths - A sequence of path segments to join.
-     * @returns {string} The constructed path string.
-     *
-     * @example
-     * // Constructing a path for a log file
-     * const logPath = __sys__.path.join("var", "logs", "app.log");
-     * // Output (Linux): "var/logs/app.log"
-     * // Output (Windows): "var\logs\app.log"
-     */
     join: (...paths: string[]) => string;
-    /**
-     * **Get Directory Name**
-     *
-     * Returns the directory name of a `path`. Typically used to get the parent folder
-     * of a file. It behavior follows the standard Unix `dirname` command.
-     *
-     * @param {string} p - The path to parse.
-     * @returns {string} The directory portion of the path.
-     *
-     * @example
-     * // Extracting the parent directory
-     * const parentDir = __sys__.path.dirname("/usr/local/bin/node");
-     * console.log(parentDir); // -> "/usr/local/bin"
-     */
     dirname: (p: string) => string;
-    /**
-     * **Get Base Name**
-     *
-     * Returns the last portion of a `path`. This is commonly used to extract the
-     * filename from a full path. An optional suffix can be provided to remove
-     * the file extension effectively.
-     *
-     * @param {string} p - The path to evaluate.
-     * @param {string} [suffix] - An optional suffix to remove (e.g., ".txt").
-     * @returns {string} The base name (filename) of the path.
-     *
-     * @example
-     * // Getting a filename including extension
-     * const file = __sys__.path.basename("/src/models/user.ts");
-     * console.log(file); // -> "user.ts"
-     *
-     * @example
-     * // Getting a filename without extension
-     * const name = __sys__.path.basename("/src/models/user.ts", ".ts");
-     * console.log(name); // -> "user"
-     */
     basename: (p: string, suffix?: string) => string;
-    /**
-     * **Get File Extension**
-     *
-     * Returns the extension of the path, including the leading dot (`.`).
-     * The extension is determined from the last portion of the path. If there
-     * is no `.` in the last portion, or if the first character is `.`, exact
-     * behavior mirrors standard library definitions (returning empty string or the dotfile name).
-     *
-     * @param {string} p - The path to evaluate.
-     * @returns {string} The extension of the file (e.g., ".ts", ".json").
-     *
-     * @example
-     * // checking file type
-     * const ext = __sys__.path.extname("data.json");
-     * if (ext === ".json") {
-     *   console.log("It's a JSON file!");
-     * }
-     */
     extname: (p: string) => string;
-    /**
-     * **Calculate Relative Path**
-     *
-     * Solves the relative path from `from` to `to`.
-     * This is essential when you need to generate import paths or link two files
-     * relative to each other within the filesystem.
-     *
-     * @param {string} from - The source path (start point).
-     * @param {string} to - The destination path.
-     * @returns {string} The relative path string.
-     *
-     * @example
-     * // Finding relationship between two directories
-     * const relative = __sys__.path.relative("/project/src/views", "/project/src/components");
-     * console.log(relative); // -> "../components"
-     */
     relative: (from: string, to: string) => string;
-    /**
-     * **Normalize Path**
-     *
-     * Normalizes a given path string, resolving `..` and `.` segments.
-     * It also collapses multiple sequential separators (e.g., `//` -> `/`)
-     * and ensures the path is in its simplest standard form.
-     *
-     * @param {string} p - The path to normalize.
-     * @returns {string} The clean, normalized path.
-     *
-     * @example
-     * // Cleaning up a messy path
-     * const clean = __sys__.path.normalize("/users//john/./docs/../images");
-     * console.log(clean); // -> "/users/john/images"
-     */
     normalize: (p: string) => string;
-    /**
-     * **Check Child Path Relationship**
-     *
-     * Determines if a given `child` path is strictly contained within a `parent` directory.
-     * This is a critical security utility for verifying that file operations remain
-     * within authorized boundaries.
-     *
-     * @param {string} parent - The expected parent directory.
-     * @param {string} child - The path to check.
-     * @returns {boolean} True if child is inside parent.
-     */
     isChild: (parent: string, child: string) => boolean;
-    /**
-     * **Secure Path Join**
-     *
-     * Joins path segments and ensures the result is strictly within the `base` path.
-     * If the resulting path attempts to escape via traversal (e.g., `../`), it
-     * throws a security error or returns a safe path.
-     *
-     * @param {string} base - The root/base directory.
-     * @param {...string[]} segments - The segments to join.
-     * @returns {string} The joined, safe path.
-     */
     secureJoin: (base: string, ...segments: string[]) => string;
-    /**
-     * **Get Comprehensive Path Metadata**
-     *
-     * Returns a structured object containing directory, base name, extension,
-     * filename without extension, and absolute status - all in a single high-speed call.
-     *
-     * @param {string} p - The path to evaluate.
-     * @returns {object} Metadata object: { dir, base, ext, name, isAbsolute }
-     */
     metadata: (p: string) => {
         dir: string;
         base: string;
@@ -2928,44 +2797,9 @@ declare class PathApi extends BaseApi {
         name: string;
         isAbsolute: boolean;
     };
-    /**
-     * **Convert to Namespaced Path**
-     *
-     * Converts the path to a platform-specific namespaced path (e.g., UNC on Windows).
-     * This is essential for handling extremely long paths or network shares natively.
-     *
-     * @param {string} p - The path to convert.
-     * @returns {string} The namespaced path.
-     */
     toNamespacedPath: (p: string) => string;
-    /**
-     * **Normalize Separators**
-     *
-     * Standardizes all path separators (`/` or `\`) to the current operating system's
-     * primary separator format.
-     *
-     * @param {string} p - The path to handle.
-     * @returns {string} The path with uniform separators.
-     */
     normalizeSeparators: (p: string) => string;
-    /**
-     * **Identify Common Base Directory**
-     *
-     * Analyzes multiple paths and returns the deepest common directory shared by all.
-     *
-     * @param {...string[]} paths - Multiple paths to analyze.
-     * @returns {string} The shared parent directory.
-     */
     commonBase: (...paths: string[]) => string;
-    /**
-     * **Check if Path is Absolute**
-     *
-     * Determines if the given path is an absolute path. This is platform-aware,
-     * correctly handling Windows drive letters and Unix root slashes.
-     *
-     * @param {string} p - The path to check.
-     * @returns {boolean} True if the path is absolute, false otherwise.
-     */
     isAbsolute: (p: string) => boolean;
     /**
      * **Smart Path Correction**
@@ -11850,10 +11684,6 @@ interface XServerOptions {
      * and high-speed synchronization with the native Go core (XHSC).
      */
     synapx?: SynapxOptions;
-    /**
-     * Alias for `synapx`.
-     */
-    libsynapx?: SynapxOptions;
     /**
      * Static file serving configuration (XStatic).
      *
@@ -12614,6 +12444,14 @@ interface XServerOptions {
  * Controls maximum message payload envelopes, communication timeouts, and frame batching.
  */
 interface SynapxOptions {
+    /**
+     * Automatic calculation and adaptive tuning for timeout, payload limits, and buffer batch size.
+     * When enabled (or omitted), XyPriss dynamically derives optimal engine parameters from maxPayloadSize
+     * and fileUpload constraints to guarantee reliable throughput without resource starvation or premature timeouts.
+     *
+     * @default true
+     */
+    autoTune?: boolean;
     /**
      * Maximum payload frame size allowed by the Synapx engine (e.g. "512MB", "1GB", "2GB", or number in bytes).
      * Used for ultra-high-throughput streaming, bulk binary transfers, and large file operations.
@@ -12622,11 +12460,11 @@ interface SynapxOptions {
      */
     maxPayloadSize?: number | string;
     /**
-     * Request execution timeout in milliseconds for Synapx operations before throwing a timeout error.
+     * Request execution timeout in milliseconds or human-readable duration (e.g. 60000, "60s", "120s", "auto") for Synapx operations before throwing a timeout error.
      *
-     * @default 60000 (60 seconds)
+     * @default 60000 (60 seconds, or dynamically derived when autoTune is enabled)
      */
-    timeout?: number;
+    timeout?: number | string;
     /**
      * Batch buffer queue depth for coalescing write operations.
      *
@@ -12634,8 +12472,6 @@ interface SynapxOptions {
      */
     batchSize?: number;
 }
-type LibSynapxOptions = SynapxOptions;
-type IpcOptions = SynapxOptions;
 
 /**
  * @fileoverview Main export file for XyPriss integration types
@@ -14218,6 +14054,10 @@ interface RedirectServerInstance {
 }
 type XyPrissApp = XyApp;
 
+/**
+ * Configuration Manager Class
+ * Singleton pattern for managing XyPriss configurations
+ */
 /**
  * XyPriss Configuration Manager
  *
@@ -14254,11 +14094,6 @@ type XyPrissApp = XyApp;
  * Configs.update('fileUpload', { maxFileSize: 10 * 1024 * 1024 });
  * ```
  */
-
-/**
- * Configuration Manager Class
- * Singleton pattern for managing XyPriss configurations
- */
 declare class ConfigurationManager {
     private static instance;
     private config;
@@ -16042,4 +15877,4 @@ declare class XStatic {
 declare function Router(): XyPrissRouter;
 
 export { ConfigurationManager as CM, ConfigurationManager as Configs, DateUtils, FileUploadAPI as FLA, FileUploadAPI, Plugin, PluginHookIds, Router, SecurityMiddleware, Send, Upload, XJsonResponseHandler, XServer, XStatic, XyGuard, MultiServerApp as XyPMS, XyPrissRouter, XyPrissXHSC, __cfg__, __const__, __sys__, createOptimalCache, createServer, getCallerProjectRoot, getInstanceId, getIp, getMime, getMimes, identifyProjectRoot, initializeFileUpload, mergeWithDefaults, mergeWithDefaults as mwdef, normalizeXtrsRules, parseDurationMs, parseXtrsRule, quickServer, uploadAny, uploadArray, uploadFields, uploadSingle, xems };
-export type { ArchiveOptions, BatchRenameChange, CacheConfig, DateExpression, DateUnit, DurationUnitShorthand, FileUploadConfig as FiUpConfig, FileUploadConfig, GetIpResult, GuardResolver, IFile, IpSource, IpcOptions, LibSynapxOptions, MonitorSnapshot, MultiServerConfig, NaturalDateKeyword, NetworkStats, NextFunction, PerformanceConfig, PluginCreator, PluginServer, ProcessInfo, ProcessMonitorSnapshot, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RoutRateLimit, RoutRateLimitInput, RouteConfig, RouteGuard, RouteMeta, RouteOptions, ParamType as RouteParamType, SecurityConfig, ServerOptions$1 as ServerOptions, SynapxOptions, TempFileOptions, TempFileResult, XyPrisRequest$1 as XRequest, XyPrisResponse$1 as XResponse, XemsTypes, XtrsOptions, XtrsRuleConfig, XtrsRuleInput, XyGuardContext, XyPrisRequest$1 as XyPrisRequest, XyPrisResponse$1 as XyPrisResponse, XyPrissApp, XyPrissPlugin };
+export type { ArchiveOptions, BatchRenameChange, CacheConfig, DateExpression, DateUnit, DurationUnitShorthand, FileUploadConfig as FiUpConfig, FileUploadConfig, GetIpResult, GuardResolver, IFile, IpSource, MonitorSnapshot, MultiServerConfig, NaturalDateKeyword, NetworkStats, NextFunction, PerformanceConfig, PluginCreator, PluginServer, ProcessInfo, ProcessMonitorSnapshot, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RoutRateLimit, RoutRateLimitInput, RouteConfig, RouteGuard, RouteMeta, RouteOptions, ParamType as RouteParamType, SecurityConfig, ServerOptions$1 as ServerOptions, SynapxOptions, TempFileOptions, TempFileResult, XyPrisRequest$1 as XRequest, XyPrisResponse$1 as XResponse, XemsTypes, XtrsOptions, XtrsRuleConfig, XtrsRuleInput, XyGuardContext, XyPrisRequest$1 as XyPrisRequest, XyPrisResponse$1 as XyPrisResponse, XyPrissApp, XyPrissPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xypriss",
-    "version": "9.14.11",
+    "version": "9.14.13",
     "description": "XyPriss is a high-performance, TypeScript-first hyper-system web framework powered by a native Go core (XHSC), featuring robust multi-tenant sandboxing, secure native file streaming, and zero Express dependencies.",
     "author": {
         "DEV.to": "https://dev.to/nehonix",