exisjs 0.7.5 → 0.7.7

package/dist/response/index.js

@@ -1,19 +1,289 @@
 "use strict";
+// ─── Standard Response Envelope Types ─────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSSEEvent = exports.SSEStream = exports.ExisResponse = exports.HttpStatus = void 0;
+exports.getStatusText = getStatusText;
+exports.isSuccessStatus = isSuccessStatus;
+exports.isRedirectStatus = isRedirectStatus;
+exports.isClientError = isClientError;
+exports.isServerError = isServerError;
 exports.success = success;
+exports.created = created;
+exports.accepted = accepted;
+exports.noContent = noContent;
 exports.error = error;
-function success(data, message) {
+exports.problem = problem;
+exports.paginate = paginate;
+exports.getPaginationSkip = getPaginationSkip;
+exports.json = json;
+exports.redirect = redirect;
+// ─── HTTP Status Codes ────────────────────────────────────────────────────────
+/**
+ * Standard HTTP Status Code Constants.
+ */
+exports.HttpStatus = {
+    // 2xx Success
+    OK: 200,
+    CREATED: 201,
+    ACCEPTED: 202,
+    NON_AUTHORITATIVE_INFORMATION: 203,
+    NO_CONTENT: 204,
+    RESET_CONTENT: 205,
+    PARTIAL_CONTENT: 206,
+    // 3xx Redirection
+    MULTIPLE_CHOICES: 300,
+    MOVED_PERMANENTLY: 301,
+    FOUND: 302,
+    SEE_OTHER: 303,
+    NOT_MODIFIED: 304,
+    TEMPORARY_REDIRECT: 307,
+    PERMANENT_REDIRECT: 308,
+    // 4xx Client Errors
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    PAYMENT_REQUIRED: 402,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    METHOD_NOT_ALLOWED: 405,
+    NOT_ACCEPTABLE: 406,
+    PROXY_AUTHENTICATION_REQUIRED: 407,
+    REQUEST_TIMEOUT: 408,
+    CONFLICT: 409,
+    GONE: 410,
+    LENGTH_REQUIRED: 411,
+    PRECONDITION_FAILED: 412,
+    PAYLOAD_TOO_LARGE: 413,
+    URI_TOO_LONG: 414,
+    UNSUPPORTED_MEDIA_TYPE: 415,
+    RANGE_NOT_SATISFIABLE: 416,
+    EXPECTATION_FAILED: 417,
+    IM_A_TEAPOT: 418,
+    MISDIRECTED_REQUEST: 421,
+    UNPROCESSABLE_ENTITY: 422,
+    LOCKED: 423,
+    FAILED_DEPENDENCY: 424,
+    TOO_EARLY: 425,
+    UPGRADE_REQUIRED: 426,
+    PRECONDITION_REQUIRED: 428,
+    TOO_MANY_REQUESTS: 429,
+    REQUEST_HEADER_FIELDS_TOO_LARGE: 431,
+    UNAVAILABLE_FOR_LEGAL_REASONS: 451,
+    // 5xx Server Errors
+    INTERNAL_SERVER_ERROR: 500,
+    NOT_IMPLEMENTED: 501,
+    BAD_GATEWAY: 502,
+    SERVICE_UNAVAILABLE: 503,
+    GATEWAY_TIMEOUT: 504,
+    HTTP_VERSION_NOT_SUPPORTED: 505,
+    VARIANT_ALSO_NEGOTIATES: 506,
+    INSUFFICIENT_STORAGE: 507,
+    LOOP_DETECTED: 508,
+    NOT_EXTENDED: 510,
+    NETWORK_AUTHENTICATION_REQUIRED: 511,
+};
+const STATUS_TEXT_MAP = {
+    200: 'OK',
+    201: 'Created',
+    202: 'Accepted',
+    204: 'No Content',
+    301: 'Moved Permanently',
+    302: 'Found',
+    304: 'Not Modified',
+    307: 'Temporary Redirect',
+    308: 'Permanent Redirect',
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Not Found',
+    405: 'Method Not Allowed',
+    406: 'Not Acceptable',
+    409: 'Conflict',
+    410: 'Gone',
+    413: 'Payload Too Large',
+    415: 'Unsupported Media Type',
+    422: 'Unprocessable Entity',
+    429: 'Too Many Requests',
+    500: 'Internal Server Error',
+    501: 'Not Implemented',
+    502: 'Bad Gateway',
+    503: 'Service Unavailable',
+    504: 'Gateway Timeout',
+};
+/**
+ * Returns human-readable status text for a given HTTP status code.
+ */
+function getStatusText(status) {
+    return (STATUS_TEXT_MAP[status] ||
+        (status >= 200 && status < 300 ? 'OK' : 'Unknown Status'));
+}
+/**
+ * Determines whether a status code represents a 2xx success.
+ */
+function isSuccessStatus(status) {
+    return status >= 200 && status < 300;
+}
+/**
+ * Determines whether a status code represents a 3xx redirection.
+ */
+function isRedirectStatus(status) {
+    return status >= 300 && status < 400;
+}
+/**
+ * Determines whether a status code represents a 4xx client error.
+ */
+function isClientError(status) {
+    return status >= 400 && status < 500;
+}
+/**
+ * Determines whether a status code represents a 5xx server error.
+ */
+function isServerError(status) {
+    return status >= 500 && status < 600;
+}
+// ─── Response Builders ────────────────────────────────────────────────────────
+/**
+ * Creates a standard 200 OK success response envelope.
+ *
+ * @example
+ * return success(user, 'User profile retrieved successfully')
+ */
+function success(data, message, meta) {
     const res = { success: true, data };
     if (message !== undefined)
         res.message = message;
+    if (meta !== undefined)
+        res.meta = meta;
+    return res;
+}
+/**
+ * Creates a standard 201 Created response envelope.
+ *
+ * @example
+ * return created(newUser, 'User created successfully')
+ */
+function created(data, message = 'Created', meta) {
+    const res = { success: true, data, message };
+    if (meta !== undefined)
+        res.meta = meta;
+    return res;
+}
+/**
+ * Creates a standard 202 Accepted response envelope for async background processing.
+ *
+ * @example
+ * return accepted({ jobId: '123' }, 'Job queued for background execution')
+ */
+function accepted(data = null, message = 'Accepted', meta) {
+    const res = { success: true, data, message };
+    if (meta !== undefined)
+        res.meta = meta;
     return res;
 }
-function error(message, code, details) {
+/**
+ * Creates a standard 204 No Content response representation.
+ *
+ * @example
+ * return noContent()
+ */
+function noContent() {
+    return { success: true, data: null };
+}
+/**
+ * Creates a standard error response envelope.
+ *
+ * @example
+ * return error('Invalid credentials', 'AUTH_INVALID_CREDENTIALS', undefined, 401)
+ */
+function error(message, code, details, status) {
     const res = { success: false, error: { message } };
     if (code !== undefined)
         res.error.code = code;
     if (details !== undefined)
         res.error.details = details;
+    if (status !== undefined)
+        res.error.status = status;
     return res;
 }
+/**
+ * Creates a standardized RFC 7807 / RFC 9457 Problem Details object.
+ *
+ * @example
+ * return problem('Invalid Request Body', 422, 'The email field is invalid', {
+ *   invalidParams: [{ name: 'email', reason: 'Must be a valid email format' }]
+ * })
+ */
+function problem(title, status, detail, options = {}) {
+    return {
+        title,
+        status,
+        ...(detail ? { detail } : {}),
+        ...options,
+    };
+}
+/**
+ * Creates a standardized paginated response envelope.
+ *
+ * @example
+ * return paginate(users, totalCount, { page: 1, limit: 20 })
+ */
+function paginate(data, total, options = {}, message, meta) {
+    const page = Math.max(1, Number(options.page) || 1);
+    const limit = Math.max(1, Number(options.limit) || 20);
+    const totalPages = Math.ceil(total / limit);
+    const hasNext = page < totalPages;
+    const hasPrev = page > 1;
+    const res = {
+        success: true,
+        data,
+        pagination: {
+            page,
+            limit,
+            total,
+            totalPages,
+            hasNextPage: hasNext,
+            hasPrevPage: hasPrev,
+            hasNext,
+            hasPrev,
+        },
+    };
+    if (message !== undefined)
+        res.message = message;
+    if (meta !== undefined)
+        res.meta = meta;
+    return res;
+}
+/**
+ * Calculates SQL/Database `skip` (offset) and `limit` from pagination query parameters.
+ *
+ * @example
+ * const { skip, limit, page } = getPaginationSkip(req.query)
+ * const users = await db.user.findMany({ skip, take: limit })
+ */
+function getPaginationSkip(query = {}) {
+    const page = Math.max(1, Number(query.page) || 1);
+    const limit = Math.max(1, Number(query.limit) || 20);
+    return {
+        skip: (page - 1) * limit,
+        limit,
+        page,
+    };
+}
+/**
+ * Helper to build custom JSON payload structure with optional status code and headers hint.
+ */
+function json(data, status = 200, headers = {}) {
+    return { data, status, headers };
+}
+/**
+ * Helper to create a redirection descriptor.
+ */
+function redirect(url, status = 302) {
+    return { redirect: url, status };
+}
+// ─── Direct Re-exports ────────────────────────────────────────────────────────
+var response_1 = require("../server/response");
+Object.defineProperty(exports, "ExisResponse", { enumerable: true, get: function () { return response_1.ExisResponse; } });
+var sse_1 = require("../server/sse");
+Object.defineProperty(exports, "SSEStream", { enumerable: true, get: function () { return sse_1.SSEStream; } });
+Object.defineProperty(exports, "formatSSEEvent", { enumerable: true, get: function () { return sse_1.formatSSEEvent; } });
 //# sourceMappingURL=index.js.map

package/dist/response/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/response/index.ts"],"names":[],"mappings":";;AAeA,0BAIC;AAED,sBASC;AAfD,SAAgB,OAAO,CAAI,IAAO,EAAE,OAAgB;IAClD,MAAM,GAAG,GAAuB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACvD,IAAI,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;IAChD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAgB,KAAK,CACnB,OAAe,EACf,IAAa,EACb,OAAiB;IAEjB,MAAM,GAAG,GAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,CAAA;IACjE,IAAI,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;IAC7C,IAAI,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;IACtD,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/response/index.ts"],"names":[],"mappings":";AAAA,iFAAiF;;;AAqLjF,sCAKC;AAKD,0CAEC;AAKD,4CAEC;AAKD,sCAEC;AAKD,sCAEC;AAUD,0BASC;AAQD,0BAQC;AAQD,4BAQC;AAQD,8BAEC;AAQD,sBAWC;AAUD,0BAYC;AAQD,4BAgCC;AASD,8CAcC;AAKD,oBAMC;AAKD,4BAKC;AAlUD,iFAAiF;AAEjF;;GAEG;AACU,QAAA,UAAU,GAAG;IACxB,cAAc;IACd,EAAE,EAAE,GAAG;IACP,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,6BAA6B,EAAE,GAAG;IAClC,UAAU,EAAE,GAAG;IACf,aAAa,EAAE,GAAG;IAClB,eAAe,EAAE,GAAG;IAEpB,kBAAkB;IAClB,gBAAgB,EAAE,GAAG;IACrB,iBAAiB,EAAE,GAAG;IACtB,KAAK,EAAE,GAAG;IACV,SAAS,EAAE,GAAG;IACd,YAAY,EAAE,GAAG;IACjB,kBAAkB,EAAE,GAAG;IACvB,kBAAkB,EAAE,GAAG;IAEvB,oBAAoB;IACpB,WAAW,EAAE,GAAG;IAChB,YAAY,EAAE,GAAG;IACjB,gBAAgB,EAAE,GAAG;IACrB,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,GAAG;IACd,kBAAkB,EAAE,GAAG;IACvB,cAAc,EAAE,GAAG;IACnB,6BAA6B,EAAE,GAAG;IAClC,eAAe,EAAE,GAAG;IACpB,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,GAAG;IACT,eAAe,EAAE,GAAG;IACpB,mBAAmB,EAAE,GAAG;IACxB,iBAAiB,EAAE,GAAG;IACtB,YAAY,EAAE,GAAG;IACjB,sBAAsB,EAAE,GAAG;IAC3B,qBAAqB,EAAE,GAAG;IAC1B,kBAAkB,EAAE,GAAG;IACvB,WAAW,EAAE,GAAG;IAChB,mBAAmB,EAAE,GAAG;IACxB,oBAAoB,EAAE,GAAG;IACzB,MAAM,EAAE,GAAG;IACX,iBAAiB,EAAE,GAAG;IACtB,SAAS,EAAE,GAAG;IACd,gBAAgB,EAAE,GAAG;IACrB,qBAAqB,EAAE,GAAG;IAC1B,iBAAiB,EAAE,GAAG;IACtB,+BAA+B,EAAE,GAAG;IACpC,6BAA6B,EAAE,GAAG;IAElC,oBAAoB;IACpB,qBAAqB,EAAE,GAAG;IAC1B,eAAe,EAAE,GAAG;IACpB,WAAW,EAAE,GAAG;IAChB,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,GAAG;IACpB,0BAA0B,EAAE,GAAG;IAC/B,uBAAuB,EAAE,GAAG;IAC5B,oBAAoB,EAAE,GAAG;IACzB,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,GAAG;IACjB,+BAA+B,EAAE,GAAG;CAC5B,CAAA;AAIV,MAAM,eAAe,GAA2B;IAC9C,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,iBAAiB;CACvB,CAAA;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,MAAc;IAC1C,OAAO,CACL,eAAe,CAAC,MAAM,CAAC;QACvB,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAC1D,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAc;IAC7C,OAAO,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAA;AACtC,CAAC;AAED,iFAAiF;AAEjF;;;;;GAKG;AACH,SAAgB,OAAO,CACrB,IAAO,EACP,OAAgB,EAChB,IAAQ;IAER,MAAM,GAAG,GAA0B,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAC1D,IAAI,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;IAChD,IAAI,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACvC,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,OAAO,CACrB,IAAO,EACP,OAAO,GAAG,SAAS,EACnB,IAAQ;IAER,MAAM,GAAG,GAA0B,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACnE,IAAI,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACvC,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CACtB,OAAU,IAAoB,EAC9B,OAAO,GAAG,UAAU,EACpB,IAAQ;IAER,MAAM,GAAG,GAA0B,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACnE,IAAI,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACvC,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS;IACvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACtC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,KAAK,CACnB,OAAe,EACf,IAAa,EACb,OAAW,EACX,MAAe;IAEf,MAAM,GAAG,GAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,CAAA;IACpE,IAAI,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;IAC7C,IAAI,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;IACtD,IAAI,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAA;IACnD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,OAAO,CACrB,KAAa,EACb,MAAc,EACd,MAAe,EACf,UAAmC,EAAE;IAErC,OAAO;QACL,KAAK;QACL,MAAM;QACN,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,OAAO;KACX,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CACtB,IAAS,EACT,KAAa,EACb,UAA6C,EAAE,EAC/C,OAAgB,EAChB,IAAQ;IAER,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAA;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,UAAU,CAAA;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAA;IAExB,MAAM,GAAG,GAA4B;QACnC,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,UAAU,EAAE;YACV,IAAI;YACJ,KAAK;YACL,KAAK;YACL,UAAU;YACV,WAAW,EAAE,OAAO;YACpB,WAAW,EAAE,OAAO;YACpB,OAAO;YACP,OAAO;SACR;KACF,CAAA;IAED,IAAI,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;IAChD,IAAI,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IAEvC,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,QAA2C,EAAE;IAM7C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACpD,OAAO;QACL,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK;QACxB,KAAK;QACL,IAAI;KACL,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,IAAI,CAClB,IAAO,EACP,MAAM,GAAG,GAAG,EACZ,UAA2B,EAAE;IAE7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CACtB,GAAW,EACX,MAAM,GAAG,GAAG;IAEZ,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;AAClC,CAAC;AAED,iFAAiF;AAEjF,+CAAiD;AAAxC,wGAAA,YAAY,OAAA;AACrB,qCAKsB;AAJpB,gGAAA,SAAS,OAAA;AACT,qGAAA,cAAc,OAAA"}

package/dist/router/boundary.d.ts

@@ -11,16 +11,16 @@ export interface BoundaryExcludeRule {
     methods?: HttpMethod[];
     method?: HttpMethod;
 }
-export interface BoundaryConfig {
+export interface BoundaryConfig<TContext = Record<string, any>> {
     /**
      * Middleware to apply to all routes in this directory and subdirectories.
      * Replaces the old router.use() globally for a folder.
      */
-    middleware?: Handler[] | Handler;
+    middleware?: Handler<any, any, any, any, TContext>[] | Handler<any, any, any, any, TContext>;
     /**
      * Alias for `middleware`. Supports plural naming.
      */
-    middlewares?: Handler[] | Handler;
+    middlewares?: Handler<any, any, any, any, TContext>[] | Handler<any, any, any, any, TContext>;
     /**
      * CORS configuration applied to all routes in this directory and subdirectories.
      */
@@ -62,27 +62,57 @@ export interface BoundaryConfig {
      * Folder-scoped request timeout (in milliseconds).
      * Can be a static number or a dynamic function evaluated per-request.
      */
-    timeout?: number | ((req: import('../types').Request<any, any, any>) => number | undefined);
+    timeout?: number | ((req: import('../types').Request<any, any, any, TContext>) => number | undefined);
     /**
      * Cascading metadata (e.g., OpenAPI tags, roles) applied to all routes in this directory.
      */
     metadata?: Record<string, any>;
+    /**
+     * Opt-in security scanner noise suppression & exploit probe blocker.
+     * Intercepts automated vulnerability scanner probes (e.g. `/.env`, `/.git`, `/.DS_Store`)
+     * and blackholes them immediately without running downstream handlers or flooding error logs.
+     */
+    blockProbes?: boolean | import('../middleware/security').BlockProbesOptions;
+    blockSuspiciousProbes?: boolean | import('../middleware/security').BlockProbesOptions;
     /**
      * Hook executed immediately before any route handler in this boundary.
      * Can short-circuit execution by returning `false` or sending a response directly.
      */
-    beforeHandle?: BoundaryBeforeHandleHook | BoundaryBeforeHandleHook[];
+    beforeHandle?: BoundaryBeforeHandleHook<TContext> | BoundaryBeforeHandleHook<TContext>[];
     /**
      * Hook executed immediately after a route handler in this boundary successfully returns.
      * Receives `(req, res, data)` and can transform the outgoing payload or perform audit logging.
      */
-    afterHandle?: BoundaryAfterHandleHook | BoundaryAfterHandleHook[];
+    afterHandle?: BoundaryAfterHandleHook<any, TContext> | BoundaryAfterHandleHook<any, TContext>[];
 }
-export type BoundaryBeforeHandleHook = (req: import('../types').Request<any, any, any>, res: import('../types').Response) => void | boolean | Promise<void | boolean>;
-export type BoundaryAfterHandleHook<T = any> = (req: import('../types').Request<any, any, any>, res: import('../types').Response, data?: T) => void | any | Promise<void | any>;
+export type { BlockProbesOptions } from '../middleware/security';
+export type BoundaryBeforeHandleHook<TContext = Record<string, any>> = (req: import('../types').Request<any, any, any, TContext>, res: import('../types').Response) => void | boolean | Promise<void | boolean>;
+export type BoundaryAfterHandleHook<T = any, TContext = Record<string, any>> = (req: import('../types').Request<any, any, any, TContext>, res: import('../types').Response, data?: T) => void | any | Promise<void | any>;
 /**
- * Defines a boundary that acts as folder-scoped config + request pipeline for
- * everything in this directory and subdirectories.
+ * Defines a boundary configuration that acts as a folder-scoped request pipeline
+ * for all routes in its directory and subdirectories.
+ *
+ * @param config Boundary options (middleware, guards, interceptors, CORS, hooks, exclusions)
+ * @returns Strongly typed `BoundaryConfig`
+ *
+ * @example
+ * ```ts
+ * // src/http/api/admin/boundary.ts
+ * export default defineBoundary({
+ *   guards: [AdminGuard],
+ *   cors: { origin: 'https://admin.example.com' },
+ *   beforeHandle(req, res) {
+ *     if (!req.user) {
+ *       res.status(401).json({ error: 'Unauthorized' })
+ *       return false // halts execution
+ *     }
+ *   },
+ *   afterHandle(req, res, data) {
+ *     // Audit logging / payload wrapping
+ *     return { data, timestamp: Date.now() }
+ *   }
+ * })
+ * ```
  */
-export declare function defineBoundary(config: BoundaryConfig): BoundaryConfig;
+export declare function defineBoundary<TContext = Record<string, any>>(config: BoundaryConfig<TContext>): BoundaryConfig<TContext>;
 //# sourceMappingURL=boundary.d.ts.map

package/dist/router/boundary.d.ts.map

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

package/dist/router/boundary.js

@@ -2,8 +2,30 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defineBoundary = defineBoundary;
 /**
- * Defines a boundary that acts as folder-scoped config + request pipeline for
- * everything in this directory and subdirectories.
+ * Defines a boundary configuration that acts as a folder-scoped request pipeline
+ * for all routes in its directory and subdirectories.
+ *
+ * @param config Boundary options (middleware, guards, interceptors, CORS, hooks, exclusions)
+ * @returns Strongly typed `BoundaryConfig`
+ *
+ * @example
+ * ```ts
+ * // src/http/api/admin/boundary.ts
+ * export default defineBoundary({
+ *   guards: [AdminGuard],
+ *   cors: { origin: 'https://admin.example.com' },
+ *   beforeHandle(req, res) {
+ *     if (!req.user) {
+ *       res.status(401).json({ error: 'Unauthorized' })
+ *       return false // halts execution
+ *     }
+ *   },
+ *   afterHandle(req, res, data) {
+ *     // Audit logging / payload wrapping
+ *     return { data, timestamp: Date.now() }
+ *   }
+ * })
+ * ```
  */
 function defineBoundary(config) {
     return config;

package/dist/router/boundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"boundary.js","sourceRoot":"","sources":["../../src/router/boundary.ts"],"names":[],"mappings":";;AAsHA,wCAEC;AAND;;;GAGG;AACH,SAAgB,cAAc,CAAC,MAAsB;IACnD,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"boundary.js","sourceRoot":"","sources":["../../src/router/boundary.ts"],"names":[],"mappings":";;AAgKA,wCAIC;AA9BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,cAAc,CAC5B,MAAgC;IAEhC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/router/controller-registrar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller-registrar.d.ts","sourceRoot":"","sources":["../../src/router/controller-registrar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AAGxC,qBAAa,mBAAmB;IAClB,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC;IAI1B,mBAAmB,CACxB,WAAW,EAAE,GAAG,EAAE,EAClB,QAAQ,SAAK,EACb,iBAAiB,GAAE,GAAG,EAAO,GAC5B,GAAG,CAAC,GAAG,CAAC;IAIX,OAAO,CAAC,oBAAoB;CAyb7B"}
+{"version":3,"file":"controller-registrar.d.ts","sourceRoot":"","sources":["../../src/router/controller-registrar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AAGxC,qBAAa,mBAAmB;IAClB,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC;IAI1B,mBAAmB,CACxB,WAAW,EAAE,GAAG,EAAE,EAClB,QAAQ,SAAK,EACb,iBAAiB,GAAE,GAAG,EAAO,GAC5B,GAAG,CAAC,GAAG,CAAC;IAIX,OAAO,CAAC,oBAAoB;CAoiB7B"}

package/dist/router/controller-registrar.js

@@ -191,6 +191,30 @@ class ControllerRegistrar {
                                             rawArg = isMulti ? files : files[0];
                                         }
                                         break;
+                                    case 'cookies':
+                                    case 'cookie':
+                                        rawArg = param.name
+                                            ? req.cookies?.[param.name]
+                                            : req.cookies;
+                                        break;
+                                    case 'state': {
+                                        const storeState = context_1.executionContext.getStore()?.state;
+                                        const reqState = req.state;
+                                        const stateObj = {
+                                            ...(storeState || {}),
+                                            ...(reqState || {}),
+                                        };
+                                        rawArg = param.name ? stateObj[param.name] : stateObj;
+                                        break;
+                                    }
+                                    case 'app':
+                                        rawArg = this.app;
+                                        break;
+                                    case 'fields':
+                                        rawArg = param.name
+                                            ? req.fields?.[param.name]
+                                            : req.fields;
+                                        break;
                                     case 'customParam':
                                         if (typeof param.customFactory === 'function') {
                                             const executionCtx = {
@@ -284,7 +308,20 @@ class ControllerRegistrar {
                                 res.status(routeMeta.httpCode);
                             }
                             if (result !== undefined) {
-                                res.json(result);
+                                if (result &&
+                                    (typeof result.pipe === 'function' ||
+                                        (typeof result.getReader === 'function' &&
+                                            typeof result.tee === 'function') ||
+                                        (typeof result[Symbol.asyncIterator] === 'function' &&
+                                            !Array.isArray(result)))) {
+                                    ;
+                                    res.sendStream(result);
+                                }
+                                else if (!(result &&
+                                    typeof result.send === 'function' &&
+                                    typeof result.onClose === 'function')) {
+                                    res.json(result);
+                                }
                             }
                         }
                     }
@@ -300,13 +337,26 @@ class ControllerRegistrar {
                                 let filterInstance = this.app.container.resolve(filter);
                                 if (!filterInstance)
                                     filterInstance = new filter();
-                                await filterInstance.catch(err, { req, res });
+                                await filterInstance.catch(err, { req, res, next });
                                 handled = true;
                                 break;
                             }
                             else if (typeof filter === 'object' &&
                                 typeof filter.catch === 'function') {
-                                await filter.catch(err, { req, res });
+                                await filter.catch(err, { req, res, next });
+                                handled = true;
+                                break;
+                            }
+                            else if (typeof filter === 'function') {
+                                if (filter.length >= 3) {
+                                    await filter(err, req, res, next);
+                                }
+                                else if (filter.length === 2) {
+                                    await filter(err, { req, res, next });
+                                }
+                                else {
+                                    await filter(err);
+                                }
                                 handled = true;
                                 break;
                             }
@@ -343,6 +393,8 @@ class ControllerRegistrar {
                 const paramMetadata = paramMetadataMap[route.handlerName] || [];
                 let extractedBodySchema = undefined;
                 let extractedQuerySchema = undefined;
+                let extractedParamsSchema = undefined;
+                let extractedHeadersSchema = undefined;
                 for (const param of paramMetadata) {
                     if (!param)
                         continue;
@@ -356,13 +408,44 @@ class ControllerRegistrar {
                         if (queryPipe)
                             extractedQuerySchema = queryPipe;
                     }
+                    if (param.type === 'param') {
+                        const paramPipe = param.pipes?.find((p) => p && typeof p.parse === 'function');
+                        if (paramPipe)
+                            extractedParamsSchema = paramPipe;
+                    }
+                    if (param.type === 'header') {
+                        const headerPipe = param.pipes?.find((p) => p && typeof p.parse === 'function');
+                        if (headerPipe)
+                            extractedHeadersSchema = headerPipe;
+                    }
                 }
                 const extractedResponseSchema = routeMeta.responseSchema;
+                const classOpenApi = ControllerClass[Symbol.for('exisjs:openapi_class_meta')] ||
+                    {};
+                const mergedTags = [
+                    ...(classOpenApi.tags || []),
+                    ...(routeMeta.tags || []),
+                ];
+                const mergedSecurity = [
+                    ...(classOpenApi.security || []),
+                    ...(routeMeta.security || []),
+                ];
                 if (schema ||
                     finalHost ||
                     extractedBodySchema ||
                     extractedQuerySchema ||
-                    extractedResponseSchema) {
+                    extractedParamsSchema ||
+                    extractedHeadersSchema ||
+                    extractedResponseSchema ||
+                    mergedTags.length > 0 ||
+                    mergedSecurity.length > 0 ||
+                    routeMeta.summary ||
+                    routeMeta.description ||
+                    routeMeta.operationId ||
+                    routeMeta.deprecated !== undefined ||
+                    routeMeta.responses ||
+                    routeMeta.excludeFromDocs ||
+                    classOpenApi.excludeFromDocs) {
                     schema = schema || {};
                     if (finalHost)
                         schema.host = finalHost;
@@ -370,8 +453,29 @@ class ControllerRegistrar {
                         schema.body = extractedBodySchema;
                     if (extractedQuerySchema && !schema.query)
                         schema.query = extractedQuerySchema;
+                    if (extractedParamsSchema && !schema.params)
+                        schema.params = extractedParamsSchema;
+                    if (extractedHeadersSchema && !schema.headers)
+                        schema.headers = extractedHeadersSchema;
                     if (extractedResponseSchema && !schema.response)
                         schema.response = extractedResponseSchema;
+                    if (mergedTags.length > 0 && !schema.tags)
+                        schema.tags = mergedTags;
+                    if (mergedSecurity.length > 0 && !schema.security)
+                        schema.security = mergedSecurity;
+                    if (routeMeta.summary && !schema.summary)
+                        schema.summary = routeMeta.summary;
+                    if (routeMeta.description && !schema.description)
+                        schema.description = routeMeta.description;
+                    if (routeMeta.operationId && !schema.operationId)
+                        schema.operationId = routeMeta.operationId;
+                    if (routeMeta.deprecated !== undefined &&
+                        schema.deprecated === undefined)
+                        schema.deprecated = routeMeta.deprecated;
+                    if (routeMeta.responses && !schema.responses)
+                        schema.responses = routeMeta.responses;
+                    if (routeMeta.excludeFromDocs || classOpenApi.excludeFromDocs)
+                        schema.excludeFromDocs = true;
                     this.app.router[method](fullPath, ...allMiddlewares, schema, finalHandler);
                 }
                 else {