@better-logger/core 0.1.0

package/README.md

@@ -0,0 +1,294 @@
+# @better-logger/core
+
+> Track what your app *did*, not what it *said*.
+
+Execution flow debugger for modern apps. Zero deps. Works everywhere. <10KB.
+
+```bash
+npm install @better-logger/core
+```
+
+---
+
+Stop debugging like this:
+
+```ts
+console.log('start')
+console.log('user', user)
+console.log('after db')
+console.log('done')
+```
+
+And trying to mentally reconstruct what happened, in what order, and how long each thing took.
+
+Your app is not a list of messages.
+
+It's a **flow**.
+
+---
+
+## What you actually get
+
+```
+🚀 [flow:user-onboarding] [auth] (tid: a1b2c3d4)
+  → create-user
+    data: { email: "test@example.com" }
+  ✓ create-user (45ms)
+  → generate-ai-profile
+  ✓ generate-ai-profile (410ms)
+  → save-db
+  ✗ save-db (error: timeout)
+🏁 [flow:user-onboarding] failed (532ms)
+```
+
+```ts
+import { createFlow } from '@better-logger/core'
+
+const flow = createFlow('user-onboarding', { tags: ['auth'] })
+
+const s1 = flow.step('create-user', { email })
+await createUser(email)
+s1.success()
+
+const s2 = flow.step('save-db')
+await saveUser()
+s2.fail(new Error('timeout'))
+
+flow.fail(new Error('save-db failed'))
+```
+
+You didn't write logs.
+
+You defined the **execution**.
+
+better-logger turns your code into a timeline of what actually happened.
+
+Output is deferred until `flow.success()` / `flow.fail()` — one atomic write, zero interleaving, even in async chaos.
+
+---
+
+## Why this exists
+
+Debugging today is broken:
+
+- `console.log` → flat noise, no structure
+- No automatic timing
+- No context propagation
+- Async flows become impossible to follow
+
+You don't debug code.
+
+You debug **guesses about what happened**.
+
+better-logger removes the guesswork. Instead of scattering `console.log` across your code and reconstructing timelines mentally, you define the flow upfront and get a structured narrative back — with timing, context, and clear failure markers.
+
+---
+
+## What changes
+
+Instead of guessing:
+- "did this run?"
+- "what ran first?"
+- "where did it fail?"
+- "why is it slow?"
+
+You **see**:
+
+- 🧠 A full execution narrative
+- ⏱ Exact timing for every step
+- 🌳 Nested flows (real hierarchy, not flat logs)
+- 🧾 Data at the moment it mattered
+- 🧵 Shared context across the entire flow
+- 🏷 Tags to group and filter
+- 🧱 Guaranteed consistency — no race-condition bugs
+- 🔒 Immutable render snapshots — output can't be corrupted
+
+This replaces `console.log` for anything non-trivial.
+
+---
+
+## Why not just use something else?
+
+| Tool | Reality |
+|------|--------|
+| `console.log` | You reconstruct flows manually like it's 2005 |
+| `pino` / `winston` | Built for shipping logs, not understanding execution |
+| `debug` | Namespaces ≠ structure |
+| OpenTelemetry | Powerful, but heavy and not built for everyday debugging |
+
+**@better-logger/core** sits in the missing gap:
+
+→ instant, local, zero-config execution tracing
+
+---
+
+## Usage
+
+```ts
+const flow = createFlow('request', { tags: ['api'] })
+
+const step = flow.step('db')
+await db.query()
+step.success()
+
+flow.success()
+```
+
+That's it.
+
+---
+
+## How it works
+
+```mermaid
+graph TD
+  Start[createFlow] --> Step[step]
+  Step --> Complete[success / fail]
+  Complete --> FlowEnd[flow.success / flow.fail]
+  FlowEnd --> Render[Atomic Render]
+```
+
+---
+
+## When should you use this
+
+Use it when:
+
+- your flow has more than 2 steps
+- async logic gets confusing
+- debugging requires more than one `console.log`
+- timing matters
+- you need to know "what ran" and "what didn't"
+
+If a single `console.log` feels enough, you don't need this.
+
+If it doesn't… this replaces it.
+
+---
+
+## Advanced
+
+### Child Flows
+
+```ts
+const flow = createFlow('request')
+
+const ai = flow.child('ai-call')
+const s = ai.step('generate')
+await generate()
+s.success()
+ai.success()
+
+flow.success()
+```
+
+```
+🚀 [flow:request] (tid: a1b2c3d4)
+  └─ 🚀 [flow:ai-call] (tid: x9y8z7w6)
+       → generate
+       ✓ generate (210ms)
+     🏁 [flow:ai-call] success (215ms)
+🏁 [flow:request] success (340ms)
+```
+
+### Context Propagation
+
+```ts
+flow.setContext({ userId: 'abc', requestId: 'xyz' })
+// Available across all steps and child flows
+```
+
+### Silent Mode
+
+```ts
+const flow = createFlow('task', { enabled: false })
+// Near-zero overhead. All operations are no-ops.
+```
+
+### Max Steps Guard
+
+```ts
+const flow = createFlow('batch', { maxSteps: 1000 })
+// Prevents memory blowups from runaway loops
+```
+
+### Subscribe (DevTools / Testing)
+
+```ts
+import { subscribe, toJSON } from '@better-logger/core'
+
+subscribe((trace) => {
+  // Frozen snapshot of every completed flow
+  console.log(toJSON(trace))
+})
+```
+
+### JSON Output
+
+```ts
+import { toJSON } from '@better-logger/core'
+
+const json = toJSON(flow)
+// { version: 1, flow: { id, name, state, status, tags, steps, context, ... } }
+```
+
+Portable, structured trace for tooling, testing, and future integrations.
+
+---
+
+## Features
+
+### Core
+`createFlow` · `step` · `success/fail` · `child` · `toJSON`
+
+### Advanced
+Context propagation · Tags · Inline data snapshots · Subscribe event tap · Deferred atomic rendering · Immutable snapshots
+
+### Safety
+Guarded finalization · `maxSteps` overflow protection · Lifecycle states (`running` → `completed`) · Safe data serializer (circular refs, deep nesting) · NoOp singletons (zero-allocation silent mode)
+
+---
+
+## What's not included
+
+- ❌ Log levels (debug, info, warn)
+- ❌ Transports (file, HTTP, Elasticsearch)
+- ❌ SaaS dashboards
+- ❌ Auto-instrumentation
+
+This is a developer debugging tool, not observability infrastructure.
+
+---
+
+## Roadmap
+
+| Version | Focus |
+|---------|-------|
+| **V1** | Core flow debugger — this release |
+| **V2** | Custom renderers, `flow.run()` async helper, flow sampling |
+| **V3** | Browser DevTools timeline panel |
+| **V4+** | Python / Go / Rust ports, shared tracing schema |
+
+---
+
+## Organization
+
+Published under the **@better-logger** org, owned by [0xmilord](https://github.com/0xmilord).
+
+```bash
+npm install @better-logger/core
+```
+
+All packages in this org share the same execution tracing schema.
+
+---
+
+## Test Coverage
+
+**100%** across all metrics — statements, branches, functions, lines.
+
+[View detailed coverage report](./COVERAGE.md) | [Testing Strategy](./docs/TESTING-STRATEGY.md)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,3 @@
+"use strict";var y=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var W=Object.prototype.hasOwnProperty;var q=(e,t)=>{for(var r in t)y(e,r,{get:t[r],enumerable:!0})},J=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of M(t))!W.call(e,s)&&s!==r&&y(e,s,{get:()=>t[s],enumerable:!(o=A(t,s))||o.enumerable});return e};var U=e=>J(y({},"__esModule",{value:!0}),e);var ie={};q(ie,{createFlow:()=>G,subscribe:()=>T,toJSON:()=>E});module.exports=U(ie);function l(e){return e===void 0?{name:"Error",message:"Unknown error"}:e instanceof Error?{name:e.name,message:e.message,stack:e.stack}:typeof e=="string"?{name:"Error",message:e}:{name:"Error",message:String(e)}}var x=class{constructor(t,r){this._trace=t;this._clock=r;this._completed=!1}get isCompleted(){return this._completed}get trace(){return this._trace}success(){this._completed||(this._completed=!0,this._trace.end=this._clock.now(),this._trace.state="completed",this._trace.status="success")}fail(t){this._completed||(this._completed=!0,this._trace.end=this._clock.now(),this._trace.state="completed",this._trace.status="error",this._trace.error=l(t))}};var c=()=>{},u={success:c,fail:c},a={step:()=>u,child:()=>a,tag:c,tags:()=>[],setContext:c,getContext:()=>({}),success:c,fail:c};function N(e){let t=new WeakMap;function r(o){if(o===null||typeof o!="object")return o;if(o instanceof Date)return new Date(o.getTime());if(o instanceof RegExp)return new RegExp(o.source,o.flags);if(t.has(o))return t.get(o);if(Array.isArray(o)){let i=[];t.set(o,i);for(let n=0;n<o.length;n++)i.push(r(o[n]));return i}let s={};t.set(o,s);for(let i of Object.keys(o))s[i]=r(o[i]);return s}return r(e)}function h(e){if(e===null||typeof e!="object")return e;if(Object.freeze(e),Array.isArray(e))for(let t of e)h(t);else for(let t of Object.keys(e)){let r=e[t];r&&typeof r=="object"&&!Object.isFrozen(r)&&h(r)}return e}function R(e){let t=N(e);return h(t)}var _=new Set;function T(e){return _.add(e),()=>{_.delete(e)}}function Y(e){if(_.size!==0)for(let t of _)try{t(e)}catch{}}var S=class e{constructor(t,r,o,s,i){this._trace=t;this._clock=r;this._idGen=o;this._renderer=s;this._options=i;this._completed=!1;this._sequence=0}get isCompleted(){return this._completed}get trace(){return this._trace}step(t,r){if(this._completed)return u;let o=this._options.maxSteps;if(o!==void 0&&this._trace.steps.length>=o)return this._trace.meta===void 0?this._trace.meta={maxStepsExceeded:!0}:this._trace.meta.maxStepsExceeded=!0,u;let s={id:this._idGen.generate(),name:t,sequence:this._sequence++,state:"running",status:"pending",start:this._clock.now(),data:r,children:[]};return this._trace.steps.push(s),new x(s,this._clock)}child(t){if(this._completed)return a;if(this._options.enabled===!1)return a;let r={id:this._idGen.generate(),name:t,parentId:this._trace.id,state:"running",status:void 0,tags:[],start:this._clock.now(),context:{...this._trace.context},steps:[]};return new e(r,this._clock,this._idGen,this._renderer,{...this._options})}tag(t){this._completed||this._trace.tags.includes(t)||this._trace.tags.push(t)}tags(){return[...this._trace.tags]}setContext(t){this._completed||Object.assign(this._trace.context,t)}getContext(){return{...this._trace.context}}success(){this._finalize("success")}fail(t){this._trace.error=l(t),this._finalize("error")}_finalize(t){if(this._completed)return;this._completed=!0,this._trace.end=this._clock.now(),this._trace.state="completed",this._trace.status=t;let r=R(this._trace);Y(r),this._renderer.render(r)}};var f=class{generate(){return Math.random().toString(36).slice(2,10)}};var p=class{now(){return Date.now()}};function m(e,t){let r=t?.maxDepth??2,o=t?.maxLength??80,s=new WeakSet;function i(n,d){if(typeof n=="function")return`[Fn:${n.name||"?"}]`;if(typeof n=="symbol")return n.toString();if(d>r)return n&&typeof n=="object"?"[...]":n;if(n===null||typeof n!="object")return n;if(n instanceof Map)return`{Map(${n.size})}`;if(n instanceof Set)return`{Set(${n.size})}`;if(n instanceof Date)return n.toISOString();if(n instanceof RegExp)return n.toString();if(s.has(n))return"[Circular]";if(s.add(n),Array.isArray(n))return n.map(w=>i(w,d+1));let v={};for(let w of Object.keys(n)){let P=n[w];v[w]=i(P,d+1)}return v}try{let n=JSON.stringify(i(e,0));return n&&n.length>o?n.slice(0,o)+"\u2026":n}catch{return"[Unserializable]"}}var B=()=>typeof process<"u"&&process.versions!==void 0&&process.versions.node!==void 0,K=()=>typeof EdgeRuntime<"u",Q=()=>typeof caches<"u"&&"default"in caches,V=()=>typeof window<"u"||typeof self<"u";function C(){return B()?"node":K()||Q()?"edge":V()?"browser":"node"}var X="\x1B[0m",Z="\x1B[32m",j="\x1B[31m";var ee="\x1B[36m";var te="\x1B[2m";function re(){return!(C()==="browser"||typeof process<"u"&&process.env?.NO_COLOR)}var ne=re();function F(e,t){return ne?`${t}${e}${X}`:e}function O(e){return F(e,Z)}function k(e){return F(e,j)}function z(e){return F(e,ee)}function $(e){return F(e,te)}function b(e,t){if(t===void 0)return"\u2014";let r=Math.round(t-e);return r>=1e3?`${(r/1e3).toFixed(1)}s`:`${r}ms`}function H(e,t,r){let o="  ".repeat(t);r.push(`${o}${z("\u2192")} ${e.name}`),e.data!==void 0&&r.push(`${o}  ${$("data:")} ${m(e.data,{maxLength:80})}`);let s=b(e.start,e.end);e.status==="success"?r.push(`${o}${O("\u2713")} ${e.name} (${s})`):e.status==="error"?r.push(`${o}${k("\u2717")} ${e.name} (error: ${e.error?.message??"Unknown error"})`):r.push(`${o}  ${e.name} (${s})`);for(let i of e.children)H(i,t+1,r)}var g=class{render(t){let r=[],o=t.tags.length>0?` [${t.tags.join(", ")}]`:"",s=t.status==="error"?"\u{1F525}":"\u{1F680}";r.push(`${s} [flow:${t.name}]${o} (${$("tid:")} ${t.id})`);for(let d of t.steps)H(d,1,r);let i=b(t.start,t.end),n=t.meta?.maxStepsExceeded?` ${k("\u26A0\uFE0F maxSteps exceeded")}`:"";t.status==="error"?(r.push(`\u{1F3C1} [flow:${t.name}] ${k("failed")} (${i}, error: ${t.error?.message??"Unknown error"})${n}`),console.error(r.join(`
+`))):(r.push(`\u{1F3C1} [flow:${t.name}] ${O("success")} (${i})${n}`),console.log(r.join(`
+`)))}};var L=new f,D=new p,oe=new g;function G(e,t){if(t?.enabled===!1)return a;let r={id:L.generate(),name:e,state:"running",tags:t?.tags??[],start:D.now(),context:{},steps:[]};return new S(r,D,L,oe,t??{})}function se(e){return typeof e=="object"&&e!==null&&"trace"in e&&typeof e.trace=="object"&&e.trace!==null}function E(e){let t=se(e)?e.trace:e;return JSON.stringify({version:1,flow:{id:t.id,name:t.name,...t.parentId!==void 0&&{parentId:t.parentId},state:t.state,...t.status!==void 0&&{status:t.status},tags:t.tags,start:t.start,...t.end!==void 0&&{end:t.end},...t.error!==void 0&&{error:t.error},context:t.context,steps:t.steps.map(I),...t.meta!==void 0&&{meta:t.meta}}},null,2)}function I(e){let t={id:e.id,name:e.name,sequence:e.sequence,state:e.state,status:e.status,start:e.start};return e.end!==void 0&&(t.end=e.end),e.data!==void 0&&(t.data=m(e.data)),e.error!==void 0&&(t.error=e.error),e.children.length>0&&(t.children=e.children.map(I)),t}0&&(module.exports={createFlow,subscribe,toJSON});

