@cley_faye/boilerplate 3.21.3 → 4.0.1

package/lib/express/autoclose.js

@@ -1,76 +0,0 @@
-/**
- * @license
- * @preserve
- * MIT License
- *
- * Copyright (c) 2021 Gabriel Paul "Cley Faye" Risterucci
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- *
- */
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setSignalHandler = exports.closeServer = exports.unsetRef = exports.setRef = void 0;
-const serverRefs = [];
-/** Store a server instance for closing it later.
- *
- * @param {Object} ref
- * The server instance
- */
-const setRef = (ref) => {
-    if (serverRefs.includes(ref)) {
-        return;
-    }
-    serverRefs.push(ref);
-};
-exports.setRef = setRef;
-/** Remove a server instance from the closing list.
- *
- * @param {Object} ref
- * The server instance
- */
-const unsetRef = (ref) => {
-    if (!serverRefs.includes(ref)) {
-        return;
-    }
-    serverRefs.splice(serverRefs.indexOf(ref), 1);
-};
-exports.unsetRef = unsetRef;
-/** Close the stored server reference */
-const closeServer = () => {
-    serverRefs.forEach(ref => ref.close());
-    serverRefs.length = 0;
-};
-exports.closeServer = closeServer;
-/** Stop the server on SIGINT */
-const setSignalHandler = () => {
-    if (process.platform === "win32") {
-        process.on("message", msg => {
-            if (msg === "shutdown") {
-                (0, exports.closeServer)();
-            }
-        });
-    }
-    else {
-        process.on("SIGINT", () => {
-            (0, exports.closeServer)();
-        });
-    }
-};
-exports.setSignalHandler = setSignalHandler;

package/lib/express/logger.d.ts

@@ -1,25 +0,0 @@
-import expressWinston, { BaseLoggerOptions } from "express-winston";
-import { Request, Router } from "express";
-import { LogOptions, UserFromReqFunc } from "./pipelinebuilder.js";
-export type LoggerOptions = expressWinston.BaseLoggerOptions | boolean;
-interface ErrorLoggerConfiguration {
-    /** @deprecated Use collapseStacktrace */
-    collapseNodeModules?: boolean;
-    collapseStacktrace?: boolean;
-    extraFilter?: Array<RegExp> | RegExp;
-}
-export type ErrorLoggerOptions = ErrorLoggerConfiguration | boolean;
-export interface LoggingData {
-    extraLoggingData?: Record<string, unknown>;
-}
-export interface RequestWithLoggingData extends Request {
-    _cleyfayeLogging?: LoggingData;
-    _routeWhitelists?: {
-        body?: Array<string>;
-    };
-}
-/** Return the default value for route logger is it is set as `true` */
-export declare const defaultRouteLoggerConfig: (authFromReq?: UserFromReqFunc) => BaseLoggerOptions;
-export declare const registerRouteLogger: (app: Router, logOptions?: LogOptions) => void;
-export declare const registerErrorLogger: (app: Router, logOptions?: LogOptions) => void;
-export {};

package/lib/express/logger.js

