@nmshd/typescript-rest 3.0.5

package/dist/decorators/methods.js

@@ -0,0 +1,263 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET = GET;
+exports.POST = POST;
+exports.PUT = PUT;
+exports.DELETE = DELETE;
+exports.HEAD = HEAD;
+exports.OPTIONS = OPTIONS;
+exports.PATCH = PATCH;
+require("reflect-metadata");
+const metadata_1 = require("../server/model/metadata");
+const server_types_1 = require("../server/model/server-types");
+const server_container_1 = require("../server/server-container");
+/**
+ * A decorator to tell the [[Server]] that a method
+ * should be called to process HTTP GET requests.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ GET
+ *   getPeople() {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests like:
+ *
+ * ```
+ * GET http://mydomain/people
+ * ```
+ */
+function GET(target, propertyKey) {
+    new MethodDecorator(server_types_1.HttpMethod.GET).decorateMethod(target, propertyKey);
+}
+/**
+ * A decorator to tell the [[Server]] that a method
+ * should be called to process HTTP POST requests.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ POST
+ *   addPerson() {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests like:
+ *
+ * ```
+ * POST http://mydomain/people
+ * ```
+ */
+function POST(target, propertyKey) {
+    new MethodDecorator(server_types_1.HttpMethod.POST).decorateMethod(target, propertyKey);
+}
+/**
+ * A decorator to tell the [[Server]] that a method
+ * should be called to process HTTP PUT requests.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ PUT
+ *   @ Path(':id')
+ *   savePerson(person: Person) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests like:
+ *
+ * ```
+ * PUT http://mydomain/people/123
+ * ```
+ */
+function PUT(target, propertyKey) {
+    new MethodDecorator(server_types_1.HttpMethod.PUT).decorateMethod(target, propertyKey);
+}
+/**
+ * A decorator to tell the [[Server]] that a method
+ * should be called to process HTTP DELETE requests.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ DELETE
+ *   @ Path(':id')
+ *   removePerson(@ PathParam('id')id: string) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests like:
+ *
+ * ```
+ * PUT http://mydomain/people/123
+ * ```
+ */
+function DELETE(target, propertyKey) {
+    new MethodDecorator(server_types_1.HttpMethod.DELETE).decorateMethod(target, propertyKey);
+}
+/**
+ * A decorator to tell the [[Server]] that a method
+ * should be called to process HTTP HEAD requests.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ HEAD
+ *   headPerson() {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests like:
+ *
+ * ```
+ * HEAD http://mydomain/people/123
+ * ```
+ */
+function HEAD(target, propertyKey) {
+    new MethodDecorator(server_types_1.HttpMethod.HEAD).decorateMethod(target, propertyKey);
+}
+/**
+ * A decorator to tell the [[Server]] that a method
+ * should be called to process HTTP OPTIONS requests.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ OPTIONS
+ *   optionsPerson() {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests like:
+ *
+ * ```
+ * OPTIONS http://mydomain/people/123
+ * ```
+ */
+function OPTIONS(target, propertyKey) {
+    new MethodDecorator(server_types_1.HttpMethod.OPTIONS).decorateMethod(target, propertyKey);
+}
+/**
+ * A decorator to tell the [[Server]] that a method
+ * should be called to process HTTP PATCH requests.
+ *
+ * For example:
+ *
+ * ```
+ * @ Path('people')
+ * class PeopleService {
+ *   @ PATCH
+ *   @ Path(':id')
+ *   savePerson(person: Person) {
+ *      // ...
+ *   }
+ * }
+ * ```
+ *
+ * Will create a service that listen for requests like:
+ *
+ * ```
+ * PATCH http://mydomain/people/123
+ * ```
+ */
+function PATCH(target, propertyKey) {
+    new MethodDecorator(server_types_1.HttpMethod.PATCH).decorateMethod(target, propertyKey);
+}
+class MethodDecorator {
+    constructor(httpMethod) {
+        this.httpMethod = httpMethod;
+    }
+    decorateMethod(target, propertyKey) {
+        const serviceMethod = server_container_1.ServerContainer.get().registerServiceMethod(target.constructor, propertyKey);
+        if (serviceMethod) {
+            // does not intercept constructor
+            if (!serviceMethod.httpMethod) {
+                serviceMethod.httpMethod = this.httpMethod;
+                this.processServiceMethod(target, propertyKey, serviceMethod);
+            }
+            else if (serviceMethod.httpMethod !== this.httpMethod) {
+                throw new Error('Method is already annotated with @' +
+                    server_types_1.HttpMethod[serviceMethod.httpMethod] +
+                    '. You can only map a method to one HTTP verb.');
+            }
+        }
+    }
+    /**
+     * Extract metadata for rest methods
+     */
+    processServiceMethod(target, propertyKey, serviceMethod) {
+        serviceMethod.name = propertyKey;
+        const paramTypes = Reflect.getOwnMetadata('design:paramtypes', target, propertyKey);
+        this.registerUndecoratedParameters(paramTypes, serviceMethod);
+        serviceMethod.parameters.forEach((param) => {
+            const processor = MethodDecorator.PROCESSORS.get(param.paramType);
+            if (processor) {
+                processor(serviceMethod, param);
+            }
+        });
+    }
+    registerUndecoratedParameters(paramTypes, serviceMethod) {
+        while (paramTypes && paramTypes.length > serviceMethod.parameters.length) {
+            serviceMethod.parameters.push(new metadata_1.MethodParam(null, paramTypes[serviceMethod.parameters.length], metadata_1.ParamType.body));
+        }
+    }
+}
+MethodDecorator.PROCESSORS = getParameterProcessors();
+function getParameterProcessors() {
+    const result = new Map();
+    result.set(metadata_1.ParamType.cookie, (serviceMethod) => {
+        serviceMethod.mustParseCookies = true;
+    });
+    result.set(metadata_1.ParamType.file, (serviceMethod, param) => {
+        serviceMethod.files.push(new metadata_1.FileParam(param.name, true));
+    });
+    result.set(metadata_1.ParamType.files, (serviceMethod, param) => {
+        serviceMethod.files.push(new metadata_1.FileParam(param.name, false));
+    });
+    result.set(metadata_1.ParamType.param, (serviceMethod) => {
+        serviceMethod.acceptMultiTypedParam = true;
+    });
+    result.set(metadata_1.ParamType.form, (serviceMethod) => {
+        if (serviceMethod.mustParseBody) {
+            throw Error('Can not use form parameters with a body parameter on the same method.');
+        }
+        serviceMethod.mustParseForms = true;
+    });
+    result.set(metadata_1.ParamType.body, (serviceMethod) => {
+        if (serviceMethod.mustParseForms) {
+            throw Error('Can not use form parameters with a body parameter on the same method.');
+        }
+        if (serviceMethod.mustParseBody) {
+            throw Error('Can not use more than one body parameter on the same method.');
+        }
+        serviceMethod.mustParseBody = true;
+    });
+    return result;
+}
+//# sourceMappingURL=methods.js.map

