# ApiVault

**ApiVault** is an in-game developer reference, API browser, metadata explorer, controlled test lab and debug bridge for World of Warcraft addon authors.

Target:

```text
World of Warcraft: Midnight
Interface: 120007
Version: 1.2.1
Developer: DruxlyeSofty
```

## Main features

```text
- Documented Blizzard API browser
- Function / event / table reference
- Source usage reference metadata
- Bundled Interface reference tree
- Interface resource catalog
- XML template catalog
- TOC module browser
- Source example index
- Secure pattern reference index
- Unified developer search
- Symbol coverage
- Runtime global inspector
- Constants / slash commands / bindings / settings catalogs
- Widget / Frame / ScriptObject method explorer
- Runtime test lab
- Event lab and payload recorder
- Addon audit mode
- Loaded addon runtime inspector
- Public Developer Debug API
- Bug Advisor / external error bridge
- Developer dashboards, checklists and export panels
```

## Safety policy

```text
- No protected/secure execution bypass
- No automatic SetAttribute calls
- No automatic protected API execution
- No runtime file reads from bundled source
- No full Blizzard source display in-game
- External addon input is treated as data only
```

## Core commands

```text
/apivault
/av
/av stats
/av search
/av symbols
/av globals
/av catalogs
/av widgets
/av audit
/av events
/av addons
/av devapi
/av bugadvisor
/av dashboard
/av layout
```

See `Docs/DEVELOPER_GUIDE.md` and `Docs/PUBLIC_DEVELOPER_API.md` for developer workflows.


## In-game Documentation

ApiVault includes a Documentation button in the main interface. The same manual can be opened with `/av docs`, `/av documentation`, `/av manual` or `/av help`.

The manual covers user workflows, developer workflows, safety rules and all slash commands.


## Must-Have Developer Tools

ApiVault v1.2.0 includes an integrated developer toolbox:

```text
/av devtools
```

Tools included:

```text
- Error Inbox + Explain This Error
- SavedVariables Schema Inspector
- Taint / Combat Safety Assistant
- Addon Package Validator
- Performance Audit Assistant
- API Compatibility Matrix
- Snippet Library with Safe Patterns
- Complete Developer Session Export
```


## Addon Lookup UX

The Dev Tools panel now includes an Addon Lookup mode. Type an addon name such as `StockVault` and click Run to inspect runtime addon metadata, Public Developer API registration, Error Inbox matches and Bug Advisor matches.


## BugSack / BugGrabber Bridge

ApiVault can mirror future Lua errors into ApiVault Error Inbox and Bug Advisor while still forwarding the error to the previous error handler used by BugSack/BugGrabber.

Commands:

```text
/av bugsack
/av buggrabber
/av errormirror
/av errorhandler
```

No BugSack internals are assumed and old BugSack history is not imported without a supplied API/source.


## Loaded Addon Control Center

Open `/av addoncenter` to inspect runtime addon metadata and create opt-in report requests for integrated addons. ApiVault does not force arbitrary addon code execution.


## v1.3.0 Interface Clarity

ApiVault now opens into a unified Developer Cockpit AppShell with left-side workflow navigation. `/av`, `/apivault`, `/av home`, `/av addons`, and `/av errors` route into clearer task-focused panels.


## v1.3.1 API/UI/Secure Workflows

Adds embedded AppShell workflow panels for API & Symbols, UI/XML/Widgets and Secure/Taint. `/av api`, `/av ui` and `/av secure` now route into clear cockpit sections while detailed legacy browsers remain available through buttons and aliases.


## v1.3.2 Functional Workflow Hotfix

Fixes SavedVariables inspector visibility for addon-name filters such as `StockVault` and improves no-data output.


## v1.3.3 SavedVariables Runtime Probe

SavedVariables Inspector no longer treats `C_AddOns.GetAddOnMetadata(addon, "SavedVariables")` as authoritative. It now uses:

```text
- runtime global probes
- known DB hints
- Public Developer API SavedVariables reports
- optional metadata only as diagnostic context
```

Use:

```text
/av savedvariables
/av schema
/av sv
```

Then type an addon or DB name such as `StockVault` or `StockVaultDB`.


## v1.3.4 Stability / Lazy Data

ApiVault now moves Symbols, Widgets and Catalogs metadata to LoadOnDemand companion addons and loads them only when the relevant tools are opened.

BugGrabber integration now prefers the direct `BugGrabber.RegisterCallback` adapter and imports `BugGrabber.errors` / `BugGrabberDB.errors` read-only when available.

The slash command router is now backed by a command registry with legacy fallback.
