error.cpp

// Copyright (c) 2024-2026 Qualcomm Technologies, Inc. and/or its subsidiaries.
// SPDX-License-Identifier: BSD-3-Clause

#include "geniex.h"

/**
 * @brief Get error message string for error code
 *
 * This function maps error codes to human-readable error messages.
 * Error codes follow hierarchical naming: GENIEX_ERROR_[CATEGORY]_[SUBCATEGORY]_[ERROR_TYPE]
 *
 * @param error_code Error code from geniex_ErrorCode enumeration
 * @return Error message string (const char*)
 */
const char* geniex_get_error_message(const geniex_ErrorCode error_code) {
    if (error_code > 0) {
        return "Success";  // Success case
    }

    switch (error_code) {
            /** ===== SUCCESS ===== */
        case GENIEX_SUCCESS:
            return "Success";

            /* ===== COMMON ERRORS (100xxx) ===== */
        case GENIEX_ERROR_COMMON_UNKNOWN:
            return "Unknown error";
        case GENIEX_ERROR_COMMON_INVALID_INPUT:
            return "Invalid input parameters or handle";
        case GENIEX_ERROR_COMMON_INVALID_DEVICE:
            return "Unknown device alias (expected one of: cpu, gpu, npu, hybrid)";
        case GENIEX_ERROR_COMMON_MEMORY_ALLOCATION:
            return "Memory allocation failed";
        case GENIEX_ERROR_COMMON_FILE_NOT_FOUND:
            return "File not found or inaccessible";
        case GENIEX_ERROR_COMMON_NOT_INITIALIZED:
            return "Library not initialized";
        case GENIEX_ERROR_COMMON_AUTH:
            return "Hub rejected request; authentication required";
        case GENIEX_ERROR_COMMON_HUB_MODEL_NOT_FOUND:
            return "Model not found on hub";
        case GENIEX_ERROR_COMMON_RATE_LIMITED:
            return "Hub rate limit exceeded";
        case GENIEX_ERROR_COMMON_HUB_SERVER:
            return "Hub server error";
        case GENIEX_ERROR_COMMON_NOT_SUPPORTED:
            return "Operation not supported";
        case GENIEX_ERROR_COMMON_PARAM_NOT_SUPPORTED:
            return "Parameter not supported by this plugin";
        case GENIEX_ERROR_COMMON_MODEL_LOAD:
            return "Model loading failed";
        case GENIEX_ERROR_COMMON_MODEL_INVALID:
            return "Invalid model format";
        case GENIEX_ERROR_COMMON_PLUGIN_LOAD:
            return "Plugin loading failed";
        case GENIEX_ERROR_COMMON_PLUGIN_INVALID:
            return "Invalid plugin";
            /* ===== LLM ERRORS (200xxx) ===== */
        case GENIEX_ERROR_LLM_TOKENIZATION_FAILED:
            return "Tokenization failed";
        case GENIEX_ERROR_LLM_TOKENIZATION_CONTEXT_LENGTH:
            return "Context length exceeded";
        case GENIEX_ERROR_LLM_GENERATION_FAILED:
            return "Text generation failed";
        case GENIEX_ERROR_LLM_GENERATION_PROMPT_TOO_LONG:
            return "Input prompt too long";

            /* ===== VLM ERRORS (201xxx) ===== */
        case GENIEX_ERROR_VLM_IMAGE_LOAD:
            return "Image loading failed";
        case GENIEX_ERROR_VLM_IMAGE_FORMAT:
            return "Unsupported image format";
        case GENIEX_ERROR_VLM_AUDIO_LOAD:
            return "Audio loading failed";
        case GENIEX_ERROR_VLM_AUDIO_FORMAT:
            return "Unsupported audio format";
        case GENIEX_ERROR_VLM_GENERATION_FAILED:
            return "Multimodal generation failed";

        default:
            return "Unknown error code";
    }
}