@mks2508/better-logger 0.14.0-alpha.2 → 0.18.2-alpha.2

package/dist/chunks/server-fallback-CaCPjWby.cjs

@@ -0,0 +1,119 @@
+//#region src/playground/server-fallback.ts
+/**
+* Degradación de CLI primitives para modo server/non-TTY.
+*
+* Cada método espeja uno del {@link TerminalBridge} (`step`/`header`/`box`/...)
+* y decide cómo renderizarlo sin depender de caracteres de caja ni control
+* ANSI: texto plano al logger, o no-op cuando no hay nada útil que emitir.
+*
+* @example
+* ```ts
+* // En CI (sin TTY), TerminalBridge enruta automáticamente aquí:
+* logger.step(2, 5, 'Compilando');      // logger.info('[2/5] Compilando')
+* logger.header('Build', 'v1.2.3');     // logger.info('Build v1.2.3')
+* logger.divider();                     // (no-op)
+* ```
+*
+* @see {@link TerminalBridge} para el dispatcher TTY-vs-server.
+*/
+var ServerFallback = class {
+	logger;
+	/**
+	* @param {Logger} logger - Logger sobre el que se emiten los mensajes
+	*   degradados. Respeta el `outputMode` que tenga configurado (json,
+	*   console, ...), por lo que funciona tanto para logs estructurados
+	*   como para texto plano.
+	*/
+	constructor(logger) {
+		this.logger = logger;
+	}
+	/**
+	* Emite un step como `logger.info` con el contador `[current/total]`
+	* prefijado al mensaje. Conserva el orden y el progreso sin depender
+	* de caracteres de caja.
+	*
+	* @param {number} current - Índice del step actual (1-based).
+	* @param {number} total - Total de steps del run.
+	* @param {string} msg - Descripción del step.
+	* @returns {void}
+	*/
+	step(current, total, msg) {
+		this.logger.info(`[${current}/${total}] ${msg}`);
+	}
+	/**
+	* Emite el título (y subtítulo opcional) como `logger.info`. No pinta
+	* bordes ni separadores — en modo server solo interesa el texto.
+	*
+	* @param {string} title - Texto principal del header.
+	* @param {string} [subtitle] - Subtítulo optativo; se concatena con
+	*   espacio si viene.
+	* @returns {void}
+	*/
+	header(title, subtitle) {
+		const text = subtitle ? `${title} ${subtitle}` : title;
+		this.logger.info(text);
+	}
+	/**
+	* No-op: un divisor visual (`───`) no aporta nada a un log server/JSON
+	* y solo ensuciaría el stream.
+	*
+	* @returns {void}
+	*/
+	divider() {}
+	/**
+	* No-op: las líneas en blanco rompen la consistencia de un log JSON
+	* (cada línea debería ser un registro parseable).
+	*
+	* @returns {void}
+	*/
+	blank() {}
+	/**
+	* Emite el contenido del box como `logger.info`, ignorando bordes y
+	* opciones de estilo (`title`, `borderColor`, ...). En modo server lo
+	* que importa es el payload, no el embalaje.
+	*
+	* @param {string} content - Texto a registrar.
+	* @param {IBoxOptions} [_options] - Opciones de box de la API TTY;
+	*   ignoradas en este fallback.
+	* @returns {void}
+	*/
+	box(content, _options) {
+		this.logger.info(content);
+	}
+	/**
+	* Emite cada fila de la tabla como un `logger.info` con la fila
+	* serializada a JSON, en lugar de pintar una grilla ASCII.
+	*
+	* Cada fila queda como su propio registro JSON — útil para filtrar por
+	* columna en tools como `jq` o Loki. Las opciones de columnas/headers
+	* (`ITableOptions.columns` / `ITableOptions.head`) se ignoran: en modo
+	* server los keys del objeto son la fuente de verdad.
+	*
+	* @param {Record<string, unknown>[]} rows - Filas a emitir.
+	* @param {ITableOptions} [_options] - Opciones de tabla de la API TTY;
+	*   ignoradas en este fallback.
+	* @returns {void}
+	*
+	* @example
+	* ```ts
+	* serverFallback.cliTable([
+	*   { user: 'alice', age: 30 },
+	*   { user: 'bob',   age: 25 }
+	* ]);
+	* // logger.info('{"user":"alice","age":30}')
+	* // logger.info('{"user":"bob","age":25}')
+	* ```
+	*/
+	cliTable(rows, _options) {
+		for (const row of rows) this.logger.info(JSON.stringify(row));
+	}
+};
+//#endregion
+Object.defineProperty(exports, "ServerFallback", {
+	enumerable: true,
+	get: function() {
+		return ServerFallback;
+	}
+});
+
+//# sourceMappingURL=server-fallback-CaCPjWby.cjs.map

