@tsed/common 8.0.0-beta.3 → 8.0.0-beta.5

package/lib/types/services/PlatformRequest.d.ts

@@ -1,111 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-import { IncomingHttpHeaders, IncomingMessage } from "http";
-import type { PlatformContext } from "../domain/PlatformContext.js";
-import type { PlatformResponse } from "./PlatformResponse.js";
-declare global {
-    namespace TsED {
-        interface Request {
-            id: string;
-        }
-    }
-}
-/**
- * Platform Request abstraction layer.
- * @platform
- */
-export declare class PlatformRequest<Req extends {
-    [key: string]: any;
-} = any> {
-    readonly $ctx: PlatformContext;
-    constructor($ctx: PlatformContext);
-    /**
-     * The current @@PlatformResponse@@.
-     */
-    get response(): PlatformResponse;
-    get raw(): Req;
-    get secure(): boolean;
-    get host(): string;
-    get protocol(): string;
-    /**
-     * Get the url of the request.
-     *
-     * Is equivalent of `express.response.originalUrl || express.response.url`.
-     */
-    get url(): string;
-    get headers(): IncomingHttpHeaders;
-    get method(): string;
-    /**
-     * Contains key-value pairs of data submitted in the request body. By default, it is `undefined`, and is populated when you use
-     * `body-parsing` middleware such as `express.json()` or `express.urlencoded()`.
-     */
-    get body(): any;
-    get rawBody(): any;
-    /**
-     * When using `cookie-parser` middleware, this property is an object that contains cookies sent by the request.
-     * If the request contains no cookies, it defaults to `{}`.
-     */
-    get cookies(): {
-        [key: string]: any;
-    };
-    /**
-     * This property is an object containing properties mapped to the named route `parameters`.
-     * For example, if you have the route `/user/:name`, then the `name` property is available as `req.params.name`.
-     * This object defaults to `{}`.
-     */
-    get params(): {
-        [key: string]: any;
-    };
-    /**
-     * This property is an object containing a property for each query string parameter in the route.
-     * When query parser is set to disabled, it is an empty object `{}`, otherwise it is the result of the configured query parser.
-     */
-    get query(): {
-        [key: string]: any;
-    };
-    /**
-     * This property is an object containing a property for each session attributes set by any code.
-     * It requires to install a middleware like express-session to work.
-     */
-    get session(): {
-        [key: string]: any;
-    };
-    get files(): any;
-    get route(): import("@tsed/platform-router").SinglePathType;
-    /**
-     * Return the original request framework instance
-     */
-    get request(): Req;
-    /**
-     * Return the original request node.js instance
-     */
-    get req(): IncomingMessage;
-    /**
-     * Returns the HTTP request header specified by field. The match is case-insensitive.
-     *
-     * ```typescript
-     * request.get('Content-Type') // => "text/plain"
-     * ```
-     *
-     * @param name
-     */
-    get(name: string): any;
-    getHeader(name: string): any;
-    /**
-     * Checks if the specified content types are acceptable, based on the request’s Accept HTTP header field. The method returns the best match, or if none of the specified content types is acceptable, returns false (in which case, the application should respond with 406 "Not Acceptable").
-     *
-     * The type value may be a single MIME type string (such as “application/json”), an extension name such as “json”, a comma-delimited list, or an array. For a list or array, the method returns the best match (if any).
-     *
-     * @param mime
-     */
-    accepts(mime: string): string | false;
-    accepts(mime: string[]): string[] | false;
-    isAborted(): any;
-    /**
-     * Return the Framework response object (express, koa, etc...)
-     */
-    getRequest<R = Req>(): R;
-    /**
-     * Return the Node.js response object
-     */
-    getReq(): IncomingMessage;
-}

package/lib/types/services/PlatformResponse.d.ts

