/**
* Error handling utilities for consistent error logging across the codebase.
* Uses structured logger to keep output consistent.
*/
import logger from './logger.js';
/**
* Type guard to check if a value is an Error instance.
*/
function isError(value: unknown): value is Error {
return value instanceof Error;
}
/**
* Safely extracts an error message from any thrown value.
* Returns error.message if Error, String(error) otherwise.
*/
export function toErrorMessage(error: unknown): string {
if (isError(error)) {
return error.message;
}
return String(error);
}
/**
* Logs an error with context prefix and optional details.
* Format: [context] message { details }
*/
export function logError(
context: string,
error: unknown,
details?: Record<string, unknown>
): void {
const message = toErrorMessage(error);
const payload = { context, ...(details ?? {}) };
if (isError(error)) {
logger.error({ ...payload, err: error }, message);
return;
}
logger.error(payload, message);
}
