simapi-vue/src/simapi.core.ts

/**
 * SimApi Core — 纯 TypeScript 核心，无框架依赖
 *
 * 支持所有 JS/TS 环境（Node.js、浏览器、小程序等）。
 *
 * @example
 * import { SimApiCore } from '@simcu/simapi'
 * const api = new SimApiCore()
 * api.setEndpoints({ default: 'https://api.example.com' })
 * const res = await api.query('/users/list', { page: 1 })
 */

import {
    type SimApiVersions,
    type SimApiAuthConfig,
    type SimApiApiConfig,
    type SimApiOptions,
    type SimApiBaseResponse,
} from './types'

export type {
    SimApiVersions,
    SimApiAuthConfig,
    SimApiApiConfig,
    SimApiOptions,
    SimApiBaseResponse,
} from './types'

declare const SimApiVersion: string;
declare const AppVersion: string;

// ── Helper: Fetch with Timeout ────────────────────────────────────────

function fetchWithTimeout(
    url: string,
    options: RequestInit,
    timeout: number = 10000
): Promise<Response> {
    return Promise.race([
        fetch(url, options),
        new Promise<never>((_, reject) =>
            setTimeout(() => reject(new Error(`Request timeout after ${timeout}ms`)), timeout)
        ),
    ])
}

// ── Helper: Fetch POST with JSON body ────────────────────────────────────

async function fetchPost<T = any>(
    url: string,
    body: any,
    headers: Record<string, string>,
    timeout: number
): Promise<SimApiBaseResponse<T>> {
    const options: RequestInit = {
        method: 'POST',
        headers: headers as HeadersInit,
        body: body instanceof FormData ? body : JSON.stringify(body),
        credentials: 'omit',  // 从不发送 Cookie
    }

    const response = await fetchWithTimeout(url, options, timeout)

    if (!response.ok) {
        const errorData = await response.json().catch(() => ({}))
        throw {
            status: response.status,
            statusText: response.statusText,
            data: errorData,
            message: `HTTP ${response.status}: ${response.statusText}`,
        }
    }

    return response.json()
}

// ── SimApiCore ────────────────────────────────────────

export class SimApiCore {
    private debug: boolean = true
    private auth: SimApiAuthConfig = {
        token_name: 'simapi-auth-token',
        check_url: '/user/info',
        logout_url: '/auth/logout',
        login_url: '/auth/login',
    }
    private webConfig: Map<string, Record<string, object>> = new Map();

    private api: SimApiApiConfig = {
        endpoints: {default: ''},
        defaultEndpoint: 'default',
        businessCallback: {
            401: () => this.removeToken(),
            common: () => {
            },
        },
        responseCallback: {
            success: (response: any) => response,
            error: (_err: any) => {
            },
        },
        timeout: 10000,
    }

    constructor(options?: SimApiOptions) {
        if (options) {
            this.configure(options)
        }
    }

    /**
     * 从 JSON 文件加载配置
     *
     * 部署时替换 config.json 即可切换环境，无需重新构建。
     *
     * @param file - 配置文件路径，默认 'config.json'
     * @example
     * await api.loadFromFile()
     * await api.loadFromFile('/env/prod.json')
     */
    async loadFromFile(file: string = 'config.json'): Promise<void> {
        try {
            const resp = await fetch(file)
            if (!resp.ok) {
                this.logDebug(`配置文件 ${file} 加载失败: HTTP ${resp.status}`)
                return
            }
            const config = await resp.json()
            if (config.debug !== undefined) {
                this.debug = config.debug
            }
            if (config.endpoints) {
                this.api.endpoints = {...this.api.endpoints, ...config.endpoints}
            }
            if (config.defaultEndpoint) {
                this.api.defaultEndpoint = config.defaultEndpoint
            }
        } catch (err: any) {
            this.logDebug(`配置文件 ${file} 加载失败: ${err.message}`)
        }
    }

    configure(options: SimApiOptions): void {
        if (options.debug !== undefined) {
            this.debug = options.debug
        }
        if (options.auth) {
            this.auth = {...this.auth, ...options.auth}
        }
        if (options.api) {
            this.api = {
                ...this.api,
                ...options.api,
                endpoints: {...this.api.endpoints, ...(options.api.endpoints ?? {})},
                businessCallback: {...this.api.businessCallback, ...(options.api.businessCallback ?? {})},
                responseCallback: {...this.api.responseCallback, ...(options.api.responseCallback ?? {})},
            }
        }
    }

    get isDebug() {
        return this.debug
    }

    setDebug(debug: boolean) {
        this.debug = debug;
    }

    setEndpoints(endpoints: { [name: string]: string }): void {
        this.api.endpoints = {...this.api.endpoints, ...endpoints}
    }

    getEndpoint(name?: string): string {
        return this.api.endpoints[name ?? this.api.defaultEndpoint] ?? ''
    }

    setBusinessCallback(code: number | string, callback: (data: any) => void): void {
        this.api.businessCallback[code] = callback
    }

