additional tsdoc

Author: jacekradko

packages/clerk-js/src/core/tokenCache.ts

@@ -26,10 +26,27 @@ interface TokenCacheEntry extends TokenCacheKeyJSON {
   tokenResolver: Promise<TokenResource>;
 }
 
+/**
+ * Metadata broadcast to other tabs when a token is fetched or refreshed.
+ * Contains session and organization context along with the raw token value.
+ */
 export interface TokenBroadcastMetadata {
+  /**
+   * Organization ID associated with the token, if any.
+   * Nullable for tokens not scoped to an organization.
+   */
   organizationId?: string | null;
+  /**
+   * Session ID for which the token was issued.
+   */
   sessionId: string;
+  /**
+   * JWT template name used to generate the token, if applicable.
+   */
   template?: string;
+  /**
+   * Raw JWT token string.
+   */
   tokenRaw: string;
 }