@loopback/rest 4.0.0-alpha.8 → 5.0.1

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) IBM Corp. 2017. All Rights Reserved.
+Copyright (c) IBM Corp. 2017,2019.
 Node module: @loopback/rest
 This project is licensed under the MIT License, full text below.
 

package/README.md

@@ -1,84 +1,55 @@
 # @loopback/rest
 
-The REST API package for [loopback-next](https://github.com/strongloop/loopback-next).
-
-## STATUS: ALPHA
-This package is not yet ready for production use, and the API has not yet
-stabilized. Additionally, this document is also a work-in-progress and some
-sections may not have corresponding code!
+The REST API package for
+[loopback-next](https://github.com/strongloop/loopback-next).
 
 ## Overview
+
 This component provides a REST server for your application instances, complete
 with:
+
 - new custom routing engine (special thanks to @bajtos)!
 - tools for defining your application routes
-- OpenAPI 2.0 spec (`swagger.json`/`swagger.yaml`) generation
+- OpenAPI 3.0 spec (`openapi.json`/`openapi.yaml`) generation using
+  `@loopback/openapi-v3`
 - a default sequence implementation to manage the request and response lifecycle
+
 ## Installation
-To use this package, you'll need to install both `@loopback/core` and
-`@loopback/rest`.
 
-```shell
-$ npm install --save @loopback/core @loopback/rest
+To use this package, you'll need to install `@loopback/rest`.
+
+```sh
+npm i @loopback/rest
 ```
 
 ## Basic Use
-Here's a basic "Hello World" application using `@loopback/core` and
-`@loopback/rest`:
-
-  ```ts
-  import {Application} from '@loopback/core';
-  import {RestComponent, RestServer} from '@loopback/rest';
-
-  const app = new Application({
-    components: [
-      RestComponent,
-    ]
-  });
-
-  (async function start() {
-    const rest = await app.getServer(RestServer);
-    rest.handler((sequence, request, response) => {
-      sequence.send(response, 'hello world');
-    });
-    await app.start();
-    console.log(`REST server running on port: ${rest.getSync('rest.port')}`);
-  })();
-  ```
 
-## Configuration
-The rest package is configured by passing a `rest` property inside of your
-Application options.
+Here's a basic "Hello World" application using `@loopback/rest`:
 
 ```ts
-  const app = new Application({
-    components: [
-      RestComponent,
-    ],
-    rest: {
-      port: 3001
-    }
-  });
-```
+import {RestApplication, RestServer} from '@loopback/rest';
 
-### `rest` options
+const app = new RestApplication();
+app.handler(({request, response}, sequence) => {
+  sequence.send(response, 'hello world');
+});
 
-| Property | Type | Purpose |
-|----------|------|---------|
-| port | number | Specify the port on which the RestServer will listen for traffic. |
-| secure (NOT YET IMPLEMENTED) | HttpsConfiguration | Provide a collection of secure key materials to the RestServer, which switches it to HTTPS mode. |
-| sequence | SequenceHandler | Use a custom SequenceHandler to change the behaviour of the RestServer for the request-response lifecycle. |
+(async function start() {
+  await app.start();
 
-#### HttpsConfiguration
-<!-- TODO(@kjdelisle): Define the contents of this type for users. -->
+  const server = await app.getServer(RestServer);
+  const port = await server.get('rest.port');
+  console.log(`Server is running at http://127.0.0.1:${port}`);
+})();
+```
+
+## Configuration
 
-#### SequenceHandler
-<!-- TODO(@kjdelisle): Point to the request-response lifecycle doc
-(or migrate it here?) -->
+See https://loopback.io/doc/en/lb4/Server.html#configuration.
 
 ## Contributions
 
-- [Guidelines](https://github.com/strongloop/loopback-next/wiki/Contributing#guidelines)
+- [Guidelines](https://github.com/strongloop/loopback-next/blob/master/docs/CONTRIBUTING.md)
 - [Join the team](https://github.com/strongloop/loopback-next/issues/110)
 
 ## Tests
@@ -87,7 +58,8 @@ Run `npm test` from the root folder.
 
 ## Contributors
 
-See [all contributors](https://github.com/strongloop/loopback-next/graphs/contributors).
+See
+[all contributors](https://github.com/strongloop/loopback-next/graphs/contributors).
 
 ## License
 

package/dist/body-parsers/body-parser.d.ts

@@ -0,0 +1,25 @@
+import { Context } from '@loopback/context';
+import { OperationObject } from '@loopback/openapi-v3';
+import { Request } from '../types';
+import { BodyParser, RequestBody } from './types';
+export declare class RequestBodyParser {
+    private readonly ctx?;
+    readonly parsers: BodyParser[];
+    constructor(parsers?: BodyParser[], ctx?: Context | undefined);
+    loadRequestBodyIfNeeded(operationSpec: OperationObject, request: Request): Promise<RequestBody>;
+    /**
+     * Match the http request to a given media type of the request body spec
+     */
+    private _matchRequestBodySpec;
+    /**
+     * Find a body parser that supports the media type
+     * @param matchedMediaType - Media type
+     */
+    private _findParser;
+    /**
+     * Resolve and invoke a custom parser
+     * @param customParser - The parser name, class or function
+     * @param request - Http request
+     */
+    private _invokeCustomParser;
+}

package/dist/body-parsers/body-parser.helpers.d.ts

@@ -0,0 +1,44 @@
+import { Options, OptionsJson, OptionsText, OptionsUrlencoded } from 'body-parser';
+import { HttpError } from 'http-errors';
+import { Request, RequestBodyParserOptions, Response } from '../types';
+/**
+ * Get the content-type header value from the request
+ * @param req - Http request
+ */
+export declare function getContentType(req: Request): string | undefined;
+/**
+ * Express body parser function type
+ */
+export declare type BodyParserMiddleware = (request: Request, response: Response, next: (err: HttpError) => void) => void;
+/**
+ * Normalize parsing errors as `4xx`
+ * @param err
+ */
+export declare function normalizeParsingError(err: HttpError): HttpError;
+/**
+ * Parse the request body asynchronously
+ * @param handle - The express middleware handler
+ * @param request - Http request
+ */
+export declare function invokeBodyParserMiddleware(handle: BodyParserMiddleware, request: Request): Promise<any>;
+export declare const DEFAULT_LIMIT = "1mb";
+/**
+ * Extract parser options based on the parser type
+ * @param type - json|urlencoded|text
+ * @param options
+ */
+export declare function getParserOptions(type: 'json', options: RequestBodyParserOptions): OptionsJson;
+export declare function getParserOptions(type: 'urlencoded', options: RequestBodyParserOptions): OptionsUrlencoded;
+export declare function getParserOptions(type: 'text', options: RequestBodyParserOptions): OptionsText;
+export declare function getParserOptions(type: 'raw', options: RequestBodyParserOptions): Options;
+export declare namespace builtinParsers {
+    const json: unique symbol;
+    const urlencoded: unique symbol;
+    const text: unique symbol;
+    const raw: unique symbol;
+    const stream: unique symbol;
+    const names: (string | symbol)[];
+    const mapping: {
+        [name: string]: symbol;
+    };
+}

package/dist/body-parsers/body-parser.helpers.js

@@ -0,0 +1,102 @@
+"use strict";
+// Copyright IBM Corp. 2018,2019. 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.builtinParsers = exports.getParserOptions = exports.DEFAULT_LIMIT = exports.invokeBodyParserMiddleware = exports.normalizeParsingError = exports.getContentType = void 0;
+const tslib_1 = require("tslib");
+const debug_1 = tslib_1.__importDefault(require("debug"));
+const debug = debug_1.default('loopback:rest:body-parser');
+/**
+ * Get the content-type header value from the request
+ * @param req - Http request
+ */
+function getContentType(req) {
+    return req.get('content-type');
+}
+exports.getContentType = getContentType;
+/**
+ * Normalize parsing errors as `4xx`
+ * @param err
+ */
+function normalizeParsingError(err) {
+    debug('Cannot parse request body %j', err);
+    if (!err.statusCode || err.statusCode >= 500) {
+        err.statusCode = 400;
+    }
+    return err;
+}
+exports.normalizeParsingError = normalizeParsingError;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Parse the request body asynchronously
+ * @param handle - The express middleware handler
+ * @param request - Http request
+ */
+function invokeBodyParserMiddleware(handle, request) {
+    // A hack to fool TypeScript as we don't need `response`
+    const response = {};
+    return new Promise((resolve, reject) => {
+        handle(request, response, err => {
+            if (err) {
+                reject(err);
+                return;
+            }
+            resolve(request.body);
+        });
+    });
+}
+exports.invokeBodyParserMiddleware = invokeBodyParserMiddleware;
+// Default limit of the body length
+exports.DEFAULT_LIMIT = '1mb';
+function getParserOptions(type, options) {
+    const opts = { limit: exports.DEFAULT_LIMIT };
+    switch (type) {
+        case 'json':
+            // Allow */json and */*+json
+            opts.type = ['*/json', '*/*+json'];
+            opts.strict = false;
+            break;
+        case 'urlencoded':
+            opts.type = type;
+            opts.extended = true;
+            break;
+        case 'text':
+            // Set media type to `text/*` to match `text/plain` or `text/html`
+            opts.type = 'text/*';
+            break;
+        case 'raw':
+            opts.type = ['application/octet-stream', '*/*'];
+            break;
+    }
+    Object.assign(opts, options[type], options);
+    for (const k of ['json', 'urlencoded', 'text', 'raw']) {
+        delete opts[k];
+    }
+    return opts;
+}
+exports.getParserOptions = getParserOptions;
+var builtinParsers;
+(function (builtinParsers) {
+    builtinParsers.json = Symbol('json');
+    builtinParsers.urlencoded = Symbol('urlencoded');
+    builtinParsers.text = Symbol('text');
+    builtinParsers.raw = Symbol('raw');
+    builtinParsers.stream = Symbol('stream');
+    builtinParsers.names = [
+        builtinParsers.json,
+        builtinParsers.urlencoded,
+        builtinParsers.text,
+        builtinParsers.raw,
+        builtinParsers.stream,
+    ];
+    builtinParsers.mapping = {
+        json: builtinParsers.json,
+        urlencoded: builtinParsers.urlencoded,
+        text: builtinParsers.text,
+        raw: builtinParsers.raw,
+        stream: builtinParsers.stream,
+    };
+})(builtinParsers = exports.builtinParsers || (exports.builtinParsers = {}));
+//# sourceMappingURL=body-parser.helpers.js.map

