@sploov/trace 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sploov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+# 🔍 Trace
+
+[![npm version](https://img.shields.io/npm/v/@sploov/trace.svg?style=flat-square)](https://www.npmjs.com/package/@sploov/trace)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
+
+> **Execution flow, made visible.**
+
+Trace is a lightweight, high-performance tracing and flow-visualization library for Node.js. Designed for developers who need to understand exactly what happens inside their async operations without the overhead of a full APM.
+
+---
+
+## ✨ Features
+
+- 🚀 **Zero-Overhead Async Tracking**: Leverages `AsyncLocalStorage` for bulletproof context propagation.
+- 🎨 **Visual Timelines**: Beautiful, colorized CLI output showing parallel and sequential execution.
+- 🌲 **Nested Spans**: Effortlessly track parent-child relationships across complex async flows.
+- 🛠 **Dev-Friendly**: Capture errors, add tags, and wrap functions with minimal boilerplate.
+- 🔌 **Framework Ready**: First-class support for Express.js and easy integration for others.
+- 💾 **Persistence**: Export traces to JSON/NDJSON and reload them for offline analysis.
+- 🧩 **Extensible**: Hooks for custom exporters, metrics, and plugin support.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @sploov/trace
+```
+
+---
+
+## 🚀 Quick Start
+
+```typescript
+import { trace } from '@sploov/trace';
+
+async function performTask() {
+  await trace.startSpan('compute-data', async () => {
+    trace.tag('id', '12345');
+    
+    // Simulate some work
+    await new Promise(r => setTimeout(r, 100));
+    
+    console.log(trace.format());
+  });
+}
+```
+
+### The Output
+
+Trace transforms complex async logs into an intuitive timeline:
+
+```text
+  ● Trace ID: 87c2940c
+  ● Duration: 105ms
+  ● Spans:    1
+
+  Timeline                                  Execution Flow
+  ┌────────────────────────────────────────┐
+  │━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━│ compute-data 105ms [id:12345]
+  └────────────────────────────────────────┘
+```
+
+---
+
+## 🛠 Advanced Usage
+
+### Function Wrapping
+Don't want to change your function body? Wrap it!
+
+```typescript
+const processUser = trace.wrap('process-user', (user) => {
+  // Automatically traced!
+});
+```
+
+### Express Integration
+Track entire request lifecycles with one line of code.
+
+```typescript
+import { expressTrace } from '@sploov/trace/middleware';
+
+app.use(expressTrace);
+```
+
+### Automatic Error Capture
+Trace automatically catches errors and labels them in the timeline.
+
+```typescript
+await trace.startSpan('risky-operation', async () => {
+  throw new Error('Something went wrong');
+});
+```
+
+---
+
+## ⚙️ Configuration
+
+Tune Trace to fit your production needs:
+
+```typescript
+trace.configure({
+  enabled: true,         // Toggle tracing globally
+  samplingRate: 0.05,    // Only trace 5% of requests
+  maxSpans: 1000         // Protect memory in massive operations
+});
+```
+
+---
+
+## 🤝 Contributing
+
+We love contributions! Check out our [Contributing Guide](CONTRIBUTING.md) to get started.
+
+## 📄 License
+
+Trace is [MIT Licensed](LICENSE).
+
+---
+
+<p align="center">
+  Built with ❤️ for the developer community.
+</p>

package/dist/core/Trace.d.ts

@@ -0,0 +1,22 @@
+import type { SpanData, TraceData, TraceConfig, TracePlugin } from '../types.js';
+export declare class TraceContext {
+    private storage;
+    private rootSpan;
+    private traceId;
+    private config;
+    private spanCount;
+    private isSampled;
+    private plugins;
+    configure(config: TraceConfig): void;
+    use(plugin: TracePlugin): void;
+    startSpan<T>(label: string, fn: (span: SpanData) => T): T;
+    wrap<Args extends any[], Ret>(label: string, fn: (...args: Args) => Ret): (...args: Args) => Ret;
+    tag(key: string, value: string | number | boolean): void;
+    get currentSpan(): SpanData | undefined;
+    private endSpan;
+    toJSON(): TraceData;
+    save(path: string): Promise<void>;
+    load(path: string): Promise<void>;
+    format(traceData?: TraceData): string;
+}
+//# sourceMappingURL=Trace.d.ts.map

package/dist/core/Trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Trace.d.ts","sourceRoot":"","sources":["../../src/core/Trace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGjF,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,MAAM,CAIZ;IACF,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,OAAO,CAAqB;IAEpC,SAAS,CAAC,MAAM,EAAE,WAAW;IAI7B,GAAG,CAAC,MAAM,EAAE,WAAW;IAIvB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,CAAC,GAAG,CAAC;IA2DzD,IAAI,CAAC,IAAI,SAAS,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,GAAG;IAIhG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI;IAKxD,IAAI,WAAW,IAAI,QAAQ,GAAG,SAAS,CAEtC;IAED,OAAO,CAAC,OAAO;IAYf,MAAM,IAAI,SAAS;IASb,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC,MAAM,CAAC,SAAS,GAAE,SAAyB,GAAG,MAAM;CAGrD"}

package/dist/core/Trace.js

@@ -0,0 +1,122 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomUUID } from 'node:crypto';
+import { writeFile, readFile } from 'node:fs/promises';
+import { Formatter } from '../ui/Formatter.js';
+export class TraceContext {
+    storage = new AsyncLocalStorage();
+    rootSpan = null;
+    traceId = randomUUID().substring(0, 8);
+    config = {
+        enabled: process.env['TRACE_ENABLED'] !== 'false',
+        samplingRate: 1.0,
+        maxSpans: 1000
+    };
+    spanCount = 0;
+    isSampled = true;
+    plugins = [];
+    configure(config) {
+        this.config = { ...this.config, ...config };
+    }
+    use(plugin) {
+        this.plugins.push(plugin);
+    }
+    startSpan(label, fn) {
+        if (!this.config.enabled)
+            return fn({});
+        const parentSpan = this.storage.getStore();
+        if (!parentSpan) {
+            this.isSampled = Math.random() < this.config.samplingRate;
+            this.spanCount = 0;
+            this.rootSpan = null;
+            this.traceId = randomUUID().substring(0, 8);
+            if (this.isSampled) {
+                this.plugins.forEach(p => p.onTraceStart?.(this.traceId));
+            }
+        }
+        if (!this.isSampled)
+            return fn({});
+        if (this.spanCount >= this.config.maxSpans) {
+            return fn({});
+        }
+        this.spanCount++;
+        const span = {
+            id: randomUUID().substring(0, 8),
+            parentId: parentSpan ? parentSpan.id : null,
+            label,
+            startTime: Date.now(),
+            tags: {},
+            children: []
+        };
+        if (parentSpan) {
+            parentSpan.children.push(span);
+        }
+        else {
+            this.rootSpan = span;
+        }
+        this.plugins.forEach(p => p.onSpanStart?.(span));
+        return this.storage.run(span, () => {
+            try {
+                const result = fn(span);
+                if (result instanceof Promise) {
+                    return result
+                        .catch(err => {
+                        span.error = err;
+                        throw err;
+                    })
+                        .finally(() => this.endSpan(span));
+                }
+                this.endSpan(span);
+                return result;
+            }
+            catch (error) {
+                span.error = error;
+                this.endSpan(span);
+                throw error;
+            }
+        });
+    }
+    wrap(label, fn) {
+        return (...args) => this.startSpan(label, () => fn(...args));
+    }
+    tag(key, value) {
+        const span = this.storage.getStore();
+        if (span)
+            span.tags[key] = value;
+    }
+    get currentSpan() {
+        return this.storage.getStore();
+    }
+    endSpan(span) {
+        if (span.id && span.endTime === undefined) {
+            span.endTime = Date.now();
+            span.duration = span.endTime - span.startTime;
+            this.plugins.forEach(p => p.onSpanEnd?.(span));
+            if (span === this.rootSpan) {
+                this.plugins.forEach(p => p.onTraceEnd?.(this.toJSON()));
+            }
+        }
+    }
+    toJSON() {
+        return {
+            id: this.traceId,
+            rootSpan: this.rootSpan,
+            isSampled: this.isSampled,
+            spanCount: this.spanCount
+        };
+    }
+    async save(path) {
+        await writeFile(path, JSON.stringify(this.toJSON(), null, 2));
+    }
+    async load(path) {
+        const data = await readFile(path, 'utf-8');
+        const parsed = JSON.parse(data);
+        this.traceId = parsed.id;
+        this.rootSpan = parsed.rootSpan;
+        this.isSampled = parsed.isSampled ?? true;
+        this.spanCount = parsed.spanCount ?? 0;
+    }
+    format(traceData = this.toJSON()) {
+        return Formatter.format(traceData);
+    }
+}
+//# sourceMappingURL=Trace.js.map

package/dist/core/Trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Trace.js","sourceRoot":"","sources":["../../src/core/Trace.ts"],"names":[],"mappings":"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"}

package/dist/example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":""}

package/dist/example.js

@@ -0,0 +1,34 @@
+import { trace } from './index.js';
+async function simulate() {
+    await trace.startSpan('root-request', async () => {
+        trace.tag('api_version', 'v1');
+        await trace.startSpan('authentication', async () => {
+            await new Promise(r => setTimeout(r, 20));
+            trace.tag('user_id', 'user_123');
+        });
+        await Promise.all([
+            trace.startSpan('fetch-db', async () => {
+                await new Promise(r => setTimeout(r, 60));
+                trace.tag('db.query', 'SELECT * FROM users');
+            }),
+            trace.startSpan('fetch-cache', async () => {
+                await new Promise(r => setTimeout(r, 15));
+            })
+        ]);
+        try {
+            await trace.startSpan('legacy-service', async () => {
+                await new Promise(r => setTimeout(r, 10));
+                throw new Error('Service Unavailable');
+            });
+        }
+        catch (e) {
+            // handled
+        }
+        await trace.startSpan('serialization', async () => {
+            await new Promise(r => setTimeout(r, 5));
+        });
+        console.log(trace.format());
+    });
+}
+simulate();
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,KAAK,UAAU,QAAQ;IACrB,MAAM,KAAK,CAAC,SAAS,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;QAC/C,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAE/B,MAAM,KAAK,CAAC,SAAS,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAC1C,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;gBACrC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC1C,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;YAC/C,CAAC,CAAC;YACF,KAAK,CAAC,SAAS,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE;gBACxC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,SAAS,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;gBACjD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,UAAU;QACZ,CAAC;QAED,MAAM,KAAK,CAAC,SAAS,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { TraceContext } from './core/Trace.js';
+export * from './types.js';
+export * from './core/Trace.js';
+export * from './ui/Formatter.js';
+export * from './integrations/Express.js';
+export declare const trace: TraceContext;
+export default trace;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAE1C,eAAO,MAAM,KAAK,cAAqB,CAAC;AACxC,eAAe,KAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+import { TraceContext } from './core/Trace.js';
+export * from './types.js';
+export * from './core/Trace.js';
+export * from './ui/Formatter.js';
+export * from './integrations/Express.js';
+export const trace = new TraceContext();
+export default trace;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;AACxC,eAAe,KAAK,CAAC"}

package/dist/integrations/Express.d.ts

@@ -0,0 +1,6 @@
+import type { Request, Response, NextFunction } from 'express';
+/**
+ * Express middleware for Trace
+ */
+export declare function expressTrace(req: Request, res: Response, next: NextFunction): void;
+//# sourceMappingURL=Express.d.ts.map

package/dist/integrations/Express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Express.d.ts","sourceRoot":"","sources":["../../src/integrations/Express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG/D;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,QAmB3E"}

package/dist/integrations/Express.js

@@ -0,0 +1,21 @@
+import { trace } from '../index.js';
+/**
+ * Express middleware for Trace
+ */
+export function expressTrace(req, res, next) {
+    const label = `${req.method} ${req.path}`;
+    trace.startSpan(label, async () => {
+        trace.tag('http.method', req.method);
+        trace.tag('http.path', req.path);
+        const responseFinished = new Promise((resolve) => {
+            res.on('finish', () => {
+                trace.tag('http.status', res.statusCode);
+                resolve();
+            });
+            res.on('close', resolve);
+        });
+        next();
+        await responseFinished;
+    });
+}
+//# sourceMappingURL=Express.js.map

package/dist/integrations/Express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Express.js","sourceRoot":"","sources":["../../src/integrations/Express.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;IAC1E,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;IAE1C,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;QAChC,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAEjC,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACrD,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACpB,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;gBACzC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,IAAI,EAAE,CAAC;QAEP,MAAM,gBAAgB,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":""}

package/dist/test.js

@@ -0,0 +1,54 @@
+import { trace } from './index.js';
+import assert from 'node:assert';
+async function testBasicTracing() {
+    console.log('Testing basic tracing...');
+    await trace.startSpan('root', async () => {
+        trace.tag('test', 'basic');
+        await trace.startSpan('child', async () => {
+            await new Promise(r => setTimeout(r, 10));
+        });
+    });
+    const data = trace.toJSON();
+    assert.strictEqual(data.rootSpan?.label, 'root');
+    assert.strictEqual(data.rootSpan?.children.length, 1);
+    assert.strictEqual(data.rootSpan?.children[0]?.label, 'child');
+    assert.strictEqual(data.rootSpan?.tags['test'], 'basic');
+    console.log('✅ Basic tracing passed');
+}
+async function testErrorCapturing() {
+    console.log('Testing error capturing...');
+    try {
+        await trace.startSpan('error-parent', async () => {
+            throw new Error('boom');
+        });
+    }
+    catch (e) { }
+    const data = trace.toJSON();
+    assert.strictEqual(data.rootSpan?.label, 'error-parent');
+    assert.strictEqual(data.rootSpan?.error?.message, 'boom');
+    console.log('✅ Error capturing passed');
+}
+async function testSampling() {
+    console.log('Testing sampling...');
+    trace.configure({ samplingRate: 0 });
+    await trace.startSpan('not-sampled', () => { });
+    assert.strictEqual(trace.format(), '\u001b[33m⚠ Trace not sampled.\u001b[39m');
+    trace.configure({ samplingRate: 1 });
+    await trace.startSpan('sampled', () => { });
+    assert.notStrictEqual(trace.format(), '\u001b[33m⚠ Trace not sampled.\u001b[39m');
+    console.log('✅ Sampling passed');
+}
+async function runTests() {
+    try {
+        await testBasicTracing();
+        await testErrorCapturing();
+        await testSampling();
+        console.log('\nAll tests passed! 🚀');
+    }
+    catch (error) {
+        console.error('❌ Test failed:', error);
+        process.exit(1);
+    }
+}
+runTests();
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+export interface SpanData {
+    id: string;
+    parentId: string | null;
+    label: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    error?: any;
+    tags: Record<string, string | number | boolean>;
+    children: SpanData[];
+}
+export interface TraceData {
+    id: string;
+    rootSpan: SpanData | null;
+    isSampled: boolean;
+    spanCount: number;
+}
+export interface TraceConfig {
+    enabled?: boolean;
+    samplingRate?: number;
+    maxSpans?: number;
+}
+export interface TracePlugin {
+    onTraceStart?: (id: string) => void;
+    onTraceEnd?: (data: TraceData) => void;
+    onSpanStart?: (span: SpanData) => void;
+    onSpanEnd?: (span: SpanData) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAChD,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;CACtC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/ui/Formatter.d.ts

@@ -0,0 +1,7 @@
+import type { TraceData } from '../types.js';
+export declare class Formatter {
+    private static readonly BAR_WIDTH;
+    static format(traceData: TraceData): string;
+    private static renderSpan;
+}
+//# sourceMappingURL=Formatter.d.ts.map

package/dist/ui/Formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Formatter.d.ts","sourceRoot":"","sources":["../../src/ui/Formatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,aAAa,CAAC;AAEvD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAM;IAEvC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IA8B3C,OAAO,CAAC,MAAM,CAAC,UAAU;CA0C1B"}

package/dist/ui/Formatter.js

@@ -0,0 +1,61 @@
+import pc from 'picocolors';
+export class Formatter {
+    static BAR_WIDTH = 40;
+    static format(traceData) {
+        if (!traceData.isSampled)
+            return pc.yellow('⚠ Trace not sampled.');
+        const { id, rootSpan, spanCount } = traceData;
+        if (!rootSpan)
+            return pc.red('✖ No trace recorded.');
+        const now = Date.now();
+        const totalDuration = (rootSpan.duration || (now - rootSpan.startTime)) || 1;
+        const rootStart = rootSpan.startTime;
+        let output = `
+  ${pc.bold(pc.cyan('●'))} ${pc.bold('Trace ID:')} ${pc.gray(id)}
+`;
+        output += `  ${pc.bold(pc.cyan('●'))} ${pc.bold('Duration:')} ${pc.blue(`${totalDuration}ms`)}
+`;
+        output += `  ${pc.bold(pc.cyan('●'))} ${pc.bold('Spans:   ')} ${pc.gray(spanCount.toString())}
+
+`;
+        const barHeader = ' '.repeat(2) + pc.dim('Timeline') + ' '.repeat(this.BAR_WIDTH - 8 + 2) + pc.dim('Execution Flow') + '\n';
+        output += barHeader;
+        output += `  ${pc.gray('┌' + '─'.repeat(this.BAR_WIDTH) + '┐')}\n`;
+        output += this.renderSpan(rootSpan, 0, rootStart, totalDuration);
+        output += `  ${pc.gray('└' + '─'.repeat(this.BAR_WIDTH) + '┘')}\n`;
+        return output;
+    }
+    static renderSpan(span, depth, rootStart, totalDuration) {
+        const now = Date.now();
+        const relativeStart = span.startTime - rootStart;
+        const duration = span.duration || (now - span.startTime);
+        const startPos = Math.max(0, Math.floor((relativeStart / totalDuration) * this.BAR_WIDTH));
+        let barWidth = Math.max(1, Math.floor((duration / totalDuration) * this.BAR_WIDTH));
+        // Ensure bar doesn't exceed total width
+        if (startPos + barWidth > this.BAR_WIDTH) {
+            barWidth = this.BAR_WIDTH - startPos;
+        }
+        const isError = !!span.error;
+        const barColor = isError ? pc.red : (depth === 0 ? pc.cyan : (depth % 2 === 0 ? pc.green : pc.yellow));
+        const barContent = '━'.repeat(Math.max(0, barWidth));
+        const bar = ' '.repeat(startPos) + barColor(barContent);
+        const paddedBar = bar.padEnd(this.BAR_WIDTH + (isError ? 10 : 10)); // ANSI compensation
+        const indent = depth > 0 ? pc.gray('  '.repeat(depth - 1) + '└─ ') : '';
+        const label = isError ? pc.red(pc.bold(span.label)) : (depth === 0 ? pc.bold(pc.white(span.label)) : pc.white(span.label));
+        const durationStr = pc.dim(`${duration}ms`);
+        const tags = Object.keys(span.tags).length
+            ? ` ${pc.dim(`[${Object.entries(span.tags).map(([k, v]) => `${pc.cyan(k)}:${v}`).join(', ')}]`)}`
+            : '';
+        const errorMsg = span.error ? ` ${pc.bgRed(pc.white(pc.bold(' ERROR ')))} ${pc.red(span.error.message || span.error)}` : '';
+        // We need to carefully handle the padding because of ANSI codes
+        // Re-calculating visible length for the bar part
+        const visibleBar = ' '.repeat(startPos) + '━'.repeat(Math.max(0, barWidth));
+        const barPadding = ' '.repeat(this.BAR_WIDTH - visibleBar.length);
+        let line = `  ${pc.gray('│')}${bar}${barPadding}${pc.gray('│')} ${indent}${label} ${durationStr}${tags}${errorMsg}\n`;
+        for (const child of span.children) {
+            line += this.renderSpan(child, depth + 1, rootStart, totalDuration);
+        }
+        return line;
+    }
+}
+//# sourceMappingURL=Formatter.js.map

package/dist/ui/Formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Formatter.js","sourceRoot":"","sources":["../../src/ui/Formatter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@sploov/trace",
+  "version": "1.0.0",
+  "description": "Trace is a lightweight execution tracing and flow-visualization tool that helps developers understand how code actually runs across time, state, and events.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./middleware": "./dist/integrations/Express.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sploov/Trace.git"
+  },
+  "keywords": [
+    "trace",
+    "tracing",
+    "telemetry",
+    "visualization",
+    "async-safe",
+    "performance",
+    "node",
+    "typescript"
+  ],
+  "author": "Sploov",
+  "license": "MIT",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/sploov/Trace/issues"
+  },
+  "homepage": "https://github.com/sploov/Trace#readme",
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.0.3",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "express": "^5.2.1",
+    "picocolors": "^1.1.1"
+  }
+}