pols-logger 1.1.2 → 2.0.1

package/README.md

@@ -1,3 +1,192 @@
-# Pols-Utils
-
-Utils methods
+# pols-logger
+
+`pols-logger` es una librería robusta y ligera de logging para Node.js escrita en TypeScript. Permite registrar mensajes formateados tanto en la consola como en archivos físicos, ofreciendo serialización automática de objetos, formateo limpio de errores y pilas de llamadas (stack traces), gestión de directorios automatizada y hooks de finalización personalizados.
+
+## Características
+
+* **Salidas flexibles:** Registra logs en consola, en archivos locales o en ambos a la vez de forma condicional.
+* **Serialización automática de datos:** Soporta cuerpos de log (`body`) del tipo `string`, `number`, `object` (JSON estructurado), `Error` (con stack trace seguro) y arreglos mixtos.
+* **Ruteo inteligente de consola:** Redirecciona automáticamente los logs de temas críticos (`ERROR`, `FATAL`) a `console.error` y el resto a `console.log`.
+* **Escritura eficiente en disco:** Optimiza las comprobaciones de directorios mediante una verificación perezosa (evita llamar a `fs.existsSync` repetidamente).
+* **Finalización de procesos controlada:** El método `fatal` detiene el proceso automáticamente con código de salida `1` por defecto, permitiendo configurar códigos de salida específicos en cualquier entrada de log.
+* **Eventos personalizados:** Permite registrar un hook `onEntryFinish` para reaccionar al terminar de escribir una entrada de log (útil para telemetría, alertas, etc.).
+
+---
+
+## Instalación
+
+Instala el paquete y sus dependencias en tu proyecto:
+
+```bash
+npm install pols-logger
+```
+
+---
+
+## Configuración y API
+
+### `PLogger`
+
+La clase principal que maneja los registros.
+
+#### Constructor
+
+```typescript
+const logger = new PLogger(config?: PLoggerParams)
+```
+
+Donde `PLoggerParams` tiene la siguiente estructura:
+
+* **`destinationPath?: string`**: Directorio donde se guardarán los archivos log. Obligatorio si el guardado en archivo está activado.
+* **`fileName?: ({ theme: PThemes, now: Date }) => string`**: Función personalizada para nombrar los archivos log dinámicamente. Por defecto genera nombres con el formato `LOG_YYYY-MM-DD.log`.
+* **`showIn?: PLoggerShowInConfig`**: Configura dónde mostrar cada tema de log.
+
+#### `PLoggerShowInConfig`
+
+Define si las salidas van a la consola o a archivos. Puede ser un booleano global o un objeto de grano fino para cada tipo de log:
+
+```typescript
+export type PLoggerShowInParams = boolean | {
+	info?: boolean
+	warning?: boolean
+	error?: boolean
+	debug?: boolean
+	system?: boolean
+	fatal?: boolean
+}
+
+export type PLoggerShowInConfig = {
+	console?: PLoggerShowInParams
+	file?: PLoggerShowInParams
+}
+```
+
+*Por defecto, `console` está activado (`true` para todos) y `file` está desactivado (`false`).*
+
+---
+
+### Métodos de Logging
+
+Todos los métodos aceptan un objeto del tipo `PLoggerLogParams` y formatean la salida con la estructura: `[THEME] DD/MM/YYYY HH:MM:SS.lll :: LABEL :: DESCRIPTION [TAG1] [TAG2]` seguido del contenido de `body`.
+
+* `logger.info(params)`
+* `logger.warning(params)`
+* `logger.error(params)`
+* `logger.debug(params)`
+* `logger.system(params)`
+* `logger.fatal(params)` *(provoca salida del proceso al finalizar)*
+
+---
+
+### Estructura de Parámetros (`PLoggerLogParams`)
+
+* **`label: string`** (Requerido): Etiqueta identificadora o título de la entrada.
+* **`description?: string`**: Descripción breve adicional del evento.
+* **`tags?: string[]`**: Etiquetas contextuales que se mostrarán al final de la cabecera (ej: `['database', 'retry']`).
+* **`body?: string | Record<string, any> | any[] | Error`**: Contenido o carga útil a registrar.
+* **`exit?: boolean | number`**: Si es `true` o un número, terminará la ejecución del proceso al finalizar el registro. Si es un número, se utilizará como código de salida.
+
+---
+
+## Ejemplos de Uso
+
+### 1. Inicialización Básica (Solo Consola)
+
+```typescript
+import { PLogger } from 'pols-logger'
+
+const logger = new PLogger()
+
+logger.info({
+	label: 'APP_START',
+	description: 'Iniciando la aplicación en modo producción'
+})
+```
+
+### 2. Guardado en Archivo con Rotación Personalizada
+
+Puedes generar archivos de logs separados por horas, turnos o días utilizando la fecha actual en la función `fileName`:
+
+```typescript
+import { PLogger } from 'pols-logger'
+import { PUtilsDate, PUtilsNumber } from 'pols-utils'
+
+const logger = new PLogger({
+	showIn: {
+		console: true,
+		file: true
+	},
+	destinationPath: __dirname + '/logs',
+	fileName: ({ now }) => {
+		// Crea un archivo diferente cada 6 horas (ej: LOG 2026-07-07 06-00.log)
+		const hourRange = PUtilsNumber.padStart(Math.floor(now.getHours() / 6) * 6, 2)
+		return PUtilsDate.format(now, `LOG @y-@mm-@dd ${hourRange}-00.log`)
+	}
+})
+
+logger.system({
+	label: 'DB_SYNC',
+	description: 'Sincronización de esquemas completada'
+})
+```
+
+### 3. Registro de Datos Complejos (Objetos, Arreglos y Errores)
+
+`pols-logger` detecta automáticamente el tipo de dato del `body` y lo formatea de manera óptima para lectura humana.
+
+```typescript
+// 1. Registrar un Objeto (JSON formateado con espacios)
+logger.info({
+	label: 'USER_LOGIN',
+	body: {
+		userId: 1042,
+		role: 'admin',
+		session: { active: true }
+	}
+})
+
+// 2. Registrar un Error (Muestra mensaje y stack trace limpio)
+try {
+	throw new Error('Conexión perdida con el host remoto')
+} catch (error) {
+	logger.error({
+		label: 'CONNECTION_FAILURE',
+		body: error
+	})
+}
+
+// 3. Registrar un Arreglo Mixto (Formatea recursivamente cada elemento)
+logger.warning({
+	label: 'BATCH_PROCESS',
+	body: [
+		'Procesando lote #54',
+		404,
+		{ itemId: 'A-12' },
+		new Error('Fallo de validación local')
+	]
+})
+```
+
+### 4. Uso del Hook de Evento `onEntryFinish`
+
+Útil para reenviar alertas a servicios de mensajería (como Slack, Telegram) o registrar auditorías adicionales:
+
+```typescript
+const logger = new PLogger({
+	destinationPath: './logs',
+	showIn: { console: true, file: true }
+})
+
+// Hook que se ejecuta al finalizar la escritura de cada log
+logger.onEntryFinish = (entry) => {
+	if (entry.exit) {
+		console.log(`El logger provocó una salida del sistema con etiqueta: ${entry.label}`)
+	}
+}
+```
+
+---
+
+## Licencia
+
+Este proyecto está bajo la Licencia ISC.

