TrueVAULT Presets

[zachEastin]

Goal:
Make TrueTERRAIN show and use only presets the signed-in user is entitled to, by retrieving them through TrueVAULT as we do the other assets.

---

1. Integrate with TrueVAULT Preset APIs

• Call TrueVAULT to:

  • List the user’s entitled presets
  • Download/install preset packs as needed

• Treat TrueVAULT as the single gateway (no direct entitlement logic in TrueTERRAIN).

---

2. Preset Sync Workflow

• Add this into “Sync Vault” (or similar) action that:

  • Fetches entitled preset list
  • Downloads missing/updated presets
  • Refreshes TrueTERRAIN’s preset list without restart

• Keep sync idempotent (re-running it should be safe).

---

3. Storage & Loading

• Store Vault presets in a dedicated, managed directory (separate from user/local presets).

• Update preset discovery/loading to include:

  • Core/user presets
  • Vault-installed presets

• Track what was installed from Vault (manifest or similar) so entitlements can be enforced over time.

---

4. UI/UX Behavior in Preferences

• Preferences UI must show only entitled presets, with clear states for:

  • No entitled presets (empty state, not an error)
  • Network failure (retry + message)
  • Authorization failure (prompt sign-in again)
  • TrueVAULT missing/disabled (action disabled + guidance)

• Provide clear feedback during sync (progress and/or status).

---

5. Entitlement Revocation Handling

• If a user loses entitlement (refund/revoke), TrueTERRAIN should:

  • Hide/remove only Vault-managed presets
  • Never delete user-created presets

• Avoid leaving stale presets selectable in UI.

---

6. Versioning & Compatibility

• Default to the server/TrueVAULT “recommended” (latest compatible) preset version.
• Respect add-on compatibility rules (e.g., minimum TrueTERRAIN version), and avoid installing incompatible presets.

---

Net effect:
TrueTERRAIN becomes a consumer of entitled preset content, syncing and presenting only what the user is allowed to use, with reliable UI handling for auth/network edge cases and clean separation between Vault-managed and user presets.

Master Issue: True-VFX/true_terrain#267