xypriss 9.12.0 → 9.12.1

package/dist/cjs/src/server/core/SendFileHandler.js

@@ -1,8 +1,9 @@
 'use strict';
 
+var getSysApi = require('../../plugins/const/getSysApi.js');
 var MIME_MAP = require('../const/MIME_MAP.js');
-var xhsc = require('../../xhsc.js');
-var promises = require('node:fs/promises');
+var path = require('node:path');
+var fs = require('node:fs');
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Resolve MIME type from file extension.
@@ -10,6 +11,7 @@ var promises = require('node:fs/promises');
 function resolveMime(ext) {
     return MIME_MAP.MIME_MAP[ext.toLowerCase()] ?? "application/octet-stream";
 }
+getSysApi.getSysApi();
 class SendFileHandler {
     constructor(res, logger) {
         this.res = res;
@@ -18,33 +20,69 @@ class SendFileHandler {
     async handle(filePath, options = {}) {
         try {
             const finalPath = options.root
-                ? xhsc.__sys__.path.join(options.root, filePath)
+                ? path.join(options.root, filePath)
                 : filePath;
             // Resolve absolute path to ensure Go can access it
-            const absolutePath = xhsc.__sys__.path.isAbsolute(finalPath)
+            const absolutePath = path.isAbsolute(finalPath)
                 ? finalPath
-                : xhsc.__sys__.path.resolve(process.cwd(), finalPath);
-            try {
-                await promises.stat(absolutePath);
-            }
-            catch (e) {
-                throw { code: "ENOENT", message: "File not found" };
-            }
+                : path.resolve(process.cwd(), finalPath);
             const req = this.res.req;
             const requestId = req?.id;
             const worker = req?.app?._xhscWorker;
-            if (requestId && worker && typeof worker.delegateStatic === "function") {
+            if (requestId && worker) {
                 if (this.logger) {
                     this.logger.debug("server", `[SendFileHandler] Delegating "${absolutePath}" to XHSC Core (Req: ${requestId})`);
                 }
-                // Delegate to Go. Go will handle ETags, Range, Mime, and Networking.
-                worker.delegateStatic(requestId, absolutePath, options);
+                /**
+                 * @performance XHSC Zero-Copy Static File Delegation
+                 *
+                 * By delegating immediately to the XHSC (Go) engine *before* performing
+                 * `fs.stat()` in Node.js, we eliminate a major performance bottleneck.
+                 * Node.js relies on a limited thread pool (default 4) for async file system
+                 * operations. Under heavy concurrent load, synchronous-like `stat` calls
+                 * exhaust this pool and queue up, causing multi-second latency spikes.
+                 *
+                 * Delegating to Go offloads file existence checking, MIME resolution,
+                 * ETags, Range headers, and the actual native `sendfile` zero-copy stream
+                 * completely to the core engine. If the file does not exist, Go will
+                 * natively return an HTTP 404 response.
+                 */
+                // Embed options natively into headers so they serialize via XBP
+                this.res.setHeader("x-xhsc-static-delegate", absolutePath);
+                if (options.headers) {
+                    for (const [k, v] of Object.entries(options.headers)) {
+                        this.res.setHeader(k, v);
+                    }
+                }
+                if (options.maxAge) {
+                    this.res.setHeader("Cache-Control", `public, max-age=${Math.floor(options.maxAge / 1000)}`);
+                }
+                if (options.disposition) {
+                    if (options.disposition === "inline") {
+                        this.res.setHeader("Content-Disposition", "inline");
+                    }
+                    else if (options.disposition === "attachment") {
+                        this.res.setHeader("Content-Disposition", `attachment; filename="${path.basename(absolutePath)}"`);
+                    }
+                    else {
+                        this.res.setHeader("Content-Disposition", `attachment; filename="${options.disposition}"`);
+                    }
+                }
+                if (options.mimeOverrides) {
+                    const ext = path.extname(absolutePath);
+                    if (options.mimeOverrides[ext]) {
+                        this.res.setHeader("Content-Type", options.mimeOverrides[ext]);
+                    }
+                }
                 // Mark as delegated by setting status 0. 
                 // XHSCBridge/index.ts and XHSCWorker.ts handle this state.
                 this.res.statusCode = 0;
                 this.res.end();
                 return;
             }
+            if (!fs.existsSync(absolutePath) || !fs.statSync(absolutePath).isFile()) {
+                throw { code: "ENOENT", message: "File not found" };
+            }
             // Fallback if not running under XHSC Bridge (should not happen in production)
             this.logger?.warn("server", "[SendFileHandler] XHSC Bridge not found, falling back to manual stream");
             this._streamFile(absolutePath);
@@ -66,7 +104,7 @@ class SendFileHandler {
         }
     }
     _streamFile(filePath, start, end) {
-        const stream = xhsc.__sys__.fs.createReadStream(filePath, { start, end });
+        const stream = fs.createReadStream(filePath, { start, end });
         stream.pipe(this.res);
     }
     static registerMimeTypes(types) {

package/dist/cjs/src/server/core/SendFileHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"SendFileHandler.js","sources":["../../../../../src/server/core/SendFileHandler.ts"],"sourcesContent":[null],"names":["MIME_MAP","__sys__","stat"],"mappings":"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"}
+{"version":3,"file":"SendFileHandler.js","sources":["../../../../../src/server/core/SendFileHandler.ts"],"sourcesContent":[null],"names":["MIME_MAP","getSysApi"],"mappings":"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"}