@sdux-vault/addons

Composable controllers and runtime policies for SDuX Vault.

@sdux-vault/addons provides a set of optional, plug-in controllers and extensions that enhance the behavior of the SDuX runtime.

These add-ons extend the system with policies, safeguards, and orchestration logic without modifying the core engine.

TL;DR

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

Overview

SDuX is built as a layered system:

shared → engine → core → core-extensions → apps
           └─────────---------───────────→ devtools

• apps → end-user applications
• addons → optional runtime policies and controllers (this package)
• core → behavior execution runtime
• devtools → debugging and inspection
• engine → orchestration, decision engine, conductor
• shared → contracts, types, utilities

What This Package Does

Add-ons provide runtime extensions that plug into the controller and orchestration layers.

They are responsible for:

• enforcing policies (e.g., retry limits, failure thresholds)
• modifying control flow decisions
• reacting to controller events (success, failure, abort, etc.)
• enabling safe, composable runtime behavior changes

What This Package Provides

• Controller implementations — reusable policy modules
• Failure and retry strategies — e.g., max failure limits
• Fluent configuration APIs — attach policies declaratively
• Runtime decision hooks — influence pipeline execution without mutation
• Composable extensions — stack multiple policies safely

Design Principles

Add-ons follow strict rules:

• No state mutation
• No direct pipeline execution
• Pure decision logic only
• Composable and isolated
• Deterministic behavior

They act as policy layers, not execution layers.

Installation

npm install @sdux-vault/addons

Development

Build

npm run build:addons

Output:

dist/addons

Test

npm run test:addons

Verify

npm run verify

Includes:

• linting
• formatting
• type checking
• tests

Publishing

See RELEASE.md for publishing instructions.

Ecosystem

• @sdux-vault/core — behavior, runtime and pipeline execution(README)
• @sdux-vault/core-extensions/angular — Angular integration layer (signals, DI, reactive bindings) (README)
• @sdux-vault/devtools — observability and debugging layer for runtime inspection (README)
• @sdux-vault/engine — orchestration, conductor, decision engine
• @sdux-vault/shared — contracts, types, utilities(README)

License

For full licensing details:
https://www.sdux-vault.com/docs/welcome/license#license-texts

MIT © SDuX Vault