EventPop

Popii / EventPop

Interface: EventPop<TState, TLocals>

The base context object provided to all Popii event, command, snap, and task handlers.

Every handler receives this as its first argument. It provides the client reference, localization helpers, a shared KV store (the Cooler), request-scoped caching, structured logging, and utilities for scheduling tasks and making HTTP requests.

Commands and snaps receive the richer Pop subtype, which adds reply(), defer(), options, and other interaction-specific members.

Example

export default event(async (pop, guild) => {
  pop.log.info(`Joined ${guild.name}`);
  pop.client.discord.guilds.cache.size; // full discord.js access
});

Extended by

Type Parameters

TState

TState = any

TLocals

TLocals = PopiiLocals & Record<string, any>

Methods

success()

success(message): Promise<void>

Defined in: plugins/ui.ts:43

Parameters

message

string

Returns

Promise<void>

error()

error(message): Promise<void>

Defined in: plugins/ui.ts:44

Parameters

message

string

Returns

Promise<void>

info()

info(message): Promise<void>

Defined in: plugins/ui.ts:45

Parameters

message

string

Returns

Promise<void>

paginate()

paginate(source, timeoutMs?): Promise<void>

Defined in: plugins/ui.ts:46

Parameters

source

EmbedBuilder[] | { fetch: (page) => Promise<EmbedBuilder | null>; totalPages?: number; }

timeoutMs?

number

Returns

Promise<void>

prompt()

prompt(embed, buttons, timeoutMs?): Promise<string | null>

Defined in: plugins/ui.ts:47

Parameters

embed

EmbedBuilder

buttons

string[]

timeoutMs?

number

Returns

Promise<string | null>

confirm()

confirm(question, timeoutMs?): Promise<boolean>

Defined in: plugins/ui.ts:48

Parameters

question

string

timeoutMs?

number

Returns

Promise<boolean>

form()

form(title, fields, timeoutMs?): Promise<Record<string, string> | null>

Defined in: plugins/ui.ts:49

Parameters

title

string

fields

FormField[]

timeoutMs?

number

Returns

Promise<Record<string, string> | null>

awaitMessage()

awaitMessage(timeoutMs?, promptMessageId?): Promise<any>

Defined in: plugins/ui.ts:50

Parameters

timeoutMs?

number

promptMessageId?

string

Returns

Promise<any>

wizard()

wizard(steps, timeoutMs?): Promise<Record<string, string> | null>

Defined in: plugins/ui.ts:51

Parameters

steps

WizardStep[]

timeoutMs?

number

Returns

Promise<Record<string, string> | null>

joinVoice()

joinVoice(): Promise<any>

Defined in: plugins/voice.ts:27

Returns

Promise<any>

playAudio()

playAudio(urlOrStream): Promise<{ player: any; title: string; metadata?: any; }>

Defined in: plugins/voice.ts:28

Parameters

urlOrStream

any

Returns

Promise<{ player: any; title: string; metadata?: any; }>

leaveVoice()

leaveVoice(): Promise<void>

Defined in: plugins/voice.ts:29

Returns

Promise<void>

getQueue()

getQueue(): any[]

Defined in: plugins/voice.ts:30

Returns

any[]

getNowPlaying()

getNowPlaying(): { title: string; artist: string; duration: string; thumbnail?: string; requestedBy?: string; elapsedMs: number; elapsed: string; progress: number; } | null

Defined in: plugins/voice.ts:31

Returns

{ title: string; artist: string; duration: string; thumbnail?: string; requestedBy?: string; elapsedMs: number; elapsed: string; progress: number; } | null

getNowPlayingCard()

getNowPlayingCard(opts?): Promise<AttachmentBuilder | null>

Defined in: plugins/voice.ts:32

Parameters

opts?

accentColor?

string

Returns

Promise<AttachmentBuilder | null>

createAttachment()

createAttachment(path, name?): any

Defined in: types.ts:142

Parameters

path

string

name?

string

Returns

any

fetchJSON()

fetchJSON<T>(url, init?): Promise<T>

Defined in: types.ts:143

Type Parameters

T

T = unknown

Parameters

url

string | URL | Request

init?

RequestInit

Returns

Promise<T>

fetchText()

fetchText(url, init?): Promise<string>

Defined in: types.ts:144

Parameters

url

string | URL | Request

init?

RequestInit

Returns

Promise<string>

fetchBuffer()

fetchBuffer(url, init?): Promise<ArrayBuffer>

Defined in: types.ts:145

Parameters

url

string | URL | Request

init?

RequestInit

Returns

Promise<ArrayBuffer>

fetchForm()

fetchForm<T>(url, data, init?): Promise<T>