package/dist/body-parsers/body-parser.helpers.js.map

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

package/dist/body-parsers/body-parser.js

@@ -0,0 +1,159 @@
+"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.RequestBodyParser = void 0;
+const tslib_1 = require("tslib");
+const context_1 = require("@loopback/context");
+const openapi_v3_1 = require("@loopback/openapi-v3");
+const debug_1 = tslib_1.__importDefault(require("debug"));
+const type_is_1 = require("type-is");
+const rest_http_error_1 = require("../rest-http-error");
+const body_parser_helpers_1 = require("./body-parser.helpers");
+const types_1 = require("./types");
+const debug = debug_1.default('loopback:rest:body-parser');
+let RequestBodyParser = /** @class */ (() => {
+    let RequestBodyParser = class RequestBodyParser {
+        constructor(parsers, ctx) {
+            this.ctx = ctx;
+            this.parsers = sortParsers(parsers !== null && parsers !== void 0 ? parsers : []);
+            if (debug.enabled) {
+                debug('Body parsers: ', this.parsers.map(p => p.name));
+            }
+        }
+        async loadRequestBodyIfNeeded(operationSpec, request) {
+            const { requestBody, customParser } = await this._matchRequestBodySpec(operationSpec, request);
+            if (!operationSpec.requestBody)
+                return requestBody;
+            const matchedMediaType = requestBody.mediaType;
+            try {
+                if (customParser) {
+                    // Invoke the custom parser
+                    const body = await this._invokeCustomParser(customParser, request);
+                    return Object.assign(requestBody, body);
+                }
+                else {
+                    const parser = this._findParser(matchedMediaType);
+                    if (parser) {
+                        const body = await parser.parse(request);
+                        return Object.assign(requestBody, body);
+                    }
+                }
+            }
+            catch (err) {
+                throw body_parser_helpers_1.normalizeParsingError(err);
+            }
+            throw rest_http_error_1.RestHttpErrors.unsupportedMediaType(matchedMediaType);
+        }
+        /**
+         * Match the http request to a given media type of the request body spec
+         */
+        async _matchRequestBodySpec(operationSpec, request) {
+            var _a;
+            const requestBody = {
+                value: undefined,
+            };
+            if (!operationSpec.requestBody)
+                return { requestBody };
+            const contentType = (_a = body_parser_helpers_1.getContentType(request)) !== null && _a !== void 0 ? _a : 'application/json';
+            debug('Loading request body with content type %j', contentType);
+            // 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.');
+            }
+            let content = operationSpec.requestBody.content || {};
+            if (!Object.keys(content).length) {
+                content = {
+                    // default to allow json and urlencoded
+                    'application/json': { schema: { type: 'object' } },
+                    'application/x-www-form-urlencoded': { schema: { type: 'object' } },
+                };
+            }
+            // Check of the request content type matches one of the expected media
+            // types in the request body spec
+            let matchedMediaType = false;
+            let customParser = undefined;
+            for (const type in content) {
+                matchedMediaType = type_is_1.is(contentType, type);
+                if (matchedMediaType) {
+                    debug('Matched media type: %s -> %s', type, contentType);
+                    requestBody.mediaType = contentType;
+                    requestBody.schema = content[type].schema;
+                    customParser = content[type]['x-parser'];
+                    break;
+                }
+            }
+            if (!matchedMediaType) {
+                // No matching media type found, fail fast
+                throw rest_http_error_1.RestHttpErrors.unsupportedMediaType(contentType, Object.keys(content));
+            }
+            return { requestBody, customParser };
+        }
+        /**
+         * Find a body parser that supports the media type
+         * @param matchedMediaType - Media type
+         */
+        _findParser(matchedMediaType) {
+            for (const parser of this.parsers) {
+                if (!parser.supports(matchedMediaType)) {
+                    debug('Body parser %s does not support %s', parser.name, matchedMediaType);
+                    continue;
+                }
+                debug('Body parser %s found for %s', parser.name, matchedMediaType);
+                return parser;
+            }
+        }
+        /**
+         * Resolve and invoke a custom parser
+         * @param customParser - The parser name, class or function
+         * @param request - Http request
+         */
+        async _invokeCustomParser(customParser, request) {
+            if (typeof customParser === 'string') {
+                const parser = this.parsers.find(p => p.name === customParser ||
+                    p.name === body_parser_helpers_1.builtinParsers.mapping[customParser]);
+                if (parser) {
+                    debug('Using custom parser %s', customParser);
+                    return parser.parse(request);
+                }
+            }
+            else if (typeof customParser === 'function') {
+                if (isBodyParserClass(customParser)) {
+                    debug('Using custom parser class %s', customParser.name);
+                    const parser = await context_1.instantiateClass(customParser, this.ctx);
+                    return parser.parse(request);
+                }
+                else {
+                    debug('Using custom parser function %s', customParser.name);
+                    return customParser(request);
+                }
+            }
+            throw new Error('Custom parser not found: ' + customParser);
+        }
+    };
+    RequestBodyParser = tslib_1.__decorate([
+        tslib_1.__param(0, context_1.inject(context_1.filterByTag(types_1.REQUEST_BODY_PARSER_TAG), { optional: true })),
+        tslib_1.__param(1, context_1.inject.context()),
+        tslib_1.__metadata("design:paramtypes", [Array, context_1.Context])
+    ], RequestBodyParser);
+    return RequestBodyParser;
+})();
+exports.RequestBodyParser = RequestBodyParser;
+/**
+ * Test if a function is a body parser class or plain function
+ * @param fn
+ */
+function isBodyParserClass(fn) {
+    return fn.toString().startsWith('class ');
+}
+/**
+ * Sort body parsers so that built-in ones are used after extensions
+ * @param parsers
+ */
+function sortParsers(parsers) {
+    return parsers.sort((a, b) => context_1.compareByOrder(a.name, b.name, body_parser_helpers_1.builtinParsers.names));
+}
+//# sourceMappingURL=body-parser.js.map

