@opra/http 1.21.0 → 1.22.0

package/cjs/http-handler.js

@@ -1,668 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpHandler = void 0;
-const tslib_1 = require("tslib");
-const process = tslib_1.__importStar(require("node:process"));
-const type_is_1 = tslib_1.__importDefault(require("@browsery/type-is"));
-const common_1 = require("@opra/common");
-const core_1 = require("@opra/core");
-const content_type_1 = require("content-type");
-const fast_tokenizer_1 = require("fast-tokenizer");
-const super_fast_md5_1 = require("super-fast-md5");
-const ts_gems_1 = require("ts-gems");
-const valgen_1 = require("valgen");
-const wrap_exception_js_1 = require("./utils/wrap-exception.js");
-/**
- * @class HttpHandler
- */
-class HttpHandler {
-    constructor(adapter) {
-        this.adapter = adapter;
-        this[core_1.kAssetCache] = adapter[core_1.kAssetCache];
-    }
-    /**
-     * Main http request handler
-     * @param context
-     * @protected
-     */
-    async handleRequest(context) {
-        const { response } = context;
-        try {
-            response.setHeader(common_1.HttpHeaderCodes.X_Opra_Version, common_1.OpraSchema.SpecVersion);
-            // Expose headers if cors enabled
-            if (response.getHeader(common_1.HttpHeaderCodes.Access_Control_Allow_Origin)) {
-                // Expose X-Opra-* headers
-                response.appendHeader(common_1.HttpHeaderCodes.Access_Control_Expose_Headers, Object.values(common_1.HttpHeaderCodes).filter(k => k.toLowerCase().startsWith('x-opra-')));
-            }
-            // Parse request
-            try {
-                await this.parseRequest(context);
-            }
-            catch (e) {
-                if (e instanceof common_1.OpraException)
-                    throw e;
-                if (e instanceof valgen_1.ValidationError) {
-                    throw new common_1.BadRequestError({
-                        message: 'Request validation failed',
-                        code: 'REQUEST_VALIDATION',
-                        details: e.issues,
-                    }, e);
-                }
-                throw new common_1.BadRequestError(e);
-            }
-            await this.adapter.emitAsync('request', context);
-            // Call interceptors than execute request
-            if (this.adapter.interceptors) {
-                const interceptors = this.adapter.interceptors;
-                let i = 0;
-                const next = async () => {
-                    const interceptor = interceptors[i++];
-                    if (typeof interceptor === 'function')
-                        await interceptor(context, next);
-                    else if (typeof interceptor?.intercept === 'function')
-                        await interceptor.intercept(context, next);
-                    await this._executeRequest(context);
-                };
-                await next();
-            }
-            else
-                await this._executeRequest(context);
-        }
-        catch (error) {
-            let e = error;
-            if (e instanceof valgen_1.ValidationError) {
-                e = new common_1.InternalServerError({
-                    message: 'Response validation failed',
-                    code: 'RESPONSE_VALIDATION',
-                    details: e.issues,
-                }, e);
-            }
-            else
-                e = (0, wrap_exception_js_1.wrapException)(e);
-            if (this.onError)
-                await this.onError(context, error);
-            context.errors.push(e);
-            await this.sendResponse(context);
-        }
-        finally {
-            await context.emitAsync('finish', context);
-        }
-    }
-    /**
-     *
-     * @param context
-     */
-    async parseRequest(context) {
-        await this._parseParameters(context);
-        await this._parseContentType(context);
-        if (context.__oprDef?.requestBody?.immediateFetch)
-            await context.getBody();
-        /** Set default status code as the first status code between 200 and 299 */
-        if (context.__oprDef) {
-            for (const r of context.__oprDef.responses) {
-                const st = r.statusCode.find(sc => sc.start <= 299 && sc.end >= 200);
-                if (st) {
-                    context.response.status(st.start);
-                    break;
-                }
-            }
-        }
-    }
-    /**
-     *
-     * @param context
-     * @protected
-     */
-    async _parseParameters(context) {
-        const { __oprDef, request } = context;
-        if (!__oprDef)
-            return;
-        let key = '';
-        try {
-            const onFail = (issue) => {
-                issue.location = key;
-                return issue;
-            };
-            /** prepare decoders */
-            const getDecoder = (prm) => {
-                let decode = this[core_1.kAssetCache].get(prm, 'decode');
-                if (!decode) {
-                    decode = prm.generateCodec('decode', {
-                        scope: this.adapter.scope,
-                        ignoreReadonlyFields: true,
-                    });
-                    this[core_1.kAssetCache].set(prm, 'decode', decode);
-                }
-                return decode;
-            };
-            const paramsLeft = new Set([
-                ...__oprDef.parameters,
-                ...__oprDef.owner.parameters,
-            ]);
-            /** parse cookie parameters */
-            if (request.cookies) {
-                for (key of Object.keys(request.cookies)) {
-                    const oprPrm = __oprDef.findParameter(key, 'cookie');
-                    const cntPrm = __oprDef.owner.findParameter(key, 'cookie');
-                    const prm = oprPrm || cntPrm;
-                    if (!prm)
-                        continue;
-                    if (oprPrm)
-                        paramsLeft.delete(oprPrm);
-                    if (cntPrm)
-                        paramsLeft.delete(cntPrm);
-                    const decode = getDecoder(prm);
-                    const v = decode(request.cookies[key], {
-                        coerce: true,
-                        label: key,
-                        onFail,
-                    });
-                    const prmName = typeof prm.name === 'string' ? prm.name : key;
-                    if (v !== undefined)
-                        context.cookies[prmName] = v;
-                }
-            }
-            /** parse headers */
-            if (request.headers) {
-                for (key of Object.keys(request.headers)) {
-                    const oprPrm = __oprDef.findParameter(key, 'header');
-                    const cntPrm = __oprDef.owner.findParameter(key, 'header');
-                    const prm = oprPrm || cntPrm;
-                    if (!prm)
-                        continue;
-                    if (oprPrm)
-                        paramsLeft.delete(oprPrm);
-                    if (cntPrm)
-                        paramsLeft.delete(cntPrm);
-                    const decode = getDecoder(prm);
-                    const v = decode(request.headers[key], {
-                        coerce: true,
-                        label: key,
-                        onFail,
-                    });
-                    const prmName = typeof prm.name === 'string' ? prm.name : key;
-                    if (v !== undefined)
-                        context.headers[prmName] = v;
-                }
-            }
-            /** parse path parameters */
-            if (request.params) {
-                for (key of Object.keys(request.params)) {
-                    const oprPrm = __oprDef.findParameter(key, 'path');
-                    const cntPrm = __oprDef.owner.findParameter(key, 'path');
-                    const prm = oprPrm || cntPrm;
-                    if (!prm)
-                        continue;
-                    if (oprPrm)
-                        paramsLeft.delete(oprPrm);
-                    if (cntPrm)
-                        paramsLeft.delete(cntPrm);
-                    const decode = getDecoder(prm);
-                    const v = decode(request.params[key], {
-                        coerce: true,
-                        label: key,
-                        onFail,
-                    });
-                    if (v !== undefined)
-                        context.pathParams[key] = v;
-                }
-            }
-            /** parse query parameters */
-            const url = new URL(request.originalUrl || request.url || '/', 'http://tempuri.org');
-            const { searchParams } = url;
-            for (key of searchParams.keys()) {
-                const oprPrm = __oprDef.findParameter(key, 'query');
-                const cntPrm = __oprDef.owner.findParameter(key, 'query');
-                const prm = oprPrm || cntPrm;
-                if (!prm)
-                    continue;
-                if (oprPrm)
-                    paramsLeft.delete(oprPrm);
-                if (cntPrm)
-                    paramsLeft.delete(cntPrm);
-                const decode = getDecoder(prm);
-                let values = searchParams?.getAll(key);
-                const prmName = typeof prm.name === 'string' ? prm.name : key;
-                if (values?.length && prm.isArray) {
-                    values = values
-                        .map(v => (0, fast_tokenizer_1.splitString)(v, {
-                        delimiters: prm.arraySeparator || ',',
-                        quotes: true,
-                    }))
-                        .flat();
-                    values = values.map(v => decode(v, { coerce: true, label: key, onFail }));
-                    if (prm.parser)
-                        values = prm.parser(values);
-                    if (values.length)
-                        context.queryParams[prmName] = values;
-                }
-                else {
-                    let v = decode(values[0], { coerce: true, label: key, onFail });
-                    if (prm.parser)
-                        v = prm.parser(v);
-                    if (values.length)
-                        context.queryParams[prmName] = v;
-                }
-            }
-            for (const prm of paramsLeft) {
-                key = String(prm.name);
-                // Throw error for required parameters
-                if (prm.required) {
-                    const decode = getDecoder(prm);
-                    decode(undefined, { coerce: true, label: String(prm.name), onFail });
-                }
-            }
-        }
-        catch (e) {
-            if (e instanceof valgen_1.ValidationError) {
-                throw new common_1.BadRequestError({
-                    message: `Invalid parameter (${key}) value. ` + e.message,
-                    code: 'REQUEST_VALIDATION',
-                    details: e.issues,
-                }, e);
-            }
-            throw e;
-        }
-    }
-    /**
-     *
-     * @param context
-     * @protected
-     */
-    async _parseContentType(context) {
-        const { request, __oprDef } = context;
-        if (!__oprDef)
-            return;
-        if (__oprDef.requestBody?.content.length) {
-            let mediaType;
-            let contentType = request.header('content-type');
-            if (contentType) {
-                contentType = (0, content_type_1.parse)(contentType).type;
-                mediaType = __oprDef.requestBody.content.find(mc => mc.contentType &&
-                    type_is_1.default.is(contentType, Array.isArray(mc.contentType) ? mc.contentType : [mc.contentType]));
-            }
-            if (!mediaType) {
-                const contentTypes = __oprDef.requestBody.content
-                    .map(mc => mc.contentType)
-                    .flat();
-                throw new common_1.BadRequestError(`Request body should be one of required content types (${contentTypes.join(', ')})`);
-            }
-            (0, ts_gems_1.asMutable)(context).mediaType = mediaType;
-        }
-    }
-    /**
-     *
-     * @param context
-     * @protected
-     */
-    async _executeRequest(context) {
-        if (!context.__handler)
-            throw new common_1.MethodNotAllowedError();
-        const responseValue = await context.__handler.call(context.__controller, context);
-        const { response } = context;
-        if (!response.writableEnded) {
-            await this.sendResponse(context, responseValue).finally(() => {
-                if (!response.writableEnded)
-                    response.end();
-            });
-        }
-    }
-    /**
-     *
-     * @param context
-     * @param responseValue
-     * @protected
-     */
-    async sendResponse(context, responseValue) {
-        if (context.errors.length)
-            return this._sendErrorResponse(context);
-        const { response } = context;
-        const { document } = this.adapter;
-        try {
-            const responseArgs = this._determineResponseArgs(context, responseValue);
-            const { operationResponse, statusCode } = responseArgs;
-            let { contentType, body } = responseArgs;
-            const operationResultType = document.node.getDataType(common_1.OperationResult);
-            let operationResultEncoder = this[core_1.kAssetCache].get(operationResultType, 'encode');
-            if (!operationResultEncoder) {
-                operationResultEncoder = operationResultType.generateCodec('encode', {
-                    scope: this.adapter.scope,
-                    ignoreWriteonlyFields: true,
-                });
-                this[core_1.kAssetCache].set(operationResultType, 'encode', operationResultEncoder);
-            }
-            /** Validate response */
-            if (operationResponse?.type) {
-                if (!(body == null &&
-                    statusCode === common_1.HttpStatusCode.NO_CONTENT)) {
-                    /** Generate encoder */
-                    const projection = responseArgs.projection || '*';
-                    const assetKey = (0, super_fast_md5_1.md5)(String(projection));
-                    let encode = this[core_1.kAssetCache].get(operationResponse, 'encode:' + assetKey);
-                    if (!encode) {
-                        encode = operationResponse.type.generateCodec('encode', {
-                            scope: this.adapter.scope,
-                            partial: operationResponse.partial,
-                            projection,
-                            ignoreWriteonlyFields: true,
-                            onFail: issue => `Response body validation failed: ` + issue.message,
-                        });
-                        if (operationResponse) {
-                            if (operationResponse.isArray)
-                                encode = valgen_1.vg.isArray(encode);
-                            this[core_1.kAssetCache].set(operationResponse, 'encode:' + assetKey, encode);
-                        }
-                    }
-                    /** Encode body */
-                    if (operationResponse.type.extendsFrom(operationResultType)) {
-                        if (body instanceof common_1.OperationResult)
-                            body = encode(body);
-                        else {
-                            body.payload = encode(body.payload);
-                            body = operationResultEncoder(body);
-                        }
-                    }
-                    else {
-                        if (body instanceof common_1.OperationResult &&
-                            contentType &&
-                            type_is_1.default.is(contentType, [common_1.MimeTypes.opra_response_json])) {
-                            body.payload = encode(body.payload);
-                            body = operationResultEncoder(body);
-                        }
-                        else {
-                            body = encode(body);
-                        }
-                    }
-                    if (body instanceof common_1.OperationResult &&
-                        operationResponse.type &&
-                        operationResponse.type !==
-                            document.node.getDataType(common_1.OperationResult)) {
-                        body.type = operationResponse.type.name
-                            ? operationResponse.type.name
-                            : '#embedded';
-                    }
-                }
-            }
-            else if (body != null) {
-                if (body instanceof common_1.OperationResult) {
-                    body = operationResultEncoder(body);
-                    contentType = common_1.MimeTypes.opra_response_json;
-                }
-                else if (Buffer.isBuffer(body))
-                    contentType = common_1.MimeTypes.binary;
-                else if (typeof body === 'object') {
-                    contentType = contentType || common_1.MimeTypes.json;
-                    if (typeof body.toJSON === 'function')
-                        body = body.toJSON();
-                }
-                else {
-                    contentType = contentType || common_1.MimeTypes.text;
-                    body = String(body);
-                }
-            }
-            /** Set content-type header value if not set */
-            if (contentType && contentType !== responseArgs.contentType)
-                response.setHeader('content-type', contentType);
-            response.status(statusCode);
-            if (body == null) {
-                response.end();
-                return;
-            }
-            let x;
-            if (Buffer.isBuffer(body) || (0, common_1.isReadableStream)(body))
-                x = body;
-            else if ((0, common_1.isBlob)(body))
-                x = body.stream();
-            else if (typeof body === 'object')
-                x = JSON.stringify(body);
-            else
-                x = String(body);
-            response.end(x);
-        }
-        catch (error) {
-            context.errors.push(error);
-            return this._sendErrorResponse(context);
-        }
-    }
-    async _sendErrorResponse(context) {
-        let errors = (context.errors = this._wrapExceptions(context.errors));
-        try {
-            if (context.listenerCount('error')) {
-                await context.emitAsync('error', errors[0], context);
-                errors = context.errors = this._wrapExceptions(context.errors);
-            }
-            if (this.adapter.listenerCount('error')) {
-                await this.adapter.emitAsync('error', errors[0], context);
-                errors = context.errors = this._wrapExceptions(errors);
-            }
-            if (this.adapter.logger?.error) {
-                const logger = this.adapter.logger;
-                errors.forEach(e => {
-                    if (e.status >= 500 && e.status < 600)
-                        logger.error(e);
-                });
-            }
-        }
-        catch (e) {
-            context.errors = this._wrapExceptions([e, ...context.errors]);
-        }
-        const { response } = context;
-        if (response.headersSent) {
-            response.end();
-            return;
-        }
-        let status = response.statusCode || 0;
-        if (!status || status < Number(common_1.HttpStatusCode.BAD_REQUEST)) {
-            status = errors[0].status;
-            if (status < Number(common_1.HttpStatusCode.BAD_REQUEST))
-                status = common_1.HttpStatusCode.INTERNAL_SERVER_ERROR;
-        }
-        response.statusCode = status;
-        const { document } = this.adapter;
-        const dt = document.node.getComplexType('OperationResult');
-        let encode = this[core_1.kAssetCache].get(dt, 'encode');
-        if (!encode) {
-            encode = dt.generateCodec('encode', {
-                scope: this.adapter.scope,
-                ignoreWriteonlyFields: true,
-            });
-            this[core_1.kAssetCache].set(dt, 'encode', encode);
-        }
-        // const { i18n } = this.adapter;
-        const bodyObject = new common_1.OperationResult({
-            errors: errors.map(x => {
-                const o = x.toJSON();
-                if (!(process.env.NODE_ENV === 'dev' ||
-                    process.env.NODE_ENV === 'development'))
-                    delete o.stack;
-                return o; // i18n.deep(o);
-            }),
-        });
-        const body = encode(bodyObject);
-        response.setHeader(common_1.HttpHeaderCodes.Content_Type, common_1.MimeTypes.opra_response_json + '; charset=utf-8');
-        response.setHeader(common_1.HttpHeaderCodes.Cache_Control, 'no-cache');
-        response.setHeader(common_1.HttpHeaderCodes.Pragma, 'no-cache');
-        response.setHeader(common_1.HttpHeaderCodes.Expires, '-1');
-        response.setHeader(common_1.HttpHeaderCodes.X_Opra_Version, common_1.OpraSchema.SpecVersion);
-        response.send((0, common_1.safeJsonStringify)(body));
-        response.end();
-    }
-    async sendDocumentSchema(context) {
-        const { request, response } = context;
-        const { document } = this.adapter;
-        response.setHeader('content-type', common_1.MimeTypes.json);
-        const url = new URL(request.originalUrl || request.url || '/', 'http://tempuri.org');
-        const { searchParams } = url;
-        const documentId = searchParams.get('id');
-        const doc = documentId ? document.findDocument(documentId) : document;
-        if (!doc) {
-            context.errors.push(new common_1.BadRequestError({
-                message: `Document with given id [${documentId}] does not exists`,
-            }));
-            return this.sendResponse(context);
-        }
-        /** Check if response cache exists */
-        let responseBody = this[core_1.kAssetCache].get(doc, `$schema`);
-        /** Create response if response cache does not exists */
-        if (!responseBody) {
-            const schema = doc.export({
-                scope: this.adapter.scope,
-            });
-            responseBody = JSON.stringify(schema);
-            this[core_1.kAssetCache].set(doc, `$schema`, responseBody);
-        }
-        response.end(responseBody);
-    }
-    /**
-     *
-     * @param context
-     * @param body
-     * @protected
-     */
-    _determineResponseArgs(context, body) {
-        const { response, __oprDef } = context;
-        const hasBody = body != null;
-        const statusCode = !hasBody && response.statusCode === common_1.HttpStatusCode.OK
-            ? common_1.HttpStatusCode.NO_CONTENT
-            : response.statusCode;
-        /** Parse content-type header */
-        const parsedContentType = hasBody && response.hasHeader('content-type')
-            ? (0, content_type_1.parse)(response)
-            : undefined;
-        let contentType = parsedContentType?.type;
-        /** Estimate content type if not defined */
-        if (hasBody && !contentType) {
-            if (body instanceof common_1.OperationResult)
-                contentType = common_1.MimeTypes.opra_response_json;
-            else if (Buffer.isBuffer(body))
-                contentType = common_1.MimeTypes.binary;
-        }
-        let operationResponse;
-        const cacheKey = `HttpOperationResponse:${statusCode}${contentType ? ':' + contentType : ''}`;
-        let responseArgs = this[core_1.kAssetCache].get(response, cacheKey);
-        if (!responseArgs) {
-            responseArgs = { statusCode, contentType };
-            if (__oprDef?.responses.length) {
-                /** Filter available HttpOperationResponse instances according to status code. */
-                const filteredResponses = __oprDef.responses.filter(r => r.statusCode.find(sc => sc.start <= statusCode && sc.end >= statusCode));
-                /** Throw InternalServerError if controller returns non-configured status code */
-                if (!filteredResponses.length && statusCode < 400) {
-                    throw new common_1.InternalServerError(`No responses defined for status code ${statusCode} in operation "${__oprDef.name}"`);
-                }
-                /** We search for content-type in filtered HttpOperationResponse array */
-                if (filteredResponses.length) {
-                    /** If no response returned, and content-type has not been set (No response wants to be returned by operation) */
-                    if (!hasBody) {
-                        /** Find HttpOperationResponse with no content-type */
-                        operationResponse = filteredResponses.find(r => !r.contentType);
-                    }
-                    if (!operationResponse) {
-                        /** Find HttpOperationResponse according to content-type */
-                        if (contentType) {
-                            // Find HttpEndpointResponse instance according to content-type header
-                            operationResponse = filteredResponses.find(r => type_is_1.default.is(contentType, (0, valgen_1.toArray)(r.contentType)));
-                            if (!operationResponse) {
-                                throw new common_1.InternalServerError(`Operation didn't configured to return "${contentType}" content`);
-                            }
-                        }
-                        else {
-                            /** Select first HttpOperationResponse if content-type header has not been set */
-                            operationResponse = filteredResponses[0];
-                            if (operationResponse.contentType) {
-                                const ct = type_is_1.default.normalize(Array.isArray(operationResponse.contentType)
-                                    ? operationResponse.contentType[0]
-                                    : operationResponse.contentType);
-                                if (typeof ct === 'string')
-                                    responseArgs.contentType = contentType = ct;
-                                else if (operationResponse.type)
-                                    responseArgs.contentType = common_1.MimeTypes.opra_response_json;
-                            }
-                        }
-                    }
-                    responseArgs.operationResponse = operationResponse;
-                    if (!operationResponse.statusCode.find(sc => sc.start <= statusCode && sc.end >= statusCode)) {
-                        responseArgs.statusCode = operationResponse.statusCode[0].start;
-                    }
-                }
-            }
-            if (!hasBody)
-                delete responseArgs.contentType;
-            if (__oprDef?.composition?.startsWith('Entity.')) {
-                if (context.queryParams.projection)
-                    responseArgs.projection = context.queryParams.projection;
-            }
-            this[core_1.kAssetCache].set(response, cacheKey, { ...responseArgs });
-        }
-        /** Fix response value according to composition */
-        const composition = operationResponse?.owner.composition;
-        if (composition && body != null) {
-            switch (composition) {
-                case 'Entity.Create':
-                case 'Entity.Get':
-                case 'Entity.FindMany':
-                case 'Entity.Update': {
-                    if (!(body instanceof common_1.OperationResult)) {
-                        body = new common_1.OperationResult({
-                            payload: body,
-                        });
-                    }
-                    if ((composition === 'Entity.Create' ||
-                        composition === 'Entity.Update') &&
-                        composition &&
-                        body.affected == null) {
-                        body.affected = 1;
-                    }
-                    break;
-                }
-                case 'Entity.Delete':
-                case 'Entity.DeleteMany':
-                case 'Entity.UpdateMany': {
-                    if (!(body instanceof common_1.OperationResult)) {
-                        body = new common_1.OperationResult({
-                            affected: body,
-                        });
-                    }
-                    body.affected =
-                        typeof body.affected === 'number'
-                            ? body.affected
-                            : typeof body.affected === 'boolean'
-                                ? body.affected
-                                    ? 1
-                                    : 0
-                                : undefined;
-                    break;
-                }
-                default:
-                    break;
-            }
-        }
-        if (responseArgs.contentType &&
-            responseArgs.contentType !== parsedContentType?.type) {
-            response.setHeader('content-type', responseArgs.contentType);
-        }
-        if (responseArgs.contentType &&
-            body != null &&
-            !(body instanceof common_1.OperationResult) &&
-            type_is_1.default.is(responseArgs.contentType, [common_1.MimeTypes.opra_response_json])) {
-            body = new common_1.OperationResult({ payload: body });
-        }
-        if (hasBody)
-            responseArgs.body = body;
-        return responseArgs;
-    }
-    _wrapExceptions(exceptions) {
-        const wrappedErrors = exceptions.map(wrap_exception_js_1.wrapException);
-        if (!wrappedErrors.length)
-            wrappedErrors.push(new common_1.InternalServerError());
-        // Sort errors from fatal to info
-        wrappedErrors.sort((a, b) => {
-            const i = common_1.IssueSeverity.Keys.indexOf(a.severity) -
-                common_1.IssueSeverity.Keys.indexOf(b.severity);
-            if (i === 0)
-                return b.status - a.status;
-            return i;
-        });
-        return wrappedErrors;
-    }
-}
-exports.HttpHandler = HttpHandler;