@sdux-vault/devtools

Deterministic state management for every framework — one pipeline, zero ambiguity.

Plain TypeScript. Zero Magic.

@sdux-vault/devtools

Observability, debugging, and runtime inspection for SDuX Vault.

Docs · Live Examples · Pipeline Builder · Issues

What is SDuX Vault?

SDuX Vault is a framework-agnostic, deterministic state management system built around a reactive execution pipeline. It replaces the unpredictable sprawl of action/reducer architectures with a single, ordered, traceable pipeline where every transition is explicit and every output is guaranteed.

What is SDuX Vault DevTools Tooling?

@sdux-vault/devtools provides the developer-facing tooling layer for SDuX Vault. It enables deep insight into pipeline execution, controller decisions, and state transitions in real time — with zero production overhead.

Features:

• Runtime instrumentation — non-invasive hooks into pipeline execution
• Pipeline inspection — observe every stage of execution in real time
• Controller decision tracing — see why controllers approved, denied, or abstained
• State transition tracking — trace every state change with a unique traceId
• DevTools integration bridge — connects to the SDuX Chrome extension

Key Characteristics:

• Non-invasive — does not alter execution or mutate state
• Dev-only — no-op in production, zero runtime overhead
• Framework-agnostic — works with Angular, React, Vue, Node
• SSR-safe — guarded for server-side rendering environments
• Traceable — every pipeline run is tracked via traceId

For full documentation, guides, and API references: sdux-vault.com

---

Example

import { Vault } from '@sdux-vault/core';

// Enable DevTools instrumentation
Vault({ devMode: true });

const cell = FeatureCell(ExampleService, {
  key: 'example-feature-cell-key',
  initialState: [],
  insights: {
    wantsErrors: true,
    wantsPayload: true,
    wantsState: false
  }
});

cell.initialize();
// DevTools will now trace all pipeline execution for this cell

---

Side Effects

This package performs controlled, dev-only side effects:

import '@sdux-vault/devtools';

• Triggers DevTools registration and runtime instrumentation wiring
• No-op in production — idempotent and safe across all runtimes

---

Peer Dependencies

• @sdux-vault/shared

---

Installation

This package is installed automatically as a dependency of @sdux-vault/core.

npm install @sdux-vault/core

---

Ecosystem

Package	Purpose
@sdux-vault/shared	Contracts, types, utilities
@sdux-vault/engine	Orchestration, conductor, decision engine
@sdux-vault/core	Behavior runtime and pipeline execution
@sdux-vault/addons	Optional runtime policies and controllers
@sdux-vault/core-extensions	Framework integrations (Angular, React, Vue)

---

License

MIT (with SDuX Clarification Notice) SDuX Vault