package/dist/body-parsers/body-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-parser.js","sourceRoot":"","sources":["../../src/body-parsers/body-parser.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,+CAO2B;AAC3B,qDAAwE;AACxE,0DAAgC;AAChC,qCAA2B;AAC3B,wDAAkD;AAElD,+DAI+B;AAC/B,mCAKiB;AAEjB,MAAM,KAAK,GAAG,eAAW,CAAC,2BAA2B,CAAC,CAAC;AAEvD;IAAA,IAAa,iBAAiB,GAA9B,MAAa,iBAAiB;QAG5B,YAEE,OAAsB,EACa,GAAa;YAAb,QAAG,GAAH,GAAG,CAAU;YAEhD,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC,CAAC;YAC1C,IAAI,KAAK,CAAC,OAAO,EAAE;gBACjB,KAAK,CACH,gBAAgB,EAChB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9B,CAAC;aACH;QACH,CAAC;QAED,KAAK,CAAC,uBAAuB,CAC3B,aAA8B,EAC9B,OAAgB;YAEhB,MAAM,EAAC,WAAW,EAAE,YAAY,EAAC,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAClE,aAAa,EACb,OAAO,CACR,CAAC;YACF,IAAI,CAAC,aAAa,CAAC,WAAW;gBAAE,OAAO,WAAW,CAAC;YACnD,MAAM,gBAAgB,GAAG,WAAW,CAAC,SAAU,CAAC;YAChD,IAAI;gBACF,IAAI,YAAY,EAAE;oBAChB,2BAA2B;oBAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBACnE,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;iBACzC;qBAAM;oBACL,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;oBAClD,IAAI,MAAM,EAAE;wBACV,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBACzC,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;qBACzC;iBACF;aACF;YAAC,OAAO,GAAG,EAAE;gBACZ,MAAM,2CAAqB,CAAC,GAAG,CAAC,CAAC;aAClC;YAED,MAAM,gCAAc,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;QAC9D,CAAC;QAED;;WAEG;QACK,KAAK,CAAC,qBAAqB,CACjC,aAA8B,EAC9B,OAAgB;;YAEhB,MAAM,WAAW,GAAgB;gBAC/B,KAAK,EAAE,SAAS;aACjB,CAAC;YACF,IAAI,CAAC,aAAa,CAAC,WAAW;gBAAE,OAAO,EAAC,WAAW,EAAC,CAAC;YAErD,MAAM,WAAW,SAAG,oCAAc,CAAC,OAAO,CAAC,mCAAI,kBAAkB,CAAC;YAClE,KAAK,CAAC,2CAA2C,EAAE,WAAW,CAAC,CAAC;YAEhE,uEAAuE;YACvE,uEAAuE;YACvE,IAAI,8BAAiB,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE;gBAChD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;aAC3D;YAED,IAAI,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE;gBAChC,OAAO,GAAG;oBACR,uCAAuC;oBACvC,kBAAkB,EAAE,EAAC,MAAM,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAC,EAAC;oBAC9C,mCAAmC,EAAE,EAAC,MAAM,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAC,EAAC;iBAChE,CAAC;aACH;YAED,sEAAsE;YACtE,iCAAiC;YACjC,IAAI,gBAAgB,GAAmB,KAAK,CAAC;YAC7C,IAAI,YAAY,GAAG,SAAS,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE;gBAC1B,gBAAgB,GAAG,YAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBACzC,IAAI,gBAAgB,EAAE;oBACpB,KAAK,CAAC,8BAA8B,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;oBACzD,WAAW,CAAC,SAAS,GAAG,WAAW,CAAC;oBACpC,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;oBAC1C,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;oBACzC,MAAM;iBACP;aACF;YAED,IAAI,CAAC,gBAAgB,EAAE;gBACrB,0CAA0C;gBAC1C,MAAM,gCAAc,CAAC,oBAAoB,CACvC,WAAW,EACX,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CACrB,CAAC;aACH;YAED,OAAO,EAAC,WAAW,EAAE,YAAY,EAAC,CAAC;QACrC,CAAC;QAED;;;WAGG;QACK,WAAW,CAAC,gBAAwB;YAC1C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE;gBACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE;oBACtC,KAAK,CACH,oCAAoC,EACpC,MAAM,CAAC,IAAI,EACX,gBAAgB,CACjB,CAAC;oBACF,SAAS;iBACV;gBACD,KAAK,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;gBACpE,OAAO,MAAM,CAAC;aACf;QACH,CAAC;QAED;;;;WAIG;QACK,KAAK,CAAC,mBAAmB,CAC/B,YAAmE,EACnE,OAAgB;YAEhB,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE;gBACpC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,CACF,CAAC,CAAC,IAAI,KAAK,YAAY;oBACvB,CAAC,CAAC,IAAI,KAAK,oCAAc,CAAC,OAAO,CAAC,YAAY,CAAC,CAClD,CAAC;gBACF,IAAI,MAAM,EAAE;oBACV,KAAK,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAC;oBAC9C,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;iBAC9B;aACF;iBAAM,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE;gBAC7C,IAAI,iBAAiB,CAAC,YAAY,CAAC,EAAE;oBACnC,KAAK,CAAC,8BAA8B,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;oBACzD,MAAM,MAAM,GAAG,MAAM,0BAAgB,CACnC,YAAuC,EACvC,IAAI,CAAC,GAAI,CACV,CAAC;oBACF,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;iBAC9B;qBAAM;oBACL,KAAK,CAAC,iCAAiC,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;oBAC5D,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;iBAC9B;aACF;YACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,YAAY,CAAC,CAAC;QAC9D,CAAC;KACF,CAAA;IA3JY,iBAAiB;QAIzB,mBAAA,gBAAM,CAAC,qBAAW,CAAC,+BAAuB,CAAC,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;QAE9D,mBAAA,gBAAM,CAAC,OAAO,EAAE,CAAA;wDAAwB,iBAAO;OANvC,iBAAiB,CA2J7B;IAAD,wBAAC;KAAA;AA3JY,8CAAiB;AA6J9B;;;GAGG;AACH,SAAS,iBAAiB,CACxB,EAAgD;IAEhD,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,OAAqB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC3B,wBAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,oCAAc,CAAC,KAAK,CAAC,CACrD,CAAC;AACJ,CAAC"}

