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

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

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

export type CommandRunnerEvents = {
    prompt: PromptEvent;
};

export type CommandResult<T=unknown> = {
    success: true;
    result: T;
} | {
    success: false;
    error: string;
}

export type CommandRunnerContext<TContext> = {
    context: TContext;
    run: <T=unknown>(input: string) => Promise<CommandResult<T>>;
    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>;
};