🌽 @codecorn/corn-logger

🧠 Logger TypeScript avanzato per Node.js con supporto a colori, salvataggio su file, sub-contesto e livello log.
Colori, contesto, stack trace, log file, livelli e supporto a .env. Basato su console-log-colors e ottimizzato per ambienti CLI/DevOps.

---

🚀 Installazione

npm install @codecorn/corn-logger

oppure con yarn:

yarn add @codecorn/corn-logger

⚠️ Il logger legge automaticamente variabili da .env se presenti (dotenv.config() è incluso).

---

✨ Funzionalità

• ✅ Log colorati con contesto e sub-contesto
• ✅ Livelli: DEBUG, INFO, WARN, ERROR
• ✅ Logging condizionale su file (process.env.LOG_STORE=true)
• ✅ Supporto a stack trace errori
• ✅ Pretty-print JSON e oggetti complessi
• ✅ Time e date IT friendly (dd/MM/yyyy HH:mm:ss)

---

🔧 Setup base

// index.ts o bootstrap
import * as dotenv from 'dotenv';
dotenv.config();

import { logInfo, logError, logWarn, logDebug, logMessage } from '@codecorn/corn-logger';

logMessage('DEBUG', 'BOOT', 'Logger pronto 🚀');
logInfo('MAIN', 'Tutto ok');
logWarn('INIT', { warning: 'config mancante' });
logError('DB', new Error('Connessione fallita'), 'DBConnect');
logDebug('SERVICE', { id: 123, state: 'running' }, 'JobRunner');

---

🔥 Esempi

logInfo('SERVER', 'Server avviato sulla porta 3000');

logWarn('DB', 'Connessione lenta rilevata', 'Postgres');

logError('API', new Error('Endpoint fallito'), 'GET /api/user');

logDebug('AUTH', { user: 'admin', role: 'superuser' }, 'SessionPayload');

Tutti i log vengono stampati in console colorata e salvati in logs/YYYY-MM-DD.log se LOG_STORE=true.

---

⚙️ Variabili .env e 📦 Logger su File

Per abilitare la scrittura su file nella directory logs/:

LOG_STORE=true
LOG_DIR=test_log

Se LOG_STORE=true, ogni log sarà anche salvato in file logs/YYYY-MM-DD.log.

Output nel formato:

[2025-08-05 14:33:05] [SERVICE] DEBUG > JobRunner:
{ id: 123, state: 'running' }

---

✨ Features

• ✅ Colorazione ANSI per ogni livello log
• ✅ Sub-context support (logError(context, err, subContext))
• ✅ Supporto a Error, object, string, null, undefined
• ✅ Salvataggio su file con timestamp (LOG_STORE=true)
• ✅ Estendibile e minimalista

---

🔧 Scripts utili

Nel tuo package.json:

"scripts": {
  "build": "tsc",
  "dev": "tsc --watch",
  "lint": "tsc --noEmit",
  "prepare": "npm run build"
}

---

🗂 Struttura progetto

corn-logger/
├── dist/              # Build finale JS
├── src/               # Codice sorgente TS
├── types/             # Tipi definiti
├── index.ts           # Entry point
├── index.ts           # Cli script
├── .env               # (opzionale)
├── .npmignore
├── package.json
├── README.md
├── LICENSE
└── tsconfig.json

---

🛠 Integrazione CLI (facoltativa)

Puoi usare il logger anche direttamente da terminale in diversi modi:

✅ 1. Esecuzione diretta con npx

npx cornlog --context "SYSTEM" --level info --message "Avvio completato"

---

✅ 2. Esecuzione tramite npm run

Usa lo script definito nel tuo package.json:

npm run cli -- -c SYSTEM -l info -m "Avvio completato"

Attenzione al doppio --: serve per passare argomenti al comando CLI.

---

✅ 3. Esecuzione via npm link (globale)

Se hai eseguito:

npm run build
npm link

Puoi usare direttamente il comando globale ovunque nel sistema:

cornlog -c SYSTEM -l info -m "Avvio completato"

---

🎯 Altri esempi CLI

cornlog -c DB -l warn -m "Query lenta" -s "postgres"
cornlog -c API -l error -m "Token non valido" -s "AuthMiddleware"
cornlog -c JOB -l debug -m "Task schedulato" -s "cron-runner"
cornlog -c INIT -l info -m "Configurazione caricata"

I log verranno colorati e stampati a terminale. Se LOG_STORE=true nel tuo .env, verranno anche salvati in logs/YYYY-MM-DD.log.

---

📖 Guida rapida CLI (--help)

Per vedere tutte le opzioni disponibili della CLI, puoi usare:

cornlog --help

Output:

Usage: cornlog [options]

🧠 Logger CLI CodeCorn - log colorato e opzionale su file

Options:
  -c, --context <context>     Contesto del log (es: SYSTEM, DB, API) [obbligatorio]
  -l, --level <level>         Livello log: info | warn | error | debug [obbligatorio]
  -m, --message <message>     Messaggio da loggare [obbligatorio]
  -s, --sub <subContext>      Sotto-contesto opzionale
  -V, --version               Mostra versione
  -h, --help                  Mostra questo aiuto

⚠️ Tutte le opzioni marcate come obbligatorie devono essere specificate, altrimenti la CLI restituirà un errore.

---

🧪 Test

npm run lint
npm test

---

👤 Maintainer

👨‍💻 Federico Girolami

Full Stack Developer | System Integrator | Digital Solution Architect 🚀

📫 Get in Touch

🌐 Website: codecorn.it *(Under Construction)*

📧 Email: f.girolami@codecorn.it

🐙 GitHub: github.com/fgirolami29

---

📝 License

MIT © CodeCorn™

Distribuito sotto licenza MIT.

---

🤝 Contribuisci

Pull request benvenute. Per grosse modifiche apri una issue prima di iniziare.

Powered by CodeCorn™ 🚀