@loopback/rest 4.0.0-alpha.8 → 5.0.1

package/dist/src/rest-server.js

@@ -1,426 +0,0 @@
-"use strict";
-// Copyright IBM Corp. 2017. All Rights Reserved.
-// Node module: @loopback/rest
-// This file is licensed under the MIT License.
-// License text available at https://opensource.org/licenses/MIT
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const assert_1 = require("assert");
-const swagger2openapi = require('swagger2openapi');
-const js_yaml_1 = require("js-yaml");
-const context_1 = require("@loopback/context");
-const _1 = require(".");
-const openapi_spec_1 = require("@loopback/openapi-spec");
-const http_1 = require("http");
-const core_1 = require("@loopback/core");
-const metadata_1 = require("./router/metadata");
-const http_handler_1 = require("./http-handler");
-const sequence_1 = require("./sequence");
-const keys_1 = require("./keys");
-const SequenceActions = keys_1.RestBindings.SequenceActions;
-// NOTE(bajtos) we cannot use `import * as cloneDeep from 'lodash/cloneDeep'
-// because it produces the following TypeScript error:
-//  Module '"(...)/node_modules/@types/lodash/cloneDeep/index"' resolves to
-//  a non-module entity and cannot be imported using this construct.
-const cloneDeep = require('lodash/cloneDeep');
-const OPENAPI_SPEC_MAPPING = {
-    '/openapi.json': { version: '3.0.0', format: 'json' },
-    '/openapi.yaml': { version: '3.0.0', format: 'yaml' },
-    '/swagger.json': { version: '2.0', format: 'json' },
-    '/swagger.yaml': { version: '2.0', format: 'yaml' },
-};
-/**
- * A REST API server for use with Loopback.
- * Add this server to your application by importing the RestComponent.
- * ```ts
- * const app = new MyApplication({
- *   components: [RestComponent]
- * });
- * // OR
- * app.component(RestComponent);
- * ```
- *
- * To add additional instances of RestServer to your application, use the
- * `.server` function:
- * ```ts
- * app.server(RestServer, 'nameOfYourServer');
- * ```
- *
- * By default, one instance of RestServer will be created when the RestComponent
- * is bootstrapped. This instance can be retrieved with
- * `app.getServer(RestServer)`, or by calling `app.get('servers.RestServer')`
- * Note that retrieving other instances of RestServer must be done using the
- * server's name:
- * ```ts
- * const server = await app.getServer('foo')
- * // OR
- * const server = await app.get('servers.foo');
- * ```
- *
- * @export
- * @class RestServer
- * @extends {Context}
- * @implements {Server}
- */
-let RestServer = class RestServer extends context_1.Context {
-    /**
-     * @memberof RestServer
-     * Creates an instance of RestServer.
-     *
-     * @param {Application} app The application instance (injected via
-     * CoreBindings.APPLICATION_INSTANCE).
-     * @param {RestServerConfig=} options The configuration options (injected via
-     * RestBindings.CONFIG).
-     *
-     */
-    constructor(app, options) {
-        super(app);
-        if (!options)
-            options = {};
-        // Can't check falsiness, 0 is a valid port.
-        if (options.port === null || options.port === undefined) {
-            options.port = 3000;
-        }
-        this.bind(keys_1.RestBindings.PORT).to(options.port);
-        this.api(openapi_spec_1.createEmptyApiSpec());
-        this.sequence(options.sequence ? options.sequence : sequence_1.DefaultSequence);
-        this.handleHttp = (req, res) => {
-            try {
-                this._handleHttpRequest(req, res).catch(err => this._onUnhandledError(req, res, err));
-            }
-            catch (err) {
-                this._onUnhandledError(req, res, err);
-            }
-        };
-        this.bind(keys_1.RestBindings.HANDLER).toDynamicValue(() => this.httpHandler);
-    }
-    get httpHandler() {
-        this._setupHandlerIfNeeded();
-        return this._httpHandler;
-    }
-    _handleHttpRequest(request, response) {
-        // allow CORS support for all endpoints so that users
-        // can test with online SwaggerUI instance
-        response.setHeader('Access-Control-Allow-Origin', '*');
-        response.setHeader('Access-Control-Allow-Credentials', 'true');
-        response.setHeader('Access-Control-Allow-Max-Age', '86400');
-        if (request.method === 'GET' &&
-            request.url &&
-            request.url in OPENAPI_SPEC_MAPPING) {
-            // NOTE(bajtos) Regular routes are handled through Sequence.
-            // IMO, this built-in endpoint should not run through a Sequence,
-            // because it's not part of the application API itself.
-            // E.g. if the app implements access/audit logs, I don't want
-            // this endpoint to trigger a log entry. If the server implements
-            // content-negotiation to support XML clients, I don't want the OpenAPI
-            // spec to be converted into an XML response.
-            const options = OPENAPI_SPEC_MAPPING[request.url];
-            return this._serveOpenApiSpec(request, response, options);
-        }
-        if (request.method === 'GET' &&
-            request.url &&
-            request.url === '/swagger-ui') {
-            return this._redirectToSwaggerUI(request, response);
-        }
-        return this.httpHandler.handleRequest(request, response);
-    }
-    _setupHandlerIfNeeded() {
-        // TODO(bajtos) support hot-reloading of controllers
-        // after the app started. The idea is to rebuild the HttpHandler
-        // instance whenever a controller was added/deleted.
-        // See https://github.com/strongloop/loopback-next/issues/433
-        if (this._httpHandler)
-            return;
-        this._httpHandler = new http_handler_1.HttpHandler(this);
-        for (const b of this.find('controllers.*')) {
-            const controllerName = b.key.replace(/^controllers\./, '');
-            const ctor = b.valueConstructor;
-            if (!ctor) {
-                throw new Error(`The controller ${controllerName} was not bound via .toClass()`);
-            }
-            const apiSpec = metadata_1.getControllerSpec(ctor);
-            if (!apiSpec) {
-                // controller methods are specified through app.api() spec
-                continue;
-            }
-            this._httpHandler.registerController(ctor, apiSpec);
-        }
-        for (const b of this.find('routes.*')) {
-            // TODO(bajtos) should we support routes defined asynchronously?
-            const route = this.getSync(b.key);
-            this._httpHandler.registerRoute(route);
-        }
-        // TODO(bajtos) should we support API spec defined asynchronously?
-        const spec = this.getSync(keys_1.RestBindings.API_SPEC);
-        for (const path in spec.paths) {
-            for (const verb in spec.paths[path]) {
-                const routeSpec = spec.paths[path][verb];
-                this._setupOperation(verb, path, routeSpec);
-            }
-        }
-    }
-    _setupOperation(verb, path, spec) {
-        const handler = spec['x-operation'];
-        if (typeof handler === 'function') {
-            // Remove a field value that cannot be represented in JSON.
-            // Start by creating a shallow-copy of the spec, so that we don't
-            // modify the original spec object provided by user.
-            spec = Object.assign({}, spec);
-            delete spec['x-operation'];
-            const route = new _1.Route(verb, path, spec, handler);
-            this._httpHandler.registerRoute(route);
-            return;
-        }
-        const controllerName = spec['x-controller-name'];
-        if (typeof controllerName === 'string') {
-            const b = this.find(`controllers.${controllerName}`)[0];
-            if (!b) {
-                throw new Error(`Unknown controller ${controllerName} used by "${verb} ${path}"`);
-            }
-            const ctor = b.valueConstructor;
-            if (!ctor) {
-                throw new Error(`The controller ${controllerName} was not bound via .toClass()`);
-            }
-            const route = new _1.ControllerRoute(verb, path, spec, ctor);
-            this._httpHandler.registerRoute(route);
-            return;
-        }
-        throw new Error(`There is no handler configured for operation "${verb} ${path}`);
-    }
-    async _serveOpenApiSpec(request, response, options) {
-        options = options || { version: '2.0', format: 'json' };
-        let specObj = this.getApiSpec();
-        if (options.version === '3.0.0') {
-            specObj = await swagger2openapi.convertObj(specObj, { direct: true });
-        }
-        if (options.format === 'json') {
-            const spec = JSON.stringify(specObj, null, 2);
-            response.setHeader('content-type', 'application/json; charset=utf-8');
-            response.end(spec, 'utf-8');
-        }
-        else {
-            const yaml = js_yaml_1.safeDump(specObj, {});
-            response.setHeader('content-type', 'text/yaml; charset=utf-8');
-            response.end(yaml, 'utf-8');
-        }
-    }
-    async _redirectToSwaggerUI(request, response) {
-        response.statusCode = 308;
-        response.setHeader('Location', 'http://petstore.swagger.io/?url=' +
-            'http://' +
-            request.headers.host +
-            '/swagger.json');
-        response.end();
-    }
-    /**
-     * Register a controller class with this server.
-     *
-     * @param {Constructor} controllerCtor The controller class
-     * (constructor function).
-     * @returns {Binding} The newly created binding, you can use the reference to
-     * further modify the binding, e.g. lock the value to prevent further
-     * modifications.
-     *
-     * ```ts
-     * class MyController {
-     * }
-     * app.controller(MyController).lock();
-     * ```
-     *
-     */
-    controller(controllerCtor) {
-        return this.bind('controllers.' + controllerCtor.name).toClass(controllerCtor);
-    }
-    route(routeOrVerb, path, spec, controller, methodName) {
-        if (typeof routeOrVerb === 'object') {
-            const r = routeOrVerb;
-            return this.bind(`routes.${r.verb} ${r.path}`).to(r);
-        }
-        if (!path) {
-            throw new assert_1.AssertionError({
-                message: 'path is required for a controller-based route',
-            });
-        }
-        if (!spec) {
-            throw new assert_1.AssertionError({
-                message: 'spec is required for a controller-based route',
-            });
-        }
-        if (!controller) {
-            throw new assert_1.AssertionError({
-                message: 'controller is required for a controller-based route',
-            });
-        }
-        if (!methodName) {
-            throw new assert_1.AssertionError({
-                message: 'methodName is required for a controller-based route',
-            });
-        }
-        return this.route(new _1.ControllerRoute(routeOrVerb, path, spec, controller, methodName));
-    }
-    /**
-     * Set the OpenAPI specification that defines the REST API schema for this
-     * server. All routes, parameter definitions and return types will be defined
-     * in this way.
-     *
-     * Note that this will override any routes defined via decorators at the
-     * controller level (this function takes precedent).
-     *
-     * @param {OpenApiSpec} spec The OpenAPI specification, as an object.
-     * @returns {Binding}
-     * @memberof RestServer
-     */
-    api(spec) {
-        return this.bind(keys_1.RestBindings.API_SPEC).to(spec);
-    }
-    /**
-     * Get the OpenAPI specification describing the REST API provided by
-     * this application.
-     *
-     * This method merges operations (HTTP endpoints) from the following sources:
-     *  - `app.api(spec)`
-     *  - `app.controller(MyController)`
-     *  - `app.route(route)`
-     *  - `app.route('get', '/greet', operationSpec, MyController, 'greet')`
-     */
-    getApiSpec() {
-        const spec = this.getSync(keys_1.RestBindings.API_SPEC);
-        // Apply deep clone to prevent getApiSpec() callers from
-        // accidentally modifying our internal routing data
-        spec.paths = cloneDeep(this.httpHandler.describeApiPaths());
-        return spec;
-    }
-    /**
-     * Configure a custom sequence class for handling incoming requests.
-     *
-     * ```ts
-     * class MySequence implements SequenceHandler {
-     *   constructor(
-     *     @inject('send) public send: Send)) {
-     *   }
-     *
-     *   public async handle(request: ParsedRequest, response: ServerResponse) {
-     *     send(response, 'hello world');
-     *   }
-     * }
-     * ```
-     *
-     * @param value The sequence to invoke for each incoming request.
-     */
-    sequence(value) {
-        this.bind(keys_1.RestBindings.SEQUENCE).toClass(value);
-    }
-    /**
-     * Configure a custom sequence function for handling incoming requests.
-     *
-     * ```ts
-     * app.handler((sequence, request, response) => {
-     *   sequence.send(response, 'hello world');
-     * });
-     * ```
-     *
-     * @param handlerFn The handler to invoke for each incoming request.
-     */
-    handler(handlerFn) {
-        let SequenceFromFunction = class SequenceFromFunction extends sequence_1.DefaultSequence {
-            // NOTE(bajtos) Unfortunately, we have to duplicate the constructor
-            // in order for our DI/IoC framework to inject constructor arguments
-            constructor(ctx, findRoute, parseParams, invoke, send, reject) {
-                super(ctx, findRoute, parseParams, invoke, send, reject);
-                this.ctx = ctx;
-                this.findRoute = findRoute;
-                this.parseParams = parseParams;
-                this.invoke = invoke;
-                this.send = send;
-                this.reject = reject;
-            }
-            async handle(request, response) {
-                await Promise.resolve(handlerFn(this, request, response));
-            }
-        };
-        SequenceFromFunction = __decorate([
-            __param(0, context_1.inject(keys_1.RestBindings.Http.CONTEXT)),
-            __param(1, context_1.inject(SequenceActions.FIND_ROUTE)),
-            __param(2, context_1.inject(SequenceActions.PARSE_PARAMS)),
-            __param(3, context_1.inject(SequenceActions.INVOKE_METHOD)),
-            __param(4, context_1.inject(SequenceActions.SEND)),
-            __param(5, context_1.inject(SequenceActions.REJECT)),
-            __metadata("design:paramtypes", [context_1.Context, Function, Function, Function, Function, Function])
-        ], SequenceFromFunction);
-        this.sequence(SequenceFromFunction);
-    }
-    /**
-     * Start this REST API's HTTP/HTTPS server.
-     *
-     * @returns {Promise<void>}
-     * @memberof RestServer
-     */
-    async start() {
-        // Setup the HTTP handler so that we can verify the configuration
-        // of API spec, controllers and routes at startup time.
-        this._setupHandlerIfNeeded();
-        const httpPort = await this.get(keys_1.RestBindings.PORT);
-        this._httpServer = http_1.createServer(this.handleHttp);
-        const httpServer = this._httpServer;
-        // TODO(bajtos) support httpHostname too
-        // See https://github.com/strongloop/loopback-next/issues/434
-        httpServer.listen(httpPort);
-        return new Promise((resolve, reject) => {
-            httpServer.once('listening', () => {
-                this.bind(keys_1.RestBindings.PORT).to(httpServer.address().port);
-                resolve();
-            });
-            httpServer.once('error', reject);
-        });
-    }
-    /**
-     * Stop this REST API's HTTP/HTTPS server.
-     *
-     * @returns {Promise<void>}
-     * @memberof RestServer
-     */
-    async stop() {
-        // Kill the server instance.
-        const server = this._httpServer;
-        return new Promise((resolve, reject) => {
-            server.close((err) => {
-                if (err) {
-                    reject(err);
-                }
-                else {
-                    resolve();
-                }
-            });
-        });
-    }
-    _onUnhandledError(req, res, err) {
-        if (!res.headersSent) {
-            res.statusCode = 500;
-            res.end();
-        }
-        // It's the responsibility of the Sequence to handle any errors.
-        // If an unhandled error escaped, then something very wrong happened
-        // and it's best to crash the process immediately.
-        process.nextTick(() => {
-            throw err;
-        });
-    }
-};
-RestServer = __decorate([
-    __param(0, context_1.inject(core_1.CoreBindings.APPLICATION_INSTANCE)),
-    __param(1, context_1.inject(keys_1.RestBindings.CONFIG)),
-    __metadata("design:paramtypes", [core_1.Application, Object])
-], RestServer);
-exports.RestServer = RestServer;
-//# sourceMappingURL=rest-server.js.map