package/dist/body-parsers/body-parser.json.d.ts

@@ -0,0 +1,9 @@
+import { Request, RequestBodyParserOptions } from '../types';
+import { BodyParser, RequestBody } from './types';
+export declare class JsonBodyParser implements BodyParser {
+    name: symbol;
+    private jsonParser;
+    constructor(options?: RequestBodyParserOptions);
+    supports(mediaType: string): boolean;
+    parse(request: Request): Promise<RequestBody>;
+}

package/dist/body-parsers/body-parser.json.js

@@ -0,0 +1,43 @@
+"use strict";
+// Copyright IBM Corp. 2018,2019. 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.JsonBodyParser = void 0;
+const tslib_1 = require("tslib");
+const context_1 = require("@loopback/context");
+const body_parser_1 = require("body-parser");
+const type_is_1 = require("type-is");
+const keys_1 = require("../keys");
+const body_parser_helpers_1 = require("./body-parser.helpers");
+const parse_json_1 = require("../parse-json");
+let JsonBodyParser = /** @class */ (() => {
+    let JsonBodyParser = class JsonBodyParser {
+        constructor(options = {}) {
+            this.name = body_parser_helpers_1.builtinParsers.json;
+            const jsonOptions = body_parser_helpers_1.getParserOptions('json', options);
+            jsonOptions.reviver = parse_json_1.sanitizeJsonParse(jsonOptions.reviver);
+            this.jsonParser = body_parser_1.json(jsonOptions);
+        }
+        supports(mediaType) {
+            return !!type_is_1.is(mediaType, '*/json', '*/*+json');
+        }
+        async parse(request) {
+            let body = await body_parser_helpers_1.invokeBodyParserMiddleware(this.jsonParser, request);
+            // https://github.com/expressjs/body-parser/blob/master/lib/types/json.js#L71-L76
+            const contentLength = request.get('content-length');
+            if (contentLength != null && +contentLength === 0) {
+                body = undefined;
+            }
+            return { value: body };
+        }
+    };
+    JsonBodyParser = tslib_1.__decorate([
+        tslib_1.__param(0, context_1.inject(keys_1.RestBindings.REQUEST_BODY_PARSER_OPTIONS, { optional: true })),
+        tslib_1.__metadata("design:paramtypes", [Object])
+    ], JsonBodyParser);
+    return JsonBodyParser;
+})();
+exports.JsonBodyParser = JsonBodyParser;
+//# sourceMappingURL=body-parser.json.js.map

