import _ from "lodash"; import CONSTRAINTS from "../validation/constraints"; import ErrorTypes from "../utils/errorTypes"; import Logger from "../logger"; import {Constraints, forConstraints, isConstraints} from "../validation/validator"; import {Request, Response} from "express"; import { EnumTypeGuard, EnumValue, type GenericSortField, isJSONObject, isNumber, isString, isUndefined, JSONObject, JSONValue, SortDirection, TypeGuard } from "../types"; export type RequestData = JSONObject; export type RequestHandler = (request: Request, response: Response) => void; export type Entity = { [key: string]: any }; export type RestParams = { q?: string; _sortField?: GenericSortField; _sortDir?: SortDirection; _page: number; _perPage: number; filters?: FilterClause; }; export type OrderByClause = { query: string, params: any[] }; export type LimitOffsetClause = { query: string, params: any[] }; export type FilterClause = { query: string, params: any[] }; function respond(res: Response, httpCode: number, data: string, type: "html"): void; function respond(res: Response, httpCode: number, data: JSONValue, type: "json"): void; function respond(res: Response, httpCode: number, data: JSONValue, type: "html" | "json"): void { switch (type) { case 'html': res.writeHead(httpCode, {'Content-Type': 'text/html'}); res.end(data); break; default: res.writeHead(httpCode, {'Content-Type': 'application/json'}); res.end(JSON.stringify(data)); break; } } function orderByClause( restParams: RestParams, defaultSortField: EnumValue, isSortField: EnumTypeGuard, ): OrderByClause { let sortField: EnumValue | undefined = isSortField(restParams._sortField) ? restParams._sortField : undefined; if (!sortField) { sortField = defaultSortField; } return { query: 'ORDER BY LOWER(' + sortField + ') ' + (restParams._sortDir === SortDirection.ASCENDING ? 'ASC' : 'DESC'), params: [] }; } function limitOffsetClause(restParams: RestParams): LimitOffsetClause { const page = restParams._page; const perPage = restParams._perPage; return { query: 'LIMIT ? OFFSET ?', params: [perPage, ((page - 1) * perPage)] }; } function escapeForLikePattern(str: string): string { return str .replace(/\\/g, '\\\\') .replace(/%/g, '\\%') .replace(/_/g, '\\_'); } function filterCondition(restParams: RestParams, filterFields: string[]): FilterClause { if (_.isEmpty(filterFields)) { return { query: '1 = 1', params: [] }; } let query = filterFields .map(field => 'LOWER(' + field + ') LIKE ?') .join(' OR '); query += ' ESCAPE \'\\\''; const search = '%' + (isString(restParams.q) ? escapeForLikePattern(restParams.q.trim().toLowerCase()) : '') + '%'; const params = _.times(filterFields.length, () => search); return { query: query, params: params }; } function getConstrainedValues(data: { [key: string]: any }, constraints: Constraints): { [key: string]: any } { const values: { [key: string]: any } = {}; for (const key of Object.keys(constraints)) { const value = data[key]; values[key] = isUndefined(value) && key in constraints && !isUndefined(constraints[key].default) ? constraints[key].default : value; } return values; } function normalize(data: any): JSONObject { return isJSONObject(data) ? data : {}; } export function getData(req: Request): RequestData { const body = normalize(req.body); const params = normalize(req.params); const query = normalize(req.query); return { ...body, ...params, ...query, }; } export async function getValidRestParams( type: string, subtype: string | null, req: Request, ): Promise { const restConstraints = CONSTRAINTS.rest as { [key: string]: any }; let constraints: Constraints; if (!(type in restConstraints) || !isConstraints(restConstraints[type])) { Logger.tag('validation', 'rest').error('Unknown REST resource type: {}', type); throw {data: 'Internal error.', type: ErrorTypes.internalError}; } constraints = restConstraints[type]; let filterConstraints: Constraints = {}; if (subtype) { const subtypeFilters = subtype + 'Filters'; const constraintsObj = CONSTRAINTS as { [key: string]: any }; if (!(subtypeFilters in constraintsObj) || !isConstraints(constraintsObj[subtypeFilters])) { Logger.tag('validation', 'rest').error('Unknown REST resource subtype: {}', subtype); throw {data: 'Internal error.', type: ErrorTypes.internalError}; } filterConstraints = constraintsObj[subtypeFilters]; } const data = getData(req); const restParams = getConstrainedValues(data, constraints); const filterParams = getConstrainedValues(data, filterConstraints); const areValidParams = forConstraints(constraints, false); const areValidFilters = forConstraints(filterConstraints, false); if (!areValidParams(restParams) || !areValidFilters(filterParams)) { throw {data: 'Invalid REST parameters.', type: ErrorTypes.badRequest}; } restParams.filters = filterParams; return restParams as RestParams; } export function filter(entities: E[], allowedFilterFields: string[], restParams: RestParams): E[] { let query = restParams.q; if (query) { query = query.trim().toLowerCase(); } function queryMatches(entity: Entity): boolean { if (!query) { return true; } return allowedFilterFields.some((field: string): boolean => { if (!query) { return true; } let value = entity[field]; if (isNumber(value)) { value = value.toString(); } if (!isString(value) || _.isEmpty(value)) { return false; } value = value.toLowerCase(); if (field === 'mac') { return _.includes(value.replace(/:/g, ''), query.replace(/:/g, '')); } return _.includes(value, query); }); } const filters = restParams.filters; function filtersMatch(entity: Entity): boolean { if (isUndefined(filters) || _.isEmpty(filters)) { return true; } return Object.entries(filters).every(([key, value]) => { if (isUndefined(value)) { return true; } if (key.startsWith('has')) { const entityKey = key.substring(3, 4).toLowerCase() + key.substring(4); return _.isEmpty(entity[entityKey]).toString() !== value; } return entity[key] === value; }); } return entities.filter(entity => queryMatches(entity) && filtersMatch(entity)); } export function sort, S extends string>(entities: T[], isSortField: TypeGuard, restParams: RestParams): T[] { const sortField: S | undefined = isSortField(restParams._sortField) ? restParams._sortField : undefined; if (!sortField) { return entities; } const sorted = entities.slice(0); sorted.sort((a, b) => { let as = a[sortField]; let bs = b[sortField]; if (isString(as)) { as = as.toLowerCase(); } if (isString(bs)) { bs = bs.toLowerCase(); } let order = 0; if (as < bs) { order = -1; } else if (bs > as) { order = 1; } return restParams._sortDir === SortDirection.DESCENDING ? -order : order; }); return sorted; } export function getPageEntities(entities: Entity[], restParams: RestParams): Entity[] { const page = restParams._page; const perPage = restParams._perPage; return entities.slice((page - 1) * perPage, page * perPage); } export {filterCondition as whereCondition}; export function filterClause( restParams: RestParams, defaultSortField: EnumValue, isSortField: EnumTypeGuard, filterFields: string[], ): FilterClause { const orderBy = orderByClause( restParams, defaultSortField, isSortField, ); const limitOffset = limitOffsetClause(restParams); const filter = filterCondition( restParams, filterFields ); return { query: filter.query + ' ' + orderBy.query + ' ' + limitOffset.query, params: [...filter.params, ...orderBy.params, ...limitOffset.params] }; } export function success(res: Response, data: JSONValue) { respond(res, 200, data, 'json'); } export function successHtml(res: Response, html: string) { respond(res, 200, html, 'html'); } export function error(res: Response, err: { data: JSONValue, type: { code: number } }) { respond(res, err.type.code, err.data, 'json'); } export function handleJSON(handler: () => Promise): RequestHandler { return (request, response) => { handler() .then(data => success(response, data || {})) .catch(e => error(response, e)); }; } export function handleJSONWithData(handler: (data: RequestData) => Promise): RequestHandler { return (request, response) => { handler(getData(request)) .then(data => success(response, data || {})) .catch(e => error(response, e)); }; }