@opra/core 1.0.0-alpha.8 → 1.0.0-beta.1

package/esm/http/{impl/http-handler.js → http-handler.js}

@@ -1,12 +1,13 @@
 import * as process from 'node:process';
 import typeIs from '@browsery/type-is';
-import { BadRequestError, HttpHeaderCodes, HttpStatusCode, InternalServerError, isBlob, isReadableStream, IssueSeverity, MethodNotAllowedError, MimeTypes, OperationResult, OpraException, OpraSchema, translate, } from '@opra/common';
+import { BadRequestError, HttpHeaderCodes, HttpStatusCode, InternalServerError, isBlob, isReadableStream, IssueSeverity, MethodNotAllowedError, MimeTypes, OperationResult, OpraException, OpraSchema, safeJsonStringify, } from '@opra/common';
 import { parse as parseContentType } from 'content-type';
 import { splitString } from 'fast-tokenizer';
+import { md5 } from 'super-fast-md5';
 import { asMutable } from 'ts-gems';
 import { toArray, ValidationError, vg } from 'valgen';
-import { kAssetCache } from '../../constants.js';
-import { wrapException } from '../utils/wrap-exception.js';
+import { kAssetCache } from '../constants.js';
+import { wrapException } from './utils/wrap-exception.js';
 /**
  * @class HttpHandler
  */
