@loopback/rest 4.0.0-alpha.8 → 5.0.1

package/dist/parse-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json.js","sourceRoot":"","sources":["../src/parse-json.ts"],"names":[],"mappings":";AAAA,iDAAiD;AACjD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;AAEhE,uDAAuD;AAEvD,2EAA2E;AAC3E,qBAAqB;AACrB,wEAAwE;AACxE,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,wBAAwB;AAExB;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,OAAuC;IACvE,OAAO,CAAC,GAAW,EAAE,KAAU,EAAE,EAAE;QACjC,IAAI,GAAG,KAAK,WAAW;YACrB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,IAAI,OAAO,EAAE;YACX,OAAO,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;SAC5B;aAAM;YACL,OAAO,KAAK,CAAC;SACd;IACH,CAAC,CAAC;AACJ,CAAC;AAVD,8CAUC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CACvB,IAAY,EACZ,OAAuC;IAEvC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;AACtD,CAAC;AALD,8BAKC"}

package/dist/parser.d.ts

@@ -0,0 +1,11 @@
+import { RequestBodyParser } from './body-parsers';
+import { ResolvedRoute } from './router';
+import { OperationArgs, Request, RequestBodyValidationOptions } from './types';
+/**
+ * Parses the request to derive arguments to be passed in for the Application
+ * controller method
+ *
+ * @param request - Incoming HTTP request
+ * @param route - Resolved Route
+ */
+export declare function parseOperationArgs(request: Request, route: ResolvedRoute, requestBodyParser?: RequestBodyParser, options?: RequestBodyValidationOptions): Promise<OperationArgs>;

package/dist/parser.js