Defined in: types.ts:146

Type Parameters

T

T = unknown

Parameters

url

string | URL | Request

data

FormData

init?

RequestInit

Returns

Promise<T>

cache()

cache<T>(key, ttlMs, fetcher): Promise<T>

Defined in: types.ts:147

Type Parameters

T

T

Parameters

key

string

ttlMs

number

fetcher

() => T | Promise<T>

Returns

Promise<T>

translate()

translate(key, args?): string

Defined in: types.ts:148

Parameters

key

string

args?

Record<string, any>

Returns

string

t()

t(key, args?): string

Defined in: types.ts:149

Parameters

key

string

args?

Record<string, any>

Returns

string

pack()

pack(customId, data): string

Defined in: types.ts:155

Parameters

customId

string

data

any

Returns

string

schedule()

schedule(taskName, payload?, delayMs?): Promise<void>

Defined in: types.ts:160

Parameters

taskName

string

payload?

any

delayMs?

number

Returns

Promise<void>

Properties

ai

ai: object

Defined in: plugins/ai.ts:16

generate()

generate(prompt): Promise<string>

Parameters

prompt

string

Returns

Promise<string>

chat()

chat(history): Promise<string>

Parameters

history

object[]

Returns

Promise<string>

economy

economy: object

Defined in: plugins/economy.ts:23

currencyName

currencyName: string

getProfile()

getProfile(guildId, userId): Promise<{ balance: number; last_daily: number; } | null>

Parameters

guildId

string

userId

string

Returns

Promise<{ balance: number; last_daily: number; } | null>

addBalance()

addBalance(guildId, userId, amount): Promise<void>

Parameters

guildId

string

userId

string

amount

number

Returns

Promise<void>

giveaways

giveaways: object

Defined in: plugins/giveaway.ts:18

start()

start(channelId, prize, winners, durationMs): Promise<void>

Parameters

channelId

string

prize

string

winners

number

durationMs

number

Returns

Promise<void>

levels

levels: object

Defined in: plugins/levels.ts:23

getProfile()

getProfile(guildId, userId): Promise<{ xp: number; level: number; } | null>

Parameters

guildId

string

userId

string

Returns

Promise<{ xp: number; level: number; } | null>

addXp()

addXp(guildId, userId, amount): Promise<{ leveledUp: boolean; newLevel: number; }>

Parameters

guildId

string

userId

string

amount

number

Returns

Promise<{ leveledUp: boolean; newLevel: number; }>

mongoose

mongoose: __module

Defined in: plugins/mongoose.ts:13

db

db: Database

Defined in: plugins/sqlite.ts:11

session

session: object

Defined in: plugins/ui.ts:52

get()

get(key): Promise<any>

Parameters

key

string

Returns

Promise<any>

set()

set(key, value, ttlMs?): Promise<void>

Parameters

key

string

value

any

ttlMs?

number

Returns

Promise<void>

del()

del(key): Promise<void>

Parameters

key

string

Returns

Promise<void>

clear()

clear(): Promise<void>

Returns

Promise<void>

sponsorblock

sponsorblock: object

Defined in: plugins/voice.ts:33

isEnabled()

isEnabled(): boolean

Returns

boolean

setEnabled()

setEnabled(enabled): void

Parameters

enabled

boolean

Returns

void

getCategories()

getCategories(): string[]

Returns

string[]

setCategories()

setCategories(cats): void

Parameters

cats

string[]

Returns

void

forceSkip()

forceSkip(): Promise<boolean>

Returns

Promise<boolean>

execution?

readonly optional execution?: object

Defined in: types.ts:137

Correlation and cancellation metadata for this execution.

id

id: string

type

type: "command" | "event" | "component" | "task"

definitionId

definitionId: string

startedAt

startedAt: number

signal?

readonly optional signal?: AbortSignal

Defined in: types.ts:138

client

client: PopiiClient<TState>

Defined in: types.ts:139

locale

locale: string

Defined in: types.ts:140

log

log: PopLogger

Defined in: types.ts:141

cooler

cooler: object

Defined in: types.ts:150

get()

get<T>(key): Promise<T | null>

Type Parameters

T

T = any

Parameters

key

string

Returns

Promise<T | null>

set()

set(key, value, ttlMs?): Promise<void>

Parameters

key

string

value

any

ttlMs?

number

Returns

Promise<void>

delete()

delete(key): Promise<void>

Parameters

key

string

Returns

Promise<void>

state

state: TState

Defined in: types.ts:156

locals

locals: TLocals

Defined in: types.ts:157

guild

guild: Guild | null

Defined in: types.ts:158

channel

channel: TextBasedChannel | null

Defined in: types.ts:159