@@ -38,7 +39,7 @@ export class HttpHandler {
                     throw e;
                 if (e instanceof ValidationError) {
                     throw new BadRequestError({
-                        message: translate('error:RESPONSE_VALIDATION,', 'Response validation failed'),
+                        message: 'Response validation failed',
                         code: 'RESPONSE_VALIDATION',
                         details: e.issues,
                     }, e);
@@ -48,11 +49,14 @@ export class HttpHandler {
             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 = this.adapter.interceptors[i++];
-                    if (interceptor)
+                    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();
@@ -64,19 +68,17 @@ export class HttpHandler {
             let e = error;
             if (e instanceof ValidationError) {
                 e = new InternalServerError({
-                    message: translate('error:RESPONSE_VALIDATION,', 'Response validation failed'),
+                    message: 'Response validation failed',
                     code: 'RESPONSE_VALIDATION',
                     details: e.issues,
                 }, e);
             }
             else
                 e = wrapException(e);
-            response.status(e.statusCode || e.status || HttpStatusCode.INTERNAL_SERVER_ERROR);
-            response.contentType(MimeTypes.opra_response_json);
-            await this._sendResponse(context, new OperationResult({ errors: [e.toJSON()] })).finally(() => {
-                if (!response.finished)
-                    response.end();
-            });
+            if (this.onError)
+                await this.onError(context, error);
+            context.errors.push(e);
+            await this.sendResponse(context);
         }
         finally {
             await context.emitAsync('finish');
@@ -89,7 +91,7 @@ export class HttpHandler {
     async parseRequest(context) {
         await this._parseParameters(context);
         await this._parseContentType(context);
-        if (context.operation.requestBody?.immediateFetch)
+        if (context.operation?.requestBody?.immediateFetch)
             await context.getBody();
         /** Set default status code as the first status code between 200 and 299 */
         if (context.operation) {
@@ -109,6 +111,8 @@ export class HttpHandler {
      */
     async _parseParameters(context) {
         const { operation, request } = context;
+        if (!operation)
+            return;
         let key = '';
         try {
             const onFail = (issue) => {
@@ -210,6 +214,7 @@ export class HttpHandler {
                 }
             }
             for (const prm of paramsLeft) {
+                key = String(prm.name);
                 // Throw error for required parameters
                 if (prm.required) {
                     const decode = getDecoder(prm);
@@ -235,6 +240,8 @@ export class HttpHandler {
      */
     async _parseContentType(context) {
         const { request, operation } = context;
+        if (!operation)
+            return;
         if (operation.requestBody?.content.length) {
             let mediaType;
             let contentType = request.header('content-type');
@@ -261,7 +268,7 @@ export class HttpHandler {
         const responseValue = await context.operationHandler.call(context.controllerInstance, context);
         const { response } = context;
         if (!response.writableEnded) {
-            await this._sendResponse(context, responseValue).finally(() => {
+            await this.sendResponse(context, responseValue).finally(() => {
                 if (!response.writableEnded)
                     response.end();
             });
@@ -273,94 +280,182 @@ export class HttpHandler {
      * @param responseValue
      * @protected
      */
-    async _sendResponse(context, responseValue) {
+    async sendResponse(context, responseValue) {
+        if (context.errors.length)
+            return this._sendErrorResponse(context);
         const { response } = context;
         const { document } = this.adapter;
-        const responseArgs = this._determineResponseArgs(context, responseValue);
-        const { operationResponse, statusCode } = responseArgs;
-        let { contentType, body } = responseArgs;
-        const operationResultType = document.node.getDataType(OperationResult);
-        let operationResultEncoder = this[kAssetCache].get(operationResultType, 'encode');
-        if (!operationResultEncoder) {
-            operationResultEncoder = operationResultType.generateCodec('encode', { ignoreWriteonlyFields: true });
-            this[kAssetCache].set(operationResultType, 'encode', operationResultEncoder);
-        }
-        /** Validate response */
-        if (operationResponse?.type) {
-            if (!(body == null && statusCode === HttpStatusCode.NO_CONTENT)) {
-                /** Generate encoder */
-                let encode = this[kAssetCache].get(operationResponse, 'encode');
-                if (!encode) {
-                    encode = operationResponse.type.generateCodec('encode', {
-                        partial: operationResponse.partial,
-                        projection: '*',
-                        ignoreWriteonlyFields: true,
-                    });
-                    if (operationResponse) {
-                        if (operationResponse.isArray)
-                            encode = vg.isArray(encode);
-                        this[kAssetCache].set(operationResponse, 'encode', encode);
+        try {
+            const responseArgs = this._determineResponseArgs(context, responseValue);
+            const { operationResponse, statusCode } = responseArgs;
+            let { contentType, body } = responseArgs;
+            const operationResultType = document.node.getDataType(OperationResult);
+            let operationResultEncoder = this[kAssetCache].get(operationResultType, 'encode');
+            if (!operationResultEncoder) {
+                operationResultEncoder = operationResultType.generateCodec('encode', {
+                    ignoreWriteonlyFields: true,
+                    ignoreHiddenFields: true,
+                });
+                this[kAssetCache].set(operationResultType, 'encode', operationResultEncoder);
+            }
+            /** Validate response */
+            if (operationResponse?.type) {
+                if (!(body == null && statusCode === HttpStatusCode.NO_CONTENT)) {
+                    /** Generate encoder */
+                    const projection = responseArgs.projection || '*';
+                    const assetKey = md5(String(projection));
+                    let encode = this[kAssetCache].get(operationResponse, 'encode:' + assetKey);
+                    if (!encode) {
+                        encode = operationResponse.type.generateCodec('encode', {
+                            partial: operationResponse.partial,
+                            projection,
+                            ignoreWriteonlyFields: true,
+                            ignoreHiddenFields: true,
+                            onFail: issue => `Response body validation failed: ` + issue.message,
+                        });
+                        if (operationResponse) {
+                            if (operationResponse.isArray)
+                                encode = vg.isArray(encode);
+                            this[kAssetCache].set(operationResponse, 'encode:' + assetKey, encode);
+                        }
+                    }
+                    /** Encode body */
+                    if (operationResponse.type.extendsFrom(operationResultType)) {
+                        if (body instanceof OperationResult)
+                            body = encode(body);
+                        else {
+                            body.payload = encode(body.payload);
+                            body = operationResultEncoder(body);
+                        }
                     }
-                }
-                /** Encode body */
-                if (operationResponse.type.extendsFrom(operationResultType)) {
-                    if (body instanceof OperationResult)
-                        body = encode(body);
                     else {
-                        body.payload = encode(body.payload);
-                        body = operationResultEncoder(body);
+                        if (body instanceof OperationResult &&
+                            contentType &&
+                            typeIs.is(contentType, [MimeTypes.opra_response_json])) {
+                            body.payload = encode(body.payload);
+                            body = operationResultEncoder(body);
+                        }
+                        else {
+                            body = encode(body);
+                        }
                     }
-                }
-                else {
                     if (body instanceof OperationResult &&
-                        contentType &&
-                        typeIs.is(contentType, [MimeTypes.opra_response_json])) {
-                        body.payload = encode(body.payload);
-                        body = operationResultEncoder(body);
+                        operationResponse.type &&
+                        operationResponse.type !== document.node.getDataType(OperationResult)) {
+                        body.type = operationResponse.type.name ? operationResponse.type.name : '#embedded';
                     }
-                    else
-                        body = encode(body);
-                }
-                if (body instanceof OperationResult && operationResponse.type) {
-                    body.type = operationResponse.type.name ? operationResponse.type.name : '#embedded';
                 }
             }
-        }
-        else if (body != null) {
-            if (body instanceof OperationResult) {
-                body = operationResultEncoder(body);
-                contentType = MimeTypes.opra_response_json;
-            }
-            else if (Buffer.isBuffer(body))
-                contentType = MimeTypes.binary;
-            else if (typeof body === 'object') {
-                contentType = contentType || MimeTypes.json;
-                if (typeof body.toJSON === 'function')
-                    body = body.toJSON();
+            else if (body != null) {
+                if (body instanceof OperationResult) {
+                    body = operationResultEncoder(body);
+                    contentType = MimeTypes.opra_response_json;
+                }
+                else if (Buffer.isBuffer(body))
+                    contentType = MimeTypes.binary;
+                else if (typeof body === 'object') {
+                    contentType = contentType || MimeTypes.json;
+                    if (typeof body.toJSON === 'function')
+                        body = body.toJSON();
+                }
+                else {
+                    contentType = contentType || MimeTypes.text;
+                    body = String(body);
+                }
             }
-            else {
-                contentType = contentType || 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) || isReadableStream(body))
+                x = body;
+            else if (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);
         }
-        /** Set content-type header value if not set */
-        if (contentType && contentType !== responseArgs.contentType)
-            response.setHeader('content-type', contentType);
-        response.status(statusCode);
-        if (body == null) {
+    }
+    async _sendErrorResponse(context) {
+        context.errors = this._wrapExceptions(context.errors);
+        try {
+            await this.adapter.emitAsync('error', context);
+            context.errors = this._wrapExceptions(context.errors);
+        }
+        catch (e) {
+            context.errors = this._wrapExceptions([e, ...context.errors]);
+        }
+        const { response, errors } = context;
+        if (response.headersSent) {
             response.end();
             return;
         }
-        let x;
-        if (Buffer.isBuffer(body) || isReadableStream(body))
-            x = body;
-        else if (isBlob(body))
-            x = body.stream();
-        else if (typeof body === 'object')
-            x = JSON.stringify(body);
-        else
-            x = String(body);
-        response.end(x);
+        let status = response.statusCode || 0;
+        if (!status || status < Number(HttpStatusCode.BAD_REQUEST)) {
+            status = errors[0].status;
+            if (status < Number(HttpStatusCode.BAD_REQUEST))
+                status = HttpStatusCode.INTERNAL_SERVER_ERROR;
+        }
+        response.statusCode = status;
+        const { document } = this.adapter;
+        const dt = document.node.getComplexType('OperationResult');
+        let encode = this[kAssetCache].get(dt, 'encode');
+        if (!encode) {
+            encode = dt.generateCodec('encode', { ignoreWriteonlyFields: true });
+            this[kAssetCache].set(dt, 'encode', encode);
+        }
+        // const { i18n } = this.adapter;
+        const bodyObject = new 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(HttpHeaderCodes.Content_Type, MimeTypes.opra_response_json + '; charset=utf-8');
+        response.setHeader(HttpHeaderCodes.Cache_Control, 'no-cache');
+        response.setHeader(HttpHeaderCodes.Pragma, 'no-cache');
+        response.setHeader(HttpHeaderCodes.Expires, '-1');
+        response.setHeader(HttpHeaderCodes.X_Opra_Version, OpraSchema.SpecVersion);
+        response.send(safeJsonStringify(body));
+        response.end();
+    }
+    async sendDocumentSchema(context) {
+        const { request, response } = context;
+        const { document } = this.adapter;
+        response.setHeader('content-type', 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 BadRequestError({
+                message: `Document with given id [${documentId}] does not exists`,
+            }));
+            return this.sendResponse(context);
+        }
+        /** Check if response cache exists */
+        let responseBody = this[kAssetCache].get(doc, `$schema`);
+        /** Create response if response cache does not exists */
+        if (!responseBody) {
+            const schema = doc.export();
+            responseBody = JSON.stringify(schema);
+            this[kAssetCache].set(doc, `$schema`, responseBody);
+        }
+        response.end(responseBody);
     }
     /**
      *
@@ -387,7 +482,7 @@ export class HttpHandler {
         let responseArgs = this[kAssetCache].get(response, cacheKey);
         if (!responseArgs) {
             responseArgs = { statusCode, contentType };
-            if (operation.responses.length) {
+            if (operation?.responses.length) {
                 /** Filter available HttpOperationResponse instances according to status code. */
                 const filteredResponses = operation.responses.filter(r => r.statusCode.find(sc => sc.start <= statusCode && sc.end >= statusCode));
                 /** Throw InternalServerError if controller returns non-configured status code */
@@ -419,6 +514,8 @@ export class HttpHandler {
                                     : operationResponse.contentType);
                                 if (typeof ct === 'string')
                                     responseArgs.contentType = contentType = ct;
+                                else if (operationResponse.type)
+                                    responseArgs.contentType = MimeTypes.opra_response_json;
                             }
                         }
                     }
@@ -430,6 +527,10 @@ export class HttpHandler {
             }
             if (!hasBody)
                 delete responseArgs.contentType;
+            if (operation?.composition?.startsWith('Entity.')) {
+                if (context.queryParams.projection)
+                    responseArgs.projection = context.queryParams.projection;
+            }
             this[kAssetCache].set(response, cacheKey, { ...responseArgs });
         }
         /** Fix response value according to composition */
@@ -487,56 +588,10 @@ export class HttpHandler {
             responseArgs.body = body;
         return responseArgs;
     }
-    async sendDocumentSchema(context) {
-        const { request, response } = context;
-        const { document } = this.adapter;
-        response.setHeader('content-type', 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) {
-            return this.sendErrorResponse(response, [
-                new BadRequestError({
-                    message: `Document with given id [${documentId}] does not exists`,
-                }),
-            ]);
-        }
-        /** Check if response cache exists */
-        let responseBody = this[kAssetCache].get(doc, `$schema`);
-        /** Create response if response cache does not exists */
-        if (!responseBody) {
-            const schema = doc.export();
-            responseBody = JSON.stringify(schema);
-            this[kAssetCache].set(doc, `$schema`, responseBody);
-        }
-        response.end(responseBody);
-    }
-    async sendErrorResponse(response, errors) {
-        if (response.headersSent) {
-            response.end();
-            return;
-        }
-        if (!errors.length)
-            errors.push(wrapException({ status: response.statusCode || 500 }));
-        const { logger } = this.adapter;
-        errors.forEach(x => {
-            if (x instanceof OpraException) {
-                switch (x.severity) {
-                    case 'fatal':
-                        logger.fatal(x);
-                        break;
-                    case 'warning':
-                        logger.warn(x);
-                        break;
-                    default:
-                        logger.error(x);
-                }
-            }
-            else
-                logger.fatal(x);
-        });
-        const wrappedErrors = errors.map(wrapException);
+    _wrapExceptions(exceptions) {
+        const wrappedErrors = exceptions.map(wrapException);
+        if (!wrappedErrors.length)
+            wrappedErrors.push(new InternalServerError());
         // Sort errors from fatal to info
         wrappedErrors.sort((a, b) => {
             const i = IssueSeverity.Keys.indexOf(a.severity) - IssueSeverity.Keys.indexOf(b.severity);
@@ -544,36 +599,6 @@ export class HttpHandler {
                 return b.status - a.status;
             return i;
         });
-        let status = response.statusCode || 0;
-        if (!status || status < Number(HttpStatusCode.BAD_REQUEST)) {
-            status = wrappedErrors[0].status;
-            if (status < Number(HttpStatusCode.BAD_REQUEST))
-                status = HttpStatusCode.INTERNAL_SERVER_ERROR;
-        }
-        response.statusCode = status;
-        const { document } = this.adapter;
-        const dt = document.node.getComplexType('OperationResult');
-        let encode = this[kAssetCache].get(dt, 'encode');
-        if (!encode) {
-            encode = dt.generateCodec('encode', { ignoreWriteonlyFields: true });
-            this[kAssetCache].set(dt, 'encode', encode);
-        }
-        const { i18n } = this.adapter;
-        const bodyObject = new OperationResult({
-            errors: wrappedErrors.map(x => {
-                const o = x.toJSON();
-                if (!(process.env.NODE_ENV === 'dev' || process.env.NODE_ENV === 'development'))
-                    delete o.stack;
-                return i18n.deep(o);
-            }),
-        });
-        const body = encode(bodyObject);
-        response.setHeader(HttpHeaderCodes.Content_Type, MimeTypes.opra_response_json + '; charset=utf-8');
-        response.setHeader(HttpHeaderCodes.Cache_Control, 'no-cache');
-        response.setHeader(HttpHeaderCodes.Pragma, 'no-cache');
-        response.setHeader(HttpHeaderCodes.Expires, '-1');
-        response.setHeader(HttpHeaderCodes.X_Opra_Version, OpraSchema.SpecVersion);
-        response.send(JSON.stringify(body));
-        response.end();
+        return wrappedErrors;
     }
 }

package/esm/http/impl/http-outgoing.host.js

@@ -2,6 +2,7 @@
   Some parts of this file contains codes from open source express library
   https://github.com/expressjs
  */
+import path from 'node:path';
 import { HttpStatusCode } from '@opra/common';
 import contentDisposition from 'content-disposition';
 import contentType from 'content-type';
@@ -9,7 +10,6 @@ import cookie from 'cookie';
 import cookieSignature from 'cookie-signature';
 import encodeUrl from 'encodeurl';
 import mime from 'mime-types';
-import path from 'path';
 import { toString } from 'putil-varhelpers';
 import vary from 'vary';
 const charsetRegExp = /;\s*charset\s*=/;