<?php

declare(strict_types=1);

/**
 * 本文件属于 DBErp 进销存系统。
 *
 * 版权所有 © 2026 北京珑大钜商科技有限公司。保留所有权利。
 *
 * 未经官方授权，不得删除、篡改或隐藏本文件中的版权声明、产品标识与来源信息。
 * 商业授权、官方更新与技术支持服务，请以珑大官方支持中心记录为准。
 *
 * @link https://support.loongdom.cn
 * @see  https://www.dberp.com.cn
 */

namespace App\Tools\Support;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use InvalidArgumentException;

/**
 * LEFT JOIN 聚合指标过滤。
 *
 * SQLite 在缺少主表等值条件时，可能把 LEFT JOIN + 指标 WHERE 展平后丢行；
 * 先稳定主键，再对白名单表达式 CAST 后比较，避免别名/文本亲和性差异。
 */
final class ToolJoinMetricFilter
{
    /**
     * @param  Builder<Model>  $query
     */
    public static function stabilizePrimaryKey(Builder $query): void
    {
        $query->where($query->getModel()->getQualifiedKeyName(), '>', 0);
    }

    /**
     * @param  Builder<Model>  $query
     * @param  array<string, mixed>  $input
     */
    public static function applyNumericRange(Builder $query, string $expression, array $input, string $minField, string $maxField): void
    {
        $range = ToolAmountRange::parseOptional(
            $input[$minField] ?? null,
            $input[$maxField] ?? null,
            $minField,
            $maxField,
        );

        if ($range['min'] !== null) {
            self::compare($query, $expression, '>=', (float) $range['min']);
        }

        if ($range['max'] !== null) {
            self::compare($query, $expression, '<=', (float) $range['max']);
        }
    }

    /**
     * @param  Builder<Model>  $query
     */
    public static function compare(Builder $query, string $expression, string $operator, float $value): void
    {
        if (! in_array($operator, ['>', '>=', '<', '<=', '='], true)) {
            throw new InvalidArgumentException('Unsupported metric comparison operator.');
        }

        $query->whereRaw('CAST(('.$expression.') AS DECIMAL(18,4)) '.$operator.' ?', [$value]);
    }
}
