Welshman

Appearance

Welshman Docs / @welshman/domain / RoomAdminsWriter

Class: RoomAdminsWriter ​

Defined in: domain/src/kinds/RoomAdmins.ts:32

Extends ​

Constructors ​

Constructor ​

new RoomAdminsWriter(kind, context, reader?): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:67

Parameters ​

kind ​

number

context ​

KindContext

reader? ​

RoomAdminsReader

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.constructor

Properties ​

clientTag? ​

optional clientTag?: string[]

Defined in: domain/src/core/EventWriter.ts:57

Inherited from ​

EventWriter.clientTag

content ​

content: string = ""

Defined in: domain/src/core/EventWriter.ts:52

Inherited from ​

EventWriter.content

contentWarningTag? ​

optional contentWarningTag?: string[]

Defined in: domain/src/core/EventWriter.ts:56

Inherited from ​

EventWriter.contentWarningTag

context ​

readonly context: KindContext

Defined in: domain/src/core/EventWriter.ts:69

Inherited from ​

EventWriter.context

expirationTag? ​

optional expirationTag?: string[]

Defined in: domain/src/core/EventWriter.ts:55

Inherited from ​

EventWriter.expirationTag

extraTags ​

extraTags: string[][] = []

Defined in: domain/src/core/EventWriter.ts:59

Inherited from ​

EventWriter.extraTags

forcedRoutes? ​

optional forcedRoutes?: RelaySelection[]

Defined in: domain/src/core/EventWriter.ts:60

Inherited from ​

EventWriter.forcedRoutes

identifierTag? ​

optional identifierTag?: string[]

Defined in: domain/src/core/EventWriter.ts:58

Inherited from ​

EventWriter.identifierTag

kind ​

readonly kind: number

Defined in: domain/src/core/EventWriter.ts:68

Inherited from ​

EventWriter.kind

pendingResolves ​

pendingResolves: Promise<unknown>[] = []

Defined in: domain/src/core/EventWriter.ts:61

Inherited from ​

EventWriter.pendingResolves

protectTag? ​

optional protectTag?: string[]

Defined in: domain/src/core/EventWriter.ts:54

Inherited from ​

EventWriter.protectTag

reader? ​

readonly optional reader?: RoomAdminsReader

Defined in: domain/src/core/EventWriter.ts:70

Inherited from ​

EventWriter.reader

requiresRelays ​

readonly requiresRelays: true = true

Defined in: domain/src/kinds/RoomAdmins.ts:33

Overrides ​

EventWriter.requiresRelays

roomTag? ​

optional roomTag?: string[]

Defined in: domain/src/core/EventWriter.ts:53

Inherited from ​

EventWriter.roomTag

Methods ​

addEmoji() ​

addEmoji(shortcode, url, address?): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:269

Parameters ​

shortcode ​

string

url ​

string

address? ​

string

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.addEmoji

addImeta() ​

addImeta(imeta): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:261

Parameters ​

imeta ​

Imeta

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.addImeta

addMention() ​

addMention(pubkey): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:209

Parameters ​

pubkey ​

string

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.addMention

addPubkey() ​

addPubkey(pubkey, roles?): RoomAdminsWriter

Defined in: domain/src/kinds/RoomAdmins.ts:36

Parameters ​

pubkey ​

string

roles? ​

string[] = ...

Returns ​

RoomAdminsWriter

addQuote() ​

addQuote(event): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:225

Parameters ​

event ​

TrustedEvent

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.addQuote

addTags() ​

addTags(...tags): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:191

Parameters ​

tags ​

...string[][]

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.addTags

addZapSplit() ​

addZapSplit(pubkey, split?): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:241

Parameters ​

pubkey ​

string

split? ​

number = 1

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.addZapSplit

clearClient() ​

clearClient(): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:173

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.clearClient

clearContentWarning() ​

clearContentWarning(): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:148

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.clearContentWarning

clearExpiration() ​

clearExpiration(): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:135

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.clearExpiration

clearForcedRoutes() ​

clearForcedRoutes(): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:117

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.clearForcedRoutes

clearIdentifier() ​

clearIdentifier(): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:185

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.clearIdentifier

clearRoom() ​

clearRoom(): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:99

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.clearRoom

dropTags() ​

dropTags(pred): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:203

Parameters ​

pred ​

(tag) => unknown

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.dropTags

forceRoutes() ​

forceRoutes(...routes): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:111

Replaces the rendered routes. These are routes rather than urls, so forceRoutes(userInbox()) pins an event to the user's read relays without resolving them first.

Parameters ​

routes ​

...RelaySelection[]

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.forceRoutes

hint() ​

protected hint(...routes): Promise<string>

Defined in: domain/src/core/EventWriter.ts:316

Resolves one or more relay selections to a single hint url, tracking the in-flight promise so renderTags can wait for it. Callers backfill the resolved url into a tag's hint slot.

Parameters ​

routes ​

...RelaySelection[]

Returns ​

Promise<string>

Inherited from ​

EventWriter.hint

imeta() ​

imeta(): Imeta[]

Defined in: domain/src/core/EventWriter.ts:257

Returns ​

Imeta[]

Inherited from ​

EventWriter.imeta

keepTags() ​

keepTags(pred): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:197

Parameters ​

pred ​

(tag) => unknown

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.keepTags

