@nmshd/typescript-rest 3.0.5

package/dist/decorators/parameters.js

@@ -0,0 +1,423 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = Context;
+exports.ContextRequest = ContextRequest;
+exports.ContextResponse = ContextResponse;
+exports.ContextNext = ContextNext;
+exports.ContextLanguage = ContextLanguage;
+exports.ContextAccept = ContextAccept;
+exports.PathParam = PathParam;
+exports.FileParam = FileParam;
+exports.FilesParam = FilesParam;
+exports.QueryParam = QueryParam;
+exports.HeaderParam = HeaderParam;
+exports.CookieParam = CookieParam;
+exports.FormParam = FormParam;
+exports.Param = Param;
+const _ = require("lodash");
+require("reflect-metadata");
+const metadata_1 = require("../server/model/metadata");
+const server_container_1 = require("../server/server-container");
+/**
+ * A decorator to be used on class properties or on service method arguments
+ * to inform that the decorated property or argument should be bound to the
+ * [[ServiceContext]] object associated to the current request.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('context')
+ * class TestService {
+ *   @ Context
+ *   context: ServiceContext;
+ *   // ...
+ * }
+ * ```
+ *
+ * The field context on the above class will point to the current
+ * [[ServiceContext]] instance.
+ */
+function Context(...args) {
+    return new ParameterDecorator('Context').withType(metadata_1.ParamType.context).decorateParameterOrProperty(args);
+}
+/**
+ * A decorator to be used on class properties or on service method arguments
+ * to inform that the decorated property or argument should be bound to the
+ * the current request.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('context')
+ * class TestService {
+ *   @ ContextRequest
+ *   request: express.Request;
+ *   // ...
+ * }
+ * ```
+ *
+ * The field request on the above class will point to the current
+ * request.
+ */
+function ContextRequest(...args) {
+    return new ParameterDecorator('ContextRequest')
+        .withType(metadata_1.ParamType.context_request)
+        .decorateParameterOrProperty(args);
+}
+/**
+ * A decorator to be used on class properties or on service method arguments
+ * to inform that the decorated property or argument should be bound to the
+ * the current response object.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('context')
+ * class TestService {
+ *   @ ContextResponse
+ *   response: express.Response;
+ *   // ...
+ * }
+ * ```
+ *
+ * The field response on the above class will point to the current
+ * response object.
+ */
+function ContextResponse(...args) {
+    return new ParameterDecorator('ContextResponse')
+        .withType(metadata_1.ParamType.context_response)
+        .decorateParameterOrProperty(args);
+}
+/**
+ * A decorator to be used on class properties or on service method arguments
+ * to inform that the decorated property or argument should be bound to the
+ * the next function.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('context')
+ * class TestService {
+ *   @ ContextNext
+ *   next: express.NextFunction
+ *       // ...
+ * }
+ * ```
+ *
+ * The next function can be used to delegate to the next registered
+ * middleware the current request processing.
+ */
+function ContextNext(...args) {
+    return new ParameterDecorator('ContextNext').withType(metadata_1.ParamType.context_next).decorateParameterOrProperty(args);
+}
+/**
+ * A decorator to be used on class properties or on service method arguments
+ * to inform that the decorated property or argument should be bound to the
+ * the current context language.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('context')
+ * class TestService {
+ *   @ ContextLanguage
+ *   language: string
+ *       // ...
+ * }
+ * ```
+ */
+function ContextLanguage(...args) {
+    return new ParameterDecorator('ContextLanguage')
+        .withType(metadata_1.ParamType.context_accept_language)
+        .decorateParameterOrProperty(args);
+}
+/**
+ * A decorator to be used on class properties or on service method arguments
+ * to inform that the decorated property or argument should be bound to the
+ * the preferred media type for the current request.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('context')
+ * class TestService {
+ *   @ ContextAccept
+ *   media: string
+ *       // ...
+ * }
+ * ```
+ */
+function ContextAccept(...args) {
+    return new ParameterDecorator('ContextAccept').withType(metadata_1.ParamType.context_accept).decorateParameterOrProperty(args);
+}
+/**
+ * Creates a mapping between a fragment of the requested path and
+ * a method argument.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ GET
+ *   @ Path(':id')
+ *   getPerson(@ PathParam('id') id: string) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests like:
+ *
+ * ```
+ * GET http://mydomain/people/123
+ * ```
+ *
+ * And pass 123 as the id argument on getPerson method's call.
+ */
+function PathParam(name) {
+    return new ParameterDecorator('PathParam')
+        .withType(metadata_1.ParamType.path)
+        .withName(name)
+        .decorateNamedParameterOrProperty();
+}
+/**
+ * Creates a mapping between a file on a multipart request and a method
+ * argument.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ POST
+ *   @ Path('id')
+ *   addAvatar(@ PathParam('id') id: string,
+ *             @ FileParam('avatar') file: Express.Multer.File) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests and bind the
+ * file with name 'avatar' on the requested form to the file
+ * argument on addAvatar method's call.
+ */
+function FileParam(name) {
+    return new ParameterDecorator('FileParam')
+        .withType(metadata_1.ParamType.file)
+        .withName(name)
+        .decorateNamedParameterOrProperty();
+}
+/**
+ * Creates a mapping between a list of files on a multipart request and a method
+ * argument.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ POST
+ *   @ Path('id')
+ *   addAvatar(@ PathParam('id') id: string,
+ *             @ FilesParam('avatar[]') files: Array<Express.Multer.File>) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests and bind the
+ * files with name 'avatar' on the request form to the file
+ * argument on addAvatar method's call.
+ */
+function FilesParam(name) {
+    return new ParameterDecorator('FilesParam')
+        .withType(metadata_1.ParamType.files)
+        .withName(name)
+        .decorateNamedParameterOrProperty();
+}
+/**
+ * Creates a mapping between a query parameter on request and a method
+ * argument.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ GET
+ *   getPeople(@ QueryParam('name') name: string) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests like:
+ *
+ * ```
+ * GET http://mydomain/people?name=joe
+ * ```
+ *
+ * And pass 'joe' as the name argument on getPerson method's call.
+ */
+function QueryParam(name) {
+    return new ParameterDecorator('QueryParam')
+        .withType(metadata_1.ParamType.query)
+        .withName(name)
+        .decorateNamedParameterOrProperty();
+}
+/**
+ * Creates a mapping between a header on request and a method
+ * argument.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ GET
+ *   getPeople(@ HeaderParam('header') header: string) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests and bind the
+ * header called 'header' to the header argument on getPerson method's call.
+ */
+function HeaderParam(name) {
+    return new ParameterDecorator('HeaderParam')
+        .withType(metadata_1.ParamType.header)
+        .withName(name)
+        .decorateNamedParameterOrProperty();
+}
+/**
+ * Creates a mapping between a cookie on request and a method
+ * argument.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ GET
+ *   getPeople(@ CookieParam('cookie') cookie: string) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests and bind the
+ * cookie called 'cookie' to the cookie argument on getPerson method's call.
+ */
+function CookieParam(name) {
+    return new ParameterDecorator('CookieParam')
+        .withType(metadata_1.ParamType.cookie)
+        .withName(name)
+        .decorateNamedParameterOrProperty();
+}
+/**
+ * Creates a mapping between a form parameter on request and a method
+ * argument.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ GET
+ *   getPeople(@ FormParam('name') name: string) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests and bind the
+ * request paramenter called 'name' to the name argument on getPerson
+ * method's call.
+ */
+function FormParam(name) {
+    return new ParameterDecorator('FormParam')
+        .withType(metadata_1.ParamType.form)
+        .withName(name)
+        .decorateNamedParameterOrProperty();
+}
+/**
+ * Creates a mapping between a parameter on request and a method
+ * argument.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ GET
+ *   getPeople(@ Param('name') name: string) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests and bind the
+ * request paramenter called 'name' to the name argument on getPerson
+ * method's call. It will work to query parameters or form parameters
+ * received in the current request.
+ */
+function Param(name) {
+    return new ParameterDecorator('Param').withType(metadata_1.ParamType.param).withName(name).decorateNamedParameterOrProperty();
+}
+class ParameterDecorator {
+    constructor(decorator) {
+        this.nameRequired = false;
+        this.name = null;
+        this.decorator = decorator;
+    }
+    withType(paramType) {
+        this.paramType = paramType;
+        return this;
+    }
+    withName(name) {
+        this.nameRequired = true;
+        this.name = name ? name.trim() : '';
+        return this;
+    }
+    decorateParameterOrProperty(args) {
+        if (!this.nameRequired || this.name) {
+            args = _.without(args, undefined);
+            if (args.length < 3 || typeof args[2] === 'undefined') {
+                return this.decorateProperty(args[0], args[1]);
+            }
+            else if (args.length === 3 && typeof args[2] === 'number') {
+                return this.decorateParameter(args[0], args[1], args[2]);
+            }
+        }
+        throw new Error(`Invalid @${this.decorator} Decorator declaration.`);
+    }
+    decorateNamedParameterOrProperty() {
+        return (...args) => {
+            return this.decorateParameterOrProperty(args);
+        };
+    }
+    decorateParameter(target, propertyKey, parameterIndex) {
+        const serviceMethod = server_container_1.ServerContainer.get().registerServiceMethod(target.constructor, propertyKey);
+        if (serviceMethod) {
+            // does not intercept constructor
+            const paramTypes = Reflect.getOwnMetadata('design:paramtypes', target, propertyKey);
+            while (paramTypes && serviceMethod.parameters.length < paramTypes.length) {
+                serviceMethod.parameters.push(new metadata_1.MethodParam(null, paramTypes[serviceMethod.parameters.length], metadata_1.ParamType.body));
+            }
+            serviceMethod.parameters[parameterIndex] = new metadata_1.MethodParam(this.name, paramTypes[parameterIndex], this.paramType);
+        }
+    }
+    decorateProperty(target, key) {
+        const classData = server_container_1.ServerContainer.get().registerServiceClass(target.constructor);
+        const propertyType = Reflect.getMetadata('design:type', target, key);
+        classData.addProperty(key, {
+            name: this.name,
+            propertyType: propertyType,
+            type: this.paramType
+        });
+    }
+}
+//# sourceMappingURL=parameters.js.map

