@andrewcaires/express 2.1.0 → 2.1.1

package/dist/index.cjs.js

@@ -1,7 +1,7 @@
 /*!
- * @andrewcaires/express v2.1.0
+ * @andrewcaires/express v2.1.1
  * Decorators for express
  * (c) 2026 Andrew Caires
  * @license: MIT
  */
-"use strict";var e=require("@andrewcaires/decorator"),t=require("@andrewcaires/node"),s=require("@andrewcaires/utils.js"),r=require("compression"),o=require("cookie-parser"),i=require("cors"),n=require("express"),a=require("express-session"),u=require("fs"),l=require("http"),d=require("https"),p=require("net"),h=require("path"),E=require("request-ip"),c=require("multer");function _(e){var t=Object.create(null);return e&&Object.keys(e).forEach(function(s){if("default"!==s){var r=Object.getOwnPropertyDescriptor(e,s);Object.defineProperty(t,s,r.get?r:{enumerable:!0,get:function(){return e[s]}})}}),t.default=e,Object.freeze(t)}var T=_(l),O=_(d);function v(e,t,s,r){return new(s||(s=Promise))(function(o,i){function n(e){try{u(r.next(e))}catch(e){i(e)}}function a(e){try{u(r.throw(e))}catch(e){i(e)}}function u(e){var t;e.done?o(e.value):(t=e.value,t instanceof s?t:new s(function(e){e(t)})).then(n,a)}u((r=r.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;class R{}R.CONTINUE=100,R.SWITCHING_PROTOCOLS=101,R.PROCESSING=102,R.OK=200,R.CREATED=201,R.ACCEPTED=202,R.NON_AUTHORITATIVE_INFORMATION=203,R.NO_CONTENT=204,R.RESET_CONTENT=205,R.PARTIAL_CONTENT=206,R.MULTI_STATUS=207,R.ALREADY_REPORTED=208,R.IM_USED=226,R.MULTIPLE_CHOICES=300,R.MOVED_PERMANENTLY=301,R.FOUND=302,R.SEE_OTHER=303,R.NOT_MODIFIED=304,R.USE_PROXY=305,R.TEMPORARY_REDIRECT=307,R.PERMANENT_REDIRECT=308,R.BAD_REQUEST=400,R.UNAUTHORIZED=401,R.PAYMENT_REQUIRED=402,R.FORBIDDEN=403,R.NOT_FOUND=404,R.METHOD_NOT_ALLOWED=405,R.NOT_ACCEPTABLE=406,R.PROXY_AUTHENTICATION_REQUIRED=407,R.REQUEST_TIMEOUT=408,R.CONFLICT=409,R.GONE=410,R.LENGTH_REQUIRED=411,R.PRECONDITION_FAILED=412,R.PAYLOAD_TOO_LARGE=413,R.REQUEST_URI_TOO_LONG=414,R.UNSUPPORTED_MEDIA_TYPE=415,R.REQUESTED_RANGE_NOT_SATISFIABLE=416,R.EXPECTATION_FAILED=417,R.IM_A_TEAPOT=418,R.MISDIRECTED_REQUEST=421,R.UNPROCESSABLE_ENTITY=422,R.LOCKED=423,R.FAILED_DEPENDENCY=424,R.UPGRADE_REQUIRED=426,R.PRECONDITION_REQUIRED=428,R.TOO_MANY_REQUESTS=429,R.REQUEST_HEADER_FIELDS_TOO_LARGE=431,R.CONNECTION_CLOSED_WITHOUT_RESPONSE=444,R.UNAVAILABLE_FOR_LEGAL_REASONS=451,R.CLIENT_CLOSED_REQUEST=499,R.INTERNAL_SERVER_ERROR=500,R.NOT_IMPLEMENTED=501,R.BAD_GATEWAY=502,R.SERVICE_UNAVAILABLE=503,R.GATEWAY_TIMEOUT=504,R.HTTP_VERSION_NOT_SUPPORTED=505,R.VARIANT_ALSO_NEGOCIATES=506,R.INSUFFICIENT_STORAGE=507,R.LOOP_DETECTED=508,R.NOT_EXTENDED=510,R.NETWORK_AUTHENTICATION_REQUIRED=511,R.NETWORK_CONNECTION_TIMEOUT_ERROR=599;class m extends Error{constructor(e,t=R.INTERNAL_SERVER_ERROR){super(e),this.status=t}}class N extends m{constructor(e){super(e,R.UNPROCESSABLE_ENTITY)}}class x{constructor(e,t,s,r,o){this.storage={},this.req=e,this.res=t,this.next=s,this.app=r,this.controller=o}cache(e){const t=Object.assign({},e),r=[];t.private?r.push("private"):t.public&&r.push("public"),t.noStore&&(t.noCache=!0,r.push("no-store")),t.noCache&&(t.maxAge=0,delete t.sMaxAge,r.push("no-cache")),t.noTransform&&r.push("no-transform"),t.proxyRevalidate&&r.push("proxy-revalidate"),t.mustRevalidate?r.push("must-revalidate"):t.noCache||(s.isNumber(t.staleIfError)&&r.push(`stale-if-error=${t.staleIfError}`),s.isNumber(t.staleWhileRevalidate)&&r.push(`stale-while-revalidate=${t.staleWhileRevalidate}`)),s.isNumber(t.maxAge)&&r.push(`max-age=${t.maxAge}`),s.isNumber(t.sMaxAge)&&r.push(`s-maxage=${t.sMaxAge}`),r.length&&(this.res.setHeader("Cache-Control",r.join(",")),t.noCache&&s.forEachKey({"Surrogate-Control":"no-store",Pragma:"no-cache",ETag:"false",Expires:"0"},(e,t)=>this.res.setHeader(t,e)))}clearCookie(e,t){this.res.clearCookie(e,t)}close(e){this.isResponded()||this.res.json(null!=e?e:this.storage)}destroy(e){var t;e&&this.error(e),null===(t=this.res.socket)||void 0===t||t.destroy(e)}error(e){var t;let s=null!==(t=e.toString())&&void 0!==t?t:"",r=R.INTERNAL_SERVER_ERROR;e instanceof Error&&(s=e.message,e instanceof m&&(r=e.status)),this.send(r,{error:s})}file(e){this.isResponded()||(this.status(R.OK),this.res.sendFile(h.resolve(e)))}getBody(){var e,t;return null!==(t=null===(e=this.req)||void 0===e?void 0:e.body)&&void 0!==t?t:{}}getBodyValue(e){var t;return null===(t=this.req.body)||void 0===t?void 0:t[e]}getCookie(e){var t;return this.normalize(null===(t=this.req.cookies)||void 0===t?void 0:t[e])}getCookies(){var e,t;return s.map(null!==(t=null===(e=this.req)||void 0===e?void 0:e.cookies)&&void 0!==t?t:{},e=>this.normalize(e))}getFiles(){var e,t;return null!==(t=null===(e=this.req)||void 0===e?void 0:e.files)&&void 0!==t?t:{}}getHeader(e){var t;return this.normalize(null===(t=this.req.headers)||void 0===t?void 0:t[e])}getHeaders(){var e,t;return s.map(null!==(t=null===(e=this.req)||void 0===e?void 0:e.headers)&&void 0!==t?t:{},e=>this.normalize(e))}getIp(){return E.getClientIp(this.req)||"0.0.0.0"}getQuery(e){var t;return this.normalize(null===(t=this.req.query)||void 0===t?void 0:t[e])}getQueries(){var e,t;return s.map(null!==(t=null===(e=this.req)||void 0===e?void 0:e.query)&&void 0!==t?t:{},e=>this.normalize(e))}getParam(e){var t;const r=null===(t=this.req.params)||void 0===t?void 0:t[e];return s.isUndefined(r)?void 0:String(r)}getParams(){var e,t;return s.map(null!==(t=null===(e=this.req)||void 0===e?void 0:e.params)&&void 0!==t?t:{},e=>{if(!s.isUndefined(e)&&!s.isNull(e))return String(e)})}getUrl(){return`${this.req.protocol}://${this.req.get("host")}${this.req.originalUrl}`}isResponded(){return this.res.headersSent||this.res.writableEnded}json(e){this.send(R.OK,e)}normalize(e){if(!s.isUndefined(e)&&!s.isNull(e))return s.isObject(e)?JSON.stringify(e):String(e)}prepare(e,t){this.isResponded()||(this.status(e),this.storage=t)}send(e,t){this.isResponded()||(this.status(e),204===e||304===e||s.isUndefined(t)?this.res.end():this.res.json(t))}setCookie(e,t,s){this.res.cookie(e,t,null!=s?s:{})}status(e){return s.isUndefined(e)||this.res.status(e),this.res.statusCode}success(e){this.send(R.OK,{message:e})}}class A{static extends(t){return e.metadata(A.EXTENDS,t,[])}static middleware(t){return e.metadata(A.MIDDLEWARE,t,[])}static parameters(t){return e.metadata(A.PARAMETERS,t,[])}static path(t,s){return e.metadata(A.PATH,t,s)}static routers(t){return e.metadata(A.ROUTERS,t,[])}}A.EXTENDS=Symbol("EXTENDS"),A.MIDDLEWARE=Symbol("MIDDLEWARE"),A.PARAMETERS=Symbol("PARAMETERS"),A.PATH=Symbol("PATH"),A.ROUTERS=Symbol("ROUTERS");class g extends s.EventEmitter{get controllers(){return this._controllers}get instance(){return this._app}get router(){return this._router}get server(){return this._server}constructor(t,l){var d,p;super(),this._app=n(),this._options={},this._base=n.Router(),this._router=n.Router(),this._controllers=[],this._controllers.push(...t.map(t=>s.isConstructor(t)?new t(...e.getInjectionArgs(t)):t)),this._options=s.merge({},{cross:!1,hybrid:!1,path:"/",port:3e3,session:{secret:"yoursecret",resave:!0,saveUninitialized:!1,cookie:{maxAge:864e5}}},null!=l?l:{}),this._app.use(n.json(this._options.json)),this._app.disable("x-powered-by"),this._app.use(n.urlencoded({extended:!0})),this._options.cross&&this._app.use(i(s.isObject(this._options.cross)?this._options.cross:{})),this._app.use(r(this._options.compression)),this._app.use(o(null===(d=this._options.cookie)||void 0===d?void 0:d.secret,this._options.cookie)),this._app.use(a(this._options.session)),this.init(),this._app.use(this._router);const E=(null===(p=this._options.path)||void 0===p?void 0:p.length)?this._options.path:"/";if(this._app.use(E,this._base),this._app.all(E+"/*path",(e,t)=>{this._options.redirect?t.redirect(this._options.redirect):(t.status(R.NOT_FOUND),t.json({message:"INVALID API"}))}),this._options.public){const e=h.resolve(this._options.public);u.existsSync(e)&&this._app.use(n.static(e)),this._app.get("*path",(t,s)=>{u.existsSync(e)?s.sendFile(e+"/index.html"):this._options.notfound?s.redirect(this._options.notfound):(s.status(R.NOT_FOUND),s.json({message:'FILE "index.html" NOT FOUND'}))})}else this._app.all("*path",(e,t)=>{this._options.redirect?t.redirect(this._options.redirect):(t.status(R.NOT_FOUND),t.json({message:"INVALID API"}))});this._controllers.forEach(e=>{const t=n.Router(),r=this._middlewares(e),o=A.parameters(e);this._extends(e).forEach(e=>{r.push(...this._middlewares(e)),o.push(...A.parameters(e))}),A.routers(e).forEach(i=>{const n=i.propertyKey.toString();if(s.isFunction(e[n])){if(!s.isFunction(t[i.method]))return this._notFound(i.method);const a=this._handles(e,n,r,o);return t[i.method](i.path,...a,(t,r,i)=>v(this,void 0,void 0,function*(){const a=new x(t,r,i,this,e),u=this._args(a,this._indexes(n,o)),l=yield e[n](...u);a.close(s.isArray(l)||s.isObject(l)?l:void 0)}))}this._notFound(`${e.name}.${n}`)}),this._extends(e).forEach(i=>{A.routers(i).forEach(i=>{const n=i.propertyKey.toString();if(s.isFunction(e[n])){if(!s.isFunction(t[i.method]))return this._notFound(i.method);const a=this._handles(e,n,r,o);return t[i.method](i.path,...a,(t,r,i)=>v(this,void 0,void 0,function*(){const a=new x(t,r,i,this,e),u=this._args(a,this._indexes(n,o)),l=yield e[n](...u);a.close(s.isArray(l)||s.isObject(l)?l:void 0)}))}this._notFound(`${e.constructor.name}.${n}`)})}),this._base.use(A.path(e,"/"),t)})}init(){}error(e,s){t.Log.error(e)}log(e,s){t.Log.info(e)}_args(e,t,s){const r=[],o={ctx:e,key:"",app:this,argument:s};return t.forEach(e=>{r[e.parameterIndex]=e.callback(Object.assign(Object.assign({},o),{key:e.key}))}),r}_handles(e,t,r,o){return r.filter(e=>e.propertyKey==t).map(t=>{if(t.callback!=s.noop){const r=this._indexes(t.method,o);return(o,i,n)=>v(this,void 0,void 0,function*(){const a=new x(o,i,n,this,e),u=s.isFunction(t.argument)?t.argument(a):t.argument,l=yield t.callback.call(e,...this._args(a,r,u));(s.isArray(l)||s.isObject(l))&&a.close(l)})}this._notFound(t.method)}).filter(s.isFunction)}_extends(e){return A.extends(e).reduce((e,t)=>(e.push(t,...this._extends(t)),e),[]).filter((e,t,s)=>s.indexOf(e)===t)}_indexes(e,t){return t.filter(t=>t.propertyKey==e)}_middlewares(e){return[...A.middleware(e)].reverse()}_notFound(e){this.error(new Error(`Router "${e}" not found`),"express")}_port(e){return`Server listening on port ${e}`}listen(){return v(this,void 0,void 0,function*(){if(this._options.cert&&this._options.key||(this._server=T.createServer(this._app),this._server.listen(this._options.port,()=>this.log(this._port(this._options.port),"express"))),!this._server){const e=T.createServer((e,t)=>{const s=80==this._options.port?":80":"";t.writeHead(R.MOVED_PERMANENTLY,{Location:`https://${e.headers.host}${s}${e.url}`}),t.end()}),t=O.createServer({key:this._options.key,cert:this._options.cert},this._app);if(this._options.hybrid){new p.Server(s=>{s.once("data",r=>{s.pause(),s.unshift(r),(22===r[0]?t:e).emit("connection",s),process.nextTick(()=>s.resume())})}).listen(this._options.port,()=>this.log(this._port(this._options.port),"express")),this._server=t}this._server||(443==this._options.port&&e.listen(80,()=>this.log(this._port(80),"express")),t.listen(this._options.port,()=>this.log(this._port(this._options.port),"express")),this._server=t)}})}}const I=e=>t=>(s,r,o)=>{A.parameters(s).push({callback:e,key:t,propertyKey:r,parameterIndex:o})},S=I(({app:e})=>e),D=I(({argument:e})=>e),f=I(({ctx:e,key:t})=>t?e.getBodyValue(t):e.getBody()),y=I(({ctx:e,key:t})=>t?e.getCookie(t):e.getCookies()),C=I(({ctx:e})=>e),U=I(({ctx:e})=>e.getFiles()),L=I(({ctx:e,key:t})=>t?e.getHeader(t):e.getHeaders()),P=I(({ctx:e,key:t})=>t?e.getParam(t):e.getParams()),b=I(({ctx:e,key:t})=>t?e.getQuery(t):e.getQueries()),F=I(({ctx:e})=>{var t;return null===(t=e.req)||void 0===t?void 0:t.session}),q=(e,t)=>(r,o)=>{const i=s.uuidv7();C()(r,i,0),A.middleware(r).push({method:i,argument:t,propertyKey:o,callback:e})},k={ALL:"all",GET:"get",POST:"post",PUT:"put",HEAD:"head",DELETE:"delete",OPTIONS:"options",PATCH:"patch"},M=e=>t=>(s,r)=>{A.routers(s).push({method:e,path:(null==t?void 0:t.length)?t:"/",propertyKey:r})},w=M(k.ALL),j=M(k.DELETE),H=M(k.GET),Q=M(k.HEAD),V=M(k.OPTIONS),$=M(k.PATCH),B=M(k.POST),G=M(k.PUT),K=e=>{var t;return(null===(t=e.split(".").pop())||void 0===t?void 0:t.toLowerCase())||"bin"},Y=(e,t)=>{var s;return null!==(s=e[t])&&void 0!==s?s:null},z=(e,t)=>{const r=s.uuidv7()+"."+t;return u.existsSync(h.join(e,r))?z(e,t):r};exports.All=w,exports.App=S,exports.Application=g,exports.Argument=D,exports.BadRequestError=class extends m{constructor(e="Bad Request"){super(e,R.BAD_REQUEST)}},exports.Body=f,exports.Cache=e=>(t,s,r)=>{q(t=>{t.cache(Object.assign({},e)),t.next()})(t,s,r)},exports.Context=x,exports.Controller=e=>t=>{A.path(t,(null==e?void 0:e.length)?e:"/")},exports.Cookies=y,exports.Ctx=C,exports.Delete=j,exports.Extends=e=>t=>{A.extends(t).push(e)},exports.Files=U,exports.ForbiddenError=class extends m{constructor(e="Forbidden"){super(e,R.FORBIDDEN)}},exports.Get=H,exports.Head=Q,exports.Headers=L,exports.InternalServerError=class extends m{constructor(e="Internal server error"){super(e,R.INTERNAL_SERVER_ERROR)}},exports.Metadata=A,exports.Methods=k,exports.Middleware=(e,t)=>(r,o)=>{let i=s.noop;if(s.isString(o)){const t=r;s.isFunction(t[e])&&(i=t[e])}A.middleware(r).push({method:e,argument:t,propertyKey:o,callback:i})},exports.NotFoundError=class extends m{constructor(e="Record not found"){super(e,R.NOT_FOUND)}},exports.Options=V,exports.Params=P,exports.Patch=$,exports.Post=B,exports.Put=G,exports.Query=b,exports.ResponseError=m,exports.Session=F,exports.Status=R,exports.UnauthorizedError=class extends m{constructor(e="Unauthorized"){super(e,R.UNAUTHORIZED)}},exports.Upload=e=>{const t=s.merge({},e),r=c.diskStorage({destination(e,s,r){var o;const i=Y(t,s.fieldname);r(null,null!==(o=null==i?void 0:i.path)&&void 0!==o?o:"./")},filename(e,s,r){var o;const i=Y(t,s.fieldname);r(null,z(null!==(o=null==i?void 0:i.path)&&void 0!==o?o:"./",K(s.originalname)))}}),o=Math.max(...Object.values(t).map(e=>{var t;return null!==(t=e.size)&&void 0!==t?t:0})),i=c({storage:r,fileFilter(e,s,r){var o;const i=Y(t,s.fieldname);return i?((e,t)=>!t.length||t.includes(K(e.originalname))||t.includes(e.mimetype.toLowerCase()))(s,null!==(o=null==i?void 0:i.types)&&void 0!==o?o:[])?void r(null,!0):r(new Error(`FILE TYPE NOT ALLOWED FOR "${s.fieldname}"`)):r(new Error(`UPLOAD FIELD "${s.fieldname}" IS NOT CONFIGURED`))},limits:{fileSize:1024*o*1024}}).fields(Object.keys(t).map(e=>{var s,r;return{name:e,maxCount:null!==(r=null===(s=t[e])||void 0===s?void 0:s.count)&&void 0!==r?r:1}}));return(e,t,s)=>{q(e=>{i(e.req,e.res,t=>{if(t)return"LIMIT_UNEXPECTED_FILE"==t.code&&(t.message=`FIELD "${t.field}" EXCEEDS MAX SIZE`),e.destroy(t);e.next()})})(e,t,s)}},exports.Use=q,exports.Validate=e=>{const t=s.Validation.object(s.isFunction(e)?e(s.Validation):e).parse();return(e,s,r)=>{q(e=>v(void 0,void 0,void 0,function*(){var s,r;const{error:o,message:i,value:n}=yield t.validateAsync(null!==(r=null===(s=e.req)||void 0===s?void 0:s.body)&&void 0!==r?r:{});if(o)return e.error(new N(null!=i?i:o));e.req.body=n,e.next()}))(e,s,r)}},exports.ValidationError=N,exports.methodFactory=M,exports.parameterFactory=I;
+"use strict";var e=require("@andrewcaires/decorator"),t=require("@andrewcaires/node"),s=require("@andrewcaires/utils.js"),r=require("compression"),o=require("cookie-parser"),i=require("cors"),n=require("express"),a=require("express-session"),u=require("fs"),l=require("http"),d=require("https"),p=require("net"),c=require("path"),h=require("request-ip"),E=require("multer");function _(e){var t=Object.create(null);return e&&Object.keys(e).forEach(function(s){if("default"!==s){var r=Object.getOwnPropertyDescriptor(e,s);Object.defineProperty(t,s,r.get?r:{enumerable:!0,get:function(){return e[s]}})}}),t.default=e,Object.freeze(t)}var R=_(l),v=_(d);function T(e,t,s,r){return new(s||(s=Promise))(function(o,i){function n(e){try{u(r.next(e))}catch(e){i(e)}}function a(e){try{u(r.throw(e))}catch(e){i(e)}}function u(e){var t;e.done?o(e.value):(t=e.value,t instanceof s?t:new s(function(e){e(t)})).then(n,a)}u((r=r.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;class m{}m.CONTINUE=100,m.SWITCHING_PROTOCOLS=101,m.PROCESSING=102,m.OK=200,m.CREATED=201,m.ACCEPTED=202,m.NON_AUTHORITATIVE_INFORMATION=203,m.NO_CONTENT=204,m.RESET_CONTENT=205,m.PARTIAL_CONTENT=206,m.MULTI_STATUS=207,m.ALREADY_REPORTED=208,m.IM_USED=226,m.MULTIPLE_CHOICES=300,m.MOVED_PERMANENTLY=301,m.FOUND=302,m.SEE_OTHER=303,m.NOT_MODIFIED=304,m.USE_PROXY=305,m.TEMPORARY_REDIRECT=307,m.PERMANENT_REDIRECT=308,m.BAD_REQUEST=400,m.UNAUTHORIZED=401,m.PAYMENT_REQUIRED=402,m.FORBIDDEN=403,m.NOT_FOUND=404,m.METHOD_NOT_ALLOWED=405,m.NOT_ACCEPTABLE=406,m.PROXY_AUTHENTICATION_REQUIRED=407,m.REQUEST_TIMEOUT=408,m.CONFLICT=409,m.GONE=410,m.LENGTH_REQUIRED=411,m.PRECONDITION_FAILED=412,m.PAYLOAD_TOO_LARGE=413,m.REQUEST_URI_TOO_LONG=414,m.UNSUPPORTED_MEDIA_TYPE=415,m.REQUESTED_RANGE_NOT_SATISFIABLE=416,m.EXPECTATION_FAILED=417,m.IM_A_TEAPOT=418,m.MISDIRECTED_REQUEST=421,m.UNPROCESSABLE_ENTITY=422,m.LOCKED=423,m.FAILED_DEPENDENCY=424,m.UPGRADE_REQUIRED=426,m.PRECONDITION_REQUIRED=428,m.TOO_MANY_REQUESTS=429,m.REQUEST_HEADER_FIELDS_TOO_LARGE=431,m.CONNECTION_CLOSED_WITHOUT_RESPONSE=444,m.UNAVAILABLE_FOR_LEGAL_REASONS=451,m.CLIENT_CLOSED_REQUEST=499,m.INTERNAL_SERVER_ERROR=500,m.NOT_IMPLEMENTED=501,m.BAD_GATEWAY=502,m.SERVICE_UNAVAILABLE=503,m.GATEWAY_TIMEOUT=504,m.HTTP_VERSION_NOT_SUPPORTED=505,m.VARIANT_ALSO_NEGOCIATES=506,m.INSUFFICIENT_STORAGE=507,m.LOOP_DETECTED=508,m.NOT_EXTENDED=510,m.NETWORK_AUTHENTICATION_REQUIRED=511,m.NETWORK_CONNECTION_TIMEOUT_ERROR=599;class O{}O[100]="Continue",O[101]="Switching Protocols",O[102]="Processing",O[200]="OK",O[201]="Created",O[202]="Accepted",O[203]="Non-Authoritative Information",O[204]="No Content",O[205]="Reset Content",O[206]="Partial Content",O[207]="Multi-Status",O[226]="IM Used",O[300]="Multiple Choices",O[301]="Moved Permanently",O[302]="Found",O[303]="See Other",O[304]="Not Modified",O[305]="Use Proxy",O[307]="Temporary Redirect",O[308]="Permanent Redirect",O[400]="Bad Request",O[401]="Unauthorized",O[402]="Payment Required",O[403]="Forbidden",O[404]="Not Found",O[405]="Method Not Allowed",O[406]="Not Acceptable",O[407]="Proxy Authentication Required",O[408]="Request Timeout",O[409]="Conflict",O[410]="Gone",O[411]="Length Required",O[412]="Precondition Failed",O[413]="Payload Too Large",O[414]="URI Too Long",O[415]="Unsupported Media Type",O[416]="Range Not Satisfiable",O[417]="Expectation Failed",O[418]="I'm a teapot",O[422]="Unprocessable Entity",O[423]="Locked",O[424]="Failed Dependency",O[426]="Upgrade Required",O[428]="Precondition Required",O[429]="Too Many Requests",O[431]="Request Header Fields Too Large",O[451]="Unavailable For Legal Reasons",O[500]="Internal Server Error",O[501]="Not Implemented",O[502]="Bad Gateway",O[503]="Service Unavailable",O[504]="Gateway Time-out",O[505]="HTTP Version Not Supported",O[506]="Variant Also Negotiates",O[507]="Insufficient Storage",O[511]="Network Authentication Required";class g extends Error{constructor(e,t=m.INTERNAL_SERVER_ERROR){super(e),this.status=t}}class N extends g{constructor(e="Not Found"){super(e,m.NOT_FOUND)}}class S extends g{constructor(e){super(e,m.UNPROCESSABLE_ENTITY)}}class x{static created(e,t,s){var r,o;const i=m.CREATED,n={success:!0,status:i,data:t?{id:t}:{},meta:null!==(r=null==s?void 0:s.meta)&&void 0!==r?r:{},message:null!==(o=null==s?void 0:s.message)&&void 0!==o?o:null};return e.status(i).json(n),n}static noContent(e){e.status(m.NO_CONTENT).end()}static ok(e,t,s){var r,o;const i=m.OK,n={success:!0,status:i,data:t,meta:null!==(r=null==s?void 0:s.meta)&&void 0!==r?r:{},message:null!==(o=null==s?void 0:s.message)&&void 0!==o?o:null};return e.status(i).json(n),n}static error(e,t,s){var r,o;const{status:i,message:n}=this.normalizeError(s),a=Object.assign({success:!1,status:i,error:null!==(r=null==O?void 0:O[i])&&void 0!==r?r:"Internal Server Error",message:n,path:null!==(o=e.originalUrl)&&void 0!==o?o:e.url,timestamp:(new Date).toISOString()},this.isDev()&&s instanceof Error&&s.stack?{stack:s.stack}:{});return t.status(i).json(a),a}static isDev(){return"production"!==process.env.NODE_ENV}static normalizeError(e){let t=m.INTERNAL_SERVER_ERROR,r=O[500];if(e instanceof g)return t=this.safeStatus(e.status),r=this.safeMessage(e.message)||r,{status:t,message:r};if(e instanceof Error){const o=e;return s.isNumber(o.statusCode)?t=this.safeStatus(o.statusCode):s.isNumber(o.status)&&(t=this.safeStatus(o.status)),r=this.safeMessage(e.message)||r,{status:t,message:r}}if(s.isString(e))return r=this.safeMessage(e)||r,{status:t,message:r};if(e&&s.isObject(e)){const o=e;return s.isNumber(o.statusCode)?t=this.safeStatus(o.statusCode):s.isNumber(o.status)&&(t=this.safeStatus(o.status)),s.isString(o.message)&&(r=this.safeMessage(o.message)||r),{status:t,message:r}}return{status:t,message:r}}static safeStatus(e){if(!Number.isFinite(e))return m.INTERNAL_SERVER_ERROR;const t=Math.trunc(e);return t<400||t>599?m.INTERNAL_SERVER_ERROR:t}static safeMessage(e){if(!s.isString(e))return"";const t=e.trim();return t.length>2e3?t.slice(0,2e3)+"...":t}}class A{constructor(e,t,s,r,o){this.storage={},this.req=e,this.res=t,this.next=s,this.app=r,this.controller=o}cache(e){const t=Object.assign({},e),r=[];t.private?r.push("private"):t.public&&r.push("public"),t.noStore&&(t.noCache=!0,r.push("no-store")),t.noCache&&(t.maxAge=0,delete t.sMaxAge,r.push("no-cache")),t.noTransform&&r.push("no-transform"),t.proxyRevalidate&&r.push("proxy-revalidate"),t.mustRevalidate?r.push("must-revalidate"):t.noCache||(s.isNumber(t.staleIfError)&&r.push(`stale-if-error=${t.staleIfError}`),s.isNumber(t.staleWhileRevalidate)&&r.push(`stale-while-revalidate=${t.staleWhileRevalidate}`)),s.isNumber(t.maxAge)&&r.push(`max-age=${t.maxAge}`),s.isNumber(t.sMaxAge)&&r.push(`s-maxage=${t.sMaxAge}`),r.length&&(this.res.setHeader("Cache-Control",r.join(",")),t.noCache&&s.forEachKey({"Surrogate-Control":"no-store",Pragma:"no-cache",ETag:"false",Expires:"0"},(e,t)=>this.res.setHeader(t,e)))}clearCookie(e,t){this.res.clearCookie(e,t)}close(e){this.isResponded()||this.res.json(null!=e?e:this.storage)}destroy(e){var t;e&&this.error(e),null===(t=this.res.socket)||void 0===t||t.destroy(e)}error(e){this.isResponded()||x.error(this.req,this.res,e)}file(e){this.isResponded()||(this.status(m.OK),this.res.sendFile(c.resolve(e)))}getBody(){var e,t;return null!==(t=null===(e=this.req)||void 0===e?void 0:e.body)&&void 0!==t?t:{}}getBodyValue(e){var t;return null===(t=this.req.body)||void 0===t?void 0:t[e]}getCookie(e){var t;return this.normalize(null===(t=this.req.cookies)||void 0===t?void 0:t[e])}getCookies(){var e,t;return s.map(null!==(t=null===(e=this.req)||void 0===e?void 0:e.cookies)&&void 0!==t?t:{},e=>this.normalize(e))}getFiles(){var e,t;return null!==(t=null===(e=this.req)||void 0===e?void 0:e.files)&&void 0!==t?t:{}}getHeader(e){var t;return this.normalize(null===(t=this.req.headers)||void 0===t?void 0:t[e])}getHeaders(){var e,t;return s.map(null!==(t=null===(e=this.req)||void 0===e?void 0:e.headers)&&void 0!==t?t:{},e=>this.normalize(e))}getIp(){return h.getClientIp(this.req)||"0.0.0.0"}getQuery(e){var t;return this.normalize(null===(t=this.req.query)||void 0===t?void 0:t[e])}getQueries(){var e,t;return s.map(null!==(t=null===(e=this.req)||void 0===e?void 0:e.query)&&void 0!==t?t:{},e=>this.normalize(e))}getParam(e){var t;const r=null===(t=this.req.params)||void 0===t?void 0:t[e];return s.isUndefined(r)?void 0:String(r)}getParams(){var e,t;return s.map(null!==(t=null===(e=this.req)||void 0===e?void 0:e.params)&&void 0!==t?t:{},e=>{if(!s.isUndefined(e)&&!s.isNull(e))return String(e)})}getUrl(){return`${this.req.protocol}://${this.req.get("host")}${this.req.originalUrl}`}isResponded(){return this.res.headersSent||this.res.writableEnded}json(e){this.send(m.OK,e)}normalize(e){if(!s.isUndefined(e)&&!s.isNull(e))return s.isObject(e)?JSON.stringify(e):String(e)}ok(e,t){this.isResponded()||x.ok(this.res,e,t)}prepare(e,t){this.isResponded()||(this.status(e),this.storage=t)}send(e,t){this.isResponded()||(this.status(e),204===e||304===e||s.isUndefined(t)?this.res.end():this.res.json(t))}setCookie(e,t,s){this.res.cookie(e,t,null!=s?s:{})}status(e){return s.isUndefined(e)||this.res.status(e),this.res.statusCode}success(e){this.send(m.OK,{message:e})}}class I{static extends(t){return e.metadata(I.EXTENDS,t,[])}static middleware(t){return e.metadata(I.MIDDLEWARE,t,[])}static parameters(t){return e.metadata(I.PARAMETERS,t,[])}static path(t,s){return e.metadata(I.PATH,t,s)}static routers(t){return e.metadata(I.ROUTERS,t,[])}}I.EXTENDS=Symbol("EXTENDS"),I.MIDDLEWARE=Symbol("MIDDLEWARE"),I.PARAMETERS=Symbol("PARAMETERS"),I.PATH=Symbol("PATH"),I.ROUTERS=Symbol("ROUTERS");class f extends s.EventEmitter{get controllers(){return this._controllers}get instance(){return this._app}get router(){return this._router}get server(){return this._server}constructor(t,l){var d,p;super(),this._app=n(),this._options={},this._base=n.Router(),this._router=n.Router(),this._controllers=[],this._controllers.push(...t.map(t=>s.isConstructor(t)?new t(...e.getInjectionArgs(t)):t)),this._options=s.merge({},{cross:!1,hybrid:!1,path:"/",port:3e3,session:{secret:"yoursecret",resave:!0,saveUninitialized:!1,cookie:{maxAge:864e5}}},null!=l?l:{}),this._app.use(n.json(this._options.json)),this._app.disable("x-powered-by"),this._app.use(n.urlencoded({extended:!0})),this._options.cross&&this._app.use(i(s.isObject(this._options.cross)?this._options.cross:{})),this._app.use(r(this._options.compression)),this._app.use(o(null===(d=this._options.cookie)||void 0===d?void 0:d.secret,this._options.cookie)),this._app.use(a(this._options.session)),this.init(),this._app.use(this._router);const h=(null===(p=this._options.path)||void 0===p?void 0:p.length)?this._options.path:"/";if(this._app.use(h,this._base),this._app.all(h+"/*path",(e,t)=>{this._options.redirect?t.redirect(this._options.redirect):x.error(e,t,new N("Endpoint Not Found"))}),this._options.public){const e=c.resolve(this._options.public);u.existsSync(e)&&this._app.use(n.static(e)),this._app.get("*path",(t,s)=>{u.existsSync(e)?s.sendFile(e+"/index.html"):this._options.notfound?s.redirect(this._options.notfound):x.error(t,s,new N('FILE "index.html" Not Found'))})}else this._app.all("*path",(e,t)=>{this._options.redirect?t.redirect(this._options.redirect):x.error(e,t,new N("Endpoint not found"))});this._controllers.forEach(e=>{const t=n.Router(),r=this._middlewares(e),o=I.parameters(e);this._extends(e).forEach(e=>{r.push(...this._middlewares(e)),o.push(...I.parameters(e))}),I.routers(e).forEach(i=>{const n=i.propertyKey.toString();if(s.isFunction(e[n])){if(!s.isFunction(t[i.method]))return this._notFound(i.method);const a=this._handles(e,n,r,o);return t[i.method](i.path,...a,(t,r,i)=>T(this,void 0,void 0,function*(){const a=new A(t,r,i,this,e),u=this._args(a,this._indexes(n,o)),l=yield e[n](...u);a.close(s.isArray(l)||s.isObject(l)?l:void 0)}))}this._notFound(`${e.name}.${n}`)}),this._extends(e).forEach(i=>{I.routers(i).forEach(i=>{const n=i.propertyKey.toString();if(s.isFunction(e[n])){if(!s.isFunction(t[i.method]))return this._notFound(i.method);const a=this._handles(e,n,r,o);return t[i.method](i.path,...a,(t,r,i)=>T(this,void 0,void 0,function*(){const a=new A(t,r,i,this,e),u=this._args(a,this._indexes(n,o)),l=yield e[n](...u);a.close(s.isArray(l)||s.isObject(l)?l:void 0)}))}this._notFound(`${e.constructor.name}.${n}`)})}),this._base.use(I.path(e,"/"),t)})}init(){}error(e,s){t.Log.error(e)}log(e,s){t.Log.info(e)}_args(e,t,s){const r=[],o={ctx:e,key:"",app:this,argument:s};return t.forEach(e=>{r[e.parameterIndex]=e.callback(Object.assign(Object.assign({},o),{key:e.key}))}),r}_handles(e,t,r,o){return r.filter(e=>e.propertyKey==t).map(t=>{if(t.callback!=s.noop){const r=this._indexes(t.method,o);return(o,i,n)=>T(this,void 0,void 0,function*(){const a=new A(o,i,n,this,e),u=s.isFunction(t.argument)?t.argument(a):t.argument,l=yield t.callback.call(e,...this._args(a,r,u));(s.isArray(l)||s.isObject(l))&&a.close(l)})}this._notFound(t.method)}).filter(s.isFunction)}_extends(e){return I.extends(e).reduce((e,t)=>(e.push(t,...this._extends(t)),e),[]).filter((e,t,s)=>s.indexOf(e)===t)}_indexes(e,t){return t.filter(t=>t.propertyKey==e)}_middlewares(e){return[...I.middleware(e)].reverse()}_notFound(e){this.error(new Error(`Router "${e}" not found`),"express")}_port(e){return`Server listening on port ${e}`}listen(){return T(this,void 0,void 0,function*(){if(this._options.cert&&this._options.key||(this._server=R.createServer(this._app),this._server.listen(this._options.port,()=>this.log(this._port(this._options.port),"express"))),!this._server){const e=R.createServer((e,t)=>{const s=80==this._options.port?":80":"";t.writeHead(m.MOVED_PERMANENTLY,{Location:`https://${e.headers.host}${s}${e.url}`}),t.end()}),t=v.createServer({key:this._options.key,cert:this._options.cert},this._app);if(this._options.hybrid){new p.Server(s=>{s.once("data",r=>{s.pause(),s.unshift(r),(22===r[0]?t:e).emit("connection",s),process.nextTick(()=>s.resume())})}).listen(this._options.port,()=>this.log(this._port(this._options.port),"express")),this._server=t}this._server||(443==this._options.port&&e.listen(80,()=>this.log(this._port(80),"express")),t.listen(this._options.port,()=>this.log(this._port(this._options.port),"express")),this._server=t)}})}}const y=e=>t=>(s,r,o)=>{I.parameters(s).push({callback:e,key:t,propertyKey:r,parameterIndex:o})},C=y(({app:e})=>e),D=y(({argument:e})=>e),U=y(({ctx:e,key:t})=>t?e.getBodyValue(t):e.getBody()),P=y(({ctx:e,key:t})=>t?e.getCookie(t):e.getCookies()),L=y(({ctx:e})=>e),b=y(({ctx:e})=>e.getFiles()),F=y(({ctx:e,key:t})=>t?e.getHeader(t):e.getHeaders()),q=y(({ctx:e,key:t})=>t?e.getParam(t):e.getParams()),M=y(({ctx:e,key:t})=>t?e.getQuery(t):e.getQueries()),k=y(({ctx:e})=>{var t;return null===(t=e.req)||void 0===t?void 0:t.session}),w=(e,t)=>(r,o)=>{const i=s.uuidv7();L()(r,i,0),I.middleware(r).push({method:i,argument:t,propertyKey:o,callback:e})},H={ALL:"all",GET:"get",POST:"post",PUT:"put",HEAD:"head",DELETE:"delete",OPTIONS:"options",PATCH:"patch"},j=e=>t=>(s,r)=>{I.routers(s).push({method:e,path:(null==t?void 0:t.length)?t:"/",propertyKey:r})},V=j(H.ALL),G=j(H.DELETE),B=j(H.GET),Q=j(H.HEAD),$=j(H.OPTIONS),K=j(H.PATCH),z=j(H.POST),Y=j(H.PUT),W=e=>{var t;return(null===(t=e.split(".").pop())||void 0===t?void 0:t.toLowerCase())||"bin"},X=(e,t)=>{var s;return null!==(s=e[t])&&void 0!==s?s:null},Z=(e,t)=>{const r=s.uuidv7()+"."+t;return u.existsSync(c.join(e,r))?Z(e,t):r};exports.All=V,exports.App=C,exports.Application=f,exports.Argument=D,exports.BadRequestError=class extends g{constructor(e="Bad Request"){super(e,m.BAD_REQUEST)}},exports.Body=U,exports.Cache=e=>(t,s,r)=>{w(t=>{t.cache(Object.assign({},e)),t.next()})(t,s,r)},exports.Context=A,exports.Controller=e=>t=>{I.path(t,(null==e?void 0:e.length)?e:"/")},exports.Cookies=P,exports.Ctx=L,exports.Delete=G,exports.Extends=e=>t=>{I.extends(t).push(e)},exports.Files=b,exports.ForbiddenError=class extends g{constructor(e="Forbidden"){super(e,m.FORBIDDEN)}},exports.Get=B,exports.Head=Q,exports.Headers=F,exports.HttpResponse=x,exports.InternalServerError=class extends g{constructor(e="Internal server error"){super(e,m.INTERNAL_SERVER_ERROR)}},exports.Metadata=I,exports.Methods=H,exports.Middleware=(e,t)=>(r,o)=>{let i=s.noop;if(s.isString(o)){const t=r;s.isFunction(t[e])&&(i=t[e])}I.middleware(r).push({method:e,argument:t,propertyKey:o,callback:i})},exports.NotFoundError=N,exports.Options=$,exports.Params=q,exports.Patch=K,exports.Post=z,exports.Put=Y,exports.Query=M,exports.ResponseError=g,exports.Session=k,exports.StatusCodes=m,exports.StatusText=O,exports.UnauthorizedError=class extends g{constructor(e="Unauthorized"){super(e,m.UNAUTHORIZED)}},exports.Upload=e=>{const t=s.merge({},e),r=E.diskStorage({destination(e,s,r){var o;const i=X(t,s.fieldname);r(null,null!==(o=null==i?void 0:i.path)&&void 0!==o?o:"./")},filename(e,s,r){var o;const i=X(t,s.fieldname);r(null,Z(null!==(o=null==i?void 0:i.path)&&void 0!==o?o:"./",W(s.originalname)))}}),o=Math.max(...Object.values(t).map(e=>{var t;return null!==(t=e.size)&&void 0!==t?t:0})),i=E({storage:r,fileFilter(e,s,r){var o;const i=X(t,s.fieldname);return i?((e,t)=>!t.length||t.includes(W(e.originalname))||t.includes(e.mimetype.toLowerCase()))(s,null!==(o=null==i?void 0:i.types)&&void 0!==o?o:[])?void r(null,!0):r(new Error(`FILE TYPE NOT ALLOWED FOR "${s.fieldname}"`)):r(new Error(`UPLOAD FIELD "${s.fieldname}" IS NOT CONFIGURED`))},limits:{fileSize:1024*o*1024}}).fields(Object.keys(t).map(e=>{var s,r;return{name:e,maxCount:null!==(r=null===(s=t[e])||void 0===s?void 0:s.count)&&void 0!==r?r:1}}));return(e,t,s)=>{w(e=>{i(e.req,e.res,t=>{if(t)return"LIMIT_UNEXPECTED_FILE"==t.code&&(t.message=`FIELD "${t.field}" EXCEEDS MAX SIZE`),e.destroy(t);e.next()})})(e,t,s)}},exports.Use=w,exports.Validate=e=>{const t=s.Validation.object(s.isFunction(e)?e(s.Validation):e).parse();return(e,s,r)=>{w(e=>T(void 0,void 0,void 0,function*(){var s,r;const{error:o,message:i,value:n}=yield t.validateAsync(null!==(r=null===(s=e.req)||void 0===s?void 0:s.body)&&void 0!==r?r:{});if(o)return e.error(new S(null!=i?i:o));e.req.body=n,e.next()}))(e,s,r)}},exports.ValidationError=S,exports.methodFactory=j,exports.parameterFactory=y;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @andrewcaires/express v2.1.0
+ * @andrewcaires/express v2.1.1
  * Decorators for express
  * (c) 2026 Andrew Caires
  * @license: MIT
@@ -44,6 +44,7 @@ declare class Context<T = any, A = Application> {
     isResponded(): boolean;
     json(value?: TypeAnyObject | Array<TypeAnyObject>): void;
     private normalize;
+    ok<T = any>(data: T, meta?: TypeAnyObject): void;
     prepare(status: number, value: TypeAnyObject | Array<TypeAnyObject>): void;
     send(status: number, value?: TypeAnyObject | Array<TypeAnyObject>): void;
     setCookie(key: string, value: string, options?: CookieOptions): void;
@@ -407,6 +408,34 @@ interface OpenAPIObject {
 
 type ParseFunction = (_$: typeof Validation) => TypeObject<ValidationBase>;
 
+interface HttpResponseBase<T> {
+    success: true;
+    status: number;
+    data: T;
+    meta?: TypeAnyObject;
+    message?: string | null;
+}
+
+interface HttpResponseCreated extends HttpResponseBase<{
+    id?: string | number;
+}> {
+}
+
+interface HttpResponseError {
+    success: false;
+    status: number;
+    error: string;
+    message: string;
+    path?: string;
+    timestamp?: string;
+    stack?: string;
+}
+
+interface HttpResponseOptions {
+    message?: string | null;
+    meta?: TypeAnyObject;
+}
+
 declare class Application<T extends TypeAnyObject = TypeAnyObject> extends EventEmitter<T> {
     private readonly _app;
     private _server?;
@@ -515,6 +544,17 @@ declare class ValidationError extends ResponseError {
     constructor(message: string);
 }
 
+declare class HttpResponse {
+    static created(res: Response, id?: string | number, options?: HttpResponseOptions): HttpResponseCreated;
+    static noContent(res: Response): void;
+    static ok<T = TypeAnyObject | Array<TypeAnyObject>>(res: Response, data: T, options?: HttpResponseOptions): HttpResponseBase<T>;
+    static error(req: Request, res: Response, error: unknown): HttpResponseError;
+    private static isDev;
+    private static normalizeError;
+    private static safeStatus;
+    private static safeMessage;
+}
+
 declare class Metadata {
     static readonly EXTENDS: unique symbol;
     static readonly MIDDLEWARE: unique symbol;
@@ -528,7 +568,7 @@ declare class Metadata {
     static routers(target: any): Array<IRouter>;
 }
 
-declare class Status {
+declare class StatusCodes {
     static readonly CONTINUE = 100;
     static readonly SWITCHING_PROTOCOLS = 101;
     static readonly PROCESSING = 102;
@@ -594,5 +634,64 @@ declare class Status {
     static readonly NETWORK_CONNECTION_TIMEOUT_ERROR = 599;
 }
 
-export { All, App, Application, Argument, BadRequestError, Body, Cache, Context, Controller, Cookies, Ctx, Delete, Extends, Files, ForbiddenError, Get, Head, Headers, InternalServerError, Metadata, Methods, Middleware, NotFoundError, Options, Params, Patch, Post, Put, Query, ResponseError, Session, Status, UnauthorizedError, Upload, Use, Validate, ValidationError, methodFactory, parameterFactory };
-export type { CallbackObject, ComponentsObject, ContactObject, EncodingObject, ExampleObject, ExternalDocumentationObject, HeaderObject, IArgs, ICache, ICookie, IFile, IHandler, IMiddlewares, IOptions, IParameter, IRouter, IStore, IUpload, IUse, InfoObject, LicenseObject, LinkObject, MediaTypeObject, Method, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OperationObject, ParameterObject, ParseFunction, PathItemObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SecurityRequirementObject, SecuritySchemeObject, ServerObject, ServerVariableObject, TagObject };
+declare class StatusText {
+    static readonly 100 = "Continue";
+    static readonly 101 = "Switching Protocols";
+    static readonly 102 = "Processing";
+    static readonly 200 = "OK";
+    static readonly 201 = "Created";
+    static readonly 202 = "Accepted";
+    static readonly 203 = "Non-Authoritative Information";
+    static readonly 204 = "No Content";
+    static readonly 205 = "Reset Content";
+    static readonly 206 = "Partial Content";
+    static readonly 207 = "Multi-Status";
+    static readonly 226 = "IM Used";
+    static readonly 300 = "Multiple Choices";
+    static readonly 301 = "Moved Permanently";
+    static readonly 302 = "Found";
+    static readonly 303 = "See Other";
+    static readonly 304 = "Not Modified";
+    static readonly 305 = "Use Proxy";
+    static readonly 307 = "Temporary Redirect";
+    static readonly 308 = "Permanent Redirect";
+    static readonly 400 = "Bad Request";
+    static readonly 401 = "Unauthorized";
+    static readonly 402 = "Payment Required";
+    static readonly 403 = "Forbidden";
+    static readonly 404 = "Not Found";
+    static readonly 405 = "Method Not Allowed";
+    static readonly 406 = "Not Acceptable";
+    static readonly 407 = "Proxy Authentication Required";
+    static readonly 408 = "Request Timeout";
+    static readonly 409 = "Conflict";
+    static readonly 410 = "Gone";
+    static readonly 411 = "Length Required";
+    static readonly 412 = "Precondition Failed";
+    static readonly 413 = "Payload Too Large";
+    static readonly 414 = "URI Too Long";
+    static readonly 415 = "Unsupported Media Type";
+    static readonly 416 = "Range Not Satisfiable";
+    static readonly 417 = "Expectation Failed";
+    static readonly 418 = "I'm a teapot";
+    static readonly 422 = "Unprocessable Entity";
+    static readonly 423 = "Locked";
+    static readonly 424 = "Failed Dependency";
+    static readonly 426 = "Upgrade Required";
+    static readonly 428 = "Precondition Required";
+    static readonly 429 = "Too Many Requests";
+    static readonly 431 = "Request Header Fields Too Large";
+    static readonly 451 = "Unavailable For Legal Reasons";
+    static readonly 500 = "Internal Server Error";
+    static readonly 501 = "Not Implemented";
+    static readonly 502 = "Bad Gateway";
+    static readonly 503 = "Service Unavailable";
+    static readonly 504 = "Gateway Time-out";
+    static readonly 505 = "HTTP Version Not Supported";
+    static readonly 506 = "Variant Also Negotiates";
+    static readonly 507 = "Insufficient Storage";
+    static readonly 511 = "Network Authentication Required";
+}
+
+export { All, App, Application, Argument, BadRequestError, Body, Cache, Context, Controller, Cookies, Ctx, Delete, Extends, Files, ForbiddenError, Get, Head, Headers, HttpResponse, InternalServerError, Metadata, Methods, Middleware, NotFoundError, Options, Params, Patch, Post, Put, Query, ResponseError, Session, StatusCodes, StatusText, UnauthorizedError, Upload, Use, Validate, ValidationError, methodFactory, parameterFactory };
+export type { CallbackObject, ComponentsObject, ContactObject, EncodingObject, ExampleObject, ExternalDocumentationObject, HeaderObject, HttpResponseBase, HttpResponseCreated, HttpResponseError, HttpResponseOptions, IArgs, ICache, ICookie, IFile, IHandler, IMiddlewares, IOptions, IParameter, IRouter, IStore, IUpload, IUse, InfoObject, LicenseObject, LinkObject, MediaTypeObject, Method, OAuthFlowObject, OAuthFlowsObject, OpenAPIObject, OperationObject, ParameterObject, ParseFunction, PathItemObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, ResponsesObject, SchemaObject, SecurityRequirementObject, SecuritySchemeObject, ServerObject, ServerVariableObject, TagObject };

package/dist/index.esm.js

@@ -1,7 +1,7 @@
 /*!
- * @andrewcaires/express v2.1.0
+ * @andrewcaires/express v2.1.1
  * Decorators for express
  * (c) 2026 Andrew Caires
  * @license: MIT
  */
-import{metadata as e,getInjectionArgs as t}from"@andrewcaires/decorator";import{Log as s}from"@andrewcaires/node";import{isNumber as r,forEachKey as o,map as i,isUndefined as n,isNull as a,isObject as l,EventEmitter as h,isConstructor as u,merge as d,isFunction as p,noop as E,isArray as c,uuidv7 as _,isString as T,Validation as O}from"@andrewcaires/utils.js";import m from"compression";import R from"cookie-parser";import v from"cors";import N,{Router as A,json as I,urlencoded as g}from"express";import S from"express-session";import{existsSync as D}from"fs";import*as f from"http";import*as y from"https";import{Server as x}from"net";import{resolve as L,join as C}from"path";import{getClientIp as U}from"request-ip";import P,{diskStorage as F}from"multer";function b(e,t,s,r){return new(s||(s=Promise))(function(o,i){function n(e){try{l(r.next(e))}catch(e){i(e)}}function a(e){try{l(r.throw(e))}catch(e){i(e)}}function l(e){var t;e.done?o(e.value):(t=e.value,t instanceof s?t:new s(function(e){e(t)})).then(n,a)}l((r=r.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;class k{}k.CONTINUE=100,k.SWITCHING_PROTOCOLS=101,k.PROCESSING=102,k.OK=200,k.CREATED=201,k.ACCEPTED=202,k.NON_AUTHORITATIVE_INFORMATION=203,k.NO_CONTENT=204,k.RESET_CONTENT=205,k.PARTIAL_CONTENT=206,k.MULTI_STATUS=207,k.ALREADY_REPORTED=208,k.IM_USED=226,k.MULTIPLE_CHOICES=300,k.MOVED_PERMANENTLY=301,k.FOUND=302,k.SEE_OTHER=303,k.NOT_MODIFIED=304,k.USE_PROXY=305,k.TEMPORARY_REDIRECT=307,k.PERMANENT_REDIRECT=308,k.BAD_REQUEST=400,k.UNAUTHORIZED=401,k.PAYMENT_REQUIRED=402,k.FORBIDDEN=403,k.NOT_FOUND=404,k.METHOD_NOT_ALLOWED=405,k.NOT_ACCEPTABLE=406,k.PROXY_AUTHENTICATION_REQUIRED=407,k.REQUEST_TIMEOUT=408,k.CONFLICT=409,k.GONE=410,k.LENGTH_REQUIRED=411,k.PRECONDITION_FAILED=412,k.PAYLOAD_TOO_LARGE=413,k.REQUEST_URI_TOO_LONG=414,k.UNSUPPORTED_MEDIA_TYPE=415,k.REQUESTED_RANGE_NOT_SATISFIABLE=416,k.EXPECTATION_FAILED=417,k.IM_A_TEAPOT=418,k.MISDIRECTED_REQUEST=421,k.UNPROCESSABLE_ENTITY=422,k.LOCKED=423,k.FAILED_DEPENDENCY=424,k.UPGRADE_REQUIRED=426,k.PRECONDITION_REQUIRED=428,k.TOO_MANY_REQUESTS=429,k.REQUEST_HEADER_FIELDS_TOO_LARGE=431,k.CONNECTION_CLOSED_WITHOUT_RESPONSE=444,k.UNAVAILABLE_FOR_LEGAL_REASONS=451,k.CLIENT_CLOSED_REQUEST=499,k.INTERNAL_SERVER_ERROR=500,k.NOT_IMPLEMENTED=501,k.BAD_GATEWAY=502,k.SERVICE_UNAVAILABLE=503,k.GATEWAY_TIMEOUT=504,k.HTTP_VERSION_NOT_SUPPORTED=505,k.VARIANT_ALSO_NEGOCIATES=506,k.INSUFFICIENT_STORAGE=507,k.LOOP_DETECTED=508,k.NOT_EXTENDED=510,k.NETWORK_AUTHENTICATION_REQUIRED=511,k.NETWORK_CONNECTION_TIMEOUT_ERROR=599;class M extends Error{constructor(e,t=k.INTERNAL_SERVER_ERROR){super(e),this.status=t}}class w extends M{constructor(e="Bad Request"){super(e,k.BAD_REQUEST)}}class H extends M{constructor(e="Forbidden"){super(e,k.FORBIDDEN)}}class q extends M{constructor(e="Internal server error"){super(e,k.INTERNAL_SERVER_ERROR)}}class Q extends M{constructor(e="Record not found"){super(e,k.NOT_FOUND)}}class $ extends M{constructor(e="Unauthorized"){super(e,k.UNAUTHORIZED)}}class G extends M{constructor(e){super(e,k.UNPROCESSABLE_ENTITY)}}class j{constructor(e,t,s,r,o){this.storage={},this.req=e,this.res=t,this.next=s,this.app=r,this.controller=o}cache(e){const t=Object.assign({},e),s=[];t.private?s.push("private"):t.public&&s.push("public"),t.noStore&&(t.noCache=!0,s.push("no-store")),t.noCache&&(t.maxAge=0,delete t.sMaxAge,s.push("no-cache")),t.noTransform&&s.push("no-transform"),t.proxyRevalidate&&s.push("proxy-revalidate"),t.mustRevalidate?s.push("must-revalidate"):t.noCache||(r(t.staleIfError)&&s.push(`stale-if-error=${t.staleIfError}`),r(t.staleWhileRevalidate)&&s.push(`stale-while-revalidate=${t.staleWhileRevalidate}`)),r(t.maxAge)&&s.push(`max-age=${t.maxAge}`),r(t.sMaxAge)&&s.push(`s-maxage=${t.sMaxAge}`),s.length&&(this.res.setHeader("Cache-Control",s.join(",")),t.noCache&&o({"Surrogate-Control":"no-store",Pragma:"no-cache",ETag:"false",Expires:"0"},(e,t)=>this.res.setHeader(t,e)))}clearCookie(e,t){this.res.clearCookie(e,t)}close(e){this.isResponded()||this.res.json(null!=e?e:this.storage)}destroy(e){var t;e&&this.error(e),null===(t=this.res.socket)||void 0===t||t.destroy(e)}error(e){var t;let s=null!==(t=e.toString())&&void 0!==t?t:"",r=k.INTERNAL_SERVER_ERROR;e instanceof Error&&(s=e.message,e instanceof M&&(r=e.status)),this.send(r,{error:s})}file(e){this.isResponded()||(this.status(k.OK),this.res.sendFile(L(e)))}getBody(){var e,t;return null!==(t=null===(e=this.req)||void 0===e?void 0:e.body)&&void 0!==t?t:{}}getBodyValue(e){var t;return null===(t=this.req.body)||void 0===t?void 0:t[e]}getCookie(e){var t;return this.normalize(null===(t=this.req.cookies)||void 0===t?void 0:t[e])}getCookies(){var e,t;return i(null!==(t=null===(e=this.req)||void 0===e?void 0:e.cookies)&&void 0!==t?t:{},e=>this.normalize(e))}getFiles(){var e,t;return null!==(t=null===(e=this.req)||void 0===e?void 0:e.files)&&void 0!==t?t:{}}getHeader(e){var t;return this.normalize(null===(t=this.req.headers)||void 0===t?void 0:t[e])}getHeaders(){var e,t;return i(null!==(t=null===(e=this.req)||void 0===e?void 0:e.headers)&&void 0!==t?t:{},e=>this.normalize(e))}getIp(){return U(this.req)||"0.0.0.0"}getQuery(e){var t;return this.normalize(null===(t=this.req.query)||void 0===t?void 0:t[e])}getQueries(){var e,t;return i(null!==(t=null===(e=this.req)||void 0===e?void 0:e.query)&&void 0!==t?t:{},e=>this.normalize(e))}getParam(e){var t;const s=null===(t=this.req.params)||void 0===t?void 0:t[e];return n(s)?void 0:String(s)}getParams(){var e,t;return i(null!==(t=null===(e=this.req)||void 0===e?void 0:e.params)&&void 0!==t?t:{},e=>{if(!n(e)&&!a(e))return String(e)})}getUrl(){return`${this.req.protocol}://${this.req.get("host")}${this.req.originalUrl}`}isResponded(){return this.res.headersSent||this.res.writableEnded}json(e){this.send(k.OK,e)}normalize(e){if(!n(e)&&!a(e))return l(e)?JSON.stringify(e):String(e)}prepare(e,t){this.isResponded()||(this.status(e),this.storage=t)}send(e,t){this.isResponded()||(this.status(e),204===e||304===e||n(t)?this.res.end():this.res.json(t))}setCookie(e,t,s){this.res.cookie(e,t,null!=s?s:{})}status(e){return n(e)||this.res.status(e),this.res.statusCode}success(e){this.send(k.OK,{message:e})}}class B{static extends(t){return e(B.EXTENDS,t,[])}static middleware(t){return e(B.MIDDLEWARE,t,[])}static parameters(t){return e(B.PARAMETERS,t,[])}static path(t,s){return e(B.PATH,t,s)}static routers(t){return e(B.ROUTERS,t,[])}}B.EXTENDS=Symbol("EXTENDS"),B.MIDDLEWARE=Symbol("MIDDLEWARE"),B.PARAMETERS=Symbol("PARAMETERS"),B.PATH=Symbol("PATH"),B.ROUTERS=Symbol("ROUTERS");class V extends h{get controllers(){return this._controllers}get instance(){return this._app}get router(){return this._router}get server(){return this._server}constructor(e,s){var r,o;super(),this._app=N(),this._options={},this._base=A(),this._router=A(),this._controllers=[],this._controllers.push(...e.map(e=>u(e)?new e(...t(e)):e)),this._options=d({},{cross:!1,hybrid:!1,path:"/",port:3e3,session:{secret:"yoursecret",resave:!0,saveUninitialized:!1,cookie:{maxAge:864e5}}},null!=s?s:{}),this._app.use(I(this._options.json)),this._app.disable("x-powered-by"),this._app.use(g({extended:!0})),this._options.cross&&this._app.use(v(l(this._options.cross)?this._options.cross:{})),this._app.use(m(this._options.compression)),this._app.use(R(null===(r=this._options.cookie)||void 0===r?void 0:r.secret,this._options.cookie)),this._app.use(S(this._options.session)),this.init(),this._app.use(this._router);const i=(null===(o=this._options.path)||void 0===o?void 0:o.length)?this._options.path:"/";if(this._app.use(i,this._base),this._app.all(i+"/*path",(e,t)=>{this._options.redirect?t.redirect(this._options.redirect):(t.status(k.NOT_FOUND),t.json({message:"INVALID API"}))}),this._options.public){const e=L(this._options.public);D(e)&&this._app.use(N.static(e)),this._app.get("*path",(t,s)=>{D(e)?s.sendFile(e+"/index.html"):this._options.notfound?s.redirect(this._options.notfound):(s.status(k.NOT_FOUND),s.json({message:'FILE "index.html" NOT FOUND'}))})}else this._app.all("*path",(e,t)=>{this._options.redirect?t.redirect(this._options.redirect):(t.status(k.NOT_FOUND),t.json({message:"INVALID API"}))});this._controllers.forEach(e=>{const t=A(),s=this._middlewares(e),r=B.parameters(e);this._extends(e).forEach(e=>{s.push(...this._middlewares(e)),r.push(...B.parameters(e))}),B.routers(e).forEach(o=>{const i=o.propertyKey.toString();if(p(e[i])){if(!p(t[o.method]))return this._notFound(o.method);const n=this._handles(e,i,s,r);return t[o.method](o.path,...n,(t,s,o)=>b(this,void 0,void 0,function*(){const n=new j(t,s,o,this,e),a=this._args(n,this._indexes(i,r)),h=yield e[i](...a);n.close(c(h)||l(h)?h:void 0)}))}this._notFound(`${e.name}.${i}`)}),this._extends(e).forEach(o=>{B.routers(o).forEach(o=>{const i=o.propertyKey.toString();if(p(e[i])){if(!p(t[o.method]))return this._notFound(o.method);const n=this._handles(e,i,s,r);return t[o.method](o.path,...n,(t,s,o)=>b(this,void 0,void 0,function*(){const n=new j(t,s,o,this,e),a=this._args(n,this._indexes(i,r)),h=yield e[i](...a);n.close(c(h)||l(h)?h:void 0)}))}this._notFound(`${e.constructor.name}.${i}`)})}),this._base.use(B.path(e,"/"),t)})}init(){}error(e,t){s.error(e)}log(e,t){s.info(e)}_args(e,t,s){const r=[],o={ctx:e,key:"",app:this,argument:s};return t.forEach(e=>{r[e.parameterIndex]=e.callback(Object.assign(Object.assign({},o),{key:e.key}))}),r}_handles(e,t,s,r){return s.filter(e=>e.propertyKey==t).map(t=>{if(t.callback!=E){const s=this._indexes(t.method,r);return(r,o,i)=>b(this,void 0,void 0,function*(){const n=new j(r,o,i,this,e),a=p(t.argument)?t.argument(n):t.argument,h=yield t.callback.call(e,...this._args(n,s,a));(c(h)||l(h))&&n.close(h)})}this._notFound(t.method)}).filter(p)}_extends(e){return B.extends(e).reduce((e,t)=>(e.push(t,...this._extends(t)),e),[]).filter((e,t,s)=>s.indexOf(e)===t)}_indexes(e,t){return t.filter(t=>t.propertyKey==e)}_middlewares(e){return[...B.middleware(e)].reverse()}_notFound(e){this.error(new Error(`Router "${e}" not found`),"express")}_port(e){return`Server listening on port ${e}`}listen(){return b(this,void 0,void 0,function*(){if(this._options.cert&&this._options.key||(this._server=f.createServer(this._app),this._server.listen(this._options.port,()=>this.log(this._port(this._options.port),"express"))),!this._server){const e=f.createServer((e,t)=>{const s=80==this._options.port?":80":"";t.writeHead(k.MOVED_PERMANENTLY,{Location:`https://${e.headers.host}${s}${e.url}`}),t.end()}),t=y.createServer({key:this._options.key,cert:this._options.cert},this._app);if(this._options.hybrid){new x(s=>{s.once("data",r=>{s.pause(),s.unshift(r),(22===r[0]?t:e).emit("connection",s),process.nextTick(()=>s.resume())})}).listen(this._options.port,()=>this.log(this._port(this._options.port),"express")),this._server=t}this._server||(443==this._options.port&&e.listen(80,()=>this.log(this._port(80),"express")),t.listen(this._options.port,()=>this.log(this._port(this._options.port),"express")),this._server=t)}})}}const Y=e=>t=>{B.path(t,(null==e?void 0:e.length)?e:"/")},K=e=>t=>{B.extends(t).push(e)},W=e=>t=>(s,r,o)=>{B.parameters(s).push({callback:e,key:t,propertyKey:r,parameterIndex:o})},z=W(({app:e})=>e),X=W(({argument:e})=>e),Z=W(({ctx:e,key:t})=>t?e.getBodyValue(t):e.getBody()),J=W(({ctx:e,key:t})=>t?e.getCookie(t):e.getCookies()),ee=W(({ctx:e})=>e),te=W(({ctx:e})=>e.getFiles()),se=W(({ctx:e,key:t})=>t?e.getHeader(t):e.getHeaders()),re=W(({ctx:e,key:t})=>t?e.getParam(t):e.getParams()),oe=W(({ctx:e,key:t})=>t?e.getQuery(t):e.getQueries()),ie=W(({ctx:e})=>{var t;return null===(t=e.req)||void 0===t?void 0:t.session}),ne=(e,t)=>(s,r)=>{const o=_();ee()(s,o,0),B.middleware(s).push({method:o,argument:t,propertyKey:r,callback:e})},ae=e=>(t,s,r)=>{ne(t=>{t.cache(Object.assign({},e)),t.next()})(t,s,r)},le={ALL:"all",GET:"get",POST:"post",PUT:"put",HEAD:"head",DELETE:"delete",OPTIONS:"options",PATCH:"patch"},he=e=>t=>(s,r)=>{B.routers(s).push({method:e,path:(null==t?void 0:t.length)?t:"/",propertyKey:r})},ue=he(le.ALL),de=he(le.DELETE),pe=he(le.GET),Ee=he(le.HEAD),ce=he(le.OPTIONS),_e=he(le.PATCH),Te=he(le.POST),Oe=he(le.PUT),me=(e,t)=>(s,r)=>{let o=E;if(T(r)){const t=s;p(t[e])&&(o=t[e])}B.middleware(s).push({method:e,argument:t,propertyKey:r,callback:o})},Re=e=>{var t;return(null===(t=e.split(".").pop())||void 0===t?void 0:t.toLowerCase())||"bin"},ve=(e,t)=>{var s;return null!==(s=e[t])&&void 0!==s?s:null},Ne=(e,t)=>{const s=_()+"."+t;return D(C(e,s))?Ne(e,t):s},Ae=e=>{const t=d({},e),s=F({destination(e,s,r){var o;const i=ve(t,s.fieldname);r(null,null!==(o=null==i?void 0:i.path)&&void 0!==o?o:"./")},filename(e,s,r){var o;const i=ve(t,s.fieldname);r(null,Ne(null!==(o=null==i?void 0:i.path)&&void 0!==o?o:"./",Re(s.originalname)))}}),r=Math.max(...Object.values(t).map(e=>{var t;return null!==(t=e.size)&&void 0!==t?t:0})),o=P({storage:s,fileFilter(e,s,r){var o;const i=ve(t,s.fieldname);return i?((e,t)=>!t.length||t.includes(Re(e.originalname))||t.includes(e.mimetype.toLowerCase()))(s,null!==(o=null==i?void 0:i.types)&&void 0!==o?o:[])?void r(null,!0):r(new Error(`FILE TYPE NOT ALLOWED FOR "${s.fieldname}"`)):r(new Error(`UPLOAD FIELD "${s.fieldname}" IS NOT CONFIGURED`))},limits:{fileSize:1024*r*1024}}).fields(Object.keys(t).map(e=>{var s,r;return{name:e,maxCount:null!==(r=null===(s=t[e])||void 0===s?void 0:s.count)&&void 0!==r?r:1}}));return(e,t,s)=>{ne(e=>{o(e.req,e.res,t=>{if(t)return"LIMIT_UNEXPECTED_FILE"==t.code&&(t.message=`FIELD "${t.field}" EXCEEDS MAX SIZE`),e.destroy(t);e.next()})})(e,t,s)}},Ie=e=>{const t=O.object(p(e)?e(O):e).parse();return(e,s,r)=>{ne(e=>b(void 0,void 0,void 0,function*(){var s,r;const{error:o,message:i,value:n}=yield t.validateAsync(null!==(r=null===(s=e.req)||void 0===s?void 0:s.body)&&void 0!==r?r:{});if(o)return e.error(new G(null!=i?i:o));e.req.body=n,e.next()}))(e,s,r)}};export{ue as All,z as App,V as Application,X as Argument,w as BadRequestError,Z as Body,ae as Cache,j as Context,Y as Controller,J as Cookies,ee as Ctx,de as Delete,K as Extends,te as Files,H as ForbiddenError,pe as Get,Ee as Head,se as Headers,q as InternalServerError,B as Metadata,le as Methods,me as Middleware,Q as NotFoundError,ce as Options,re as Params,_e as Patch,Te as Post,Oe as Put,oe as Query,M as ResponseError,ie as Session,k as Status,$ as UnauthorizedError,Ae as Upload,ne as Use,Ie as Validate,G as ValidationError,he as methodFactory,W as parameterFactory};
+import{metadata as e,getInjectionArgs as t}from"@andrewcaires/decorator";import{Log as s}from"@andrewcaires/node";import{isNumber as r,isString as o,isObject as i,forEachKey as n,map as a,isUndefined as l,isNull as u,EventEmitter as d,isConstructor as h,merge as c,isFunction as p,noop as E,isArray as _,uuidv7 as m,Validation as R}from"@andrewcaires/utils.js";import T from"compression";import v from"cookie-parser";import O from"cors";import N,{Router as g,json as A,urlencoded as f}from"express";import I from"express-session";import{existsSync as S}from"fs";import*as D from"http";import*as y from"https";import{Server as C}from"net";import{resolve as L,join as x}from"path";import{getClientIp as P}from"request-ip";import U,{diskStorage as M}from"multer";function F(e,t,s,r){return new(s||(s=Promise))(function(o,i){function n(e){try{l(r.next(e))}catch(e){i(e)}}function a(e){try{l(r.throw(e))}catch(e){i(e)}}function l(e){var t;e.done?o(e.value):(t=e.value,t instanceof s?t:new s(function(e){e(t)})).then(n,a)}l((r=r.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;class b{}b.CONTINUE=100,b.SWITCHING_PROTOCOLS=101,b.PROCESSING=102,b.OK=200,b.CREATED=201,b.ACCEPTED=202,b.NON_AUTHORITATIVE_INFORMATION=203,b.NO_CONTENT=204,b.RESET_CONTENT=205,b.PARTIAL_CONTENT=206,b.MULTI_STATUS=207,b.ALREADY_REPORTED=208,b.IM_USED=226,b.MULTIPLE_CHOICES=300,b.MOVED_PERMANENTLY=301,b.FOUND=302,b.SEE_OTHER=303,b.NOT_MODIFIED=304,b.USE_PROXY=305,b.TEMPORARY_REDIRECT=307,b.PERMANENT_REDIRECT=308,b.BAD_REQUEST=400,b.UNAUTHORIZED=401,b.PAYMENT_REQUIRED=402,b.FORBIDDEN=403,b.NOT_FOUND=404,b.METHOD_NOT_ALLOWED=405,b.NOT_ACCEPTABLE=406,b.PROXY_AUTHENTICATION_REQUIRED=407,b.REQUEST_TIMEOUT=408,b.CONFLICT=409,b.GONE=410,b.LENGTH_REQUIRED=411,b.PRECONDITION_FAILED=412,b.PAYLOAD_TOO_LARGE=413,b.REQUEST_URI_TOO_LONG=414,b.UNSUPPORTED_MEDIA_TYPE=415,b.REQUESTED_RANGE_NOT_SATISFIABLE=416,b.EXPECTATION_FAILED=417,b.IM_A_TEAPOT=418,b.MISDIRECTED_REQUEST=421,b.UNPROCESSABLE_ENTITY=422,b.LOCKED=423,b.FAILED_DEPENDENCY=424,b.UPGRADE_REQUIRED=426,b.PRECONDITION_REQUIRED=428,b.TOO_MANY_REQUESTS=429,b.REQUEST_HEADER_FIELDS_TOO_LARGE=431,b.CONNECTION_CLOSED_WITHOUT_RESPONSE=444,b.UNAVAILABLE_FOR_LEGAL_REASONS=451,b.CLIENT_CLOSED_REQUEST=499,b.INTERNAL_SERVER_ERROR=500,b.NOT_IMPLEMENTED=501,b.BAD_GATEWAY=502,b.SERVICE_UNAVAILABLE=503,b.GATEWAY_TIMEOUT=504,b.HTTP_VERSION_NOT_SUPPORTED=505,b.VARIANT_ALSO_NEGOCIATES=506,b.INSUFFICIENT_STORAGE=507,b.LOOP_DETECTED=508,b.NOT_EXTENDED=510,b.NETWORK_AUTHENTICATION_REQUIRED=511,b.NETWORK_CONNECTION_TIMEOUT_ERROR=599;class k{}k[100]="Continue",k[101]="Switching Protocols",k[102]="Processing",k[200]="OK",k[201]="Created",k[202]="Accepted",k[203]="Non-Authoritative Information",k[204]="No Content",k[205]="Reset Content",k[206]="Partial Content",k[207]="Multi-Status",k[226]="IM Used",k[300]="Multiple Choices",k[301]="Moved Permanently",k[302]="Found",k[303]="See Other",k[304]="Not Modified",k[305]="Use Proxy",k[307]="Temporary Redirect",k[308]="Permanent Redirect",k[400]="Bad Request",k[401]="Unauthorized",k[402]="Payment Required",k[403]="Forbidden",k[404]="Not Found",k[405]="Method Not Allowed",k[406]="Not Acceptable",k[407]="Proxy Authentication Required",k[408]="Request Timeout",k[409]="Conflict",k[410]="Gone",k[411]="Length Required",k[412]="Precondition Failed",k[413]="Payload Too Large",k[414]="URI Too Long",k[415]="Unsupported Media Type",k[416]="Range Not Satisfiable",k[417]="Expectation Failed",k[418]="I'm a teapot",k[422]="Unprocessable Entity",k[423]="Locked",k[424]="Failed Dependency",k[426]="Upgrade Required",k[428]="Precondition Required",k[429]="Too Many Requests",k[431]="Request Header Fields Too Large",k[451]="Unavailable For Legal Reasons",k[500]="Internal Server Error",k[501]="Not Implemented",k[502]="Bad Gateway",k[503]="Service Unavailable",k[504]="Gateway Time-out",k[505]="HTTP Version Not Supported",k[506]="Variant Also Negotiates",k[507]="Insufficient Storage",k[511]="Network Authentication Required";class w extends Error{constructor(e,t=b.INTERNAL_SERVER_ERROR){super(e),this.status=t}}class q extends w{constructor(e="Bad Request"){super(e,b.BAD_REQUEST)}}class H extends w{constructor(e="Forbidden"){super(e,b.FORBIDDEN)}}class G extends w{constructor(e="Internal server error"){super(e,b.INTERNAL_SERVER_ERROR)}}class Q extends w{constructor(e="Not Found"){super(e,b.NOT_FOUND)}}class V extends w{constructor(e="Unauthorized"){super(e,b.UNAUTHORIZED)}}class $ extends w{constructor(e){super(e,b.UNPROCESSABLE_ENTITY)}}class B{static created(e,t,s){var r,o;const i=b.CREATED,n={success:!0,status:i,data:t?{id:t}:{},meta:null!==(r=null==s?void 0:s.meta)&&void 0!==r?r:{},message:null!==(o=null==s?void 0:s.message)&&void 0!==o?o:null};return e.status(i).json(n),n}static noContent(e){e.status(b.NO_CONTENT).end()}static ok(e,t,s){var r,o;const i=b.OK,n={success:!0,status:i,data:t,meta:null!==(r=null==s?void 0:s.meta)&&void 0!==r?r:{},message:null!==(o=null==s?void 0:s.message)&&void 0!==o?o:null};return e.status(i).json(n),n}static error(e,t,s){var r,o;const{status:i,message:n}=this.normalizeError(s),a=Object.assign({success:!1,status:i,error:null!==(r=null==k?void 0:k[i])&&void 0!==r?r:"Internal Server Error",message:n,path:null!==(o=e.originalUrl)&&void 0!==o?o:e.url,timestamp:(new Date).toISOString()},this.isDev()&&s instanceof Error&&s.stack?{stack:s.stack}:{});return t.status(i).json(a),a}static isDev(){return"production"!==process.env.NODE_ENV}static normalizeError(e){let t=b.INTERNAL_SERVER_ERROR,s=k[500];if(e instanceof w)return t=this.safeStatus(e.status),s=this.safeMessage(e.message)||s,{status:t,message:s};if(e instanceof Error){const o=e;return r(o.statusCode)?t=this.safeStatus(o.statusCode):r(o.status)&&(t=this.safeStatus(o.status)),s=this.safeMessage(e.message)||s,{status:t,message:s}}if(o(e))return s=this.safeMessage(e)||s,{status:t,message:s};if(e&&i(e)){const i=e;return r(i.statusCode)?t=this.safeStatus(i.statusCode):r(i.status)&&(t=this.safeStatus(i.status)),o(i.message)&&(s=this.safeMessage(i.message)||s),{status:t,message:s}}return{status:t,message:s}}static safeStatus(e){if(!Number.isFinite(e))return b.INTERNAL_SERVER_ERROR;const t=Math.trunc(e);return t<400||t>599?b.INTERNAL_SERVER_ERROR:t}static safeMessage(e){if(!o(e))return"";const t=e.trim();return t.length>2e3?t.slice(0,2e3)+"...":t}}class j{constructor(e,t,s,r,o){this.storage={},this.req=e,this.res=t,this.next=s,this.app=r,this.controller=o}cache(e){const t=Object.assign({},e),s=[];t.private?s.push("private"):t.public&&s.push("public"),t.noStore&&(t.noCache=!0,s.push("no-store")),t.noCache&&(t.maxAge=0,delete t.sMaxAge,s.push("no-cache")),t.noTransform&&s.push("no-transform"),t.proxyRevalidate&&s.push("proxy-revalidate"),t.mustRevalidate?s.push("must-revalidate"):t.noCache||(r(t.staleIfError)&&s.push(`stale-if-error=${t.staleIfError}`),r(t.staleWhileRevalidate)&&s.push(`stale-while-revalidate=${t.staleWhileRevalidate}`)),r(t.maxAge)&&s.push(`max-age=${t.maxAge}`),r(t.sMaxAge)&&s.push(`s-maxage=${t.sMaxAge}`),s.length&&(this.res.setHeader("Cache-Control",s.join(",")),t.noCache&&n({"Surrogate-Control":"no-store",Pragma:"no-cache",ETag:"false",Expires:"0"},(e,t)=>this.res.setHeader(t,e)))}clearCookie(e,t){this.res.clearCookie(e,t)}close(e){this.isResponded()||this.res.json(null!=e?e:this.storage)}destroy(e){var t;e&&this.error(e),null===(t=this.res.socket)||void 0===t||t.destroy(e)}error(e){this.isResponded()||B.error(this.req,this.res,e)}file(e){this.isResponded()||(this.status(b.OK),this.res.sendFile(L(e)))}getBody(){var e,t;return null!==(t=null===(e=this.req)||void 0===e?void 0:e.body)&&void 0!==t?t:{}}getBodyValue(e){var t;return null===(t=this.req.body)||void 0===t?void 0:t[e]}getCookie(e){var t;return this.normalize(null===(t=this.req.cookies)||void 0===t?void 0:t[e])}getCookies(){var e,t;return a(null!==(t=null===(e=this.req)||void 0===e?void 0:e.cookies)&&void 0!==t?t:{},e=>this.normalize(e))}getFiles(){var e,t;return null!==(t=null===(e=this.req)||void 0===e?void 0:e.files)&&void 0!==t?t:{}}getHeader(e){var t;return this.normalize(null===(t=this.req.headers)||void 0===t?void 0:t[e])}getHeaders(){var e,t;return a(null!==(t=null===(e=this.req)||void 0===e?void 0:e.headers)&&void 0!==t?t:{},e=>this.normalize(e))}getIp(){return P(this.req)||"0.0.0.0"}getQuery(e){var t;return this.normalize(null===(t=this.req.query)||void 0===t?void 0:t[e])}getQueries(){var e,t;return a(null!==(t=null===(e=this.req)||void 0===e?void 0:e.query)&&void 0!==t?t:{},e=>this.normalize(e))}getParam(e){var t;const s=null===(t=this.req.params)||void 0===t?void 0:t[e];return l(s)?void 0:String(s)}getParams(){var e,t;return a(null!==(t=null===(e=this.req)||void 0===e?void 0:e.params)&&void 0!==t?t:{},e=>{if(!l(e)&&!u(e))return String(e)})}getUrl(){return`${this.req.protocol}://${this.req.get("host")}${this.req.originalUrl}`}isResponded(){return this.res.headersSent||this.res.writableEnded}json(e){this.send(b.OK,e)}normalize(e){if(!l(e)&&!u(e))return i(e)?JSON.stringify(e):String(e)}ok(e,t){this.isResponded()||B.ok(this.res,e,t)}prepare(e,t){this.isResponded()||(this.status(e),this.storage=t)}send(e,t){this.isResponded()||(this.status(e),204===e||304===e||l(t)?this.res.end():this.res.json(t))}setCookie(e,t,s){this.res.cookie(e,t,null!=s?s:{})}status(e){return l(e)||this.res.status(e),this.res.statusCode}success(e){this.send(b.OK,{message:e})}}class K{static extends(t){return e(K.EXTENDS,t,[])}static middleware(t){return e(K.MIDDLEWARE,t,[])}static parameters(t){return e(K.PARAMETERS,t,[])}static path(t,s){return e(K.PATH,t,s)}static routers(t){return e(K.ROUTERS,t,[])}}K.EXTENDS=Symbol("EXTENDS"),K.MIDDLEWARE=Symbol("MIDDLEWARE"),K.PARAMETERS=Symbol("PARAMETERS"),K.PATH=Symbol("PATH"),K.ROUTERS=Symbol("ROUTERS");class Y extends d{get controllers(){return this._controllers}get instance(){return this._app}get router(){return this._router}get server(){return this._server}constructor(e,s){var r,o;super(),this._app=N(),this._options={},this._base=g(),this._router=g(),this._controllers=[],this._controllers.push(...e.map(e=>h(e)?new e(...t(e)):e)),this._options=c({},{cross:!1,hybrid:!1,path:"/",port:3e3,session:{secret:"yoursecret",resave:!0,saveUninitialized:!1,cookie:{maxAge:864e5}}},null!=s?s:{}),this._app.use(A(this._options.json)),this._app.disable("x-powered-by"),this._app.use(f({extended:!0})),this._options.cross&&this._app.use(O(i(this._options.cross)?this._options.cross:{})),this._app.use(T(this._options.compression)),this._app.use(v(null===(r=this._options.cookie)||void 0===r?void 0:r.secret,this._options.cookie)),this._app.use(I(this._options.session)),this.init(),this._app.use(this._router);const n=(null===(o=this._options.path)||void 0===o?void 0:o.length)?this._options.path:"/";if(this._app.use(n,this._base),this._app.all(n+"/*path",(e,t)=>{this._options.redirect?t.redirect(this._options.redirect):B.error(e,t,new Q("Endpoint Not Found"))}),this._options.public){const e=L(this._options.public);S(e)&&this._app.use(N.static(e)),this._app.get("*path",(t,s)=>{S(e)?s.sendFile(e+"/index.html"):this._options.notfound?s.redirect(this._options.notfound):B.error(t,s,new Q('FILE "index.html" Not Found'))})}else this._app.all("*path",(e,t)=>{this._options.redirect?t.redirect(this._options.redirect):B.error(e,t,new Q("Endpoint not found"))});this._controllers.forEach(e=>{const t=g(),s=this._middlewares(e),r=K.parameters(e);this._extends(e).forEach(e=>{s.push(...this._middlewares(e)),r.push(...K.parameters(e))}),K.routers(e).forEach(o=>{const n=o.propertyKey.toString();if(p(e[n])){if(!p(t[o.method]))return this._notFound(o.method);const a=this._handles(e,n,s,r);return t[o.method](o.path,...a,(t,s,o)=>F(this,void 0,void 0,function*(){const a=new j(t,s,o,this,e),l=this._args(a,this._indexes(n,r)),u=yield e[n](...l);a.close(_(u)||i(u)?u:void 0)}))}this._notFound(`${e.name}.${n}`)}),this._extends(e).forEach(o=>{K.routers(o).forEach(o=>{const n=o.propertyKey.toString();if(p(e[n])){if(!p(t[o.method]))return this._notFound(o.method);const a=this._handles(e,n,s,r);return t[o.method](o.path,...a,(t,s,o)=>F(this,void 0,void 0,function*(){const a=new j(t,s,o,this,e),l=this._args(a,this._indexes(n,r)),u=yield e[n](...l);a.close(_(u)||i(u)?u:void 0)}))}this._notFound(`${e.constructor.name}.${n}`)})}),this._base.use(K.path(e,"/"),t)})}init(){}error(e,t){s.error(e)}log(e,t){s.info(e)}_args(e,t,s){const r=[],o={ctx:e,key:"",app:this,argument:s};return t.forEach(e=>{r[e.parameterIndex]=e.callback(Object.assign(Object.assign({},o),{key:e.key}))}),r}_handles(e,t,s,r){return s.filter(e=>e.propertyKey==t).map(t=>{if(t.callback!=E){const s=this._indexes(t.method,r);return(r,o,n)=>F(this,void 0,void 0,function*(){const a=new j(r,o,n,this,e),l=p(t.argument)?t.argument(a):t.argument,u=yield t.callback.call(e,...this._args(a,s,l));(_(u)||i(u))&&a.close(u)})}this._notFound(t.method)}).filter(p)}_extends(e){return K.extends(e).reduce((e,t)=>(e.push(t,...this._extends(t)),e),[]).filter((e,t,s)=>s.indexOf(e)===t)}_indexes(e,t){return t.filter(t=>t.propertyKey==e)}_middlewares(e){return[...K.middleware(e)].reverse()}_notFound(e){this.error(new Error(`Router "${e}" not found`),"express")}_port(e){return`Server listening on port ${e}`}listen(){return F(this,void 0,void 0,function*(){if(this._options.cert&&this._options.key||(this._server=D.createServer(this._app),this._server.listen(this._options.port,()=>this.log(this._port(this._options.port),"express"))),!this._server){const e=D.createServer((e,t)=>{const s=80==this._options.port?":80":"";t.writeHead(b.MOVED_PERMANENTLY,{Location:`https://${e.headers.host}${s}${e.url}`}),t.end()}),t=y.createServer({key:this._options.key,cert:this._options.cert},this._app);if(this._options.hybrid){new C(s=>{s.once("data",r=>{s.pause(),s.unshift(r),(22===r[0]?t:e).emit("connection",s),process.nextTick(()=>s.resume())})}).listen(this._options.port,()=>this.log(this._port(this._options.port),"express")),this._server=t}this._server||(443==this._options.port&&e.listen(80,()=>this.log(this._port(80),"express")),t.listen(this._options.port,()=>this.log(this._port(this._options.port),"express")),this._server=t)}})}}const z=e=>t=>{K.path(t,(null==e?void 0:e.length)?e:"/")},W=e=>t=>{K.extends(t).push(e)},X=e=>t=>(s,r,o)=>{K.parameters(s).push({callback:e,key:t,propertyKey:r,parameterIndex:o})},Z=X(({app:e})=>e),J=X(({argument:e})=>e),ee=X(({ctx:e,key:t})=>t?e.getBodyValue(t):e.getBody()),te=X(({ctx:e,key:t})=>t?e.getCookie(t):e.getCookies()),se=X(({ctx:e})=>e),re=X(({ctx:e})=>e.getFiles()),oe=X(({ctx:e,key:t})=>t?e.getHeader(t):e.getHeaders()),ie=X(({ctx:e,key:t})=>t?e.getParam(t):e.getParams()),ne=X(({ctx:e,key:t})=>t?e.getQuery(t):e.getQueries()),ae=X(({ctx:e})=>{var t;return null===(t=e.req)||void 0===t?void 0:t.session}),le=(e,t)=>(s,r)=>{const o=m();se()(s,o,0),K.middleware(s).push({method:o,argument:t,propertyKey:r,callback:e})},ue=e=>(t,s,r)=>{le(t=>{t.cache(Object.assign({},e)),t.next()})(t,s,r)},de={ALL:"all",GET:"get",POST:"post",PUT:"put",HEAD:"head",DELETE:"delete",OPTIONS:"options",PATCH:"patch"},he=e=>t=>(s,r)=>{K.routers(s).push({method:e,path:(null==t?void 0:t.length)?t:"/",propertyKey:r})},ce=he(de.ALL),pe=he(de.DELETE),Ee=he(de.GET),_e=he(de.HEAD),me=he(de.OPTIONS),Re=he(de.PATCH),Te=he(de.POST),ve=he(de.PUT),Oe=(e,t)=>(s,r)=>{let i=E;if(o(r)){const t=s;p(t[e])&&(i=t[e])}K.middleware(s).push({method:e,argument:t,propertyKey:r,callback:i})},Ne=e=>{var t;return(null===(t=e.split(".").pop())||void 0===t?void 0:t.toLowerCase())||"bin"},ge=(e,t)=>{var s;return null!==(s=e[t])&&void 0!==s?s:null},Ae=(e,t)=>{const s=m()+"."+t;return S(x(e,s))?Ae(e,t):s},fe=e=>{const t=c({},e),s=M({destination(e,s,r){var o;const i=ge(t,s.fieldname);r(null,null!==(o=null==i?void 0:i.path)&&void 0!==o?o:"./")},filename(e,s,r){var o;const i=ge(t,s.fieldname);r(null,Ae(null!==(o=null==i?void 0:i.path)&&void 0!==o?o:"./",Ne(s.originalname)))}}),r=Math.max(...Object.values(t).map(e=>{var t;return null!==(t=e.size)&&void 0!==t?t:0})),o=U({storage:s,fileFilter(e,s,r){var o;const i=ge(t,s.fieldname);return i?((e,t)=>!t.length||t.includes(Ne(e.originalname))||t.includes(e.mimetype.toLowerCase()))(s,null!==(o=null==i?void 0:i.types)&&void 0!==o?o:[])?void r(null,!0):r(new Error(`FILE TYPE NOT ALLOWED FOR "${s.fieldname}"`)):r(new Error(`UPLOAD FIELD "${s.fieldname}" IS NOT CONFIGURED`))},limits:{fileSize:1024*r*1024}}).fields(Object.keys(t).map(e=>{var s,r;return{name:e,maxCount:null!==(r=null===(s=t[e])||void 0===s?void 0:s.count)&&void 0!==r?r:1}}));return(e,t,s)=>{le(e=>{o(e.req,e.res,t=>{if(t)return"LIMIT_UNEXPECTED_FILE"==t.code&&(t.message=`FIELD "${t.field}" EXCEEDS MAX SIZE`),e.destroy(t);e.next()})})(e,t,s)}},Ie=e=>{const t=R.object(p(e)?e(R):e).parse();return(e,s,r)=>{le(e=>F(void 0,void 0,void 0,function*(){var s,r;const{error:o,message:i,value:n}=yield t.validateAsync(null!==(r=null===(s=e.req)||void 0===s?void 0:s.body)&&void 0!==r?r:{});if(o)return e.error(new $(null!=i?i:o));e.req.body=n,e.next()}))(e,s,r)}};export{ce as All,Z as App,Y as Application,J as Argument,q as BadRequestError,ee as Body,ue as Cache,j as Context,z as Controller,te as Cookies,se as Ctx,pe as Delete,W as Extends,re as Files,H as ForbiddenError,Ee as Get,_e as Head,oe as Headers,B as HttpResponse,G as InternalServerError,K as Metadata,de as Methods,Oe as Middleware,Q as NotFoundError,me as Options,ie as Params,Re as Patch,Te as Post,ve as Put,ne as Query,w as ResponseError,ae as Session,b as StatusCodes,k as StatusText,V as UnauthorizedError,fe as Upload,le as Use,Ie as Validate,$ as ValidationError,he as methodFactory,X as parameterFactory};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewcaires/express",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Decorators for express",
   "type": "module",
   "main": "./dist/index.cjs.js",
@@ -53,7 +53,7 @@
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@rollup/rollup-darwin-arm64": "^4.58.0",
+    "@rollup/rollup-darwin-arm64": "^4.59.0",
     "@types/compression": "^1.8.1",
     "@types/cookie-parser": "^1.4.10",
     "@types/cors": "^2.8.19",
@@ -63,10 +63,10 @@
     "@types/node": "^25.3.0",
     "@types/request-ip": "^0.0.41",
     "@types/swagger-ui-express": "^4.1.8",
-    "eslint": "^10.0.1",
+    "eslint": "^10.0.2",
     "rollup-plugin-dts": "^6.3.0",
     "swagger-ui-express": "^5.0.1",
     "tslib": "^2.8.1",
-    "typescript-eslint": "^8.56.0"
+    "typescript-eslint": "^8.56.1"
   }
 }