chapterjs 0.1.1 → 0.1.4

package/dist/discord/types.d.ts

@@ -1,334 +0,0 @@
-/** https://docs.discord.com/developers/reference#snowflakes */
-export type Snowflake = string;
-/** ISO8601 timestamp, e.g. `2026-10-03T15:00:00.000000+00:00`. */
-export type Timestamp = string;
-/** Any object Discord may send, for events not typed in detail yet. */
-export type GatewayObject = {
-    [key: string]: any;
-};
-export interface APIUser {
-    id: Snowflake;
-    username: string;
-    discriminator: string;
-    global_name: string | null;
-    avatar: string | null;
-    bot?: boolean;
-    system?: boolean;
-    mfa_enabled?: boolean;
-    banner?: string | null;
-    accent_color?: number | null;
-    locale?: string;
-    verified?: boolean;
-    email?: string | null;
-    flags?: number;
-    premium_type?: number;
-    public_flags?: number;
-    avatar_decoration_data?: unknown;
-    collectibles?: unknown;
-    primary_guild?: unknown;
-}
-export interface APIGuildMember {
-    user?: APIUser;
-    nick?: string | null;
-    avatar?: string | null;
-    banner?: string | null;
-    roles: Snowflake[];
-    joined_at: Timestamp | null;
-    premium_since?: Timestamp | null;
-    deaf: boolean;
-    mute: boolean;
-    flags: number;
-    pending?: boolean;
-    permissions?: string;
-    communication_disabled_until?: Timestamp | null;
-    avatar_decoration_data?: unknown;
-    collectibles?: unknown;
-}
-export interface APIUnavailableGuild {
-    id: Snowflake;
-    unavailable?: boolean;
-}
-export interface APIGuild {
-    id: Snowflake;
-    name: string;
-    icon: string | null;
-    icon_hash?: string | null;
-    splash: string | null;
-    discovery_splash: string | null;
-    owner_id: Snowflake;
-    afk_channel_id: Snowflake | null;
-    afk_timeout: number;
-    widget_enabled?: boolean;
-    widget_channel_id?: Snowflake | null;
-    verification_level: number;
-    default_message_notifications: number;
-    explicit_content_filter: number;
-    roles: unknown[];
-    emojis: unknown[];
-    features: string[];
-    mfa_level: number;
-    application_id: Snowflake | null;
-    system_channel_id: Snowflake | null;
-    system_channel_flags: number;
-    rules_channel_id: Snowflake | null;
-    max_presences?: number | null;
-    max_members?: number;
-    vanity_url_code: string | null;
-    description: string | null;
-    banner: string | null;
-    premium_tier: number;
-    premium_subscription_count?: number;
-    preferred_locale: string;
-    public_updates_channel_id: Snowflake | null;
-    max_video_channel_users?: number;
-    max_stage_video_channel_users?: number;
-    welcome_screen?: unknown;
-    nsfw_level: number;
-    stickers?: unknown[];
-    premium_progress_bar_enabled: boolean;
-    safety_alerts_channel_id: Snowflake | null;
-    incidents_data: unknown;
-}
-export interface PartialEmoji {
-    /** null for standard (unicode) emojis. */
-    id: Snowflake | null;
-    /** The unicode character for standard emojis. */
-    name: string | null;
-    animated?: boolean;
-}
-export interface APIMessage {
-    id: Snowflake;
-    channel_id: Snowflake;
-    /** For webhook messages, holds the webhook's id, username and avatar. */
-    author: APIUser;
-    /** Empty without the `MessageContent` intent, except in DMs and when the bot is mentioned. */
-    content: string;
-    timestamp: Timestamp;
-    edited_timestamp: Timestamp | null;
-    tts: boolean;
-    mention_everyone: boolean;
-    /** In MESSAGE_CREATE and MESSAGE_UPDATE, guild mentions carry a partial `member`. */
-    mentions: (APIUser & {
-        member?: Omit<APIGuildMember, 'user'>;
-    })[];
-    mention_roles: Snowflake[];
-    mention_channels?: unknown[];
-    attachments: unknown[];
-    embeds: unknown[];
-    reactions?: unknown[];
-    nonce?: number | string;
-    pinned: boolean;
-    webhook_id?: Snowflake;
-    type: number;
-    activity?: unknown;
-    application?: unknown;
-    application_id?: Snowflake;
-    flags?: number;
-    message_reference?: unknown;
-    message_snapshots?: unknown[];
-    referenced_message?: APIMessage | null;
-    interaction_metadata?: unknown;
-    thread?: GatewayObject;
-    components?: unknown[];
-    sticker_items?: unknown[];
-    position?: number;
-    role_subscription_data?: unknown;
-    resolved?: unknown;
-    poll?: unknown;
-    call?: unknown;
-    shared_client_theme?: unknown;
-    /** Missing for ephemeral messages and DMs. */
-    guild_id?: Snowflake;
-    /** Without `user`. Missing for ephemeral messages, webhooks and DMs. */
-    member?: Omit<APIGuildMember, 'user'>;
-    channel_type?: number;
-}
-export interface APIInteraction {
-    id: Snowflake;
-    application_id: Snowflake;
-    /** 1 PING, 2 APPLICATION_COMMAND, 3 MESSAGE_COMPONENT, 4 APPLICATION_COMMAND_AUTOCOMPLETE, 5 MODAL_SUBMIT */
-    type: number;
-    data?: GatewayObject;
-    guild?: GatewayObject;
-    guild_id?: Snowflake;
-    channel?: GatewayObject;
-    channel_id?: Snowflake;
-    /** Sent when invoked in a guild. */
-    member?: APIGuildMember;
-    /** Sent when invoked in a DM. */
-    user?: APIUser;
-    token: string;
-    version: number;
-    message?: APIMessage;
-    app_permissions: string;
-    locale?: string;
-    guild_locale?: string;
-    entitlements: unknown[];
-    authorizing_integration_owners: Record<string, Snowflake>;
-    context?: number;
-    attachment_size_limit: number;
-}
-export interface APIReadyEvent {
-    v: number;
-    user: APIUser;
-    guilds: APIUnavailableGuild[];
-    session_id: string;
-    resume_gateway_url: string;
-    shard?: [shardId: number, numShards: number];
-    application: {
-        id: Snowflake;
-        flags: number;
-        [key: string]: unknown;
-    };
-}
-export interface APIRateLimitedEvent {
-    opcode: number;
-    retry_after: number;
-    meta: GatewayObject;
-}
-export type APIGuildCreateEvent = (APIGuild & {
-    joined_at: Timestamp;
-    large: boolean;
-    unavailable?: false;
-    member_count: number;
-    voice_states: unknown[];
-    members: APIGuildMember[];
-    channels: GatewayObject[];
-    threads: GatewayObject[];
-    presences: unknown[];
-    stage_instances: unknown[];
-    guild_scheduled_events: unknown[];
-    soundboard_sounds: unknown[];
-}) | (APIUnavailableGuild & {
-    unavailable: true;
-});
-export interface APIGuildBanEvent {
-    guild_id: Snowflake;
-    user: APIUser;
-}
-export interface APIGuildMemberAddEvent extends APIGuildMember {
-    user: APIUser;
-    guild_id: Snowflake;
-}
-export interface APIGuildMemberRemoveEvent {
-    guild_id: Snowflake;
-    user: APIUser;
-}
-export interface APIGuildMemberUpdateEvent {
-    guild_id: Snowflake;
-    roles: Snowflake[];
-    user: APIUser;
-    nick?: string | null;
-    avatar: string | null;
-    banner: string | null;
-    joined_at: Timestamp | null;
-    premium_since?: Timestamp | null;
-    deaf?: boolean;
-    mute?: boolean;
-    pending?: boolean;
-    communication_disabled_until?: Timestamp | null;
-    avatar_decoration_data?: unknown;
-    collectibles?: unknown;
-}
-export interface APIMessageDeleteEvent {
-    id: Snowflake;
-    channel_id: Snowflake;
-    guild_id?: Snowflake;
-}
-export interface APIMessageDeleteBulkEvent {
-    ids: Snowflake[];
-    channel_id: Snowflake;
-    guild_id?: Snowflake;
-}
-export interface APIMessageReactionAddEvent extends APIMessageReactionRemoveEvent {
-    /** Member who reacted, if it happened in a guild. */
-    member?: APIGuildMember;
-    message_author_id?: Snowflake;
-    burst_colors?: string[];
-}
-export interface APIMessageReactionRemoveEvent {
-    user_id: Snowflake;
-    channel_id: Snowflake;
-    message_id: Snowflake;
-    guild_id?: Snowflake;
-    emoji: PartialEmoji;
-    /** true for a super-reaction. */
-    burst: boolean;
-    type: number;
-}
-export interface APIMessageReactionRemoveAllEvent {
-    channel_id: Snowflake;
-    message_id: Snowflake;
-    guild_id?: Snowflake;
-}
-export interface APIMessageReactionRemoveEmojiEvent extends APIMessageReactionRemoveAllEvent {
-    emoji: PartialEmoji;
-}
-export interface APITypingStartEvent {
-    channel_id: Snowflake;
-    guild_id?: Snowflake;
-    user_id: Snowflake;
-    /** Unix time in seconds. */
-    timestamp: number;
-    member?: APIGuildMember;
-}
-export interface APIChannel {
-    id: Snowflake;
-    /** https://docs.discord.com/developers/resources/channel#channel-object-channel-types */
-    type: number;
-    guild_id?: Snowflake;
-    position?: number;
-    permission_overwrites?: unknown[];
-    name?: string | null;
-    topic?: string | null;
-    nsfw?: boolean;
-    last_message_id?: Snowflake | null;
-    bitrate?: number;
-    user_limit?: number;
-    rate_limit_per_user?: number;
-    recipients?: APIUser[];
-    icon?: string | null;
-    owner_id?: Snowflake;
-    application_id?: Snowflake | null;
-    managed?: boolean;
-    parent_id?: Snowflake | null;
-    last_pin_timestamp?: Timestamp | null;
-    rtc_region?: string | null;
-    video_quality_mode?: number;
-    message_count?: number;
-    member_count?: number;
-    thread_metadata?: unknown;
-    member?: unknown;
-    default_auto_archive_duration?: number;
-    permissions?: string;
-    app_permissions?: string;
-    flags?: number;
-    total_message_sent?: number;
-    available_tags?: unknown[];
-    applied_tags?: Snowflake[];
-    default_reaction_emoji?: unknown;
-    default_thread_rate_limit_per_user?: number;
-    default_sort_order?: number | null;
-    default_forum_layout?: number;
-}
-export interface APIRole {
-    id: Snowflake;
-    name: string;
-    /** Deprecated, use `colors`. */
-    color: number;
-    colors: {
-        primary_color: number;
-        secondary_color: number | null;
-        tertiary_color: number | null;
-    };
-    hoist: boolean;
-    icon?: string | null;
-    unicode_emoji?: string | null;
-    position: number;
-    /** Permission bit set. */
-    permissions: string;
-    managed: boolean;
-    mentionable: boolean;
-    tags?: unknown;
-    flags: number;
-}

