Persist badge catalog + icon cache via ctx.storage #1

New issue

Closed

opened 2026-08-15 23:33:03 +02:00 by julian · 0 comments

julian commented

2026-08-15 23:33:03 +02:00

Owner

Problem

The myTeamSpeak badge catalog and icon cache (backend/badges.ts, BadgeCatalog) are in-memory only. Every host restart refetches the protobuf catalog from badges-content.teamspeak.com/list and re-downloads every icon variant on first use. That is external traffic and startup latency for data that changes rarely.

Proposal

Once OpsDeck core ships module-scoped persistent storage (ctx.storage, see below), use it here:

Persist the parsed catalog (byGuid entries) with a fetched-at timestamp; rehydrate on register() and only refetch when stale or on the existing refresh cadence.
Persist fetched icons (guid + variant → bytes/content-type), respecting the existing MAX_ICON_BYTES cap; failures stay uncached as today.

Blocked by

Blocked by OpsDeck/core#37 — the ctx.storage capability does not exist yet. This issue should not start until that lands and the SDK exposes it.

## Problem The myTeamSpeak badge catalog and icon cache (`backend/badges.ts`, `BadgeCatalog`) are in-memory only. Every host restart refetches the protobuf catalog from `badges-content.teamspeak.com/list` and re-downloads every icon variant on first use. That is external traffic and startup latency for data that changes rarely. ## Proposal Once OpsDeck core ships module-scoped persistent storage (`ctx.storage`, see below), use it here: - Persist the parsed catalog (`byGuid` entries) with a fetched-at timestamp; rehydrate on `register()` and only refetch when stale or on the existing refresh cadence. - Persist fetched icons (guid + variant → bytes/content-type), respecting the existing `MAX_ICON_BYTES` cap; failures stay uncached as today. ## Blocked by **Blocked by OpsDeck/core#37** — the `ctx.storage` capability does not exist yet. This issue should not start until that lands and the SDK exposes it.

julian referenced this issue from a commit

2026-08-17 00:47:57 +02:00

feat(badges): the catalog and its icons survive a restart

julian referenced this issue from a pull request that will close it,

2026-08-17 00:48:19 +02:00

feat(badges): the catalog and its icons survive a restart #2

julian closed this issue

2026-08-21 16:54:23 +02:00

julian referenced this issue from a commit

2026-08-21 16:54:24 +02:00

feat(badges): the catalog and its icons survive a restart (#2)