BEACON-25 update beacon docs for sheet-to-sheet communication

Author: wing-it

content/docs/components/dispatch.md

@@ -132,6 +132,26 @@ dispatch.setComputed({
 ```
 `getComputed` and `setComputed` are both nearly identical in how they are called, taking a character id and a property with the name of the computed property you wish to get or set, and an array of string args. Both methods return a promise that resolves with the computed value.
 
+## getAvailableCharacters
+```typescript
+dispatch.getAvailableCharacters(): Promise<{
+  [id: string]: {
+    id: string;
+    name: string;
+    avatar: string;
+    permissions: "view"|"edit";
+    characterType: string;
+    description: string;
+    customMeta1: string;
+    customMeta2: string;
+    customMeta3: string;
+    statusmarkers: string;
+    tags: string;
+  }
+}>
+```
+`getAvailableCharacters` returns a list of all characters available to the current player. It returns the characters' metadata, as well as the player's permission level (`view` or `edit`).
+
 ## compendiumRequest
 ```javascript
 dispatch.compendiumRequest({ 

content/docs/components/handlers.md

@@ -39,27 +39,6 @@ initRelay({
 }): Promise<Dispatch>
 ```
 
-```typescript
-type Character {
-  id: string // The character's unique ID
-  name: string // The character's name
-  characterType?: string // The character type metadata, i.e. PC, NPC, Vehicle, etc.
-  description?: string // The character desciprtion metadata
-  customMeta1?: string // Custom metadata fields
-  customMeta2?: string
-  customMeta3?: string
-  attributes: JSONObject
-  customAttributes?: CustomAttributes
-  abilities?: Abilities
-  playerMacros?: PlayerMacros
-  bio?: string | null
-  gmNotes?: string | null
-  token: Token
-  statusmarkers?: string
-  avatar: string
-}
-```
-
 ## onInit
 
 The `onInit` method receives the initial data from the host. 
@@ -72,12 +51,12 @@ onInit(event: {
   settings: { // Campaign and character specific settings
     colorTheme: string, // 'dark' or 'light'
     language: string, // two-letter language code, i.e. 'en'
-    gm: boolean, // whether or not the current player has gm permissions
-    owned: boolean, // whether or not the current player controls the primary character
+    gm: boolean, // Whether the current player has gm permissions
+    owned: boolean, // Whether the current player controls the primary character
     playerSubscription: 'free'|'plus'|'pro', // The player's subscription level
     campaignSubscription?: 'free'|'plus'|'pro', // The campaign's subscription level
-    settingsSheet: boolean, // whether or not this sheet is the settings sheet
-    headless: boolean, // whether or not it should be displayed, set by the host
+    settingsSheet: boolean, // Whether this sheet is the settings sheet
+    headless: boolean, // Whether it should be displayed, set by the host
     sandbox: boolean,
     campaignId: number, // The id of the current campaign
     environment: string, // VTT, CHARACTERS, DISCORD
@@ -92,6 +71,27 @@ onInit(event: {
   },
 }, dispatch: Dispatch): void;
 ```
+The `Character` data is returned in the following format:
+
+```typescript
+type Character {
+  id: string // The character's unique ID
+  name: string // The character's name
+  characterType?: string // The character type metadata, i.e. PC, NPC, Vehicle, etc.
+  description?: string // The character desciprtion metadata
+  customMeta1?: string // Custom metadata fields
+  customMeta2?: string
+  customMeta3?: string
+  attributes: Object // The character's attributes
+  customAttributes?: CustomAttributes // Custom attributes created by the user
+  abilities?: Abilities // The character's abilities (macros)
+  playerMacros?: PlayerMacros // Custom macros created by the user
+  bio?: string | null // The character's biography metadata
+  gmNotes?: string | null // The character's GM Notes metadata (only present if the player is GM)
+  token: Token // The character's default token
+  avatar: string // The url for the character's avatar
+}
+```
 
 {{< callout context="note" >}}
  This function may be called multiple times during development in the sheet sandbox as part of hot reloads.