@phystack/phy-logger 4.3.40-dev

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export interface LogOptions {
+    level?: LogLevel;
+    logToFile?: boolean;
+    logDirectory?: string;
+    timestampFormat?: string;
+    includeTrace?: boolean;
+    namespace?: string;
+    rotationPeriodInDays?: number;
+    logToConsole?: boolean;
+}
+export interface LogEntry {
+    timestamp: string;
+    level: string;
+    message: string;
+    data?: any;
+    trace?: string;
+}
+export declare class PhyLogger {
+    private level;
+    private logToFile;
+    private logDirectory;
+    private timestampFormat;
+    private includeTrace;
+    private currentLogPath;
+    private namespace;
+    private rotationPeriodInDays;
+    private logToConsole;
+    constructor(options?: LogOptions);
+    private generateLogFilePath;
+    private ensureLogDirectory;
+    private getCallerPackageName;
+    private getTimestamp;
+    private formatMessage;
+    private safeJsonStringify;
+    private writeToFile;
+    private removeOldLogs;
+    private getConsoleMethod;
+    private log;
+    debug(message: string, data?: any): void;
+    info(message: string, data?: any): void;
+    warn(message: string, data?: any): void;
+    error(message: string, data?: any): void;
+    setLevel(level: LogLevel): void;
+    clearCurrentLog(): Promise<void>;
+    getCurrentLogPath(): Promise<string>;
+    getLogs(lastLines?: number): Promise<string[]>;
+    getAllLogFiles(): Promise<string[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACZ;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAS;IAClB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,YAAY,CAAU;gBAElB,OAAO,GAAE,UAAe;IA4BpC,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,oBAAoB;IA0C5B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,iBAAiB;YAiBX,WAAW;YAmBX,aAAa;IAqB3B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,GAAG;IAkBJ,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAIzB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAIpC,OAAO,CAAC,SAAS,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQnD,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAOnD"}

package/dist/index.js

@@ -0,0 +1,232 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhyLogger = exports.LogLevel = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+class PhyLogger {
+    constructor(options = {}) {
+        var _a, _b, _c, _d, _e, _f;
+        const baseDirectory = '/var/log';
+        this.level = (_a = options.level) !== null && _a !== void 0 ? _a : LogLevel.INFO;
+        this.logToFile = (_b = options.logToFile) !== null && _b !== void 0 ? _b : false;
+        if (options.logDirectory === 'logs') {
+            this.logDirectory = baseDirectory;
+        }
+        else {
+            this.logDirectory = path_1.default.join(baseDirectory, options.logDirectory || '');
+        }
+        this.timestampFormat = (_c = options.timestampFormat) !== null && _c !== void 0 ? _c : 'ISO';
+        this.includeTrace = (_d = options.includeTrace) !== null && _d !== void 0 ? _d : true;
+        let callerNamespace = this.getCallerPackageName() || 'phylogger';
+        if (callerNamespace.startsWith('@phystack/')) {
+            callerNamespace = `phylogger-${callerNamespace.substring('@phystack/'.length)}`;
+        }
+        this.currentLogPath = this.generateLogFilePath(callerNamespace);
+        this.namespace = callerNamespace ? `[${callerNamespace}] ` : '';
+        this.rotationPeriodInDays = (_e = options.rotationPeriodInDays) !== null && _e !== void 0 ? _e : 3;
+        this.logToConsole = (_f = options.logToConsole) !== null && _f !== void 0 ? _f : true;
+        if (this.logToFile) {
+            this.ensureLogDirectory();
+        }
+    }
+    generateLogFilePath(namespace) {
+        return path_1.default.join(this.logDirectory, `${namespace}.log`);
+    }
+    ensureLogDirectory() {
+        try {
+            if (!fs_1.default.existsSync(this.logDirectory)) {
+                fs_1.default.mkdirSync(this.logDirectory, { recursive: true });
+                fs_1.default.chmodSync(this.logDirectory, 0o700);
+            }
+        }
+        catch (error) {
+            console.error('Failed to ensure log directory:', error);
+        }
+    }
+    getCallerPackageName() {
+        const originalPrepareStackTrace = Error.prepareStackTrace;
+        try {
+            Error.prepareStackTrace = (_, stack) => stack;
+            const err = new Error();
+            const stack = err.stack;
+            let callerFile;
+            for (const callSite of stack) {
+                const fileName = callSite.getFileName();
+                if (fileName && !fileName.includes('phy-logger')) {
+                    callerFile = fileName;
+                    break;
+                }
+            }
+            if (callerFile) {
+                let dir = path_1.default.dirname(callerFile);
+                const root = path_1.default.parse(dir).root;
+                while (dir !== root) {
+                    const pkgPath = path_1.default.join(dir, 'package.json');
+                    if (fs_1.default.existsSync(pkgPath)) {
+                        try {
+                            const pkg = JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf8'));
+                            return pkg.name || '';
+                        }
+                        catch (e) {
+                            console.error('Error parsing package.json:', e);
+                        }
+                    }
+                    dir = path_1.default.dirname(dir);
+                }
+            }
+        }
+        catch (error) {
+            console.error('Error while getting caller package name:', error);
+        }
+        finally {
+            Error.prepareStackTrace = originalPrepareStackTrace;
+        }
+        return '';
+    }
+    getTimestamp() {
+        const now = new Date();
+        if (this.timestampFormat === 'ISO') {
+            return now.toISOString();
+        }
+        return now.toLocaleString();
+    }
+    formatMessage(level, message, data) {
+        var _a;
+        const logEntry = {
+            timestamp: this.getTimestamp(),
+            level,
+            message: `${this.namespace}${message}`,
+            data: data,
+        };
+        if (this.includeTrace && (level === 'ERROR' || level === 'WARN')) {
+            logEntry.trace = (_a = new Error().stack) === null || _a === void 0 ? void 0 : _a.split('\n').slice(3).join('\n');
+        }
+        return logEntry;
+    }
+    safeJsonStringify(data) {
+        try {
+            const seen = new WeakSet();
+            return JSON.stringify(data, (_key, value) => {
+                if (typeof value === 'object' && value !== null) {
+                    if (seen.has(value)) {
+                        return '[Circular]';
+                    }
+                    seen.add(value);
+                }
+                return value;
+            });
+        }
+        catch (err) {
+            return '[Unserializable Data]';
+        }
+    }
+    async writeToFile(entry) {
+        try {
+            await this.removeOldLogs();
+            const logLine = `${entry.timestamp} [${entry.level}] ${entry.message}${entry.data ? ' ' + this.safeJsonStringify(entry.data) : ''}${entry.trace ? '\nStack Trace:\n' + entry.trace : ''}\n`;
+            if (!fs_1.default.existsSync(this.currentLogPath)) {
+                await fs_1.default.promises.writeFile(this.currentLogPath, '');
+                await fs_1.default.promises.chmod(this.currentLogPath, 0o660);
+            }
+            await fs_1.default.promises.appendFile(this.currentLogPath, logLine);
+        }
+        catch (error) {
+            console.error('Failed to write to log file:', error);
+        }
+    }
+    async removeOldLogs() {
+        try {
+            const files = await fs_1.default.promises.readdir(this.logDirectory);
+            const thresholdDate = new Date();
+            thresholdDate.setDate(thresholdDate.getDate() - this.rotationPeriodInDays);
+            for (const file of files) {
+                if (file.endsWith('.log')) {
+                    const filePath = path_1.default.join(this.logDirectory, file);
+                    const stats = await fs_1.default.promises.stat(filePath);
+                    const fileDate = new Date(stats.mtime);
+                    if (fileDate < thresholdDate) {
+                        await fs_1.default.promises.unlink(filePath);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error('Error deleting old log files:', error);
+        }
+    }
+    getConsoleMethod(level) {
+        switch (level) {
+            case 'DEBUG': return 'log';
+            case 'INFO': return 'info';
+            case 'WARN': return 'warn';
+            case 'ERROR': return 'error';
+            default: return 'log';
+        }
+    }
+    log(level, message, data) {
+        if (LogLevel[level] < this.level) {
+            return;
+        }
+        const entry = this.formatMessage(level, message, data);
+        if (this.logToConsole) {
+            const consoleMethod = this.getConsoleMethod(level);
+            const consoleMessage = `${entry.timestamp} [${entry.level}] ${entry.message}`;
+            data ? console[consoleMethod](consoleMessage, data) : console[consoleMethod](consoleMessage);
+            if (entry.trace) {
+                console[consoleMethod]('Stack Trace:', entry.trace);
+            }
+        }
+        if (this.logToFile) {
+            this.writeToFile(entry);
+        }
+    }
+    debug(message, data) {
+        this.log('DEBUG', message, data);
+    }
+    info(message, data) {
+        this.log('INFO', message, data);
+    }
+    warn(message, data) {
+        this.log('WARN', message, data);
+    }
+    error(message, data) {
+        this.log('ERROR', message, data);
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    async clearCurrentLog() {
+        if (this.logToFile && fs_1.default.existsSync(this.currentLogPath)) {
+            await fs_1.default.promises.writeFile(this.currentLogPath, '');
+        }
+    }
+    async getCurrentLogPath() {
+        return this.currentLogPath;
+    }
+    async getLogs(lastLines = 100) {
+        if (!this.logToFile || !fs_1.default.existsSync(this.currentLogPath)) {
+            return [];
+        }
+        const fileContent = await fs_1.default.promises.readFile(this.currentLogPath, 'utf-8');
+        return fileContent.split('\n').slice(-lastLines);
+    }
+    async getAllLogFiles() {
+        if (!fs_1.default.existsSync(this.logDirectory)) {
+            return [];
+        }
+        const files = await fs_1.default.promises.readdir(this.logDirectory);
+        return files.filter(file => file.endsWith('.log')).sort().reverse();
+    }
+}
+exports.PhyLogger = PhyLogger;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@phystack/phy-logger",
+  "version": "4.3.40-dev",
+  "main": "dist/index.js",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc",
+    "build:watch": "tsc -w"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.1",
+    "typescript": "^5.4.5"
+  },
+  "test": "react-scripts test",
+  "test:coverage": "npm run test -- --coverage --watchAll=false",
+  "gitHead": "53c505b3ecad47ebd4f38819c07b0ec1227214a6"
+}

package/src/index.ts

@@ -0,0 +1,279 @@
+import fs from 'fs';
+import path from 'path';
+
+export enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+}
+
+export interface LogOptions {
+    level?: LogLevel;
+    logToFile?: boolean;
+    logDirectory?: string;
+    timestampFormat?: string;
+    includeTrace?: boolean;
+    namespace?: string;
+    rotationPeriodInDays?: number;
+    logToConsole?: boolean;
+}
+
+export interface LogEntry {
+    timestamp: string;
+    level: string;
+    message: string;
+    data?: any;
+    trace?: string;
+}
+
+export class PhyLogger {
+    private level: LogLevel;
+    private logToFile: boolean;
+    private logDirectory: string;
+    private timestampFormat: string;
+    private includeTrace: boolean;
+    private currentLogPath: string;
+    private namespace: string;
+    private rotationPeriodInDays: number;
+    private logToConsole: boolean;
+
+    constructor(options: LogOptions = {}) {
+        const baseDirectory = '/var/log';
+
+        this.level = options.level ?? LogLevel.INFO;
+        this.logToFile = options.logToFile ?? false;
+        if (options.logDirectory === 'logs') {
+            this.logDirectory = baseDirectory;
+        } else {
+            this.logDirectory = path.join(baseDirectory, options.logDirectory || '');
+        }
+        this.timestampFormat = options.timestampFormat ?? 'ISO';
+        this.includeTrace = options.includeTrace ?? true;
+
+        // Determine the caller namespace solely from package.json.
+        let callerNamespace = this.getCallerPackageName() || 'phylogger';
+        if (callerNamespace.startsWith('@phystack/')) {
+            callerNamespace = `phylogger-${callerNamespace.substring('@phystack/'.length)}`;
+        }
+        this.currentLogPath = this.generateLogFilePath(callerNamespace);
+        this.namespace = callerNamespace ? `[${callerNamespace}] ` : '';
+        this.rotationPeriodInDays = options.rotationPeriodInDays ?? 3;
+        this.logToConsole = options.logToConsole ?? true;
+
+        if (this.logToFile) {
+            this.ensureLogDirectory();
+        }
+    }
+
+    private generateLogFilePath(namespace: string): string {
+        return path.join(this.logDirectory, `${namespace}.log`);
+    }
+
+    private ensureLogDirectory(): void {
+        try {
+            if (!fs.existsSync(this.logDirectory)) {
+                fs.mkdirSync(this.logDirectory, { recursive: true });
+                fs.chmodSync(this.logDirectory, 0o700);
+            }
+        } catch (error) {
+            console.error('Failed to ensure log directory:', error);
+        }
+    }
+
+    // This helper inspects the call stack to determine the caller file and finds the package name.
+    private getCallerPackageName(): string {
+        const originalPrepareStackTrace = Error.prepareStackTrace;
+        try {
+            // Prepare the error to get a structured stack
+            Error.prepareStackTrace = (_, stack) => stack;
+            const err = new Error();
+            const stack = err.stack as unknown as NodeJS.CallSite[];
+
+            let callerFile: string | undefined;
+            // Start scanning the stack frames, skipping frames inside the logger itself.
+            for (const callSite of stack) {
+                const fileName = callSite.getFileName();
+                if (fileName && !fileName.includes('phy-logger')) {
+                    callerFile = fileName;
+                    break;
+                }
+            }
+
+            if (callerFile) {
+                let dir = path.dirname(callerFile);
+                const root = path.parse(dir).root;
+                while (dir !== root) {
+                    const pkgPath = path.join(dir, 'package.json');
+                    if (fs.existsSync(pkgPath)) {
+                        try {
+                            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+                            return pkg.name || '';
+                        } catch (e) {
+                            console.error('Error parsing package.json:', e);
+                        }
+                    }
+                    dir = path.dirname(dir);
+                }
+            }
+        } catch (error) {
+            console.error('Error while getting caller package name:', error);
+        } finally {
+            Error.prepareStackTrace = originalPrepareStackTrace;
+        }
+        return '';
+    }
+
+    private getTimestamp(): string {
+        const now = new Date();
+        if (this.timestampFormat === 'ISO') {
+            return now.toISOString();
+        }
+        return now.toLocaleString();
+    }
+
+    private formatMessage(level: string, message: string, data?: any): LogEntry {
+        const logEntry: LogEntry = {
+            timestamp: this.getTimestamp(),
+            level,
+            message: `${this.namespace}${message}`,
+            data: data,
+        };
+
+        if (this.includeTrace && (level === 'ERROR' || level === 'WARN')) {
+            logEntry.trace = new Error().stack?.split('\n').slice(3).join('\n');
+        }
+        return logEntry;
+    }
+
+    private safeJsonStringify(data: any): string {
+        try {
+            const seen = new WeakSet();
+            return JSON.stringify(data, (_key, value) => {
+                if (typeof value === 'object' && value !== null) {
+                    if (seen.has(value)) {
+                        return '[Circular]';
+                    }
+                    seen.add(value);
+                }
+                return value;
+            });
+        } catch (err) {
+            return '[Unserializable Data]';
+        }
+    }
+
+    private async writeToFile(entry: LogEntry): Promise<void> {
+        try {
+            await this.removeOldLogs();
+
+            const logLine = `${entry.timestamp} [${entry.level}] ${entry.message}${
+                entry.data ? ' ' + this.safeJsonStringify(entry.data) : ''
+            }${entry.trace ? '\nStack Trace:\n' + entry.trace : ''}\n`;
+
+            if (!fs.existsSync(this.currentLogPath)) {
+                await fs.promises.writeFile(this.currentLogPath, '');
+                await fs.promises.chmod(this.currentLogPath, 0o660);
+            }
+
+            await fs.promises.appendFile(this.currentLogPath, logLine);
+        } catch (error) {
+            console.error('Failed to write to log file:', error);
+        }
+    }
+
+    private async removeOldLogs(): Promise<void> {
+        try {
+            const files = await fs.promises.readdir(this.logDirectory);
+            const thresholdDate = new Date();
+            thresholdDate.setDate(thresholdDate.getDate() - this.rotationPeriodInDays);
+
+            for (const file of files) {
+                if (file.endsWith('.log')) {
+                    const filePath = path.join(this.logDirectory, file);
+                    const stats = await fs.promises.stat(filePath);
+                    const fileDate = new Date(stats.mtime);
+                    if (fileDate < thresholdDate) {
+                        await fs.promises.unlink(filePath);
+                    }
+                }
+            }
+        } catch (error) {
+            console.error('Error deleting old log files:', error);
+        }
+    }
+
+    private getConsoleMethod(level: string): 'log' | 'info' | 'warn' | 'error' {
+        switch (level) {
+            case 'DEBUG': return 'log';
+            case 'INFO': return 'info';
+            case 'WARN': return 'warn';
+            case 'ERROR': return 'error';
+            default: return 'log';
+        }
+    }
+
+    private log(level: string, message: string, data?: any): void {
+        if (LogLevel[level as keyof typeof LogLevel] < this.level) {
+            return;
+        }
+        const entry = this.formatMessage(level, message, data);
+        if (this.logToConsole) {
+            const consoleMethod = this.getConsoleMethod(level);
+            const consoleMessage = `${entry.timestamp} [${entry.level}] ${entry.message}`;
+            data ? console[consoleMethod](consoleMessage, data) : console[consoleMethod](consoleMessage);
+            if (entry.trace) {
+                console[consoleMethod]('Stack Trace:', entry.trace);
+            }
+        }
+        if (this.logToFile) {
+            this.writeToFile(entry);
+        }
+    }
+
+    public debug(message: string, data?: any): void {
+        this.log('DEBUG', message, data);
+    }
+
+    public info(message: string, data?: any): void {
+        this.log('INFO', message, data);
+    }
+
+    public warn(message: string, data?: any): void {
+        this.log('WARN', message, data);
+    }
+
+    public error(message: string, data?: any): void {
+        this.log('ERROR', message, data);
+    }
+
+    public setLevel(level: LogLevel): void {
+        this.level = level;
+    }
+
+    public async clearCurrentLog(): Promise<void> {
+        if (this.logToFile && fs.existsSync(this.currentLogPath)) {
+            await fs.promises.writeFile(this.currentLogPath, '');
+        }
+    }
+
+    public async getCurrentLogPath(): Promise<string> {
+        return this.currentLogPath;
+    }
+
+    public async getLogs(lastLines: number = 100): Promise<string[]> {
+        if (!this.logToFile || !fs.existsSync(this.currentLogPath)) {
+            return [];
+        }
+        const fileContent = await fs.promises.readFile(this.currentLogPath, 'utf-8');
+        return fileContent.split('\n').slice(-lastLines);
+    }
+
+    public async getAllLogFiles(): Promise<string[]> {
+        if (!fs.existsSync(this.logDirectory)) {
+            return [];
+        }
+        const files = await fs.promises.readdir(this.logDirectory);
+        return files.filter(file => file.endsWith('.log')).sort().reverse();
+    }
+}

package/tsconfig.json

@@ -0,0 +1,45 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "es2018",
+    "outDir": "dist",
+    "rootDir": "./src",
+    "baseUrl": "src",
+    "removeComments": true,
+    "moduleResolution": "node",
+    "sourceMap": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "alwaysStrict": true,
+    "allowJs": true,
+    "noEmitOnError": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitAny": true,
+    "noImplicitReturns": false,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "strictBindCallApply": true,
+    "strictNullChecks": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "declarationDir": "dist",
+    "declarationMap": true,
+    "declaration": true,
+    "paths": {
+      "@/*": ["*"]
+    }
+    },
+  "include": [
+    "./src/**/*"
+, "src/__tests__"  ],
+  "exclude": [
+    "node_modules/**/*",
+    ".serverless/**/*",
+    ".webpack/**/*",
+    "_warmup/**/*",
+    "dist/**/*",
+    ".vscode/**/*",
+  ],
+}