@@ -1,132 +0,0 @@
-/**
- * @license
- * @preserve
- * MIT License
- *
- * Copyright (c) 2021 Gabriel Paul "Cley Faye" Risterucci
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- *
- */
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerErrorLogger = exports.registerRouteLogger = exports.defaultRouteLoggerConfig = void 0;
-const winston_1 = __importDefault(require("winston"));
-const express_winston_1 = __importDefault(require("express-winston"));
-const winston_js_1 = require("../winston.js");
-const customRouteFormat = (outputTimestamp) => winston_1.default.format.printf((info) => {
-    const meta = info.meta;
-    // Clean the meta object from stuff displayed in the regular message
-    if (meta.res?.statusCode) {
-        delete meta.res.statusCode;
-    }
-    if (meta.res) {
-        if (Object.keys(meta.res).length === 0) {
-            delete meta.res;
-        }
-    }
-    if ("responseTime" in meta) {
-        delete meta.responseTime;
-    }
-    if (meta.req) {
-        if (Object.keys(meta.req).length === 0) {
-            delete meta.req;
-        }
-    }
-    const metaString = JSON.stringify(info.meta);
-    const finalMessage = `${info.message.toString()} ${metaString === "{}" ? "" : metaString}`;
-    return (0, winston_js_1.prefixOutput)(info.level, finalMessage, outputTimestamp);
-});
-/** Return the default value for route logger is it is set as `true` */
-const defaultRouteLoggerConfig = (authFromReq) => ({
-    meta: true,
-    requestWhitelist: ["body"],
-    responseWhitelist: [],
-    dynamicMeta: (req) => {
-        const castReq = req;
-        const data = { ...castReq._cleyfayeLogging?.extraLoggingData };
-        if (authFromReq) {
-            const value = authFromReq(req);
-            if (!value) {
-                data.auth = null;
-            }
-            else if (typeof value === "string") {
-                data.auth = value;
-            }
-            else {
-                Object.assign(data, value);
-            }
-        }
-        return data;
-    },
-});
-exports.defaultRouteLoggerConfig = defaultRouteLoggerConfig;
-const registerRouteLogger = (app, logOptions) => {
-    const { route, timestamp, userFromReq, authFromReq, ignoredRoutes } = logOptions ?? {};
-    let extraConfig;
-    if (typeof route === "boolean") {
-        extraConfig = (0, exports.defaultRouteLoggerConfig)(authFromReq ?? userFromReq);
-    }
-    else {
-        extraConfig = { ...route };
-        const rec = extraConfig;
-        if (rec.winstonInstance) {
-            delete rec.winstonInstance;
-        }
-    }
-    const baseConfig = {
-        meta: true,
-        requestWhitelist: ["body"],
-        bodyWhitelist: [],
-        expressFormat: false,
-        format: customRouteFormat(timestamp),
-        msg: "{{req.method}} {{req.url}} {{res.statusCode}} {{res.responseTime}}ms",
-        ignoredRoutes,
-    };
-    app.use(express_winston_1.default.logger({
-        transports: winston_js_1.transports,
-        ...baseConfig,
-        ...extraConfig,
-    }));
-};
-exports.registerRouteLogger = registerRouteLogger;
-const getExtraFilter = (userExtraFilter) => {
-    const expressRegEx = /node_modules\/express/u;
-    if (!userExtraFilter)
-        return expressRegEx;
-    if (Array.isArray(userExtraFilter))
-        return [expressRegEx, ...userExtraFilter];
-    return [expressRegEx, userExtraFilter];
-};
-const registerErrorLogger = (app, logOptions) => {
-    const { error, logger, timestamp } = logOptions ?? {};
-    const config = typeof error === "boolean"
-        ? {}
-        : error ?? {};
-    const activeTransports = logger ? logger.transports : winston_js_1.transports;
-    app.use(express_winston_1.default.errorLogger({
-        transports: activeTransports,
-        format: (0, winston_js_1.customFormat)(timestamp, config.collapseStacktrace ?? config.collapseNodeModules, getExtraFilter(config.extraFilter)),
-        meta: false,
-    }));
-};
-exports.registerErrorLogger = registerErrorLogger;

package/lib/express/middlewares/bodylogger.d.ts

@@ -1,9 +0,0 @@
-import { NextFunction, Request, Response } from "express";
-export type ExtraLoggingDataType = Record<string, unknown> | undefined;
-export type ExtraLoggingDataFunc = (req: Request) => Promise<ExtraLoggingDataType> | ExtraLoggingDataType;
-export type ExtraLoggingData = ExtraLoggingDataFunc | Record<string, unknown>;
-export interface ExtraLoggingOptions {
-    /** Do not expose the "hidden" body props */
-    noHiddenBodyProps?: boolean;
-}
-export declare const bodyLogger: (bodyProps?: Array<string>, extraLoggingData?: ExtraLoggingData, options?: ExtraLoggingOptions) => (req: Request, res: Response, next: NextFunction) => void;

package/lib/express/middlewares/bodylogger.js

@@ -1,90 +0,0 @@
-/**
- * @license
- * @preserve
- * MIT License
- *
- * Copyright (c) 2021 Gabriel Paul "Cley Faye" Risterucci
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- *
- */
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.bodyLogger = void 0;
-const setLogInfoInReq = (req, body, extraData) => {
-    const castReq = req;
-    if (body) {
-        if (!castReq._routeWhitelists)
-            castReq._routeWhitelists = {};
-        castReq._routeWhitelists.body = body;
-    }
-    if (extraData) {
-        castReq._cleyfayeLogging = { extraLoggingData: extraData };
-    }
-};
-const getPropType = (value) => {
-    if (typeof value === "string")
-        return `string(${value.length})`;
-    if (typeof value === "number")
-        return "number";
-    if (typeof value === "boolean")
-        return "boolean";
-    if (typeof value === "undefined")
-        return "undefined";
-    if (Array.isArray(value))
-        return `Array(${value.length})`;
-    return "object";
-};
-const getHiddenBodyProps = (req, ignoreKeys = []) => {
-    if (typeof req.body !== "object")
-        return;
-    const body = req.body;
-    const res = {};
-    for (const key of Object.keys(body)) {
-        if (ignoreKeys.includes(key))
-            continue;
-        res[key] = getPropType(body[key]);
-    }
-    if (Object.keys(res).length === 0)
-        return;
-    return res;
-};
-const bodyLogger = (bodyProps, extraLoggingData, options = {}) => (req, res, next) => {
-    const asyncFunc = async () => {
-        const allExtraData = {};
-        if (!options.noHiddenBodyProps) {
-            const redactedBody = getHiddenBodyProps(req, bodyProps);
-            if (redactedBody)
-                Object.assign(allExtraData, { redactedBody });
-        }
-        const extraLogData = typeof extraLoggingData === "function"
-            ? await extraLoggingData(req)
-            : extraLoggingData;
-        Object.assign(allExtraData, extraLogData);
-        setLogInfoInReq(req, bodyProps, allExtraData);
-    };
-    asyncFunc()
-        .then(() => {
-        next();
-    })
-        .catch((error) => {
-        next(error);
-    });
-};
-exports.bodyLogger = bodyLogger;