package/dist/src/rest-server.js.map

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

package/dist/src/router/metadata.d.ts

@@ -1,150 +0,0 @@
-import { OperationObject, ParameterObject, SchemaObject, PathsObject } from '@loopback/openapi-spec';
-export interface ControllerSpec {
-    /**
-     * The base path on which the Controller API is served.
-     * If it is not included, the API is served directly under the host.
-     * The value MUST start with a leading slash (/).
-     */
-    basePath?: string;
-    /**
-     * The available paths and operations for the API.
-     */
-    paths: PathsObject;
-}
-/**
- * Decorate the given Controller constructor with metadata describing
- * the HTTP/REST API the Controller implements/provides.
- *
- * `@api` can be applied to controller classes. For example,
- * ```
- * @api({basePath: '/my'})
- * class MyController {
- *   // ...
- * }
- * ```
- *
- * @param spec OpenAPI specification describing the endpoints
- * handled by this controller
- *
- * @decorator
- */
-export declare function api(spec: ControllerSpec): (constructor: Function) => void;
-/**
- * Get the controller spec for the given class
- * @param constructor Controller class
- */
-export declare function getControllerSpec(constructor: Function): ControllerSpec;
-/**
- * Expose a Controller method as a REST API operation
- * mapped to `GET` request method.
- *
- * @param path The URL path of this operation, e.g. `/product/{id}`
- * @param spec The OpenAPI specification describing parameters and responses
- *   of this operation.
- */
-export declare function get(path: string, spec?: OperationObject): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
-/**
- * Expose a Controller method as a REST API operation
- * mapped to `POST` request method.
- *
- * @param path The URL path of this operation, e.g. `/product/{id}`
- * @param spec The OpenAPI specification describing parameters and responses
- *   of this operation.
- */
-export declare function post(path: string, spec?: OperationObject): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
-/**
- * Expose a Controller method as a REST API operation
- * mapped to `PUT` request method.
- *
- * @param path The URL path of this operation, e.g. `/product/{id}`
- * @param spec The OpenAPI specification describing parameters and responses
- *   of this operation.
- */
-export declare function put(path: string, spec?: OperationObject): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
-/**
- * Expose a Controller method as a REST API operation
- * mapped to `PATCH` request method.
- *
- * @param path The URL path of this operation, e.g. `/product/{id}`
- * @param spec The OpenAPI specification describing parameters and responses
- *   of this operation.
- */
-export declare function patch(path: string, spec?: OperationObject): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
-/**
- * Expose a Controller method as a REST API operation
- * mapped to `DELETE` request method.
- *
- * @param path The URL path of this operation, e.g. `/product/{id}`
- * @param spec The OpenAPI specification describing parameters and responses
- *   of this operation.
- */
-export declare function del(path: string, spec?: OperationObject): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
-/**
- * Expose a Controller method as a REST API operation.
- *
- * @param verb HTTP verb, e.g. `GET` or `POST`.
- * @param path The URL path of this operation, e.g. `/product/{id}`
- * @param spec The OpenAPI specification describing parameters and responses
- *   of this operation.
- */
-export declare function operation(verb: string, path: string, spec?: OperationObject): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
-/**
- * Describe an input parameter of a Controller method.
- *
- * `@param` can be applied to method itself or specific parameters. For example,
- * ```
- * class MyController {
- *   @get('/')
- *   @param(offsetSpec)
- *   @param(pageSizeSpec)
- *   list(offset?: number, pageSize?: number) {}
- * }
- * ```
- * or
- * ```
- * class MyController {
- *   @get('/')
- *   list(
- *     @param(offsetSpec) offset?: number,
- *     @param(pageSizeSpec) pageSize?: number,
- *   ) {}
- * }
- * ```
- * Please note mixed usage of `@param` at method/parameter level is not allowed.
- *
- * @param paramSpec Parameter specification.
- */
-export declare function param(paramSpec: ParameterObject): (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-export declare namespace param {
-    const query: {
-        string: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        number: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        integer: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        boolean: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-    };
-    const header: {
-        string: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        number: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        integer: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        boolean: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-    };
-    const path: {
-        string: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        number: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        integer: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        boolean: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-    };
-    const formData: {
-        string: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        number: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        integer: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-        boolean: (name: string) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-    };
-    /**
-     * Define a parameter that's set to the full request body.
-     *
-     * @param name Parameter name
-     * @param schema The schema defining the type used for the body parameter.
-     */
-    const body: (name: string, schema: SchemaObject) => (target: any, propertyKey: string, descriptorOrParameterIndex: number | PropertyDescriptor) => void;
-}