@@ -1,175 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { OutgoingHttpHeaders, ServerResponse } from "http";
-import type { PlatformContext } from "../domain/PlatformContext.js";
-import type { PlatformRequest } from "./PlatformRequest.js";
-declare global {
-    namespace TsED {
-        interface Response {
-        }
-        interface SetCookieOpts extends Record<string, unknown> {
-            maxAge?: number | undefined;
-            signed?: boolean | undefined;
-            expires?: Date | undefined;
-            httpOnly?: boolean | undefined;
-            path?: string | undefined;
-            domain?: string | undefined;
-            secure?: boolean | undefined;
-            encode?: ((val: string) => string) | undefined;
-            sameSite?: boolean | "lax" | "strict" | "none" | undefined;
-        }
-    }
-}
-/**
- * Platform Response abstraction layer.
- * @platform
- */
-export declare class PlatformResponse<Res extends Record<string, any> = any> {
-    readonly $ctx: PlatformContext;
-    data: any;
-    constructor($ctx: PlatformContext);
-    /**
-     * The current @@PlatformRequest@@.
-     */
-    get request(): PlatformRequest;
-    get raw(): Res;
-    /**
-     * Get the current statusCode
-     */
-    get statusCode(): any;
-    /**
-     * An object that contains response local variables scoped to the request, and therefore available only to the view(s) rendered during that request / response cycle (if any). Otherwise, this property is identical to app.locals.
-     *
-     * This property is useful for exposing request-level information such as the request path name, authenticated user, user settings, and so on.
-     */
-    get locals(): any;
-    /**
-     * Return the original response framework instance
-     */
-    get response(): Res;
-    /**
-     * Return the original response node.js instance
-     */
-    get res(): ServerResponse<import("http").IncomingMessage>;
-    /**
-     * Returns the HTTP response header specified by field. The match is case-insensitive.
-     *
-     * ```typescript
-     * response.get('Content-Type') // => "text/plain"
-     * ```
-     *
-     * @param name
-     */
-    get(name: string): any;
-    getHeaders(): OutgoingHttpHeaders;
-    /**
-     * Return the Framework response object (express, koa, etc...)
-     */
-    getResponse<R = Res>(): R;
-    /**
-     * Return the Node.js response object
-     */
-    getRes(): ServerResponse;
-    hasStatus(): boolean;
-    /**
-     * Sets the HTTP status for the response.
-     *
-     * @param status
-     */
-    status(status: number): this;
-    /**
-     * Set header `field` to `val`, or pass
-     * an object of header fields.
-     *
-     * Examples:
-     * ```typescript
-     * response.setHeaders({ Accept: 'text/plain', 'X-API-Key': 'tobi' });
-     * ```
-     *
-     * Aliased as `res.header()`.
-     */
-    setHeaders(headers: OutgoingHttpHeaders): this;
-    setHeader(key: string, item: any): this;
-    /**
-     * Set `Content-Type` response header with `type` through `mime.lookup()`
-     * when it does not contain "/", or set the Content-Type to `type` otherwise.
-     *
-     * Examples:
-     *
-     *     res.type('.html');
-     *     res.type('html');
-     *     res.type('json');
-     *     res.type('application/json');
-     *     res.type('png');
-     */
-    contentType(contentType: string): this;
-    contentLength(length: number): this;
-    getContentLength(): number | undefined;
-    getContentType(): any;
-    /**
-     * Sets the HTTP response Content-Disposition header field to “attachment”.
-     * If a filename is given, then it sets the Content-Type based on the extension name via res.type(), and sets the Content-Disposition “filename=” parameter.
-     *
-     * ```typescript
-     * res.attachment()
-     * // Content-Disposition: attachment
-     *
-     * res.attachment('path/to/logo.png')
-     * // Content-Disposition: attachment; filename="logo.png"
-     * // Content-Type: image/png
-     * ```
-     *
-     * @param filename
-     */
-    attachment(filename: string): this;
-    /**
-     * Redirects to the URL derived from the specified path, with specified status, a positive integer that corresponds to an [HTTP status code](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html).
-     * If not specified, status defaults to `302 Found`.
-     *
-     * @param status
-     * @param url
-     */
-    redirect(status: number, url: string): this;
-    /**
-     * Sets the response Location HTTP header to the specified path parameter.
-     *
-     * @param location
-     */
-    location(location: string): this;
-    /**
-     * Stream the given data.
-     *
-     * @param data
-     */
-    stream(data: any): this;
-    /**
-     * Renders a view and sends the rendered HTML string to the client.
-     *
-     * @param path
-     * @param options
-     */
-    render(path: string, options?: any): Promise<any>;
-    /**
-     * Send any data to your consumer.
-     *
-     * This method accept a ReadableStream, a plain object, boolean, string, number, null and undefined data.
-     * It chooses the better way to send the data.
-     *
-     * @param data
-     */
-    body(data: any): this;
-    getBody(): any;
-    /**
-     * Add a listener to handler the end of the request/response.
-     * @param cb
-     */
-    onEnd(cb: () => Promise<void> | void): this;
-    isDone(): boolean;
-    isHeadersSent(): boolean;
-    cookie(name: string, value: string | null, opts?: TsED.SetCookieOpts): this;
-    protected formatHeader(key: string, item: any): any;
-    protected json(data: any): this;
-    protected buffer(data: any): void;
-    protected end(data?: string | Buffer): void;
-}

