astrbot_plugin_imagestudio/frontend/shared/api/client.ts

108 行
3.4 KiB
TypeScript

2026-07-05 09:24:00 +08:00
import { API_BASE } from "./endpoints"
import type { ApiResponse } from "../types/api"
export class ApiClientError extends Error {
readonly code: string
readonly details: Record<string, unknown>
constructor(code: string, message: string, details: Record<string, unknown> = {}) {
super(message)
this.name = "ApiClientError"
this.code = code
this.details = details
}
}
export async function getJson<T>(endpoint: string, query?: Record<string, string | number | boolean | undefined>) {
return request<T>(endpoint, { method: "GET", query })
}
export async function postJson<T>(endpoint: string, body?: unknown) {
return request<T>(endpoint, { method: "POST", body })
}
export async function request<T>(
endpoint: string,
options: {
method?: "GET" | "POST" | "PUT" | "DELETE"
query?: Record<string, string | number | boolean | undefined>
body?: unknown
} = {},
): Promise<T> {
2026-07-06 09:45:13 +08:00
const bridgePayload = await requestViaPluginBridge<T>(endpoint, options)
if (bridgePayload !== undefined) {
return unwrapApiResponse(bridgePayload)
}
2026-07-05 09:24:00 +08:00
const response = await fetch(buildUrl(endpoint, options.query), {
method: options.method ?? "GET",
headers: options.body === undefined ? undefined : { "Content-Type": "application/json" },
body: options.body === undefined ? undefined : JSON.stringify(options.body),
})
const payload = (await response.json()) as ApiResponse<T>
2026-07-06 09:45:13 +08:00
return unwrapApiResponse(payload)
}
async function requestViaPluginBridge<T>(
endpoint: string,
options: {
method?: "GET" | "POST" | "PUT" | "DELETE"
query?: Record<string, string | number | boolean | undefined>
body?: unknown
},
): Promise<T | ApiResponse<T> | 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<T | ApiResponse<T>>(endpoint, compactQuery(options.query))
}
if (method === "POST" && typeof bridge.apiPost === "function") {
return bridge.apiPost<T | ApiResponse<T>>(endpoint, options.body)
}
return undefined
}
function unwrapApiResponse<T>(payload: T | ApiResponse<T>): T {
if (!isApiResponse<T>(payload)) {
return payload
}
2026-07-05 09:24:00 +08:00
if (!payload.ok) {
throw new ApiClientError(payload.error_code, payload.message, payload.details)
}
return payload.data
}
2026-07-06 09:45:13 +08:00
function isApiResponse<T>(payload: T | ApiResponse<T>): payload is ApiResponse<T> {
return Boolean(payload && typeof payload === "object" && "ok" in payload)
}
function compactQuery(query?: Record<string, string | number | boolean | undefined>): Record<string, unknown> | undefined {
if (!query) {
return undefined
}
const compacted: Record<string, unknown> = {}
for (const [key, value] of Object.entries(query)) {
if (value !== undefined) {
compacted[key] = value
}
}
return compacted
}
2026-07-05 09:24:00 +08:00
export function buildUrl(endpoint: string, query?: Record<string, string | number | boolean | undefined>) {
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}`
}