@cloudcome/utils-uni 1.33.0 → 1.34.0

package/dist/client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.cjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type { AnyArray, AnyFunction } from '@cloudcome/utils-core/types';\nimport {\n  type UseRequestOptions,\n  type UseRequestOutput,\n  type UseRequestOutputFilled,\n  useRequest,\n} from '@cloudcome/utils-vue/request';\nimport type { CloudMethodOutput, UniError } from '@/cloud';\nimport type { ClientDatabaseOutput } from '@/database';\nimport { parseCloudMethodOutput } from './_helpers';\n\ntype _ImportObject = UniCloudNamespace.UniCloud['importObject'];\ntype _ImportObjectArgs = Parameters<_ImportObject>;\ntype _ImportObjectOptions = _ImportObjectArgs[1];\n\nexport type CreateUseCloudObjectOptions = _ImportObjectOptions & {\n  /**\n   * 模拟云对象，用于单元测试\n   * @private\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockServer?: any;\n\n  /**\n   * 回退错误信息\n   * @default '请求失败'\n   */\n  fallbackErrorMessage?: string;\n\n  /**\n   * 请求开始前的回调函数\n   */\n  onBefore?: () => unknown;\n\n  /**\n   * 请求成功后的回调函数\n   */\n  onSuccess?: () => unknown;\n\n  /**\n   * 请求失败时的回调函数\n   * @param err 错误信息\n   */\n  onError?: (err: UniError) => unknown;\n\n  /**\n   * 请求完成后的回调函数（无论成功或失败都会执行）\n   */\n  onAfter?: () => unknown;\n\n  /**\n   * 显示加载状态的回调函数，当配置了 showLoading 为 true 时会调用\n   */\n  onShowLoading?: () => unknown;\n\n  /**\n   * 隐藏加载状态的回调函数，当配置了 showLoading 为 true 时会调用\n   */\n  onHideLoading?: () => unknown;\n\n  /**\n   * 显示错误信息的回调函数，当配置了 showError 为 true 时会调用\n   * @param err 错误信息\n   */\n  onShowError?: (err: UniError) => unknown;\n};\n\n/**\n * 云对象请求函数类型定义\n * @template F 云对象方法函数类型\n * @param input 云对象方法的参数数组\n * @returns 返回云对象方法执行结果的Promise\n */\nexport type CloudObjectRequest = <F extends AnyFunction>(\n  ...input: Parameters<F>\n) => Promise<CloudMethodOutput<ReturnType<F>>>;\n\n/**\n * 用于调用云对象方法的配置选项类型定义\n * @template I 输入参数类型数组\n * @template O 输出结果类型\n */\nexport type UseCloudMethodOptions<I extends AnyArray, O> = Omit<\n  UseRequestOptions<I, O>,\n  'onError'\n> & {\n  /**\n   * 请求发生错误时的回调函数\n   * @param err 错误信息\n   * @param inputs 请求输入参数\n   */\n  onError?: (err: UniError, ...inputs: I) => unknown;\n\n  /**\n   * 是否显示加载状态\n   * @default false\n   */\n  showLoading?: boolean;\n\n  /**\n   * 是否显示错误信息\n   * @default false\n   */\n  showError?: boolean;\n};\n\n/**\n * 用于调用云对象方法的hook函数类型定义\n * @template I 输入参数类型数组\n * @template O 输出结果类型\n */\nexport type UseCloudMethod<Api extends Record<string, AnyFunction>> = {\n  /**\n   * 重载签名：当提供 placeholder 选项时，返回包含初始值的输出类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象方法的函数\n   * @param options 包含 placeholder 的请求配置选项\n   * @returns 返回包含初始值的请求输出\n   */\n  <K extends keyof Api, I extends AnyArray, O>(\n    method: K,\n    caller: (request: Api[K], ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options: Omit<UseCloudMethodOptions<I, O>, 'placeholder'> & {\n      placeholder: () => O;\n    },\n  ): UseRequestOutputFilled<I, O>;\n\n  /**\n   * 重载签名：当不提供 placeholder 选项时，返回普通输出类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象方法的函数\n   * @param options 可选的请求配置选项\n   * @returns 返回普通的请求输出\n   */\n  <K extends keyof Api, I extends AnyArray, O>(\n    method: K,\n    caller: (request: Api[K], ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options?: UseCloudMethodOptions<I, O>,\n  ): UseRequestOutput<I, O>;\n};\n\n/**\n * 导入云对象并创建一个用于调用云对象的hook\n * @param objectName 云对象名称\n * @param importOptions 配置选项，包含模拟服务器、回退错误信息等\n * @returns 返回一个可用于调用云对象方法的hook函数\n */\nexport function importCloudObject<Api extends Record<string, AnyFunction>>(\n  objectName: _ImportObjectArgs[0],\n  importOptions?: CreateUseCloudObjectOptions,\n) {\n  const fallbackErrorMessage =\n    importOptions?.fallbackErrorMessage || '请求失败';\n  const server =\n    importOptions?._mockServer ||\n    uniCloud.importObject(objectName, importOptions);\n  const onShowLoading =\n    importOptions?.onShowLoading ||\n    (() => uni.showLoading({ title: '', mask: true }));\n  const onHideLoading =\n    importOptions?.onHideLoading || (() => uni.hideLoading());\n  const onShowError =\n    importOptions?.onShowError ||\n    ((err) =>\n      uni.showToast({\n        title: err.message,\n        icon: 'none',\n        duration: 3000,\n        mask: false,\n      }));\n\n  /**\n   * 用于调用云对象方法的hook函数\n   * @template I 输入参数类型\n   * @template O 输出结果类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象的函数\n   * @param options 配置选项，包含请求相关的配置\n   * @returns 返回一个请求hook，用于处理云对象调用\n   */\n  const useCloudMethod: UseCloudMethod<Api> = (method, caller, options) => {\n    // 使用请求hook处理云对象调用\n    return useRequest(\n      async (...inputs) => {\n        const request = server[method];\n        const output = await caller(request, ...inputs);\n        return parseCloudMethodOutput(output, fallbackErrorMessage);\n      },\n      {\n        ...options,\n        async onBefore(...inputs) {\n          if (options?.showLoading) onShowLoading();\n\n          await importOptions?.onBefore?.();\n          await options?.onBefore?.(...inputs);\n        },\n        async onSuccess(data, ...inputs) {\n          await importOptions?.onSuccess?.();\n          await options?.onSuccess?.(data, ...inputs);\n        },\n        async onError(err, ...inputs) {\n          await importOptions?.onError?.(err as UniError);\n          await options?.onError?.(err as UniError, ...inputs);\n\n          if (options?.showError) {\n            // 加延迟是尽量保证在 loading 隐藏后再显示错误信息\n            setTimeout(() => {\n              onShowError(err as UniError);\n            });\n          }\n        },\n        async onAfter(...inputs) {\n          if (options?.showLoading) onHideLoading();\n\n          await importOptions?.onAfter?.();\n          await options?.onAfter?.(...inputs);\n        },\n      },\n    );\n  };\n\n  return useCloudMethod;\n}\n\nexport type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<\n  I,\n  O\n> & {\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDatabase?: any;\n};\n\n/**\n * 创建一个用于调用云数据库的hook\n * @param caller 调用云数据库的函数，接收数据库实例和输入参数，返回Promise\n * @param options 配置选项\n * @returns 返回一个请求hook，用于处理云数据库调用\n */\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (\n    db: UniCloud.Database,\n    ...inputs: I\n  ) => Promise<ClientDatabaseOutput<O>>,\n  options: Omit<UseDatabaseOptions<I, O>, 'placeholder'> & {\n    placeholder: () => O;\n  },\n): UseRequestOutputFilled<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (\n    db: UniCloud.Database,\n    ...inputs: I\n  ) => Promise<ClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (\n    db: UniCloud.Database,\n    ...inputs: I\n  ) => Promise<ClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O> {\n  // 获取数据库实例，优先使用模拟数据库（用于测试），否则使用uniCloud数据库\n  const db = options?._mockDatabase || uniCloud.database();\n  return useRequest(async (...inputs: I) => {\n    const { result } = await caller(db, ...inputs);\n    if (!result.errCode) return result;\n    throw new Error(result.errMsg || '请求失败');\n  }, options);\n}\n\nexport { parseCloudMethodOutput } from './_helpers';\nexport type { UniError } from './_types';\n"],"mappings":";;;;;;;;;;AAmJA,SAAgB,kBACd,YACA,eACA;CACA,MAAM,uBACJ,eAAe,wBAAwB;CACzC,MAAM,SACJ,eAAe,eACf,SAAS,aAAa,YAAY,cAAc;CAClD,MAAM,gBACJ,eAAe,wBACR,IAAI,YAAY;EAAE,OAAO;EAAI,MAAM;EAAM,CAAC;CACnD,MAAM,gBACJ,eAAe,wBAAwB,IAAI,aAAa;CAC1D,MAAM,cACJ,eAAe,iBACb,QACA,IAAI,UAAU;EACZ,OAAO,IAAI;EACX,MAAM;EACN,UAAU;EACV,MAAM;EACP,CAAC;;;;;;;;;;CAWN,MAAM,kBAAuC,QAAQ,QAAQ,YAAY;EAEvE,QAAA,GAAA,6BAAA,YACE,OAAO,GAAG,WAAW;GACnB,MAAM,UAAU,OAAO;GAEvB,OAAO,iBAAA,uBAAuB,MADT,OAAO,SAAS,GAAG,OAAO,EACT,qBAAqB;KAE7D;GACE,GAAG;GACH,MAAM,SAAS,GAAG,QAAQ;IACxB,IAAI,SAAS,aAAa,eAAe;IAEzC,MAAM,eAAe,YAAY;IACjC,MAAM,SAAS,WAAW,GAAG,OAAO;;GAEtC,MAAM,UAAU,MAAM,GAAG,QAAQ;IAC/B,MAAM,eAAe,aAAa;IAClC,MAAM,SAAS,YAAY,MAAM,GAAG,OAAO;;GAE7C,MAAM,QAAQ,KAAK,GAAG,QAAQ;IAC5B,MAAM,eAAe,UAAU,IAAgB;IAC/C,MAAM,SAAS,UAAU,KAAiB,GAAG,OAAO;IAEpD,IAAI,SAAS,WAEX,iBAAiB;KACf,YAAY,IAAgB;MAC5B;;GAGN,MAAM,QAAQ,GAAG,QAAQ;IACvB,IAAI,SAAS,aAAa,eAAe;IAEzC,MAAM,eAAe,WAAW;IAChC,MAAM,SAAS,UAAU,GAAG,OAAO;;GAEtC,CACF;;CAGH,OAAO;;AAoCT,SAAgB,YACd,QAIA,SACwB;CAExB,MAAM,KAAK,SAAS,iBAAiB,SAAS,UAAU;CACxD,QAAA,GAAA,6BAAA,YAAkB,OAAO,GAAG,WAAc;EACxC,MAAM,EAAE,WAAW,MAAM,OAAO,IAAI,GAAG,OAAO;EAC9C,IAAI,CAAC,OAAO,SAAS,OAAO;EAC5B,MAAM,IAAI,MAAM,OAAO,UAAU,OAAO;IACvC,QAAQ"}
+{"version":3,"file":"client.cjs","names":[],"sources":["../src/client/message.ts","../src/client/app.ts","../src/client/async.ts","../src/client/page.ts","../src/client/request.ts","../src/client/ui.ts"],"sourcesContent":["import { promiseDelay } from '@cloudcome/utils-core/promise';\nimport { isString } from '@cloudcome/utils-core/type';\n\n/**\n * 显示 confirm 提示\n * @param text 提示文本\n * @param options 其他选项\n * @returns 提示完成后的 Promise\n */\nexport function uniConfirm(\n  text: string,\n  options?: Omit<\n    UniNamespace.ShowModalOptions,\n    'showCancel' | 'success' | 'content' | 'editable'\n  >,\n) {\n  const cancelText = options?.cancelText || '取消';\n  const confirmText = options?.confirmText || '确认';\n\n  if (cancelText.length > 4)\n    console.warn('微信小程序内不支持 cancelText 长度超过 4 个字符');\n  if (confirmText.length > 4)\n    console.warn('微信小程序内不支持 confirmText 长度超过 4 个字符');\n\n  return new Promise<boolean>((resolve) => {\n    // 避免和 hideLoading 同时出现影响弹窗\n    setTimeout(() => {\n      uni.showModal({\n        title: '请确认',\n        content: text,\n        showCancel: true,\n        confirmText,\n        cancelText,\n        ...options,\n        success(result) {\n          resolve(result.confirm);\n        },\n      });\n    });\n  });\n}\n\n/**\n * 显示 prompt 提示\n * @param text 提示文本\n * @param options 其他选项\n * @returns 提示完成后的 Promise\n */\nexport function uniPrompt(\n  text: string,\n  options?: Omit<\n    UniNamespace.ShowModalOptions,\n    'showCancel' | 'success' | 'content' | 'editable'\n  >,\n) {\n  const cancelText = options?.cancelText || '取消';\n  const confirmText = options?.confirmText || '确认';\n\n  if (cancelText.length > 4)\n    console.warn('微信小程序内不支持 cancelText 长度超过 4 个字符');\n  if (confirmText.length > 4)\n    console.warn('微信小程序内不支持 confirmText 长度超过 4 个字符');\n\n  return new Promise<string>((resolve) => {\n    // 避免和 hideLoading 同时出现影响弹窗\n    setTimeout(() => {\n      uni.showModal({\n        title: '请输入',\n        content: '',\n        placeholderText: text,\n        showCancel: true,\n        confirmText,\n        cancelText,\n        editable: true,\n        ...options,\n        success(result) {\n          resolve(result.content || '');\n        },\n      });\n    });\n  });\n}\n\n/**\n * 显示 alert 提示\n * @param text 提示文本\n * @param options 其他选项\n * @returns 提示完成后的 Promise\n */\nexport function uniAlert(\n  text: string,\n  options?: Omit<\n    UniNamespace.ShowModalOptions,\n    'cancelText' | 'showCancel' | 'success' | 'content'\n  >,\n) {\n  const confirmText = options?.confirmText || '好';\n\n  if (confirmText.length > 4)\n    console.warn('微信小程序内不支持 confirmText 长度超过 4 个字符');\n\n  return new Promise<void>((resolve) => {\n    // 避免和 hideLoading 同时出现影响弹窗\n    setTimeout(() => {\n      uni.showModal({\n        title: '提示',\n        confirmText,\n        cancelText: '',\n        ...options,\n        content: text,\n        showCancel: false,\n        success() {\n          resolve();\n        },\n      });\n    });\n  });\n}\n\n/**\n * 显示 toast 提示\n * @param text 提示文本\n * @param icon 图标\n * @param options 其他选项\n * @returns 提示完成后的 Promise\n */\nexport function uniToast(\n  text: string,\n  icon?: UniNamespace.ShowToastOptions['icon'],\n): Promise<void>;\nexport function uniToast(\n  text: string,\n  options?: UniNamespace.ShowToastOptions,\n): Promise<void>;\nexport function uniToast(\n  text: string,\n  iconOrOptions?:\n    | UniNamespace.ShowToastOptions['icon']\n    | UniNamespace.ShowToastOptions,\n): Promise<void> {\n  const options = {} as UniNamespace.ShowToastOptions;\n\n  if (isString(iconOrOptions)) {\n    options.icon = iconOrOptions;\n  } else {\n    Object.assign(options, iconOrOptions);\n  }\n\n  return new Promise<void>((resolve) => {\n    // 避免和 hideLoading 同时出现影响弹窗\n    setTimeout(async () => {\n      uni.showToast({\n        title: text,\n        duration: 2900,\n        icon: options.icon || 'none',\n      });\n      promiseDelay(3000).then(resolve);\n    });\n  });\n}\n\n/**\n * 显示 loading 提示\n * @param title 提示文本\n */\nexport function uniLoading(title?: string) {\n  uni.showLoading({\n    title,\n    mask: true,\n  });\n}\n","import type { HookListenerWithDispose } from '@cloudcome/utils-vue/component';\nimport { _runLifeHook } from '@cloudcome/utils-vue/shared';\nimport { onHide, onShow } from '@dcloudio/uni-app';\nimport { ref } from 'vue';\nimport { uniConfirm } from './message';\n\n/**\n * 应用显示状态生命周期钩子函数\n *\n * 该函数用于监听应用从后台进入前台的生命周期事件。\n * 当应用从后台切换到前台时触发 onShow 回调，\n * 当应用从前台切换到后台时触发 onHide 回调。\n *\n * @param appShow - 应用显示状态变化时的回调函数，可以返回一个清理函数\n *\n * @example\n * // 基本用法\n * useAppShow(() => {\n *   console.log('应用进入前台');\n *\n *   // 可选：返回一个清理函数，在应用进入后台时执行\n *   return () => {\n *     console.log('应用进入后台');\n *   };\n * });\n *\n * @example\n * // 带有异步操作的用法\n * useAppShow(async () => {\n *   // 应用进入前台时刷新数据\n *   await refreshUserData();\n *\n *   // 返回清理函数\n *   return () => {\n *     // 应用进入后台时保存数据\n *     saveUserData();\n *   };\n * });\n */\nexport function useAppShow(appShow: HookListenerWithDispose) {\n  _runLifeHook(onShow, onHide, appShow);\n}\n\n/**\n * 订阅模板消息\n * @param templateId 模板消息 ID 或 ID 列表\n * @returns Promise<boolean>\n */\nexport async function uniSubscribeNotice(templateId: string | string[]) {\n  if (!uni.requestSubscribeMessage) return false;\n\n  return new Promise<boolean>((resolve) => {\n    const tmplIds = Array.isArray(templateId) ? templateId : [templateId];\n    uni.requestSubscribeMessage({\n      tmplIds,\n      success(_res) {\n        // 'accept'表示用户同意订阅该条id对应的模板消息，\n        // 'reject'表示用户拒绝订阅该条id对应的模板消息，\n        // 'ban'表示已被后台封禁，\n        // 'filter'表示该模板因为模板标题同名被后台过滤\n        const res = _res as unknown as Record<\n          string,\n          'accept' | 'reject' | 'ban' | 'filter'\n        >;\n        let subscribed = false;\n\n        for (const templateId of tmplIds) {\n          if (res[templateId] === 'accept') {\n            subscribed = true;\n            break;\n          }\n        }\n\n        resolve(subscribed);\n      },\n      fail() {\n        resolve(false);\n      },\n    });\n  });\n}\n\n/**\n * 监听应用更新状态\n */\nexport function useAppUpdate() {\n  const hasUpdate = ref(false);\n  const updateReady = ref(false);\n  const updateManager = uni.getUpdateManager?.();\n\n  updateManager?.onCheckForUpdate((res) => {\n    // 请求完新版本信息的回调\n    hasUpdate.value = Boolean(res.hasUpdate);\n  });\n\n  updateManager?.onUpdateReady(async () => {\n    updateReady.value = true;\n\n    const confirm = await uniConfirm('新版本已经准备好，是否重启应用？', {\n      title: '更新提示',\n      confirmText: '重启',\n    });\n    if (!confirm) return;\n\n    updateManager.applyUpdate();\n  });\n\n  updateManager?.onUpdateFailed(() => {\n    // 新的版本下载失败\n  });\n\n  return { hasUpdate, updateReady };\n}\n","import { errorAssign } from '@cloudcome/utils-core/error';\n\nexport type UniFailErr = UniNamespace.GeneralCallbackResult & {\n  errCode?: number;\n  errno?: number;\n};\n\nexport type UniPromiseError = Error & {\n  errCode: number;\n  errNo: number;\n};\n\n/**\n * 包装 uni 异步函数，返回 Promise 并处理错误\n * @param promise uni 异步函数的 Promise\n * @returns Promise<T>\n * @throws UniPromiseError\n */\nexport async function uniPromise<T>(promise: Promise<T>): Promise<T> {\n  try {\n    const result = await promise;\n    return result;\n  } catch (err) {\n    const res = err as unknown as UniFailErr;\n    throw errorAssign(new Error(res.errMsg || '未知错误'), {\n      errCode: res.errCode || -1,\n      errNo: res.errno || -1,\n    });\n  }\n}\n\n/**\n * 包装 uni 异步函数，返回 Promise 并处理错误\n * @param runner uni 异步函数的回调\n * @returns Promise<T>\n * @throws UniPromiseError\n */\nexport async function uniCallback<T>(\n  runner: (options: {\n    success: (res: T) => void;\n    fail: (err: UniFailErr) => void;\n  }) => unknown,\n) {\n  return new Promise<T>((resolve, reject) => {\n    runner({\n      success(res) {\n        resolve(res);\n      },\n      fail(err) {\n        reject(\n          errorAssign(new Error(err.errMsg || '未知错误'), {\n            errCode: err.errCode || -1,\n            errNo: err.errno || -1,\n          }),\n        );\n      },\n    });\n  });\n}\n","import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { HookListenerWithDispose } from '@cloudcome/utils-vue/component';\nimport { _runLifeHook } from '@cloudcome/utils-vue/shared';\nimport { onLoad, onPageHide, onPageShow, onUnload } from '@dcloudio/uni-app';\nimport { type Reactive, reactive } from 'vue';\n\n/**\n * 用于获取页面参数的 hook 函数\n * @template T - 页面参数对象的类型，继承自 AnyObject\n * @param {function} [onPageLoad] - 页面加载时的回调函数\n * @param {T} onLoad.query - 页面参数对象\n * @returns {T} 响应式的页面参数对象\n * @example\n * // 基本用法\n * const query = usePageQuery();\n *\n * // 带回调的用法\n * const query = usePageQuery((query) => {\n *   console.log('页面参数:', query);\n * });\n *\n * // 指定参数类型\n * interface PageParams {\n *   id: string;\n *   name?: string;\n * }\n * const query = usePageQuery<PageParams>();\n */\nexport function usePageQuery<T extends AnyObject>(\n  onPageLoad?: (query: Reactive<T>) => void,\n) {\n  const query = reactive<T>({} as T);\n\n  onLoad((_query) => {\n    Object.assign(query, _query);\n    onPageLoad?.(query);\n  });\n\n  return query;\n}\n\n/**\n * 用于处理页面加载生命周期的 hook 函数\n *\n * 该函数会在页面加载时执行传入的回调函数，并在页面卸载时执行清理操作（如果提供了清理函数）。\n * 它是 uni-app 中 onLoad 和 onUnload 生命周期的封装。\n *\n * @param {HookListenerWithDispose} load - 页面加载时的回调函数，可以返回一个清理函数\n *\n * @example\n * // 基本用法\n * usePageLoad(() => {\n *   console.log('页面已加载');\n * });\n *\n * @example\n * // 带清理函数的用法\n * usePageLoad(() => {\n *   console.log('页面已加载');\n *\n *   // 返回一个清理函数，在页面卸载时执行\n *   return () => {\n *     console.log('页面将要卸载');\n *   };\n * });\n *\n * @example\n * // 异步用法\n * usePageLoad(async () => {\n *   const data = await fetchData();\n *   console.log('获取到数据:', data);\n *\n *   return () => {\n *     console.log('清理资源');\n *   };\n * });\n */\nexport function usePageLoad(load: HookListenerWithDispose) {\n  _runLifeHook(onLoad, onUnload, load);\n}\n\n/**\n * 用于处理页面显示生命周期的 hook 函数\n *\n * 该函数会在页面显示时执行传入的回调函数，并在页面隐藏时执行清理操作（如果提供了清理函数）。\n * 它是 uni-app 中 onPageShow 和 onPageHide 生命周期的封装。\n *\n * @param {HookListenerWithDispose} pageShow - 页面显示时的回调函数，可以返回一个清理函数\n *\n * @example\n * // 基本用法\n * usePageShow(() => {\n *   console.log('页面已显示');\n * });\n *\n * @example\n * // 带清理函数的用法\n * usePageShow(() => {\n *   console.log('页面已显示');\n *\n *   // 返回一个清理函数，在页面隐藏时执行\n *   return () => {\n *     console.log('页面将要隐藏');\n *   };\n * });\n */\nexport function usePageShow(pageShow: HookListenerWithDispose) {\n  _runLifeHook(onPageShow, onPageHide, pageShow);\n}\n","import type { AnyArray, AnyFunction } from '@cloudcome/utils-core/types';\nimport {\n  type UseRequestOptions,\n  type UseRequestOutput,\n  type UseRequestOutputFilled,\n  useRequest,\n} from '@cloudcome/utils-vue/request';\nimport type { CloudMethodOutput, UniError } from '@/cloud';\nimport type { ClientDatabaseOutput } from '@/database';\nimport { parseCloudMethodOutput } from '../_helpers';\n\ntype _ImportObject = UniCloudNamespace.UniCloud['importObject'];\ntype _ImportObjectArgs = Parameters<_ImportObject>;\ntype _ImportObjectOptions = _ImportObjectArgs[1];\n\nexport type CreateUseCloudObjectOptions = _ImportObjectOptions & {\n  /**\n   * 模拟云对象，用于单元测试\n   * @private\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockServer?: any;\n\n  /**\n   * 回退错误信息\n   * @default '请求失败'\n   */\n  fallbackErrorMessage?: string;\n\n  /**\n   * 请求开始前的回调函数\n   */\n  onBefore?: () => unknown;\n\n  /**\n   * 请求成功后的回调函数\n   */\n  onSuccess?: () => unknown;\n\n  /**\n   * 请求失败时的回调函数\n   * @param err 错误信息\n   */\n  onError?: (err: UniError) => unknown;\n\n  /**\n   * 请求完成后的回调函数（无论成功或失败都会执行）\n   */\n  onAfter?: () => unknown;\n\n  /**\n   * 显示加载状态的回调函数，当配置了 showLoading 为 true 时会调用\n   */\n  onShowLoading?: () => unknown;\n\n  /**\n   * 隐藏加载状态的回调函数，当配置了 showLoading 为 true 时会调用\n   */\n  onHideLoading?: () => unknown;\n\n  /**\n   * 显示错误信息的回调函数，当配置了 showError 为 true 时会调用\n   * @param err 错误信息\n   */\n  onShowError?: (err: UniError) => unknown;\n};\n\n/**\n * 云对象请求函数类型定义\n * @template F 云对象方法函数类型\n * @param input 云对象方法的参数数组\n * @returns 返回云对象方法执行结果的Promise\n */\nexport type CloudObjectRequest = <F extends AnyFunction>(\n  ...input: Parameters<F>\n) => Promise<CloudMethodOutput<ReturnType<F>>>;\n\n/**\n * 用于调用云对象方法的配置选项类型定义\n * @template I 输入参数类型数组\n * @template O 输出结果类型\n */\nexport type UseCloudMethodOptions<I extends AnyArray, O> = Omit<\n  UseRequestOptions<I, O>,\n  'onError'\n> & {\n  /**\n   * 请求发生错误时的回调函数\n   * @param err 错误信息\n   * @param inputs 请求输入参数\n   */\n  onError?: (err: UniError, ...inputs: I) => unknown;\n\n  /**\n   * 是否显示加载状态\n   * @default false\n   */\n  showLoading?: boolean;\n\n  /**\n   * 是否显示错误信息\n   * @default false\n   */\n  showError?: boolean;\n};\n\n/**\n * 用于调用云对象方法的hook函数类型定义\n * @template I 输入参数类型数组\n * @template O 输出结果类型\n */\nexport type UseCloudMethod<Api extends Record<string, AnyFunction>> = {\n  /**\n   * 重载签名：当提供 placeholder 选项时，返回包含初始值的输出类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象方法的函数\n   * @param options 包含 placeholder 的请求配置选项\n   * @returns 返回包含初始值的请求输出\n   */\n  <K extends keyof Api, I extends AnyArray, O>(\n    method: K,\n    caller: (request: Api[K], ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options: Omit<UseCloudMethodOptions<I, O>, 'placeholder'> & {\n      placeholder: () => O;\n    },\n  ): UseRequestOutputFilled<I, O>;\n\n  /**\n   * 重载签名：当不提供 placeholder 选项时，返回普通输出类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象方法的函数\n   * @param options 可选的请求配置选项\n   * @returns 返回普通的请求输出\n   */\n  <K extends keyof Api, I extends AnyArray, O>(\n    method: K,\n    caller: (request: Api[K], ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options?: UseCloudMethodOptions<I, O>,\n  ): UseRequestOutput<I, O>;\n};\n\n/**\n * 导入云对象并创建一个用于调用云对象的hook\n * @param objectName 云对象名称\n * @param importOptions 配置选项，包含模拟服务器、回退错误信息等\n * @returns 返回一个可用于调用云对象方法的hook函数\n */\nexport function importCloudObject<Api extends Record<string, AnyFunction>>(\n  objectName: _ImportObjectArgs[0],\n  importOptions?: CreateUseCloudObjectOptions,\n) {\n  const fallbackErrorMessage =\n    importOptions?.fallbackErrorMessage || '请求失败';\n  const server =\n    importOptions?._mockServer ||\n    uniCloud.importObject(objectName, importOptions);\n  const onShowLoading =\n    importOptions?.onShowLoading ||\n    (() => uni.showLoading({ title: '', mask: true }));\n  const onHideLoading =\n    importOptions?.onHideLoading || (() => uni.hideLoading());\n  const onShowError =\n    importOptions?.onShowError ||\n    ((err) =>\n      uni.showToast({\n        title: err.message,\n        icon: 'none',\n        duration: 3000,\n        mask: false,\n      }));\n\n  /**\n   * 用于调用云对象方法的hook函数\n   * @template I 输入参数类型\n   * @template O 输出结果类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象的函数\n   * @param options 配置选项，包含请求相关的配置\n   * @returns 返回一个请求hook，用于处理云对象调用\n   */\n  const useCloudMethod: UseCloudMethod<Api> = (method, caller, options) => {\n    // 使用请求hook处理云对象调用\n    return useRequest(\n      async (...inputs) => {\n        const request = server[method];\n        const output = await caller(request, ...inputs);\n        return parseCloudMethodOutput(output, fallbackErrorMessage);\n      },\n      {\n        ...options,\n        async onBefore(...inputs) {\n          if (options?.showLoading) onShowLoading();\n\n          await importOptions?.onBefore?.();\n          await options?.onBefore?.(...inputs);\n        },\n        async onSuccess(data, ...inputs) {\n          await importOptions?.onSuccess?.();\n          await options?.onSuccess?.(data, ...inputs);\n        },\n        async onError(err, ...inputs) {\n          await importOptions?.onError?.(err as UniError);\n          await options?.onError?.(err as UniError, ...inputs);\n\n          if (options?.showError) {\n            // 加延迟是尽量保证在 loading 隐藏后再显示错误信息\n            setTimeout(() => {\n              onShowError(err as UniError);\n            });\n          }\n        },\n        async onAfter(...inputs) {\n          if (options?.showLoading) onHideLoading();\n\n          await importOptions?.onAfter?.();\n          await options?.onAfter?.(...inputs);\n        },\n      },\n    );\n  };\n\n  return useCloudMethod;\n}\n\nexport type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<\n  I,\n  O\n> & {\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDatabase?: any;\n};\n\n/**\n * 创建一个用于调用云数据库的hook\n * @param caller 调用云数据库的函数，接收数据库实例和输入参数，返回Promise\n * @param options 配置选项\n * @returns 返回一个请求hook，用于处理云数据库调用\n */\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (\n    db: UniCloud.Database,\n    ...inputs: I\n  ) => Promise<ClientDatabaseOutput<O>>,\n  options: Omit<UseDatabaseOptions<I, O>, 'placeholder'> & {\n    placeholder: () => O;\n  },\n): UseRequestOutputFilled<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (\n    db: UniCloud.Database,\n    ...inputs: I\n  ) => Promise<ClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (\n    db: UniCloud.Database,\n    ...inputs: I\n  ) => Promise<ClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O> {\n  // 获取数据库实例，优先使用模拟数据库（用于测试），否则使用uniCloud数据库\n  const db = options?._mockDatabase || uniCloud.database();\n  return useRequest(async (...inputs: I) => {\n    const { result } = await caller(db, ...inputs);\n    if (!result.errCode) return result;\n    throw new Error(result.errMsg || '请求失败');\n  }, options);\n}\n","import type { ComponentInternalInstance } from 'vue';\n\nexport type Rect = {\n  /**\n   * 元素距离屏幕的左坐标，单位：px\n   */\n  left: number;\n  /**\n   * 元素距离屏幕的上坐标，单位：px\n   */\n  top: number;\n  /**\n   * 元素距离屏幕的宽度，单位：px\n   */\n  width: number;\n  /**\n   * 元素距离屏幕的高度，单位：px\n   */\n  height: number;\n};\n\n/**\n * 查询元素距离屏幕的矩形信息\n * @param instance 组件实例\n * @param selector 选择器\n * @returns 元素距离屏幕的矩形信息\n */\nexport async function querySelectorRects(\n  instance: ComponentInternalInstance,\n  selector: string,\n) {\n  return new Promise<Rect[]>((resolve) => {\n    uni\n      .createSelectorQuery()\n      .in(instance.proxy)\n      .selectAll(selector)\n      .boundingClientRect((_rects) => {\n        const rects = _rects as UniApp.NodeInfo[];\n        resolve(\n          rects.map((rect) => ({\n            left: rect.left || 0,\n            top: rect.top || 0,\n            width: rect.width || 0,\n            height: rect.height || 0,\n          })),\n        );\n      })\n      .exec();\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;AASA,SAAgB,WACd,MACA,SAIA;CACA,MAAM,aAAa,SAAS,cAAc;CAC1C,MAAM,cAAc,SAAS,eAAe;CAE5C,IAAI,WAAW,SAAS,GACtB,QAAQ,KAAK,kCAAkC;CACjD,IAAI,YAAY,SAAS,GACvB,QAAQ,KAAK,mCAAmC;CAElD,OAAO,IAAI,SAAkB,YAAY;EAEvC,iBAAiB;GACf,IAAI,UAAU;IACZ,OAAO;IACP,SAAS;IACT,YAAY;IACZ;IACA;IACA,GAAG;IACH,QAAQ,QAAQ;KACd,QAAQ,OAAO,QAAQ;;IAE1B,CAAC;IACF;GACF;;;;;;;;AASJ,SAAgB,UACd,MACA,SAIA;CACA,MAAM,aAAa,SAAS,cAAc;CAC1C,MAAM,cAAc,SAAS,eAAe;CAE5C,IAAI,WAAW,SAAS,GACtB,QAAQ,KAAK,kCAAkC;CACjD,IAAI,YAAY,SAAS,GACvB,QAAQ,KAAK,mCAAmC;CAElD,OAAO,IAAI,SAAiB,YAAY;EAEtC,iBAAiB;GACf,IAAI,UAAU;IACZ,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,YAAY;IACZ;IACA;IACA,UAAU;IACV,GAAG;IACH,QAAQ,QAAQ;KACd,QAAQ,OAAO,WAAW,GAAG;;IAEhC,CAAC;IACF;GACF;;;;;;;;AASJ,SAAgB,SACd,MACA,SAIA;CACA,MAAM,cAAc,SAAS,eAAe;CAE5C,IAAI,YAAY,SAAS,GACvB,QAAQ,KAAK,mCAAmC;CAElD,OAAO,IAAI,SAAe,YAAY;EAEpC,iBAAiB;GACf,IAAI,UAAU;IACZ,OAAO;IACP;IACA,YAAY;IACZ,GAAG;IACH,SAAS;IACT,YAAY;IACZ,UAAU;KACR,SAAS;;IAEZ,CAAC;IACF;GACF;;AAkBJ,SAAgB,SACd,MACA,eAGe;CACf,MAAM,UAAU,EAAE;CAElB,KAAA,GAAA,2BAAA,UAAa,cAAc,EACzB,QAAQ,OAAO;MAEf,OAAO,OAAO,SAAS,cAAc;CAGvC,OAAO,IAAI,SAAe,YAAY;EAEpC,WAAW,YAAY;GACrB,IAAI,UAAU;IACZ,OAAO;IACP,UAAU;IACV,MAAM,QAAQ,QAAQ;IACvB,CAAC;GACF,CAAA,GAAA,8BAAA,cAAa,IAAK,CAAC,KAAK,QAAQ;IAChC;GACF;;;;;;AAOJ,SAAgB,WAAW,OAAgB;CACzC,IAAI,YAAY;EACd;EACA,MAAM;EACP,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AClIJ,SAAgB,WAAW,SAAkC;CAC3D,CAAA,GAAA,4BAAA,cAAa,kBAAA,QAAQ,kBAAA,QAAQ,QAAQ;;;;;;;AAQvC,eAAsB,mBAAmB,YAA+B;CACtE,IAAI,CAAC,IAAI,yBAAyB,OAAO;CAEzC,OAAO,IAAI,SAAkB,YAAY;EACvC,MAAM,UAAU,MAAM,QAAQ,WAAW,GAAG,aAAa,CAAC,WAAW;EACrE,IAAI,wBAAwB;GAC1B;GACA,QAAQ,MAAM;IAKZ,MAAM,MAAM;IAIZ,IAAI,aAAa;IAEjB,KAAK,MAAM,cAAc,SACvB,IAAI,IAAI,gBAAgB,UAAU;KAChC,aAAa;KACb;;IAIJ,QAAQ,WAAW;;GAErB,OAAO;IACL,QAAQ,MAAM;;GAEjB,CAAC;GACF;;;;;AAMJ,SAAgB,eAAe;CAC7B,MAAM,aAAA,GAAA,IAAA,KAAgB,MAAM;CAC5B,MAAM,eAAA,GAAA,IAAA,KAAkB,MAAM;CAC9B,MAAM,gBAAgB,IAAI,oBAAoB;CAE9C,eAAe,kBAAkB,QAAQ;EAEvC,UAAU,QAAQ,QAAQ,IAAI,UAAU;GACxC;CAEF,eAAe,cAAc,YAAY;EACvC,YAAY,QAAQ;EAMpB,IAAI,CAAC,MAJiB,WAAW,oBAAoB;GACnD,OAAO;GACP,aAAa;GACd,CAAC,EACY;EAEd,cAAc,aAAa;GAC3B;CAEF,eAAe,qBAAqB,GAElC;CAEF,OAAO;EAAE;EAAW;EAAa;;;;;;;;;;AC7FnC,eAAsB,WAAc,SAAiC;CACnE,IAAI;EAEF,OAAO,MADc;UAEd,KAAK;EACZ,MAAM,MAAM;EACZ,OAAA,GAAA,4BAAA,aAAkB,IAAI,MAAM,IAAI,UAAU,OAAO,EAAE;GACjD,SAAS,IAAI,WAAW;GACxB,OAAO,IAAI,SAAS;GACrB,CAAC;;;;;;;;;AAUN,eAAsB,YACpB,QAIA;CACA,OAAO,IAAI,SAAY,SAAS,WAAW;EACzC,OAAO;GACL,QAAQ,KAAK;IACX,QAAQ,IAAI;;GAEd,KAAK,KAAK;IACR,QAAA,GAAA,4BAAA,aACc,IAAI,MAAM,IAAI,UAAU,OAAO,EAAE;KAC3C,SAAS,IAAI,WAAW;KACxB,OAAO,IAAI,SAAS;KACrB,CAAC,CACH;;GAEJ,CAAC;GACF;;;;;;;;;;;;;;;;;;;;;;;;;;AC7BJ,SAAgB,aACd,YACA;CACA,MAAM,SAAA,GAAA,IAAA,UAAoB,EAAE,CAAM;CAElC,CAAA,GAAA,kBAAA,SAAQ,WAAW;EACjB,OAAO,OAAO,OAAO,OAAO;EAC5B,aAAa,MAAM;GACnB;CAEF,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCT,SAAgB,YAAY,MAA+B;CACzD,CAAA,GAAA,4BAAA,cAAa,kBAAA,QAAQ,kBAAA,UAAU,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BtC,SAAgB,YAAY,UAAmC;CAC7D,CAAA,GAAA,4BAAA,cAAa,kBAAA,YAAY,kBAAA,YAAY,SAAS;;;;;;;;;;ACwChD,SAAgB,kBACd,YACA,eACA;CACA,MAAM,uBACJ,eAAe,wBAAwB;CACzC,MAAM,SACJ,eAAe,eACf,SAAS,aAAa,YAAY,cAAc;CAClD,MAAM,gBACJ,eAAe,wBACR,IAAI,YAAY;EAAE,OAAO;EAAI,MAAM;EAAM,CAAC;CACnD,MAAM,gBACJ,eAAe,wBAAwB,IAAI,aAAa;CAC1D,MAAM,cACJ,eAAe,iBACb,QACA,IAAI,UAAU;EACZ,OAAO,IAAI;EACX,MAAM;EACN,UAAU;EACV,MAAM;EACP,CAAC;;;;;;;;;;CAWN,MAAM,kBAAuC,QAAQ,QAAQ,YAAY;EAEvE,QAAA,GAAA,6BAAA,YACE,OAAO,GAAG,WAAW;GACnB,MAAM,UAAU,OAAO;GAEvB,OAAO,iBAAA,uBAAuB,MADT,OAAO,SAAS,GAAG,OAAO,EACT,qBAAqB;KAE7D;GACE,GAAG;GACH,MAAM,SAAS,GAAG,QAAQ;IACxB,IAAI,SAAS,aAAa,eAAe;IAEzC,MAAM,eAAe,YAAY;IACjC,MAAM,SAAS,WAAW,GAAG,OAAO;;GAEtC,MAAM,UAAU,MAAM,GAAG,QAAQ;IAC/B,MAAM,eAAe,aAAa;IAClC,MAAM,SAAS,YAAY,MAAM,GAAG,OAAO;;GAE7C,MAAM,QAAQ,KAAK,GAAG,QAAQ;IAC5B,MAAM,eAAe,UAAU,IAAgB;IAC/C,MAAM,SAAS,UAAU,KAAiB,GAAG,OAAO;IAEpD,IAAI,SAAS,WAEX,iBAAiB;KACf,YAAY,IAAgB;MAC5B;;GAGN,MAAM,QAAQ,GAAG,QAAQ;IACvB,IAAI,SAAS,aAAa,eAAe;IAEzC,MAAM,eAAe,WAAW;IAChC,MAAM,SAAS,UAAU,GAAG,OAAO;;GAEtC,CACF;;CAGH,OAAO;;AAoCT,SAAgB,YACd,QAIA,SACwB;CAExB,MAAM,KAAK,SAAS,iBAAiB,SAAS,UAAU;CACxD,QAAA,GAAA,6BAAA,YAAkB,OAAO,GAAG,WAAc;EACxC,MAAM,EAAE,WAAW,MAAM,OAAO,IAAI,GAAG,OAAO;EAC9C,IAAI,CAAC,OAAO,SAAS,OAAO;EAC5B,MAAM,IAAI,MAAM,OAAO,UAAU,OAAO;IACvC,QAAQ;;;;;;;;;;ACnPb,eAAsB,mBACpB,UACA,UACA;CACA,OAAO,IAAI,SAAiB,YAAY;EACtC,IACG,qBAAqB,CACrB,GAAG,SAAS,MAAM,CAClB,UAAU,SAAS,CACnB,oBAAoB,WAAW;GAE9B,QACE,OAAM,KAAK,UAAU;IACnB,MAAM,KAAK,QAAQ;IACnB,KAAK,KAAK,OAAO;IACjB,OAAO,KAAK,SAAS;IACrB,QAAQ,KAAK,UAAU;IACxB,EAAE,CACJ;IACD,CACD,MAAM;GACT"}

package/dist/client.d.ts

@@ -1,129 +1,8 @@
-import { AnyArray, AnyFunction } from '@cloudcome/utils-core/types';
-import { UseRequestOptions, UseRequestOutput, UseRequestOutputFilled } from '@cloudcome/utils-vue/request';
-import { CloudMethodOutput, UniError } from './cloud';
-import { ClientDatabaseOutput } from './database';
-type _ImportObject = UniCloudNamespace.UniCloud['importObject'];
-type _ImportObjectArgs = Parameters<_ImportObject>;
-type _ImportObjectOptions = _ImportObjectArgs[1];
-export type CreateUseCloudObjectOptions = _ImportObjectOptions & {
-    /**
-     * 模拟云对象，用于单元测试
-     * @private
-     */
-    _mockServer?: any;
-    /**
-     * 回退错误信息
-     * @default '请求失败'
-     */
-    fallbackErrorMessage?: string;
-    /**
-     * 请求开始前的回调函数
-     */
-    onBefore?: () => unknown;
-    /**
-     * 请求成功后的回调函数
-     */
-    onSuccess?: () => unknown;
-    /**
-     * 请求失败时的回调函数
-     * @param err 错误信息
-     */
-    onError?: (err: UniError) => unknown;
-    /**
-     * 请求完成后的回调函数（无论成功或失败都会执行）
-     */
-    onAfter?: () => unknown;
-    /**
-     * 显示加载状态的回调函数，当配置了 showLoading 为 true 时会调用
-     */
-    onShowLoading?: () => unknown;
-    /**
-     * 隐藏加载状态的回调函数，当配置了 showLoading 为 true 时会调用
-     */
-    onHideLoading?: () => unknown;
-    /**
-     * 显示错误信息的回调函数，当配置了 showError 为 true 时会调用
-     * @param err 错误信息
-     */
-    onShowError?: (err: UniError) => unknown;
-};
-/**
- * 云对象请求函数类型定义
- * @template F 云对象方法函数类型
- * @param input 云对象方法的参数数组
- * @returns 返回云对象方法执行结果的Promise
- */
-export type CloudObjectRequest = <F extends AnyFunction>(...input: Parameters<F>) => Promise<CloudMethodOutput<ReturnType<F>>>;
-/**
- * 用于调用云对象方法的配置选项类型定义
- * @template I 输入参数类型数组
- * @template O 输出结果类型
- */
-export type UseCloudMethodOptions<I extends AnyArray, O> = Omit<UseRequestOptions<I, O>, 'onError'> & {
-    /**
-     * 请求发生错误时的回调函数
-     * @param err 错误信息
-     * @param inputs 请求输入参数
-     */
-    onError?: (err: UniError, ...inputs: I) => unknown;
-    /**
-     * 是否显示加载状态
-     * @default false
-     */
-    showLoading?: boolean;
-    /**
-     * 是否显示错误信息
-     * @default false
-     */
-    showError?: boolean;
-};
-/**
- * 用于调用云对象方法的hook函数类型定义
- * @template I 输入参数类型数组
- * @template O 输出结果类型
- */
-export type UseCloudMethod<Api extends Record<string, AnyFunction>> = {
-    /**
-     * 重载签名：当提供 placeholder 选项时，返回包含初始值的输出类型
-     * @param method 云对象方法名
-     * @param caller 调用云对象方法的函数
-     * @param options 包含 placeholder 的请求配置选项
-     * @returns 返回包含初始值的请求输出
-     */
-    <K extends keyof Api, I extends AnyArray, O>(method: K, caller: (request: Api[K], ...inputs: I) => Promise<CloudMethodOutput<O>>, options: Omit<UseCloudMethodOptions<I, O>, 'placeholder'> & {
-        placeholder: () => O;
-    }): UseRequestOutputFilled<I, O>;
-    /**
-     * 重载签名：当不提供 placeholder 选项时，返回普通输出类型
-     * @param method 云对象方法名
-     * @param caller 调用云对象方法的函数
-     * @param options 可选的请求配置选项
-     * @returns 返回普通的请求输出
-     */
-    <K extends keyof Api, I extends AnyArray, O>(method: K, caller: (request: Api[K], ...inputs: I) => Promise<CloudMethodOutput<O>>, options?: UseCloudMethodOptions<I, O>): UseRequestOutput<I, O>;
-};
-/**
- * 导入云对象并创建一个用于调用云对象的hook
- * @param objectName 云对象名称
- * @param importOptions 配置选项，包含模拟服务器、回退错误信息等
- * @returns 返回一个可用于调用云对象方法的hook函数
- */
-export declare function importCloudObject<Api extends Record<string, AnyFunction>>(objectName: _ImportObjectArgs[0], importOptions?: CreateUseCloudObjectOptions): UseCloudMethod<Api>;
-export type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<I, O> & {
-    /**
-     * 模拟数据库，用于单元测试
-     */
-    _mockDatabase?: any;
-};
-/**
- * 创建一个用于调用云数据库的hook
- * @param caller 调用云数据库的函数，接收数据库实例和输入参数，返回Promise
- * @param options 配置选项
- * @returns 返回一个请求hook，用于处理云数据库调用
- */
-export declare function useDatabase<I extends AnyArray, O>(caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>, options: Omit<UseDatabaseOptions<I, O>, 'placeholder'> & {
-    placeholder: () => O;
-}): UseRequestOutputFilled<I, O>;
-export declare function useDatabase<I extends AnyArray, O>(caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>, options?: UseDatabaseOptions<I, O>): UseRequestOutput<I, O>;
 export { parseCloudMethodOutput } from './_helpers';
 export type { UniError } from './_types';
+export * from './client/app';
+export * from './client/async';
+export * from './client/message';
+export * from './client/page';
+export * from './client/request';
+export * from './client/ui';

package/dist/client.mjs

@@ -1,6 +1,347 @@
 import { t as parseCloudMethodOutput } from "./_helpers.mjs";
+import { errorAssign } from "@cloudcome/utils-core/error";
+import { _runLifeHook } from "@cloudcome/utils-vue/shared";
+import { onHide, onLoad, onPageHide, onPageShow, onShow, onUnload } from "@dcloudio/uni-app";
+import { reactive, ref } from "vue";
+import { promiseDelay } from "@cloudcome/utils-core/promise";
+import { isString } from "@cloudcome/utils-core/type";
 import { useRequest } from "@cloudcome/utils-vue/request";
-//#region src/client.ts
+//#region src/client/message.ts
+/**
+* 显示 confirm 提示
+* @param text 提示文本
+* @param options 其他选项
+* @returns 提示完成后的 Promise
+*/
+function uniConfirm(text, options) {
+	const cancelText = options?.cancelText || "取消";
+	const confirmText = options?.confirmText || "确认";
+	if (cancelText.length > 4) console.warn("微信小程序内不支持 cancelText 长度超过 4 个字符");
+	if (confirmText.length > 4) console.warn("微信小程序内不支持 confirmText 长度超过 4 个字符");
+	return new Promise((resolve) => {
+		setTimeout(() => {
+			uni.showModal({
+				title: "请确认",
+				content: text,
+				showCancel: true,
+				confirmText,
+				cancelText,
+				...options,
+				success(result) {
+					resolve(result.confirm);
+				}
+			});
+		});
+	});
+}
+/**
+* 显示 prompt 提示
+* @param text 提示文本
+* @param options 其他选项
+* @returns 提示完成后的 Promise
+*/
+function uniPrompt(text, options) {
+	const cancelText = options?.cancelText || "取消";
+	const confirmText = options?.confirmText || "确认";
+	if (cancelText.length > 4) console.warn("微信小程序内不支持 cancelText 长度超过 4 个字符");
+	if (confirmText.length > 4) console.warn("微信小程序内不支持 confirmText 长度超过 4 个字符");
+	return new Promise((resolve) => {
+		setTimeout(() => {
+			uni.showModal({
+				title: "请输入",
+				content: "",
+				placeholderText: text,
+				showCancel: true,
+				confirmText,
+				cancelText,
+				editable: true,
+				...options,
+				success(result) {
+					resolve(result.content || "");
+				}
+			});
+		});
+	});
+}
+/**
+* 显示 alert 提示
+* @param text 提示文本
+* @param options 其他选项
+* @returns 提示完成后的 Promise
+*/
+function uniAlert(text, options) {
+	const confirmText = options?.confirmText || "好";
+	if (confirmText.length > 4) console.warn("微信小程序内不支持 confirmText 长度超过 4 个字符");
+	return new Promise((resolve) => {
+		setTimeout(() => {
+			uni.showModal({
+				title: "提示",
+				confirmText,
+				cancelText: "",
+				...options,
+				content: text,
+				showCancel: false,
+				success() {
+					resolve();
+				}
+			});
+		});
+	});
+}
+function uniToast(text, iconOrOptions) {
+	const options = {};
+	if (isString(iconOrOptions)) options.icon = iconOrOptions;
+	else Object.assign(options, iconOrOptions);
+	return new Promise((resolve) => {
+		setTimeout(async () => {
+			uni.showToast({
+				title: text,
+				duration: 2900,
+				icon: options.icon || "none"
+			});
+			promiseDelay(3e3).then(resolve);
+		});
+	});
+}
+/**
+* 显示 loading 提示
+* @param title 提示文本
+*/
+function uniLoading(title) {
+	uni.showLoading({
+		title,
+		mask: true
+	});
+}
+//#endregion
+//#region src/client/app.ts
+/**
+* 应用显示状态生命周期钩子函数
+*
+* 该函数用于监听应用从后台进入前台的生命周期事件。
+* 当应用从后台切换到前台时触发 onShow 回调，
+* 当应用从前台切换到后台时触发 onHide 回调。
+*
+* @param appShow - 应用显示状态变化时的回调函数，可以返回一个清理函数
+*
+* @example
+* // 基本用法
+* useAppShow(() => {
+*   console.log('应用进入前台');
+*
+*   // 可选：返回一个清理函数，在应用进入后台时执行
+*   return () => {
+*     console.log('应用进入后台');
+*   };
+* });
+*
+* @example
+* // 带有异步操作的用法
+* useAppShow(async () => {
+*   // 应用进入前台时刷新数据
+*   await refreshUserData();
+*
+*   // 返回清理函数
+*   return () => {
+*     // 应用进入后台时保存数据
+*     saveUserData();
+*   };
+* });
+*/
+function useAppShow(appShow) {
+	_runLifeHook(onShow, onHide, appShow);
+}
+/**
+* 订阅模板消息
+* @param templateId 模板消息 ID 或 ID 列表
+* @returns Promise<boolean>
+*/
+async function uniSubscribeNotice(templateId) {
+	if (!uni.requestSubscribeMessage) return false;
+	return new Promise((resolve) => {
+		const tmplIds = Array.isArray(templateId) ? templateId : [templateId];
+		uni.requestSubscribeMessage({
+			tmplIds,
+			success(_res) {
+				const res = _res;
+				let subscribed = false;
+				for (const templateId of tmplIds) if (res[templateId] === "accept") {
+					subscribed = true;
+					break;
+				}
+				resolve(subscribed);
+			},
+			fail() {
+				resolve(false);
+			}
+		});
+	});
+}
+/**
+* 监听应用更新状态
+*/
+function useAppUpdate() {
+	const hasUpdate = ref(false);
+	const updateReady = ref(false);
+	const updateManager = uni.getUpdateManager?.();
+	updateManager?.onCheckForUpdate((res) => {
+		hasUpdate.value = Boolean(res.hasUpdate);
+	});
+	updateManager?.onUpdateReady(async () => {
+		updateReady.value = true;
+		if (!await uniConfirm("新版本已经准备好，是否重启应用？", {
+			title: "更新提示",
+			confirmText: "重启"
+		})) return;
+		updateManager.applyUpdate();
+	});
+	updateManager?.onUpdateFailed(() => {});
+	return {
+		hasUpdate,
+		updateReady
+	};
+}
+//#endregion
+//#region src/client/async.ts
+/**
+* 包装 uni 异步函数，返回 Promise 并处理错误
+* @param promise uni 异步函数的 Promise
+* @returns Promise<T>
+* @throws UniPromiseError
+*/
+async function uniPromise(promise) {
+	try {
+		return await promise;
+	} catch (err) {
+		const res = err;
+		throw errorAssign(new Error(res.errMsg || "未知错误"), {
+			errCode: res.errCode || -1,
+			errNo: res.errno || -1
+		});
+	}
+}
+/**
+* 包装 uni 异步函数，返回 Promise 并处理错误
+* @param runner uni 异步函数的回调
+* @returns Promise<T>
+* @throws UniPromiseError
+*/
+async function uniCallback(runner) {
+	return new Promise((resolve, reject) => {
+		runner({
+			success(res) {
+				resolve(res);
+			},
+			fail(err) {
+				reject(errorAssign(new Error(err.errMsg || "未知错误"), {
+					errCode: err.errCode || -1,
+					errNo: err.errno || -1
+				}));
+			}
+		});
+	});
+}
+//#endregion
+//#region src/client/page.ts
+/**
+* 用于获取页面参数的 hook 函数
+* @template T - 页面参数对象的类型，继承自 AnyObject
+* @param {function} [onPageLoad] - 页面加载时的回调函数
+* @param {T} onLoad.query - 页面参数对象
+* @returns {T} 响应式的页面参数对象
+* @example
+* // 基本用法
+* const query = usePageQuery();
+*
+* // 带回调的用法
+* const query = usePageQuery((query) => {
+*   console.log('页面参数:', query);
+* });
+*
+* // 指定参数类型
+* interface PageParams {
+*   id: string;
+*   name?: string;
+* }
+* const query = usePageQuery<PageParams>();
+*/
+function usePageQuery(onPageLoad) {
+	const query = reactive({});
+	onLoad((_query) => {
+		Object.assign(query, _query);
+		onPageLoad?.(query);
+	});
+	return query;
+}
+/**
+* 用于处理页面加载生命周期的 hook 函数
+*
+* 该函数会在页面加载时执行传入的回调函数，并在页面卸载时执行清理操作（如果提供了清理函数）。
+* 它是 uni-app 中 onLoad 和 onUnload 生命周期的封装。
+*
+* @param {HookListenerWithDispose} load - 页面加载时的回调函数，可以返回一个清理函数
+*
+* @example
+* // 基本用法
+* usePageLoad(() => {
+*   console.log('页面已加载');
+* });
+*
+* @example
+* // 带清理函数的用法
+* usePageLoad(() => {
+*   console.log('页面已加载');
+*
+*   // 返回一个清理函数，在页面卸载时执行
+*   return () => {
+*     console.log('页面将要卸载');
+*   };
+* });
+*
+* @example
+* // 异步用法
+* usePageLoad(async () => {
+*   const data = await fetchData();
+*   console.log('获取到数据:', data);
+*
+*   return () => {
+*     console.log('清理资源');
+*   };
+* });
+*/
+function usePageLoad(load) {
+	_runLifeHook(onLoad, onUnload, load);
+}
+/**
+* 用于处理页面显示生命周期的 hook 函数
+*
+* 该函数会在页面显示时执行传入的回调函数，并在页面隐藏时执行清理操作（如果提供了清理函数）。
+* 它是 uni-app 中 onPageShow 和 onPageHide 生命周期的封装。
+*
+* @param {HookListenerWithDispose} pageShow - 页面显示时的回调函数，可以返回一个清理函数
+*
+* @example
+* // 基本用法
+* usePageShow(() => {
+*   console.log('页面已显示');
+* });
+*
+* @example
+* // 带清理函数的用法
+* usePageShow(() => {
+*   console.log('页面已显示');
+*
+*   // 返回一个清理函数，在页面隐藏时执行
+*   return () => {
+*     console.log('页面将要隐藏');
+*   };
+* });
+*/
+function usePageShow(pageShow) {
+	_runLifeHook(onPageShow, onPageHide, pageShow);
+}
+//#endregion
+//#region src/client/request.ts
 /**
 * 导入云对象并创建一个用于调用云对象的hook
 * @param objectName 云对象名称
@@ -70,6 +411,26 @@ function useDatabase(caller, options) {
 	}, options);
 }
 //#endregion
-export { importCloudObject, parseCloudMethodOutput, useDatabase };
+//#region src/client/ui.ts
+/**
+* 查询元素距离屏幕的矩形信息
+* @param instance 组件实例
+* @param selector 选择器
+* @returns 元素距离屏幕的矩形信息
+*/
+async function querySelectorRects(instance, selector) {
+	return new Promise((resolve) => {
+		uni.createSelectorQuery().in(instance.proxy).selectAll(selector).boundingClientRect((_rects) => {
+			resolve(_rects.map((rect) => ({
+				left: rect.left || 0,
+				top: rect.top || 0,
+				width: rect.width || 0,
+				height: rect.height || 0
+			})));
+		}).exec();
+	});
+}
+//#endregion
+export { importCloudObject, parseCloudMethodOutput, querySelectorRects, uniAlert, uniCallback, uniConfirm, uniLoading, uniPromise, uniPrompt, uniSubscribeNotice, uniToast, useAppShow, useAppUpdate, useDatabase, usePageLoad, usePageQuery, usePageShow };
 
 //# sourceMappingURL=client.mjs.map