package/dist/decorators/methods.js.map

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

package/dist/decorators/parameters.d.ts

@@ -0,0 +1,295 @@
+import 'reflect-metadata';
+/**
+ * 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.
+ */
+export declare function Context(...args: Array<any>): void;
+/**
+ * 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.
+ */
+export declare function ContextRequest(...args: Array<any>): void;
+/**
+ * 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.
+ */
+export declare function ContextResponse(...args: Array<any>): void;
+/**
+ * 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.
+ */
+export declare function ContextNext(...args: Array<any>): void;
+/**
+ * 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
+ *       // ...
+ * }
+ * ```
+ */
+export declare function ContextLanguage(...args: Array<any>): void;
+/**
+ * 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
+ *       // ...
+ * }
+ * ```
+ */
+export declare function ContextAccept(...args: Array<any>): void;
+/**
+ * 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.
+ */
+export declare function PathParam(name: string): (...args: Array<any>) => void;
+/**
+ * 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.
+ */
+export declare function FileParam(name: string): (...args: Array<any>) => void;
+/**
+ * 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.
+ */
+export declare function FilesParam(name: string): (...args: Array<any>) => void;
+/**
+ * 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.
+ */
+export declare function QueryParam(name: string): (...args: Array<any>) => void;
+/**
+ * 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.
+ */
+export declare function HeaderParam(name: string): (...args: Array<any>) => void;
+/**
+ * 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.
+ */
+export declare function CookieParam(name: string): (...args: Array<any>) => void;
+/**
+ * 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.
+ */
+export declare function FormParam(name: string): (...args: Array<any>) => void;
+/**
+ * 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.
+ */
+export declare function Param(name: string): (...args: Array<any>) => void;