boardgame-core/src/utils/command/command-runner.ts

import type { Command, CommandSchema } from './types.js';

export type PromptEvent = {
    schema: CommandSchema;
    resolve: (command: Command) => void;
    reject: (error: Error) => void;
};

export type CommandRunnerEvents = {
    prompt: PromptEvent;
};

export type CommandRunnerContext<TContext> = {
    context: TContext;
    run: (input: string) => Promise<{ success: true; result: unknown } | { success: false; error: string }>;
    runParsed: (command: Command) => Promise<{ success: true; result: unknown } | { success: false; error: string }>;
    prompt: (schema: CommandSchema | string) => Promise<Command>;
    on: <T extends keyof CommandRunnerEvents>(event: T, listener: (e: CommandRunnerEvents[T]) => void) => void;
    off: <T extends keyof CommandRunnerEvents>(event: T, listener: (e: CommandRunnerEvents[T]) => void) => void;
};

export type CommandRunnerHandler<TContext, TResult> = (
    this: CommandRunnerContext<TContext>,
    command: Command
) => Promise<TResult>;

export type CommandRunner<TContext, TResult = unknown> = {
    schema: CommandSchema;
    run: CommandRunnerHandler<TContext, TResult>;
};