quotes() ​

quotes(): Quote[]

Defined in: domain/src/core/EventWriter.ts:221

Returns ​

Quote[]

Inherited from ​

EventWriter.quotes

relays() ​

relays(): Promise<string[]>

Defined in: domain/src/core/EventWriter.ts:400

Shortcut for getting relays from the router scenario. Forced routes bypass scoring.

Returns ​

Promise<string[]>

Inherited from ​

EventWriter.relays

removeEmoji() ​

removeEmoji(shortcode): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:275

Parameters ​

shortcode ​

string

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.removeEmoji

removeImeta() ​

removeImeta(match): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:265

Parameters ​

match ​

(imeta) => boolean

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.removeImeta

removePubkey() ​

removePubkey(pubkey): RoomAdminsWriter

Defined in: domain/src/kinds/RoomAdmins.ts:40

Parameters ​

pubkey ​

string

Returns ​

RoomAdminsWriter

removeQuote() ​

removeQuote(value): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:237

Parameters ​

value ​

string

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.removeQuote

removeZapSplit() ​

removeZapSplit(pubkey): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:253

Parameters ​

pubkey ​

string

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.removeZapSplit

render() ​

render(): Promise<{ event: EventTemplate; relays: string[]; }>

Defined in: domain/src/core/EventWriter.ts:409

Returns a rendered event template along with its relays.

Returns ​

Promise<{ event: EventTemplate; relays: string[]; }>

Inherited from ​

EventWriter.render

renderBehaviorTags() ​

protected renderBehaviorTags(): MaybeAsync<string[][]>

Defined in: domain/src/core/EventWriter.ts:323

Returns a list of tags that may be attached to any kind.

Returns ​

MaybeAsync<string[][]>

Inherited from ​

EventWriter.renderBehaviorTags

renderContent() ​

renderContent(): MaybeAsync<string>

Defined in: domain/src/core/EventWriter.ts:357

Returns the content string as defined by the kind.

Returns ​

MaybeAsync<string>

Inherited from ​

EventWriter.renderContent

renderDomainTags() ​

protected renderDomainTags(): MaybeAsync<string[][]>

Defined in: domain/src/core/EventWriter.ts:337

Returns a list of tags related to the kind.

Returns ​

MaybeAsync<string[][]>

Inherited from ​

EventWriter.renderDomainTags

renderRoutes() ​

protected renderRoutes(): Promise<RelaySelection[]>

Defined in: domain/src/core/EventWriter.ts:378

Returns the list of routes this event should be published to. Defaults to the outbox model. Override to implement custom behavior.

Returns ​

Promise<RelaySelection[]>

Inherited from ​

EventWriter.renderRoutes

renderTags() ​

renderTags(): Promise<string[][]>

Defined in: domain/src/core/EventWriter.ts:344

Returns the complete tag list for publishing.

Returns ​

Promise<string[][]>

Inherited from ​

EventWriter.renderTags

renderTemplate() ​

renderTemplate(): Promise<EventTemplate>

Defined in: domain/src/core/EventWriter.ts:364

Validates and renders an event template.

Returns ​

Promise<EventTemplate>

Inherited from ​

EventWriter.renderTemplate

scenario() ​

scenario(): Promise<RelayScenario>

Defined in: domain/src/core/EventWriter.ts:391

Returns a router scenario for this event. Publishes to the forced routes (e.g. a NIP-29 room's relay) when set, otherwise to the rendered routes.

The resolver's default limit is tuned for reads, where an extra relay is a round trip returning mostly the same events. Publishing is the opposite: a relay that never received the event serves it to nobody. Override scenario for a different limit.

Returns ​

Promise<RelayScenario>

Inherited from ​

EventWriter.scenario

setClient() ​

setClient(name, address?): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:159

Attributes the event to the NIP-89 client that produced it. address is an optional 31990:pubkey:d-tag pointer to the client's handler information event; when given, its author's outbox fills in the tag's relay hint slot.

Parameters ​

name ​

string

address? ​

string

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.setClient

setContent() ​

setContent(content): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:86

Parameters ​

content ​

string

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.setContent

setContentWarning() ​

setContentWarning(reason?): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:142

Parameters ​

reason? ​

string

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.setContentWarning

setExpiration() ​

setExpiration(expiration): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:129

Parameters ​

expiration ​

number

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.setExpiration

setIdentifier() ​

setIdentifier(identifier?): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:179

Parameters ​

identifier? ​

string = ...

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.setIdentifier

setProtected() ​

setProtected(protect): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:123

Parameters ​

protect ​

Maybe<boolean>

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.setProtected

setPubkeys() ​

setPubkeys(pubkeys): RoomAdminsWriter

Defined in: domain/src/kinds/RoomAdmins.ts:44

Parameters ​

pubkeys ​

string[]

Returns ​

RoomAdminsWriter

setRoom() ​

setRoom(url, room): RoomAdminsWriter

Defined in: domain/src/core/EventWriter.ts:92

Parameters ​

url ​

string

room ​

string

Returns ​

RoomAdminsWriter

Inherited from ​

EventWriter.setRoom

validate() ​

validate(): void

Defined in: domain/src/core/EventWriter.ts:282

Validates a domain object, throwing an error if invalid.

Returns ​

void

Inherited from ​

EventWriter.validate