com.mcawful.CustomPanelManifestCollector

public final class CustomPanelManifestCollector extends Object

Discovers manifest.json files under web/panel/custom/<moduleId>/ (bot install and, in Docker, the data volume) and merges nav and cards entries for the panel.

Panel HTML/JS should continue to live under web/panel/pages/<folder>/ using the same URLs as stock $.loadPage; manifests register sidebar links (nav) and cards on existing single-page panels (cards). folder must begin with custom/ so paths stay namespaced.

Author:: mcawful

Method Summary

Modifier and Type

Method

Description

static byte[]

filterManifestBytesForPanelUser(byte[] mergedUtf8, PanelUser user)

Returns merged manifest bytes filtered for the logged-in PanelUser: entries whose nav.section / cards.section fail PanelUserHandler.checkPanelUserSectionAccess(tv.phantombot.panel.PanelUser.PanelUser, java.lang.String, boolean) with read access are omitted.

static CustomPanelManifestCache.CachedResponse

getCachedResponse()

Returns a memoized CustomPanelManifestCache.CachedResponse for the merged manifest JSON.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details
- getCachedResponse
  
  public static CustomPanelManifestCache.CachedResponse getCachedResponse()
  
  Returns a memoized CustomPanelManifestCache.CachedResponse for the merged manifest JSON. Delegates to CustomPanelManifestCache.getOrRefresh(java.util.function.Supplier<java.lang.String>, java.util.function.Supplier<byte[]>); this method supplies the manifest-domain callbacks (filesystem-signature recipe and JSON-bytes builder) while the cache layer owns the TTL/ETag/concurrency policy.
  
  Returns:
  
  current cached response, recomputed on demand when the underlying manifests change
- filterManifestBytesForPanelUser
  
  public static byte[] filterManifestBytesForPanelUser(byte[] mergedUtf8, PanelUser user)
  
  Returns merged manifest bytes filtered for the logged-in PanelUser: entries whose nav.section / cards.section fail PanelUserHandler.checkPanelUserSectionAccess(tv.phantombot.panel.PanelUser.PanelUser, java.lang.String, boolean) with read access are omitted. Config users and null (legacy panel login) receive the unfiltered merge. On filter failure for a non-config user, returns an empty nav / cards payload (fail-closed) rather than the unfiltered merge.
  
  Parameters:
  
  mergedUtf8 - full merged JSON from getCachedResponse()
  
  user - authenticated panel user, or null for unfiltered output
  
  Returns:
  
  UTF-8 JSON bytes, never null

Class CustomPanelManifestCollector

Method Summary

Methods inherited from class java.lang.Object

Method Details

getCachedResponse

filterManifestBytesForPanelUser