Classcore/pluginv0.11.0

Plugin

Base class for a seedcord plugin. Extend it and implement init(). this.core is the running bot.

Your constructor takes the host first and passes it to super(). Add your own parameters after it. attach() types them at the call site.

A plugin that narrows transport or runtime in Opts passes the same values to super(). attach() throws when either one differs from the bot's.

abstract class Plugin<
    Opts extends PluginOptions = {},
    TCore extends CoreBase = CoreBase,
    Fixed extends ScopeAxis = never
>
    implements Initializeable, HmrAware

class Analytics extends Plugin<{ transport: 'gateway' }> {
    constructor(
        host: CoreBase,
        private readonly apiKey: string
    ) {
        super(host, { transport: 'gateway', init: { phase: StartupPhase.Login } });
    }

    public async init(): Promise<void> {
        await this.connect(this.apiKey);
    }
}

seedcord.attach('analytics', Analytics, apiKey);

Member visibility

Filter class members by access level.

constructor

Constructs a new instance of the Plugin class

Plugin(
    host: CoreBase,
    [spec],
    input: PluginSpecArgs<Opts, Fixed>
)

Showing members with Protected visibility and higher.

Methods

dispose()
init()
onHmr()
ready()
registerCriticalFiles()
rejectOptions()

Opts

Where this plugin may attach.

Opts extends PluginOptions = {}

TCore

The Core each transport binds this.core to.

TCore extends CoreBase = CoreBase

Fixed

The transport and runtime values a transport's own Plugin base sets. Leave it out.

Fixed extends ScopeAxis = never

core

The host, typed to the transport whose Plugin base this class extends.

protected core: TCore

logger

Logs under the plugin's class name, on the channel its attach key sets.

protected readonly logger: Logger

dispose()

Runs during teardown, in ShutdownPhase.Disconnect by default. seedcord skips it when init() has thrown.

When init() outlasts its timeout, seedcord calls this once that init() resolves, outside any shutdown phase. The process must still be alive for that call to happen.

public async dispose?(): Promise<void>

init()

Runs in StartupPhase.Configuration by default. Move it to a different phase with the PluginLifecycleSpec.

public abstract init(): Promise<void>

onHmr()

Override to reload plugin state on an HMR update.

public async onHmr(_event: HmrUpdateEvent): Promise<void>

ready()

Runs in the Ready phase, after every attached plugin's init() has resolved. The other Ready tasks run alongside it, including the http server binding its port.

Override it when your work needs a logged-in client or a resolved application id.

public async ready?(): Promise<void>

registerCriticalFiles()

Registers critical file patterns that should trigger a full restart when changed in Dev HMR.

protected registerCriticalFiles(
    patterns: string[]
): void

Parameter: patterns

Glob patterns. A relative one resolves against root from seedcord.config.ts.

rejectOptions()

Rejects the options this plugin got.

protected rejectOptions(reason: string): never

Parameter: reason

Why the options are invalid.

Throws:

A SeedcordTypeError every time, with the plugin class name and reason in its message.