syntropylog 0.9.13 → 0.9.14

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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,25 @@ 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 (`ClassicConsoleTransport`, `PrettyConsoleTransport`, `CompactConsoleTransport`, `ColorfulConsoleTransport`). **Chalk is optional:** if you install `chalk` in your project, those transports use it and you get colors; if you don't install it, the same format is shown in plain text (no colors). That keeps the base bundle small and avoids CJS/ESM load issues when chalk isn't present.
 
 ```bash
-npm install chalk
+npm install chalk   # optional — only if you want colors
 ```
 
-| 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 | With chalk | Without chalk | Recommended for |
+| :--- | :--- | :---: | :--- | :--- |
+| *(default)* | Plain JSON | — | — | Production / log aggregators |
+| `ClassicConsoleTransport` | Structured single-line | ✅ Colored | Plain text | Development |
+| `PrettyConsoleTransport` | Human-readable pretty | ✅ Colored | Plain text | Development / debugging |
+| `CompactConsoleTransport` | Compact one-liner | ✅ Colored | Plain text | Development |
+| `ColorfulConsoleTransport` | Full-line colored | ✅ Colored | Plain text | 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 format: with chalk → colors; without chalk → same format, no colors
 import { ClassicConsoleTransport } from 'syntropylog';
 
 syntropyLog.init({

package/dist/index.cjs

@@ -7,9 +7,10 @@ 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 module$1 = require('module');
 var redis = require('redis');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
     if (e) {
@@ -2554,9 +2555,59 @@ 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 Load chalk optionally so that pretty console transports work in both
+ * ESM (tsx + "type": "module") and CJS (ts-node) consumers. If chalk is missing or
+ * fails to load, a no-op identity is used (no colors).
  */
+function createNoColorChalk() {
+    const noColor = ((s) => s);
+    noColor.white = noColor;
+    noColor.bold = noColor;
+    noColor.red = noColor;
+    noColor.bgRed = noColor;
+    noColor.yellow = noColor;
+    noColor.cyan = noColor;
+    noColor.green = noColor;
+    noColor.gray = noColor;
+    noColor.magenta = noColor;
+    noColor.blue = noColor;
+    noColor.bgWhite = noColor;
+    noColor.dim = noColor;
+    return noColor;
+}
+function getRequire() {
+    if (typeof require !== 'undefined') {
+        return require;
+    }
+    return module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+}
+function loadChalkSync() {
+    try {
+        const c = getRequire()('chalk');
+        const ch = (c?.default ?? c);
+        if (ch && typeof ch.white !== 'undefined') {
+            return ch;
+        }
+    }
+    catch {
+        // chalk not installed or failed to load (e.g. CJS/ESM interop)
+    }
+    return createNoColorChalk();
+}
+let cached = null;
+/**
+ * Returns a chalk-like instance: real chalk if available and usable, otherwise
+ * a no-op that returns the string unchanged. Safe to call from both ESM and CJS.
+ */
+function getOptionalChalk() {
+    if (cached !== null) {
+        return cached;
+    }
+    cached = loadChalkSync();
+    return cached;
+}
+
 /**
  * @class BaseConsolePrettyTransport
  * @description Provides common functionality for "pretty" console transports,
@@ -2567,8 +2618,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 +2756,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(' ');