package/dist/discord/types.js

@@ -1,4 +0,0 @@
-// Shapes of the objects Discord sends, as documented. Only the fields listed in
-// the documentation are typed; nested objects the framework doesn't use yet
-// are typed `unknown` and can be narrowed by the user.
-export {};

package/dist/events.d.ts

@@ -1,94 +0,0 @@
-import { type EventContext } from './context.js';
-import type { Client } from './discord/client.js';
-import { GatewayIntents } from './discord/constants.js';
-import { type EventName } from './discord/events.js';
-/**
- * Runs each time Discord sends the event, with what it is about:
- * `({ client, message }) => message.reply('Hi')`. Errors are logged without
- * stopping the bot.
- */
-export type EventHandler = (context: EventContext) => unknown;
-export type IntentName = keyof typeof GatewayIntents;
-export interface EventDefinition {
-    handler: EventHandler;
-    /**
-     * Additional intents, e.g. `['MessageContent']` to read the content of
-     * messages. The intents the event itself needs are requested automatically.
-     */
-    intents?: IntentName[];
-    /**
-     * messageCreate and messageUpdate only: also receive messages sent by bots,
-     * this one included. Ignored by default, so a bot never answers itself or
-     * loops with another bot.
-     */
-    allowBots?: boolean;
-}
-declare const EVENT: unique symbol;
-/** What `defineEvent` returns, to export by default from a file in `src/events/`. */
-export interface Event {
-    readonly [EVENT]: true;
-    readonly handler: EventHandler;
-    readonly intents: readonly IntentName[];
-    readonly allowBots: boolean;
-}
-/**
- * Handles a Discord event in `src/events/`. The file (or folder) name is the
- * event: `src/events/messageCreate.ts`, or several handlers in
- * `src/events/messageCreate/*.ts`. Files and folders starting with `_` are
- * ignored, for shared code.
- */
-export declare function defineEvent(input: EventHandler | EventDefinition): Event;
-/** An event handler loaded from a file. */
-export interface LoadedEvent {
-    /** Path relative to the project, e.g. `src/events/messageCreate.ts`. */
-    file: string;
-    name: EventName;
-    handler: EventHandler;
-    /** Intents requested for this handler, event's own included. */
-    intents: number;
-    /** Intents listed by the user in `defineEvent`. */
-    extraIntents: readonly IntentName[];
-    /** Whether messages from bots reach this handler (message events only). */
-    allowBots: boolean;
-}
-export interface LoadEventsResult {
-    /** Sorted by file, so handlers of the same event always run in the same order. */
-    events: LoadedEvent[];
-    /** One message per invalid file, prefixed with its path. */
-    errors: string[];
-}
-/**
- * Loads every handler of `src/events/`. With `previous`, a file that fails to
- * load keeps its previous handler (hot reload), so a typo doesn't stop the bot.
- */
-export declare function loadEvents(cwd?: string, previous?: LoadedEvent[]): Promise<LoadEventsResult>;
-/** Intents needed by the events, `Guilds` always included. */
-export declare function eventIntents(events: readonly LoadedEvent[]): number;
-/** `GuildMembers (src/events/guildMemberAdd.ts)` for each privileged intent requested. */
-export declare function privilegedIntentsUsage(events: readonly LoadedEvent[]): string[];
-/**
- * Message handlers without the `MessageContent` intent receive empty contents,
- * except in DMs and for messages mentioning the bot. Returns their files.
- * https://docs.discord.com/developers/events/gateway#message-content-intent
- */
-export declare function filesMissingMessageContent(events: readonly LoadedEvent[]): string[];
-/**
- * Calls the handlers of each event received by the client. Events are queued
- * until `start`, so handlers see READY and the first GUILD_CREATE events even
- * though the CLI runs its checks first.
- */
-export declare class EventRouter {
-    #private;
-    /** Takes an event before the handlers, e.g. clicks on framework components. */
-    intercept: ((event: string, data: unknown) => boolean) | null;
-    constructor(client: Client, events: readonly LoadedEvent[], onError: (file: string, error: unknown) => void);
-    /** Replaces the handlers, e.g. after a reload. */
-    setEvents(events: readonly LoadedEvent[]): void;
-    /** Listener for the client's `dispatch` event. */
-    dispatch: (event: string, data: unknown) => void;
-    /** Runs the queued events, then every event as it arrives. */
-    start(): void;
-}
-/** Calls `onChange` when anything under `src/events/` changes. */
-export declare function watchEvents(onChange: () => void, cwd?: string): import("fs").FSWatcher | null;
-export {};

