/**
 * Global 版适配器：统一模型 <-> Global API 请求/响应互转。
 *
 * 注意：Global 不支持的参数（time_range/sites/block_hosts）由 tool.ts 按
 * 「请求中实际出现」计算 unsupportedParams，不在 parseResponse 中无条件上报。
 *
 * @module
 */

import type { ApiError } from "./errors.ts";
import type {
  DoubaoSearchConfig,
  SearchAdapter,
  UnifiedSearchItem,
  UnifiedSearchRequest,
  UnifiedSearchResult,
} from "./types.ts";

// ============================================================================
// Global 版 API 原始响应类型（就近放置，仅本适配器消费）
// ============================================================================

export interface GlobalApiResponse {
  ResponseMetadata: {
    RequestId: string;
    Action?: string;
    Version?: string;
    Service?: string;
    Region?: string;
    Error?: ApiError;
  };
  Result?: {
    TotalDocCount: number;
    Documents?: GlobalDocument[];
    ErrorCode: number;
    ErrorMsg: string;
  };
}

export interface GlobalDocument {
  Rank: number;
  Url?: string;
  Title?: string;
  Snippet?: GlobalSnippet[];
  DocumentInfo?: {
    ContentCharCount?: number;
    ContentTokenCount?: number;
    Filetype?: string;
    PublishTime?: string;
  };
  HostInfo?: {
    Hostname?: string;
    IconUrl?: string;
  };
}

export interface GlobalSnippet {
  Type?: string;
  Text?: string;
  Image?: {
    Width?: number;
    Height?: number;
    ImageUrl?: string;
  };
}

export const globalAdapter: SearchAdapter = {
  version: "global",
  apiUrl: "https://open.feedcoopapi.com/search_api/global_search",

  buildRequest(req: UnifiedSearchRequest, config: DoubaoSearchConfig): Record<string, unknown> {
    return {
      Query: req.query,
      DocCount: Math.min(req.count, 20),
      MaxSnippetLength: req.detailLevel === "brief" ? 200 : config.maxSnippetLength,
      MaxImageCountPerDoc: req.includeImages ? 3 : 0,
    };
  },

  parseResponse(raw: unknown): UnifiedSearchResult {
    const data = raw as GlobalApiResponse;
    const result = data.Result;

    if (!result) {
      return { totalCount: 0, results: [], version: "global" };
    }

    const items: UnifiedSearchItem[] = (result.Documents ?? []).map((d) => {
      // Global 的 Snippet 是数组，混合 text 和 image，拼接为纯文本
      const textSnippets = (d.Snippet ?? [])
        .filter(s => s.Type === "text")
        .map(s => s.Text ?? "")
        .join("\n");

      return {
        title: d.Title ?? "",
        url: d.Url ?? "",
        snippet: textSnippets.slice(0, 200),
        summary: textSnippets,
        publishTime: d.DocumentInfo?.PublishTime,
        siteName: d.HostInfo?.Hostname,
        filetype: d.DocumentInfo?.Filetype,
      };
    });

    return {
      totalCount: result.TotalDocCount,
      results: items,
      version: "global",
    };
  },
};