package/dist/chunks/server-fallback-CaCPjWby.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fallback-CaCPjWby.cjs","names":[],"sources":["../../src/playground/server-fallback.ts"],"sourcesContent":["/**\n * @fileoverview Server/JSON fallback para CLI primitives en entornos non-TTY.\n *\n * Cuando el logger corre con `outputMode: 'json'` o fuera de una TTY real\n * (CI logs, pipes, redirecciones), los primitives visuales — `step`,\n * `header`, `box`, `cliTable` — no tienen sentido como arte ASCII.\n * {@link ServerFallback} los degrada a llamadas `logger.info` / no-ops\n * conservando el contenido semántico, para que el log siga siendo parseable\n * línea por línea en aggregators centralizados.\n *\n * La factoría vive en `TerminalBridge.getServerFallback()` (lazy-singleton);\n * los consumers no construyen esta clase directamente.\n */\n\nimport type { IBoxOptions, ITableOptions } from '../types/core.js';\nimport type { Logger } from '../Logger.js';\n\n/**\n * Degradación de CLI primitives para modo server/non-TTY.\n *\n * Cada método espeja uno del {@link TerminalBridge} (`step`/`header`/`box`/...)\n * y decide cómo renderizarlo sin depender de caracteres de caja ni control\n * ANSI: texto plano al logger, o no-op cuando no hay nada útil que emitir.\n *\n * @example\n * ```ts\n * // En CI (sin TTY), TerminalBridge enruta automáticamente aquí:\n * logger.step(2, 5, 'Compilando');      // logger.info('[2/5] Compilando')\n * logger.header('Build', 'v1.2.3');     // logger.info('Build v1.2.3')\n * logger.divider();                     // (no-op)\n * ```\n *\n * @see {@link TerminalBridge} para el dispatcher TTY-vs-server.\n */\nexport class ServerFallback {\n    private logger: Logger;\n\n    /**\n     * @param {Logger} logger - Logger sobre el que se emiten los mensajes\n     *   degradados. Respeta el `outputMode` que tenga configurado (json,\n     *   console, ...), por lo que funciona tanto para logs estructurados\n     *   como para texto plano.\n     */\n    constructor(logger: Logger) {\n        this.logger = logger;\n    }\n\n    /**\n     * Emite un step como `logger.info` con el contador `[current/total]`\n     * prefijado al mensaje. Conserva el orden y el progreso sin depender\n     * de caracteres de caja.\n     *\n     * @param {number} current - Índice del step actual (1-based).\n     * @param {number} total - Total de steps del run.\n     * @param {string} msg - Descripción del step.\n     * @returns {void}\n     */\n    step(current: number, total: number, msg: string): void {\n        this.logger.info(`[${current}/${total}] ${msg}`);\n    }\n\n    /**\n     * Emite el título (y subtítulo opcional) como `logger.info`. No pinta\n     * bordes ni separadores — en modo server solo interesa el texto.\n     *\n     * @param {string} title - Texto principal del header.\n     * @param {string} [subtitle] - Subtítulo optativo; se concatena con\n     *   espacio si viene.\n     * @returns {void}\n     */\n    header(title: string, subtitle?: string): void {\n        const text = subtitle ? `${title} ${subtitle}` : title;\n        this.logger.info(text);\n    }\n\n    /**\n     * No-op: un divisor visual (`───`) no aporta nada a un log server/JSON\n     * y solo ensuciaría el stream.\n     *\n     * @returns {void}\n     */\n    divider(): void {\n        // No-op in server/JSON mode\n    }\n\n    /**\n     * No-op: las líneas en blanco rompen la consistencia de un log JSON\n     * (cada línea debería ser un registro parseable).\n     *\n     * @returns {void}\n     */\n    blank(): void {\n        // No-op in server/JSON mode\n    }\n\n    /**\n     * Emite el contenido del box como `logger.info`, ignorando bordes y\n     * opciones de estilo (`title`, `borderColor`, ...). En modo server lo\n     * que importa es el payload, no el embalaje.\n     *\n     * @param {string} content - Texto a registrar.\n     * @param {IBoxOptions} [_options] - Opciones de box de la API TTY;\n     *   ignoradas en este fallback.\n     * @returns {void}\n     */\n    box(content: string, _options?: IBoxOptions): void {\n        this.logger.info(content);\n    }\n\n    /**\n     * Emite cada fila de la tabla como un `logger.info` con la fila\n     * serializada a JSON, en lugar de pintar una grilla ASCII.\n     *\n     * Cada fila queda como su propio registro JSON — útil para filtrar por\n     * columna en tools como `jq` o Loki. Las opciones de columnas/headers\n     * (`ITableOptions.columns` / `ITableOptions.head`) se ignoran: en modo\n     * server los keys del objeto son la fuente de verdad.\n     *\n     * @param {Record<string, unknown>[]} rows - Filas a emitir.\n     * @param {ITableOptions} [_options] - Opciones de tabla de la API TTY;\n     *   ignoradas en este fallback.\n     * @returns {void}\n     *\n     * @example\n     * ```ts\n     * serverFallback.cliTable([\n     *   { user: 'alice', age: 30 },\n     *   { user: 'bob',   age: 25 }\n     * ]);\n     * // logger.info('{\"user\":\"alice\",\"age\":30}')\n     * // logger.info('{\"user\":\"bob\",\"age\":25}')\n     * ```\n     */\n    cliTable(rows: Record<string, unknown>[], _options?: ITableOptions): void {\n        for (const row of rows) {\n            this.logger.info(JSON.stringify(row));\n        }\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkCA,IAAa,iBAAb,MAA4B;CACxB;;;;;;;CAQA,YAAY,QAAgB;EACxB,KAAK,SAAS;CAClB;;;;;;;;;;;CAYA,KAAK,SAAiB,OAAe,KAAmB;EACpD,KAAK,OAAO,KAAK,IAAI,QAAQ,GAAG,MAAM,IAAI,KAAK;CACnD;;;;;;;;;;CAWA,OAAO,OAAe,UAAyB;EAC3C,MAAM,OAAO,WAAW,GAAG,MAAM,GAAG,aAAa;EACjD,KAAK,OAAO,KAAK,IAAI;CACzB;;;;;;;CAQA,UAAgB,CAEhB;;;;;;;CAQA,QAAc,CAEd;;;;;;;;;;;CAYA,IAAI,SAAiB,UAA8B;EAC/C,KAAK,OAAO,KAAK,OAAO;CAC5B;;;;;;;;;;;;;;;;;;;;;;;;;CA0BA,SAAS,MAAiC,UAAgC;EACtE,KAAK,MAAM,OAAO,MACd,KAAK,OAAO,KAAK,KAAK,UAAU,GAAG,CAAC;CAE5C;AACJ"}

package/dist/chunks/server-fallback-jj0T6XaK.js

@@ -0,0 +1,114 @@
+//#region src/playground/server-fallback.ts
+/**
+* Degradación de CLI primitives para modo server/non-TTY.
+*
+* Cada método espeja uno del {@link TerminalBridge} (`step`/`header`/`box`/...)
+* y decide cómo renderizarlo sin depender de caracteres de caja ni control
+* ANSI: texto plano al logger, o no-op cuando no hay nada útil que emitir.
+*
+* @example
+* ```ts
+* // En CI (sin TTY), TerminalBridge enruta automáticamente aquí:
+* logger.step(2, 5, 'Compilando');      // logger.info('[2/5] Compilando')
+* logger.header('Build', 'v1.2.3');     // logger.info('Build v1.2.3')
+* logger.divider();                     // (no-op)
+* ```
+*
+* @see {@link TerminalBridge} para el dispatcher TTY-vs-server.
+*/
+var ServerFallback = class {
+	logger;
+	/**
+	* @param {Logger} logger - Logger sobre el que se emiten los mensajes
+	*   degradados. Respeta el `outputMode` que tenga configurado (json,
+	*   console, ...), por lo que funciona tanto para logs estructurados
+	*   como para texto plano.
+	*/
+	constructor(logger) {
+		this.logger = logger;
+	}
+	/**
+	* Emite un step como `logger.info` con el contador `[current/total]`
+	* prefijado al mensaje. Conserva el orden y el progreso sin depender
+	* de caracteres de caja.
+	*
+	* @param {number} current - Índice del step actual (1-based).
+	* @param {number} total - Total de steps del run.
+	* @param {string} msg - Descripción del step.
+	* @returns {void}
+	*/
+	step(current, total, msg) {
+		this.logger.info(`[${current}/${total}] ${msg}`);
+	}
+	/**
+	* Emite el título (y subtítulo opcional) como `logger.info`. No pinta
+	* bordes ni separadores — en modo server solo interesa el texto.
+	*
+	* @param {string} title - Texto principal del header.
+	* @param {string} [subtitle] - Subtítulo optativo; se concatena con
+	*   espacio si viene.
+	* @returns {void}
+	*/
+	header(title, subtitle) {
+		const text = subtitle ? `${title} ${subtitle}` : title;
+		this.logger.info(text);
+	}
+	/**
+	* No-op: un divisor visual (`───`) no aporta nada a un log server/JSON
+	* y solo ensuciaría el stream.
+	*
+	* @returns {void}
+	*/
+	divider() {}
+	/**
+	* No-op: las líneas en blanco rompen la consistencia de un log JSON
+	* (cada línea debería ser un registro parseable).
+	*
+	* @returns {void}
+	*/
+	blank() {}
+	/**
+	* Emite el contenido del box como `logger.info`, ignorando bordes y
+	* opciones de estilo (`title`, `borderColor`, ...). En modo server lo
+	* que importa es el payload, no el embalaje.
+	*
+	* @param {string} content - Texto a registrar.
+	* @param {IBoxOptions} [_options] - Opciones de box de la API TTY;
+	*   ignoradas en este fallback.
+	* @returns {void}
+	*/
+	box(content, _options) {
+		this.logger.info(content);
+	}
+	/**
+	* Emite cada fila de la tabla como un `logger.info` con la fila
+	* serializada a JSON, en lugar de pintar una grilla ASCII.
+	*
+	* Cada fila queda como su propio registro JSON — útil para filtrar por
+	* columna en tools como `jq` o Loki. Las opciones de columnas/headers
+	* (`ITableOptions.columns` / `ITableOptions.head`) se ignoran: en modo
+	* server los keys del objeto son la fuente de verdad.
+	*
+	* @param {Record<string, unknown>[]} rows - Filas a emitir.
+	* @param {ITableOptions} [_options] - Opciones de tabla de la API TTY;
+	*   ignoradas en este fallback.
+	* @returns {void}
+	*
+	* @example
+	* ```ts
+	* serverFallback.cliTable([
+	*   { user: 'alice', age: 30 },
+	*   { user: 'bob',   age: 25 }
+	* ]);
+	* // logger.info('{"user":"alice","age":30}')
+	* // logger.info('{"user":"bob","age":25}')
+	* ```
+	*/
+	cliTable(rows, _options) {
+		for (const row of rows) this.logger.info(JSON.stringify(row));
+	}
+};
+//#endregion
+export { ServerFallback as t };
+
+//# sourceMappingURL=server-fallback-jj0T6XaK.js.map

package/dist/chunks/server-fallback-jj0T6XaK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fallback-jj0T6XaK.js","names":[],"sources":["../../src/playground/server-fallback.ts"],"sourcesContent":["/**\n * @fileoverview Server/JSON fallback para CLI primitives en entornos non-TTY.\n *\n * Cuando el logger corre con `outputMode: 'json'` o fuera de una TTY real\n * (CI logs, pipes, redirecciones), los primitives visuales — `step`,\n * `header`, `box`, `cliTable` — no tienen sentido como arte ASCII.\n * {@link ServerFallback} los degrada a llamadas `logger.info` / no-ops\n * conservando el contenido semántico, para que el log siga siendo parseable\n * línea por línea en aggregators centralizados.\n *\n * La factoría vive en `TerminalBridge.getServerFallback()` (lazy-singleton);\n * los consumers no construyen esta clase directamente.\n */\n\nimport type { IBoxOptions, ITableOptions } from '../types/core.js';\nimport type { Logger } from '../Logger.js';\n\n/**\n * Degradación de CLI primitives para modo server/non-TTY.\n *\n * Cada método espeja uno del {@link TerminalBridge} (`step`/`header`/`box`/...)\n * y decide cómo renderizarlo sin depender de caracteres de caja ni control\n * ANSI: texto plano al logger, o no-op cuando no hay nada útil que emitir.\n *\n * @example\n * ```ts\n * // En CI (sin TTY), TerminalBridge enruta automáticamente aquí:\n * logger.step(2, 5, 'Compilando');      // logger.info('[2/5] Compilando')\n * logger.header('Build', 'v1.2.3');     // logger.info('Build v1.2.3')\n * logger.divider();                     // (no-op)\n * ```\n *\n * @see {@link TerminalBridge} para el dispatcher TTY-vs-server.\n */\nexport class ServerFallback {\n    private logger: Logger;\n\n    /**\n     * @param {Logger} logger - Logger sobre el que se emiten los mensajes\n     *   degradados. Respeta el `outputMode` que tenga configurado (json,\n     *   console, ...), por lo que funciona tanto para logs estructurados\n     *   como para texto plano.\n     */\n    constructor(logger: Logger) {\n        this.logger = logger;\n    }\n\n    /**\n     * Emite un step como `logger.info` con el contador `[current/total]`\n     * prefijado al mensaje. Conserva el orden y el progreso sin depender\n     * de caracteres de caja.\n     *\n     * @param {number} current - Índice del step actual (1-based).\n     * @param {number} total - Total de steps del run.\n     * @param {string} msg - Descripción del step.\n     * @returns {void}\n     */\n    step(current: number, total: number, msg: string): void {\n        this.logger.info(`[${current}/${total}] ${msg}`);\n    }\n\n    /**\n     * Emite el título (y subtítulo opcional) como `logger.info`. No pinta\n     * bordes ni separadores — en modo server solo interesa el texto.\n     *\n     * @param {string} title - Texto principal del header.\n     * @param {string} [subtitle] - Subtítulo optativo; se concatena con\n     *   espacio si viene.\n     * @returns {void}\n     */\n    header(title: string, subtitle?: string): void {\n        const text = subtitle ? `${title} ${subtitle}` : title;\n        this.logger.info(text);\n    }\n\n    /**\n     * No-op: un divisor visual (`───`) no aporta nada a un log server/JSON\n     * y solo ensuciaría el stream.\n     *\n     * @returns {void}\n     */\n    divider(): void {\n        // No-op in server/JSON mode\n    }\n\n    /**\n     * No-op: las líneas en blanco rompen la consistencia de un log JSON\n     * (cada línea debería ser un registro parseable).\n     *\n     * @returns {void}\n     */\n    blank(): void {\n        // No-op in server/JSON mode\n    }\n\n    /**\n     * Emite el contenido del box como `logger.info`, ignorando bordes y\n     * opciones de estilo (`title`, `borderColor`, ...). En modo server lo\n     * que importa es el payload, no el embalaje.\n     *\n     * @param {string} content - Texto a registrar.\n     * @param {IBoxOptions} [_options] - Opciones de box de la API TTY;\n     *   ignoradas en este fallback.\n     * @returns {void}\n     */\n    box(content: string, _options?: IBoxOptions): void {\n        this.logger.info(content);\n    }\n\n    /**\n     * Emite cada fila de la tabla como un `logger.info` con la fila\n     * serializada a JSON, en lugar de pintar una grilla ASCII.\n     *\n     * Cada fila queda como su propio registro JSON — útil para filtrar por\n     * columna en tools como `jq` o Loki. Las opciones de columnas/headers\n     * (`ITableOptions.columns` / `ITableOptions.head`) se ignoran: en modo\n     * server los keys del objeto son la fuente de verdad.\n     *\n     * @param {Record<string, unknown>[]} rows - Filas a emitir.\n     * @param {ITableOptions} [_options] - Opciones de tabla de la API TTY;\n     *   ignoradas en este fallback.\n     * @returns {void}\n     *\n     * @example\n     * ```ts\n     * serverFallback.cliTable([\n     *   { user: 'alice', age: 30 },\n     *   { user: 'bob',   age: 25 }\n     * ]);\n     * // logger.info('{\"user\":\"alice\",\"age\":30}')\n     * // logger.info('{\"user\":\"bob\",\"age\":25}')\n     * ```\n     */\n    cliTable(rows: Record<string, unknown>[], _options?: ITableOptions): void {\n        for (const row of rows) {\n            this.logger.info(JSON.stringify(row));\n        }\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkCA,IAAa,iBAAb,MAA4B;CACxB;;;;;;;CAQA,YAAY,QAAgB;EACxB,KAAK,SAAS;CAClB;;;;;;;;;;;CAYA,KAAK,SAAiB,OAAe,KAAmB;EACpD,KAAK,OAAO,KAAK,IAAI,QAAQ,GAAG,MAAM,IAAI,KAAK;CACnD;;;;;;;;;;CAWA,OAAO,OAAe,UAAyB;EAC3C,MAAM,OAAO,WAAW,GAAG,MAAM,GAAG,aAAa;EACjD,KAAK,OAAO,KAAK,IAAI;CACzB;;;;;;;CAQA,UAAgB,CAEhB;;;;;;;CAQA,QAAc,CAEd;;;;;;;;;;;CAYA,IAAI,SAAiB,UAA8B;EAC/C,KAAK,OAAO,KAAK,OAAO;CAC5B;;;;;;;;;;;;;;;;;;;;;;;;;CA0BA,SAAS,MAAiC,UAAgC;EACtE,KAAK,MAAM,OAAO,MACd,KAAK,OAAO,KAAK,KAAK,UAAU,GAAG,CAAC;CAE5C;AACJ"}