package/dist/body-parsers/body-parser.json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-parser.json.js","sourceRoot":"","sources":["../../src/body-parsers/body-parser.json.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,+CAAyC;AACzC,6CAAiC;AACjC,qCAA2B;AAC3B,kCAAqC;AAErC,+DAK+B;AAE/B,8CAAgD;AAEhD;IAAA,IAAa,cAAc,GAA3B,MAAa,cAAc;QAIzB,YAEE,UAAoC,EAAE;YALxC,SAAI,GAAG,oCAAc,CAAC,IAAI,CAAC;YAOzB,MAAM,WAAW,GAAG,sCAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACtD,WAAW,CAAC,OAAO,GAAG,8BAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC7D,IAAI,CAAC,UAAU,GAAG,kBAAI,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;QAED,QAAQ,CAAC,SAAiB;YACxB,OAAO,CAAC,CAAC,YAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,OAAgB;YAC1B,IAAI,IAAI,GAAG,MAAM,gDAA0B,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACtE,iFAAiF;YACjF,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACpD,IAAI,aAAa,IAAI,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC,EAAE;gBACjD,IAAI,GAAG,SAAS,CAAC;aAClB;YACD,OAAO,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;QACvB,CAAC;KACF,CAAA;IA1BY,cAAc;QAKtB,mBAAA,gBAAM,CAAC,mBAAY,CAAC,2BAA2B,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;;OAL1D,cAAc,CA0B1B;IAAD,qBAAC;KAAA;AA1BY,wCAAc"}

