Spaces:
Runtime error
Runtime error
| ; | |
| Object.defineProperty(exports, "__esModule", { value: true }); | |
| exports.uServer = void 0; | |
| const debug_1 = require("debug"); | |
| const server_1 = require("./server"); | |
| const transports_uws_1 = require("./transports-uws"); | |
| const debug = (0, debug_1.default)("engine:uws"); | |
| class uServer extends server_1.BaseServer { | |
| init() { } | |
| cleanup() { } | |
| /** | |
| * Prepares a request by processing the query string. | |
| * | |
| * @api private | |
| */ | |
| prepare(req, res) { | |
| req.method = req.getMethod().toUpperCase(); | |
| req.url = req.getUrl(); | |
| const params = new URLSearchParams(req.getQuery()); | |
| req._query = Object.fromEntries(params.entries()); | |
| req.headers = {}; | |
| req.forEach((key, value) => { | |
| req.headers[key] = value; | |
| }); | |
| req.connection = { | |
| remoteAddress: Buffer.from(res.getRemoteAddressAsText()).toString(), | |
| }; | |
| res.onAborted(() => { | |
| debug("response has been aborted"); | |
| }); | |
| } | |
| createTransport(transportName, req) { | |
| return new transports_uws_1.default[transportName](req); | |
| } | |
| /** | |
| * Attach the engine to a µWebSockets.js server | |
| * @param app | |
| * @param options | |
| */ | |
| attach(app /* : TemplatedApp */, options = {}) { | |
| const path = this._computePath(options); | |
| app | |
| .any(path, this.handleRequest.bind(this)) | |
| // | |
| .ws(path, { | |
| compression: options.compression, | |
| idleTimeout: options.idleTimeout, | |
| maxBackpressure: options.maxBackpressure, | |
| maxPayloadLength: this.opts.maxHttpBufferSize, | |
| upgrade: this.handleUpgrade.bind(this), | |
| open: (ws) => { | |
| const transport = ws.getUserData().transport; | |
| transport.socket = ws; | |
| transport.writable = true; | |
| transport.emit("drain"); | |
| }, | |
| message: (ws, message, isBinary) => { | |
| ws.getUserData().transport.onData(isBinary ? message : Buffer.from(message).toString()); | |
| }, | |
| close: (ws, code, message) => { | |
| ws.getUserData().transport.onClose(code, message); | |
| }, | |
| }); | |
| } | |
| _applyMiddlewares(req, res, callback) { | |
| if (this.middlewares.length === 0) { | |
| return callback(); | |
| } | |
| // needed to buffer headers until the status is computed | |
| req.res = new ResponseWrapper(res); | |
| super._applyMiddlewares(req, req.res, (err) => { | |
| // some middlewares (like express-session) wait for the writeHead() call to flush their headers | |
| // see https://github.com/expressjs/session/blob/1010fadc2f071ddf2add94235d72224cf65159c6/index.js#L220-L244 | |
| req.res.writeHead(); | |
| callback(err); | |
| }); | |
| } | |
| handleRequest(res, req) { | |
| debug('handling "%s" http request "%s"', req.getMethod(), req.getUrl()); | |
| this.prepare(req, res); | |
| req.res = res; | |
| const callback = (errorCode, errorContext) => { | |
| if (errorCode !== undefined) { | |
| this.emit("connection_error", { | |
| req, | |
| code: errorCode, | |
| message: server_1.Server.errorMessages[errorCode], | |
| context: errorContext, | |
| }); | |
| this.abortRequest(req.res, errorCode, errorContext); | |
| return; | |
| } | |
| if (req._query.sid) { | |
| debug("setting new request for existing client"); | |
| this.clients[req._query.sid].transport.onRequest(req); | |
| } | |
| else { | |
| const closeConnection = (errorCode, errorContext) => this.abortRequest(res, errorCode, errorContext); | |
| this.handshake(req._query.transport, req, closeConnection); | |
| } | |
| }; | |
| this._applyMiddlewares(req, res, (err) => { | |
| if (err) { | |
| callback(server_1.Server.errors.BAD_REQUEST, { name: "MIDDLEWARE_FAILURE" }); | |
| } | |
| else { | |
| this.verify(req, false, callback); | |
| } | |
| }); | |
| } | |
| handleUpgrade(res, req, context) { | |
| debug("on upgrade"); | |
| this.prepare(req, res); | |
| req.res = res; | |
| const callback = async (errorCode, errorContext) => { | |
| if (errorCode !== undefined) { | |
| this.emit("connection_error", { | |
| req, | |
| code: errorCode, | |
| message: server_1.Server.errorMessages[errorCode], | |
| context: errorContext, | |
| }); | |
| this.abortRequest(res, errorCode, errorContext); | |
| return; | |
| } | |
| const id = req._query.sid; | |
| let transport; | |
| if (id) { | |
| const client = this.clients[id]; | |
| if (!client) { | |
| debug("upgrade attempt for closed client"); | |
| res.close(); | |
| } | |
| else if (client.upgrading) { | |
| debug("transport has already been trying to upgrade"); | |
| res.close(); | |
| } | |
| else if (client.upgraded) { | |
| debug("transport had already been upgraded"); | |
| res.close(); | |
| } | |
| else { | |
| debug("upgrading existing transport"); | |
| transport = this.createTransport(req._query.transport, req); | |
| client.maybeUpgrade(transport); | |
| } | |
| } | |
| else { | |
| transport = await this.handshake(req._query.transport, req, (errorCode, errorContext) => this.abortRequest(res, errorCode, errorContext)); | |
| if (!transport) { | |
| return; | |
| } | |
| } | |
| // calling writeStatus() triggers the flushing of any header added in a middleware | |
| req.res.writeStatus("101 Switching Protocols"); | |
| res.upgrade({ | |
| transport, | |
| }, req.getHeader("sec-websocket-key"), req.getHeader("sec-websocket-protocol"), req.getHeader("sec-websocket-extensions"), context); | |
| }; | |
| this._applyMiddlewares(req, res, (err) => { | |
| if (err) { | |
| callback(server_1.Server.errors.BAD_REQUEST, { name: "MIDDLEWARE_FAILURE" }); | |
| } | |
| else { | |
| this.verify(req, true, callback); | |
| } | |
| }); | |
| } | |
| abortRequest(res, errorCode, errorContext) { | |
| const statusCode = errorCode === server_1.Server.errors.FORBIDDEN | |
| ? "403 Forbidden" | |
| : "400 Bad Request"; | |
| const message = errorContext && errorContext.message | |
| ? errorContext.message | |
| : server_1.Server.errorMessages[errorCode]; | |
| res.writeStatus(statusCode); | |
| res.writeHeader("Content-Type", "application/json"); | |
| res.end(JSON.stringify({ | |
| code: errorCode, | |
| message, | |
| })); | |
| } | |
| } | |
| exports.uServer = uServer; | |
| class ResponseWrapper { | |
| constructor(res) { | |
| this.res = res; | |
| this.statusWritten = false; | |
| this.headers = []; | |
| this.isAborted = false; | |
| } | |
| set statusCode(status) { | |
| if (!status) { | |
| return; | |
| } | |
| // FIXME: handle all status codes? | |
| this.writeStatus(status === 200 ? "200 OK" : "204 No Content"); | |
| } | |
| writeHead(status) { | |
| this.statusCode = status; | |
| } | |
| setHeader(key, value) { | |
| if (Array.isArray(value)) { | |
| value.forEach((val) => { | |
| this.writeHeader(key, val); | |
| }); | |
| } | |
| else { | |
| this.writeHeader(key, value); | |
| } | |
| } | |
| removeHeader() { | |
| // FIXME: not implemented | |
| } | |
| // needed by vary: https://github.com/jshttp/vary/blob/5d725d059b3871025cf753e9dfa08924d0bcfa8f/index.js#L134 | |
| getHeader() { } | |
| writeStatus(status) { | |
| if (this.isAborted) | |
| return; | |
| this.res.writeStatus(status); | |
| this.statusWritten = true; | |
| this.writeBufferedHeaders(); | |
| return this; | |
| } | |
| writeHeader(key, value) { | |
| if (this.isAborted) | |
| return; | |
| if (key === "Content-Length") { | |
| // the content length is automatically added by uWebSockets.js | |
| return; | |
| } | |
| if (this.statusWritten) { | |
| this.res.writeHeader(key, value); | |
| } | |
| else { | |
| this.headers.push([key, value]); | |
| } | |
| } | |
| writeBufferedHeaders() { | |
| this.headers.forEach(([key, value]) => { | |
| this.res.writeHeader(key, value); | |
| }); | |
| } | |
| end(data) { | |
| if (this.isAborted) | |
| return; | |
| this.res.cork(() => { | |
| if (!this.statusWritten) { | |
| // status will be inferred as "200 OK" | |
| this.writeBufferedHeaders(); | |
| } | |
| this.res.end(data); | |
| }); | |
| } | |
| onData(fn) { | |
| if (this.isAborted) | |
| return; | |
| this.res.onData(fn); | |
| } | |
| onAborted(fn) { | |
| if (this.isAborted) | |
| return; | |
| this.res.onAborted(() => { | |
| // Any attempt to use the UWS response object after abort will throw! | |
| this.isAborted = true; | |
| fn(); | |
| }); | |
| } | |
| cork(fn) { | |
| if (this.isAborted) | |
| return; | |
| this.res.cork(fn); | |
| } | |
| } | |