package/dist/events.js

@@ -1,255 +0,0 @@
-import { existsSync } from 'node:fs';
-import { extname, relative, resolve, sep } from 'node:path';
-import { createContext } from './context.js';
-import { GatewayIntents } from './discord/constants.js';
-import { GATEWAY_EVENTS, PRIVILEGED_INTENTS, toDispatchName, } from './discord/events.js';
-import { describeLoadError, importFresh, isScript, readEntries, scriptFiles, watchTree, } from './utils/modules.js';
-/** Events whose bot messages are ignored unless `allowBots` is set. */
-const MESSAGE_EVENTS = new Set([
-    'messageCreate',
-    'messageUpdate',
-]);
-const EVENT = Symbol.for('chapterjs.event');
-/**
- * Handles a Discord event in `src/events/`. The file (or folder) name is the
- * event: `src/events/messageCreate.ts`, or several handlers in
- * `src/events/messageCreate/*.ts`. Files and folders starting with `_` are
- * ignored, for shared code.
- */
-export function defineEvent(input) {
-    const { handler, intents = [], allowBots = false, } = typeof input === 'function'
-        ? { handler: input }
-        : (input ?? {});
-    if (typeof handler !== 'function') {
-        throw new Error('defineEvent() needs the function to run, e.g. defineEvent(({ message }) => { … }) ' +
-            'or defineEvent({ handler: ({ message }) => { … } }).');
-    }
-    if (!Array.isArray(intents)) {
-        throw new Error("defineEvent(): intents must be a list, e.g. intents: ['MessageContent'].");
-    }
-    if (typeof allowBots !== 'boolean') {
-        throw new Error('defineEvent(): allowBots must be true or false.');
-    }
-    for (const intent of intents) {
-        if (!Object.hasOwn(GatewayIntents, intent)) {
-            const suggestion = Object.keys(GatewayIntents).find(name => normalize(name) === normalize(String(intent)));
-            throw new Error(`defineEvent(): "${intent}" is not an intent. ` +
-                (suggestion
-                    ? `Did you mean "${suggestion}"?`
-                    : `Valid intents: ${Object.keys(GatewayIntents).join(', ')}.`));
-        }
-    }
-    return Object.freeze({
-        [EVENT]: true,
-        handler,
-        intents: Object.freeze([...intents]),
-        allowBots,
-    });
-}
-/** Lowercase without separators: `message-create`, `MESSAGE_CREATE` and `messageCreate` match. */
-const normalize = (name) => name.replace(/[-_]/g, '').toLowerCase();
-const EVENTS_BY_KEY = new Map(Object.keys(GATEWAY_EVENTS).map(name => [
-    normalize(name),
-    name,
-]));
-const eventsDir = (cwd) => resolve(cwd, 'src', 'events');
-/**
- * Loads every handler of `src/events/`. With `previous`, a file that fails to
- * load keeps its previous handler (hot reload), so a typo doesn't stop the bot.
- */
-export async function loadEvents(cwd = process.cwd(), previous = []) {
-    const events = [];
-    const errors = [];
-    for (const entry of scanEvents(eventsDir(cwd))) {
-        const file = relative(cwd, entry.path);
-        if (!entry.name) {
-            errors.push(`${file}: ${entry.error}`);
-            continue;
-        }
-        try {
-            events.push(toLoaded(file, entry.name, (await importFresh(entry.path)).default));
-        }
-        catch (error) {
-            errors.push(describeLoadError(error, entry.path, cwd));
-            events.push(...previous.filter(event => event.file === file));
-        }
-    }
-    return { events, errors };
-}
-function toLoaded(file, name, value) {
-    if (!value || typeof value !== 'object' || !(EVENT in value)) {
-        throw new Error("doesn't export an event. Add at the end of the file: export default defineEvent(({ client }) => { … })");
-    }
-    const event = value;
-    if (event.allowBots && !MESSAGE_EVENTS.has(name)) {
-        throw new Error(`allowBots only works for ${[...MESSAGE_EVENTS].join(' and ')} events: remove it from this file.`);
-    }
-    const extra = event.intents.reduce((bits, intent) => bits | GatewayIntents[intent], 0);
-    return {
-        file,
-        name,
-        handler: event.handler,
-        intents: GATEWAY_EVENTS[name] | extra,
-        extraIntents: event.intents,
-        allowBots: event.allowBots,
-    };
-}
-/**
- * Files of `src/events/`: `<event>.ts` at the root, and any file nested in an
- * `<event>/` folder. Entries starting with `_` or `.`, declarations and tests
- * are ignored.
- */
-function scanEvents(dir) {
-    if (!existsSync(dir))
-        return [];
-    const files = [];
-    for (const entry of readEntries(dir)) {
-        const path = resolve(dir, entry.name);
-        if (entry.isDirectory()) {
-            const name = resolveEventName(entry.name);
-            const nested = scriptFiles(path);
-            if (name)
-                files.push(...nested.map(path => ({ path, name })));
-            else if (nested.length > 0)
-                files.push({ path, error: unknownEventMessage(entry.name) });
-        }
-        else if (isScript(entry)) {
-            const stem = entry.name.slice(0, -extname(entry.name).length);
-            const name = resolveEventName(stem);
-            files.push(name ? { path, name } : { path, error: unknownEventMessage(stem) });
-        }
-    }
-    return files;
-}
-function resolveEventName(name) {
-    return EVENTS_BY_KEY.get(normalize(name));
-}
-function unknownEventMessage(name) {
-    const suggestion = closestEvent(name);
-    return (`"${name}" is not a Discord event.` +
-        (suggestion
-            ? ` Did you mean "${suggestion}"?`
-            : ' See https://docs.discord.com/developers/events/gateway-events#receive-events') +
-        ` If it is shared code and not an event, start its name with _ (_${name}) so it is ignored.`);
-}
-function closestEvent(name) {
-    const key = normalize(name);
-    let best;
-    let bestDistance = Math.max(2, Math.floor(key.length / 4)) + 1;
-    for (const [candidate, event] of EVENTS_BY_KEY) {
-        const distance = levenshtein(key, candidate);
-        if (distance < bestDistance)
-            [best, bestDistance] = [event, distance];
-    }
-    return best;
-}
-function levenshtein(a, b) {
-    let row = Array.from({ length: b.length + 1 }, (_, index) => index);
-    for (let i = 1; i <= a.length; i++) {
-        const next = [i];
-        for (let j = 1; j <= b.length; j++) {
-            next[j] = Math.min(row[j] + 1, next[j - 1] + 1, row[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
-        }
-        row = next;
-    }
-    return row[b.length];
-}
-/** Intents needed by the events, `Guilds` always included. */
-export function eventIntents(events) {
-    return events.reduce((intents, event) => intents | event.intents, GatewayIntents.Guilds);
-}
-/** `GuildMembers (src/events/guildMemberAdd.ts)` for each privileged intent requested. */
-export function privilegedIntentsUsage(events) {
-    return Object.entries(PRIVILEGED_INTENTS).flatMap(([intent, bit]) => {
-        const files = events
-            .filter(event => event.intents & bit)
-            .map(event => event.file);
-        return files.length > 0 ? [`${intent} (${files.join(', ')})`] : [];
-    });
-}
-/**
- * Message handlers without the `MessageContent` intent receive empty contents,
- * except in DMs and for messages mentioning the bot. Returns their files.
- * https://docs.discord.com/developers/events/gateway#message-content-intent
- */
-export function filesMissingMessageContent(events) {
-    if (eventIntents(events) & GatewayIntents.MessageContent)
-        return [];
-    return events
-        .filter(event => event.name === 'messageCreate' || event.name === 'messageUpdate')
-        .map(event => event.file);
-}
-/** Events received before `start` are kept, up to this number. */
-const MAX_QUEUED_EVENTS = 1_000;
-/**
- * Calls the handlers of each event received by the client. Events are queued
- * until `start`, so handlers see READY and the first GUILD_CREATE events even
- * though the CLI runs its checks first.
- */
-export class EventRouter {
-    #client;
-    #onError;
-    #handlers = new Map();
-    #queue = [];
-    /** Takes an event before the handlers, e.g. clicks on framework components. */
-    intercept = null;
-    constructor(client, events, onError) {
-        this.#client = client;
-        this.#onError = onError;
-        this.setEvents(events);
-    }
-    /** Replaces the handlers, e.g. after a reload. */
-    setEvents(events) {
-        const handlers = new Map();
-        for (const event of events) {
-            const name = toDispatchName(event.name);
-            handlers.set(name, [...(handlers.get(name) ?? []), event]);
-        }
-        this.#handlers = handlers;
-    }
-    /** Listener for the client's `dispatch` event. */
-    dispatch = (event, data) => {
-        if (!this.#queue)
-            return this.#run(event, data);
-        if (this.#queue.length < MAX_QUEUED_EVENTS &&
-            (this.#handlers.has(event) || this.intercept)) {
-            this.#queue.push([event, data]);
-        }
-    };
-    /** Runs the queued events, then every event as it arrives. */
-    start() {
-        const queue = this.#queue ?? [];
-        this.#queue = null;
-        for (const [event, data] of queue)
-            this.#run(event, data);
-    }
-    #run(event, data) {
-        if (this.intercept?.(event, data))
-            return;
-        const fromBot = data?.author?.bot === true;
-        const handlers = this.#handlers
-            .get(event)
-            ?.filter(handler => handler.allowBots || !fromBot || !MESSAGE_EVENTS.has(handler.name));
-        if (!handlers?.length)
-            return;
-        let context;
-        try {
-            context = createContext(handlers[0].name, this.#client, data);
-        }
-        catch (error) {
-            for (const { file } of handlers)
-                this.#onError(file, error);
-            return;
-        }
-        for (const { file, handler } of handlers) {
-            // Each handler runs on its own: a slow or failing one doesn't block the others
-            Promise.resolve()
-                .then(() => handler(context))
-                .catch(error => this.#onError(file, error));
-        }
-    }
-}
-/** Calls `onChange` when anything under `src/events/` changes. */
-export function watchEvents(onChange, cwd = process.cwd()) {
-    return watchTree(resolve(cwd, 'src'), path => path === 'events' || path.startsWith(`events${sep}`), onChange);
-}