Warband Integration

Warband.pro Integration

Blizzard Profile API: 14 fields. Warbandeer OpenAPI confirms 0 paths for vault, currency, gold, lockout, mail, bank, bag. Addon is the only source.

Goal: Warband.pro answers "who to play tonight" with location of gear, gold and consumables, usable lockouts, and cap warnings.

Real Use

Not once a month. Four to ten times per night, ambient.

1. Log out -> glance at second monitor -> $ sync -> API 1 minute fresh
2. Loot Spark / open Vault 3/8 to 4/8 / Warband bank 200 Crests / AH mail 20 Phials -> addon snaps in 0.5s, no extra step
3. Tap to export/import -> game on primary monitor, web on second, press i or click Import. If clipboard holds wb1! from 10 seconds ago (you just did /warband Ctrl+C) -> auto-grab via navigator.clipboard.readText() inside the click -> preview instantly, zero Ctrl+V. Otherwise text area is focused.
4. Preview -> confirm -> D1 upserts per character. Missing characters stay stale.
5. Tonight Plan updates using fresh consumables data.

Saturday push: play Monday to Saturday, paste once before +12, all 6 current.

What Consumes It

After wb1! hits D1, lib/addon-cache.ts provides the only D1 reader and deriveFacts() projects one CharacterObject to facts every surface reads:

• Tonight Plan: vault progress behind last reset gate, key in bag, phial count on raid line
• /characters: gold, free bag slots, free bank slots as sortable columns, each dotted from its own seenAt
• Camp inspector: warband gold with count it covers, warbank credit line "1h ago (by Vocnar)", account-wide currencies near cap
• Item search: per-item lists via /api/addon/search, rendered as filter on roster

Facts never judge freshness. Consumer does. Tonight Plan discards vault before weekly reset. Roster still shows it dotted stale. Both correct for surface.

Item Search

Per-item lists {id, count} exist for this feature and explain why MAX_DECODED_BYTES is 1 MB not 25 KB.

Search resolves query not inventory:

1. Resolve words to ids against /data/wow/search/item on ClientCredentials token.
2. Match ids locally via findItems() pure.

Resolving query is one call per search and does not grow with warband. Resolving inventory would be one call per distinct id. Numeric query skips step one and is degradation path when Game Data unreachable.

Warbank counted once not per character. Hit stamped from containers matched in so bank-only hit uses seenAt.bank.

After import, rail dispatches wb:import and surfaces re-fetch. Block line stamped in place, receipt survives.

Sink

Top-right MenuBar [ Sync / Import ] on every route. Not tucked in Settings.

Mirrors ghost sync buttons inside blocks. Same data-sync-all handler found by keys.ts so they never disagree.

Bottom line: API 12m · Addon 2h · Warbank 1d (by Vocnar) is trust signal.

Hotkeys

1-4 routes, i import anywhere, ? help. Scripts initialize from astro:page-load because ClientRouter does not re-execute.

When Data Matters

• 0 Phials fresh -> hard block "hit auction house before raid"
• 0 Phials 5 days old (yellow) -> grey "per last import 5 days ago, verify" not block
• Vault addon often fresher than API if you just opened Vault on alt that API has not fetched
• Crests near cap -> warning
• Warband bank scattered, 47 Sparks across 3 characters -> consolidate
• 120 Phials in Warbank from Vocnar -> do not block Vocgrim +12, just "consolidate first"

Why Not Auto-Upload

Trust. You paste to your own account. No background network. Streamer mode planned to collapse gold to dots.

App Files That Reference This

• App .wiki/wiki/topics/addon-import.md
• src/lib/warband-import.ts pure decoder plus facts projection
• src/lib/addon-cache.ts only D1 reader
• /api/addon/data returns facts, never 401s
• /api/addon/search item search
• src/components/Sync.astro notes reload versus in-place
• shell-model.md section 10 explains why import was route, then overlay, now rail field