# PresenceAuthority (/docs/presence/reference/presence-server/classes/PresenceAuthority)



# Class: PresenceAuthority [#class-presenceauthority]

Defined in:
[index.ts:52](https://github.com/handlewithcarecollective/pitter-patter/blob/81896664a0707dea093e9edc81dae89a35a20ad2/packages/presence-server/src/index.ts#L52)

The PresenceAuthority manages most of Pitter Patter's server side presence operations.

You create endpoints that call the appropriate PresenceAuthority functions to integrate with a
PresenceClient.

A PresenceAuthority is designed to be stateless, so you can create a new one on every server,
lambda, or cloud function instance.

## Constructors [#constructors]

### Constructor [#constructor]

```ts
new PresenceAuthority(config: PresenceAuthorityConfig): PresenceAuthority;
```

Defined in:
[index.ts:56](https://github.com/handlewithcarecollective/pitter-patter/blob/81896664a0707dea093e9edc81dae89a35a20ad2/packages/presence-server/src/index.ts#L56)

#### Parameters [#parameters]

##### config [#config]

[`PresenceAuthorityConfig`](/docs/presence/reference/presence-server/interfaces/PresenceAuthorityConfig)

#### Returns [#returns]

`PresenceAuthority`

## Methods [#methods]

### listenForPresence() [#listenforpresence]

```ts
listenForPresence(
   docId: string,
   excludeClientId: string,
   refs?: Record<string, string>): Promise<{
[k: string]: PresenceIndicator;
}>;
```

Defined in:
[index.ts:73](https://github.com/handlewithcarecollective/pitter-patter/blob/81896664a0707dea093e9edc81dae89a35a20ad2/packages/presence-server/src/index.ts#L73)

Listens for remote changes to a document's presence state and returns when changes are found or
after a timeout specified in the PresenceAuthority's `broadcastManager`.

#### Parameters [#parameters-1]

##### docId [#docid]

`string`

##### excludeClientId [#excludeclientid]

`string`

##### refs? [#refs]

`Record`\<`string`, `string`> = `{}`

#### Returns [#returns-1]

`Promise`\<\{ \[`k`: `string`]:
[`PresenceIndicator`](/docs/presence/reference/presence-server/interfaces/PresenceIndicator); }>

***

### updatePresence() [#updatepresence]

```ts
updatePresence(docId: string, indicator: PresenceIndicator): Promise<void>;
```

Defined in:
[index.ts:64](https://github.com/handlewithcarecollective/pitter-patter/blob/81896664a0707dea093e9edc81dae89a35a20ad2/packages/presence-server/src/index.ts#L64)

Saves new presence state for a client and notifies and listeners of the update.

#### Parameters [#parameters-2]

##### docId [#docid-1]

`string`

##### indicator [#indicator]

[`PresenceIndicator`](/docs/presence/reference/presence-server/interfaces/PresenceIndicator)

#### Returns [#returns-2]

`Promise`\<`void`>