@mks2508/better-logger 5.0.0 → 5.0.2

package/playground/demo-all.ts

@@ -1,95 +0,0 @@
-/**
- * Full showcase of every CLI primitive in sequence.
- * Run: bun playground/demo-all.ts
- */
-import { Logger } from '../src/Logger.js';
-import type { CLILogLevel } from '../src/types/index.js';
-
-const logger = new Logger();
-const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
-
-async function main() {
-    // ── Header & Divider ──────────────────────────────
-    logger.header('Better Logger v5', 'CLI Primitives Showcase');
-    logger.divider();
-    logger.blank();
-
-    // ── Steps ─────────────────────────────────────────
-    logger.info('▸ Step progress');
-    for (let i = 1; i <= 5; i++) {
-        logger.step(i, 5, `Processing item ${i}...`);
-        await sleep(200);
-    }
-    logger.blank();
-
-    // ── Box — all border styles ───────────────────────
-    logger.info('▸ Box primitives');
-    logger.blank();
-
-    const styles = ['single', 'rounded', 'double', 'bold'] as const;
-    for (const style of styles) {
-        logger.box(`borderStyle: "${style}"`, {
-            title: style.toUpperCase(),
-            borderStyle: style,
-        });
-        logger.blank();
-    }
-
-    logger.box('Box with custom border color\nand multiline content', {
-        title: 'Colored',
-        borderStyle: 'rounded',
-        borderColor: '#ff6b6b',
-    });
-    logger.blank();
-
-    // ── Table ─────────────────────────────────────────
-    logger.info('▸ CLI Table');
-    logger.blank();
-    logger.cliTable([
-        { provider: 'Gemini SDK', model: 'gemini-2.5-flash', status: 'active' },
-        { provider: 'Groq', model: 'llama-3.3-70b', status: 'active' },
-        { provider: 'OpenRouter', model: 'claude-sonnet-4', status: 'fallback' },
-        { provider: 'Gemini CLI', model: 'default', status: 'inactive' },
-    ]);
-    logger.blank();
-
-    // ── Spinner — succeed ─────────────────────────────
-    logger.info('▸ Spinner (succeed)');
-    const s1 = logger.spinner('Loading configuration...');
-    s1.start();
-    await sleep(1000);
-    s1.text('Almost done...');
-    await sleep(600);
-    s1.succeed('Configuration loaded');
-    logger.blank();
-
-    // ── Spinner — fail ────────────────────────────────
-    logger.info('▸ Spinner (fail)');
-    const s2 = logger.spinner('Connecting to remote...');
-    s2.start();
-    await sleep(800);
-    s2.fail('Connection timed out');
-    logger.blank();
-
-    // ── setCLILevel ───────────────────────────────────
-    logger.info('▸ setCLILevel demo');
-    logger.blank();
-
-    logger.setCLILevel('quiet');
-    logger.info('  [quiet] This box should NOT appear:');
-    logger.box('You should not see this', { title: 'Hidden' });
-
-    logger.setCLILevel('normal');
-    logger.box('CLI level restored to normal', {
-        title: 'Visible Again',
-        borderStyle: 'rounded',
-        borderColor: '#00ff00',
-    });
-    logger.blank();
-
-    // ── Done ──────────────────────────────────────────
-    logger.divider();
-    logger.header('Showcase Complete');
-}
-
-main().catch(console.error);

package/playground/demo-box.ts

@@ -1,85 +0,0 @@
-/**
- * Box primitive — all border styles, colors, titles, multiline.
- * Run: bun playground/demo-box.ts
- */
-import { Logger } from '../src/Logger.js';
-
-const logger = new Logger();
-
-function main() {
-    logger.header('Box Demos');
-    logger.divider();
-    logger.blank();
-
-    // ── Each border style ─────────────────────────────
-    logger.info('1. Border styles');
-    logger.blank();
-
-    logger.box('Single border style', { borderStyle: 'single', title: 'single' });
-    logger.blank();
-
-    logger.box('Rounded border style (default)', { borderStyle: 'rounded', title: 'rounded' });
-    logger.blank();
-
-    logger.box('Double border style', { borderStyle: 'double', title: 'double' });
-    logger.blank();
-
-    logger.box('Bold border style', { borderStyle: 'bold', title: 'bold' });
-    logger.blank();
-
-    // ── With / without title ──────────────────────────
-    logger.info('2. Title variations');
-    logger.blank();
-
-    logger.box('This box has a title above', { title: 'With Title' });
-    logger.blank();
-
-    logger.box('This box has no title');
-    logger.blank();
-
-    // ── Border colors ─────────────────────────────────
-    logger.info('3. Border colors');
-    logger.blank();
-
-    logger.box('Red border', { title: 'Error', borderColor: '#ff4444', borderStyle: 'bold' });
-    logger.blank();
-
-    logger.box('Green border', { title: 'Success', borderColor: '#00cc66', borderStyle: 'rounded' });
-    logger.blank();
-
-    logger.box('Blue border', { title: 'Info', borderColor: '#4488ff', borderStyle: 'double' });
-    logger.blank();
-
-    logger.box('Yellow border', { title: 'Warning', borderColor: '#ffaa00', borderStyle: 'single' });
-    logger.blank();
-
-    // ── Multiline content ─────────────────────────────
-    logger.info('4. Multiline content');
-    logger.blank();
-
-    logger.box(
-        [
-            'feat(providers): add multi-provider AI support',
-            '',
-            'Added Gemini SDK, Groq, and OpenRouter providers',
-            'with automatic detection and fallback chain.',
-        ].join('\n'),
-        { title: 'Commit #1', borderStyle: 'rounded', borderColor: '#ff6b6b' },
-    );
-    logger.blank();
-
-    // ── Long content ──────────────────────────────────
-    logger.info('5. Long single-line content');
-    logger.blank();
-
-    logger.box(
-        'This is a very long line of text that should demonstrate how the box renderer handles content that extends beyond a typical terminal width to verify wrapping or truncation behavior.',
-        { title: 'Long Content', borderStyle: 'rounded' },
-    );
-    logger.blank();
-
-    logger.divider();
-    logger.info('Box demos complete.');
-}
-
-main();