package/dist/body-parsers/body-parser.raw.d.ts

@@ -0,0 +1,12 @@
+import { Request, RequestBodyParserOptions } from '../types';
+import { BodyParser, RequestBody } from './types';
+/**
+ * Parsing the request body into Buffer
+ */
+export declare class RawBodyParser implements BodyParser {
+    name: symbol;
+    private rawParser;
+    constructor(options?: RequestBodyParserOptions);
+    supports(mediaType: string): boolean;
+    parse(request: Request): Promise<RequestBody>;
+}

package/dist/body-parsers/body-parser.raw.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright IBM Corp. 2018. 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.RawBodyParser = void 0;
+const tslib_1 = require("tslib");
+const context_1 = require("@loopback/context");
+const body_parser_1 = require("body-parser");
+const type_is_1 = require("type-is");
+const keys_1 = require("../keys");
+const body_parser_helpers_1 = require("./body-parser.helpers");
+/**
+ * Parsing the request body into Buffer
+ */
+let RawBodyParser = /** @class */ (() => {
+    let RawBodyParser = class RawBodyParser {
+        constructor(options = {}) {
+            this.name = body_parser_helpers_1.builtinParsers.raw;
+            const rawOptions = body_parser_helpers_1.getParserOptions('raw', options);
+            this.rawParser = body_parser_1.raw(rawOptions);
+        }
+        supports(mediaType) {
+            return !!type_is_1.is(mediaType, 'application/octet-stream');
+        }
+        async parse(request) {
+            const body = await body_parser_helpers_1.invokeBodyParserMiddleware(this.rawParser, request);
+            return { value: body };
+        }
+    };
+    RawBodyParser = tslib_1.__decorate([
+        tslib_1.__param(0, context_1.inject(keys_1.RestBindings.REQUEST_BODY_PARSER_OPTIONS, { optional: true })),
+        tslib_1.__metadata("design:paramtypes", [Object])
+    ], RawBodyParser);
+    return RawBodyParser;
+})();
+exports.RawBodyParser = RawBodyParser;
+//# sourceMappingURL=body-parser.raw.js.map

