config-loader.sh

#!/usr/bin/env bash
# Source guard: prevent double-sourcing
[[ -n "${_CONFIG_LOADER_LOADED:-}" ]] && return 0 2>/dev/null || true
_CONFIG_LOADER_LOADED=1

set -euo pipefail

_config_loader_warn() {
    echo "Warning: $*" >&2
}

_config_loader_fatal() {
    echo "Error: $*" >&2
    return 1
}

_config_loader_require_jq() {
    if ! command -v jq >/dev/null 2>&1; then
        _config_loader_fatal "jq is required. Install it (for example: 'brew install jq' or 'sudo apt-get install jq')."
        return 1
    fi
}

_config_loader_prepare_layer() {
    local config_path="${1:-}"
    local config_label="${2:-config}"
    local output_file="${3:-}"
    local required="${4:-false}"

    if [[ -z "$output_file" ]]; then
        _config_loader_fatal "_config_loader_prepare_layer requires an output file path."
        exit 1
    fi

    if [[ -z "$config_path" ]]; then
        printf '{}' > "$output_file"
        return 0
    fi

    if [[ ! -f "$config_path" ]]; then
        if [[ "$required" == "true" ]]; then
            _config_loader_fatal "Missing required ${config_label}: $config_path"
            # exit instead of return: this function is only called inside the (...)
            # subshell in load_merged_config; set -e does not reliably propagate
            # through nested if-body function calls in bash.
            exit 1
        fi
        printf '{}' > "$output_file"
        return 0
    fi

    if ! jq -e 'if type == "object" then . else error("not a JSON object") end' "$config_path" > "$output_file" 2>/dev/null; then
        if [[ "$required" == "true" ]]; then
            _config_loader_fatal "Malformed required ${config_label} (must be a JSON object): $config_path"
            exit 1
        fi
        _config_loader_warn "Ignoring malformed ${config_label} (must be a JSON object): $config_path"
        printf '{}' > "$output_file"
        return 0
    fi
}

load_merged_config() {
    local plugin_root="${1:-}"
    local project_root="${2:-}"
    local default_config_path=""
    local user_config_path=""
    local project_config_path=""

    if [[ -z "$plugin_root" || -z "$project_root" ]]; then
        _config_loader_fatal "Usage: load_merged_config <plugin_root> <project_root>"
        return 1
    fi

    _config_loader_require_jq

    default_config_path="$plugin_root/config/default_config.json"
    if [[ -n "${XDG_CONFIG_HOME:-}" ]]; then
        user_config_path="$XDG_CONFIG_HOME/humanize/config.json"
    else
        user_config_path="${HOME:-}/.config/humanize/config.json"
    fi

    if [[ -n "${HUMANIZE_CONFIG:-}" ]]; then
        project_config_path="$HUMANIZE_CONFIG"
    else
        project_config_path="$project_root/.humanize/config.json"
    fi

    (
        set -euo pipefail

        local tmp_dir=""
        local empty_layer_file=""
        local default_layer_file=""
        local user_layer_file=""
        local project_layer_file=""
        local merged_json=""

        tmp_dir="$(mktemp -d)"
        trap 'rm -rf "${tmp_dir:-}"' EXIT

        empty_layer_file="$tmp_dir/empty.json"
        default_layer_file="$tmp_dir/default.json"
        user_layer_file="$tmp_dir/user.json"
        project_layer_file="$tmp_dir/project.json"

        printf '{}' > "$empty_layer_file"
        _config_loader_prepare_layer "$default_config_path" "default config" "$default_layer_file" "true"
        _config_loader_prepare_layer "$user_config_path" "user config" "$user_layer_file" "false"
        _config_loader_prepare_layer "$project_config_path" "project config" "$project_layer_file" "false"

        merged_json="$(
            jq -n \
                --slurpfile layer0 "$empty_layer_file" \
                --slurpfile layer1 "$default_layer_file" \
                --slurpfile layer2 "$user_layer_file" \
                --slurpfile layer3 "$project_layer_file" '
                def strip_nulls:
                    if type == "object" then
                        with_entries(select(.value != null) | .value |= strip_nulls)
                    elif type == "array" then
                        map(select(. != null) | strip_nulls)
                    else
                        .
                    end;

                ($layer0[0] // {} | strip_nulls)
                * ($layer1[0] // {} | strip_nulls)
                * ($layer2[0] // {} | strip_nulls)
                * ($layer3[0] // {} | strip_nulls)
            '
        )"

        printf '%s\n' "$merged_json"
    )
}

get_config_value() {
    local merged_config_json="${1:-}"
    local key="${2:-}"

    if [[ -z "$key" ]]; then
        _config_loader_fatal "Usage: get_config_value <merged_config_json> <key>"
        return 1
    fi

    printf '%s' "$merged_config_json" | jq -r --arg key "$key" '
        if has($key) then
            .[$key]
            | if type == "string" then .
              elif . == null then empty
              else tostring
              end
        else
            empty
        end
    '
}