package/dist/index.d.cts

@@ -0,0 +1,93 @@
+/** Lifecycle state for flows and steps */
+type FlowState = 'running' | 'completed';
+/** Final status of a completed flow */
+type FlowStatus = 'success' | 'error';
+/** Final status of a completed step */
+type StepStatus = 'pending' | 'success' | 'error';
+/** Normalized error shape — all errors converge to this */
+interface NormalizedError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+/** Complete execution flow trace */
+interface FlowTrace {
+    id: string;
+    name: string;
+    parentId?: string;
+    state: FlowState;
+    status?: FlowStatus;
+    tags: string[];
+    start: number;
+    end?: number;
+    error?: NormalizedError;
+    context: Record<string, unknown>;
+    steps: StepTrace[];
+    meta?: {
+        maxStepsExceeded: boolean;
+    };
+}
+/** Individual step within a flow */
+interface StepTrace {
+    id: string;
+    name: string;
+    sequence: number;
+    state: FlowState;
+    status: StepStatus;
+    start: number;
+    end?: number;
+    data?: unknown;
+    error?: NormalizedError;
+    children: StepTrace[];
+}
+/** Options for creating a flow */
+interface FlowOptions {
+    enabled?: boolean;
+    tags?: string[];
+    maxSteps?: number;
+}
+
+/** Public StepHandle interface */
+interface StepHandle {
+    success(): void;
+    fail(error?: unknown): void;
+}
+
+/** Public FlowHandle interface */
+interface FlowHandle {
+    step(name: string, data?: unknown): StepHandle;
+    child(name: string): FlowHandle;
+    tag(tag: string): void;
+    tags(): string[];
+    setContext(context: Record<string, unknown>): void;
+    getContext(): Record<string, unknown>;
+    success(): void;
+    fail(error?: unknown): void;
+}
+/** Listener type for subscribe */
+type FlowListener = (flow: Readonly<FlowTrace>) => void;
+/**
+ * Register a listener that receives frozen snapshots on flow completion.
+ * Zero overhead when no listeners registered.
+ */
+declare function subscribe(listener: FlowListener): () => void;
+
+/**
+ * Create a new execution flow with a human-readable name and optional configuration.
+ *
+ * @param name - Human-readable flow name
+ * @param options - Optional configuration (enabled, tags, maxSteps)
+ * @returns FlowHandle for interacting with the flow
+ */
+declare function createFlow(name: string, options?: FlowOptions): FlowHandle;
+
+/**
+ * Serialize a FlowTrace to versioned JSON string.
+ * Accepts either a FlowTrace directly or a FlowHandle (extracts .trace).
+ * Omits undefined values for clean output.
+ */
+declare function toJSON(input: Readonly<FlowTrace> | {
+    trace: Readonly<FlowTrace>;
+}): string;
+
+export { type FlowOptions, type FlowState, type FlowStatus, type FlowTrace, type NormalizedError, type StepStatus, type StepTrace, createFlow, subscribe, toJSON };

package/dist/index.d.ts