package/dist/body-parsers/body-parser.raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-parser.raw.js","sourceRoot":"","sources":["../../src/body-parsers/body-parser.raw.ts"],"names":[],"mappings":";AAAA,iDAAiD;AACjD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,+CAAyC;AACzC,6CAAgC;AAChC,qCAA2B;AAC3B,kCAAqC;AAErC,+DAK+B;AAG/B;;GAEG;AACH;IAAA,IAAa,aAAa,GAA1B,MAAa,aAAa;QAIxB,YAEE,UAAoC,EAAE;YALxC,SAAI,GAAG,oCAAc,CAAC,GAAG,CAAC;YAOxB,MAAM,UAAU,GAAG,sCAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACpD,IAAI,CAAC,SAAS,GAAG,iBAAG,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QAED,QAAQ,CAAC,SAAiB;YACxB,OAAO,CAAC,CAAC,YAAE,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;QACrD,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,OAAgB;YAC1B,MAAM,IAAI,GAAG,MAAM,gDAA0B,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACvE,OAAO,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;QACvB,CAAC;KACF,CAAA;IApBY,aAAa;QAKrB,mBAAA,gBAAM,CAAC,mBAAY,CAAC,2BAA2B,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;;OAL1D,aAAa,CAoBzB;IAAD,oBAAC;KAAA;AApBY,sCAAa"}