package/playground/demo-levels.ts

@@ -1,56 +0,0 @@
-/**
- * setCLILevel() toggling: silent → quiet → normal → verbose.
- * Run: bun playground/demo-levels.ts
- */
-import { Logger } from '../src/Logger.js';
-import type { CLILogLevel } from '../src/types/index.js';
-
-const logger = new Logger();
-
-function demonstrateLevel(level: CLILogLevel) {
-    logger.setCLILevel(level);
-    process.stderr.write(`\n── setCLILevel('${level}') ──\n`);
-
-    // Try each primitive
-    logger.header('Header', 'subtitle');
-    logger.divider();
-    logger.step(1, 3, 'Step message');
-    logger.box('Box content', { title: 'Box', borderStyle: 'rounded' });
-    logger.cliTable([{ key: 'value', status: 'ok' }]);
-    logger.blank();
-
-    // Also test regular log methods
-    logger.info('info message');
-    logger.warn('warn message');
-    logger.error('error message');
-
-    process.stderr.write(`── end '${level}' ──\n`);
-}
-
-function main() {
-    // Start with a visible header
-    logger.setCLILevel('normal');
-    logger.header('CLI Level Demos');
-    logger.divider();
-
-    logger.info('Each level sets verbosity + primitive visibility:');
-    logger.info('  silent  → no output at all');
-    logger.info('  quiet   → errors only, primitives hidden');
-    logger.info('  normal  → info+, primitives visible');
-    logger.info('  verbose → debug+, primitives visible');
-    logger.blank();
-
-    // Demonstrate each level
-    const levels: CLILogLevel[] = ['silent', 'quiet', 'normal', 'verbose'];
-    for (const level of levels) {
-        demonstrateLevel(level);
-    }
-
-    // Restore to normal
-    logger.setCLILevel('normal');
-    logger.blank();
-    logger.divider();
-    logger.info('Level demos complete. Restored to "normal".');
-}
-
-main();

package/playground/demo-real-world.ts