package/lib/types/services/PlatformTest.d.ts

@@ -1,61 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-import { Type } from "@tsed/core";
-import { DITest, InjectorService } from "@tsed/di";
-import type { IncomingMessage, RequestListener, ServerResponse } from "http";
-import { PlatformContext, PlatformContextOptions } from "../domain/PlatformContext.js";
-import { PlatformAdapter, PlatformBuilderSettings } from "./PlatformAdapter.js";
-/**
- * @platform
- */
-export declare class PlatformTest extends DITest {
-    static adapter: Type<PlatformAdapter>;
-    static create(settings?: Partial<TsED.Configuration>): Promise<void>;
-    /**
-     * Create a new injector with the right default services
-     */
-    static createInjector(settings?: any): InjectorService;
-    /**
-     * Load the server silently without listening port and configure it on test profile.
-     * @decorator
-     * @param mod
-     * @param listen
-     * @param settings
-     * @returns {Promise<void>}
-     */
-    static bootstrap(mod: any, { listen, ...settings }?: Partial<PlatformBuilderSettings & {
-        listen: boolean;
-    }>): () => Promise<void>;
-    /**
-     * It injects services into the test function where you can alter, spy on, and manipulate them.
-     *
-     * The inject function has two parameters
-     *
-     * * an array of Service dependency injection tokens,
-     * * a test function whose parameters correspond exactly to each item in the injection token array.
-     *
-     * @deprecated use PlatformTest.injector.invoke instead
-     * @param targets
-     * @param func
-     */
-    static inject<T>(targets: any[], func: (...args: any[]) => Promise<T> | T): () => Promise<T>;
-    /**
-     * Return the raw application (express or koa).
-     * Use this callback with SuperTest.
-     *
-     * ```typescript
-     * let request: SuperTest.Agent;
-     * beforeEach(PlatformTest.bootstrap(Server, {
-     *   mount: {
-     *     "/rest": [ProductsController]
-     *   }
-     * }));
-     * beforeEach(() => {
-     *   request = SuperTest(PlatformTest.callback());
-     * });
-     * ```
-     */
-    static callback(): RequestListener<typeof IncomingMessage, typeof ServerResponse>;
-    static createRequest(options?: any): any;
-    static createResponse(options?: any): any;
-    static createRequestContext(options?: Partial<PlatformContextOptions & any>): PlatformContext<import("./PlatformRequest.js").PlatformRequest<any>, import("./PlatformResponse.js").PlatformResponse<any>>;
-}

package/lib/types/utils/closeServer.d.ts

@@ -1,7 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import type Http from "http";
-import type Http2 from "http2";
-import type Https from "https";
-export declare function closeServer(server: Http.Server | Https.Server | Http2.Http2Server): Promise<unknown>;

package/lib/types/utils/createContext.d.ts

@@ -1,10 +0,0 @@
-import { InjectorService } from "@tsed/di";
-import { PlatformContext } from "../domain/PlatformContext.js";
-import { IncomingEvent } from "../interfaces/IncomingEvent.js";
-export declare function buildIgnoreLog(ignoreUrlPatterns: any[] | undefined): ((ignore: boolean, data: any, url: string) => any) | undefined;
-/**
- * Create the TsED context to wrap request, response, injector, etc...
- * @param injector
- * @ignore
- */
-export declare function createContext(injector: InjectorService): (event: IncomingEvent) => PlatformContext;

