xypriss 9.10.20 → 9.10.22

package/dist/cjs/src/index.js

@@ -16,6 +16,7 @@ var XyGuard = require('./server/routing/modules/XyGuard.js');
 var PluginHookIds = require('./plugins/const/PluginHookIds.js');
 var mergeWithDefaults = require('./utils/mergeWithDefaults.js');
 var getIp = require('./utils/getIp.js');
+var Send = require('./utils/Send.js');
 var ProjectDiscovery = require('./utils/ProjectDiscovery.js');
 var XemsPlugin = require('./plugins/builtin/xems/XemsPlugin.js');
 var getMime = require('./utils/getMime.js');
@@ -84,6 +85,7 @@ exports.PluginHookIds = PluginHookIds.PluginHookIds;
 exports.mergeWithDefaults = mergeWithDefaults.mergeWithDefaults;
 exports.mwdef = mergeWithDefaults.mergeWithDefaults;
 exports.getIp = getIp.getIp;
+exports.Send = Send.Send;
 exports.getCallerProjectRoot = ProjectDiscovery.getCallerProjectRoot;
 exports.identifyProjectRoot = ProjectDiscovery.identifyProjectRoot;
 exports.xems = XemsPlugin.xems;

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;AACjF;AAEA;AACA;AAqBA;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;IACnCA,yBAAY,CAAC,qBAAqB,EAAE;AACxC;AA+BA;;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;AACjF;AAEA;AACA;AAqBA;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;IACnCA,yBAAY,CAAC,qBAAqB,EAAE;AACxC;AA+BA;;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/server/core/XyServerCreator.js

@@ -40,15 +40,6 @@ class XyServerCreator {
                 });
             }
         }
