syntropylog 0.9.13 → 0.9.15

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.9.15
+
+### Patch Changes
+
+- **Built-in ANSI colors: remove chalk dependency**
+  - Pretty console transports (Classic, Pretty, Compact, Colorful) now use a built-in chalk-like API implemented with ANSI escape codes. No chalk peer dependency.
+  - Colors are disabled when `NO_COLOR` is set or when stdout is not a TTY (pipes, CI). Same format is logged in plain text in those cases.
+  - README updated: no `npm install chalk`; colours described as built-in ANSI.
+
+## 0.9.14
+
+### Patch Changes
+
+- **Chalk optional for pretty console transports (Classic, Pretty, Compact, Colorful)**
+  - **Fix**: `ClassicConsoleTransport` (and other chalk-powered transports) now work in both ESM (tsx + `"type": "module"`) and CJS (e.g. ts-node) consumers. Chalk is loaded optionally via a small helper that uses `require` in CJS and `createRequire(import.meta.url)` in ESM; if chalk is missing or fails to load, a no-op is used so the same format is logged without colors.
+  - **README**: Clarified that chalk is optional — install it for colors, or use the same transports without it for plain-text output. Table updated to show "With chalk" / "Without chalk" and added ColorfulConsoleTransport.
+
 ## 0.9.13
 
 ### Patch Changes

package/CONTRIBUTING.md

@@ -88,13 +88,21 @@ We welcome code contributions! To contribute code, please follow these steps:
 
 ## Release process (maintainers)
 