@@ -0,0 +1,76 @@
+"use strict";
+// Copyright IBM Corp. 2017,2020. All Rights Reserved.
+// Node module: @loopback/rest
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOperationArgs = void 0;
+const tslib_1 = require("tslib");
+const openapi_v3_1 = require("@loopback/openapi-v3");
+const debug_1 = tslib_1.__importDefault(require("debug"));
+const body_parsers_1 = require("./body-parsers");
+const coerce_parameter_1 = require("./coercion/coerce-parameter");
+const rest_http_error_1 = require("./rest-http-error");
+const request_body_validator_1 = require("./validation/request-body.validator");
+const debug = debug_1.default('loopback:rest:parser');
+/**
+ * Parses the request to derive arguments to be passed in for the Application
+ * controller method
+ *
+ * @param request - Incoming HTTP request
+ * @param route - Resolved Route
+ */
+async function parseOperationArgs(request, route, requestBodyParser = new body_parsers_1.RequestBodyParser(), options = {}) {
+    debug('Parsing operation arguments for route %s', route.describe());
+    const operationSpec = route.spec;
+    const pathParams = route.pathParams;
+    const body = await requestBodyParser.loadRequestBodyIfNeeded(operationSpec, request);
+    return buildOperationArguments(operationSpec, request, pathParams, body, route.schemas, options);
+}
+exports.parseOperationArgs = parseOperationArgs;
+async function buildOperationArguments(operationSpec, request, pathParams, body, globalSchemas, options = {}) {
+    var _a;
+    let requestBodyIndex = -1;
+    if (operationSpec.requestBody) {
+        // the type of `operationSpec.requestBody` could be `RequestBodyObject`
+        // or `ReferenceObject`, resolving a `$ref` value is not supported yet.
+        if (openapi_v3_1.isReferenceObject(operationSpec.requestBody)) {
+            throw new Error('$ref requestBody is not supported yet.');
+        }
+        const i = operationSpec.requestBody[openapi_v3_1.REQUEST_BODY_INDEX];
+        requestBodyIndex = i ? i : 0;
+    }
+    const paramArgs = [];
+    for (const paramSpec of (_a = operationSpec.parameters) !== null && _a !== void 0 ? _a : []) {
+        if (openapi_v3_1.isReferenceObject(paramSpec)) {
+            // TODO(bajtos) implement $ref parameters
+            // See https://github.com/strongloop/loopback-next/issues/435
+            throw new Error('$ref parameters are not supported yet.');
+        }
+        const spec = paramSpec;
+        const rawValue = getParamFromRequest(spec, request, pathParams);
+        const coercedValue = coerce_parameter_1.coerceParameter(rawValue, spec);
+        paramArgs.push(coercedValue);
+    }
+    debug('Validating request body - value %j', body);
+    await request_body_validator_1.validateRequestBody(body, operationSpec.requestBody, globalSchemas, options);
+    if (requestBodyIndex > -1)
+        paramArgs.splice(requestBodyIndex, 0, body.value);
+    return paramArgs;
+}
+function getParamFromRequest(spec, request, pathParams) {
+    switch (spec.in) {
+        case 'query':
+            return request.query[spec.name];
+        case 'path':
+            return pathParams[spec.name];
+        case 'header':
+            // @jannyhou TBD: check edge cases
+            return request.headers[spec.name.toLowerCase()];
+        // TODO(jannyhou) to support `cookie`,
+        // see issue https://github.com/strongloop/loopback-next/issues/997
+        default:
+            throw rest_http_error_1.RestHttpErrors.invalidParamLocation(spec.in);
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/{dist6/src/providers/find-route.d.ts → dist/providers/find-route.provider.d.ts}

@@ -1,9 +1,11 @@
 import { Context, Provider } from '@loopback/context';
-import { FindRoute } from '../internal-types';
+import { FindRoute, Request } from '../types';
 import { HttpHandler } from '../http-handler';
+import { ResolvedRoute } from '../router';
 export declare class FindRouteProvider implements Provider<FindRoute> {
     protected context: Context;
     protected handler: HttpHandler;
     constructor(context: Context, handler: HttpHandler);
     value(): FindRoute;
+    action(request: Request): ResolvedRoute;
 }

package/dist/providers/find-route.provider.js

@@ -0,0 +1,36 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/rest
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FindRouteProvider = void 0;
+const tslib_1 = require("tslib");
+const context_1 = require("@loopback/context");
+const http_handler_1 = require("../http-handler");
+const keys_1 = require("../keys");
+let FindRouteProvider = /** @class */ (() => {
+    let FindRouteProvider = class FindRouteProvider {
+        constructor(context, handler) {
+            this.context = context;
+            this.handler = handler;
+        }
+        value() {
+            return request => this.action(request);
+        }
+        action(request) {
+            const found = this.handler.findRoute(request);
+            found.updateBindings(this.context);
+            return found;
+        }
+    };
+    FindRouteProvider = tslib_1.__decorate([
+        tslib_1.__param(0, context_1.inject(keys_1.RestBindings.Http.CONTEXT)),
+        tslib_1.__param(1, context_1.inject(keys_1.RestBindings.HANDLER)),
+        tslib_1.__metadata("design:paramtypes", [context_1.Context,
+            http_handler_1.HttpHandler])
+    ], FindRouteProvider);
+    return FindRouteProvider;
+})();
+exports.FindRouteProvider = FindRouteProvider;
+//# sourceMappingURL=find-route.provider.js.map

package/dist/providers/find-route.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-route.provider.js","sourceRoot":"","sources":["../../src/providers/find-route.provider.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,+CAA4D;AAE5D,kDAA4C;AAC5C,kCAAqC;AAGrC;IAAA,IAAa,iBAAiB,GAA9B,MAAa,iBAAiB;QAC5B,YAC+C,OAAgB,EACrB,OAAoB;YADf,YAAO,GAAP,OAAO,CAAS;YACrB,YAAO,GAAP,OAAO,CAAa;QAC3D,CAAC;QAEJ,KAAK;YACH,OAAO,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,CAAC,OAAgB;YACrB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC9C,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAA;IAfY,iBAAiB;QAEzB,mBAAA,gBAAM,CAAC,mBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACjC,mBAAA,gBAAM,CAAC,mBAAY,CAAC,OAAO,CAAC,CAAA;iDADyB,iBAAO;YACZ,0BAAW;OAHnD,iBAAiB,CAe7B;IAAD,wBAAC;KAAA;AAfY,8CAAiB"}

package/dist/providers/index.d.ts

@@ -0,0 +1,6 @@
+export * from './find-route.provider';
+export * from './invoke-method.provider';
+export * from './log-error.provider';
+export * from './parse-params.provider';
+export * from './reject.provider';
+export * from './send.provider';

package/dist/providers/index.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright IBM Corp. 2017,2020. All Rights Reserved.
+// Node module: @loopback/rest
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./find-route.provider"), exports);
+tslib_1.__exportStar(require("./invoke-method.provider"), exports);
+tslib_1.__exportStar(require("./log-error.provider"), exports);
+tslib_1.__exportStar(require("./parse-params.provider"), exports);
+tslib_1.__exportStar(require("./reject.provider"), exports);
+tslib_1.__exportStar(require("./send.provider"), exports);
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;AAEhE,gEAAsC;AACtC,mEAAyC;AACzC,+DAAqC;AACrC,kEAAwC;AACxC,4DAAkC;AAClC,0DAAgC"}

package/dist/{src/providers/invoke-method.d.ts → providers/invoke-method.provider.d.ts}

@@ -1,7 +1,9 @@
 import { Context, Provider } from '@loopback/context';
-import { InvokeMethod } from '../internal-types';
+import { InvokeMethod, OperationArgs, OperationRetval } from '../types';
+import { RouteEntry } from '../router';
 export declare class InvokeMethodProvider implements Provider<InvokeMethod> {
     protected context: Context;
     constructor(context: Context);
     value(): InvokeMethod;
+    action(route: RouteEntry, args: OperationArgs): Promise<OperationRetval>;
 }

package/dist/providers/invoke-method.provider.js

@@ -0,0 +1,30 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/rest
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvokeMethodProvider = void 0;
+const tslib_1 = require("tslib");
+const context_1 = require("@loopback/context");
+const keys_1 = require("../keys");
+let InvokeMethodProvider = /** @class */ (() => {
+    let InvokeMethodProvider = class InvokeMethodProvider {
+        constructor(context) {
+            this.context = context;
+        }
+        value() {
+            return (route, args) => this.action(route, args);
+        }
+        action(route, args) {
+            return route.invokeHandler(this.context, args);
+        }
+    };
+    InvokeMethodProvider = tslib_1.__decorate([
+        tslib_1.__param(0, context_1.inject(keys_1.RestBindings.Http.CONTEXT)),
+        tslib_1.__metadata("design:paramtypes", [context_1.Context])
+    ], InvokeMethodProvider);
+    return InvokeMethodProvider;
+})();
+exports.InvokeMethodProvider = InvokeMethodProvider;
+//# sourceMappingURL=invoke-method.provider.js.map

package/dist/providers/invoke-method.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-method.provider.js","sourceRoot":"","sources":["../../src/providers/invoke-method.provider.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,+CAA4D;AAE5D,kCAAqC;AAGrC;IAAA,IAAa,oBAAoB,GAAjC,MAAa,oBAAoB;QAC/B,YAAyD,OAAgB;YAAhB,YAAO,GAAP,OAAO,CAAS;QAAG,CAAC;QAE7E,KAAK;YACH,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,CAAC,KAAiB,EAAE,IAAmB;YAC3C,OAAO,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;KACF,CAAA;IAVY,oBAAoB;QAClB,mBAAA,gBAAM,CAAC,mBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;iDAAoB,iBAAO;OAD9D,oBAAoB,CAUhC;IAAD,2BAAC;KAAA;AAVY,oDAAoB"}

package/dist/providers/log-error.provider.d.ts

@@ -0,0 +1,6 @@
+import { Provider } from '@loopback/context';
+import { LogError, Request } from '../types';
+export declare class LogErrorProvider implements Provider<LogError> {
+    value(): LogError;
+    action(err: Error, statusCode: number, req: Request): void;
+}

package/dist/providers/log-error.provider.js

@@ -0,0 +1,21 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/rest
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogErrorProvider = void 0;
+class LogErrorProvider {
+    value() {
+        return (err, statusCode, req) => this.action(err, statusCode, req);
+    }
+    action(err, statusCode, req) {
+        var _a;
+        if (statusCode < 500) {
+            return;
+        }
+        console.error('Unhandled error in %s %s: %s %s', req.method, req.url, statusCode, (_a = err.stack) !== null && _a !== void 0 ? _a : err);
+    }
+}
+exports.LogErrorProvider = LogErrorProvider;
+//# sourceMappingURL=log-error.provider.js.map

package/dist/providers/log-error.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-error.provider.js","sourceRoot":"","sources":["../../src/providers/log-error.provider.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;AAKhE,MAAa,gBAAgB;IAC3B,KAAK;QACH,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,CAAC,GAAU,EAAE,UAAkB,EAAE,GAAY;;QACjD,IAAI,UAAU,GAAG,GAAG,EAAE;YACpB,OAAO;SACR;QAED,OAAO,CAAC,KAAK,CACX,iCAAiC,EACjC,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,GAAG,EACP,UAAU,QACV,GAAG,CAAC,KAAK,mCAAI,GAAG,CACjB,CAAC;IACJ,CAAC;CACF;AAlBD,4CAkBC"}

package/dist/providers/parse-params.provider.d.ts

@@ -0,0 +1,15 @@
+import { Provider } from '@loopback/context';
+import { RequestBodyParser } from '../body-parsers';
+import { AjvFactory, ParseParams, RequestBodyValidationOptions } from '../types';
+/**
+ * Provides the function for parsing args in requests at runtime.
+ *
+ * @returns The handler function that will parse request args.
+ */
+export declare class ParseParamsProvider implements Provider<ParseParams> {
+    private requestBodyParser;
+    private validationOptions;
+    private ajvFactory?;
+    constructor(requestBodyParser: RequestBodyParser, validationOptions?: RequestBodyValidationOptions, ajvFactory?: AjvFactory | undefined);
+    value(): ParseParams;
+}

package/dist/providers/parse-params.provider.js

@@ -0,0 +1,41 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/rest
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseParamsProvider = void 0;
+const tslib_1 = require("tslib");
+const context_1 = require("@loopback/context");
+const body_parsers_1 = require("../body-parsers");
+const keys_1 = require("../keys");
+const parser_1 = require("../parser");
+/**
+ * Provides the function for parsing args in requests at runtime.
+ *
+ * @returns The handler function that will parse request args.
+ */
+let ParseParamsProvider = /** @class */ (() => {
+    let ParseParamsProvider = class ParseParamsProvider {
+        constructor(requestBodyParser, validationOptions = {}, ajvFactory) {
+            this.requestBodyParser = requestBodyParser;
+            this.validationOptions = validationOptions;
+            this.ajvFactory = ajvFactory;
+        }
+        value() {
+            return (request, route) => parser_1.parseOperationArgs(request, route, this.requestBodyParser, {
+                ajvFactory: this.ajvFactory,
+                ...this.validationOptions,
+            });
+        }
+    };
+    ParseParamsProvider = tslib_1.__decorate([
+        tslib_1.__param(0, context_1.inject(keys_1.RestBindings.REQUEST_BODY_PARSER)),
+        tslib_1.__param(1, context_1.inject(keys_1.RestBindings.REQUEST_BODY_PARSER_OPTIONS.deepProperty('validation'), { optional: true })),
+        tslib_1.__param(2, context_1.inject(keys_1.RestBindings.AJV_FACTORY, { optional: true })),
+        tslib_1.__metadata("design:paramtypes", [body_parsers_1.RequestBodyParser, Object, Function])
+    ], ParseParamsProvider);
+    return ParseParamsProvider;
+})();
+exports.ParseParamsProvider = ParseParamsProvider;
+//# sourceMappingURL=parse-params.provider.js.map

package/dist/providers/parse-params.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-params.provider.js","sourceRoot":"","sources":["../../src/providers/parse-params.provider.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,+CAAmD;AACnD,kDAAkD;AAClD,kCAAqC;AACrC,sCAA6C;AAQ7C;;;;GAIG;AACH;IAAA,IAAa,mBAAmB,GAAhC,MAAa,mBAAmB;QAC9B,YAEU,iBAAoC,EAKpC,oBAAkD,EAAE,EAEpD,UAAuB;YAPvB,sBAAiB,GAAjB,iBAAiB,CAAmB;YAKpC,sBAAiB,GAAjB,iBAAiB,CAAmC;YAEpD,eAAU,GAAV,UAAU,CAAa;QAC9B,CAAC;QAEJ,KAAK;YACH,OAAO,CAAC,OAAgB,EAAE,KAAoB,EAAE,EAAE,CAChD,2BAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE;gBACzD,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,GAAG,IAAI,CAAC,iBAAiB;aAC1B,CAAC,CAAC;QACP,CAAC;KACF,CAAA;IApBY,mBAAmB;QAE3B,mBAAA,gBAAM,CAAC,mBAAY,CAAC,mBAAmB,CAAC,CAAA;QAExC,mBAAA,gBAAM,CACL,mBAAY,CAAC,2BAA2B,CAAC,YAAY,CAAC,YAAY,CAAC,EACnE,EAAC,QAAQ,EAAE,IAAI,EAAC,CACjB,CAAA;QAEA,mBAAA,gBAAM,CAAC,mBAAY,CAAC,WAAW,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;iDANxB,gCAAiB;OAHnC,mBAAmB,CAoB/B;IAAD,0BAAC;KAAA;AApBY,kDAAmB"}

package/dist/providers/reject.provider.d.ts

@@ -0,0 +1,10 @@
+import { LogError, Reject, HandlerContext } from '../types';
+import { Provider } from '@loopback/context';
+import { ErrorWriterOptions } from 'strong-error-handler';
+export declare class RejectProvider implements Provider<Reject> {
+    protected logError: LogError;
+    protected errorWriterOptions?: ErrorWriterOptions | undefined;
+    constructor(logError: LogError, errorWriterOptions?: ErrorWriterOptions | undefined);
+    value(): Reject;
+    action({ request, response }: HandlerContext, error: Error): void;
+}

package/dist/providers/reject.provider.js

@@ -0,0 +1,47 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/rest
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RejectProvider = void 0;
+const tslib_1 = require("tslib");
+const context_1 = require("@loopback/context");
+const keys_1 = require("../keys");
+const strong_error_handler_1 = require("strong-error-handler");
+// TODO(bajtos) Make this mapping configurable at RestServer level,
+// allow apps and extensions to contribute additional mappings.
+const codeToStatusCodeMap = {
+    ENTITY_NOT_FOUND: 404,
+};
+let RejectProvider = /** @class */ (() => {
+    let RejectProvider = class RejectProvider {
+        constructor(logError, errorWriterOptions) {
+            this.logError = logError;
+            this.errorWriterOptions = errorWriterOptions;
+        }
+        value() {
+            return (context, error) => this.action(context, error);
+        }
+        action({ request, response }, error) {
+            const err = error;
+            if (!err.status && !err.statusCode && err.code) {
+                const customStatus = codeToStatusCodeMap[err.code];
+                if (customStatus) {
+                    err.statusCode = customStatus;
+                }
+            }
+            const statusCode = err.statusCode || err.status || 500;
+            strong_error_handler_1.writeErrorToResponse(err, request, response, this.errorWriterOptions);
+            this.logError(error, statusCode, request);
+        }
+    };
+    RejectProvider = tslib_1.__decorate([
+        tslib_1.__param(0, context_1.inject(keys_1.RestBindings.SequenceActions.LOG_ERROR)),
+        tslib_1.__param(1, context_1.inject(keys_1.RestBindings.ERROR_WRITER_OPTIONS, { optional: true })),
+        tslib_1.__metadata("design:paramtypes", [Function, Object])
+    ], RejectProvider);
+    return RejectProvider;
+})();
+exports.RejectProvider = RejectProvider;
+//# sourceMappingURL=reject.provider.js.map

package/dist/providers/reject.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reject.provider.js","sourceRoot":"","sources":["../../src/providers/reject.provider.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;;AAGhE,+CAAmD;AAEnD,kCAAqC;AACrC,+DAA8E;AAE9E,mEAAmE;AACnE,+DAA+D;AAC/D,MAAM,mBAAmB,GAA4B;IACnD,gBAAgB,EAAE,GAAG;CACtB,CAAC;AAEF;IAAA,IAAa,cAAc,GAA3B,MAAa,cAAc;QACzB,YAEY,QAAkB,EAElB,kBAAuC;YAFvC,aAAQ,GAAR,QAAQ,CAAU;YAElB,uBAAkB,GAAlB,kBAAkB,CAAqB;QAChD,CAAC;QAEJ,KAAK;YACH,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,CAAC,EAAC,OAAO,EAAE,QAAQ,EAAiB,EAAE,KAAY;YACtD,MAAM,GAAG,GAAc,KAAK,CAAC;YAE7B,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,IAAI,EAAE;gBAC9C,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACnD,IAAI,YAAY,EAAE;oBAChB,GAAG,CAAC,UAAU,GAAG,YAAY,CAAC;iBAC/B;aACF;YAED,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;YACvD,2CAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACtE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;KACF,CAAA;IA1BY,cAAc;QAEtB,mBAAA,gBAAM,CAAC,mBAAY,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;QAE9C,mBAAA,gBAAM,CAAC,mBAAY,CAAC,oBAAoB,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;;OAJnD,cAAc,CA0B1B;IAAD,qBAAC;KAAA;AA1BY,wCAAc"}

package/dist/{src/providers/send.d.ts → providers/send.provider.d.ts}

@@ -4,10 +4,7 @@ import { writeResultToResponse } from '../writer';
  * Provides the function that populates the response object with
  * the results of the operation.
  *
- * @export
- * @class SendProvider
- * @implements {Provider<BoundValue>}
- * @returns {BoundValue} The handler function that will populate the
+ * @returns The handler function that will populate the
  * response with operation results.
  */
 export declare class SendProvider implements Provider<BoundValue> {

package/dist/{src/providers/send.js → providers/send.provider.js}

@@ -1,18 +1,16 @@
 "use strict";
-// Copyright IBM Corp. 2017. All Rights Reserved.
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
 // Node module: @loopback/rest
 // This file is licensed under the MIT License.
 // License text available at https://opensource.org/licenses/MIT
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendProvider = void 0;
 const writer_1 = require("../writer");
 /**
  * Provides the function that populates the response object with
  * the results of the operation.
  *
- * @export
- * @class SendProvider
- * @implements {Provider<BoundValue>}
- * @returns {BoundValue} The handler function that will populate the
+ * @returns The handler function that will populate the
  * response with operation results.
  */
 class SendProvider {
@@ -21,4 +19,4 @@ class SendProvider {
     }
 }
 exports.SendProvider = SendProvider;
-//# sourceMappingURL=send.js.map
+//# sourceMappingURL=send.provider.js.map

package/dist/providers/send.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.provider.js","sourceRoot":"","sources":["../../src/providers/send.provider.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;AAGhE,sCAAgD;AAChD;;;;;;GAMG;AACH,MAAa,YAAY;IACvB,KAAK;QACH,OAAO,8BAAqB,CAAC;IAC/B,CAAC;CACF;AAJD,oCAIC"}

package/dist/request-context.d.ts

@@ -0,0 +1,36 @@
+import { Context } from '@loopback/context';
+import { HandlerContext, MiddlewareContext, Request, Response } from '@loopback/express';
+import { RestServerResolvedConfig } from './rest.server';
+/**
+ * A per-request Context combining an IoC container with handler context
+ * (request, response, etc.).
+ */
+export declare class RequestContext extends MiddlewareContext implements HandlerContext {
+    readonly request: Request;
+    readonly response: Response;
+    readonly serverConfig: RestServerResolvedConfig;
+    /**
+     * Get the protocol used by the client to make the request.
+     * Please note this protocol may be different from what we are observing
+     * at HTTP/TCP level, because reverse proxies like nginx or sidecars like
+     * Envoy are switching between protocols.
+     */
+    get requestedProtocol(): string;
+    /**
+     * Get the effective base path of the incoming request. This base path
+     * combines `baseUrl` provided by Express when LB4 handler is mounted on
+     * a non-root path, with the `basePath` value configured at LB4 side.
+     */
+    get basePath(): string;
+    /**
+     * Get the base URL used by the client to make the request.
+     * This URL contains the protocol, hostname, port and base path.
+     * The path of the invoked route and query string is not included.
+     *
+     * Please note these values may be different from what we are observing
+     * at HTTP/TCP level, because reverse proxies like nginx are rewriting them.
+     */
+    get requestedBaseUrl(): string;
+    constructor(request: Request, response: Response, parent: Context, serverConfig: RestServerResolvedConfig, name?: string);
+    protected setupBindings(): void;
+}

package/dist/request-context.js

@@ -0,0 +1,104 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/rest
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestContext = void 0;
+const express_1 = require("@loopback/express");
+const keys_1 = require("./keys");
+/**
+ * A per-request Context combining an IoC container with handler context
+ * (request, response, etc.).
+ */
+class RequestContext extends express_1.MiddlewareContext {
+    constructor(request, response, parent, serverConfig, name) {
+        super(request, response, parent, name);
+        this.request = request;
+        this.response = response;
+        this.serverConfig = serverConfig;
+    }
+    /**
+     * Get the protocol used by the client to make the request.
+     * Please note this protocol may be different from what we are observing
+     * at HTTP/TCP level, because reverse proxies like nginx or sidecars like
+     * Envoy are switching between protocols.
+     */
+    get requestedProtocol() {
+        var _a, _b;
+        return ((_b = (((_a = this.request.get('x-forwarded-proto')) !== null && _a !== void 0 ? _a : '').split(',')[0] ||
+            this.request.protocol ||
+            this.serverConfig.protocol)) !== null && _b !== void 0 ? _b : 'http');
+    }
+    /**
+     * Get the effective base path of the incoming request. This base path
+     * combines `baseUrl` provided by Express when LB4 handler is mounted on
+     * a non-root path, with the `basePath` value configured at LB4 side.
+     */
+    get basePath() {
+        var _a;
+        const request = this.request;
+        let basePath = (_a = this.serverConfig.basePath) !== null && _a !== void 0 ? _a : '';
+        if (request.baseUrl && request.baseUrl !== '/') {
+            if (!basePath || request.baseUrl.endsWith(basePath)) {
+                // Express has already applied basePath to baseUrl
+                basePath = request.baseUrl;
+            }
+            else {
+                basePath = request.baseUrl + basePath;
+            }
+        }
+        return basePath;
+    }
+    /**
+     * Get the base URL used by the client to make the request.
+     * This URL contains the protocol, hostname, port and base path.
+     * The path of the invoked route and query string is not included.
+     *
+     * Please note these values may be different from what we are observing
+     * at HTTP/TCP level, because reverse proxies like nginx are rewriting them.
+     */
+    get requestedBaseUrl() {
+        var _a, _b, _c;
+        const request = this.request;
+        const config = this.serverConfig;
+        const protocol = this.requestedProtocol;
+        // The host can be in one of the forms
+        // [::1]:3000
+        // [::1]
+        // 127.0.0.1:3000
+        // 127.0.0.1
+        let { host, port } = parseHostAndPort((_a = request.get('x-forwarded-host')) !== null && _a !== void 0 ? _a : request.headers.host);
+        const forwardedPort = ((_b = request.get('x-forwarded-port')) !== null && _b !== void 0 ? _b : '').split(',')[0];
+        port = forwardedPort || port;
+        if (!host) {
+            // No host detected from http headers
+            // Use the configured values or the local network address
+            host = (_c = config.host) !== null && _c !== void 0 ? _c : request.socket.localAddress;
+            port = (config.port || request.socket.localPort).toString();
+        }
+        // clear default ports
+        port = protocol === 'https' && port === '443' ? '' : port;
+        port = protocol === 'http' && port === '80' ? '' : port;
+        // add port number of present
+        host += port !== '' ? ':' + port : '';
+        return protocol + '://' + host + this.basePath;
+    }
+    setupBindings() {
+        super.setupBindings();
+        this.bind(keys_1.RestBindings.Http.REQUEST).to(this.request).lock();
+        this.bind(keys_1.RestBindings.Http.RESPONSE).to(this.response).lock();
+        this.bind(keys_1.RestBindings.Http.CONTEXT).to(this).lock();
+    }
+}
+exports.RequestContext = RequestContext;
+function parseHostAndPort(host) {
+    var _a;
+    host = host !== null && host !== void 0 ? host : '';
+    host = host.split(',')[0];
+    const portPattern = /:([0-9]+)$/;
+    const port = ((_a = host.match(portPattern)) !== null && _a !== void 0 ? _a : [])[1] || '';
+    host = host.replace(portPattern, '');
+    return { host, port };
+}
+//# sourceMappingURL=request-context.js.map

package/dist/request-context.js.map

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

package/dist/rest-http-error.d.ts

@@ -0,0 +1,37 @@
+import HttpErrors from 'http-errors';
+export declare namespace RestHttpErrors {
+    function invalidData<T, Props extends object = {}>(data: T, name: string, extraProperties?: Props): HttpErrors.HttpError & Props;
+    function unsupportedMediaType(contentType: string, allowedTypes?: string[]): HttpErrors.HttpError & {
+        code: string;
+        contentType: string;
+        allowedMediaTypes: string[];
+    };
+    function missingRequired(name: string): HttpErrors.HttpError;
+    function invalidParamLocation(location: string): HttpErrors.HttpError;
+    const INVALID_REQUEST_BODY_MESSAGE = "The request body is invalid. See error object `details` property for more info.";
+    function invalidRequestBody(): HttpErrors.HttpError;
+    /**
+     * An invalid request body error contains a `details` property as the machine-readable error.
+     * Each entry in `error.details` contains 4 attributes: `path`, `code`, `info` and `message`.
+     * `ValidationErrorDetails` defines the type of each entry, which is an object.
+     * The type of `error.details` is `ValidationErrorDetails[]`.
+     */
+    interface ValidationErrorDetails {
+        /**
+         * A path to the invalid field.
+         */
+        path: string;
+        /**
+         * A single word code represents the error's type.
+         */
+        code: string;
+        /**
+         * A human readable description of the error.
+         */
+        message: string;
+        /**
+         * Some additional details that the 3 attributes above don't cover.
+         */
+        info: object;
+    }
+}