Method mapError

core/src/utils/error-mapper.ts:84–131

* Main entry point for error mapping

(error: unknown)

     * Main entry point for error mapping
     */
    mapError(error: unknown): BaseError {
        // Already a BaseError, just add exchange context if missing
        if (error instanceof BaseError) {
            if (!error.exchange && this.exchangeName) {
                return new (error.constructor as new (...args: unknown[]) => BaseError)(
                    error.message,
                    this.exchangeName
                );
            }
            return error;
        }

        // Handle axios errors
        if (axios.isAxiosError(error)) {
            return this.mapAxiosError(error);
        }

        // Handle plain objects with status/data (e.g., Polymarket clob-client)
        if (isPlainErrorObject(error)) {
            const message = this.extractErrorMessage(error);
            return this.mapByStatusCode(error.status, message, error.data, error);
        }

        // Handle network errors
        if (isNodeError(error)) {
            if (error.code === 'ECONNREFUSED' || error.code === 'ENOTFOUND' || error.code === 'ETIMEDOUT') {
                return new NetworkError(
                    `Network error: ${error.message}`,
                    this.exchangeName
                );
            }
        }

        // Handle Error instances with attached HTTP metadata (common in third-party SDKs)
        if (error instanceof Error) {
            const err = error as ErrorWithHttpMetadata;
            const status = err.status ?? err.statusCode ?? err.response?.status ?? err.response?.statusCode;
            if (typeof status === 'number') {
                const message = this.extractErrorMessage(error);
                const data = err.data ?? err.response?.data ?? err.response?.body;
                return this.mapByStatusCode(status, message, data, err.response);
            }
        }

        // Generic error fallback
        const message = this.extractErrorMessage(error);
        return new BadRequest(message, this.exchangeName);
    }

    /**
     * Maps axios HTTP errors to appropriate error classes