@@ -1,98 +0,0 @@
-/**
- * Real-world simulation: a commit-wizard-like CLI workflow.
- * Run: bun playground/demo-real-world.ts
- */
-import { Logger } from '../src/Logger.js';
-
-const logger = new Logger();
-const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
-
-async function main() {
-    // ── Startup ───────────────────────────────────────
-    logger.header('Commit Wizard', 'v2.0.0');
-    logger.divider();
-    logger.blank();
-
-    // ── Step 1: Analyze repository ────────────────────
-    logger.step(1, 5, 'Analyzing repository...');
-    const s1 = logger.spinner('Loading git diff...');
-    s1.start();
-    await sleep(1200);
-    s1.succeed('3 files changed, 47 insertions, 12 deletions');
-    logger.blank();
-
-    // ── Step 2: Detect provider ───────────────────────
-    logger.step(2, 5, 'Detecting provider...');
-    await sleep(300);
-
-    logger.cliTable([
-        { provider: 'Gemini SDK', key: 'GEMINI_API_KEY', status: 'not set' },
-        { provider: 'Groq', key: 'GROQ_API_KEY', status: 'found ✓' },
-        { provider: 'OpenRouter', key: 'OPENROUTER_API_KEY', status: 'not set' },
-        { provider: 'Gemini CLI', key: 'binary', status: 'not found' },
-    ]);
-    logger.blank();
-    logger.info('  Using provider: Groq (llama-3.3-70b-versatile)');
-    logger.blank();
-
-    // ── Step 3: Generate commit ───────────────────────
-    logger.step(3, 5, 'Generating commit message...');
-    const s3 = logger.spinner('AI thinking...');
-    s3.start();
-    await sleep(800);
-    s3.text('Analyzing diff patterns...');
-    await sleep(600);
-    s3.text('Composing message...');
-    await sleep(600);
-    s3.succeed('Commit message generated');
-    logger.blank();
-
-    logger.box(
-        [
-            'feat(providers): add multi-provider AI support',
-            '',
-            'Implement Gemini SDK, Groq, and OpenRouter providers',
-            'with automatic detection based on available API keys.',
-            '',
-            '<technical>',
-            '- Added GeminiSdkProvider, GroqProvider, OpenRouterProvider classes',
-            '- Factory function with priority-based auto-detection',
-            '- Shared IAIProvider interface for all implementations',
-            '</technical>',
-            '',
-            '<changelog>',
-            '## Feature 🚀',
-            'Multi-provider AI support with automatic fallback',
-            '</changelog>',
-        ].join('\n'),
-        { title: 'Commit #1', borderStyle: 'rounded', borderColor: '#ff6b6b' },
-    );
-    logger.blank();
-
-    // ── Step 4: Apply commit ──────────────────────────
-    logger.step(4, 5, 'Applying commit...');
-    const s4 = logger.spinner('Running git commit...');
-    s4.start();
-    await sleep(800);
-    s4.succeed('Commit applied: abc1234');
-    logger.blank();
-
-    // ── Step 5: Done ──────────────────────────────────
-    logger.step(5, 5, 'Done');
-    logger.blank();
-
-    logger.box(
-        [
-            '1 commit applied successfully',
-            '',
-            'Provider: Groq',
-            'Model:    llama-3.3-70b-versatile',
-            'Time:     2.4s',
-        ].join('\n'),
-        { title: 'Summary', borderStyle: 'rounded', borderColor: '#00ff00' },
-    );
-    logger.blank();
-    logger.divider();
-}
-
-main().catch(console.error);

package/playground/demo-spinner.ts

@@ -1,77 +0,0 @@
-/**
- * Spinner lifecycle: start, text update, succeed/fail.
- * Run: bun playground/demo-spinner.ts
- */
-import { Logger } from '../src/Logger.js';
-
-const logger = new Logger();
-const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
-
-async function main() {
-    logger.header('Spinner Demos');
-    logger.divider();
-    logger.blank();
-
-    // ── Basic spinner → succeed ───────────────────────
-    logger.info('1. Basic spinner with succeed');
-    const s1 = logger.spinner('Installing dependencies...');
-    s1.start();
-    await sleep(1500);
-    s1.succeed('Dependencies installed');
-    logger.blank();
-
-    // ── Spinner with text() update ────────────────────
-    logger.info('2. Spinner with text update');
-    const s2 = logger.spinner('Downloading package 1/3...');
-    s2.start();
-    await sleep(800);
-    s2.text('Downloading package 2/3...');
-    await sleep(800);
-    s2.text('Downloading package 3/3...');
-    await sleep(800);
-    s2.succeed('All packages downloaded');
-    logger.blank();
-
-    // ── Spinner → fail ────────────────────────────────
-    logger.info('3. Spinner with fail');
-    const s3 = logger.spinner('Connecting to database...');
-    s3.start();
-    await sleep(1200);
-    s3.fail('Connection refused on port 5432');
-    logger.blank();
-
-    // ── Multiple sequential spinners ──────────────────
-    logger.info('4. Sequential spinners');
-    const tasks = [
-        'Compiling TypeScript...',
-        'Running linter...',
-        'Building bundles...',
-        'Generating types...',
-    ];
-    for (const task of tasks) {
-        const s = logger.spinner(task);
-        s.start();
-        await sleep(700);
-        s.succeed();
-    }
-    logger.blank();
-
-    // ── Spinner concurrent with logger.info ───────────
-    logger.info('5. Spinner with interleaved log messages');
-    const s5 = logger.spinner('Processing files...');
-    s5.start();
-    await sleep(400);
-    logger.info('  Found 42 files');
-    await sleep(400);
-    logger.info('  Processed batch 1');
-    await sleep(400);
-    logger.info('  Processed batch 2');
-    await sleep(400);
-    s5.succeed('All files processed');
-    logger.blank();
-
-    logger.divider();
-    logger.info('Spinner demos complete.');
-}
-
-main().catch(console.error);

package/playground/demo-steps.ts

