<?php

/**
 *+------------------
 * madong
 *+------------------
 * Copyright (c) https://gitee.com/motion-code All rights reserved.
 *+------------------
 * Author: Mr. April (405784684@qq.com)
 *+------------------
 * Official Website: http://www.madong.tech
 */

namespace madong\query;

use madong\query\enum\ParamFormat;
use madong\query\enum\QueryMode;

/**
 * QuerySelect 配置类
 * 用于灵活配置 selectInput 方法的返回格式和行为
 */
class QuerySelectConfig
{
 /**
 * 返回格式类型
 * - array: 返回数组格式 [where, format, limit, field, order, page]
 * - object: 返回对象格式(支持更多自定义字段)
 * - compact: 返回紧凑格式,仅包含必要字段
 */
 private string $returnFormat = 'array';

 /**
 * 参数格式限定
 * - filters: 标准 filters 格式
 * - uppercase: 大写前缀格式
 * - array: 三元素数组格式
 * - where: 直接 where 条件格式
 * - auto: 自动检测格式
 */
 private string $paramFormat = ParamFormat::AUTO->value;

 /**
 * 查询模式
 * - standard: 标准模式
 * - uppercase: 大写前缀模式
 * - auto: 自动检测模式
 */
 private string $queryMode = QueryMode::AUTO->value;

 /**
 * 跳过的字段(不在 where 条件中包含这些字段)
 * @var array
 */
 private array $skipFields = [];

 /**
 * 允许的字段白名单
 * @var array|null
 */
 private ?array $allowedFields = null;

 /**
 * 排序字段白名单
 * @var array|null
 */
 private ?array $sortFields = null;

 /**
 * 默认排序
 * @var array
 */
 private array $defaultSort = [];

 /**
 * 默认每页数量
 */
 private int $defaultPageSize = 10;

 /**
 * 最大每页数量
 */
 private int $maxPageSize = 100;

 /**
 * 默认页码
 */
 private int $defaultPage = 1;

 /**
 * 关键词搜索字段
 * @var array
 */
 private array $keywordFields = [];

 /**
 * 是否启用关键词搜索
 */
 private bool $enableKeywordSearch = false;

 /**
 * 关键词参数名
 */
 private string $keywordParam = 'keyword';

 /**
 * 是否启用范围查询(between)
 */
 private bool $enableRangeQuery = true;

 /**
 * 是否启用模糊匹配(like)
 */
 private bool $enableLikeQuery = true;

 /**
 * 是否自动转换日期时间格式
 */
 private bool $autoConvertDateTime = true;

 /**
 * 是否跳过空值
 */
 private bool $skipEmptyValues = true;

 /**
 * 自定义返回字段
 * @var array
 */
 private array $customFields = [];

 /**
 * 是否启用缓存
 */
 private bool $enableCache = false;

 /**
 * 缓存时间(秒)
 */
 private int $cacheTtl = 3600;

 /**
 * 是否启用调试模式
 */
 private bool $debugMode = false;

 /**
 * 过滤器格式
 * - array: 数组格式 [[字段, 操作符, 值], ...]
 * - keyvalue: 键值对格式 [字段 => 'op:value', ...]
 */
 private string $filterFormat = 'keyvalue';

 /**
 * 默认操作符
 * 用于没有明确指定操作符时的默认值,如 'eq', 'gt', 'lt', 'like' 等
 */
 private string $defaultOperator = 'eq';

 /**
 * 创建配置实例
 *
 * @param array $config
 * @return self
 */
 public static function make(array $config = []): self
 {
 return new self($config);
 }

 /**
 * 构造函数
 *
 * @param array $config
 */
 public function __construct(array $config = [])
 {
 foreach ($config as $key => $value) {
 // 将下划线命名转换为驼峰命名:custom_fields -> CustomFields
 $method = 'set' . str_replace('_', '', ucwords($key, '_'));
 if (method_exists($this, $method)) {
 $this->$method($value);
 }
 }
 }

 // Getters

 public function getReturnFormat(): string
 {
 return $this->returnFormat;
 }

 public function getParamFormat(): string
 {
 return $this->paramFormat;
 }

 public function getQueryMode(): string
 {
 return $this->queryMode;
 }

 public function getSkipFields(): array
 {
 return $this->skipFields;
 }

 public function getAllowedFields(): ?array
 {
 return $this->allowedFields;
 }

 public function getSortFields(): ?array
 {
 return $this->sortFields;
 }

 public function getDefaultSort(): array
 {
 return $this->defaultSort;
 }

 public function getDefaultPageSize(): int
 {
 return $this->defaultPageSize;
 }

 public function getMaxPageSize(): int
 {
 return $this->maxPageSize;
 }

 public function getDefaultPage(): int
 {
 return $this->defaultPage;
 }

 public function getKeywordFields(): array
 {
 return $this->keywordFields;
 }

 public function isEnableKeywordSearch(): bool
 {
 return $this->enableKeywordSearch;
 }

 public function getKeywordParam(): string
 {
 return $this->keywordParam;
 }

 public function isEnableRangeQuery(): bool
 {
 return $this->enableRangeQuery;
 }

 public function isEnableLikeQuery(): bool
 {
 return $this->enableLikeQuery;
 }

 public function isAutoConvertDateTime(): bool
 {
 return $this->autoConvertDateTime;
 }

 public function isSkipEmptyValues(): bool
 {
 return $this->skipEmptyValues;
 }

 public function getCustomFields(): array
 {
 return $this->customFields;
 }

