@bight-ts/plugin-ops

import {
  createErrorReporterPlugin,
  createMaintenanceModePlugin,
  createStartupChecksPlugin,
} from "@bight-ts/plugin-ops";

`createStartupChecksPlugin(options)`

Validates environment variables, intents, and services before the bot connects to Discord.

Property	Type	Required	Description
`requiredEnv`	`string[]`	No	Environment variables that must be defined
`requiredIntents`	`GatewayIntentBits[]`	No	Intents that must be present on the client
`requiredServices`	`{ name, get }[]`	No	Service accessors to check for truthiness
`mode`	`"fail" \| "warn"`	No	Whether to throw or just log warnings. Defaults to `"fail"`
`enabled`	`boolean`	No	Toggle the plugin

Injects a global precondition that blocks all interactions when active.

Property	Type	Required	Description
`getState`	`(context) => Promise<{ active: boolean }>`	Yes	Reads the current maintenance state
`setState`	`(context, state) => Promise<void>`	Yes	Persists a new maintenance state
`includeCommand`	`boolean`	No	Register a `/maintenance` toggle command. Defaults to `false`
`allowedUserIds`	`string[]`	No	User IDs that bypass maintenance mode
`message`	`string`	No	Custom denial message
`enabled`	`boolean`	No	Toggle the plugin

Subscribes to diagnostic events and forwards errors to an external reporter.

Property	Type	Required	Description
`getReporter`	`(context) => ErrorReporter`	Yes	Returns your error reporting service
`includeCommandErrors`	`boolean`	No	Forward command errors. Defaults to `true`
`includeInteractionErrors`	`boolean`	No	Forward interaction errors. Defaults to `true`
`includeTaskFailures`	`boolean`	No	Forward scheduled task failures. Defaults to `true`
`enabled`	`boolean`	No	Toggle the plugin