    getToken(): string {
        const name = this.auth.token_name
        const match = document.cookie.match(new RegExp(`(?:^|;)\\s?${name}=([^;]+)`))
        return match ? match[1] : ''
    }

    setToken(token: string): void {
        const name = this.auth.token_name
        document.cookie = `${name}=${token}; path=/; max-age=315360000; secure; samesite=none`
    }

    removeToken(): void {
        const name = this.auth.token_name
        document.cookie = `${name}=; path=/; max-age=0; secure; samesite=none`
    }


    genS4(): string {
        return (((1 + Math.random()) * 0x10000 * Date.parse(new Date().toString())) | 0)
            .toString(16)
            .substring(1)
    }

    /**
     * 日志工具（仅在 debug 模式下输出）
     *
     * @example
     * api.logDebug('用户登录', { id: 1, name: 'test' })
     * api.logDebug('请求开始', uri, params)
     */
    logDebug(...args: any[]): void {
        if (!this.debug) return
        console.log('[DEBUG]', ...args)
    }

    async getConfig(reload: boolean = false, endpointName: string = 'default'): Promise<Record<string, object>> {
        if (!this.webConfig.has(endpointName) || reload) {
            const versions: SimApiVersions = {
                uiApp: typeof AppVersion === 'undefined' ? "0.0.0-develop" : AppVersion,
                uiSimApi: typeof SimApiVersion === 'undefined' ? "0.0.0-develop" : SimApiVersion,
                apiApp: '0.0.0',
                apiSimApi: '0.0.0',
                apiAppFull: '0.0.0',
                apiSimApiFull: '0.0.0',
            };
            const resp = await this.query<any>('/config', {}, endpointName)
            if (resp?.data) {
                const d = resp.data.versions;
                versions.apiApp = d.App?.split('+')[0] ?? '0.0.0';
                versions.apiSimApi = d.SimApi?.split('+')[0] ?? '0.0.0';
                versions.apiAppFull = d.App ?? '0.0.0';
                versions.apiSimApiFull = d.SimApi ?? '0.0.0';
                if (this.debug) {
                    console.log(`UI主应用版本: ${versions.uiApp}\nUISimApi版本: ${versions.uiSimApi}\nAPI主应用版本: ${versions.apiApp}\nAPISimApi版本: ${versions.apiSimApi}`)
                }
                resp.data.versions = versions;
                this.webConfig.set(endpointName, resp.data);

            }
        }
        return this.webConfig.get(endpointName)!;
    }

    async query<T = any>(
        uri: string,
        params: any = {},
        endpointKey?: string,
        extraHeaders?: Record<string, string>,
        selfHandleError: boolean = false
    ): Promise<SimApiBaseResponse<T>> {
        const headers: Record<string, string> = {...extraHeaders, ...{}}
        const queryId = this.genS4()

        if (!(params instanceof FormData)) {
            headers['Content-Type'] = 'application/json'
        }

        const token = this.getToken()
        if (token) {
            headers['Token'] = token
        }

        if (this.debug) {
            headers['Query-Id'] = queryId
            console.log('[REQUEST*]', queryId, '->', uri, 'AUTH:', this.getToken())
        }

        const url = this.getEndpoint(endpointKey) + uri

        try {
            const respData = await fetchPost<T>(
                url,
                params,
                headers,
                this.api.timeout ?? 10000
            )
            if (this.debug) {
                console.log('[RESPONSE]', queryId, '->', respData)
            }
            const processedData = this.api.responseCallback.success(respData) as SimApiBaseResponse<T>

            // 业务回调处理
            if (!selfHandleError) {
                if (this.api.businessCallback.hasOwnProperty(processedData.code)) {
                    this.api.businessCallback[processedData.code](processedData)
                } else if (this.api.businessCallback['common'] && processedData.code !== 200) {
                    this.api.businessCallback['common'](processedData)
                }
            }

            // code != 200 时抛出业务错误
            if (processedData.code !== 200) {
                throw processedData
            }
            return processedData

        } catch (error: any) {
            if (this.debug) {
                console.log('[RESPONSE]', queryId, '->', error)
            }
            // 网络/HTTP 错误：包装成标准响应格式抛出
            if (!error?.code) {
                this.api.responseCallback.error(error)
                throw {
                    code: -1,
                    message: error?.message || '网络错误',
                    data: error,
                } as SimApiBaseResponse<T>
            }
            // 业务错误直接抛出
            throw error
        }
    }

    async login(request: Record<string, any>): Promise<SimApiBaseResponse<string>> {
        const result = await this.query<string>(this.auth.login_url, request)
        if (result?.data) {
            this.setToken(result.data)
        }
        return result
    }

    async logout(url?: string | null): Promise<any> {
        if (url !== null) {
            this.query(url ?? this.auth.logout_url).catch(() => true)
        }
        this.removeToken()
        return true
    }

    async checkLogin(url?: string | null): Promise<any> {
        return this.query(url ?? this.auth.check_url);
    }
}