@@ -1,72 +0,0 @@
-/**
- * Step progress walkthrough with simulated work delays.
- * Run: bun playground/demo-steps.ts
- */
-import { Logger } from '../src/Logger.js';
-
-const logger = new Logger();
-const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
-
-async function main() {
-    logger.header('Step Progress Demos');
-    logger.divider();
-    logger.blank();
-
-    // ── Basic step sequence ───────────────────────────
-    logger.info('1. Basic step sequence');
-    logger.blank();
-
-    const steps = [
-        'Reading configuration...',
-        'Validating schema...',
-        'Compiling sources...',
-        'Running tests...',
-        'Generating output...',
-    ];
-
-    for (let i = 0; i < steps.length; i++) {
-        logger.step(i + 1, steps.length, steps[i]);
-        await sleep(300);
-    }
-    logger.blank();
-
-    // ── Steps combined with spinners ──────────────────
-    logger.info('2. Steps with spinners');
-    logger.blank();
-
-    logger.step(1, 3, 'Fetching remote data');
-    const s1 = logger.spinner('Downloading manifest...');
-    s1.start();
-    await sleep(1000);
-    s1.succeed('Manifest downloaded (2.3 KB)');
-
-    logger.step(2, 3, 'Processing data');
-    const s2 = logger.spinner('Parsing JSON...');
-    s2.start();
-    await sleep(600);
-    s2.text('Validating entries...');
-    await sleep(600);
-    s2.succeed('42 entries validated');
-
-    logger.step(3, 3, 'Writing output');
-    const s3 = logger.spinner('Generating report...');
-    s3.start();
-    await sleep(800);
-    s3.succeed('Report saved to ./output/report.json');
-    logger.blank();
-
-    // ── Many steps ────────────────────────────────────
-    logger.info('3. Long step sequence (10 steps)');
-    logger.blank();
-
-    for (let i = 1; i <= 10; i++) {
-        logger.step(i, 10, `Migration step ${i}`);
-        await sleep(150);
-    }
-    logger.blank();
-
-    logger.divider();
-    logger.info('Step demos complete.');
-}
-
-main().catch(console.error);

package/playground/demo-table.ts

@@ -1,83 +0,0 @@
-/**
- * CLI table — various column counts, auto-width, explicit columns.
- * Run: bun playground/demo-table.ts
- */
-import { Logger } from '../src/Logger.js';
-
-const logger = new Logger();
-
-function main() {
-    logger.header('Table Demos');
-    logger.divider();
-    logger.blank();
-
-    // ── Auto-detect columns from data ─────────────────
-    logger.info('1. Auto-detected columns');
-    logger.blank();
-
-    logger.cliTable([
-        { name: 'Gemini SDK', version: '1.0.0', status: 'active' },
-        { name: 'Groq SDK', version: '0.8.2', status: 'active' },
-        { name: 'OpenRouter', version: '2.1.0', status: 'fallback' },
-    ]);
-    logger.blank();
-
-    // ── Explicit columns via options ──────────────────
-    logger.info('2. Explicit columns (subset)');
-    logger.blank();
-
-    logger.cliTable(
-        [
-            { id: 1, name: 'Alice', email: 'alice@example.com', role: 'admin' },
-            { id: 2, name: 'Bob', email: 'bob@example.com', role: 'user' },
-            { id: 3, name: 'Charlie', email: 'charlie@example.com', role: 'user' },
-        ],
-        { columns: ['name', 'role'] },
-    );
-    logger.blank();
-
-    // ── Various value lengths ─────────────────────────
-    logger.info('3. Mixed value lengths');
-    logger.blank();
-
-    logger.cliTable([
-        { key: 'a', value: 'short' },
-        { key: 'longer-key-name', value: 'This is a much longer value to test column sizing' },
-        { key: 'b', value: '42' },
-    ]);
-    logger.blank();
-
-    // ── Numeric and boolean values ────────────────────
-    logger.info('4. Numeric and boolean values');
-    logger.blank();
-
-    logger.cliTable([
-        { metric: 'Requests/sec', value: 12500, healthy: true },
-        { metric: 'Avg latency', value: 23.4, healthy: true },
-        { metric: 'Error rate', value: 0.02, healthy: true },
-        { metric: 'Memory (MB)', value: 512, healthy: false },
-    ]);
-    logger.blank();
-
-    // ── Many columns ──────────────────────────────────
-    logger.info('5. Many columns');
-    logger.blank();
-
-    logger.cliTable([
-        { col1: 'A', col2: 'B', col3: 'C', col4: 'D', col5: 'E', col6: 'F' },
-        { col1: '1', col2: '2', col3: '3', col4: '4', col5: '5', col6: '6' },
-    ]);
-    logger.blank();
-
-    // ── Single row ────────────────────────────────────
-    logger.info('6. Single row');
-    logger.blank();
-
-    logger.cliTable([{ provider: 'Gemini SDK', model: 'gemini-2.5-flash', latency: '120ms' }]);
-    logger.blank();
-
-    logger.divider();
-    logger.info('Table demos complete.');
-}
-
-main();