New e2e function, TestValidator.search()

[samchon]

Make a validation function for search option provided APIs.

export namespace TestValidator {
    /**
     * Valiate search options.
     *
     * Test a pagination API supporting search options.
     *
     * @param title Title of error message when searching is invalid
     * @returns Currying function
     *
     * @example https://github.com/samchon/nestia-template/blob/master/src/test/features/api/bbs/test_api_bbs_article_index_search.ts
     */
    export const search =
        (title: string) =>
        /**
         * @param getter A pagination API function to be called
         */
        <Entity extends IEntity<any>, Request>(
            getter: (input: Request) => Promise<Entity[]>,
        ) =>
        /**
         * @param total Total entity records for comparison
         * @param sampleCount Sampling count. Default is 1
         */
        (total: Entity[], sampleCount: number = 1) =>
        /**
         * @param props Search properties
         */
        async <Values extends any[]>(
            props: ISearchProps<Entity, Values, Request>,
        ): Promise<void>;

    export interface ISearchProps<
        Entity extends IEntity<any>,
        Values extends any[],
        Request,
    > {
        fields: string[];
        values(entity: Entity): Values;
        filter(entity: Entity, values: Values): boolean;
        request(values: Values): Request;
    }
}