Class EventSet

A set of nostr events that can be queried and subscribed to NOTE: does not handle replaceable events or any deletion logic

Implements

IEventSet

Constructors

constructor

new EventSet(): EventSet
Returns EventSet

Properties

`Protected`authors

authors: Map<string, Set<Event>> = ...

`Protected`claims

claims: WeakMap<Event, any> = ...

A weak map of events that are claimed by other things

`Protected`created_at

created_at: Event[] = []

events

events: LRU<Event> = ...

LRU cache of last events touched

insert$

insert$: Subject<Event> = ...

A stream of events inserted into the database

`Protected`kinds

kinds: Map<number, Set<Event>> = ...

Indexes

`Protected`log

log: Debugger = ...

`Optional`onBeforeInsert

onBeforeInsert?: (event: Event) => boolean

A method thats called before a new event is inserted

remove$

remove$: Subject<Event> = ...

A stream of events removed from the database

`Protected`replaceable

replaceable: Map<string, Event[]> = ...

A sorted array of replaceable events by address

`Protected`tags

tags: LRU<Set<Event>> = ...

update$

update$: Subject<Event> = ...

A stream of events that have been updated

Accessors

size

get size(): number
The number of events in the event set

Returns number
- Defined in packages/core/src/event-store/event-set.ts:43

Methods

add

add(event: Event): null | Event
Inserts an event into the database and notifies all subscriptions
Parameters
- event: Event
Returns null | Event
Implementation of IEventSet.add
- Defined in packages/core/src/event-store/event-set.ts:92

claim

claim(event: Event, claim: any): void
Sets the claim on the event and touches it
Parameters
- event: Event
- claim: any
Returns void
Implementation of IEventSet.claim
- Defined in packages/core/src/event-store/event-set.ts:189

clearClaim

clearClaim(event: Event): void
Removes all claims on an event
Parameters
- event: Event
Returns void
Implementation of IEventSet.clearClaim
- Defined in packages/core/src/event-store/event-set.ts:207

`Protected`getAuthorsIndex

getAuthorsIndex(author: string): Set<Event>
Parameters
- author: string
Returns Set<Event>
- Defined in packages/core/src/event-store/event-set.ts:216

getByFilters

getByFilters(filters: Filter | Filter[]): Set<Event>
Gets all events that match the filters
Parameters
- filters: Filter | Filter[]
Returns Set<Event>
Implementation of IEventSet.getByFilters
- Defined in packages/core/src/event-store/event-set.ts:79

getEvent

getEvent(id: string): undefined | Event
Gets a single event based on id
Parameters
- id: string
Returns undefined | Event
Implementation of IEventSet.getEvent
- Defined in packages/core/src/event-store/event-set.ts:57

getEventsForFilter

getEventsForFilter(filter: Filter): Set<Event>
Returns all events that match the filter
Parameters
- filter: Filter
Returns Set<Event>
- Defined in packages/core/src/event-store/event-set.ts:306

getEventsForFilters

getEventsForFilters(filters: Filter[]): Set<Event>
Returns all events that match the filters
Parameters
- filters: Filter[]
Returns Set<Event>
- Defined in packages/core/src/event-store/event-set.ts:364

`Protected`getKindIndex

getKindIndex(kind: number): Set<Event>
Index helper methods
Parameters
- kind: number
Returns Set<Event>
- Defined in packages/core/src/event-store/event-set.ts:212

getReplaceable

getReplaceable(
    kind: number,
    pubkey: string,
    identifier?: string,
): undefined | Event
Gets the latest replaceable event
Parameters
- kind: number
- pubkey: string
- Optionalidentifier: string
Returns undefined | Event
Implementation of IEventSet.getReplaceable
- Defined in packages/core/src/event-store/event-set.ts:67

getReplaceableHistory

getReplaceableHistory(
    kind: number,
    pubkey: string,
    identifier?: string,
): undefined | Event[]
Gets the history of a replaceable event
Parameters
- kind: number
- pubkey: string
- Optionalidentifier: string
Returns undefined | Event[]
Implementation of IEventSet.getReplaceableHistory
- Defined in packages/core/src/event-store/event-set.ts:73

`Protected`getTagIndex

getTagIndex(tagAndValue: string): Set<Event>
Parameters
- tagAndValue: string
Returns Set<Event>
- Defined in packages/core/src/event-store/event-set.ts:220

getTimeline

getTimeline(filters: Filter | Filter[]): Event[]
Gets a timeline of events that match the filters
Parameters
- filters: Filter | Filter[]
Returns Event[]
Implementation of IEventSet.getTimeline
- Defined in packages/core/src/event-store/event-set.ts:84

hasEvent