-        // 3.5 Configure Environment Security Shield (XESS)
-        if (typeof globalThis !== "undefined" &&
-            globalThis.__sys__ &&
-            globalThis.__sys__.__env__) {
-            const xessConfig = options.security?.xess || options.security?.envShield;
-            if (xessConfig) {
-                globalThis.__sys__.__env__.configureShield(xessConfig);
-            }
-        }
         // 4. Update __sys__ with port if provided
         if (options.server?.port &&
             typeof globalThis !== "undefined" &&

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

@@ -1 +1 @@
-{"version":3,"file":"XyServerCreator.js","sources":["../../../../../src/server/core/XyServerCreator.ts"],"sourcesContent":[null],"names":["configLoader","Logger","Configs","getMimes","handleWorkerMode","XyPrissServer","PluginManager"],"mappings":"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"}
+{"version":3,"file":"XyServerCreator.js","sources":["../../../../../src/server/core/XyServerCreator.ts"],"sourcesContent":[null],"names":["configLoader","Logger","Configs","getMimes","handleWorkerMode","XyPrissServer","PluginManager"],"mappings":"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"}

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

@@ -0,0 +1,170 @@
+'use strict';
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Derives a compact, uppercase error code from a {@link SupportedStatus} key.
+ *
+ * @example
+ * buildErrorCode("BAD_REQUEST")      // → "EBADR"
+ * buildErrorCode("INTERNAL_SERVER_ERR") // → "EINTE"
+ *
+ * @param status - The status key to convert.
+ * @returns A 5-character string starting with `"E"`.
+ */
+function buildErrorCode(status) {
+    // Remove all underscores, take first 4 chars, prepend "E"
+    return "E" + status.replace(/_/g, "").slice(0, 4).toUpperCase();
+}
+// ---------------------------------------------------------------------------
+// Default HTTP status code registry
+// ---------------------------------------------------------------------------
+const DEFAULT_CONFIGS = {
+    BAD_REQUEST: 400,
+    NOT_FOUND: 404,
+    TOO_MANY_REQUEST: 429,
+    INTERNAL_SERVER_ERR: 500,
+};
+// ---------------------------------------------------------------------------
+// Send class
+// ---------------------------------------------------------------------------
+/**
+ * A structured HTTP response helper that standardises all error responses
+ * across the application.
+ *
+ * Every method sends a JSON body conforming to {@link IResTemplate}, ensuring
+ * consistent error shapes for API consumers regardless of where the error
+ * originates.
+ *
+ * @example
+ * ```ts
+ * const send = new Send(res);
+ *
+ * // 400 – validation failure
+ * send.badRequest("The 'email' field is required.");
+ *
+ * // 404 – resource missing
+ * send.notFound("User not found.", { userId: 42 });
+ *
+ * // 429 – rate limit exceeded
+ * send.tooManyRequest("Too many requests. Please slow down.");
+ *
+ * // 500 – unexpected failure
+ * send.internalError("An unexpected error occurred.");
+ * ```
+ */
+class Send {
+    /**
+     * Creates a new `Send` instance bound to the given response object.
+     *
+     * @param res     - The active `XyPrisResponse` to write into.
+     * @param configs - Optional override for the default status-code registry.
+     *                  Useful for non-standard or custom HTTP codes.
+     */
+    constructor(res, configs = {
+        includeServerName: true,
+        statusCode: {},
+    }) {
+        // -------------------------------------------------------------------------
+        // Public methods
+        // -------------------------------------------------------------------------
+        /**
+         * Sends a **400 Bad Request** response.
+         *
+         * Use when the client submits a malformed or invalid request
+         * (e.g. missing required fields, invalid format, constraint violation).
+         *
+         * @param message - Human-readable explanation of why the request was rejected.
+         * @param data    - Optional payload (e.g. a list of validation errors per field).
+         *
+         * @example
+         * send.badRequest("The 'username' field must be at least 3 characters.");
+         * send.badRequest("Validation failed.", { fields: { email: "Invalid format" } });
+         */
+        this.badRequest = (message, data) => {
+            this.dispatch("BAD_REQUEST", "Bad Request", message, data);
+        };
+        /**
+         * Sends a **404 Not Found** response.
+         *
+         * Use when the requested resource does not exist or has been permanently removed.
+         *
+         * @param message - Human-readable explanation of what could not be found.
+         * @param data    - Optional payload (e.g. the identifier that was looked up).
+         *
+         * @example
+         * send.notFound("No user found with id '42'.");
+         * send.notFound("Resource not found.", { id: "42" });
+         */
+        this.notFound = (message, data) => {
+            this.dispatch("NOT_FOUND", "Not Found", message, data);
+        };
+        /**
+         * Sends a **429 Too Many Requests** response.
+         *
+         * Use when the client has exceeded an allowed request rate or quota.
+         * Consider pairing this with a `Retry-After` header at the middleware level.
+         *
+         * @param message - Human-readable explanation of the rate limit breach.
+         * @param data    - Optional payload (e.g. retry delay, remaining quota).
+         *
+         * @example
+         * send.tooManyRequest("Rate limit reached. Try again in 60 seconds.");
+         * send.tooManyRequest("Quota exceeded.", { retryAfter: 60 });
+         */
+        this.tooManyRequest = (message, data) => {
+            this.dispatch("TOO_MANY_REQUEST", "Too Many Requests", message, data);
+        };
+        /**
+         * Sends a **500 Internal Server Error** response.
+         *
+         * Use for unexpected, unhandled server-side failures.
+         * Avoid leaking internal stack traces or sensitive details in the message.
+         *
+         * @param message - Human-readable explanation safe to expose to the client.
+         * @param data    - Optional payload (use sparingly — never expose raw stack traces).
+         *
+         * @example
+         * send.internalError("An unexpected error occurred. Please try again later.");
+         */
+        this.internalError = (message, data) => {
+            this.dispatch("INTERNAL_SERVER_ERR", "Internal Server Error", message, data);
+        };
+        this.res = res;
+        this.configs = { ...DEFAULT_CONFIGS, ...configs.statusCode };
+        this.serverName = __sys__.vars.__name__;
+        this.includeServerName = configs?.includeServerName;
+    }
+    // -------------------------------------------------------------------------
+    // Core dispatcher
+    // -------------------------------------------------------------------------
+    /**
+     * Resolves the status code, builds the full response body, and flushes it.
+     *
+     * @param statusKey  - One of the {@link SupportedStatus} keys.
+     * @param errorLabel - Human-readable short label for the error type.
+     * @param message    - Optional caller-supplied message; falls back to `errorLabel`.
+     * @param data       - Optional payload to attach to the response body.
+     */
+    dispatch(statusKey, errorLabel, message, data) {
+        const statusCode = this.configs[statusKey];
+        const body = {
+            success: false,
+            message: message ?? errorLabel,
+            serverName: this.includeServerName
+                ? this.serverName
+                : undefined,
+            ...(data !== undefined && { data }),
+            details: {
+                error: errorLabel,
+                errorCode: buildErrorCode(statusKey),
+                statusCode,
+            },
+        };
+        this.res.status(statusCode).json(body);
+    }
+}
+
+exports.Send = Send;
+//# sourceMappingURL=Send.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Send.js","sources":["../../../../src/utils/Send.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAsFA;AACA;AACA;AAEA;;;;;;;;;AASG;AACH,SAAS,cAAc,CAAC,MAAuB,EAAA;;IAE7C,OAAO,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE;AACjE;AAEA;AACA;AACA;AAEA,MAAM,eAAe,GAAe;AAClC,IAAA,WAAW,EAAE,GAAG;AAChB,IAAA,SAAS,EAAE,GAAG;AACd,IAAA,gBAAgB,EAAE,GAAG;AACrB,IAAA,mBAAmB,EAAE,GAAG;CACzB;AAED;AACA;AACA;AAEA;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;MACU,IAAI,CAAA;AAMf;;;;;;AAMG;IACH,WAAA,CACE,GAAmB,EACnB,OAAA,GAGK;AACH,QAAA,iBAAiB,EAAE,IAAI;AACvB,QAAA,UAAU,EAAE,EAAE;AACf,KAAA,EAAA;;;;AAiDH;;;;;;;;;;;;AAYG;AACI,QAAA,IAAA,CAAA,UAAU,GAAiB,CAAC,OAAO,EAAE,IAAI,KAAI;YAClD,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC;AAC5D,QAAA,CAAC;AAED;;;;;;;;;;;AAWG;AACI,QAAA,IAAA,CAAA,QAAQ,GAAiB,CAAC,OAAO,EAAE,IAAI,KAAI;YAChD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;AACxD,QAAA,CAAC;AAED;;;;;;;;;;;;AAYG;AACI,QAAA,IAAA,CAAA,cAAc,GAAiB,CAAC,OAAO,EAAE,IAAI,KAAI;YACtD,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,CAAC;AACvE,QAAA,CAAC;AAED;;;;;;;;;;;AAWG;AACI,QAAA,IAAA,CAAA,aAAa,GAAiB,CAAC,OAAO,EAAE,IAAI,KAAI;YACrD,IAAI,CAAC,QAAQ,CACX,qBAAqB,EACrB,uBAAuB,EACvB,OAAO,EACP,IAAI,CACL;AACH,QAAA,CAAC;AApHC,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;AACd,QAAA,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE;QAC5D,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ;AACvC,QAAA,IAAI,CAAC,iBAAiB,GAAG,OAAO,EAAE,iBAAkB;IACtD;;;;AAMA;;;;;;;AAOG;AACK,IAAA,QAAQ,CACd,SAA0B,EAC1B,UAAkB,EAClB,OAAgB,EAChB,IAAc,EAAA;QAEd,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;AAE1C,QAAA,MAAM,IAAI,GAAiB;AACzB,YAAA,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,OAAO,IAAI,UAAU;YAC9B,UAAU,EAAE,IAAI,CAAC;kBACb,IAAI,CAAC;AACP,kBAAG,SAA4B;YACjC,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;AACnC,YAAA,OAAO,EAAE;AACP,gBAAA,KAAK,EAAE,UAAU;AACjB,gBAAA,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC;gBACpC,UAAU;AACX,aAAA;SACF;AAED,QAAA,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC;AA4ED;;;;"}

package/dist/cjs/src/xhsc.js

@@ -4,6 +4,7 @@ var fs = require('fs');
 var path = require('path');
 var System = require('./xhsc/System.js');
 var DotEnvLoader = require('./utils/DotEnvLoader.js');
+var JsonUtils = require('./utils/JsonUtils.js');
 var env = require('./xhsc/api/env/env.js');
 var ProjectDiscovery = require('./utils/ProjectDiscovery.js');
 var Logger = require('./shared/logger/Logger.js');
@@ -215,9 +216,26 @@ if (typeof globalThis !== "undefined") {
     }
     // Initialize the Symbol-keyed secure store as a Map of project environments
     globalThis[env.XY_ENV_STORE_KEY] = projectEnvs;
-    // Use the primary project root's environment for system defaults
     const primaryEnv = projectEnvs.get(foundRoot) || {};
     const defaultPort = parseInt(primaryEnv["PORT"] || "3000");
+    // Read xypriss.config.jsonc or xypriss.config.json early to apply XESS configuration declaratively
+    let earlyXessConfig = null;
+    try {
+        for (const name of ["xypriss.config.jsonc", "xypriss.config.json"]) {
+            const potentialConfig = path.join(foundRoot, name);
+            if (fs.existsSync(potentialConfig)) {
+                const rawContent = fs.readFileSync(potentialConfig, "utf8");
+                const config = JsonUtils.JsonUtils.parse(rawContent);
+                if (config?.$env) {
+                    earlyXessConfig = config.$env;
+                }
+                break;
+            }
+        }
+    }
+    catch {
+        // Silently fallback on parse error
+    }
     if (!globalThis.__sys__) {
         const sysInstance = new XyPrissXHSC({
             __root__: foundRoot,
@@ -225,6 +243,10 @@ if (typeof globalThis !== "undefined") {
             __PORT__: defaultPort,
             __mode__: primaryEnv["NODE_ENV"] || "development",
         });
+        // Apply declarative XESS early configuration if found
+        if (earlyXessConfig && sysInstance.__env__) {
+            sysInstance.__env__.configureShield(earlyXessConfig);
+        }
         // ==========================================
         // ENTERPRISE IMMUTABILITY SHIELD (V2)
         // ==========================================

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

@@ -1 +1 @@
-{"version":3,"file":"xhsc.js","sources":["../../../src/xhsc.ts"],"sourcesContent":[null],"names":["XyPrissFS","XY_XHSC_REGISTER_FS","getCallerProjectRoot","isProjectRoot","logger","generateXUserTmpDir","loadXyConfig","DotEnvLoader","XY_ENV_STORE_KEY","createSecurityShield"],"mappings":"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"}
+{"version":3,"file":"xhsc.js","sources":["../../../src/xhsc.ts"],"sourcesContent":[null],"names":["XyPrissFS","XY_XHSC_REGISTER_FS","getCallerProjectRoot","isProjectRoot","logger","generateXUserTmpDir","loadXyConfig","DotEnvLoader","XY_ENV_STORE_KEY","JsonUtils","createSecurityShield"],"mappings":"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"}

package/dist/esm/src/index.js

@@ -14,6 +14,7 @@ export { XyGuard } from './server/routing/modules/XyGuard.js';
 export { PluginHookIds } from './plugins/const/PluginHookIds.js';
 export { mergeWithDefaults, mergeWithDefaults as mwdef } from './utils/mergeWithDefaults.js';
 export { getIp } from './utils/getIp.js';
+export { Send } from './utils/Send.js';
 export { getCallerProjectRoot, identifyProjectRoot } from './utils/ProjectDiscovery.js';
 export { xems } from './plugins/builtin/xems/XemsPlugin.js';
 export { getMime, getMimes } from './utils/getMime.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;AACjF;AAEA;AACA;AAqBA;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;IACnC,YAAY,CAAC,qBAAqB,EAAE;AACxC;AA+BA;;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;AACjF;AAEA;AACA;AAqBA;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;IACnC,YAAY,CAAC,qBAAqB,EAAE;AACxC;AA+BA;;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/server/core/XyServerCreator.js

@@ -38,15 +38,6 @@ class XyServerCreator {
                 });
             }
         }