package/lib/types/utils/createHttpServer.d.ts

@@ -1,4 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-import { InjectorService } from "@tsed/di";
-import Http from "http";
-export declare function createHttpServer(injector: InjectorService, requestListener: Http.RequestListener): import("./createServer.js").CreateServerReturn | undefined;

package/lib/types/utils/createHttpsServer.d.ts

@@ -1,4 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-import { InjectorService } from "@tsed/di";
-import Http from "http";
-export declare function createHttpsServer(injector: InjectorService, requestListener?: Http.RequestListener): import("./createServer.js").CreateServerReturn | undefined;

package/lib/types/utils/createInjector.d.ts

@@ -1,8 +0,0 @@
-import { Type } from "@tsed/core";
-import { PlatformAdapter } from "../services/PlatformAdapter.js";
-interface CreateInjectorOptions {
-    adapter?: Type<PlatformAdapter<any>>;
-    settings?: Partial<TsED.Configuration>;
-}
-export declare function createInjector({ adapter, settings }: CreateInjectorOptions): import("@tsed/di").InjectorService;
-export {};

package/lib/types/utils/createServer.d.ts

@@ -1,17 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { ReturnHostInfoFromPort } from "@tsed/core";
-import { InjectorService, TokenProvider } from "@tsed/di";
-import Http from "http";
-import Http2 from "http2";
-import Https from "https";
-export interface CreateServerOptions {
-    token: TokenProvider;
-    type: "http" | "https";
-    port: string | false;
-    listen?: (hostInfo: ReturnHostInfoFromPort) => Promise<any>;
-    server: () => Http.Server | Https.Server | Http2.Http2Server;
-}
-export type CreateServerReturn = () => Promise<Http.Server | Https.Server | Http2.Http2Server>;
-export declare function createServer(injector: InjectorService, { token, type, port, server: get, listen }: CreateServerOptions): undefined | CreateServerReturn;

package/lib/types/utils/ensureContext.d.ts

@@ -1,2 +0,0 @@
-import { PlatformContext } from "../domain/PlatformContext.js";
-export declare function ensureContext(request: any, cb: ($ctx: PlatformContext) => any, fallback?: () => void): any;

package/lib/types/utils/getConfiguration.d.ts

@@ -1,2 +0,0 @@
-import { Type } from "@tsed/core";
-export declare function getConfiguration(configuration?: any, module?: Type<any> | null): any;

package/lib/types/utils/getStaticsOptions.d.ts

@@ -1,5 +0,0 @@
-import { PlatformStaticsOptions, PlatformStaticsSettings } from "../config/interfaces/PlatformStaticsSettings.js";
-export declare function getStaticsOptions(statics?: PlatformStaticsSettings): {
-    path: string;
-    options: PlatformStaticsOptions;
-}[];

package/lib/types/utils/listenServer.d.ts

@@ -1,8 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { getHostInfoFromPort } from "@tsed/core";
-import type Http from "http";
-import type Http2 from "http2";
-import type Https from "https";
-export declare function listenServer(server: Http.Server | Https.Server | Http2.Http2Server, hostInfo: ReturnType<typeof getHostInfoFromPort>): Promise<unknown>;

package/lib/types/utils/mapReturnedResponse.d.ts

@@ -1,4 +0,0 @@
-/**
- * @ignore
- */
-export declare function mapReturnedResponse({ use, collection, ...options }: any): any;

package/lib/types/utils/printRoutes.d.ts

@@ -1,2 +0,0 @@
-import { PlatformRouteDetails } from "../domain/PlatformRouteDetails.js";
-export declare function printRoutes(routes: PlatformRouteDetails[]): string;

package/lib/types/utils/registerPlatformAdapter.d.ts

@@ -1,3 +0,0 @@
-import { Type } from "@tsed/core";
-import { PlatformAdapter } from "../services/PlatformAdapter.js";
-export declare function registerPlatformAdapter(adapter: Type<PlatformAdapter<any>>): void;

package/lib/types/utils/setResponseHeaders.d.ts

@@ -1,5 +0,0 @@
-import { PlatformContext } from "../domain/PlatformContext.js";
-/**
- * @ignore
- */
-export declare function setResponseHeaders(ctx: PlatformContext): void;