package/lib/express/pipelinebuilder.d.ts

@@ -1,115 +0,0 @@
-import express, { Request } from "express";
-import { OptionsJson, OptionsUrlencoded, OptionsText, Options as OptionsRaw } from "body-parser";
-import winston from "winston";
-import { LoggerOptions, ErrorLoggerOptions } from "./logger.js";
-export type LogFunction = (...args: Array<string | number | Record<string, unknown>>) => void;
-export interface MiddlewareOptions {
-    urlencoded?: boolean | OptionsUrlencoded;
-    text?: boolean | OptionsText;
-    raw?: boolean | OptionsRaw;
-    json?: boolean | OptionsJson;
-}
-export type ComplexRouteHandler = express.RequestHandler | express.Router | Array<express.RequestHandler>;
-export interface ComplexRouteDefinition {
-    route: string;
-    handler: ComplexRouteHandler;
-    method?: "get" | "post" | "put" | "options";
-}
-export type RouteDefinition = ComplexRouteDefinition | express.RequestHandler;
-export type RouterDefinition = express.Router | RouteDefinition;
-export type RouterWithNullDef = RouterDefinition | null | undefined;
-export interface ComplexStaticDefinition {
-    root: string;
-    options?: Record<string, unknown>;
-    route?: string;
-}
-export type StaticDefinition = ComplexStaticDefinition | string;
-export type UserFromReqFunc = (req: Request) => string | Record<string, unknown> | undefined;
-export interface LogOptions {
-    route?: LoggerOptions;
-    error?: ErrorLoggerOptions;
-    logger?: winston.Logger;
-    timestamp?: boolean;
-    extraStacktraceFilter?: Array<RegExp> | RegExp;
-    ignoredRoutes?: Array<string>;
-    /** @deprecated Use `authFromReq` instead */
-    userFromReq?: UserFromReqFunc;
-    authFromReq?: UserFromReqFunc;
-}
-export interface DefaultErrorHandlerConfig {
-    /** Set to true to allow server errors without a code to be sent as-is in the response */
-    noErrorFilter?: boolean;
-}
-export interface PipelineSettings {
-    topLevels?: Array<RouterWithNullDef>;
-    routes?: Array<RouterWithNullDef>;
-    statics?: Array<StaticDefinition>;
-    postStatics?: Array<RouterWithNullDef>;
-    errorHandlers?: Array<express.ErrorRequestHandler>;
-    options?: {
-        log?: LogOptions;
-        middleware?: MiddlewareOptions;
-        defaultErrorHandler?: boolean | DefaultErrorHandlerConfig;
-    };
-}
-export default class PipelineBuilder {
-    private _debugLog?;
-    constructor(debugLog?: LogFunction);
-    private static _addRouterToRouter;
-    private static _addMiddlewareToRouter;
-    /** Register error handlers
-     *
-     * @param router
-     * @param errorHandlers
-     */
-    private static _setErrorHandlers;
-    /** Appropriate call to express.static() */
-    private static _buildStaticHandler;
-    /** See createPipeline() for more info */
-    createPipeline({ topLevels, routes, statics, postStatics, errorHandlers, options, }: PipelineSettings): express.Router;
-    protected internalLog(...args: Array<string | number | Record<string, string>>): void;
-    /** Add generic middlewares to a router
-     *
-     * @param router
-     * @param [middlewareOptions]
-     * @param [middlewareOptions.json]
-     * Process JSON body
-     */
-    private _setGenericMiddlewares;
-    private _addRouteToRouter;
-    /** Register routes
-     *
-     * @param router
-     * @param routes
-     * See routes in createPipeline()
-     */
-    private _setRoutes;
-    /** Use a static definition */
-    private _useComplexStatic;
-    /** Define static resources for the express server
-     *
-     * @param router
-     * @param statics
-     * See createPipeline()
-     */
-    private _setStatics;
-    /** Register pre-route loggers
-     *
-     * @param router
-     * @param [logOptions]
-     * @param [logOptions.route]
-     * Log each route call
-     * @param [logOptions.logger]
-     */
-    private _setRouteLogger;
-    /** Register post-route loggers
-     *
-     * @param {Router} router
-     * @param {object} [logOptions]
-     * @param {bool} [logOptions.error]
-     * Log each error
-     * @param {winstonLogger} [logOptions.logger]
-     */
-    private _setErrorLogger;
-    private _setDefaultErrorHandler;
-}