package/dist/decorators/parameters.js.map

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

package/dist/decorators/services.d.ts

@@ -0,0 +1,199 @@
+import 'reflect-metadata';
+import { ParserType, ServiceProcessor } from '../server/model/server-types';
+/**
+ * A decorator to tell the [[Server]] that a class or a method
+ * should be bound to a given path.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ PUT
+ *   @ Path(':id')
+ *   savePerson(person:Person) {
+ *      // ...
+ *   }
+ *
+ *   @ GET
+ *   @ Path(':id')
+ *   getPerson():Person {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create services that listen for requests like:
+ *
+ * ```
+ * PUT http://mydomain/people/123 or
+ * GET http://mydomain/people/123
+ * ```
+ */
+export declare function Path(path: string): (...args: Array<any>) => void;
+/**
+ * A decorator to tell the [[Server]] that a class or a method
+ * should include a determined role
+ * or all authorized users (token) using passport
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * @ Security()
+ * class PeopleService {
+ *   @ PUT
+ *   @ Path(':id', true)
+ *   @ Security(['ROLE_ADMIN'])
+ *   savePerson(person:Person) {
+ *      // ...
+ *   }
+ *
+ *   @ GET
+ *   @ Path(':id', true)
+ *   getPerson():Person {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create services that listen for requests like:
+ *
+ * ```
+ * PUT http://mydomain/people/123 (Only for ADMIN roles) or
+ * GET http://mydomain/people/123 (For all authorized users)
+ * ```
+ */
+export declare function Security(roles?: string | Array<string>, name?: string): (...args: Array<any>) => void;
+/**
+ * A decorator to tell the [[Server]] that a class or a method
+ * should include a pre-processor in its request pipelines.
+ *
+ * For example:
+ * ```
+ * function validator(req: express.Request): express.Request {
+ *   if (!req.body.userId) {
+ *      throw new Errors.BadRequestError("userId not present");
+ *   }
+ * }
+ * ```
+ * And:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ PUT
+ *   @ Path(':id')
+ *   @ PreProcessor(validator)
+ *   savePerson(person:Person) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ */
+export declare function PreProcessor(preprocessor: ServiceProcessor): (...args: Array<any>) => void;
+/**
+ * A decorator to tell the [[Server]] that a class or a method
+ * should include a post-processor in its request pipelines.
+ *
+ * For example:
+ * ```
+ * function processor(req: express.Request): express.Request {
+ *   if (!req.body.userId) {
+ *      throw new Errors.BadRequestError("userId not present");
+ *   }
+ * }
+ * ```
+ * And:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ PUT
+ *   @ Path(':id')
+ *   @ PostProcessor(validator)
+ *   savePerson(person:Person) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ */
+export declare function PostProcessor(postprocessor: ServiceProcessor): (...args: Array<any>) => void;
+/**
+ * A decorator to tell the [[Server]] that a class or a method
+ * should only accept requests from clients that accepts one of
+ * the supported languages.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('accept')
+ * @ AcceptLanguage('en', 'pt-BR')
+ * class TestAcceptService {
+ *      // ...
+ * }
+ * ```
+ *
+ * Will reject requests that only accepts languages that are not
+ * English or Brazilian portuguese
+ *
+ * If the language requested is not supported, a status code 406 returned
+ */
+export declare function AcceptLanguage(...languages: Array<string>): (...args: Array<any>) => void;
+/**
+ * A decorator to tell the [[Server]] that a class or a method
+ * should only accept requests from clients that accepts one of
+ * the supported mime types.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('accept')
+ * @ Accept('application/json')
+ * class TestAcceptService {
+ *      // ...
+ * }
+ * ```
+ *
+ * Will reject requests that only accepts mime types that are not
+ * 'application/json'
+ *
+ * If the mime type requested is not supported, a status code 406 returned
+ */
+export declare function Accept(...accepts: Array<string>): (...args: Array<any>) => void;
+/**
+ * A decorator to inform options to pe passed to bodyParser.
+ * You can inform any property accepted by
+ * [[bodyParser]](https://www.npmjs.com/package/body-parser)
+ */
+export declare function BodyOptions(options: any): (...args: Array<any>) => void;
+/**
+ * A decorator to inform the type of parser to be used to parse the body.
+ * The default type is json.
+ */
+export declare function BodyType(type: ParserType): (...args: Array<any>) => void;
+/**
+ * A decorator to inform that server should ignore other middlewares.
+ * It makes server does not call next function after service invocation.
+ */
+export declare function IgnoreNextMiddlewares(...args: Array<any>): void;
+/**
+ * Mark the annotated service class as an abstract service. Abstract services has none of its
+ * methods exposed as rest enpoints, even if the class is in the services list to be exposed.
+ *
+ * For example:
+ *
+ * ```
+ * @ Abstract
+ * abstract class PeopleService {
+ *   @ GET
+ *   getPeople(@ Param('name') name: string) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * No endpoint will be registered for PeopleService. It is useful if you only plain that subclasses of
+ * PeopleService exposes the getPeople method.
+ */
+export declare function Abstract(...args: Array<any>): void;