/******************************************************************************
               __               ____                __
              / /   ___  ____ _/ __/_____________ _/ /__
             / /   / _ \/ __ `/ /_/ ___/ ___/ __ `/ / _ \
            / /___/  __/ /_/ / __(__  ) /__/ /_/ / /  __/
           /_____/\___/\__,_/_/ /____/\___/\__,_/_/\___/

   (C)opyright 2025, Leafscale, LLC -  https://www.leafscale.com

   Project: Zygaena
  Filename: exitcodes.reef
   Authors: Chris Tusa <chris.tusa@leafscale.com>
   License: <see LICENSE file included with this source code>
Description: Exit code constants for Coral package manager

******************************************************************************/

module exitcodes

export
    // Success
    fn EXIT_SUCCESS(): int

    // General errors (1-9)
    fn EXIT_ERROR(): int
    fn EXIT_USAGE(): int
    fn EXIT_CANCELLED(): int

    // Package errors (10-19)
    fn EXIT_PKG_NOT_FOUND(): int
    fn EXIT_PKG_ALREADY_INSTALLED(): int
    fn EXIT_PKG_INVALID(): int
    fn EXIT_PKG_CHECKSUM_MISMATCH(): int
    fn EXIT_PKG_SIGNATURE_INVALID(): int
    fn EXIT_PKG_CONFLICT(): int
    fn EXIT_INSTALL_FAILED(): int
    fn EXIT_REMOVE_FAILED(): int
    fn EXIT_UPGRADE_FAILED(): int

    // Build errors (20-29)
    fn EXIT_BUILD_FAILED(): int
    fn EXIT_PORT_NOT_FOUND(): int
    fn EXIT_SOURCE_MISSING(): int
    fn EXIT_PATCH_FAILED(): int
    fn EXIT_EXTRACT_FAILED(): int
    fn EXIT_CHECKSUM_FAILED(): int
    fn EXIT_PACKAGE_FAILED(): int

    // Network errors (30-39)
    fn EXIT_DOWNLOAD_FAILED(): int
    fn EXIT_REPO_UNREACHABLE(): int
    fn EXIT_TIMEOUT(): int

    // Database errors (40-49)
    fn EXIT_DB_ERROR(): int
    fn EXIT_DB_REGISTER_FAILED(): int
    fn EXIT_DB_CORRUPT(): int
    fn EXIT_DB_INDEX_STALE(): int

    // Permission errors (50-59)
    fn EXIT_PERMISSION_DENIED(): int
    fn EXIT_ROOT_REQUIRED(): int

    // Dependency errors (60-69)
    fn EXIT_DEPS_UNMET(): int
    fn EXIT_DEPS_CIRCULAR(): int
    fn EXIT_DEPS_CONFLICT(): int
    fn EXIT_DEPS_BLOCKED(): int

    // Config errors (70-79)
    fn EXIT_CONFIG_ERROR(): int
    fn EXIT_CONFIG_INVALID(): int
    fn EXIT_CONFIG_MISSING(): int

    // Informational codes for scripting (100+)
    fn EXIT_UPDATE_AVAILABLE(): int
    fn EXIT_MANIFEST_STALE(): int
    fn EXIT_NO_UPDATES(): int
end export

// ============================================================================
// Success (0)
// ============================================================================

fn EXIT_SUCCESS(): int
    return 0
end EXIT_SUCCESS

// ============================================================================
// General Errors (1-9)
// ============================================================================

fn EXIT_ERROR(): int
    return 1
end EXIT_ERROR

fn EXIT_USAGE(): int
    return 2
end EXIT_USAGE

fn EXIT_CANCELLED(): int
    return 3
end EXIT_CANCELLED

// ============================================================================
// Package Errors (10-19)
// ============================================================================

fn EXIT_PKG_NOT_FOUND(): int
    return 10
end EXIT_PKG_NOT_FOUND

fn EXIT_PKG_ALREADY_INSTALLED(): int
    return 11
end EXIT_PKG_ALREADY_INSTALLED

fn EXIT_PKG_INVALID(): int
    return 12
end EXIT_PKG_INVALID

