import { API_BASE } from "./endpoints" import type { ApiResponse } from "../types/api" export type ApiTransport = "plugin-bridge" | "direct-fetch" export class ApiClientError extends Error { readonly code: string readonly details: Record constructor(code: string, message: string, details: Record = {}) { super(message) this.name = "ApiClientError" this.code = code this.details = details } } export async function getJson(endpoint: string, query?: Record) { return request(endpoint, { method: "GET", query }) } export async function postJson(endpoint: string, body?: unknown) { return request(endpoint, { method: "POST", body }) } export async function putJson(endpoint: string, body?: unknown) { return request(endpoint, { method: "PUT", body }) } export function getApiTransport(): ApiTransport { const bridge = typeof window === "undefined" ? undefined : window.AstrBotPluginPage return bridge && (typeof bridge.apiGet === "function" || typeof bridge.apiPost === "function") ? "plugin-bridge" : "direct-fetch" } export async function request( endpoint: string, options: { method?: "GET" | "POST" | "PUT" | "DELETE" query?: Record body?: unknown } = {}, ): Promise { const bridgePayload = await requestViaPluginBridge(endpoint, options) if (bridgePayload !== undefined) { return unwrapApiResponse(bridgePayload) } const url = buildUrl(endpoint, options.query) let response: Response try { response = await fetch(url, { method: options.method ?? "GET", headers: options.body === undefined ? undefined : { "Content-Type": "application/json" }, body: options.body === undefined ? undefined : JSON.stringify(options.body), }) } catch (err) { throw new ApiClientError("network_unreachable", "无法连接 ImageStudio 后端接口", { endpoint, transport: "direct-fetch", url, reason: err instanceof Error ? err.message : String(err), }) } const payload = await parseResponsePayload(response, endpoint, url) if (!response.ok && !isApiResponse(payload)) { throw new ApiClientError("http_error", `接口请求失败(HTTP ${response.status})`, { endpoint, transport: "direct-fetch", url, status: response.status, status_text: response.statusText, }) } return unwrapApiResponse(payload) } async function requestViaPluginBridge( endpoint: string, options: { method?: "GET" | "POST" | "PUT" | "DELETE" query?: Record body?: unknown }, ): Promise | undefined> { const bridge = window.AstrBotPluginPage if (!bridge) { return undefined } const method = options.method ?? "GET" if (typeof bridge.ready === "function") { await bridge.ready() } if (method === "GET" && typeof bridge.apiGet === "function") { return bridge.apiGet>(endpoint, compactQuery(options.query)) } if (method === "POST" && typeof bridge.apiPost === "function") { return bridge.apiPost>(endpoint, options.body) } if (method === "PUT" && typeof bridge.apiPut === "function") { return bridge.apiPut>(endpoint, options.body) } if (method === "DELETE" && typeof bridge.apiDelete === "function") { return bridge.apiDelete>(endpoint) } return undefined } function unwrapApiResponse(payload: T | ApiResponse): T { if (!isApiResponse(payload)) { return payload } if (!payload.ok) { throw new ApiClientError(payload.error_code, payload.message, payload.details) } return payload.data } async function parseResponsePayload(response: Response, endpoint: string, url: string): Promise> { const contentType = response.headers.get("content-type") ?? "" const isJson = contentType.includes("application/json") || contentType.includes("+json") if (!isJson) { const preview = (await response.text()).slice(0, 240) throw new ApiClientError("invalid_api_response", "接口返回了非 JSON 响应", { endpoint, transport: "direct-fetch", url, status: response.status, status_text: response.statusText, content_type: contentType, preview, }) } try { return (await response.json()) as T | ApiResponse } catch (err) { throw new ApiClientError("invalid_api_response", "接口返回格式不正确", { endpoint, transport: "direct-fetch", url, status: response.status, status_text: response.statusText, content_type: contentType, reason: err instanceof Error ? err.message : String(err), }) } } function isApiResponse(payload: T | ApiResponse): payload is ApiResponse { return Boolean(payload && typeof payload === "object" && "ok" in payload) } function compactQuery(query?: Record): Record | undefined { if (!query) { return undefined } const compacted: Record = {} for (const [key, value] of Object.entries(query)) { if (value !== undefined) { compacted[key] = value } } return compacted } export function buildUrl(endpoint: string, query?: Record) { const trimmed = endpoint.replace(/^\/+/, "") const url = new URL(`${API_BASE}/${trimmed}`, window.location.origin) for (const [key, value] of Object.entries(query ?? {})) { if (value !== undefined) { url.searchParams.set(key, String(value)) } } return `${url.pathname}${url.search}` }