package/dist/body-parsers/body-parser.stream.d.ts

@@ -0,0 +1,12 @@
+import { Request } from '../types';
+import { BodyParser, RequestBody } from './types';
+/**
+ * A special body parser to retain request stream as is.
+ * It will be used by explicitly setting `x-parser` to `'stream'` in the request
+ * body spec.
+ */
+export declare class StreamBodyParser implements BodyParser {
+    name: symbol;
+    supports(mediaType: string): boolean;
+    parse(request: Request): Promise<RequestBody>;
+}

package/dist/body-parsers/body-parser.stream.js

@@ -0,0 +1,28 @@
+"use strict";
+// Copyright IBM Corp. 2018. 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.StreamBodyParser = void 0;
+const body_parser_helpers_1 = require("./body-parser.helpers");
+/**
+ * A special body parser to retain request stream as is.
+ * It will be used by explicitly setting `x-parser` to `'stream'` in the request
+ * body spec.
+ */
+class StreamBodyParser {
+    constructor() {
+        this.name = body_parser_helpers_1.builtinParsers.stream;
+    }
+    supports(mediaType) {
+        // Return `false` so that this parser can only be trigged by the
+        // `{x-parser: 'stream'}` extension in the request body spec
+        return false;
+    }
+    async parse(request) {
+        return { value: request };
+    }
+}
+exports.StreamBodyParser = StreamBodyParser;
+//# sourceMappingURL=body-parser.stream.js.map

package/dist/body-parsers/body-parser.stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-parser.stream.js","sourceRoot":"","sources":["../../src/body-parsers/body-parser.stream.ts"],"names":[],"mappings":";AAAA,iDAAiD;AACjD,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;AAIhE,+DAAqD;AAErD;;;;GAIG;AACH,MAAa,gBAAgB;IAA7B;QACE,SAAI,GAAG,oCAAc,CAAC,MAAM,CAAC;IAW/B,CAAC;IATC,QAAQ,CAAC,SAAiB;QACxB,gEAAgE;QAChE,4DAA4D;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAgB;QAC1B,OAAO,EAAC,KAAK,EAAE,OAAO,EAAC,CAAC;IAC1B,CAAC;CACF;AAZD,4CAYC"}

package/dist/body-parsers/body-parser.text.d.ts

@@ -0,0 +1,9 @@
+import { Request, RequestBodyParserOptions } from '../types';
+import { BodyParser, RequestBody } from './types';
+export declare class TextBodyParser implements BodyParser {
+    name: symbol;
+    private textParser;
+    constructor(options?: RequestBodyParserOptions);
+    supports(mediaType: string): boolean;
+    parse(request: Request): Promise<RequestBody>;
+}