fn EXIT_PKG_CHECKSUM_MISMATCH(): int
    return 13
end EXIT_PKG_CHECKSUM_MISMATCH

fn EXIT_PKG_SIGNATURE_INVALID(): int
    return 14
end EXIT_PKG_SIGNATURE_INVALID

fn EXIT_PKG_CONFLICT(): int
    return 15
end EXIT_PKG_CONFLICT

fn EXIT_INSTALL_FAILED(): int
    return 16
end EXIT_INSTALL_FAILED

fn EXIT_REMOVE_FAILED(): int
    return 17
end EXIT_REMOVE_FAILED

fn EXIT_UPGRADE_FAILED(): int
    return 18
end EXIT_UPGRADE_FAILED

// ============================================================================
// Build Errors (20-29)
// ============================================================================

fn EXIT_BUILD_FAILED(): int
    return 20
end EXIT_BUILD_FAILED

fn EXIT_PORT_NOT_FOUND(): int
    return 21
end EXIT_PORT_NOT_FOUND

fn EXIT_SOURCE_MISSING(): int
    return 22
end EXIT_SOURCE_MISSING

fn EXIT_PATCH_FAILED(): int
    return 23
end EXIT_PATCH_FAILED

fn EXIT_EXTRACT_FAILED(): int
    return 24
end EXIT_EXTRACT_FAILED

fn EXIT_CHECKSUM_FAILED(): int
    return 25
end EXIT_CHECKSUM_FAILED

fn EXIT_PACKAGE_FAILED(): int
    return 26
end EXIT_PACKAGE_FAILED

// ============================================================================
// Network Errors (30-39)
// ============================================================================

fn EXIT_DOWNLOAD_FAILED(): int
    return 30
end EXIT_DOWNLOAD_FAILED

fn EXIT_REPO_UNREACHABLE(): int
    return 31
end EXIT_REPO_UNREACHABLE

fn EXIT_TIMEOUT(): int
    return 32
end EXIT_TIMEOUT

// ============================================================================
// Database Errors (40-49)
// ============================================================================

fn EXIT_DB_ERROR(): int
    return 40
end EXIT_DB_ERROR

fn EXIT_DB_REGISTER_FAILED(): int
    return 41
end EXIT_DB_REGISTER_FAILED

fn EXIT_DB_CORRUPT(): int
    return 42
end EXIT_DB_CORRUPT

fn EXIT_DB_INDEX_STALE(): int
    return 43
end EXIT_DB_INDEX_STALE

// ============================================================================
// Permission Errors (50-59)
// ============================================================================

fn EXIT_PERMISSION_DENIED(): int
    return 50
end EXIT_PERMISSION_DENIED

fn EXIT_ROOT_REQUIRED(): int
    return 51
end EXIT_ROOT_REQUIRED

// ============================================================================
// Dependency Errors (60-69)
// ============================================================================

fn EXIT_DEPS_UNMET(): int
    return 60
end EXIT_DEPS_UNMET

fn EXIT_DEPS_CIRCULAR(): int
    return 61
end EXIT_DEPS_CIRCULAR

fn EXIT_DEPS_CONFLICT(): int
    return 62
end EXIT_DEPS_CONFLICT

fn EXIT_DEPS_BLOCKED(): int
    return 63
end EXIT_DEPS_BLOCKED

// ============================================================================
// Config Errors (70-79)
// ============================================================================

fn EXIT_CONFIG_ERROR(): int
    return 70
end EXIT_CONFIG_ERROR

fn EXIT_CONFIG_INVALID(): int
    return 71
end EXIT_CONFIG_INVALID

fn EXIT_CONFIG_MISSING(): int
    return 72
end EXIT_CONFIG_MISSING

// ============================================================================
// Informational Codes for Scripting (100+)
// ============================================================================

fn EXIT_UPDATE_AVAILABLE(): int
    return 100
end EXIT_UPDATE_AVAILABLE

fn EXIT_MANIFEST_STALE(): int
    return 101
end EXIT_MANIFEST_STALE

fn EXIT_NO_UPDATES(): int
    return 102
end EXIT_NO_UPDATES

end module