@spinajs/http 2.0.179 → 2.0.181

package/lib/mjs/interfaces.d.ts

@@ -1,551 +1,570 @@
-import * as express from 'express';
-import { Constructor, AsyncService } from '@spinajs/di';
-import { fs } from '@spinajs/fs';
-/**
- * Accept header enum
- */
-export declare enum HttpAcceptHeaders {
-    /**
-     * Accept header for JSON
-     */
-    JSON = 1,
-    /**
-     * Accept header for HTML
-     */
-    HTML = 2,
-    /**
-     * Accept header for XML
-     */
-    XML = 4,
-    /**
-     * Plain text
-     */
-    TEXT = 8,
-    /**
-     * Image response
-     */
-    IMAGE = 16,
-    PDF = 32,
-    /**
-     * Accept other request type ( let server decide )
-     */
-    OTHER = 64,
-    /**
-     * Accept all accept headers shorcut
-     */
-    ALL = 7
-}
-/**
- * Config options for static files
- */
-export interface IHttpStaticFileConfiguration {
-    /**
-     * virtual prefix in url eg. http://localhost:3000/static/images/kitten.jpg
-     */
-    Route: string;
-    /**
-     * full path to folder with static content
-     */
-    Path: string;
-}
-/**
- * Uploaded file fields
- */
-export interface IUploadedFile {
-    /**
-     * File size in bytes
-     */
-    Size: number;
-    /**
-     * Original file name
-     */
-    Name: string;
-    /**
-     * Filename without path
-     */
-    BaseName: string;
-    /**
-     * Mime type of file
-     */
-    Type: string;
-    LastModifiedDate?: Date;
-    Hash?: string;
-    /**
-     * File system provider used to store this file eg. could be local, or aws s3 etc
-     */
-    Provider: fs;
-}
-export interface Request extends express.Request {
-    storage: IActionLocalStoregeContext;
-}
-export interface IActionLocalStoregeContext {
-    requestId: string;
-    responseStart: Date;
-    responseEnd: Date;
-    responseTime: number;
-    realIp: string;
-}
-export declare abstract class ServerMiddleware extends AsyncService {
-    Order: number;
-    abstract before(): (req: Request, res: express.Response, next: express.NextFunction) => void | null;
-    abstract after(): (req: Request, res: express.Response, next: express.NextFunction) => void | null;
-}
-/**
- * HTTP response statuses
- */
-export declare enum HTTP_STATUS_CODE {
-    /**
-     * All ok with content
-     */
-    OK = 200,
-    /**
-     * Request is OK and new resource has been created.
-     */
-    CREATED = 201,
-    /**
-     * Request is accepted, but has not been completed yet.
-     */
-    ACCEPTED = 202,
-    /**
-     * ALl is ok & no content to return
-     */
-    NO_CONTENT = 204,
-    /**
-     * The server is delivering only part of the resource (byte serving) due to a range header
-     * sent by the client. The range header is used by HTTP clients to enable resuming of
-     * interrupted downloads, or split a download into multiple simultaneous streams.
-     */
-    PARTIAL_CONTENT = 206,
-    /**
-     * Resource is not modified
-     */
-    NOT_MODIFIED = 304,
-    /**
-     * Invalid request, eg. invalid parameters
-     */
-    BAD_REQUEST = 400,
-    /**
-     * Auth required
-     */
-    UNAUTHORIZED = 401,
-    /**
-     * No permission
-     */
-    FORBIDDEN = 403,
-    /**
-     * Resource not found
-     */
-    NOT_FOUND = 404,
-    /**
-     * Not acceptable request headers (Accept header)
-     */
-    NOT_ACCEPTABLE = 406,
-    /**
-     * Method not allowed eg. DELETE not allowed on resource, or login second time
-     */
-    NOT_ALLOWED = 405,
-    /**
-     * Conflict
-     */
-    CONFLICT = 409,
-    /**
-     * Internal server error.
-     */
-    INTERNAL_ERROR = 500,
-    /**
-     * Method not implemented
-     */
-    NOT_IMPLEMENTED = 501
-}
-/**
- * Avaible route types, match HTTP methods
- */
-export declare enum RouteType {
-    /**
-     * POST method - used to create new resource or send data to server
-     */
-    POST = "post",
-    /**
-     * GET method - used to retrieve data from server
-     */
-    GET = "get",
-    /**
-     * PUT method - used to updates resource
-     */
-    PUT = "put",
-    /**
-     * DELETE method - used to delete resource
-     */
-    DELETE = "delete",
-    /**
-     * PATCH method - used to partially update resource eg. one field
-     */
-    PATCH = "patch",
-    /**
-     * HEAD method - same as get, but returns no data. usefull for checking if resource exists etc.
-     */
-    HEAD = "head",
-    /**
-     * FILE method - spine special route type. Internall its simple GET method, but informs that specified route returns binary file
-     */
-    FILE = "file",
-    UNKNOWN = "unknown"
-}
-export declare enum UuidVersion {
-    v1 = 0,
-    v3 = 1,
-    v4 = 2,
-    v5 = 3
-}
-/**
- * Avaible route parameters type
- */
-export declare enum ParameterType {
-    /**
-     * Standard request whole fields
-     */
-    BodyField = "BodyFieldRouteArgs",
-    QueryField = "QueryFieldRouteArgs",
-    ParamField = "ParamFieldRouteArgs",
-    Headers = "HeadersFieldRouteArgs",
-    /**
-     * Request type from request header
-     */
-    RequestType = "RequestTypeRouteArgs",
-    /**
-     * Parameter is injected from DI container & resolved
-     */
-    FromDi = "FromDi",
-    /**
-     * Parameter value is taken from query string eg. `?name=flavio`
-     */
-    FromQuery = "FromQuery",
-    /**
-     * From message body, eg. POST json object
-     */
-    FromBody = "FromBody",
-    /**
-     * From url params eg: `/:id`
-     */
-    FromParams = "FromParams",
-    /**
-     * From form file field
-     */
-    FromFile = "FromFile",
-    /**
-     * From form
-     */
-    FromForm = "FromForm",
-    /**
-     * From cvs file
-     */
-    FromCSV = "FromCSV",
-    /**
-     * From JSON file
-     */
-    FromJSONFile = "FromJSONFile",
-    /**
-     * From form field
-     */
-    FormField = "FromFormField",
-    /**
-     * From model object
-     */
-    FromModel = "FromModel",
-    /**
-     * Data from coockie
-     */
-    FromCookie = "FromCookie",
-    /**
-     * From http header
-     */
-    FromHeader = "FromHeader",
-    /**
-     * Req from express
-     */
-    Req = "ArgAsRequest",
-    Res = "ArgAsResponse",
-    /**
-     * Other custom arguments
-     */
-    Other = "Other"
-}
-export interface IFormOptions {
-    multiples: boolean;
-}
-export interface IFormOptions {
-    /**
-     * default 1000; limit the number of fields that the Querystring parser will decode, set 0 for unlimited
-     */
-    maxFields?: number;
-    /**
-     *  default 20 * 1024 * 1024 (20mb); limit the amount of memory all fields together (except files) can allocate in bytes.
-     */
-    maxFieldsSize?: number;
-    /**
-     * default 'utf-8'; sets encoding for incoming form fields,
-     */
-    encoding?: string;
-}
-export interface IUploadOptions {
-    /**
-     * default false; include checksums calculated for incoming files, set this to some hash algorithm, see crypto.createHash for available algorithms
-     */
-    hash?: false;
-    /**
-     * File provider name used to upload files
-     * Defaults to default provider set in fs.defaultProvider config options
-     */
-    provider?: string;
-    /**
-     * default false; when you call the .parse method, the files argument (of the callback) will contain arrays of files for inputs which submit multiple files using the HTML5 multiple attribute. Also, the fields argument will contain arrays of values for fields that have names ending with '[]'.
-     */
-    multiples?: boolean;
-    enabledPlugins?: string[];
-    /**
-     *  default 200 * 1024 * 1024 (200mb); limit the size of uploaded file.
-     */
-    maxFileSize?: number;
-    /**
-     * default false; to include the extensions of the original files or not
-     */
-    keepExtensions?: boolean;
-    /**
-     * Should obtain fileInfo when uploading ?
-     */
-    fileInfo?: boolean;
-}
-/**
- * Describes parameters passed to route.
- */
-export interface IRouteParameter<T = any> {
-    /**
-     * Parameter index in function args
-     */
-    Index: number;
-    /**
-     * Is value taken from query string, url params or message body
-     */
-    Type: ParameterType | string;
-    /**
-     * Schema for validation parameter ( raw value eg. to check if matches string / number constrain)
-     */
-    RouteParamSchema?: any;
-    /**
-     * Schema for paramater
-     */
-    Schema?: any;
-    /**
-     * Additional options
-     */
-    Options?: T;
-    /**
-     * Parameter runtime type eg. number or class
-     */
-    RuntimeType: any;
-    /**
-     * Name of parameter eg. `id`
-     */
-    Name: string;
-}
-/**
- * Route action call spefici data. Used to pass data / arguments when parsing
- * action parameters for specific call. Eg. to parse form data, and extract it
- * as different arguments.
- */
-export interface IRouteCall {
-    Payload: any;
-}
-export interface ICookieOptions {
-    maxAge?: number | undefined;
-    signed?: boolean | undefined;
-    expires?: Date | undefined;
-    httpOnly?: boolean | undefined;
-    path?: string | undefined;
-    domain?: string | undefined;
-    secure?: boolean | undefined;
-    sameSite?: boolean | 'lax' | 'strict' | 'none' | undefined;
-}
-export interface IRoute {
-    /**
-     * url path eg. /foo/bar/:id
-     */
-    Path: string;
-    /**
-     * HTTP request method, used internally. Not visible to others.
-     */
-    InternalType: RouteType;
-    /**
-     * SPINAJS API method type, mostly same as HTTP type, but can be non standard type eg. FILE
-     * This type is visible outside in api discovery.
-     */
-    Type: RouteType;
-    /**
-     * Method name assigned to this route eg. `findUsers`
-     */
-    Method: string;
-    /**
-     * Custom route parameters taken from query string or message body
-     */
-    Parameters: Map<number, IRouteParameter>;
-    /**
-     * Assigned middlewares to route
-     */
-    Middlewares: IMiddlewareDescriptor[];
-    /**
-     * Assigned policies to route
-     */
-    Policies: IPolicyDescriptor[];
-    /**
-     * Additional route options eg. file size etc.
-     */
-    Options: any;
-    Schema: any;
-}
-export interface IMiddlewareDescriptor {
-    Type: Constructor<RouteMiddleware>;
-    Options: any[];
-}
-export interface IController {
-    /**
-     * Express router with middleware stack
-     */
-    Router: express.Router;
-    /**
-     * Controller descriptor
-     */
-    Descriptor: IControllerDescriptor;
-    /**
-     * Base path for all controller routes eg. my/custom/path/
-     *
-     * It can be defined via `@BasePath` decorator, defaults to controller name without `Controller` part.
-     */
-    BasePath: string;
-}
-/**
- * Middlewares are classes that can change request object or perform specific task before & after route execution
- * eg. route parameter logging / headers check etc.
- */
-export declare abstract class RouteMiddleware {
-    /**
-     * Inform, if middleware is enabled for given action
-     */
-    abstract isEnabled(route: IRoute, controller: IController): boolean;
-    /**
-     * Called before action in middleware stack eg. to modify req or resp objects.
-     * Its express middleware func
-     */
-    abstract onBefore(req: express.Request, res: express.Response, route: IRoute, controller: IController): Promise<void>;
-    /**
-     * Called after action response, is framework middleware
-     * Used to modify response returned by actions in controller
-     * eg. filter out data
-     *
-     */
-    abstract onResponse(response: Response, route: IRoute, controller: IController): Promise<void>;
-    /**
-     * Called after action in middleware stack eg. to modify express response.
-     * Its express middleware func
-     */
-    abstract onAfter(req: express.Request, res: express.Response, route: IRoute, controller: IController): Promise<void>;
-}
-/**
- * Descriptor for policies eg. attached routes, passed options eg. token etc.
- */
-export interface IPolicyDescriptor {
-    Type: Constructor<BasePolicy> | string;
-    Options: any[];
-}
-export type ResponseFunction = (req: express.Request, res: express.Response) => void;
-export declare abstract class Response {
-    protected responseData: any;
-    constructor(responseData: any);
-    abstract execute(req: express.Request, res: express.Response, next?: express.NextFunction): Promise<ResponseFunction | void>;
-}
-/**
- * Base class for policies.
- *
- * Policies checks if route can be executed eg. user have proper role
- */
-export declare abstract class BasePolicy {
-    /**
-     * Checks if policy is enabled for given action & controlle eg. user session exists
-     *
-     * @param action action that is executed ( route info )
-     * @param instance controller instance
-     */
-    abstract isEnabled(action: IRoute, instance: IController): boolean;
-    /**
-     *
-     * Executes policy, when throws exception - route is not executed
-     *
-     * @param req express request object
-     */
-    abstract execute(req: Request, action: IRoute, instance: IController): Promise<void>;
-}
-/**
- * Descriptor for controller
- */
-export interface IControllerDescriptor {
-    /**
-     * Controller routes
-     */
-    Routes: Map<string | symbol, IRoute>;
-    /**
-     * Controller - wise middlewares
-     */
-    Middlewares: IMiddlewareDescriptor[];
-    /**
-     * Controller - wise policies
-     */
-    Policies: IPolicyDescriptor[];
-    /**
-     * Base url path for controller ( added for all child url's)
-     */
-    BasePath: string;
-}
-/**
- * Base class for data transformers.
- *
- * Data formatter helps transforms data for desired format.
- * Eg. we have API function that returns some data, but we want
- * to easily transform data for some client
- * eg. plain array to format that datatables.net can easily read
- */
-export declare abstract class DataTransformer<T = any, U = any> {
-    /**
-     * Transforms data from one format to another
-     *
-     * @param data - input data
-     */
-    abstract transform(data: T, request: express.Request): U;
-    abstract get Type(): string;
-}
-export type RouteCallback = (req: express.Request, res: express.Response, next: express.NextFunction) => (req: express.Request, res: express.Response) => void;
-export interface IFileResponseOptions {
-    /**
-     * Path to file
-     */
-    path: string;
-    /**
-     * File system provider, default is local
-     */
-    provider?: string;
-    /**
-     * File name ( for browser )
-     */
-    filename: string;
-    /**
-     * If not provided, it will be guessed
-     */
-    mimeType?: string;
-    /**
-     * Should delete file after downloaded eg. generated temp file
-     */
-    deleteAfterDownload?: boolean;
-}
-export interface ITemplateResponseOptions {
-    template: string;
-    provider?: string;
-}
+import * as express from 'express';
+import { Constructor, AsyncService } from '@spinajs/di';
+import { fs } from '@spinajs/fs';
+import formidable from 'formidable';
+/**
+ * Accept header enum
+ */
+export declare enum HttpAcceptHeaders {
+    /**
+     * Accept header for JSON
+     */
+    JSON = 1,
+    /**
+     * Accept header for HTML
+     */
+    HTML = 2,
+    /**
+     * Accept header for XML
+     */
+    XML = 4,
+    /**
+     * Plain text
+     */
+    TEXT = 8,
+    /**
+     * Image response
+     */
+    IMAGE = 16,
+    PDF = 32,
+    /**
+     * Accept other request type ( let server decide )
+     */
+    OTHER = 64,
+    /**
+     * Accept all accept headers shorcut
+     */
+    ALL = 7
+}
+/**
+ * Config options for static files
+ */
+export interface IHttpStaticFileConfiguration {
+    /**
+     * virtual prefix in url eg. http://localhost:3000/static/images/kitten.jpg
+     */
+    Route: string;
+    /**
+     * full path to folder with static content
+     */
+    Path: string;
+}
+/**
+ * Uploaded file fields
+ */
+export interface IUploadedFile {
+    /**
+     * File size in bytes
+     */
+    Size: number;
+    /**
+     * Original file name
+     */
+    Name: string;
+    /**
+     * Filename without path
+     */
+    BaseName: string;
+    /**
+     * Mime type of file
+     */
+    Type: string;
+    LastModifiedDate?: Date;
+    Hash?: string;
+    /**
+     * File system provider used to store this file eg. could be local, or aws s3 etc
+     */
+    Provider: fs;
+}
+export interface Request extends express.Request {
+    storage: IActionLocalStoregeContext;
+}
+/**
+ * File upload provider, used to copy incoming formidable
+ * file to desired location eg. local, aws s3 etc.
+ */
+export declare abstract class FormFileUploader {
+    abstract upload(file: formidable.File, dst: string): Promise<IUploadedFile>;
+}
+export interface IActionLocalStoregeContext {
+    requestId: string;
+    responseStart: Date;
+    responseEnd: Date;
+    responseTime: number;
+    realIp: string;
+}
+export declare abstract class ServerMiddleware extends AsyncService {
+    Order: number;
+    abstract before(): (req: Request, res: express.Response, next: express.NextFunction) => void | null;
+    abstract after(): (req: Request, res: express.Response, next: express.NextFunction) => void | null;
+}
+/**
+ * HTTP response statuses
+ */
+export declare enum HTTP_STATUS_CODE {
+    /**
+     * All ok with content
+     */
+    OK = 200,
+    /**
+     * Request is OK and new resource has been created.
+     */
+    CREATED = 201,
+    /**
+     * Request is accepted, but has not been completed yet.
+     */
+    ACCEPTED = 202,
+    /**
+     * ALl is ok & no content to return
+     */
+    NO_CONTENT = 204,
+    /**
+     * The server is delivering only part of the resource (byte serving) due to a range header
+     * sent by the client. The range header is used by HTTP clients to enable resuming of
+     * interrupted downloads, or split a download into multiple simultaneous streams.
+     */
+    PARTIAL_CONTENT = 206,
+    /**
+     * Resource is not modified
+     */
+    NOT_MODIFIED = 304,
+    /**
+     * Invalid request, eg. invalid parameters
+     */
+    BAD_REQUEST = 400,
+    /**
+     * Auth required
+     */
+    UNAUTHORIZED = 401,
+    /**
+     * No permission
+     */
+    FORBIDDEN = 403,
+    /**
+     * Resource not found
+     */
+    NOT_FOUND = 404,
+    /**
+     * Not acceptable request headers (Accept header)
+     */
+    NOT_ACCEPTABLE = 406,
+    /**
+     * Method not allowed eg. DELETE not allowed on resource, or login second time
+     */
+    NOT_ALLOWED = 405,
+    /**
+     * Conflict
+     */
+    CONFLICT = 409,
+    /**
+     * Internal server error.
+     */
+    INTERNAL_ERROR = 500,
+    /**
+     * Method not implemented
+     */
+    NOT_IMPLEMENTED = 501
+}
+/**
+ * Avaible route types, match HTTP methods
+ */
+export declare enum RouteType {
+    /**
+     * POST method - used to create new resource or send data to server
+     */
+    POST = "post",
+    /**
+     * GET method - used to retrieve data from server
+     */
+    GET = "get",
+    /**
+     * PUT method - used to updates resource
+     */
+    PUT = "put",
+    /**
+     * DELETE method - used to delete resource
+     */
+    DELETE = "delete",
+    /**
+     * PATCH method - used to partially update resource eg. one field
+     */
+    PATCH = "patch",
+    /**
+     * HEAD method - same as get, but returns no data. usefull for checking if resource exists etc.
+     */
+    HEAD = "head",
+    /**
+     * FILE method - spine special route type. Internall its simple GET method, but informs that specified route returns binary file
+     */
+    FILE = "file",
+    UNKNOWN = "unknown"
+}
+export declare enum UuidVersion {
+    v1 = 0,
+    v3 = 1,
+    v4 = 2,
+    v5 = 3
+}
+/**
+ * Avaible route parameters type
+ */
+export declare enum ParameterType {
+    /**
+     * Standard request whole fields
+     */
+    BodyField = "BodyFieldRouteArgs",
+    QueryField = "QueryFieldRouteArgs",
+    ParamField = "ParamFieldRouteArgs",
+    Headers = "HeadersFieldRouteArgs",
+    /**
+     * Request type from request header
+     */
+    RequestType = "RequestTypeRouteArgs",
+    /**
+     * Parameter is injected from DI container & resolved
+     */
+    FromDi = "FromDi",
+    /**
+     * Parameter value is taken from query string eg. `?name=flavio`
+     */
+    FromQuery = "FromQuery",
+    /**
+     * From message body, eg. POST json object
+     */
+    FromBody = "FromBody",
+    /**
+     * From url params eg: `/:id`
+     */
+    FromParams = "FromParams",
+    /**
+     * From form file field
+     */
+    FromFile = "FromFile",
+    /**
+     * From form
+     */
+    FromForm = "FromForm",
+    /**
+     * From cvs file
+     */
+    FromCSV = "FromCSV",
+    /**
+     * From JSON file
+     */
+    FromJSONFile = "FromJSONFile",
+    /**
+     * From form field
+     */
+    FormField = "FromFormField",
+    /**
+     * From model object
+     */
+    FromModel = "FromModel",
+    /**
+     * Data from coockie
+     */
+    FromCookie = "FromCookie",
+    /**
+     * From http header
+     */
+    FromHeader = "FromHeader",
+    /**
+     * Req from express
+     */
+    Req = "ArgAsRequest",
+    Res = "ArgAsResponse",
+    /**
+     * Other custom arguments
+     */
+    Other = "Other"
+}
+export interface IFormOptions {
+    multiples: boolean;
+}
+export interface IFormOptions {
+    /**
+     * default 1000; limit the number of fields that the Querystring parser will decode, set 0 for unlimited
+     */
+    maxFields?: number;
+    /**
+     *  default 20 * 1024 * 1024 (20mb); limit the amount of memory all fields together (except files) can allocate in bytes.
+     */
+    maxFieldsSize?: number;
+    /**
+     * default 'utf-8'; sets encoding for incoming form fields,
+     */
+    encoding?: string;
+}
+export interface IUploadOptions {
+    /**
+     * default false; include checksums calculated for incoming files, set this to some hash algorithm, see crypto.createHash for available algorithms
+     */
+    hash?: false;
+    /**
+     * File provider name used to upload files
+     * Defaults to default provider set is copy immediately to fs
+     *
+     * Set this for eg. if lazy copying is needed eg. to aws s3 to not stall main thread
+     */
+    uploader?: string;
+    /**
+     * File system provider used to upload files. Default is taken from configuration
+     * DefaultFsProvider
+     */
+    uploaderFs?: string;
+    /**
+     * default false; when you call the .parse method, the files argument (of the callback) will contain arrays of files for inputs which submit multiple files using the HTML5 multiple attribute. Also, the fields argument will contain arrays of values for fields that have names ending with '[]'.
+     */
+    multiples?: boolean;
+    enabledPlugins?: string[];
+    /**
+     *  default 200 * 1024 * 1024 (200mb); limit the size of uploaded file.
+     */
+    maxFileSize?: number;
+    /**
+     * default false; to include the extensions of the original files or not
+     */
+    keepExtensions?: boolean;
+    /**
+     * Should obtain fileInfo when uploading ?
+     */
+    fileInfo?: boolean;
+    /**
+     * Is this file / files required ?
+     */
+    required?: boolean;
+}
+/**
+ * Describes parameters passed to route.
+ */
+export interface IRouteParameter<T = any> {
+    /**
+     * Parameter index in function args
+     */
+    Index: number;
+    /**
+     * Is value taken from query string, url params or message body
+     */
+    Type: ParameterType | string;
+    /**
+     * Schema for validation parameter ( raw value eg. to check if matches string / number constrain)
+     */
+    RouteParamSchema?: any;
+    /**
+     * Schema for paramater
+     */
+    Schema?: any;
+    /**
+     * Additional options
+     */
+    Options?: T;
+    /**
+     * Parameter runtime type eg. number or class
+     */
+    RuntimeType: any;
+    /**
+     * Name of parameter eg. `id`
+     */
+    Name: string;
+}
+/**
+ * Route action call spefici data. Used to pass data / arguments when parsing
+ * action parameters for specific call. Eg. to parse form data, and extract it
+ * as different arguments.
+ */
+export interface IRouteCall {
+    Payload: any;
+}
+export interface ICookieOptions {
+    maxAge?: number | undefined;
+    signed?: boolean | undefined;
+    expires?: Date | undefined;
+    httpOnly?: boolean | undefined;
+    path?: string | undefined;
+    domain?: string | undefined;
+    secure?: boolean | undefined;
+    sameSite?: boolean | 'lax' | 'strict' | 'none' | undefined;
+}
+export interface IRoute {
+    /**
+     * url path eg. /foo/bar/:id
+     */
+    Path: string;
+    /**
+     * HTTP request method, used internally. Not visible to others.
+     */
+    InternalType: RouteType;
+    /**
+     * SPINAJS API method type, mostly same as HTTP type, but can be non standard type eg. FILE
+     * This type is visible outside in api discovery.
+     */
+    Type: RouteType;
+    /**
+     * Method name assigned to this route eg. `findUsers`
+     */
+    Method: string;
+    /**
+     * Custom route parameters taken from query string or message body
+     */
+    Parameters: Map<number, IRouteParameter>;
+    /**
+     * Assigned middlewares to route
+     */
+    Middlewares: IMiddlewareDescriptor[];
+    /**
+     * Assigned policies to route
+     */
+    Policies: IPolicyDescriptor[];
+    /**
+     * Additional route options eg. file size etc.
+     */
+    Options: any;
+    Schema: any;
+}
+export interface IMiddlewareDescriptor {
+    Type: Constructor<RouteMiddleware>;
+    Options: any[];
+}
+export interface IController {
+    /**
+     * Express router with middleware stack
+     */
+    Router: express.Router;
+    /**
+     * Controller descriptor
+     */
+    Descriptor: IControllerDescriptor;
+    /**
+     * Base path for all controller routes eg. my/custom/path/
+     *
+     * It can be defined via `@BasePath` decorator, defaults to controller name without `Controller` part.
+     */
+    BasePath: string;
+}
+/**
+ * Middlewares are classes that can change request object or perform specific task before & after route execution
+ * eg. route parameter logging / headers check etc.
+ */
+export declare abstract class RouteMiddleware {
+    /**
+     * Inform, if middleware is enabled for given action
+     */
+    abstract isEnabled(route: IRoute, controller: IController): boolean;
+    /**
+     * Called before action in middleware stack eg. to modify req or resp objects.
+     * Its express middleware func
+     */
+    abstract onBefore(req: express.Request, res: express.Response, route: IRoute, controller: IController): Promise<void>;
+    /**
+     * Called after action response, is framework middleware
+     * Used to modify response returned by actions in controller
+     * eg. filter out data
+     *
+     */
+    abstract onResponse(response: Response, route: IRoute, controller: IController): Promise<void>;
+    /**
+     * Called after action in middleware stack eg. to modify express response.
+     * Its express middleware func
+     */
+    abstract onAfter(req: express.Request, res: express.Response, route: IRoute, controller: IController): Promise<void>;
+}
+/**
+ * Descriptor for policies eg. attached routes, passed options eg. token etc.
+ */
+export interface IPolicyDescriptor {
+    Type: Constructor<BasePolicy> | string;
+    Options: any[];
+}
+export type ResponseFunction = (req: express.Request, res: express.Response) => void;
+export declare abstract class Response {
+    protected responseData: any;
+    constructor(responseData: any);
+    abstract execute(req: express.Request, res: express.Response, next?: express.NextFunction): Promise<ResponseFunction | void>;
+}
+/**
+ * Base class for policies.
+ *
+ * Policies checks if route can be executed eg. user have proper role
+ */
+export declare abstract class BasePolicy {
+    /**
+     * Checks if policy is enabled for given action & controlle eg. user session exists
+     *
+     * @param action action that is executed ( route info )
+     * @param instance controller instance
+     */
+    abstract isEnabled(action: IRoute, instance: IController): boolean;
+    /**
+     *
+     * Executes policy, when throws exception - route is not executed
+     *
+     * @param req express request object
+     */
+    abstract execute(req: Request, action: IRoute, instance: IController): Promise<void>;
+}
+/**
+ * Descriptor for controller
+ */
+export interface IControllerDescriptor {
+    /**
+     * Controller routes
+     */
+    Routes: Map<string | symbol, IRoute>;
+    /**
+     * Controller - wise middlewares
+     */
+    Middlewares: IMiddlewareDescriptor[];
+    /**
+     * Controller - wise policies
+     */
+    Policies: IPolicyDescriptor[];
+    /**
+     * Base url path for controller ( added for all child url's)
+     */
+    BasePath: string;
+}
+/**
+ * Base class for data transformers.
+ *
+ * Data formatter helps transforms data for desired format.
+ * Eg. we have API function that returns some data, but we want
+ * to easily transform data for some client
+ * eg. plain array to format that datatables.net can easily read
+ */
+export declare abstract class DataTransformer<T = any, U = any> {
+    /**
+     * Transforms data from one format to another
+     *
+     * @param data - input data
+     */
+    abstract transform(data: T, request: express.Request): U;
+    abstract get Type(): string;
+}
+export type RouteCallback = (req: express.Request, res: express.Response, next: express.NextFunction) => (req: express.Request, res: express.Response) => void;
+export interface IFileResponseOptions {
+    /**
+     * Path to file
+     */
+    path: string;
+    /**
+     * File system provider, default is local
+     */
+    provider?: string;
+    /**
+     * File name ( for browser )
+     */
+    filename: string;
+    /**
+     * If not provided, it will be guessed
+     */
+    mimeType?: string;
+    /**
+     * Should delete file after downloaded eg. generated temp file
+     */
+    deleteAfterDownload?: boolean;
+}
+export interface ITemplateResponseOptions {
+    template: string;
+    provider?: string;
+}
 //# sourceMappingURL=interfaces.d.ts.map