 public function isEnableCache(): bool
 {
 return $this->enableCache;
 }

 public function getCacheTtl(): int
 {
 return $this->cacheTtl;
 }

 public function isDebugMode(): bool
 {
 return $this->debugMode;
 }

 public function getFilterFormat(): ?string
 {
 return $this->filterFormat;
 }

 public function getDefaultOperator(): string
 {
 return $this->defaultOperator;
 }

 // Setters

 public function setReturnFormat(string $format): self
 {
 $this->returnFormat = in_array($format, ['array', 'object', 'compact']) ? $format : 'array';
 return $this;
 }

 public function setParamFormat(string $format): self
 {
 if (ParamFormat::isValid($format)) {
 $this->paramFormat = $format;
 }
 return $this;
 }

 public function setQueryMode(string $mode): self
 {
 if (QueryMode::isValid($mode)) {
 $this->queryMode = $mode;
 }
 return $this;
 }

 public function setSkipFields(array $fields): self
 {
 $this->skipFields = $fields;
 return $this;
 }

 public function setAllowedFields(?array $fields): self
 {
 $this->allowedFields = $fields;
 return $this;
 }

 public function setSortFields(?array $fields): self
 {
 $this->sortFields = $fields;
 return $this;
 }

 public function setDefaultSort(array $sort): self
 {
 $this->defaultSort = $sort;
 return $this;
 }

 public function setDefaultPageSize(int $size): self
 {
 $this->defaultPageSize = max(1, $size);
 return $this;
 }

 public function setMaxPageSize(int $size): self
 {
 $this->maxPageSize = max(1, $size);
 return $this;
 }

 public function setDefaultPage(int $page): self
 {
 $this->defaultPage = max(1, $page);
 return $this;
 }

 public function setKeywordFields(array $fields): self
 {
 $this->keywordFields = $fields;
 return $this;
 }

 public function setEnableKeywordSearch(bool $enable): self
 {
 $this->enableKeywordSearch = $enable;
 return $this;
 }

 public function setKeywordParam(string $param): self
 {
 $this->keywordParam = $param;
 return $this;
 }

 public function setEnableRangeQuery(bool $enable): self
 {
 $this->enableRangeQuery = $enable;
 return $this;
 }

 public function setEnableLikeQuery(bool $enable): self
 {
 $this->enableLikeQuery = $enable;
 return $this;
 }

 public function setAutoConvertDateTime(bool $auto): self
 {
 $this->autoConvertDateTime = $auto;
 return $this;
 }

 public function setSkipEmptyValues(bool $skip): self
 {
 $this->skipEmptyValues = $skip;
 return $this;
 }

 public function setCustomFields(array $fields): self
 {
 $this->customFields = $fields;
 return $this;
 }

 public function setEnableCache(bool $enable): self
 {
 $this->enableCache = $enable;
 return $this;
 }

 public function setCacheTtl(int $ttl): self
 {
 $this->cacheTtl = max(0, $ttl);
 return $this;
 }

 public function setDebugMode(bool $debug): self
 {
 $this->debugMode = $debug;
 return $this;
 }

 public function setFilterFormat(string $format): self
 {
 $this->filterFormat = in_array($format, ['array', 'keyvalue']) ? $format : 'array';
 return $this;
 }

 public function setDefaultOperator(string $operator): self
 {
 $this->defaultOperator = $operator;
 return $this;
 }

 /**
 * 添加跳过的字段
 *
 * @param string|array $fields
 * @return self
 */
 public function addSkipFields($fields): self
 {
 $fields = is_array($fields) ? $fields : [$fields];
 $this->skipFields = array_merge($this->skipFields, $fields);
 return $this;
 }

 /**
 * 添加允许的字段
 *
 * @param string|array $fields
 * @return self
 */
 public function addAllowedFields($fields): self
 {
 $fields = is_array($fields) ? $fields : [$fields];
 $this->allowedFields = array_merge($this->allowedFields ?? [], $fields);
 return $this;
 }

 /**
 * 添加自定义字段
 *
 * @param string $key
 * @param mixed $value
 * @return self
 */
 public function addCustomField(string $key, $value): self
 {
 $this->customFields[$key] = $value;
 return $this;
 }

 /**
 * 转换为数组
 *
 * @return array
 */
 public function toArray(): array
 {
 return [
 'return_format' => $this->returnFormat,
 'param_format' => $this->paramFormat,
 'query_mode' => $this->queryMode,
 'skip_fields' => $this->skipFields,
 'allowed_fields' => $this->allowedFields,
 'sort_fields' => $this->sortFields,
 'default_sort' => $this->defaultSort,
 'default_page_size' => $this->defaultPageSize,
 'max_page_size' => $this->maxPageSize,
 'default_page' => $this->defaultPage,
 'keyword_fields' => $this->keywordFields,
 'enable_keyword_search' => $this->enableKeywordSearch,
 'keyword_param' => $this->keywordParam,
 'enable_range_query' => $this->enableRangeQuery,
 'enable_like_query' => $this->enableLikeQuery,
 'auto_convert_datetime' => $this->autoConvertDateTime,
 'skip_empty_values' => $this->skipEmptyValues,
 'custom_fields' => $this->customFields,
 'enable_cache' => $this->enableCache,
 'cache_ttl' => $this->cacheTtl,
 'debug_mode' => $this->debugMode,
 'filter_format' => $this->filterFormat,
 'default_operator' => $this->defaultOperator,
 ];
 }
}