@@ -0,0 +1,93 @@
+/** Lifecycle state for flows and steps */
+type FlowState = 'running' | 'completed';
+/** Final status of a completed flow */
+type FlowStatus = 'success' | 'error';
+/** Final status of a completed step */
+type StepStatus = 'pending' | 'success' | 'error';
+/** Normalized error shape — all errors converge to this */
+interface NormalizedError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+/** Complete execution flow trace */
+interface FlowTrace {
+    id: string;
+    name: string;
+    parentId?: string;
+    state: FlowState;
+    status?: FlowStatus;
+    tags: string[];
+    start: number;
+    end?: number;
+    error?: NormalizedError;
+    context: Record<string, unknown>;
+    steps: StepTrace[];
+    meta?: {
+        maxStepsExceeded: boolean;
+    };
+}
+/** Individual step within a flow */
+interface StepTrace {
+    id: string;
+    name: string;
+    sequence: number;
+    state: FlowState;
+    status: StepStatus;
+    start: number;
+    end?: number;
+    data?: unknown;
+    error?: NormalizedError;
+    children: StepTrace[];
+}
+/** Options for creating a flow */
+interface FlowOptions {
+    enabled?: boolean;
+    tags?: string[];
+    maxSteps?: number;
+}
+
+/** Public StepHandle interface */
+interface StepHandle {
+    success(): void;
+    fail(error?: unknown): void;
+}
+
+/** Public FlowHandle interface */
+interface FlowHandle {
+    step(name: string, data?: unknown): StepHandle;
+    child(name: string): FlowHandle;
+    tag(tag: string): void;
+    tags(): string[];
+    setContext(context: Record<string, unknown>): void;
+    getContext(): Record<string, unknown>;
+    success(): void;
+    fail(error?: unknown): void;
+}
+/** Listener type for subscribe */
+type FlowListener = (flow: Readonly<FlowTrace>) => void;
+/**
+ * Register a listener that receives frozen snapshots on flow completion.
+ * Zero overhead when no listeners registered.
+ */
+declare function subscribe(listener: FlowListener): () => void;
+
+/**
+ * Create a new execution flow with a human-readable name and optional configuration.
+ *
+ * @param name - Human-readable flow name
+ * @param options - Optional configuration (enabled, tags, maxSteps)
+ * @returns FlowHandle for interacting with the flow
+ */
+declare function createFlow(name: string, options?: FlowOptions): FlowHandle;
+
+/**
+ * Serialize a FlowTrace to versioned JSON string.
+ * Accepts either a FlowTrace directly or a FlowHandle (extracts .trace).
+ * Omits undefined values for clean output.
+ */
+declare function toJSON(input: Readonly<FlowTrace> | {
+    trace: Readonly<FlowTrace>;
+}): string;
+
+export { type FlowOptions, type FlowState, type FlowStatus, type FlowTrace, type NormalizedError, type StepStatus, type StepTrace, createFlow, subscribe, toJSON };

package/dist/index.js