hasEvent(id: string): boolean
Checks if the database contains an event without touching it
Parameters
- id: string
Returns boolean
Implementation of IEventSet.hasEvent
- Defined in packages/core/src/event-store/event-set.ts:53

hasReplaceable

hasReplaceable(kind: number, pubkey: string, identifier?: string): boolean
Checks if the event set has a replaceable event
Parameters
- kind: number
- pubkey: string
- Optionalidentifier: string
Returns boolean
Implementation of IEventSet.hasReplaceable
- Defined in packages/core/src/event-store/event-set.ts:62

isClaimed

isClaimed(event: Event): boolean
Checks if an event is claimed by anything
Parameters
- event: Event
Returns boolean
Implementation of IEventSet.isClaimed
- Defined in packages/core/src/event-store/event-set.ts:198

iterateAuthors

iterateAuthors(authors: Iterable<string>): Generator<Event>
Iterates over all events by author
Parameters
- authors: Iterable<string>
Returns Generator<Event>
- Defined in packages/core/src/event-store/event-set.ts:240

iterateIds

iterateIds(ids: Iterable<string>): Generator<Event>
Iterates over all events by id
Parameters
- ids: Iterable<string>
Returns Generator<Event>
- Defined in packages/core/src/event-store/event-set.ts:299

iterateKinds

iterateKinds(kinds: Iterable<number>): Generator<Event>
Iterates over all events by kind
Parameters
- kinds: Iterable<number>
Returns Generator<Event>
- Defined in packages/core/src/event-store/event-set.ts:262

iterateTag

iterateTag(tag: string, values: Iterable<string>): Generator<Event>
Iterates over all events by indexable tag and value
Parameters
- tag: string
- values: Iterable<string>
Returns Generator<Event>
- Defined in packages/core/src/event-store/event-set.ts:251

iterateTime

iterateTime(
since: undefined | number,
until: undefined | number,
): Generator<Event>
Iterates over all events by time
Parameters
- since: undefined | number
- until: undefined | number
Returns Generator<Event>
- Defined in packages/core/src/event-store/event-set.ts:273

prune

prune(limit?: number): number
Remove the oldest events that are not claimed
Parameters
- limit: number = 1000
Returns number
- Defined in packages/core/src/event-store/event-set.ts:378

remove

remove(eventOrId: string | Event): boolean
Removes an event from the database and notifies all subscriptions
Parameters
- eventOrId: string | Event
Returns boolean
Implementation of IEventSet.remove
- Defined in packages/core/src/event-store/event-set.ts:142

removeClaim

removeClaim(event: Event, claim: any): void
Removes a claim from an event
Parameters
- event: Event
- claim: any
Returns void
Implementation of IEventSet.removeClaim
- Defined in packages/core/src/event-store/event-set.ts:202

touch

touch(event: Event): void
Moves an event to the top of the LRU cache
Parameters
- event: Event
Returns void
- Defined in packages/core/src/event-store/event-set.ts:48

update

update(event: Event): boolean
Inserts and event into the database and notifies all subscriptions that the event has updated
Parameters
- event: Event
Returns boolean
Implementation of IEventSet.update
- Defined in packages/core/src/event-store/event-set.ts:135

Class EventSet

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns EventSet

Properties

Protectedauthors

Protectedclaims

Protectedcreated_at

events

insert$

Protectedkinds

Protectedlog

OptionalonBeforeInsert

remove$

Protectedreplaceable

Protectedtags

update$

Accessors

size

Returns number

Methods

add

Parameters

Returns null | Event

claim

Parameters

Returns void

clearClaim

Parameters

Returns void

ProtectedgetAuthorsIndex

Parameters

Returns Set<Event>

getByFilters

Parameters

Returns Set<Event>

getEvent

Parameters

Returns undefined | Event

getEventsForFilter

Parameters

Returns Set<Event>

getEventsForFilters

Parameters

Returns Set<Event>

ProtectedgetKindIndex

Parameters

Returns Set<Event>

getReplaceable

Parameters

Returns undefined | Event

getReplaceableHistory

Parameters

Returns undefined | Event[]

ProtectedgetTagIndex

Parameters

Returns Set<Event>

getTimeline

Parameters

Returns Event[]

hasEvent

Parameters

Returns boolean

hasReplaceable

Parameters

Returns boolean

isClaimed

Parameters

Returns boolean

iterateAuthors

Parameters

Returns Generator<Event>

iterateIds

Parameters

`Protected`authors

`Protected`claims

`Protected`created_at

`Protected`kinds

`Protected`log

`Optional`onBeforeInsert

`Protected`replaceable

`Protected`tags

`Protected`getAuthorsIndex

`Protected`getKindIndex

`Protected`getTagIndex