import { AsyncIOResult, AsyncResult, IOResult } from 'happy-rusty';

/**
 * 将小游戏异步 API 转换为返回 `AsyncResult<T, E>` 的新函数，需要转换的 API 必须是接受可选 `success` 和 `fail` 回调的函数，并且其返回值必须是 `void` 或 `PromiseLike`。
 *
 * 其中 `T` 为 `success` 回调的参数类型，`E` 为 `fail` 回调的参数类型。
 *
 * @param api - 小游戏异步 API。
 * @returns 返回一个新的函数，该函数返回 `AsyncResult<T, E>`。
 * @since 2.0.0
 * @example
 * ```ts
 * // 将 wx.setStorage 转换为 AsyncResult 风格
 * const setStorageAsync = asyncResultify(wx.setStorage);
 * const result = await setStorageAsync({ key: 'test', data: 'value' });
 * if (result.isOk()) {
 *     console.log('存储成功');
 * } else {
 *     console.error('存储失败:', result.unwrapErr());
 * }
 * ```
 */
declare function asyncResultify<F extends (...args: any[]) => unknown, T = ResultifySuccessType<F>, E = ResultifyFailType<F>>(api: F): ResultifyValidAPI<F> extends true ? (...args: Parameters<F>) => AsyncResult<T, E> : never;
/**
 * `asyncResultify` 的变体，将小游戏异步 API 转换为返回 `AsyncIOResult<T>` 的新函数。
 *
 * 与 `asyncResultify` 不同的是，此函数会将 `fail` 回调的 `WechatMinigame.GeneralCallbackResult` 转换为 `Error` 类型。
 *
 * @param api - 小游戏异步 API。
 * @returns 返回一个新的函数，该函数返回 `AsyncIOResult<T>`。
 * @since 2.0.0
 * @example
 * ```ts
 * // 将 wx.setStorage 转换为 AsyncIOResult 风格
 * const setStorageAsync = asyncIOResultify(wx.setStorage);
 * const result = await setStorageAsync({ key: 'test', data: 'value' });
 * if (result.isOk()) {
 *     console.log('存储成功');
 * } else {
 *     console.error('存储失败:', result.unwrapErr().message);
 * }
 * ```
 */
declare function asyncIOResultify<F extends (...args: any[]) => unknown, T = ResultifySuccessType<F>>(api: F): IOResultifyValidAPI<F> extends true ? (...args: Parameters<F>) => AsyncIOResult<T> : never;
/**
 * 将小游戏同步 API 转换为返回 `IOResult<T>` 的新函数。
 *
 * 功能类似于 `tryGeneralSyncOp`，但以函数包装的方式使用，将可能抛出的异常捕获并转换为 `IOResult`。
 *
 * @param api - 小游戏同步 API。
 * @returns 返回一个新的函数，该函数返回 `IOResult<T>`。
 * @since 2.0.0
 * @example
 * ```ts
 * // 将 wx.getStorageSync 转换为 IOResult 风格
 * const getStorageSync = syncIOResultify(wx.getStorageSync);
 * const result = getStorageSync('test');
 * if (result.isOk()) {
 *     console.log('获取成功:', result.unwrap());
 * } else {
 *     console.error('获取失败:', result.unwrapErr().message);
 * }
 * ```
 */
declare function syncIOResultify<F extends (...args: any[]) => unknown>(api: F): (...args: Parameters<F>) => IOResult<ReturnType<F>>;
/**
 * 通用回调函数类型。
 */
type AnyCallback = (...args: never[]) => unknown;
/**
 * 类型工具：判断 API 是否符合 resultify 条件。
 *
 * 要求 API 返回 `void` 或 `PromiseLike`，且参数包含 `success` 或 `fail` 回调。
 * @typeParam T - 待检查的 API 函数类型。
 */
type ResultifyValidAPI<T> = T extends (params: infer P) => infer R ? R extends void | PromiseLike<unknown> ? P extends {
    success?: AnyCallback;
} | undefined ? true : P extends {
    fail?: AnyCallback;
} | undefined ? true : false : false : false;
/**
 * 类型工具：判断 API 是否符合 asyncIOResultify 条件。
 *
 * 在 `ResultifyValidAPI` 基础上，额外要求 `fail` 回调参数类型必须精确为 `GeneralCallbackResult`。
 * @typeParam T - 待检查的 API 函数类型。
 */
type IOResultifyValidAPI<T> = ResultifyValidAPI<T> extends true ? ResultifyFailType<T> extends WechatMinigame.GeneralCallbackResult ? WechatMinigame.GeneralCallbackResult extends ResultifyFailType<T> ? true : false : false : false;
/**
 * 类型工具：提取成功回调参数类型。
 *
 * 从 API 函数的 `success` 回调中提取返回类型。
 * @typeParam T - API 函数类型。
 */
type ResultifySuccessType<T> = T extends (params: infer P) => unknown ? P extends {
    success?: (res: infer S) => unknown;
} ? S : never : never;
/**
 * 类型工具：提取失败回调参数类型。
 *
 * 从 API 函数的 `fail` 回调中提取错误类型。
 * @typeParam T - API 函数类型。
 */
type ResultifyFailType<T> = T extends (params: infer P) => unknown ? P extends {
    fail?: (err: infer E) => unknown;
} ? E : never : never;

export { asyncIOResultify, asyncResultify, syncIOResultify };