package/dist/index.d.ts

@@ -32,12 +32,13 @@ export type PLoggerLogParams = {
     description?: string;
     tags?: string[];
     body?: string | PRecord | unknown[] | Error;
-    exit?: boolean;
+    exit?: boolean | number;
 };
 export declare class PLogger {
     destinationPath?: string;
     showIn?: PLoggerShowInConfig;
     fileName?: PLoggerParams['fileName'];
+    _dirChecked?: string;
     onEntryFinish?: (params: PLoggerLogParams) => void;
     constructor(params?: PLoggerParams);
     info(params: PLoggerLogParams): void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAc,MAAM,YAAY,CAAA;AAEhD,oBAAY,OAAO;IAClB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IACjC,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,IAAI,CAAC,EAAE,mBAAmB,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC3B,KAAK,EAAE,OAAO,CAAA;QACd,GAAG,EAAE,IAAI,CAAA;KACT,KAAK,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,mBAAmB,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,GAAG,KAAK,CAAA;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAgGD,qBAAa,OAAO;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IAC5B,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;gBAE9C,MAAM,CAAC,EAAE,aAAa;IAMlC,IAAI,CAAC,MAAM,EAAE,gBAAgB;IAI7B,OAAO,CAAC,MAAM,EAAE,gBAAgB;IAIhC,KAAK,CAAC,MAAM,EAAE,gBAAgB;IAI9B,KAAK,CAAC,MAAM,EAAE,gBAAgB;IAI9B,MAAM,CAAC,MAAM,EAAE,gBAAgB;IAI/B,KAAK,CAAC,MAAM,EAAE,gBAAgB;CAG9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAc,MAAM,YAAY,CAAA;AAEhD,oBAAY,OAAO;IAClB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IACjC,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,IAAI,CAAC,EAAE,mBAAmB,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC3B,KAAK,EAAE,OAAO,CAAA;QACd,GAAG,EAAE,IAAI,CAAA;KACT,KAAK,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,mBAAmB,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,GAAG,KAAK,CAAA;IAC3C,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CACvB,CAAA;AA2HD,qBAAa,OAAO;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;gBAE9C,MAAM,CAAC,EAAE,aAAa;IAMlC,IAAI,CAAC,MAAM,EAAE,gBAAgB;IAI7B,OAAO,CAAC,MAAM,EAAE,gBAAgB;IAIhC,KAAK,CAAC,MAAM,EAAE,gBAAgB;IAI9B,KAAK,CAAC,MAAM,EAAE,gBAAgB;IAI9B,MAAM,CAAC,MAAM,EAAE,gBAAgB;IAI/B,KAAK,CAAC,MAAM,EAAE,gBAAgB;CAG9B"}

package/dist/index.js

@@ -22,13 +22,14 @@ const check = (theme, value, def) => {
     if (typeof value == 'boolean')
         return value;
     switch (theme) {
-        case PThemes.INFO: return value.info;
-        case PThemes.WARNING: return value.warning;
-        case PThemes.ERROR: return value.error;
-        case PThemes.DEBUG: return value.debug;
-        case PThemes.SYSTEM: return value.system;
-        case PThemes.FATAL: return value.fatal;
+        case PThemes.INFO: return value.info ?? def;
+        case PThemes.WARNING: return value.warning ?? def;
+        case PThemes.ERROR: return value.error ?? def;
+        case PThemes.DEBUG: return value.debug ?? def;
+        case PThemes.SYSTEM: return value.system ?? def;
+        case PThemes.FATAL: return value.fatal ?? def;
     }
+    return def;
 };
 const logger = (theme, pLogger, { label, description, body, exit = false, tags }, executeEvent = true) => {
     const now = new Date;
@@ -44,7 +45,7 @@ const logger = (theme, pLogger, { label, description, body, exit = false, tags }
             if (b instanceof Error) {
                 return [
                     'Error: ' + b.message,
-                    b.stack.replace(/^Error.*?\n/, '')
+                    b.stack?.replace(/^Error.*?\n/, '') ?? ''
                 ];
             }
             else if (typeof b == 'string') {
@@ -56,20 +57,45 @@ const logger = (theme, pLogger, { label, description, body, exit = false, tags }
             else if (b == null) {
                 return '';
             }
+            else if (typeof b == 'object') {
+                try {
+                    return JSON.stringify(b, null, 2);
+                }
+                catch {
+                    return b.toString();
+                }
+            }
             else {
-                b.toString();
+                return String(b);
             }
         }).flat());
     }
     else if (body instanceof Error) {
-        textBody.push('Error: ' + body.message, body.stack.replace(/^Error.*?\n/, ''));
+        textBody.push('Error: ' + body.message, body.stack?.replace(/^Error.*?\n/, '') ?? '');
     }
     else if (typeof body == 'string') {
         textBody.push(body);
     }
+    else if (typeof body == 'number') {
+        textBody.push(body.toString());
+    }
+    else if (body == null) {
+        // do nothing
+    }
+    else if (typeof body == 'object') {
+        try {
+            textBody.push(JSON.stringify(body, null, 2));
+        }
+        catch {
+            textBody.push(body.toString());
+        }
+    }
+    else {
+        textBody.push(String(body));
+    }
     /* Por defecto, muestra el mensaje en consola */
     if (check(theme, pLogger.showIn?.console, true)) {
-        if ([].includes(theme)) {
+        if ([PThemes.ERROR, PThemes.FATAL].includes(theme)) {
             console.error(headers.join(' '));
             if (textBody.length)
                 console.error(textBody.join('\n'));
@@ -86,20 +112,25 @@ const logger = (theme, pLogger, { label, description, body, exit = false, tags }
         if (!pLogger.destinationPath)
             throw new Error(`La propiedad 'destinationPath' es requerida si la entrada debe ir a un archivo`);
         const filePath = path_1.default.join(pLogger.destinationPath, fileName);
-        if (!fs_1.default.existsSync(pLogger.destinationPath)) {
-            /* Si no existe la carpeta para los logs, se intentará crear automáticamente */
-            try {
-                fs_1.default.mkdirSync(pLogger.destinationPath, { recursive: true });
-            }
-            catch (error) {
-                throw new Error(`No fue posible crear el directorio '${pLogger.destinationPath}': ${error.message}`);
+        if (pLogger._dirChecked !== pLogger.destinationPath) {
+            if (!fs_1.default.existsSync(pLogger.destinationPath)) {
+                /* Si no existe la carpeta para los logs, se intentará crear automáticamente */
+                try {
+                    fs_1.default.mkdirSync(pLogger.destinationPath, { recursive: true });
+                }
+                catch (error) {
+                    const errMsg = error instanceof Error ? error.message : String(error);
+                    throw new Error(`No fue posible crear el directorio '${pLogger.destinationPath}': ${errMsg}`);
+                }
             }
+            pLogger._dirChecked = pLogger.destinationPath;
         }
         try {
             fs_1.default.appendFileSync(filePath, `${headers.join(' ')}${textBody.length ? `\n${textBody.join('\n')}` : ''}\n`, { encoding: 'utf-8' });
         }
         catch (error) {
-            throw new Error(`No fue posible registrar la entrada en el archivo '${filePath}': ${error.message}`);
+            const errMsg = error instanceof Error ? error.message : String(error);
+            throw new Error(`No fue posible registrar la entrada en el archivo '${filePath}': ${errMsg}`);
         }
     }
     /* Ejecuta el evento del pLogger */
@@ -112,13 +143,16 @@ const logger = (theme, pLogger, { label, description, body, exit = false, tags }
         }
     }
     /* Si se ha dado la opción, se sale del programa */
-    if (exit)
-        process.exit();
+    if (exit) {
+        const exitCode = typeof exit === 'number' ? exit : (theme === PThemes.FATAL || theme === PThemes.ERROR ? 1 : 0);
+        process.exit(exitCode);
+    }
 };
 class PLogger {
     destinationPath;
     showIn;
     fileName;
+    _dirChecked;
     constructor(params) {
         this.destinationPath = params?.destinationPath;
         this.showIn = params?.showIn;

package/package.json

@@ -1,12 +1,10 @@
 {
 	"name": "pols-logger",
-	"version": "1.1.2",
+	"version": "2.0.1",
 	"main": "dist/index.js",
 	"module": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"scripts": {
-		"build:cjs": "npx tsc --project tsconfig.cjs.json",
-		"build:esm": "npx tsc --project tsconfig.esm.json",
 		"build": "npx tsc",
 		"test": "npx ts-node-dev -r tsconfig-paths/register --project tsconfig.json",
 		"export": "npm run build && npm publish"
@@ -30,6 +28,6 @@
 		"typescript-eslint": "^8.11.0"
 	},
 	"dependencies": {
-		"pols-utils": "^5.9.3"
+		"pols-utils": "^6.0.1"
 	}
 }

package/.vscode/launch.json

@@ -1,22 +0,0 @@
-{
-	// Use IntelliSense to learn about possible attributes.
-	// Hover to view descriptions of existing attributes.
-	// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-	"version": "0.2.0",
-	"configurations": [
-		{
-			"type": "node",
-			"request": "launch",
-			"name": "npm run test",
-			"skipFiles": [
-				"<node_internals>/**"
-			],
-			"runtimeExecutable": "npm",
-			"runtimeArgs": [
-				"run",
-				"test",
-				"test/logger.ts"
-			]
-		}
-	]
-}

package/.vscode/settings.json

@@ -1,3 +0,0 @@
-{
-	"typescript.tsdk": "node_modules\\typescript\\lib"
-}

package/eslint.config.mjs

@@ -1,19 +0,0 @@
-import globals from "globals";
-import pluginJs from "@eslint/js";
-import tseslint from "typescript-eslint";
-
-export default [
-	{
-		files: ["**/*.{ts}"],
-	},
-	{ languageOptions: { globals: globals.node } },
-	pluginJs.configs.recommended,
-	...tseslint.configs.recommended,
-	{
-		rules: {
-			"@typescript-eslint/no-unused-vars": "warn",
-			"@typescript-eslint/no-explicit-any": false,
-			"no-use-before-define": "off"
-		}
-	}
-];

package/tsconfig.cjs.json

@@ -1,8 +0,0 @@
-{
-	"extends": "./tsconfig.json",
-	"compilerOptions": {
-		"module": "commonjs",
-		"moduleResolution": "Node",
-		"outDir": "./dist/cjs"
-	}
-}

package/tsconfig.esm.json

@@ -1,8 +0,0 @@
-{
-	"extends": "./tsconfig.json",
-	"compilerOptions": {
-		"module": "NodeNext",
-		"moduleResolution": "NodeNext",
-		"outDir": "./dist/esm"
-	}
-}

package/tsconfig.json

@@ -1,20 +0,0 @@
-{
-	"compilerOptions": {
-		"target": "ESNext",
-		"module": "NodeNext",
-		"moduleResolution": "NodeNext",
-		"esModuleInterop": true,
-		"forceConsistentCasingInFileNames": true,
-		"strict": false,
-		"skipLibCheck": true,
-		"declaration": true,
-		"declarationMap": true,
-		"outDir": "./dist"
-	},
-	"include": [
-		"src/**/*.ts"
-	],
-	"exclude": [
-		"node_modules"
-	]
-}

package/tsconfig.old.json

@@ -1,102 +0,0 @@
-{
-	"compilerOptions": {
-		/* Visit https://aka.ms/tsconfig to read more about this file */
-		/* Projects */
-		// "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
-		// "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
-		// "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
-		// "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
-		// "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
-		// "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
-		/* Language and Environment */
-		"target": "es2016", /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-		// "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-		// "jsx": "preserve",                                /* Specify what JSX code is generated. */
-		// "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */
-		// "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
-		// "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
-		// "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
-		// "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
-		// "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
-		// "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
-		// "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
-		// "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
-		/* Modules */
-		"module": "commonjs", /* Specify what module code is generated. */
-		// "rootDir": "./",                                  /* Specify the root folder within your source files. */
-		// "moduleResolution": "node10",                     /* Specify how TypeScript looks up a file from a given module specifier. */
-		// "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
-		// "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
-		// "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
-		// "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
-		// "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
-		// "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
-		// "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
-		// "allowImportingTsExtensions": true,               /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */
-		// "resolvePackageJsonExports": true,                /* Use the package.json 'exports' field when resolving package imports. */
-		// "resolvePackageJsonImports": true,                /* Use the package.json 'imports' field when resolving imports. */
-		// "customConditions": [],                           /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */
-		// "noUncheckedSideEffectImports": true,             /* Check side effect imports. */
-		// "resolveJsonModule": true,                        /* Enable importing .json files. */
-		// "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
-		// "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
-		/* JavaScript Support */
-		// "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
-		// "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
-		// "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
-		/* Emit */
-		// "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
-		// "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
-		// "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
-		// "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
-		// "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
-		// "noEmit": true,                                   /* Disable emitting files from a compilation. */
-		// "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
-		// "outDir": "./",                                   /* Specify an output folder for all emitted files. */
-		// "removeComments": true,                           /* Disable emitting comments. */
-		// "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
-		// "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
-		// "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
-		// "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
-		// "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
-		// "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
-		// "newLine": "crlf",                                /* Set the newline character for emitting files. */
-		// "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
-		// "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
-		// "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
-		// "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
-		// "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
-		/* Interop Constraints */
-		// "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
-		// "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
-		// "isolatedDeclarations": true,                     /* Require sufficient annotation on exports so other tools can trivially generate declaration files. */
-		// "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
-		"esModuleInterop": true, /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
-		// "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
-		"forceConsistentCasingInFileNames": true, /* Ensure that casing is correct in imports. */
-		/* Type Checking */
-		"strict": true, /* Enable all strict type-checking options. */
-		// "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
-		// "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
-		// "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
-		// "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
-		// "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
-		// "strictBuiltinIteratorReturn": true,              /* Built-in iterators are instantiated with a 'TReturn' type of 'undefined' instead of 'any'. */
-		// "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
-		// "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
-		// "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
-		// "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
-		// "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
-		// "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
-		// "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
-		// "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
-		// "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
-		// "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
-		// "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
-		// "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
-		// "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
-		/* Completeness */
-		// "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
-		"skipLibCheck": true /* Skip type checking all .d.ts files. */
-	}
-}