-Releases use [Changesets](https://github.com/changesets/changesets) and GitHub Actions:
+Releases use [Changesets](https://github.com/changesets/changesets) and GitHub Actions. **Para que la versión suba en npm, siempre tienes que hacer una de estas dos cosas:**
 
-1. **Add a changeset** when changing the library: `pnpm changeset` (choose version type and describe the change).
-2. **Push to `main`** (or merge a PR that includes the changeset). The Release workflow runs and:
-   - Creates a **"Version Packages"** PR with the version bump (e.g. 0.9.12 → 0.9.13) and CHANGELOG updates.
-   - **Publishes to npm** from that same run (so npm may already have the new version).
-3. **Merge the "Version Packages" PR** into `main`. This step is required so that `main` has the same `package.json` version and CHANGELOG as what was published to npm. If you skip it, `main` will stay on the old version while npm has the new one.
+### Opción A: Usar el PR que crea el action
+
+1. **Añade un changeset** al cambiar la librería: `pnpm changeset` (elige tipo de versión y describe el cambio).
+2. **Push a `main`**. El workflow crea un PR **"Version Packages"** con el bump (ej. 0.9.12 → 0.9.13) y el CHANGELOG actualizado. **Todavía no publica en npm.**
+3. **Mergea ese PR** en `main`. Ese merge vuelve a disparar el workflow y **ahí sí** se ejecuta `publish` y la nueva versión aparece en npm.
+
+### Opción B: Subir la versión a mano (sin PR)
+
+1. Con changesets ya en el repo, en local: `pnpm run version-packages`. Eso actualiza `package.json`, CHANGELOG y borra los changesets.
+2. **Commit** (package.json, CHANGELOG.md, y los .changeset/*.md borrados) y **push a `main`**.
+3. El workflow corre, no hay changesets que aplicar, y ejecuta **publish** → la versión sube a npm.
+
+En ambos casos, **main** y **npm** quedan con la misma versión.
 
 ## Getting Help
 

package/README.md

@@ -73,24 +73,21 @@ npm install syntropylog
 
 By default, SyntropyLog outputs **lightweight plain JSON to the console — automatically, with no configuration needed**. No imports, no setup, no extra dependencies.
 
-If you want **colored, human-readable output** for development, use one of the chalk-powered transports. These require `chalk` to be installed explicitly in your project to keep the base bundle small:
+If you want **colored, human-readable output** for development, use one of the pretty console transports. Colours use **built-in ANSI codes** (no chalk or extra dependency). When stdout is a TTY you get colours; when piping or in CI, or if `NO_COLOR` is set, the same format is shown in plain text.
 
-```bash
-npm install chalk
-```
-
-| Transport | Style | Color | Recommended for |
-| :--- | :--- | :---: | :--- |
-| *(default)* | Plain JSON | ❌ | Production / log aggregators |
-| `ClassicConsoleTransport` | Structured + colored | ✅ | Development |
-| `PrettyConsoleTransport` | Human-readable pretty print | ✅ | Development / debugging |
-| `CompactConsoleTransport` | Compact one-liner | ✅ | Development |
+| Transport | Style | Recommended for |
+| :--- | :--- | :--- |
+| *(default)* | Plain JSON | Production / log aggregators |
+| `ClassicConsoleTransport` | Structured single-line, colored | Development |
+| `PrettyConsoleTransport` | Human-readable pretty, colored | Development / debugging |
+| `CompactConsoleTransport` | Compact one-liner, colored | Development |
+| `ColorfulConsoleTransport` | Full-line colored | Development |
 
 ```typescript
 // Default — no import needed, works out of the box
 syntropyLog.init({ logger: { level: 'info', serviceName: 'my-app' } });
 
-// Want colors? Install chalk first, then import the transport:
+// Pretty + colors (built-in ANSI; no extra deps)
 import { ClassicConsoleTransport } from 'syntropylog';
 
 syntropyLog.init({

package/dist/index.cjs

@@ -7,7 +7,6 @@ var node_async_hooks = require('node:async_hooks');
 var crypto = require('crypto');
 var util = require('node:util');
 var flatted = require('flatted');
-var chalk = require('chalk');
 var redis = require('redis');
 
 function _interopNamespaceDefault(e) {
@@ -2554,9 +2553,68 @@ class SyntropyLog extends events.EventEmitter {
 const syntropyLog = SyntropyLog.getInstance();
 
 /**
- * @file src/logger/transports/BaseConsolePrettyTransport.ts
- * @description An abstract base class for console transports that provide colored, human-readable output.
+ * @file src/logger/transports/optionalChalk.ts
+ * @description Built-in chalk-like API using ANSI escape codes. No chalk dependency.
+ * Used by ClassicConsoleTransport, PrettyConsoleTransport, CompactConsoleTransport, ColorfulConsoleTransport.
  */
+const RESET = '\x1b[0m';
+function wrap(s, codes) {
+    if (codes.length === 0)
+        return s;
+    return `\x1b[${codes.join(';')}m${s}${RESET}`;
+}
+function createChain(codes) {
+    const fn = ((s) => wrap(s, codes));
+    const add = (code) => createChain([...codes, code]);
+    fn.white = add(37);
+    fn.bold = add(1);
+    fn.red = add(31);
+    fn.bgRed = add(41);
+    fn.yellow = add(33);
+    fn.cyan = add(36);
+    fn.green = add(32);
+    fn.gray = add(90);
+    fn.magenta = add(35);
+    fn.blue = add(34);
+    fn.bgWhite = add(47);
+    fn.dim = add(2);
+    return fn;
+}
+let cached = null;
+/**
+ * Returns a chalk-like instance using built-in ANSI colors. No external chalk dependency.
+ * Respects NO_COLOR and disables colors when stdout is not a TTY (e.g. pipes, CI).
+ */
+function getOptionalChalk() {
+    if (cached !== null) {
+        return cached;
+    }
+    const noColor = process.env.NO_COLOR !== undefined &&
+        process.env.NO_COLOR !== '' &&
+        process.env.NO_COLOR !== '0';
+    const isTTY = typeof process.stdout?.isTTY === 'boolean' && process.stdout.isTTY;
+    if (noColor || !isTTY) {
+        const identity = ((s) => s);
+        identity.white = identity;
+        identity.bold = identity;
+        identity.red = identity;
+        identity.bgRed = identity;
+        identity.yellow = identity;
+        identity.cyan = identity;
+        identity.green = identity;
+        identity.gray = identity;
+        identity.magenta = identity;
+        identity.blue = identity;
+        identity.bgWhite = identity;
+        identity.dim = identity;
+        cached = identity;
+    }
+    else {
+        cached = createChain([]);
+    }
+    return cached;
+}
+
 /**
  * @class BaseConsolePrettyTransport
  * @description Provides common functionality for "pretty" console transports,
@@ -2567,8 +2625,7 @@ const syntropyLog = SyntropyLog.getInstance();
 class BaseConsolePrettyTransport extends Transport {
     constructor(options) {
         super(options);
-        // Chalk v4 is used directly, not instantiated.
-        this.chalk = chalk;
+        this.chalk = getOptionalChalk();
     }
     /**
      * The core log method. It handles common logic and delegates specific
@@ -2706,7 +2763,7 @@ class CompactConsoleTransport extends BaseConsolePrettyTransport {
                 // Simple stringify for objects/arrays in metadata.
                 const formattedValue = typeof value === 'object' && value !== null
                     ? JSON.stringify(value)
-                    : value;
+                    : String(value);
                 return `${this.chalk.dim(key)}=${this.chalk.gray(formattedValue)}`;
             })
                 .join(' ');