joopjs 2.0.0

package/dist/workflow/index.js

@@ -0,0 +1,282 @@
+'use strict';
+
+// src/events/index.ts
+var JoopSubject = class {
+  _listeners = [];
+  subscribe(listener) {
+    this._listeners.push(listener);
+    return () => {
+      this._listeners = this._listeners.filter((l) => l !== listener);
+    };
+  }
+  next(value) {
+    for (const listener of this._listeners) {
+      listener(value);
+    }
+  }
+  asObservable() {
+    return new JoopObservable((listener) => this.subscribe(listener));
+  }
+};
+var JoopBehaviorSubject = class extends JoopSubject {
+  _value;
+  constructor(initialValue) {
+    super();
+    this._value = initialValue;
+  }
+  getValue() {
+    return this._value;
+  }
+  next(value) {
+    this._value = value;
+    super.next(value);
+  }
+  subscribe(listener) {
+    listener(this._value);
+    return super.subscribe(listener);
+  }
+  asObservable() {
+    return new JoopObservable((listener) => this.subscribe(listener));
+  }
+};
+var JoopObservable = class {
+  constructor(_subscribeFn) {
+    this._subscribeFn = _subscribeFn;
+  }
+  _subscribeFn;
+  subscribe(listener) {
+    return this._subscribeFn(listener);
+  }
+  /** Returns the current value without subscribing (only meaningful for BehaviorSubject-backed observables). */
+  getOnce() {
+    let result;
+    const unsub = this.subscribe((v) => {
+      result = v;
+    });
+    unsub();
+    return result;
+  }
+};
+
+// src/workflow/state-machine.ts
+var JoopStateMachine = class {
+  _state$;
+  _transition$ = new JoopSubject();
+  _cfg;
+  _history = [];
+  _context;
+  constructor(config) {
+    this._cfg = config;
+    this._context = config.context;
+    this._state$ = new JoopBehaviorSubject(config.initial);
+    this._cfg.states[config.initial]?.onEnter?.(this._context);
+  }
+  getState() {
+    return this._state$.getValue();
+  }
+  getContext() {
+    return this._context;
+  }
+  state$() {
+    return this._state$.asObservable();
+  }
+  transition$() {
+    return this._transition$.asObservable();
+  }
+  history() {
+    return [...this._history];
+  }
+  matches(state) {
+    return this._state$.getValue() === state;
+  }
+  isFinal() {
+    return this._cfg.states[this.getState()]?.type === "final";
+  }
+  /** Returns true if the event can be sent from current state */
+  can(event) {
+    const cfg = this._cfg.states[this.getState()]?.on;
+    if (!cfg || !(event in cfg)) return false;
+    const t = this._resolveTransition(this.getState(), event);
+    return t !== null;
+  }
+  /** Send an event; returns true if a transition occurred */
+  send(event, context) {
+    const from = this.getState();
+    const stateCfg = this._cfg.states[from];
+    if (!stateCfg?.on || !(event in stateCfg.on)) return false;
+    const t = this._resolveTransition(from, event, context);
+    if (!t) return false;
+    const to = t.target;
+    stateCfg.onExit?.(this._context);
+    t.action?.(this._context);
+    if (context !== void 0) this._context = context;
+    const record = { from, event, to, timestamp: Date.now() };
+    this._history.push(record);
+    this._state$.next(to);
+    this._transition$.next(record);
+    this._cfg.states[to]?.onEnter?.(this._context);
+    return true;
+  }
+  /** Update context without triggering a transition */
+  setContext(ctx) {
+    this._context = ctx;
+  }
+  reset() {
+    const initial = this._cfg.initial;
+    this._state$.next(initial);
+    this._history = [];
+    this._cfg.states[initial]?.onEnter?.(this._context);
+  }
+  /** Export as Mermaid state diagram */
+  toMermaid() {
+    const lines = ["stateDiagram-v2"];
+    lines.push(`  [*] --> ${this._cfg.initial}`);
+    for (const [state, cfg] of Object.entries(this._cfg.states)) {
+      if (cfg.type === "final") lines.push(`  ${state} --> [*]`);
+      if (cfg.on) {
+        for (const [event, trans] of Object.entries(cfg.on)) {
+          const target = typeof trans === "string" ? trans : trans.target;
+          lines.push(`  ${state} --> ${target} : ${event}`);
+        }
+      }
+    }
+    return lines.join("\n");
+  }
+  _resolveTransition(from, event, context) {
+    const rawTrans = this._cfg.states[from]?.on?.[event];
+    if (!rawTrans) return null;
+    const t = typeof rawTrans === "string" ? { target: rawTrans } : rawTrans;
+    if (t.guard && !t.guard(context ?? this._context)) return null;
+    return t;
+  }
+};
+
+// src/workflow/workflow-engine.ts
+var JoopWorkflowEngine = class {
+  _definitions = /* @__PURE__ */ new Map();
+  _runs = /* @__PURE__ */ new Map();
+  _runStatus$ = new JoopSubject();
+  _cancellations = /* @__PURE__ */ new Set();
+  define(workflow) {
+    this._definitions.set(workflow.id, workflow);
+  }
+  undefine(id) {
+    this._definitions.delete(id);
+  }
+  async run(workflowId, input = null) {
+    const def = this._definitions.get(workflowId);
+    if (!def) throw new Error(`JoopWorkflowEngine: unknown workflow '${workflowId}'`);
+    const runId = `${workflowId}_${Date.now()}_${Math.floor(Math.random() * 1e3)}`;
+    const run = {
+      runId,
+      workflowId,
+      status: "running",
+      input,
+      outputs: {},
+      errors: {},
+      startedAt: Date.now()
+    };
+    this._runs.set(runId, run);
+    this._emit(run);
+    const completed = /* @__PURE__ */ new Set();
+    const context = { input, outputs: run.outputs };
+    const remaining = [...def.steps];
+    const executedSteps = [];
+    while (remaining.length > 0) {
+      if (this._cancellations.has(runId)) {
+        run.status = "cancelled";
+        this._emit(run);
+        break;
+      }
+      const ready = remaining.filter((s) => (s.after ?? []).every((dep) => completed.has(dep)));
+      if (ready.length === 0 && remaining.length > 0) throw new Error(`Workflow deadlock in '${workflowId}': circular/missing dependencies`);
+      const results = await Promise.allSettled(ready.map((s) => this._runStep(s, context, runId)));
+      for (let i = 0; i < ready.length; i++) {
+        const step = ready[i];
+        const result = results[i];
+        remaining.splice(remaining.indexOf(step), 1);
+        if (result.status === "fulfilled") {
+          run.outputs[step.id] = result.value;
+          context.outputs = run.outputs;
+          completed.add(step.id);
+          executedSteps.push(step);
+        } else {
+          run.errors[step.id] = String(result.reason);
+          run.status = "failed";
+          break;
+        }
+      }
+      if (run.status === "failed") break;
+    }
+    if (run.status === "failed") {
+      run.status = "compensating";
+      this._emit(run);
+      for (const step of [...executedSteps].reverse()) {
+        if (step.compensate) {
+          try {
+            await step.compensate(context);
+          } catch {
+          }
+        }
+      }
+    } else if (run.status === "running") {
+      run.status = "completed";
+    }
+    run.completedAt = Date.now();
+    this._emit(run);
+    this._cancellations.delete(runId);
+    return {
+      runId,
+      status: run.status === "completed" ? "completed" : "failed",
+      outputs: run.outputs,
+      errors: run.errors,
+      durationMs: run.completedAt - run.startedAt
+    };
+  }
+  cancel(runId) {
+    this._cancellations.add(runId);
+  }
+  status(runId) {
+    return this._runs.get(runId);
+  }
+  history() {
+    return Array.from(this._runs.values());
+  }
+  runStatus$() {
+    return this._runStatus$.asObservable();
+  }
+  async _runStep(step, context, runId) {
+    const maxAttempts = (step.retries ?? 0) + 1;
+    let lastErr;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+      if (this._cancellations.has(runId)) throw new Error("Cancelled");
+      try {
+        const run = step.timeout ? await _withTimeout(step.execute(context), step.timeout, step.id) : await step.execute(context);
+        return run;
+      } catch (e) {
+        lastErr = e;
+      }
+    }
+    throw lastErr;
+  }
+  _emit(run) {
+    this._runStatus$.next({ ...run });
+  }
+};
+function _withTimeout(promise, ms, id) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`Step '${id}' timed out after ${ms}ms`)), ms);
+    promise.then((v) => {
+      clearTimeout(timer);
+      resolve(v);
+    }, (e) => {
+      clearTimeout(timer);
+      reject(e);
+    });
+  });
+}
+
+exports.JoopStateMachine = JoopStateMachine;
+exports.JoopWorkflowEngine = JoopWorkflowEngine;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/events/index.ts","../../src/workflow/state-machine.ts","../../src/workflow/workflow-engine.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export type Unsubscribe = () => void;\nexport type Listener<T> = (value: T) => void;\n\n/**\n * Lightweight pub/sub subject — emits to all current subscribers.\n * Replaces RxJS Subject without pulling in the full RxJS dependency.\n */\nexport class JoopSubject<T> {\n  private _listeners: Listener<T>[] = [];\n\n  subscribe(listener: Listener<T>): Unsubscribe {\n    this._listeners.push(listener);\n    return () => {\n      this._listeners = this._listeners.filter(l => l !== listener);\n    };\n  }\n\n  next(value: T): void {\n    for (const listener of this._listeners) {\n      listener(value);\n    }\n  }\n\n  asObservable(): JoopObservable<T> {\n    return new JoopObservable<T>(listener => this.subscribe(listener));\n  }\n}\n\n/**\n * Stateful subject — replays the current value to any new subscriber immediately.\n * Replaces RxJS BehaviorSubject.\n */\nexport class JoopBehaviorSubject<T> extends JoopSubject<T> {\n  private _value: T;\n\n  constructor(initialValue: T) {\n    super();\n    this._value = initialValue;\n  }\n\n  getValue(): T {\n    return this._value;\n  }\n\n  override next(value: T): void {\n    this._value = value;\n    super.next(value);\n  }\n\n  override subscribe(listener: Listener<T>): Unsubscribe {\n    listener(this._value);\n    return super.subscribe(listener);\n  }\n\n  override asObservable(): JoopObservable<T> {\n    return new JoopObservable<T>(listener => this.subscribe(listener));\n  }\n}\n\n/**\n * Read-only observable handle returned from asObservable().\n */\nexport class JoopObservable<T> {\n  constructor(private _subscribeFn: (listener: Listener<T>) => Unsubscribe) {}\n\n  subscribe(listener: Listener<T>): Unsubscribe {\n    return this._subscribeFn(listener);\n  }\n\n  /** Returns the current value without subscribing (only meaningful for BehaviorSubject-backed observables). */\n  getOnce(): T | undefined {\n    let result: T | undefined;\n    const unsub = this.subscribe(v => { result = v; });\n    unsub();\n    return result;\n  }\n}\n","import { JoopBehaviorSubject, JoopSubject } from '../events';\n\nexport interface JoopTransition<S extends string, E extends string> {\n  target: S;\n  guard?: (context?: unknown) => boolean;\n  action?: (context?: unknown) => void;\n}\n\nexport interface JoopStateConfig<S extends string, E extends string> {\n  on?: Partial<Record<E, JoopTransition<S, E> | S>>;\n  onEnter?: (context?: unknown) => void;\n  onExit?: (context?: unknown) => void;\n  type?: 'final' | 'normal';\n}\n\nexport interface JoopMachineConfig<S extends string, E extends string> {\n  id?: string;\n  initial: S;\n  context?: unknown;\n  states: Record<S, JoopStateConfig<S, E>>;\n}\n\nexport interface JoopStateTransition<S extends string, E extends string> {\n  from: S;\n  event: E;\n  to: S;\n  timestamp: number;\n}\n\nexport class JoopStateMachine<S extends string, E extends string> {\n  private _state$: JoopBehaviorSubject<S>;\n  private _transition$ = new JoopSubject<JoopStateTransition<S, E>>();\n  private _cfg: JoopMachineConfig<S, E>;\n  private _history: JoopStateTransition<S, E>[] = [];\n  private _context: unknown;\n\n  constructor(config: JoopMachineConfig<S, E>) {\n    this._cfg = config;\n    this._context = config.context;\n    this._state$ = new JoopBehaviorSubject<S>(config.initial);\n    this._cfg.states[config.initial]?.onEnter?.(this._context);\n  }\n\n  getState(): S { return this._state$.getValue(); }\n  getContext(): unknown { return this._context; }\n  state$() { return this._state$.asObservable(); }\n  transition$() { return this._transition$.asObservable(); }\n  history(): JoopStateTransition<S, E>[] { return [...this._history]; }\n\n  matches(state: S): boolean { return this._state$.getValue() === state; }\n  isFinal(): boolean { return this._cfg.states[this.getState()]?.type === 'final'; }\n\n  /** Returns true if the event can be sent from current state */\n  can(event: E): boolean {\n    const cfg = this._cfg.states[this.getState()]?.on;\n    if (!cfg || !(event in cfg)) return false;\n    const t = this._resolveTransition(this.getState(), event);\n    return t !== null;\n  }\n\n  /** Send an event; returns true if a transition occurred */\n  send(event: E, context?: unknown): boolean {\n    const from = this.getState();\n    const stateCfg = this._cfg.states[from];\n    if (!stateCfg?.on || !(event in stateCfg.on)) return false;\n\n    const t = this._resolveTransition(from, event, context);\n    if (!t) return false;\n\n    const to = t.target;\n    stateCfg.onExit?.(this._context);\n    t.action?.(this._context);\n    if (context !== undefined) this._context = context;\n\n    const record: JoopStateTransition<S, E> = { from, event, to, timestamp: Date.now() };\n    this._history.push(record);\n    this._state$.next(to);\n    this._transition$.next(record);\n\n    this._cfg.states[to]?.onEnter?.(this._context);\n    return true;\n  }\n\n  /** Update context without triggering a transition */\n  setContext(ctx: unknown): void { this._context = ctx; }\n\n  reset(): void {\n    const initial = this._cfg.initial;\n    this._state$.next(initial);\n    this._history = [];\n    this._cfg.states[initial]?.onEnter?.(this._context);\n  }\n\n  /** Export as Mermaid state diagram */\n  toMermaid(): string {\n    const lines = ['stateDiagram-v2'];\n    lines.push(`  [*] --> ${this._cfg.initial}`);\n    for (const [state, cfg] of Object.entries(this._cfg.states) as Array<[S, JoopStateConfig<S,E>]>) {\n      if (cfg.type === 'final') lines.push(`  ${state} --> [*]`);\n      if (cfg.on) {\n        for (const [event, trans] of Object.entries(cfg.on)) {\n          const target = typeof trans === 'string' ? trans : (trans as JoopTransition<S,E>).target;\n          lines.push(`  ${state} --> ${target} : ${event}`);\n        }\n      }\n    }\n    return lines.join('\\n');\n  }\n\n  private _resolveTransition(from: S, event: E, context?: unknown): JoopTransition<S, E> | null {\n    const rawTrans = this._cfg.states[from]?.on?.[event];\n    if (!rawTrans) return null;\n    const t: JoopTransition<S, E> = typeof rawTrans === 'string' ? { target: rawTrans as S } : rawTrans;\n    if (t.guard && !t.guard(context ?? this._context)) return null;\n    return t;\n  }\n}\n","import { JoopBehaviorSubject, JoopSubject } from '../events';\n\nexport interface JoopWorkflowStep {\n  id: string;\n  name?: string;\n  after?: string[];                                      // step IDs this depends on\n  execute: (context: unknown) => Promise<unknown>;\n  compensate?: (context: unknown) => Promise<void>;     // saga rollback\n  timeout?: number;\n  retries?: number;\n}\n\nexport interface JoopWorkflowDefinition {\n  id: string;\n  steps: JoopWorkflowStep[];\n}\n\nexport type JoopWorkflowRunStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'compensating';\n\nexport interface JoopWorkflowRun {\n  runId: string;\n  workflowId: string;\n  status: JoopWorkflowRunStatus;\n  input: unknown;\n  outputs: Record<string, unknown>;\n  errors: Record<string, string>;\n  startedAt: number;\n  completedAt?: number;\n}\n\nexport interface JoopWorkflowResult {\n  runId: string;\n  status: 'completed' | 'failed';\n  outputs: Record<string, unknown>;\n  errors: Record<string, string>;\n  durationMs: number;\n}\n\nexport class JoopWorkflowEngine {\n  private _definitions = new Map<string, JoopWorkflowDefinition>();\n  private _runs = new Map<string, JoopWorkflowRun>();\n  private _runStatus$ = new JoopSubject<JoopWorkflowRun>();\n  private _cancellations = new Set<string>();\n\n  define(workflow: JoopWorkflowDefinition): void { this._definitions.set(workflow.id, workflow); }\n  undefine(id: string): void { this._definitions.delete(id); }\n\n  async run(workflowId: string, input: unknown = null): Promise<JoopWorkflowResult> {\n    const def = this._definitions.get(workflowId);\n    if (!def) throw new Error(`JoopWorkflowEngine: unknown workflow '${workflowId}'`);\n\n    const runId = `${workflowId}_${Date.now()}_${Math.floor(Math.random() * 1000)}`;\n    const run: JoopWorkflowRun = {\n      runId, workflowId, status: 'running',\n      input, outputs: {}, errors: {}, startedAt: Date.now(),\n    };\n    this._runs.set(runId, run);\n    this._emit(run);\n\n    const completed = new Set<string>();\n    const context = { input, outputs: run.outputs };\n\n    // Build execution order respecting `after` dependencies\n    const remaining = [...def.steps];\n    const executedSteps: JoopWorkflowStep[] = [];\n\n    while (remaining.length > 0) {\n      if (this._cancellations.has(runId)) {\n        run.status = 'cancelled'; this._emit(run); break;\n      }\n\n      // Find steps whose dependencies are all satisfied\n      const ready = remaining.filter(s => (s.after ?? []).every(dep => completed.has(dep)));\n      if (ready.length === 0 && remaining.length > 0) throw new Error(`Workflow deadlock in '${workflowId}': circular/missing dependencies`);\n\n      // Run ready steps in parallel\n      const results = await Promise.allSettled(ready.map(s => this._runStep(s, context, runId)));\n      for (let i = 0; i < ready.length; i++) {\n        const step = ready[i];\n        const result = results[i];\n        remaining.splice(remaining.indexOf(step), 1);\n        if (result.status === 'fulfilled') {\n          run.outputs[step.id] = result.value;\n          (context as Record<string, unknown>).outputs = run.outputs;\n          completed.add(step.id);\n          executedSteps.push(step);\n        } else {\n          run.errors[step.id] = String(result.reason);\n          run.status = 'failed';\n          break;\n        }\n      }\n      if (run.status === 'failed') break;\n    }\n\n    if (run.status === 'failed') {\n      // Saga: compensate in reverse order\n      run.status = 'compensating'; this._emit(run);\n      for (const step of [...executedSteps].reverse()) {\n        if (step.compensate) { try { await step.compensate(context); } catch { /* best effort */ } }\n      }\n    } else if (run.status === 'running') {\n      run.status = 'completed';\n    }\n\n    run.completedAt = Date.now();\n    this._emit(run);\n    this._cancellations.delete(runId);\n\n    return {\n      runId,\n      status: run.status === 'completed' ? 'completed' : 'failed',\n      outputs: run.outputs,\n      errors: run.errors,\n      durationMs: run.completedAt - run.startedAt,\n    };\n  }\n\n  cancel(runId: string): void { this._cancellations.add(runId); }\n\n  status(runId: string): JoopWorkflowRun | undefined { return this._runs.get(runId); }\n  history(): JoopWorkflowRun[] { return Array.from(this._runs.values()); }\n  runStatus$() { return this._runStatus$.asObservable(); }\n\n  private async _runStep(step: JoopWorkflowStep, context: unknown, runId: string): Promise<unknown> {\n    const maxAttempts = (step.retries ?? 0) + 1;\n    let lastErr: unknown;\n    for (let attempt = 0; attempt < maxAttempts; attempt++) {\n      if (this._cancellations.has(runId)) throw new Error('Cancelled');\n      try {\n        const run = step.timeout\n          ? await _withTimeout(step.execute(context), step.timeout, step.id)\n          : await step.execute(context);\n        return run;\n      } catch (e) { lastErr = e; }\n    }\n    throw lastErr;\n  }\n\n  private _emit(run: JoopWorkflowRun): void { this._runStatus$.next({ ...run }); }\n}\n\nfunction _withTimeout<T>(promise: Promise<T>, ms: number, id: string): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => reject(new Error(`Step '${id}' timed out after ${ms}ms`)), ms);\n    promise.then(v => { clearTimeout(timer); resolve(v); }, e => { clearTimeout(timer); reject(e); });\n  });\n}\n"]}

package/dist/workflow/index.mjs

@@ -0,0 +1,279 @@
+// src/events/index.ts
+var JoopSubject = class {
+  _listeners = [];
+  subscribe(listener) {
+    this._listeners.push(listener);
+    return () => {
+      this._listeners = this._listeners.filter((l) => l !== listener);
+    };
+  }
+  next(value) {
+    for (const listener of this._listeners) {
+      listener(value);
+    }
+  }
+  asObservable() {
+    return new JoopObservable((listener) => this.subscribe(listener));
+  }
+};
+var JoopBehaviorSubject = class extends JoopSubject {
+  _value;
+  constructor(initialValue) {
+    super();
+    this._value = initialValue;
+  }
+  getValue() {
+    return this._value;
+  }
+  next(value) {
+    this._value = value;
+    super.next(value);
+  }
+  subscribe(listener) {
+    listener(this._value);
+    return super.subscribe(listener);
+  }
+  asObservable() {
+    return new JoopObservable((listener) => this.subscribe(listener));
+  }
+};
+var JoopObservable = class {
+  constructor(_subscribeFn) {
+    this._subscribeFn = _subscribeFn;
+  }
+  _subscribeFn;
+  subscribe(listener) {
+    return this._subscribeFn(listener);
+  }
+  /** Returns the current value without subscribing (only meaningful for BehaviorSubject-backed observables). */
+  getOnce() {
+    let result;
+    const unsub = this.subscribe((v) => {
+      result = v;
+    });
+    unsub();
+    return result;
+  }
+};
+
+// src/workflow/state-machine.ts
+var JoopStateMachine = class {
+  _state$;
+  _transition$ = new JoopSubject();
+  _cfg;
+  _history = [];
+  _context;
+  constructor(config) {
+    this._cfg = config;
+    this._context = config.context;
+    this._state$ = new JoopBehaviorSubject(config.initial);
+    this._cfg.states[config.initial]?.onEnter?.(this._context);
+  }
+  getState() {
+    return this._state$.getValue();
+  }
+  getContext() {
+    return this._context;
+  }
+  state$() {
+    return this._state$.asObservable();
+  }
+  transition$() {
+    return this._transition$.asObservable();
+  }
+  history() {
+    return [...this._history];
+  }
+  matches(state) {
+    return this._state$.getValue() === state;
+  }
+  isFinal() {
+    return this._cfg.states[this.getState()]?.type === "final";
+  }
+  /** Returns true if the event can be sent from current state */
+  can(event) {
+    const cfg = this._cfg.states[this.getState()]?.on;
+    if (!cfg || !(event in cfg)) return false;
+    const t = this._resolveTransition(this.getState(), event);
+    return t !== null;
+  }
+  /** Send an event; returns true if a transition occurred */
+  send(event, context) {
+    const from = this.getState();
+    const stateCfg = this._cfg.states[from];
+    if (!stateCfg?.on || !(event in stateCfg.on)) return false;
+    const t = this._resolveTransition(from, event, context);
+    if (!t) return false;
+    const to = t.target;
+    stateCfg.onExit?.(this._context);
+    t.action?.(this._context);
+    if (context !== void 0) this._context = context;
+    const record = { from, event, to, timestamp: Date.now() };
+    this._history.push(record);
+    this._state$.next(to);
+    this._transition$.next(record);
+    this._cfg.states[to]?.onEnter?.(this._context);
+    return true;
+  }
+  /** Update context without triggering a transition */
+  setContext(ctx) {
+    this._context = ctx;
+  }
+  reset() {
+    const initial = this._cfg.initial;
+    this._state$.next(initial);
+    this._history = [];
+    this._cfg.states[initial]?.onEnter?.(this._context);
+  }
+  /** Export as Mermaid state diagram */
+  toMermaid() {
+    const lines = ["stateDiagram-v2"];
+    lines.push(`  [*] --> ${this._cfg.initial}`);
+    for (const [state, cfg] of Object.entries(this._cfg.states)) {
+      if (cfg.type === "final") lines.push(`  ${state} --> [*]`);
+      if (cfg.on) {
+        for (const [event, trans] of Object.entries(cfg.on)) {
+          const target = typeof trans === "string" ? trans : trans.target;
+          lines.push(`  ${state} --> ${target} : ${event}`);
+        }
+      }
+    }
+    return lines.join("\n");
+  }
+  _resolveTransition(from, event, context) {
+    const rawTrans = this._cfg.states[from]?.on?.[event];
+    if (!rawTrans) return null;
+    const t = typeof rawTrans === "string" ? { target: rawTrans } : rawTrans;
+    if (t.guard && !t.guard(context ?? this._context)) return null;
+    return t;
+  }
+};
+
+// src/workflow/workflow-engine.ts
+var JoopWorkflowEngine = class {
+  _definitions = /* @__PURE__ */ new Map();
+  _runs = /* @__PURE__ */ new Map();
+  _runStatus$ = new JoopSubject();
+  _cancellations = /* @__PURE__ */ new Set();
+  define(workflow) {
+    this._definitions.set(workflow.id, workflow);
+  }
+  undefine(id) {
+    this._definitions.delete(id);
+  }
+  async run(workflowId, input = null) {
+    const def = this._definitions.get(workflowId);
+    if (!def) throw new Error(`JoopWorkflowEngine: unknown workflow '${workflowId}'`);
+    const runId = `${workflowId}_${Date.now()}_${Math.floor(Math.random() * 1e3)}`;
+    const run = {
+      runId,
+      workflowId,
+      status: "running",
+      input,
+      outputs: {},
+      errors: {},
+      startedAt: Date.now()
+    };
+    this._runs.set(runId, run);
+    this._emit(run);
+    const completed = /* @__PURE__ */ new Set();
+    const context = { input, outputs: run.outputs };
+    const remaining = [...def.steps];
+    const executedSteps = [];
+    while (remaining.length > 0) {
+      if (this._cancellations.has(runId)) {
+        run.status = "cancelled";
+        this._emit(run);
+        break;
+      }
+      const ready = remaining.filter((s) => (s.after ?? []).every((dep) => completed.has(dep)));
+      if (ready.length === 0 && remaining.length > 0) throw new Error(`Workflow deadlock in '${workflowId}': circular/missing dependencies`);
+      const results = await Promise.allSettled(ready.map((s) => this._runStep(s, context, runId)));
+      for (let i = 0; i < ready.length; i++) {
+        const step = ready[i];
+        const result = results[i];
+        remaining.splice(remaining.indexOf(step), 1);
+        if (result.status === "fulfilled") {
+          run.outputs[step.id] = result.value;
+          context.outputs = run.outputs;
+          completed.add(step.id);
+          executedSteps.push(step);
+        } else {
+          run.errors[step.id] = String(result.reason);
+          run.status = "failed";
+          break;
+        }
+      }
+      if (run.status === "failed") break;
+    }
+    if (run.status === "failed") {
+      run.status = "compensating";
+      this._emit(run);
+      for (const step of [...executedSteps].reverse()) {
+        if (step.compensate) {
+          try {
+            await step.compensate(context);
+          } catch {
+          }
+        }
+      }
+    } else if (run.status === "running") {
+      run.status = "completed";
+    }
+    run.completedAt = Date.now();
+    this._emit(run);
+    this._cancellations.delete(runId);
+    return {
+      runId,
+      status: run.status === "completed" ? "completed" : "failed",
+      outputs: run.outputs,
+      errors: run.errors,
+      durationMs: run.completedAt - run.startedAt
+    };
+  }
+  cancel(runId) {
+    this._cancellations.add(runId);
+  }
+  status(runId) {
+    return this._runs.get(runId);
+  }
+  history() {
+    return Array.from(this._runs.values());
+  }
+  runStatus$() {
+    return this._runStatus$.asObservable();
+  }
+  async _runStep(step, context, runId) {
+    const maxAttempts = (step.retries ?? 0) + 1;
+    let lastErr;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+      if (this._cancellations.has(runId)) throw new Error("Cancelled");
+      try {
+        const run = step.timeout ? await _withTimeout(step.execute(context), step.timeout, step.id) : await step.execute(context);
+        return run;
+      } catch (e) {
+        lastErr = e;
+      }
+    }
+    throw lastErr;
+  }
+  _emit(run) {
+    this._runStatus$.next({ ...run });
+  }
+};
+function _withTimeout(promise, ms, id) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`Step '${id}' timed out after ${ms}ms`)), ms);
+    promise.then((v) => {
+      clearTimeout(timer);
+      resolve(v);
+    }, (e) => {
+      clearTimeout(timer);
+      reject(e);
+    });
+  });
+}
+
+export { JoopStateMachine, JoopWorkflowEngine };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/workflow/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/events/index.ts","../../src/workflow/state-machine.ts","../../src/workflow/workflow-engine.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["export type Unsubscribe = () => void;\nexport type Listener<T> = (value: T) => void;\n\n/**\n * Lightweight pub/sub subject — emits to all current subscribers.\n * Replaces RxJS Subject without pulling in the full RxJS dependency.\n */\nexport class JoopSubject<T> {\n  private _listeners: Listener<T>[] = [];\n\n  subscribe(listener: Listener<T>): Unsubscribe {\n    this._listeners.push(listener);\n    return () => {\n      this._listeners = this._listeners.filter(l => l !== listener);\n    };\n  }\n\n  next(value: T): void {\n    for (const listener of this._listeners) {\n      listener(value);\n    }\n  }\n\n  asObservable(): JoopObservable<T> {\n    return new JoopObservable<T>(listener => this.subscribe(listener));\n  }\n}\n\n/**\n * Stateful subject — replays the current value to any new subscriber immediately.\n * Replaces RxJS BehaviorSubject.\n */\nexport class JoopBehaviorSubject<T> extends JoopSubject<T> {\n  private _value: T;\n\n  constructor(initialValue: T) {\n    super();\n    this._value = initialValue;\n  }\n\n  getValue(): T {\n    return this._value;\n  }\n\n  override next(value: T): void {\n    this._value = value;\n    super.next(value);\n  }\n\n  override subscribe(listener: Listener<T>): Unsubscribe {\n    listener(this._value);\n    return super.subscribe(listener);\n  }\n\n  override asObservable(): JoopObservable<T> {\n    return new JoopObservable<T>(listener => this.subscribe(listener));\n  }\n}\n\n/**\n * Read-only observable handle returned from asObservable().\n */\nexport class JoopObservable<T> {\n  constructor(private _subscribeFn: (listener: Listener<T>) => Unsubscribe) {}\n\n  subscribe(listener: Listener<T>): Unsubscribe {\n    return this._subscribeFn(listener);\n  }\n\n  /** Returns the current value without subscribing (only meaningful for BehaviorSubject-backed observables). */\n  getOnce(): T | undefined {\n    let result: T | undefined;\n    const unsub = this.subscribe(v => { result = v; });\n    unsub();\n    return result;\n  }\n}\n","import { JoopBehaviorSubject, JoopSubject } from '../events';\n\nexport interface JoopTransition<S extends string, E extends string> {\n  target: S;\n  guard?: (context?: unknown) => boolean;\n  action?: (context?: unknown) => void;\n}\n\nexport interface JoopStateConfig<S extends string, E extends string> {\n  on?: Partial<Record<E, JoopTransition<S, E> | S>>;\n  onEnter?: (context?: unknown) => void;\n  onExit?: (context?: unknown) => void;\n  type?: 'final' | 'normal';\n}\n\nexport interface JoopMachineConfig<S extends string, E extends string> {\n  id?: string;\n  initial: S;\n  context?: unknown;\n  states: Record<S, JoopStateConfig<S, E>>;\n}\n\nexport interface JoopStateTransition<S extends string, E extends string> {\n  from: S;\n  event: E;\n  to: S;\n  timestamp: number;\n}\n\nexport class JoopStateMachine<S extends string, E extends string> {\n  private _state$: JoopBehaviorSubject<S>;\n  private _transition$ = new JoopSubject<JoopStateTransition<S, E>>();\n  private _cfg: JoopMachineConfig<S, E>;\n  private _history: JoopStateTransition<S, E>[] = [];\n  private _context: unknown;\n\n  constructor(config: JoopMachineConfig<S, E>) {\n    this._cfg = config;\n    this._context = config.context;\n    this._state$ = new JoopBehaviorSubject<S>(config.initial);\n    this._cfg.states[config.initial]?.onEnter?.(this._context);\n  }\n\n  getState(): S { return this._state$.getValue(); }\n  getContext(): unknown { return this._context; }\n  state$() { return this._state$.asObservable(); }\n  transition$() { return this._transition$.asObservable(); }\n  history(): JoopStateTransition<S, E>[] { return [...this._history]; }\n\n  matches(state: S): boolean { return this._state$.getValue() === state; }\n  isFinal(): boolean { return this._cfg.states[this.getState()]?.type === 'final'; }\n\n  /** Returns true if the event can be sent from current state */\n  can(event: E): boolean {\n    const cfg = this._cfg.states[this.getState()]?.on;\n    if (!cfg || !(event in cfg)) return false;\n    const t = this._resolveTransition(this.getState(), event);\n    return t !== null;\n  }\n\n  /** Send an event; returns true if a transition occurred */\n  send(event: E, context?: unknown): boolean {\n    const from = this.getState();\n    const stateCfg = this._cfg.states[from];\n    if (!stateCfg?.on || !(event in stateCfg.on)) return false;\n\n    const t = this._resolveTransition(from, event, context);\n    if (!t) return false;\n\n    const to = t.target;\n    stateCfg.onExit?.(this._context);\n    t.action?.(this._context);\n    if (context !== undefined) this._context = context;\n\n    const record: JoopStateTransition<S, E> = { from, event, to, timestamp: Date.now() };\n    this._history.push(record);\n    this._state$.next(to);\n    this._transition$.next(record);\n\n    this._cfg.states[to]?.onEnter?.(this._context);\n    return true;\n  }\n\n  /** Update context without triggering a transition */\n  setContext(ctx: unknown): void { this._context = ctx; }\n\n  reset(): void {\n    const initial = this._cfg.initial;\n    this._state$.next(initial);\n    this._history = [];\n    this._cfg.states[initial]?.onEnter?.(this._context);\n  }\n\n  /** Export as Mermaid state diagram */\n  toMermaid(): string {\n    const lines = ['stateDiagram-v2'];\n    lines.push(`  [*] --> ${this._cfg.initial}`);\n    for (const [state, cfg] of Object.entries(this._cfg.states) as Array<[S, JoopStateConfig<S,E>]>) {\n      if (cfg.type === 'final') lines.push(`  ${state} --> [*]`);\n      if (cfg.on) {\n        for (const [event, trans] of Object.entries(cfg.on)) {\n          const target = typeof trans === 'string' ? trans : (trans as JoopTransition<S,E>).target;\n          lines.push(`  ${state} --> ${target} : ${event}`);\n        }\n      }\n    }\n    return lines.join('\\n');\n  }\n\n  private _resolveTransition(from: S, event: E, context?: unknown): JoopTransition<S, E> | null {\n    const rawTrans = this._cfg.states[from]?.on?.[event];\n    if (!rawTrans) return null;\n    const t: JoopTransition<S, E> = typeof rawTrans === 'string' ? { target: rawTrans as S } : rawTrans;\n    if (t.guard && !t.guard(context ?? this._context)) return null;\n    return t;\n  }\n}\n","import { JoopBehaviorSubject, JoopSubject } from '../events';\n\nexport interface JoopWorkflowStep {\n  id: string;\n  name?: string;\n  after?: string[];                                      // step IDs this depends on\n  execute: (context: unknown) => Promise<unknown>;\n  compensate?: (context: unknown) => Promise<void>;     // saga rollback\n  timeout?: number;\n  retries?: number;\n}\n\nexport interface JoopWorkflowDefinition {\n  id: string;\n  steps: JoopWorkflowStep[];\n}\n\nexport type JoopWorkflowRunStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'compensating';\n\nexport interface JoopWorkflowRun {\n  runId: string;\n  workflowId: string;\n  status: JoopWorkflowRunStatus;\n  input: unknown;\n  outputs: Record<string, unknown>;\n  errors: Record<string, string>;\n  startedAt: number;\n  completedAt?: number;\n}\n\nexport interface JoopWorkflowResult {\n  runId: string;\n  status: 'completed' | 'failed';\n  outputs: Record<string, unknown>;\n  errors: Record<string, string>;\n  durationMs: number;\n}\n\nexport class JoopWorkflowEngine {\n  private _definitions = new Map<string, JoopWorkflowDefinition>();\n  private _runs = new Map<string, JoopWorkflowRun>();\n  private _runStatus$ = new JoopSubject<JoopWorkflowRun>();\n  private _cancellations = new Set<string>();\n\n  define(workflow: JoopWorkflowDefinition): void { this._definitions.set(workflow.id, workflow); }\n  undefine(id: string): void { this._definitions.delete(id); }\n\n  async run(workflowId: string, input: unknown = null): Promise<JoopWorkflowResult> {\n    const def = this._definitions.get(workflowId);\n    if (!def) throw new Error(`JoopWorkflowEngine: unknown workflow '${workflowId}'`);\n\n    const runId = `${workflowId}_${Date.now()}_${Math.floor(Math.random() * 1000)}`;\n    const run: JoopWorkflowRun = {\n      runId, workflowId, status: 'running',\n      input, outputs: {}, errors: {}, startedAt: Date.now(),\n    };\n    this._runs.set(runId, run);\n    this._emit(run);\n\n    const completed = new Set<string>();\n    const context = { input, outputs: run.outputs };\n\n    // Build execution order respecting `after` dependencies\n    const remaining = [...def.steps];\n    const executedSteps: JoopWorkflowStep[] = [];\n\n    while (remaining.length > 0) {\n      if (this._cancellations.has(runId)) {\n        run.status = 'cancelled'; this._emit(run); break;\n      }\n\n      // Find steps whose dependencies are all satisfied\n      const ready = remaining.filter(s => (s.after ?? []).every(dep => completed.has(dep)));\n      if (ready.length === 0 && remaining.length > 0) throw new Error(`Workflow deadlock in '${workflowId}': circular/missing dependencies`);\n\n      // Run ready steps in parallel\n      const results = await Promise.allSettled(ready.map(s => this._runStep(s, context, runId)));\n      for (let i = 0; i < ready.length; i++) {\n        const step = ready[i];\n        const result = results[i];\n        remaining.splice(remaining.indexOf(step), 1);\n        if (result.status === 'fulfilled') {\n          run.outputs[step.id] = result.value;\n          (context as Record<string, unknown>).outputs = run.outputs;\n          completed.add(step.id);\n          executedSteps.push(step);\n        } else {\n          run.errors[step.id] = String(result.reason);\n          run.status = 'failed';\n          break;\n        }\n      }\n      if (run.status === 'failed') break;\n    }\n\n    if (run.status === 'failed') {\n      // Saga: compensate in reverse order\n      run.status = 'compensating'; this._emit(run);\n      for (const step of [...executedSteps].reverse()) {\n        if (step.compensate) { try { await step.compensate(context); } catch { /* best effort */ } }\n      }\n    } else if (run.status === 'running') {\n      run.status = 'completed';\n    }\n\n    run.completedAt = Date.now();\n    this._emit(run);\n    this._cancellations.delete(runId);\n\n    return {\n      runId,\n      status: run.status === 'completed' ? 'completed' : 'failed',\n      outputs: run.outputs,\n      errors: run.errors,\n      durationMs: run.completedAt - run.startedAt,\n    };\n  }\n\n  cancel(runId: string): void { this._cancellations.add(runId); }\n\n  status(runId: string): JoopWorkflowRun | undefined { return this._runs.get(runId); }\n  history(): JoopWorkflowRun[] { return Array.from(this._runs.values()); }\n  runStatus$() { return this._runStatus$.asObservable(); }\n\n  private async _runStep(step: JoopWorkflowStep, context: unknown, runId: string): Promise<unknown> {\n    const maxAttempts = (step.retries ?? 0) + 1;\n    let lastErr: unknown;\n    for (let attempt = 0; attempt < maxAttempts; attempt++) {\n      if (this._cancellations.has(runId)) throw new Error('Cancelled');\n      try {\n        const run = step.timeout\n          ? await _withTimeout(step.execute(context), step.timeout, step.id)\n          : await step.execute(context);\n        return run;\n      } catch (e) { lastErr = e; }\n    }\n    throw lastErr;\n  }\n\n  private _emit(run: JoopWorkflowRun): void { this._runStatus$.next({ ...run }); }\n}\n\nfunction _withTimeout<T>(promise: Promise<T>, ms: number, id: string): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => reject(new Error(`Step '${id}' timed out after ${ms}ms`)), ms);\n    promise.then(v => { clearTimeout(timer); resolve(v); }, e => { clearTimeout(timer); reject(e); });\n  });\n}\n"]}