error.ts

import type { Pos } from './node.js';

export abstract class AiScriptError extends Error {
	// name is read by Error.prototype.toString
	public name = 'AiScript';
	public info: unknown;
	public pos?: Pos;

	constructor(message: string, info?: unknown) {
		super(message);

		this.info = info;

		// Maintains proper stack trace for where our error was thrown (only available on V8)
		if (Error.captureStackTrace) {
			Error.captureStackTrace(this, AiScriptError);
		}
	}
}

/**
 * Wrapper for non-AiScript errors.
 */
export class NonAiScriptError extends AiScriptError {
	public name = 'Internal';
	constructor(error: unknown) {
		let message: string;
		if (error != null && typeof error === 'object' && 'message' in error) {
			message = String(error.message);
		} else {
			message = String(error);
		}
		super(message, error);
	}
}

/**
 * Parse-time errors.
 */
export class AiScriptSyntaxError extends AiScriptError {
	public name = 'Syntax';
	constructor(message: string, public pos: Pos, info?: unknown) {
		super(`${message} (Line ${pos.line}, Column ${pos.column})`, info);
	}
}

/**
 * Unexpected EOF errors.
 */
export class AiScriptUnexpectedEOFError extends AiScriptSyntaxError {
	constructor(pos: Pos, info?: unknown) {
		super('unexpected EOF', pos, info);
	}
}

/**
 * Type validation(parser/plugins/validate-type) errors.
 */
export class AiScriptTypeError extends AiScriptError {
	public name = 'Type';
	constructor(message: string, public pos: Pos, info?: unknown) {
		super(`${message} (Line ${pos.line}, Column ${pos.column})`, info);
	}
}

/**
 * Namespace collection errors.
 */
export class AiScriptNamespaceError extends AiScriptError {
	public name = 'Namespace';
	constructor(message: string, public pos: Pos, info?: unknown) {
		super(`${message} (Line ${pos.line}, Column ${pos.column})`, info);
	}
}

/**
 * Interpret-time errors.
 */
export class AiScriptRuntimeError extends AiScriptError {
	public name = 'Runtime';
	constructor(message: string, info?: unknown) {
		super(message, info);
	}
}
/**
 * RuntimeError for illegal access to arrays.
 */
export class AiScriptIndexOutOfRangeError extends AiScriptRuntimeError {
	constructor(message: string, info?: unknown) {
		super(message, info);
	}
}
/**
 * Errors thrown by users.
 */
export class AiScriptUserError extends AiScriptRuntimeError {
	public name = '';
	constructor(message: string, info?: unknown) {
		super(message, info);
	}
}
/**
 * Host side configuration errors.
 */
export class AiScriptHostsideError extends AiScriptError {
	public name = 'Host';
	constructor(message: string, info?: unknown) {
		super(message, info);
	}
}