@@ -0,0 +1,3 @@
+function l(e){return e===void 0?{name:"Error",message:"Unknown error"}:e instanceof Error?{name:e.name,message:e.message,stack:e.stack}:typeof e=="string"?{name:"Error",message:e}:{name:"Error",message:String(e)}}var x=class{constructor(t,r){this._trace=t;this._clock=r;this._completed=!1}get isCompleted(){return this._completed}get trace(){return this._trace}success(){this._completed||(this._completed=!0,this._trace.end=this._clock.now(),this._trace.state="completed",this._trace.status="success")}fail(t){this._completed||(this._completed=!0,this._trace.end=this._clock.now(),this._trace.state="completed",this._trace.status="error",this._trace.error=l(t))}};var c=()=>{},u={success:c,fail:c},a={step:()=>u,child:()=>a,tag:c,tags:()=>[],setContext:c,getContext:()=>({}),success:c,fail:c};function $(e){let t=new WeakMap;function r(o){if(o===null||typeof o!="object")return o;if(o instanceof Date)return new Date(o.getTime());if(o instanceof RegExp)return new RegExp(o.source,o.flags);if(t.has(o))return t.get(o);if(Array.isArray(o)){let s=[];t.set(o,s);for(let n=0;n<o.length;n++)s.push(r(o[n]));return s}let i={};t.set(o,i);for(let s of Object.keys(o))i[s]=r(o[s]);return i}return r(e)}function h(e){if(e===null||typeof e!="object")return e;if(Object.freeze(e),Array.isArray(e))for(let t of e)h(t);else for(let t of Object.keys(e)){let r=e[t];r&&typeof r=="object"&&!Object.isFrozen(r)&&h(r)}return e}function y(e){let t=$(e);return h(t)}var _=new Set;function E(e){return _.add(e),()=>{_.delete(e)}}function I(e){if(_.size!==0)for(let t of _)try{t(e)}catch{}}var S=class e{constructor(t,r,o,i,s){this._trace=t;this._clock=r;this._idGen=o;this._renderer=i;this._options=s;this._completed=!1;this._sequence=0}get isCompleted(){return this._completed}get trace(){return this._trace}step(t,r){if(this._completed)return u;let o=this._options.maxSteps;if(o!==void 0&&this._trace.steps.length>=o)return this._trace.meta===void 0?this._trace.meta={maxStepsExceeded:!0}:this._trace.meta.maxStepsExceeded=!0,u;let i={id:this._idGen.generate(),name:t,sequence:this._sequence++,state:"running",status:"pending",start:this._clock.now(),data:r,children:[]};return this._trace.steps.push(i),new x(i,this._clock)}child(t){if(this._completed)return a;if(this._options.enabled===!1)return a;let r={id:this._idGen.generate(),name:t,parentId:this._trace.id,state:"running",status:void 0,tags:[],start:this._clock.now(),context:{...this._trace.context},steps:[]};return new e(r,this._clock,this._idGen,this._renderer,{...this._options})}tag(t){this._completed||this._trace.tags.includes(t)||this._trace.tags.push(t)}tags(){return[...this._trace.tags]}setContext(t){this._completed||Object.assign(this._trace.context,t)}getContext(){return{...this._trace.context}}success(){this._finalize("success")}fail(t){this._trace.error=l(t),this._finalize("error")}_finalize(t){if(this._completed)return;this._completed=!0,this._trace.end=this._clock.now(),this._trace.state="completed",this._trace.status=t;let r=y(this._trace);I(r),this._renderer.render(r)}};var f=class{generate(){return Math.random().toString(36).slice(2,10)}};var p=class{now(){return Date.now()}};function m(e,t){let r=t?.maxDepth??2,o=t?.maxLength??80,i=new WeakSet;function s(n,d){if(typeof n=="function")return`[Fn:${n.name||"?"}]`;if(typeof n=="symbol")return n.toString();if(d>r)return n&&typeof n=="object"?"[...]":n;if(n===null||typeof n!="object")return n;if(n instanceof Map)return`{Map(${n.size})}`;if(n instanceof Set)return`{Set(${n.size})}`;if(n instanceof Date)return n.toISOString();if(n instanceof RegExp)return n.toString();if(i.has(n))return"[Circular]";if(i.add(n),Array.isArray(n))return n.map(w=>s(w,d+1));let O={};for(let w of Object.keys(n)){let G=n[w];O[w]=s(G,d+1)}return O}try{let n=JSON.stringify(s(e,0));return n&&n.length>o?n.slice(0,o)+"\u2026":n}catch{return"[Unserializable]"}}var P=()=>typeof process<"u"&&process.versions!==void 0&&process.versions.node!==void 0,A=()=>typeof EdgeRuntime<"u",M=()=>typeof caches<"u"&&"default"in caches,W=()=>typeof window<"u"||typeof self<"u";function v(){return P()?"node":A()||M()?"edge":W()?"browser":"node"}var q="\x1B[0m",J="\x1B[32m",U="\x1B[31m";var Y="\x1B[36m";var B="\x1B[2m";function K(){return!(v()==="browser"||typeof process<"u"&&process.env?.NO_COLOR)}var Q=K();function F(e,t){return Q?`${t}${e}${q}`:e}function R(e){return F(e,J)}function k(e){return F(e,U)}function N(e){return F(e,Y)}function T(e){return F(e,B)}function C(e,t){if(t===void 0)return"\u2014";let r=Math.round(t-e);return r>=1e3?`${(r/1e3).toFixed(1)}s`:`${r}ms`}function z(e,t,r){let o="  ".repeat(t);r.push(`${o}${N("\u2192")} ${e.name}`),e.data!==void 0&&r.push(`${o}  ${T("data:")} ${m(e.data,{maxLength:80})}`);let i=C(e.start,e.end);e.status==="success"?r.push(`${o}${R("\u2713")} ${e.name} (${i})`):e.status==="error"?r.push(`${o}${k("\u2717")} ${e.name} (error: ${e.error?.message??"Unknown error"})`):r.push(`${o}  ${e.name} (${i})`);for(let s of e.children)z(s,t+1,r)}var g=class{render(t){let r=[],o=t.tags.length>0?` [${t.tags.join(", ")}]`:"",i=t.status==="error"?"\u{1F525}":"\u{1F680}";r.push(`${i} [flow:${t.name}]${o} (${T("tid:")} ${t.id})`);for(let d of t.steps)z(d,1,r);let s=C(t.start,t.end),n=t.meta?.maxStepsExceeded?` ${k("\u26A0\uFE0F maxSteps exceeded")}`:"";t.status==="error"?(r.push(`\u{1F3C1} [flow:${t.name}] ${k("failed")} (${s}, error: ${t.error?.message??"Unknown error"})${n}`),console.error(r.join(`
+`))):(r.push(`\u{1F3C1} [flow:${t.name}] ${R("success")} (${s})${n}`),console.log(r.join(`
+`)))}};var b=new f,H=new p,V=new g;function X(e,t){if(t?.enabled===!1)return a;let r={id:b.generate(),name:e,state:"running",tags:t?.tags??[],start:H.now(),context:{},steps:[]};return new S(r,H,b,V,t??{})}function Z(e){return typeof e=="object"&&e!==null&&"trace"in e&&typeof e.trace=="object"&&e.trace!==null}function L(e){let t=Z(e)?e.trace:e;return JSON.stringify({version:1,flow:{id:t.id,name:t.name,...t.parentId!==void 0&&{parentId:t.parentId},state:t.state,...t.status!==void 0&&{status:t.status},tags:t.tags,start:t.start,...t.end!==void 0&&{end:t.end},...t.error!==void 0&&{error:t.error},context:t.context,steps:t.steps.map(D),...t.meta!==void 0&&{meta:t.meta}}},null,2)}function D(e){let t={id:e.id,name:e.name,sequence:e.sequence,state:e.state,status:e.status,start:e.start};return e.end!==void 0&&(t.end=e.end),e.data!==void 0&&(t.data=m(e.data)),e.error!==void 0&&(t.error=e.error),e.children.length>0&&(t.children=e.children.map(D)),t}export{X as createFlow,E as subscribe,L as toJSON};

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapter/error-normalizer.ts","../src/adapter/step-handle.ts","../src/adapter/noop-singletons.ts","../src/renderer/snapshot.ts","../src/adapter/flow-handle.ts","../src/adapter/id-generator.ts","../src/adapter/clock.ts","../src/adapter/safe-serializer.ts","../src/renderer/ansi.ts","../src/renderer/console.ts","../src/adapter/index.ts","../src/renderer/json.ts"],"sourcesContent":["import { NormalizedError } from '../core/types'\n\n/**\n * Normalizes any error input into a consistent NormalizedError shape.\n *\n * Rules:\n * - Error instance → { name, message, stack }\n * - String → { name: 'Error', message }\n * - Other → { name: 'Error', message: String(input) }\n * - undefined/no arg → { name: 'Error', message: 'Unknown error' }\n */\nexport function normalizeError(input: unknown): NormalizedError {\n  if (input === undefined) {\n    return { name: 'Error', message: 'Unknown error' }\n  }\n\n  if (input instanceof Error) {\n    return {\n      name: input.name,\n      message: input.message,\n      stack: input.stack,\n    }\n  }\n\n  if (typeof input === 'string') {\n    return { name: 'Error', message: input }\n  }\n\n  return { name: 'Error', message: String(input) }\n}\n","import { StepTrace, FlowState, StepStatus } from '../core/types'\nimport { Clock } from './clock'\nimport { normalizeError } from './error-normalizer'\n\n/** Public StepHandle interface */\nexport interface StepHandle {\n  success(): void\n  fail(error?: unknown): void\n}\n\n/** Internal implementation — not exported publicly */\nexport class StepHandleImpl implements StepHandle {\n  private _completed = false\n\n  constructor(\n    private readonly _trace: StepTrace,\n    private readonly _clock: Clock\n  ) {}\n\n  /** Returns true if this step has been finalized */\n  get isCompleted(): boolean {\n    return this._completed\n  }\n\n  /** Returns the underlying trace for inspection */\n  get trace(): Readonly<StepTrace> {\n    return this._trace\n  }\n\n  success(): void {\n    if (this._completed) return // guarded finalization — silent no-op\n    this._completed = true\n    this._trace.end = this._clock.now()\n    this._trace.state = 'completed' as FlowState\n    this._trace.status = 'success' as StepStatus\n  }\n\n  fail(error?: unknown): void {\n    if (this._completed) return // guarded finalization — silent no-op\n    this._completed = true\n    this._trace.end = this._clock.now()\n    this._trace.state = 'completed' as FlowState\n    this._trace.status = 'error' as StepStatus\n    this._trace.error = normalizeError(error)\n  }\n}\n","/** No-op function placeholder */\nconst noop = () => {}\n\n/**\n * NoOp StepHandle shape — reused across all disabled/guarded paths.\n * Defined inline to avoid circular dependency with flow-handle.ts.\n */\nexport interface NoOpStepHandle {\n  success(): void\n  fail(error?: unknown): void\n}\n\n/**\n * NoOp FlowHandle shape — reused across all disabled/guarded paths.\n * Defined inline to avoid circular dependency with flow-handle.ts.\n */\nexport interface NoOpFlowHandle {\n  step(): NoOpStepHandle\n  child(): NoOpFlowHandle\n  tag(name: string): void\n  tags(): string[]\n  setContext(context: Record<string, unknown>): void\n  getContext(): Record<string, unknown>\n  success(): void\n  fail(error?: unknown): void\n}\n\nexport const NOOP_STEP: NoOpStepHandle = {\n  success: noop,\n  fail: noop,\n}\n\nexport const NOOP_FLOW: NoOpFlowHandle = {\n  step: () => NOOP_STEP,\n  child: () => NOOP_FLOW,\n  tag: noop,\n  tags: () => [],\n  setContext: noop,\n  getContext: () => ({}),\n  success: noop,\n  fail: noop,\n}\n","/** Deep clone an object with circular reference protection */\nexport function cloneDeep<T>(obj: T): T {\n  const seen = new WeakMap<object, unknown>()\n\n  function clone(value: unknown): unknown {\n    if (value === null || typeof value !== 'object') return value\n    if (value instanceof Date) return new Date(value.getTime())\n    if (value instanceof RegExp) return new RegExp(value.source, value.flags)\n\n    if (seen.has(value as object)) {\n      return seen.get(value as object)\n    }\n\n    if (Array.isArray(value)) {\n      const arr: unknown[] = []\n      seen.set(value as object, arr)\n      return arr.map((item) => clone(item))\n    }\n\n    const result: Record<string, unknown> = {}\n    seen.set(value as object, result)\n\n    for (const key of Object.keys(value)) {\n      result[key] = clone((value as Record<string, unknown>)[key])\n    }\n    return result as T\n  }\n\n  return clone(obj) as T\n}\n\n/** Recursively freeze an object via Object.freeze */\nexport function deepFreeze<T>(obj: T): Readonly<T> {\n  if (obj === null || typeof obj !== 'object') return obj\n\n  Object.freeze(obj)\n\n  if (Array.isArray(obj)) {\n    for (const item of obj) {\n      deepFreeze(item)\n    }\n  } else {\n    for (const key of Object.keys(obj)) {\n      const value = (obj as Record<string, unknown>)[key]\n      if (value && typeof value === 'object' && !Object.isFrozen(value)) {\n        deepFreeze(value)\n      }\n    }\n  }\n\n  return obj\n}\n\n/** Create an immutable snapshot of a FlowTrace */\nexport function createSnapshot<T extends object>(trace: T): Readonly<T> {\n  const cloned = cloneDeep(trace)\n  return deepFreeze(cloned)\n}\n","import {\n  FlowTrace,\n  StepTrace,\n  FlowOptions,\n  FlowState,\n  FlowStatus,\n} from '../core/types'\nimport { Clock } from './clock'\nimport { IdGenerator } from './id-generator'\nimport { StepHandle, StepHandleImpl } from './step-handle'\nimport { NOOP_FLOW, NOOP_STEP } from './noop-singletons'\nimport { normalizeError } from './error-normalizer'\nimport { FlowRenderer } from '../renderer/types'\nimport { createSnapshot } from '../renderer/snapshot'\n\n/** Public FlowHandle interface */\nexport interface FlowHandle {\n  step(name: string, data?: unknown): StepHandle\n  child(name: string): FlowHandle\n  tag(tag: string): void\n  tags(): string[]\n  setContext(context: Record<string, unknown>): void\n  getContext(): Record<string, unknown>\n  success(): void\n  fail(error?: unknown): void\n}\n\n/** Listener type for subscribe */\nexport type FlowListener = (flow: Readonly<FlowTrace>) => void\n\n/** Global subscriber registry */\nconst _listeners = new Set<FlowListener>()\n\n/**\n * Register a listener that receives frozen snapshots on flow completion.\n * Zero overhead when no listeners registered.\n */\nexport function subscribe(listener: FlowListener): () => void {\n  _listeners.add(listener)\n  return () => {\n    _listeners.delete(listener)\n  }\n}\n\n/**\n * Fire all registered listeners with a frozen snapshot.\n * Internal — called by FlowHandleImpl on completion.\n */\nexport function _fireSubscribers(snapshot: Readonly<FlowTrace>): void {\n  if (_listeners.size === 0) return // zero overhead guard\n  for (const listener of _listeners) {\n    try {\n      listener(snapshot)\n    } catch {\n      // Listener errors must not crash the flow or other listeners\n    }\n  }\n}\n\n/** Internal FlowHandle implementation */\nexport class FlowHandleImpl implements FlowHandle {\n  private _completed = false\n  private _sequence = 0\n\n  constructor(\n    private readonly _trace: FlowTrace,\n    private readonly _clock: Clock,\n    private readonly _idGen: IdGenerator,\n    private readonly _renderer: FlowRenderer,\n    private readonly _options: FlowOptions\n  ) {}\n\n  /** Returns true if this flow has been finalized */\n  get isCompleted(): boolean {\n    return this._completed\n  }\n\n  /** Returns the underlying trace for inspection */\n  get trace(): Readonly<FlowTrace> {\n    return this._trace\n  }\n\n  step(name: string, data?: unknown): StepHandle {\n    // Guard: completed flow → return NOOP_STEP\n    if (this._completed) return NOOP_STEP\n\n    // Guard: maxSteps exceeded\n    const maxSteps = this._options.maxSteps\n    if (maxSteps !== undefined && this._trace.steps.length >= maxSteps) {\n      if (this._trace.meta === undefined) {\n        this._trace.meta = { maxStepsExceeded: true }\n      } else {\n        this._trace.meta.maxStepsExceeded = true\n      }\n      return NOOP_STEP\n    }\n\n    const stepTrace: StepTrace = {\n      id: this._idGen.generate(),\n      name,\n      sequence: this._sequence++,\n      state: 'running',\n      status: 'pending',\n      start: this._clock.now(),\n      data,\n      children: [],\n    }\n\n    this._trace.steps.push(stepTrace)\n    return new StepHandleImpl(stepTrace, this._clock)\n  }\n\n  child(name: string): FlowHandle {\n    // Guard: completed flow → return NOOP_FLOW\n    if (this._completed) return NOOP_FLOW\n\n    // If this flow is disabled, child is also disabled\n    if (this._options.enabled === false) return NOOP_FLOW\n\n    const childTrace: FlowTrace = {\n      id: this._idGen.generate(),\n      name,\n      parentId: this._trace.id,\n      state: 'running',\n      status: undefined,\n      tags: [],\n      start: this._clock.now(),\n      context: { ...this._trace.context }, // shallow copy — child inherits\n      steps: [],\n    }\n\n    // Return a new FlowHandle for the child, sharing renderer and dependencies\n    return new FlowHandleImpl(\n      childTrace,\n      this._clock,\n      this._idGen,\n      this._renderer,\n      { ...this._options }\n    )\n  }\n\n  tag(name: string): void {\n    if (this._completed) return\n    // Deduplicate tags\n    if (!this._trace.tags.includes(name)) {\n      this._trace.tags.push(name)\n    }\n  }\n\n  tags(): string[] {\n    return [...this._trace.tags] // return copy\n  }\n\n  setContext(context: Record<string, unknown>): void {\n    if (this._completed) return\n    // Shallow merge — new keys override, existing keys preserved\n    Object.assign(this._trace.context, context)\n  }\n\n  getContext(): Record<string, unknown> {\n    return { ...this._trace.context } // return copy\n  }\n\n  success(): void {\n    this._finalize('success')\n  }\n\n  fail(error?: unknown): void {\n    this._trace.error = normalizeError(error)\n    this._finalize('error')\n  }\n\n  private _finalize(status: FlowStatus): void {\n    if (this._completed) return // guarded finalization — silent no-op\n    this._completed = true\n\n    this._trace.end = this._clock.now()\n    this._trace.state = 'completed' as FlowState\n    this._trace.status = status\n\n    // Create immutable snapshot\n    const snapshot = createSnapshot(this._trace)\n\n    // Fire subscribers before render\n    _fireSubscribers(snapshot)\n\n    // Atomic render\n    this._renderer.render(snapshot)\n  }\n}\n","/** Contract for ID generation strategies */\nexport interface IdGenerator {\n  generate(): string\n}\n\n/** Default ID generator — 8-char alphanumeric via Math.random */\nexport class RandomIdGenerator implements IdGenerator {\n  generate(): string {\n    return Math.random().toString(36).slice(2, 10)\n  }\n}\n","/** Contract for clock implementations */\nexport interface Clock {\n  now(): number\n}\n\n/** Universal clock — Date.now() works everywhere */\nexport class DateClock implements Clock {\n  now(): number {\n    return Date.now()\n  }\n}\n","export interface SerializeOptions {\n  maxDepth?: number\n  maxLength?: number\n}\n\n/**\n * Safely serialize arbitrary data to a JSON string.\n *\n * Protects against:\n * - Circular references → replaced with \"[Circular]\"\n * - Excessive nesting → maxDepth: 2, strips beyond\n * - Excessive output length → maxLength: 80, truncates with \"…\"\n * - Non-serializable types → Map, Set, Symbol, Function → stringified\n * - Never throws\n */\nexport function safeSerialize(\n  data: unknown,\n  options?: SerializeOptions\n): string {\n  const maxDepth = options?.maxDepth ?? 2\n  const maxLength = options?.maxLength ?? 80\n  const seen = new WeakSet<object>()\n\n  function replacer(key: string, value: unknown): unknown {\n    if (value === null) return null\n    if (value === undefined) return undefined\n\n    if (typeof value === 'function') {\n      return `[Function: ${value.name || 'anonymous'}]`\n    }\n\n    if (typeof value === 'symbol') {\n      return value.toString()\n    }\n\n    if (value instanceof Map) {\n      return `{Map(${value.size})}`\n    }\n\n    if (value instanceof Set) {\n      return `{Set(${value.size})}`\n    }\n\n    if (value instanceof Date) {\n      return value.toISOString()\n    }\n\n    if (value instanceof RegExp) {\n      return value.toString()\n    }\n\n    if (typeof value === 'object') {\n      if (seen.has(value as object)) {\n        return '[Circular]'\n      }\n    }\n\n    return value\n  }\n\n  function serializeWithDepth(obj: unknown, depth: number): unknown {\n    if (depth > maxDepth) {\n      if (obj && typeof obj === 'object') {\n        return '[...]'\n      }\n      return obj\n    }\n\n    if (obj === null || typeof obj !== 'object') {\n      return obj\n    }\n\n    if (obj instanceof Map) {\n      return `{Map(${obj.size})}`\n    }\n\n    if (obj instanceof Set) {\n      return `{Set(${obj.size})}`\n    }\n\n    if (obj instanceof Date) {\n      return obj.toISOString()\n    }\n\n    if (obj instanceof RegExp) {\n      return obj.toString()\n    }\n\n    if (Array.isArray(obj)) {\n      return obj.map((item) => serializeWithDepth(item, depth + 1))\n    }\n\n    const result: Record<string, unknown> = {}\n    seen.add(obj)\n\n    for (const key of Object.keys(obj)) {\n      const value = (obj as Record<string, unknown>)[key]\n      if (typeof value === 'function') {\n        result[key] = `[Function: ${value.name || 'anonymous'}]`\n      } else if (typeof value === 'symbol') {\n        result[key] = value.toString()\n      } else if (value && typeof value === 'object' && seen.has(value as object)) {\n        result[key] = '[Circular]'\n      } else {\n        result[key] = serializeWithDepth(value, depth + 1)\n      }\n    }\n\n    return result\n  }\n\n  try {\n    const depthLimited = serializeWithDepth(data, 0)\n    const json = JSON.stringify(depthLimited, replacer, 0)\n\n    if (json && json.length > maxLength) {\n      return json.slice(0, maxLength) + '…'\n    }\n\n    return json\n  } catch {\n    return '[Unserializable]'\n  }\n}\n","const RESET = '\\x1b[0m'\nconst GREEN = '\\x1b[32m'\nconst RED = '\\x1b[31m'\nconst YELLOW = '\\x1b[33m'\nconst CYAN = '\\x1b[36m'\nconst MAGENTA = '\\x1b[35m'\nconst DIM = '\\x1b[2m'\n\n/** Check if NO_COLOR environment variable is set */\nfunction colorsEnabled(): boolean {\n  if (typeof process !== 'undefined' && process.env?.NO_COLOR) {\n    return false\n  }\n  return true\n}\n\nconst useColors = colorsEnabled()\n\n/** Apply green formatting */\nexport function green(s: string): string {\n  return useColors ? `${GREEN}${s}${RESET}` : s\n}\n\n/** Apply red formatting */\nexport function red(s: string): string {\n  return useColors ? `${RED}${s}${RESET}` : s\n}\n\n/** Apply yellow formatting */\nexport function yellow(s: string): string {\n  return useColors ? `${YELLOW}${s}${RESET}` : s\n}\n\n/** Apply cyan formatting */\nexport function cyan(s: string): string {\n  return useColors ? `${CYAN}${s}${RESET}` : s\n}\n\n/** Apply magenta formatting */\nexport function magenta(s: string): string {\n  return useColors ? `${MAGENTA}${s}${RESET}` : s\n}\n\n/** Apply dim formatting */\nexport function dim(s: string): string {\n  return useColors ? `${DIM}${s}${RESET}` : s\n}\n","import { FlowTrace, StepTrace } from '../core/types'\nimport { FlowRenderer } from './types'\nimport { green, red, cyan, dim } from './ansi'\nimport { safeSerialize } from '../adapter/safe-serializer'\n\n/** Format duration as human-readable string */\nfunction formatDuration(start: number, end?: number): string {\n  if (end === undefined) return '—'\n  const ms = Math.round(end - start)\n  if (ms >= 1000) {\n    return `${(ms / 1000).toFixed(1)}s`\n  }\n  return `${ms}ms`\n}\n\n/** Render a single step with indentation */\nfunction renderStep(\n  step: Readonly<StepTrace>,\n  indent: number,\n  lines: string[]\n): void {\n  const prefix = '  '.repeat(indent)\n\n  // Step start\n  lines.push(`${prefix}${cyan('→')} ${step.name}`)\n\n  // Inline data if present\n  if (step.data !== undefined) {\n    const serialized = safeSerialize(step.data, { maxLength: 80 })\n    lines.push(`${prefix}  ${dim('data:')} ${serialized}`)\n  }\n\n  // Step completion\n  const duration = formatDuration(step.start, step.end)\n  if (step.status === 'success') {\n    lines.push(`${prefix}${green('✓')} ${step.name} (${duration})`)\n  } else if (step.status === 'error') {\n    const errorMsg = step.error?.message ?? 'Unknown error'\n    lines.push(`${prefix}${red('✗')} ${step.name} (error: ${errorMsg})`)\n  } else {\n    lines.push(`${prefix}  ${step.name} (${duration})`)\n  }\n\n  // Render children recursively\n  for (const child of step.children) {\n    renderStep(child, indent + 1, lines)\n  }\n}\n\n/**\n * ConsoleRenderer — deferred, atomic console output with ANSI colors.\n *\n * Produces entire output in a single console.log call on flow completion.\n */\nexport class ConsoleRenderer implements FlowRenderer {\n  render(snapshot: Readonly<FlowTrace>): void {\n    const lines: string[] = []\n\n    // Flow header\n    const tagsStr =\n      snapshot.tags.length > 0\n        ? ` [${snapshot.tags.join(', ')}]`\n        : ''\n    const headerIcon = snapshot.status === 'error' ? '🔥' : '🚀'\n    lines.push(\n      `${headerIcon} [flow:${snapshot.name}]${tagsStr} (${dim('tid:')} ${snapshot.id})`\n    )\n\n    // Steps\n    for (const step of snapshot.steps) {\n      renderStep(step, 1, lines)\n    }\n\n    // Flow completion\n    const duration = formatDuration(snapshot.start, snapshot.end)\n    if (snapshot.status === 'success') {\n      let footer = `🏁 [flow:${snapshot.name}] ${green('success')} (${duration})`\n      if (snapshot.meta?.maxStepsExceeded) {\n        footer += ` ${red('⚠️ maxSteps exceeded')}`\n      }\n      lines.push(footer)\n    } else if (snapshot.status === 'error') {\n      const errorMsg = snapshot.error?.message ?? 'Unknown error'\n      let footer = `🏁 [flow:${snapshot.name}] ${red('failed')} (${duration}, error: ${errorMsg})`\n      if (snapshot.meta?.maxStepsExceeded) {\n        footer += ` ${red('⚠️ maxSteps exceeded')}`\n      }\n      lines.push(footer)\n    }\n\n    // Atomic write — single console call\n    const output = lines.join('\\n')\n    if (snapshot.status === 'error') {\n      console.error(output)\n    } else {\n      console.log(output)\n    }\n  }\n}\n","export { FlowHandle } from './flow-handle'\nexport { StepHandle } from './step-handle'\nexport { RandomIdGenerator } from './id-generator'\nexport { DateClock } from './clock'\nexport { normalizeError } from './error-normalizer'\nexport { safeSerialize, SerializeOptions } from './safe-serializer'\nexport { NOOP_FLOW, NOOP_STEP, NoOpStepHandle, NoOpFlowHandle } from './noop-singletons'\n\nimport { FlowTrace, FlowOptions } from '../core/types'\nimport { FlowHandle, FlowHandleImpl } from './flow-handle'\nimport { IdGenerator, RandomIdGenerator } from './id-generator'\nimport { Clock, DateClock } from './clock'\nimport { ConsoleRenderer } from '../renderer/console'\nimport { NOOP_FLOW } from './noop-singletons'\nimport { subscribe } from './flow-handle'\n\n// Default instances\nconst _defaultIdGen = new RandomIdGenerator()\nconst _defaultClock = new DateClock()\nconst _defaultRenderer = new ConsoleRenderer()\n\n/**\n * Create a new execution flow with a human-readable name and optional configuration.\n *\n * @param name - Human-readable flow name\n * @param options - Optional configuration (enabled, tags, maxSteps)\n * @returns FlowHandle for interacting with the flow\n */\nexport function createFlow(name: string, options?: FlowOptions): FlowHandle {\n  // Silent mode — return NoOp singleton\n  if (options?.enabled === false) {\n    return NOOP_FLOW\n  }\n\n  const trace: FlowTrace = {\n    id: _defaultIdGen.generate(),\n    name,\n    state: 'running',\n    tags: options?.tags ?? [],\n    start: _defaultClock.now(),\n    context: {},\n    steps: [],\n  }\n\n  return new FlowHandleImpl(\n    trace,\n    _defaultClock,\n    _defaultIdGen,\n    _defaultRenderer,\n    options ?? {}\n  )\n}\n\nexport { subscribe }\n","import { FlowTrace, StepTrace } from '../core/types'\nimport { FlowRenderer } from './types'\nimport { safeSerialize } from '../adapter/safe-serializer'\n\n/**\n * JSONRenderer — portable FlowTrace serialization.\n *\n * Outputs versioned JSON structure suitable for downstream consumption.\n */\nexport class JSONRenderer implements FlowRenderer {\n  render(snapshot: Readonly<FlowTrace>): void {\n    const json = toJSON(snapshot)\n    console.log(json)\n  }\n}\n\n/** Check if input is a FlowHandle-like object with a .trace property */\nfunction hasTraceProperty(\n  input: unknown\n): input is { trace: Readonly<FlowTrace> } {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    'trace' in input &&\n    typeof (input as Record<string, unknown>).trace === 'object' &&\n    (input as Record<string, unknown>).trace !== null\n  )\n}\n\n/**\n * Serialize a FlowTrace to versioned JSON string.\n * Accepts either a FlowTrace directly or a FlowHandle (extracts .trace).\n * Omits undefined values for clean output.\n */\nexport function toJSON(input: Readonly<FlowTrace> | { trace: Readonly<FlowTrace> }): string {\n  const trace: Readonly<FlowTrace> = hasTraceProperty(input) ? input.trace : input\n\n  return JSON.stringify(\n    {\n      version: 1,\n      flow: {\n        id: trace.id,\n        name: trace.name,\n        ...(trace.parentId !== undefined && { parentId: trace.parentId }),\n        state: trace.state,\n        ...(trace.status !== undefined && { status: trace.status }),\n        tags: trace.tags,\n        start: trace.start,\n        ...(trace.end !== undefined && { end: trace.end }),\n        ...(trace.error !== undefined && { error: trace.error }),\n        context: trace.context,\n        steps: trace.steps.map(renderStep),\n        ...(trace.meta !== undefined && { meta: trace.meta }),\n      },\n    },\n    null,\n    2\n  )\n}\n\nfunction renderStep(step: Readonly<StepTrace>): unknown {\n  const obj: Record<string, unknown> = {\n    id: step.id,\n    name: step.name,\n    sequence: step.sequence,\n    state: step.state,\n    status: step.status,\n    start: step.start,\n  }\n\n  if (step.end !== undefined) obj.end = step.end\n  if (step.data !== undefined) {\n    obj.data = safeSerialize(step.data)\n  }\n  if (step.error !== undefined) obj.error = step.error\n  if (step.children.length > 0) {\n    obj.children = step.children.map(renderStep)\n  }\n\n  return obj\n}\n"],"mappings":"AAWO,SAASA,EAAeC,EAAiC,CAC9D,OAAIA,IAAU,OACL,CAAE,KAAM,QAAS,QAAS,eAAgB,EAG/CA,aAAiB,MACZ,CACL,KAAMA,EAAM,KACZ,QAASA,EAAM,QACf,MAAOA,EAAM,KACf,EAGE,OAAOA,GAAU,SACZ,CAAE,KAAM,QAAS,QAASA,CAAM,EAGlC,CAAE,KAAM,QAAS,QAAS,OAAOA,CAAK,CAAE,CACjD,CClBO,IAAMC,EAAN,KAA2C,CAGhD,YACmBC,EACAC,EACjB,CAFiB,YAAAD,EACA,YAAAC,EAJnB,KAAQ,WAAa,EAKlB,CAGH,IAAI,aAAuB,CACzB,OAAO,KAAK,UACd,CAGA,IAAI,OAA6B,CAC/B,OAAO,KAAK,MACd,CAEA,SAAgB,CACV,KAAK,aACT,KAAK,WAAa,GAClB,KAAK,OAAO,IAAM,KAAK,OAAO,IAAI,EAClC,KAAK,OAAO,MAAQ,YACpB,KAAK,OAAO,OAAS,UACvB,CAEA,KAAKC,EAAuB,CACtB,KAAK,aACT,KAAK,WAAa,GAClB,KAAK,OAAO,IAAM,KAAK,OAAO,IAAI,EAClC,KAAK,OAAO,MAAQ,YACpB,KAAK,OAAO,OAAS,QACrB,KAAK,OAAO,MAAQC,EAAeD,CAAK,EAC1C,CACF,EC5CA,IAAME,EAAO,IAAM,CAAC,EA0BPC,EAA4B,CACvC,QAASD,EACT,KAAMA,CACR,EAEaE,EAA4B,CACvC,KAAM,IAAMD,EACZ,MAAO,IAAMC,EACb,IAAKF,EACL,KAAM,IAAM,CAAC,EACb,WAAYA,EACZ,WAAY,KAAO,CAAC,GACpB,QAASA,EACT,KAAMA,CACR,ECxCO,SAASG,EAAaC,EAAW,CACtC,IAAMC,EAAO,IAAI,QAEjB,SAASC,EAAMC,EAAyB,CACtC,GAAIA,IAAU,MAAQ,OAAOA,GAAU,SAAU,OAAOA,EACxD,GAAIA,aAAiB,KAAM,OAAO,IAAI,KAAKA,EAAM,QAAQ,CAAC,EAC1D,GAAIA,aAAiB,OAAQ,OAAO,IAAI,OAAOA,EAAM,OAAQA,EAAM,KAAK,EAExE,GAAIF,EAAK,IAAIE,CAAe,EAC1B,OAAOF,EAAK,IAAIE,CAAe,EAGjC,GAAI,MAAM,QAAQA,CAAK,EAAG,CACxB,IAAMC,EAAiB,CAAC,EACxB,OAAAH,EAAK,IAAIE,EAAiBC,CAAG,EACtBA,EAAI,IAAKC,GAASH,EAAMG,CAAI,CAAC,CACtC,CAEA,IAAMC,EAAkC,CAAC,EACzCL,EAAK,IAAIE,EAAiBG,CAAM,EAEhC,QAAWC,KAAO,OAAO,KAAKJ,CAAK,EACjCG,EAAOC,CAAG,EAAIL,EAAOC,EAAkCI,CAAG,CAAC,EAE7D,OAAOD,CACT,CAEA,OAAOJ,EAAMF,CAAG,CAClB,CAGO,SAASQ,EAAcR,EAAqB,CACjD,GAAIA,IAAQ,MAAQ,OAAOA,GAAQ,SAAU,OAAOA,EAIpD,GAFA,OAAO,OAAOA,CAAG,EAEb,MAAM,QAAQA,CAAG,EACnB,QAAWK,KAAQL,EACjBQ,EAAWH,CAAI,MAGjB,SAAWE,KAAO,OAAO,KAAKP,CAAG,EAAG,CAClC,IAAMG,EAASH,EAAgCO,CAAG,EAC9CJ,GAAS,OAAOA,GAAU,UAAY,CAAC,OAAO,SAASA,CAAK,GAC9DK,EAAWL,CAAK,CAEpB,CAGF,OAAOH,CACT,CAGO,SAASS,EAAiCC,EAAuB,CACtE,IAAMC,EAASZ,EAAUW,CAAK,EAC9B,OAAOF,EAAWG,CAAM,CAC1B,CC1BA,IAAMC,EAAa,IAAI,IAMhB,SAASC,EAAUC,EAAoC,CAC5D,OAAAF,EAAW,IAAIE,CAAQ,EAChB,IAAM,CACXF,EAAW,OAAOE,CAAQ,CAC5B,CACF,CAMO,SAASC,EAAiBC,EAAqC,CACpE,GAAIJ,EAAW,OAAS,EACxB,QAAWE,KAAYF,EACrB,GAAI,CACFE,EAASE,CAAQ,CACnB,MAAQ,CAER,CAEJ,CAGO,IAAMC,EAAN,MAAMC,CAAqC,CAIhD,YACmBC,EACAC,EACAC,EACAC,EACAC,EACjB,CALiB,YAAAJ,EACA,YAAAC,EACA,YAAAC,EACA,eAAAC,EACA,cAAAC,EARnB,KAAQ,WAAa,GACrB,KAAQ,UAAY,CAQjB,CAGH,IAAI,aAAuB,CACzB,OAAO,KAAK,UACd,CAGA,IAAI,OAA6B,CAC/B,OAAO,KAAK,MACd,CAEA,KAAKC,EAAcC,EAA4B,CAE7C,GAAI,KAAK,WAAY,OAAOC,EAG5B,IAAMC,EAAW,KAAK,SAAS,SAC/B,GAAIA,IAAa,QAAa,KAAK,OAAO,MAAM,QAAUA,EACxD,OAAI,KAAK,OAAO,OAAS,OACvB,KAAK,OAAO,KAAO,CAAE,iBAAkB,EAAK,EAE5C,KAAK,OAAO,KAAK,iBAAmB,GAE/BD,EAGT,IAAME,EAAuB,CAC3B,GAAI,KAAK,OAAO,SAAS,EACzB,KAAAJ,EACA,SAAU,KAAK,YACf,MAAO,UACP,OAAQ,UACR,MAAO,KAAK,OAAO,IAAI,EACvB,KAAAC,EACA,SAAU,CAAC,CACb,EAEA,YAAK,OAAO,MAAM,KAAKG,CAAS,EACzB,IAAIC,EAAeD,EAAW,KAAK,MAAM,CAClD,CAEA,MAAMJ,EAA0B,CAE9B,GAAI,KAAK,WAAY,OAAOM,EAG5B,GAAI,KAAK,SAAS,UAAY,GAAO,OAAOA,EAE5C,IAAMC,EAAwB,CAC5B,GAAI,KAAK,OAAO,SAAS,EACzB,KAAAP,EACA,SAAU,KAAK,OAAO,GACtB,MAAO,UACP,OAAQ,OACR,KAAM,CAAC,EACP,MAAO,KAAK,OAAO,IAAI,EACvB,QAAS,CAAE,GAAG,KAAK,OAAO,OAAQ,EAClC,MAAO,CAAC,CACV,EAGA,OAAO,IAAIN,EACTa,EACA,KAAK,OACL,KAAK,OACL,KAAK,UACL,CAAE,GAAG,KAAK,QAAS,CACrB,CACF,CAEA,IAAIP,EAAoB,CAClB,KAAK,YAEJ,KAAK,OAAO,KAAK,SAASA,CAAI,GACjC,KAAK,OAAO,KAAK,KAAKA,CAAI,CAE9B,CAEA,MAAiB,CACf,MAAO,CAAC,GAAG,KAAK,OAAO,IAAI,CAC7B,CAEA,WAAWQ,EAAwC,CAC7C,KAAK,YAET,OAAO,OAAO,KAAK,OAAO,QAASA,CAAO,CAC5C,CAEA,YAAsC,CACpC,MAAO,CAAE,GAAG,KAAK,OAAO,OAAQ,CAClC,CAEA,SAAgB,CACd,KAAK,UAAU,SAAS,CAC1B,CAEA,KAAKC,EAAuB,CAC1B,KAAK,OAAO,MAAQC,EAAeD,CAAK,EACxC,KAAK,UAAU,OAAO,CACxB,CAEQ,UAAUE,EAA0B,CAC1C,GAAI,KAAK,WAAY,OACrB,KAAK,WAAa,GAElB,KAAK,OAAO,IAAM,KAAK,OAAO,IAAI,EAClC,KAAK,OAAO,MAAQ,YACpB,KAAK,OAAO,OAASA,EAGrB,IAAMnB,EAAWoB,EAAe,KAAK,MAAM,EAG3CrB,EAAiBC,CAAQ,EAGzB,KAAK,UAAU,OAAOA,CAAQ,CAChC,CACF,ECvLO,IAAMqB,EAAN,KAA+C,CACpD,UAAmB,CACjB,OAAO,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAG,EAAE,CAC/C,CACF,ECJO,IAAMC,EAAN,KAAiC,CACtC,KAAc,CACZ,OAAO,KAAK,IAAI,CAClB,CACF,ECKO,SAASC,EACdC,EACAC,EACQ,CACR,IAAMC,EAAWD,GAAS,UAAY,EAChCE,EAAYF,GAAS,WAAa,GAClCG,EAAO,IAAI,QAEjB,SAASC,EAASC,EAAaC,EAAyB,CACtD,GAAIA,IAAU,KAAM,OAAO,KAC3B,GAAIA,IAAU,OAEd,OAAI,OAAOA,GAAU,WACZ,cAAcA,EAAM,MAAQ,WAAW,IAG5C,OAAOA,GAAU,SACZA,EAAM,SAAS,EAGpBA,aAAiB,IACZ,QAAQA,EAAM,IAAI,KAGvBA,aAAiB,IACZ,QAAQA,EAAM,IAAI,KAGvBA,aAAiB,KACZA,EAAM,YAAY,EAGvBA,aAAiB,OACZA,EAAM,SAAS,EAGpB,OAAOA,GAAU,UACfH,EAAK,IAAIG,CAAe,EACnB,aAIJA,CACT,CAEA,SAASC,EAAmBC,EAAcC,EAAwB,CAChE,GAAIA,EAAQR,EACV,OAAIO,GAAO,OAAOA,GAAQ,SACjB,QAEFA,EAGT,GAAIA,IAAQ,MAAQ,OAAOA,GAAQ,SACjC,OAAOA,EAGT,GAAIA,aAAe,IACjB,MAAO,QAAQA,EAAI,IAAI,KAGzB,GAAIA,aAAe,IACjB,MAAO,QAAQA,EAAI,IAAI,KAGzB,GAAIA,aAAe,KACjB,OAAOA,EAAI,YAAY,EAGzB,GAAIA,aAAe,OACjB,OAAOA,EAAI,SAAS,EAGtB,GAAI,MAAM,QAAQA,CAAG,EACnB,OAAOA,EAAI,IAAKE,GAASH,EAAmBG,EAAMD,EAAQ,CAAC,CAAC,EAG9D,IAAME,EAAkC,CAAC,EACzCR,EAAK,IAAIK,CAAG,EAEZ,QAAWH,KAAO,OAAO,KAAKG,CAAG,EAAG,CAClC,IAAMF,EAASE,EAAgCH,CAAG,EAC9C,OAAOC,GAAU,WACnBK,EAAON,CAAG,EAAI,cAAcC,EAAM,MAAQ,WAAW,IAC5C,OAAOA,GAAU,SAC1BK,EAAON,CAAG,EAAIC,EAAM,SAAS,EACpBA,GAAS,OAAOA,GAAU,UAAYH,EAAK,IAAIG,CAAe,EACvEK,EAAON,CAAG,EAAI,aAEdM,EAAON,CAAG,EAAIE,EAAmBD,EAAOG,EAAQ,CAAC,CAErD,CAEA,OAAOE,CACT,CAEA,GAAI,CACF,IAAMC,EAAeL,EAAmBR,EAAM,CAAC,EACzCc,EAAO,KAAK,UAAUD,EAAcR,EAAU,CAAC,EAErD,OAAIS,GAAQA,EAAK,OAASX,EACjBW,EAAK,MAAM,EAAGX,CAAS,EAAI,SAG7BW,CACT,MAAQ,CACN,MAAO,kBACT,CACF,CC3HA,IAAMC,EAAQ,UACRC,EAAQ,WACRC,EAAM,WAEZ,IAAMC,EAAO,WAEb,IAAMC,EAAM,UAGZ,SAASC,GAAyB,CAChC,MAAI,SAAO,QAAY,KAAe,QAAQ,KAAK,SAIrD,CAEA,IAAMC,EAAYD,EAAc,EAGzB,SAASE,EAAMC,EAAmB,CACvC,OAAOF,EAAY,GAAGG,CAAK,GAAGD,CAAC,GAAGE,CAAK,GAAKF,CAC9C,CAGO,SAASG,EAAIH,EAAmB,CACrC,OAAOF,EAAY,GAAGM,CAAG,GAAGJ,CAAC,GAAGE,CAAK,GAAKF,CAC5C,CAQO,SAASK,EAAKC,EAAmB,CACtC,OAAOC,EAAY,GAAGC,CAAI,GAAGF,CAAC,GAAGG,CAAK,GAAKH,CAC7C,CAQO,SAASI,EAAIC,EAAmB,CACrC,OAAOC,EAAY,GAAGC,CAAG,GAAGF,CAAC,GAAGG,CAAK,GAAKH,CAC5C,CCxCA,SAASI,EAAeC,EAAeC,EAAsB,CAC3D,GAAIA,IAAQ,OAAW,MAAO,SAC9B,IAAMC,EAAK,KAAK,MAAMD,EAAMD,CAAK,EACjC,OAAIE,GAAM,IACD,IAAIA,EAAK,KAAM,QAAQ,CAAC,CAAC,IAE3B,GAAGA,CAAE,IACd,CAGA,SAASC,EACPC,EACAC,EACAC,EACM,CACN,IAAMC,EAAS,KAAK,OAAOF,CAAM,EAMjC,GAHAC,EAAM,KAAK,GAAGC,CAAM,GAAGC,EAAK,QAAG,CAAC,IAAIJ,EAAK,IAAI,EAAE,EAG3CA,EAAK,OAAS,OAAW,CAC3B,IAAMK,EAAaC,EAAcN,EAAK,KAAM,CAAE,UAAW,EAAG,CAAC,EAC7DE,EAAM,KAAK,GAAGC,CAAM,KAAKI,EAAI,OAAO,CAAC,IAAIF,CAAU,EAAE,CACvD,CAGA,IAAMG,EAAWb,EAAeK,EAAK,MAAOA,EAAK,GAAG,EACpD,GAAIA,EAAK,SAAW,UAClBE,EAAM,KAAK,GAAGC,CAAM,GAAGM,EAAM,QAAG,CAAC,IAAIT,EAAK,IAAI,KAAKQ,CAAQ,GAAG,UACrDR,EAAK,SAAW,QAAS,CAClC,IAAMU,EAAWV,EAAK,OAAO,SAAW,gBACxCE,EAAM,KAAK,GAAGC,CAAM,GAAGQ,EAAI,QAAG,CAAC,IAAIX,EAAK,IAAI,YAAYU,CAAQ,GAAG,CACrE,MACER,EAAM,KAAK,GAAGC,CAAM,KAAKH,EAAK,IAAI,KAAKQ,CAAQ,GAAG,EAIpD,QAAWI,KAASZ,EAAK,SACvBD,EAAWa,EAAOX,EAAS,EAAGC,CAAK,CAEvC,CAOO,IAAMW,EAAN,KAA8C,CACnD,OAAOC,EAAqC,CAC1C,IAAMZ,EAAkB,CAAC,EAGnBa,EACJD,EAAS,KAAK,OAAS,EACnB,KAAKA,EAAS,KAAK,KAAK,IAAI,CAAC,IAC7B,GACAE,EAAaF,EAAS,SAAW,QAAU,YAAO,YACxDZ,EAAM,KACJ,GAAGc,CAAU,UAAUF,EAAS,IAAI,IAAIC,CAAO,KAAKR,EAAI,MAAM,CAAC,IAAIO,EAAS,EAAE,GAChF,EAGA,QAAWd,KAAQc,EAAS,MAC1Bf,EAAWC,EAAM,EAAGE,CAAK,EAI3B,IAAMM,EAAWb,EAAemB,EAAS,MAAOA,EAAS,GAAG,EAC5D,GAAIA,EAAS,SAAW,UAAW,CACjC,IAAIG,EAAS,mBAAYH,EAAS,IAAI,KAAKL,EAAM,SAAS,CAAC,KAAKD,CAAQ,IACpEM,EAAS,MAAM,mBACjBG,GAAU,IAAIN,EAAI,gCAAsB,CAAC,IAE3CT,EAAM,KAAKe,CAAM,CACnB,SAAWH,EAAS,SAAW,QAAS,CACtC,IAAMJ,EAAWI,EAAS,OAAO,SAAW,gBACxCG,EAAS,mBAAYH,EAAS,IAAI,KAAKH,EAAI,QAAQ,CAAC,KAAKH,CAAQ,YAAYE,CAAQ,IACrFI,EAAS,MAAM,mBACjBG,GAAU,IAAIN,EAAI,gCAAsB,CAAC,IAE3CT,EAAM,KAAKe,CAAM,CACnB,CAGA,IAAMC,EAAShB,EAAM,KAAK;AAAA,CAAI,EAC1BY,EAAS,SAAW,QACtB,QAAQ,MAAMI,CAAM,EAEpB,QAAQ,IAAIA,CAAM,CAEtB,CACF,ECjFA,IAAMC,EAAgB,IAAIC,EACpBC,EAAgB,IAAIC,EACpBC,EAAmB,IAAIC,EAStB,SAASC,EAAWC,EAAcC,EAAmC,CAE1E,GAAIA,GAAS,UAAY,GACvB,OAAOC,EAGT,IAAMC,EAAmB,CACvB,GAAIV,EAAc,SAAS,EAC3B,KAAAO,EACA,MAAO,UACP,KAAMC,GAAS,MAAQ,CAAC,EACxB,MAAON,EAAc,IAAI,EACzB,QAAS,CAAC,EACV,MAAO,CAAC,CACV,EAEA,OAAO,IAAIS,EACTD,EACAR,EACAF,EACAI,EACAI,GAAW,CAAC,CACd,CACF,CClCA,SAASI,EACPC,EACyC,CACzC,OACE,OAAOA,GAAU,UACjBA,IAAU,MACV,UAAWA,GACX,OAAQA,EAAkC,OAAU,UACnDA,EAAkC,QAAU,IAEjD,CAOO,SAASC,EAAOD,EAAqE,CAC1F,IAAME,EAA6BH,EAAiBC,CAAK,EAAIA,EAAM,MAAQA,EAE3E,OAAO,KAAK,UACV,CACE,QAAS,EACT,KAAM,CACJ,GAAIE,EAAM,GACV,KAAMA,EAAM,KACZ,GAAIA,EAAM,WAAa,QAAa,CAAE,SAAUA,EAAM,QAAS,EAC/D,MAAOA,EAAM,MACb,GAAIA,EAAM,SAAW,QAAa,CAAE,OAAQA,EAAM,MAAO,EACzD,KAAMA,EAAM,KACZ,MAAOA,EAAM,MACb,GAAIA,EAAM,MAAQ,QAAa,CAAE,IAAKA,EAAM,GAAI,EAChD,GAAIA,EAAM,QAAU,QAAa,CAAE,MAAOA,EAAM,KAAM,EACtD,QAASA,EAAM,QACf,MAAOA,EAAM,MAAM,IAAIC,CAAU,EACjC,GAAID,EAAM,OAAS,QAAa,CAAE,KAAMA,EAAM,IAAK,CACrD,CACF,EACA,KACA,CACF,CACF,CAEA,SAASC,EAAWC,EAAoC,CACtD,IAAMC,EAA+B,CACnC,GAAID,EAAK,GACT,KAAMA,EAAK,KACX,SAAUA,EAAK,SACf,MAAOA,EAAK,MACZ,OAAQA,EAAK,OACb,MAAOA,EAAK,KACd,EAEA,OAAIA,EAAK,MAAQ,SAAWC,EAAI,IAAMD,EAAK,KACvCA,EAAK,OAAS,SAChBC,EAAI,KAAOC,EAAcF,EAAK,IAAI,GAEhCA,EAAK,QAAU,SAAWC,EAAI,MAAQD,EAAK,OAC3CA,EAAK,SAAS,OAAS,IACzBC,EAAI,SAAWD,EAAK,SAAS,IAAID,CAAU,GAGtCE,CACT","names":["normalizeError","input","StepHandleImpl","_trace","_clock","error","normalizeError","noop","NOOP_STEP","NOOP_FLOW","cloneDeep","obj","seen","clone","value","arr","item","result","key","deepFreeze","createSnapshot","trace","cloned","_listeners","subscribe","listener","_fireSubscribers","snapshot","FlowHandleImpl","_FlowHandleImpl","_trace","_clock","_idGen","_renderer","_options","name","data","NOOP_STEP","maxSteps","stepTrace","StepHandleImpl","NOOP_FLOW","childTrace","context","error","normalizeError","status","createSnapshot","RandomIdGenerator","DateClock","safeSerialize","data","options","maxDepth","maxLength","seen","replacer","key","value","serializeWithDepth","obj","depth","item","result","depthLimited","json","RESET","GREEN","RED","CYAN","DIM","colorsEnabled","useColors","green","s","GREEN","RESET","red","RED","cyan","s","useColors","CYAN","RESET","dim","s","useColors","DIM","RESET","formatDuration","start","end","ms","renderStep","step","indent","lines","prefix","cyan","serialized","safeSerialize","dim","duration","green","errorMsg","red","child","ConsoleRenderer","snapshot","tagsStr","headerIcon","footer","output","_defaultIdGen","RandomIdGenerator","_defaultClock","DateClock","_defaultRenderer","ConsoleRenderer","createFlow","name","options","NOOP_FLOW","trace","FlowHandleImpl","hasTraceProperty","input","toJSON","trace","renderStep","step","obj","safeSerialize"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@better-logger/core",
+  "version": "0.1.0",
+  "description": "Execution flow debugger for modern apps. Zero deps. Works everywhere. <10KB.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/0xmilord/better-logger"
+  },
+  "author": "0xmilord",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "lint": "eslint src/ --fix",
+    "test": "vitest run --coverage",
+    "build": "tsup src/index.ts --format esm,cjs --dts --minify",
+    "size": "cat dist/index.js | gzip | wc -c",
+    "changeset": "node scripts/new-changeset.cjs",
+    "release": "node scripts/release.cjs",
+    "release:dry-run": "node scripts/release.cjs --dry-run"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "6.0.2",
+    "tsup": "8.5.1",
+    "vitest": "4.1.2",
+    "@vitest/coverage-v8": "4.1.2",
+    "eslint": "10.1.0",
+    "@typescript-eslint/parser": "8.58.0",
+    "@typescript-eslint/eslint-plugin": "8.58.0",
+    "@types/node": "20.11.0"
+  }
+}