-        // 3.5 Configure Environment Security Shield (XESS)
-        if (typeof globalThis !== "undefined" &&
-            globalThis.__sys__ &&
-            globalThis.__sys__.__env__) {
-            const xessConfig = options.security?.xess || options.security?.envShield;
-            if (xessConfig) {
-                globalThis.__sys__.__env__.configureShield(xessConfig);
-            }
-        }
         // 4. Update __sys__ with port if provided
         if (options.server?.port &&
             typeof globalThis !== "undefined" &&

package/dist/esm/src/server/core/XyServerCreator.js.map

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

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

@@ -0,0 +1,168 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Derives a compact, uppercase error code from a {@link SupportedStatus} key.
+ *
+ * @example
+ * buildErrorCode("BAD_REQUEST")      // → "EBADR"
+ * buildErrorCode("INTERNAL_SERVER_ERR") // → "EINTE"
+ *
+ * @param status - The status key to convert.
+ * @returns A 5-character string starting with `"E"`.
+ */
+function buildErrorCode(status) {
+    // Remove all underscores, take first 4 chars, prepend "E"
+    return "E" + status.replace(/_/g, "").slice(0, 4).toUpperCase();
+}
+// ---------------------------------------------------------------------------
+// Default HTTP status code registry
+// ---------------------------------------------------------------------------
+const DEFAULT_CONFIGS = {
+    BAD_REQUEST: 400,
+    NOT_FOUND: 404,
+    TOO_MANY_REQUEST: 429,
+    INTERNAL_SERVER_ERR: 500,
+};
+// ---------------------------------------------------------------------------
+// Send class
+// ---------------------------------------------------------------------------
+/**
+ * A structured HTTP response helper that standardises all error responses
+ * across the application.
+ *
+ * Every method sends a JSON body conforming to {@link IResTemplate}, ensuring
+ * consistent error shapes for API consumers regardless of where the error
+ * originates.
+ *
+ * @example
+ * ```ts
+ * const send = new Send(res);
+ *
+ * // 400 – validation failure
+ * send.badRequest("The 'email' field is required.");
+ *
+ * // 404 – resource missing
+ * send.notFound("User not found.", { userId: 42 });
+ *
+ * // 429 – rate limit exceeded
+ * send.tooManyRequest("Too many requests. Please slow down.");
+ *
+ * // 500 – unexpected failure
+ * send.internalError("An unexpected error occurred.");
+ * ```
+ */
+class Send {
+    /**
+     * Creates a new `Send` instance bound to the given response object.
+     *
+     * @param res     - The active `XyPrisResponse` to write into.
+     * @param configs - Optional override for the default status-code registry.
+     *                  Useful for non-standard or custom HTTP codes.
+     */
+    constructor(res, configs = {
+        includeServerName: true,
+        statusCode: {},
+    }) {
+        // -------------------------------------------------------------------------
+        // Public methods
+        // -------------------------------------------------------------------------
+        /**
+         * Sends a **400 Bad Request** response.
+         *
+         * Use when the client submits a malformed or invalid request
+         * (e.g. missing required fields, invalid format, constraint violation).
+         *
+         * @param message - Human-readable explanation of why the request was rejected.
+         * @param data    - Optional payload (e.g. a list of validation errors per field).
+         *
+         * @example
+         * send.badRequest("The 'username' field must be at least 3 characters.");
+         * send.badRequest("Validation failed.", { fields: { email: "Invalid format" } });
+         */
+        this.badRequest = (message, data) => {
+            this.dispatch("BAD_REQUEST", "Bad Request", message, data);
+        };
+        /**
+         * Sends a **404 Not Found** response.
+         *
+         * Use when the requested resource does not exist or has been permanently removed.
+         *
+         * @param message - Human-readable explanation of what could not be found.
+         * @param data    - Optional payload (e.g. the identifier that was looked up).
+         *
+         * @example
+         * send.notFound("No user found with id '42'.");
+         * send.notFound("Resource not found.", { id: "42" });
+         */
+        this.notFound = (message, data) => {
+            this.dispatch("NOT_FOUND", "Not Found", message, data);
+        };
+        /**
+         * Sends a **429 Too Many Requests** response.
+         *
+         * Use when the client has exceeded an allowed request rate or quota.
+         * Consider pairing this with a `Retry-After` header at the middleware level.
+         *
+         * @param message - Human-readable explanation of the rate limit breach.
+         * @param data    - Optional payload (e.g. retry delay, remaining quota).
+         *
+         * @example
+         * send.tooManyRequest("Rate limit reached. Try again in 60 seconds.");
+         * send.tooManyRequest("Quota exceeded.", { retryAfter: 60 });
+         */
+        this.tooManyRequest = (message, data) => {
+            this.dispatch("TOO_MANY_REQUEST", "Too Many Requests", message, data);
+        };
+        /**
+         * Sends a **500 Internal Server Error** response.
+         *
+         * Use for unexpected, unhandled server-side failures.
+         * Avoid leaking internal stack traces or sensitive details in the message.
+         *
+         * @param message - Human-readable explanation safe to expose to the client.
+         * @param data    - Optional payload (use sparingly — never expose raw stack traces).
+         *
+         * @example
+         * send.internalError("An unexpected error occurred. Please try again later.");
+         */
+        this.internalError = (message, data) => {
+            this.dispatch("INTERNAL_SERVER_ERR", "Internal Server Error", message, data);
+        };
+        this.res = res;
+        this.configs = { ...DEFAULT_CONFIGS, ...configs.statusCode };
+        this.serverName = __sys__.vars.__name__;
+        this.includeServerName = configs?.includeServerName;
+    }
+    // -------------------------------------------------------------------------
+    // Core dispatcher
+    // -------------------------------------------------------------------------
+    /**
+     * Resolves the status code, builds the full response body, and flushes it.
+     *
+     * @param statusKey  - One of the {@link SupportedStatus} keys.
+     * @param errorLabel - Human-readable short label for the error type.
+     * @param message    - Optional caller-supplied message; falls back to `errorLabel`.
+     * @param data       - Optional payload to attach to the response body.
+     */
+    dispatch(statusKey, errorLabel, message, data) {
+        const statusCode = this.configs[statusKey];
+        const body = {
+            success: false,
+            message: message ?? errorLabel,
+            serverName: this.includeServerName
+                ? this.serverName
+                : undefined,
+            ...(data !== undefined && { data }),
+            details: {
+                error: errorLabel,
+                errorCode: buildErrorCode(statusKey),
+                statusCode,
+            },
+        };
+        this.res.status(statusCode).json(body);
+    }
+}
+
+export { Send };
+//# sourceMappingURL=Send.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Send.js","sources":["../../../../src/utils/Send.ts"],"sourcesContent":[null],"names":[],"mappings":"AAsFA;AACA;AACA;AAEA;;;;;;;;;AASG;AACH,SAAS,cAAc,CAAC,MAAuB,EAAA;;IAE7C,OAAO,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE;AACjE;AAEA;AACA;AACA;AAEA,MAAM,eAAe,GAAe;AAClC,IAAA,WAAW,EAAE,GAAG;AAChB,IAAA,SAAS,EAAE,GAAG;AACd,IAAA,gBAAgB,EAAE,GAAG;AACrB,IAAA,mBAAmB,EAAE,GAAG;CACzB;AAED;AACA;AACA;AAEA;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;MACU,IAAI,CAAA;AAMf;;;;;;AAMG;IACH,WAAA,CACE,GAAmB,EACnB,OAAA,GAGK;AACH,QAAA,iBAAiB,EAAE,IAAI;AACvB,QAAA,UAAU,EAAE,EAAE;AACf,KAAA,EAAA;;;;AAiDH;;;;;;;;;;;;AAYG;AACI,QAAA,IAAA,CAAA,UAAU,GAAiB,CAAC,OAAO,EAAE,IAAI,KAAI;YAClD,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC;AAC5D,QAAA,CAAC;AAED;;;;;;;;;;;AAWG;AACI,QAAA,IAAA,CAAA,QAAQ,GAAiB,CAAC,OAAO,EAAE,IAAI,KAAI;YAChD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;AACxD,QAAA,CAAC;AAED;;;;;;;;;;;;AAYG;AACI,QAAA,IAAA,CAAA,cAAc,GAAiB,CAAC,OAAO,EAAE,IAAI,KAAI;YACtD,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,CAAC;AACvE,QAAA,CAAC;AAED;;;;;;;;;;;AAWG;AACI,QAAA,IAAA,CAAA,aAAa,GAAiB,CAAC,OAAO,EAAE,IAAI,KAAI;YACrD,IAAI,CAAC,QAAQ,CACX,qBAAqB,EACrB,uBAAuB,EACvB,OAAO,EACP,IAAI,CACL;AACH,QAAA,CAAC;AApHC,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;AACd,QAAA,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE;QAC5D,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ;AACvC,QAAA,IAAI,CAAC,iBAAiB,GAAG,OAAO,EAAE,iBAAkB;IACtD;;;;AAMA;;;;;;;AAOG;AACK,IAAA,QAAQ,CACd,SAA0B,EAC1B,UAAkB,EAClB,OAAgB,EAChB,IAAc,EAAA;QAEd,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;AAE1C,QAAA,MAAM,IAAI,GAAiB;AACzB,YAAA,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,OAAO,IAAI,UAAU;YAC9B,UAAU,EAAE,IAAI,CAAC;kBACb,IAAI,CAAC;AACP,kBAAG,SAA4B;YACjC,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;AACnC,YAAA,OAAO,EAAE;AACP,gBAAA,KAAK,EAAE,UAAU;AACjB,gBAAA,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC;gBACpC,UAAU;AACX,aAAA;SACF;AAED,QAAA,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC;AA4ED;;;;"}

package/dist/esm/src/xhsc.js

@@ -2,6 +2,7 @@ import fs__default from 'fs';
 import path__default from 'path';
 import { XyPrissFS } from './xhsc/System.js';
 import { DotEnvLoader } from './utils/DotEnvLoader.js';
+import { JsonUtils } from './utils/JsonUtils.js';
 import { XY_ENV_STORE_KEY, XY_XHSC_REGISTER_FS } from './xhsc/api/env/env.js';
 import { isProjectRoot, getCallerProjectRoot, loadXyConfig } from './utils/ProjectDiscovery.js';
 import { logger } from './shared/logger/Logger.js';
@@ -213,9 +214,26 @@ if (typeof globalThis !== "undefined") {
     }
     // Initialize the Symbol-keyed secure store as a Map of project environments
     globalThis[XY_ENV_STORE_KEY] = projectEnvs;
-    // Use the primary project root's environment for system defaults
     const primaryEnv = projectEnvs.get(foundRoot) || {};
     const defaultPort = parseInt(primaryEnv["PORT"] || "3000");
+    // Read xypriss.config.jsonc or xypriss.config.json early to apply XESS configuration declaratively
+    let earlyXessConfig = null;
+    try {
+        for (const name of ["xypriss.config.jsonc", "xypriss.config.json"]) {
+            const potentialConfig = path__default.join(foundRoot, name);
+            if (fs__default.existsSync(potentialConfig)) {
+                const rawContent = fs__default.readFileSync(potentialConfig, "utf8");
+                const config = JsonUtils.parse(rawContent);
+                if (config?.$env) {
+                    earlyXessConfig = config.$env;
+                }
+                break;
+            }
+        }
+    }
+    catch {
+        // Silently fallback on parse error
+    }
     if (!globalThis.__sys__) {
         const sysInstance = new XyPrissXHSC({
             __root__: foundRoot,
@@ -223,6 +241,10 @@ if (typeof globalThis !== "undefined") {
             __PORT__: defaultPort,
             __mode__: primaryEnv["NODE_ENV"] || "development",
         });
+        // Apply declarative XESS early configuration if found
+        if (earlyXessConfig && sysInstance.__env__) {
+            sysInstance.__env__.configureShield(earlyXessConfig);
+        }
         // ==========================================
         // ENTERPRISE IMMUTABILITY SHIELD (V2)
         // ==========================================

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

@@ -1 +1 @@
-{"version":3,"file":"xhsc.js","sources":["../../../src/xhsc.ts"],"sourcesContent":[null],"names":["fs","path"],"mappings":"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"}
+{"version":3,"file":"xhsc.js","sources":["../../../src/xhsc.ts"],"sourcesContent":[null],"names":["fs","path"],"mappings":"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"}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { Server, IncomingMessage, ServerResponse } from 'http';
 import { SecureCacheAdapter } from 'xypriss-security';
 import * as reliant_type from 'reliant-type';
 import { Readable, Writable } from 'node:stream';
+import { XyPrisResponse as XyPrisResponse$2 } from 'xypriss';
 
 declare const LOG_LEVELS: readonly ["silent", "error", "warn", "info", "debug", "verbose"];
 type LogLevel = (typeof LOG_LEVELS)[number];
@@ -1524,50 +1525,6 @@ interface SecurityModuleRouteConfig {
     /** Routes to include for this security module (if specified, only these routes will be protected) */
     includeRoutes?: (string | RegExp | RoutePattern)[];
 }
-/**
- * Security Configuration Interface
- *
- * Defines comprehensive security settings for XyPriss applications.
- * Each security feature can be enabled/disabled or configured with detailed options.
- *
- * @example
- * ```typescript
- * const securityConfig: SecurityConfig = {
- *   level: 'enhanced',
- *   helmet: {
- *     contentSecurityPolicy: {
- *       directives: { defaultSrc: ["'self'"] }
- *     }
- *   },
- *   cors: {
- *     origin: 'https://myapp.com',
- *     credentials: true
- *   },
- *   bruteForce: {
- *     windowMs: 15 * 60 * 1000,
- *     max: 100
- *   },
- *   routeConfig: {
- *     pathTraversal: {
- *       excludeRoutes: ['/api/templates/*', '/api/content/*']
- *     }
- *   }
- * };
- * ```
- */
-interface XessConfig {
-    /**
-     * Custom list of environment variable keys allowed to bypass the shield.
-     * This will extend or override the default system whitelist.
-     */
-    whitelist?: string[];
-    /**
-     * If true, the custom whitelist will completely replace the built-in system whitelist.
-     * If false, the custom whitelist will merge with (extend) the built-in system whitelist.
-     * @default false
-     */
-    replaceDefaultWhitelist?: boolean;
-}
 interface SecurityConfig {
     /**
      * Strategic route bypass configuration.
@@ -2067,16 +2024,6 @@ interface SecurityConfig {
      * ```
      */
     requestSignature?: boolean | RequestSignatureConfig;
-    /**
-     * XyPriss Environment Security Shield (XESS) Configuration.
-     * Hardens process.env access to protect system stability and prevent secrets leaks.
-     */
-    xess?: XessConfig;
-    /**
-     * Environment Security Shield (XESS) Configuration.
-     * Alias for `xess`.
-     */
-    envShield?: XessConfig;
 }
 /**
  * Encryption configuration interface.
@@ -11196,6 +11143,176 @@ 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;
 
+/**
+ * @file Send.ts
+ * @description Structured HTTP error response helper for the XyPriss framework.
+ *
+ * @copyright Copyright © 2025–2026 NEHONIX. All Rights Reserved.
+ * @license NEHONIX Open Source License v2.0 (NOSL v2)
+ *          https://dll.nehonix.com/licenses/NOSL/v2
+ *
+ * This file is part of a NEHONIX open source project.
+ * You may use, modify, and redistribute it freely — including for commercial
+ * purposes — provided that NEHONIX is always credited as the original author.
+ *
+ * @author NEHONIX
+ */
+
+/**
+ * All HTTP status keys supported by the `Send` helper.
+ * Each key maps to a standard HTTP status code.
+ */
+type SupportedStatus = "BAD_REQUEST" | "NOT_FOUND" | "TOO_MANY_REQUEST" | "INTERNAL_SERVER_ERR";
+/**
+ * Maps every {@link SupportedStatus} key to its corresponding HTTP status code.
+ */
+type ISeConfigs = Record<SupportedStatus, number>;
+/**
+ * Signature shared by all public error-dispatch methods.
+ *
+ * @param message - Human-readable description of the error shown to the API consumer.
+ * @param data    - Optional payload to attach to the response body (e.g. validation details).
+ */
+type TSendPropsFn = (message?: string, data?: unknown) => void;
+/**
+ * Contract that the {@link Send} class must satisfy.
+ * Ensures every supported error type exposes a consistent public API.
+ */
+interface ISeResponder {
+    badRequest: TSendPropsFn;
+    notFound: TSendPropsFn;
+    tooManyRequest: TSendPropsFn;
+    internalError: TSendPropsFn;
+}
+/**
+ * Shape of every JSON response body produced by this helper.
+ *
+ * @property success    - Always `false` for error responses.
+ * @property message    - Human-readable summary of the error.
+ * @property serverName - Identifier of the server that handled the request.
+ * @property data       - Optional payload (echoed from the caller when relevant).
+ * @property details    - Machine-readable error metadata.
+ */
+interface IResTemplate {
+    success: false;
+    message: string;
+    serverName: string;
+    data?: unknown;
+    details: {
+        /** Short error label (e.g. `"Bad Request"`). */
+        error: string;
+        /** Compact error code derived from the status key (e.g. `"EBADR"`). */
+        errorCode: string;
+        /** The HTTP status code that was sent. */
+        statusCode: number;
+    };
+}
+/**
+ * A structured HTTP response helper that standardises all error responses
+ * across the application.
+ *
+ * Every method sends a JSON body conforming to {@link IResTemplate}, ensuring
+ * consistent error shapes for API consumers regardless of where the error
+ * originates.
+ *
+ * @example
+ * ```ts
+ * const send = new Send(res);
+ *
+ * // 400 – validation failure
+ * send.badRequest("The 'email' field is required.");
+ *
+ * // 404 – resource missing
+ * send.notFound("User not found.", { userId: 42 });
+ *
+ * // 429 – rate limit exceeded
+ * send.tooManyRequest("Too many requests. Please slow down.");
+ *
+ * // 500 – unexpected failure
+ * send.internalError("An unexpected error occurred.");
+ * ```
+ */
+declare class Send implements ISeResponder {
+    private readonly res;
+    private readonly configs;
+    private readonly serverName;
+    private readonly includeServerName;
+    /**
+     * Creates a new `Send` instance bound to the given response object.
+     *
+     * @param res     - The active `XyPrisResponse` to write into.
+     * @param configs - Optional override for the default status-code registry.
+     *                  Useful for non-standard or custom HTTP codes.
+     */
+    constructor(res: XyPrisResponse$2, configs?: Partial<{
+        statusCode: Partial<ISeConfigs>;
+        includeServerName: boolean;
+    }>);
+    /**
+     * Resolves the status code, builds the full response body, and flushes it.
+     *
+     * @param statusKey  - One of the {@link SupportedStatus} keys.
+     * @param errorLabel - Human-readable short label for the error type.
+     * @param message    - Optional caller-supplied message; falls back to `errorLabel`.
+     * @param data       - Optional payload to attach to the response body.
+     */
+    private dispatch;
+    /**
+     * Sends a **400 Bad Request** response.
+     *
+     * Use when the client submits a malformed or invalid request
+     * (e.g. missing required fields, invalid format, constraint violation).
+     *
+     * @param message - Human-readable explanation of why the request was rejected.
+     * @param data    - Optional payload (e.g. a list of validation errors per field).
+     *
+     * @example
+     * send.badRequest("The 'username' field must be at least 3 characters.");
+     * send.badRequest("Validation failed.", { fields: { email: "Invalid format" } });
+     */
+    badRequest: TSendPropsFn;
+    /**
+     * Sends a **404 Not Found** response.
+     *
+     * Use when the requested resource does not exist or has been permanently removed.
+     *
+     * @param message - Human-readable explanation of what could not be found.
+     * @param data    - Optional payload (e.g. the identifier that was looked up).
+     *
+     * @example
+     * send.notFound("No user found with id '42'.");
+     * send.notFound("Resource not found.", { id: "42" });
+     */
+    notFound: TSendPropsFn;
+    /**
+     * Sends a **429 Too Many Requests** response.
+     *
+     * Use when the client has exceeded an allowed request rate or quota.
+     * Consider pairing this with a `Retry-After` header at the middleware level.
+     *
+     * @param message - Human-readable explanation of the rate limit breach.
+     * @param data    - Optional payload (e.g. retry delay, remaining quota).
+     *
+     * @example
+     * send.tooManyRequest("Rate limit reached. Try again in 60 seconds.");
+     * send.tooManyRequest("Quota exceeded.", { retryAfter: 60 });
+     */
+    tooManyRequest: TSendPropsFn;
+    /**
+     * Sends a **500 Internal Server Error** response.
+     *
+     * Use for unexpected, unhandled server-side failures.
+     * Avoid leaking internal stack traces or sensitive details in the message.
+     *
+     * @param message - Human-readable explanation safe to expose to the client.
+     * @param data    - Optional payload (use sparingly — never expose raw stack traces).
+     *
+     * @example
+     * send.internalError("An unexpected error occurred. Please try again later.");
+     */
+    internalError: TSendPropsFn;
+}
+
 /**
  * Identifies the project root for a given caller path by traversing up the filesystem.
  */
@@ -11501,5 +11618,5 @@ declare class XStatic {
  */
 declare function Router(): XyPrissRouter;
 
-export { ConfigurationManager as CM, ConfigurationManager as Configs, FileUploadAPI as FLA, FileUploadAPI, Plugin, PluginHookIds, Router, SecurityMiddleware, Upload, XJsonResponseHandler, XStatic, XyGuard, MultiServerApp as XyPMS, XyPrissRouter, XyPrissXHSC, __cfg__, __const__, __sys__, createOptimalCache, createServer, getCallerProjectRoot, getIp, getMime, getMimes, identifyProjectRoot, initializeFileUpload, mergeWithDefaults, mergeWithDefaults as mwdef, quickServer, uploadAny, uploadArray, uploadFields, uploadSingle, xems };
-export type { ArchiveOptions, BatchRenameChange, CacheConfig, FileUploadConfig as FiUpConfig, FileUploadConfig, GetIpResult, IpSource, MonitorSnapshot, MultiServerConfig, NetworkStats, NextFunction, PerformanceConfig, PluginCreator, PluginServer, ProcessInfo, ProcessMonitorSnapshot, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RoutRateLimit, RouteConfig, RouteGuard, RouteMeta, RouteOptions, ParamType as RouteParamType, SecurityConfig, ServerOptions$1 as ServerOptions, XyPrisRequest$1 as XRequest, XyPrisResponse$1 as XResponse, XemsTypes, XyPrisRequest$1 as XyPrisRequest, XyPrisResponse$1 as XyPrisResponse, XyPrissApp, XyPrissPlugin };
+export { ConfigurationManager as CM, ConfigurationManager as Configs, FileUploadAPI as FLA, FileUploadAPI, Plugin, PluginHookIds, Router, SecurityMiddleware, Send, Upload, XJsonResponseHandler, XStatic, XyGuard, MultiServerApp as XyPMS, XyPrissRouter, XyPrissXHSC, __cfg__, __const__, __sys__, createOptimalCache, createServer, getCallerProjectRoot, getIp, getMime, getMimes, identifyProjectRoot, initializeFileUpload, mergeWithDefaults, mergeWithDefaults as mwdef, quickServer, uploadAny, uploadArray, uploadFields, uploadSingle, xems };
+export type { ArchiveOptions, BatchRenameChange, CacheConfig, FileUploadConfig as FiUpConfig, FileUploadConfig, GetIpResult, IResTemplate, ISeConfigs, ISeResponder, IpSource, MonitorSnapshot, MultiServerConfig, NetworkStats, NextFunction, PerformanceConfig, PluginCreator, PluginServer, ProcessInfo, ProcessMonitorSnapshot, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RoutRateLimit, RouteConfig, RouteGuard, RouteMeta, RouteOptions, ParamType as RouteParamType, SecurityConfig, ServerOptions$1 as ServerOptions, SupportedStatus, TSendPropsFn, XyPrisRequest$1 as XRequest, XyPrisResponse$1 as XResponse, XemsTypes, XyPrisRequest$1 as XyPrisRequest, XyPrisResponse$1 as XyPrisResponse, XyPrissApp, XyPrissPlugin };

package/package.json

@@ -68,6 +68,6 @@
     },
     "type": "module",
     "types": "./dist/index.d.ts",
-    "version": "9.10.20"
+    "version": "9.10.22"
 }