npm - @cloudcome/utils-uni - Versions diffs - 1.31.1 → 1.32.0 - Mend

@cloudcome/utils-uni 1.31.1 → 1.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/dist/cloud/request.d.ts ADDED Viewed

@@ -0,0 +1,82 @@
+import { AnyObject } from '@cloudcome/utils-core/types';
+/**
+ * HTTP 请求配置选项
+ */
+export type RequestOptions = {
+    /**
+     * 请求 URL 地址
+     */
+    url: string;
+    /**
+     * URL 查询参数，会自动拼接到 url 后面
+     */
+    query?: Record<string, string>;
+    /**
+     * HTTP 请求方法
+     * @default 'GET'
+     */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD' | 'OPTIONS';
+    /**
+     * 请求头
+     */
+    headers?: Record<string, string>;
+    /**
+     * 请求体数据
+     */
+    data?: AnyObject;
+    /**
+     * 返回数据格式
+     * @default 'json'
+     */
+    dataType?: string;
+    /**
+     * 请求内容类型
+     * - 'json': application/json
+     * - 'form': application/x-www-form-urlencoded
+     * @default 'json'
+     */
+    contentType?: string;
+    /**
+     * 请求超时时间，单位毫秒
+     * @default 10000
+     */
+    timeout?: number;
+};
+/**
+ * 发起 HTTP 请求
+ *
+ * 基于 uniCloud.httpclient 发起 HTTP 请求，支持 GET、POST、PUT、DELETE 等方法。
+ * 查询参数会自动通过 qsStringify 拼接到 URL 上。
+ *
+ * @template T - 响应数据的类型
+ * @param options 请求配置选项
+ * @returns 包含 data、status、headers 的响应对象
+ *
+ * @example
+ * ```ts
+ * // GET 请求
+ * const res = await request<{ name: string }>({
+ *   url: 'https://api.example.com/users/1',
+ * })
+ * console.log(res.data) // { name: 'Alice' }
+ * console.log(res.status) // 200
+ *
+ * // POST 请求
+ * const res = await request<{ id: string }>({
+ *   url: 'https://api.example.com/users',
+ *   method: 'POST',
+ *   data: { name: 'Alice', age: 25 },
+ * })
+ *
+ * // 带查询参数
+ * const res = await request<{ list: any[] }>({
+ *   url: 'https://api.example.com/users',
+ *   query: { page: '1', size: '10' },
+ * })
+ * ```
+ */
+export declare function request<T>(options: RequestOptions): Promise<{
+    data: T;
+    status: number;
+    headers: Record<string, string>;
+}>;

package/dist/cloud.cjs CHANGED Viewed

@@ -5,6 +5,7 @@ let _cloudcome_utils_core_error = require("@cloudcome/utils-core/error");
 let _cloudcome_utils_core_object = require("@cloudcome/utils-core/object");
 let _cloudcome_utils_core_try = require("@cloudcome/utils-core/try");
 let _cloudcome_utils_core_version = require("@cloudcome/utils-core/version");
+let _cloudcome_utils_core_qs = require("@cloudcome/utils-core/qs");
 //#region src/cloud/error.ts
 function createCloudObjectError(message, code) {
 	return (0, _cloudcome_utils_core_error.errorAssign)(new Error(message), {
@@ -183,10 +184,58 @@ async function _parseAppendUser(objectThis, uniIdCommonModule) {
 	return appendUser;
 }
 //#endregion
+//#region src/cloud/request.ts
+/**
+* 发起 HTTP 请求
+*
+* 基于 uniCloud.httpclient 发起 HTTP 请求，支持 GET、POST、PUT、DELETE 等方法。
+* 查询参数会自动通过 qsStringify 拼接到 URL 上。
+*
+* @template T - 响应数据的类型
+* @param options 请求配置选项
+* @returns 包含 data、status、headers 的响应对象
+*
+* @example
+* ```ts
+* // GET 请求
+* const res = await request<{ name: string }>({
+*   url: 'https://api.example.com/users/1',
+* })
+* console.log(res.data) // { name: 'Alice' }
+* console.log(res.status) // 200
+*
+* // POST 请求
+* const res = await request<{ id: string }>({
+*   url: 'https://api.example.com/users',
+*   method: 'POST',
+*   data: { name: 'Alice', age: 25 },
+* })
+*
+* // 带查询参数
+* const res = await request<{ list: any[] }>({
+*   url: 'https://api.example.com/users',
+*   query: { page: '1', size: '10' },
+* })
+* ```
+*/
+async function request(options) {
+	const { url, query = {}, method = "GET", headers = {}, data, dataType = "json", contentType = "json", timeout = 1e4 } = options;
+	const fullUrl = `${url}?${(0, _cloudcome_utils_core_qs.qsStringify)(query)}`;
+	return await uniCloud.httpclient.request(fullUrl, {
+		method,
+		headers,
+		data,
+		dataType,
+		contentType,
+		timeout
+	});
+}
+//#endregion
 exports.buildCloudMethodCreator = buildCloudMethodCreator;
 exports.createCloudObjectError = createCloudObjectError;
 exports.parseCloudMethodOutput = require__helpers.parseCloudMethodOutput;
 exports.parseCloudModuleOutput = parseCloudModuleOutput;
+exports.request = request;
 exports.respondCloudMethod = respondCloudMethod;
 //# sourceMappingURL=cloud.cjs.map

package/dist/cloud.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cloud.cjs","names":[],"sources":["../src/cloud/error.ts","../src/cloud/module.ts","../src/cloud/respond.ts","../src/cloud/method.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\n\nexport function createCloudObjectError(\n message: string,\n code?: number \| string,\n) {\n return errorAssign(new Error(message), {\n errCode: code,\n errMsg: message,\n });\n}\n","import { objectOmit } from '@cloudcome/utils-core/object';\nimport { createCloudObjectError } from './error';\nimport type { CloudModuleOutput } from './types';\n\n/*\n 解析云模块输出结果\n \n 该函数用于处理云模块的输出，如果输出中包含错误码，则抛出相应的错误；\n * 否则返回去除错误码和错误信息后的数据部分。\n \n @template O - 输出数据的类型\n * @param output - 云模块的输出结果，包含errCode、errMsg和数据部分\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 返回去除errCode和errMsg字段后的数据对象\n * @throws {CloudObjectError} 当output中存在errCode时抛出包含错误码和错误信息的异常\n \n @example\n * // 成功情况\n * const result = parseCloudModuleOutput({ value: 'success', errCode: 0, errMsg: '' });\n * // 返回: { value: 'success' }\n \n @example\n * // 错误情况\n * try {\n * parseCloudModuleOutput({ errCode: 404, errMsg: 'Not Found' });\n * } catch (error) {\n * // 抛出错误: CloudObjectError('Not Found', 404)\n * }\n /\nexport function parseCloudModuleOutput<O>(\n output: CloudModuleOutput<O>,\n fallbackErrorMessage = '',\n): Omit<O, 'errCode' \| 'errMsg'> {\n if (output.errCode) {\n throw createCloudObjectError(\n output.errMsg \|\| fallbackErrorMessage,\n output.errCode,\n );\n }\n return objectOmit(output, ['errCode', 'errMsg']);\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { UniError } from '@/_types';\nimport type { CloudMethodOutput } from './types';\n\n/\n 执行云对象方法并标准化响应格式\n \n @template O - 函数返回值的类型\n * @param fn - 要执行的异步函数\n * @param append - 要附加到响应中的额外数据\n * @returns 标准化的云对象响应对象\n \n @example\n * ```typescript\n * const result = await respondCloudMethod(async () => {\n * return await getData();\n * }, { extra: 'data' });\n * ```\n /\nexport async function respondCloudMethod<O>(\n fn: () => MaybePromise<O>,\n append?: AnyObject,\n): Promise<CloudMethodOutput<O>> {\n try {\n const data = await fn();\n\n return {\n errCode: 0,\n errMsg: '',\n data,\n ...append,\n };\n } catch (err) {\n console.error('respondCloudObject error');\n console.error(err);\n\n const err2 = errorNormalize(err as UniError);\n\n return {\n errCode: err2.errCode \|\| -1,\n errMsg: err2.errMsg \|\| err2.message \|\| '',\n // @ts-expect-error\n data: null,\n ...append,\n };\n }\n}\n","import { objectDefaults } from '@cloudcome/utils-core/object';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport { versionCompare } from '@cloudcome/utils-core/version';\nimport type z from 'zod';\nimport type { ZodObject } from 'zod';\nimport { createCloudObjectError } from './error';\nimport { parseCloudModuleOutput } from './module';\nimport { respondCloudMethod } from './respond';\nimport type { CloudMethod, CloudObjectThis } from './types';\nimport type { UniIdCommonModule } from './uni-id';\n\ntype _CloudObjectThisAppendUser = {\n id: string;\n role: string[];\n permission: string[];\n isAdmin: boolean;\n};\n\ntype _CloudObjectThisAppend = {\n options: Required<CreateCloudObjectOptions>;\n user: _CloudObjectThisAppendUser;\n};\n\nexport type CloudObjectContext = CloudObjectThis & _CloudObjectThisAppend;\n\nexport type BuildCloudMethodCreatorOptions = {\n /\n UniId 通用模块\n * 用于处理用户身份验证和权限管理\n * 如果提供，将在云对象执行前验证用户身份\n /\n uniIdCommonModule?: UniIdCommonModule;\n\n /\n 需要用户登录态的错误码\n * @default 'uni-id-check-token-failed'\n /\n requiredUserErrCode?: number \| string;\n\n /\n 需要用户登录态的错误消息\n * @default '需要登录后才能进行此操作'\n /\n requiredUserErrMsg?: string;\n\n /\n 仅允许本地环境运行的错误消息\n * @default '运行环境不匹配'\n /\n onlyLocalEnvErrMsg?: string;\n\n /\n 版本不匹配错误消息\n * @default '应用版本过低'\n /\n appVersionTooLowErrMsg?: string;\n\n /\n 应用版本过高错误消息\n * @default '应用版本过高'\n /\n appVersionTooHighErrMsg?: string;\n\n /\n 响应附加数据函数\n * 用于在云对象响应中添加额外的上下文信息\n * @param objectThis 云对象上下文\n * @returns 返回要附加到响应中的数据对象\n /\n respondAppend?: (objectThis: CloudObjectThis) => AnyObject;\n\n /\n 所有云对象执行前钩子函数\n * @param context 云对象上下文，包含用户信息、选项等\n /\n onBefore?: (context: CloudObjectContext) => MaybePromise<unknown>;\n};\n\nexport type CreateCloudObjectOptions = {\n /\n 是否需要用户登录态\n * @default false\n /\n requiredUser?: boolean;\n\n /\n 是否仅在本地环境运行\n * @default false\n /\n onlyLocalEnv?: boolean;\n\n /\n 最小支持版本\n /\n minVersion?: string;\n\n /\n 最大支持版本\n /\n maxVersion?: string;\n\n /\n 非响应模式，常用于钩子函数中，如 _before, _after 等，\n * 文档：https://doc.dcloud.net.cn/uniCloud/cloud-obj.html#before-and-after\n /\n noRespond?: boolean;\n};\n\n/\n 云对象方法创建器类型定义\n \n 用于定义云对象方法的创建函数类型，支持两种重载形式：\n * 1. 带输入验证的版本：接收schema、处理函数和选项\n * 2. 无输入参数的版本：仅接收处理函数和选项\n /\nexport type CreateCloudMethod = {\n /\n 带输入验证的云对象方法创建器\n * @template S - Zod验证模式类型\n * @template O - 返回值类型\n * @param schema - Zod验证模式，用于验证输入数据\n * @param fn - 业务逻辑处理函数，接收上下文和验证后的输入数据\n * @param options - 云对象创建选项\n * @returns 云对象方法函数\n /\n <S extends ZodObject, O>(\n schema: S,\n fn: (context: CloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n options?: CreateCloudObjectOptions,\n ): CloudMethod<z.infer<S>, O>;\n\n /\n 无输入参数的云对象方法创建器\n * @template O - 返回值类型\n * @param fn - 业务逻辑处理函数，仅接收上下文\n * @param options - 云对象创建选项\n * @returns 云对象方法函数\n /\n <O>(\n fn: (context: CloudObjectContext) => MaybePromise<O>,\n options?: CreateCloudObjectOptions,\n ): CloudMethod<void, O>;\n};\n\n/\n 构建云对象方法创建器\n \n 该函数用于创建云对象方法的工厂函数，支持输入验证、用户身份验证、环境检查等功能。\n * 返回的创建器函数可以根据不同的配置创建云对象方法。\n \n @param options 构建选项，用于配置云对象方法创建器的行为\n * @returns 返回一个云对象方法创建器函数\n \n @example\n * // 创建一个需要用户登录的云对象方法\n * const createMethod = buildCloudMethodCreator({ uniIdCommonModule });\n * const myMethod = createMethod(async (context) => {\n * return { message: 'Hello ' + context.user.id };\n * }, { requiredUser: true });\n /\nexport function buildCloudMethodCreator(\n options?: BuildCloudMethodCreatorOptions,\n) {\n const buildOptions = objectDefaults(options \|\| {}, {\n requiredUserErrCode: 'uni-id-check-token-failed',\n requiredUserErrMsg: '需要登录后才能进行此操作',\n onlyLocalEnvErrMsg: '运行环境不匹配',\n appVersionTooLowErrMsg: '应用版本过低',\n appVersionTooHighErrMsg: '应用版本过高',\n respondAppend: () => ({}),\n onBefore: () => {},\n }) as Required<BuildCloudMethodCreatorOptions>;\n\n // @ts-expect-error\n const createCloudMethod: CreateCloudMethod = (arg0, arg1, arg2) => {\n // 确定选项来源：如果arg0是函数，则选项在arg1；否则在arg2\n const optionsSource = (isFunction(arg0) ? arg1 : arg2) as\n \| CreateCloudObjectOptions\n \| undefined;\n\n // 设置默认选项值\n const createOptions = objectDefaults(optionsSource \|\| {}, {\n requiredUser: false,\n onlyLocalEnv: false,\n }) as Required<CreateCloudObjectOptions>;\n\n return async function (input) {\n const cloudMethod = async () => {\n const { runtimeEnv } = this.getCloudInfo();\n\n if (createOptions.onlyLocalEnv && runtimeEnv !== 'local') {\n throw createCloudObjectError(buildOptions.onlyLocalEnvErrMsg);\n }\n\n const { appVersion } = this.getClientInfo();\n\n if (\n createOptions.minVersion &&\n versionCompare(appVersion, createOptions.minVersion) < 0\n ) {\n throw createCloudObjectError(buildOptions.appVersionTooLowErrMsg);\n }\n\n if (\n createOptions.maxVersion &&\n versionCompare(appVersion, createOptions.maxVersion) > 0\n ) {\n throw createCloudObjectError(buildOptions.appVersionTooHighErrMsg);\n }\n\n // 构建附加的上下文信息，包括用户身份和权限信息\n const user = await _parseAppendUser(this, options?.uniIdCommonModule);\n const append: _CloudObjectThisAppend = {\n options: createOptions,\n user: user,\n };\n const context = Object.assign(this, append) as CloudObjectContext;\n\n // 如果需要用户登录态但用户未登录，则抛出错误\n if (createOptions.requiredUser && !user.id) {\n throw createCloudObjectError(\n buildOptions.requiredUserErrMsg,\n buildOptions.requiredUserErrCode,\n );\n }\n\n // 执行前钩子函数\n await buildOptions.onBefore(context);\n\n // 无入参函数调用\n if (isFunction(arg0)) {\n return await arg0(context);\n }\n\n // 有入参函数调用 - 验证输入数据\n const parsed = arg0.safeParse(input);\n\n // 输入验证失败处理\n if (!parsed.success) {\n console.log(parsed.error.issues);\n\n const issue0 = parsed.error?.issues?.[0];\n\n // 处理自定义验证错误\n if (issue0?.code === 'custom') throw issue0.message;\n throw new Error('请求数据不正确');\n }\n\n // 执行业务逻辑函数，传入上下文和验证后的数据\n return await arg1(context, parsed.data);\n };\n\n // 如果设置了非响应模式，则直接执行方法，不返回响应\n if (createOptions.noRespond) {\n return await cloudMethod();\n }\n\n // 处理云对象方法响应逻辑，包括错误捕获和统一响应格式\n return await respondCloudMethod(\n cloudMethod,\n buildOptions.respondAppend(this),\n );\n };\n };\n\n return createCloudMethod;\n}\n\n/\n 解析并附加用户信息到云对象上下文\n \n 该函数用于验证用户身份并获取用户权限信息，将结果附加到云对象上下文中的user字段\n * 如果未提供uniIdCommonModule或验证失败，则返回默认的空用户信息\n \n @param objectThis 云对象上下文，包含客户端信息和token等\n * @param uniIdCommonModule 可选的UniId通用模块实例，用于验证用户token\n * @returns 返回包含用户ID、角色、权限等信息的对象\n \n @example\n * // 成功验证用户身份\n * const user = await _parseAppendUser(this, uniIdModule);\n * // 返回: { id: 'user123', role: ['user'], permission: ['read'], isAdmin: false }\n \n @example\n * // 验证失败或未提供模块\n * const user = await _parseAppendUser(this);\n * // 返回: { id: '', role: [], permission: [], isAdmin: false }\n */\nasync function _parseAppendUser(\n objectThis: CloudObjectThis,\n uniIdCommonModule?: UniIdCommonModule,\n): Promise<_CloudObjectThisAppendUser> {\n const appendUser: _CloudObjectThisAppendUser = {\n id: '',\n role: [],\n permission: [],\n isAdmin: false,\n };\n\n if (!uniIdCommonModule) return appendUser;\n\n const uic = uniIdCommonModule.createInstance({\n clientInfo: objectThis.getClientInfo(),\n });\n\n // 验证用户token，忽略验证过程中的错误\n const [_err1, user] = await tryFlatten(\n uic.checkToken(objectThis.getUniIdToken() \|\| ''),\n );\n if (!user) return appendUser;\n\n // 解析验证结果，忽略解析过程中的错误\n const [_err2, userData] = tryFlatten(() => parseCloudModuleOutput(user));\n if (!userData) return appendUser;\n\n appendUser.id = userData.uid \|\| '';\n appendUser.role = userData.role \|\| [];\n appendUser.permission = userData.permission \|\| [];\n appendUser.isAdmin =\n appendUser.role.includes('admin') && appendUser.permission.length === 0;\n\n return appendUser;\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"cloud.cjs","names":[],"sources":["../src/cloud/error.ts","../src/cloud/module.ts","../src/cloud/respond.ts","../src/cloud/method.ts","../src/cloud/request.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\n\nexport function createCloudObjectError(\n message: string,\n code?: number \| string,\n) {\n return errorAssign(new Error(message), {\n errCode: code,\n errMsg: message,\n });\n}\n","import { objectOmit } from '@cloudcome/utils-core/object';\nimport { createCloudObjectError } from './error';\nimport type { CloudModuleOutput } from './types';\n\n/*\n 解析云模块输出结果\n \n 该函数用于处理云模块的输出，如果输出中包含错误码，则抛出相应的错误；\n * 否则返回去除错误码和错误信息后的数据部分。\n \n @template O - 输出数据的类型\n * @param output - 云模块的输出结果，包含errCode、errMsg和数据部分\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 返回去除errCode和errMsg字段后的数据对象\n * @throws {CloudObjectError} 当output中存在errCode时抛出包含错误码和错误信息的异常\n \n @example\n * // 成功情况\n * const result = parseCloudModuleOutput({ value: 'success', errCode: 0, errMsg: '' });\n * // 返回: { value: 'success' }\n \n @example\n * // 错误情况\n * try {\n * parseCloudModuleOutput({ errCode: 404, errMsg: 'Not Found' });\n * } catch (error) {\n * // 抛出错误: CloudObjectError('Not Found', 404)\n * }\n /\nexport function parseCloudModuleOutput<O>(\n output: CloudModuleOutput<O>,\n fallbackErrorMessage = '',\n): Omit<O, 'errCode' \| 'errMsg'> {\n if (output.errCode) {\n throw createCloudObjectError(\n output.errMsg \|\| fallbackErrorMessage,\n output.errCode,\n );\n }\n return objectOmit(output, ['errCode', 'errMsg']);\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { UniError } from '@/_types';\nimport type { CloudMethodOutput } from './types';\n\n/\n 执行云对象方法并标准化响应格式\n \n @template O - 函数返回值的类型\n * @param fn - 要执行的异步函数\n * @param append - 要附加到响应中的额外数据\n * @returns 标准化的云对象响应对象\n \n @example\n * ```typescript\n * const result = await respondCloudMethod(async () => {\n * return await getData();\n * }, { extra: 'data' });\n * ```\n /\nexport async function respondCloudMethod<O>(\n fn: () => MaybePromise<O>,\n append?: AnyObject,\n): Promise<CloudMethodOutput<O>> {\n try {\n const data = await fn();\n\n return {\n errCode: 0,\n errMsg: '',\n data,\n ...append,\n };\n } catch (err) {\n console.error('respondCloudObject error');\n console.error(err);\n\n const err2 = errorNormalize(err as UniError);\n\n return {\n errCode: err2.errCode \|\| -1,\n errMsg: err2.errMsg \|\| err2.message \|\| '',\n // @ts-expect-error\n data: null,\n ...append,\n };\n }\n}\n","import { objectDefaults } from '@cloudcome/utils-core/object';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport { versionCompare } from '@cloudcome/utils-core/version';\nimport type z from 'zod';\nimport type { ZodObject } from 'zod';\nimport { createCloudObjectError } from './error';\nimport { parseCloudModuleOutput } from './module';\nimport { respondCloudMethod } from './respond';\nimport type { CloudMethod, CloudObjectThis } from './types';\nimport type { UniIdCommonModule } from './uni-id';\n\ntype _CloudObjectThisAppendUser = {\n id: string;\n role: string[];\n permission: string[];\n isAdmin: boolean;\n};\n\ntype _CloudObjectThisAppend = {\n options: Required<CreateCloudObjectOptions>;\n user: _CloudObjectThisAppendUser;\n};\n\nexport type CloudObjectContext = CloudObjectThis & _CloudObjectThisAppend;\n\nexport type BuildCloudMethodCreatorOptions = {\n /\n UniId 通用模块\n * 用于处理用户身份验证和权限管理\n * 如果提供，将在云对象执行前验证用户身份\n /\n uniIdCommonModule?: UniIdCommonModule;\n\n /\n 需要用户登录态的错误码\n * @default 'uni-id-check-token-failed'\n /\n requiredUserErrCode?: number \| string;\n\n /\n 需要用户登录态的错误消息\n * @default '需要登录后才能进行此操作'\n /\n requiredUserErrMsg?: string;\n\n /\n 仅允许本地环境运行的错误消息\n * @default '运行环境不匹配'\n /\n onlyLocalEnvErrMsg?: string;\n\n /\n 版本不匹配错误消息\n * @default '应用版本过低'\n /\n appVersionTooLowErrMsg?: string;\n\n /\n 应用版本过高错误消息\n * @default '应用版本过高'\n /\n appVersionTooHighErrMsg?: string;\n\n /\n 响应附加数据函数\n * 用于在云对象响应中添加额外的上下文信息\n * @param objectThis 云对象上下文\n * @returns 返回要附加到响应中的数据对象\n /\n respondAppend?: (objectThis: CloudObjectThis) => AnyObject;\n\n /\n 所有云对象执行前钩子函数\n * @param context 云对象上下文，包含用户信息、选项等\n /\n onBefore?: (context: CloudObjectContext) => MaybePromise<unknown>;\n};\n\nexport type CreateCloudObjectOptions = {\n /\n 是否需要用户登录态\n * @default false\n /\n requiredUser?: boolean;\n\n /\n 是否仅在本地环境运行\n * @default false\n /\n onlyLocalEnv?: boolean;\n\n /\n 最小支持版本\n /\n minVersion?: string;\n\n /\n 最大支持版本\n /\n maxVersion?: string;\n\n /\n 非响应模式，常用于钩子函数中，如 _before, _after 等，\n * 文档：https://doc.dcloud.net.cn/uniCloud/cloud-obj.html#before-and-after\n /\n noRespond?: boolean;\n};\n\n/\n 云对象方法创建器类型定义\n \n 用于定义云对象方法的创建函数类型，支持两种重载形式：\n * 1. 带输入验证的版本：接收schema、处理函数和选项\n * 2. 无输入参数的版本：仅接收处理函数和选项\n /\nexport type CreateCloudMethod = {\n /\n 带输入验证的云对象方法创建器\n * @template S - Zod验证模式类型\n * @template O - 返回值类型\n * @param schema - Zod验证模式，用于验证输入数据\n * @param fn - 业务逻辑处理函数，接收上下文和验证后的输入数据\n * @param options - 云对象创建选项\n * @returns 云对象方法函数\n /\n <S extends ZodObject, O>(\n schema: S,\n fn: (context: CloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n options?: CreateCloudObjectOptions,\n ): CloudMethod<z.infer<S>, O>;\n\n /\n 无输入参数的云对象方法创建器\n * @template O - 返回值类型\n * @param fn - 业务逻辑处理函数，仅接收上下文\n * @param options - 云对象创建选项\n * @returns 云对象方法函数\n /\n <O>(\n fn: (context: CloudObjectContext) => MaybePromise<O>,\n options?: CreateCloudObjectOptions,\n ): CloudMethod<void, O>;\n};\n\n/\n 构建云对象方法创建器\n \n 该函数用于创建云对象方法的工厂函数，支持输入验证、用户身份验证、环境检查等功能。\n * 返回的创建器函数可以根据不同的配置创建云对象方法。\n \n @param options 构建选项，用于配置云对象方法创建器的行为\n * @returns 返回一个云对象方法创建器函数\n \n @example\n * // 创建一个需要用户登录的云对象方法\n * const createMethod = buildCloudMethodCreator({ uniIdCommonModule });\n * const myMethod = createMethod(async (context) => {\n * return { message: 'Hello ' + context.user.id };\n * }, { requiredUser: true });\n /\nexport function buildCloudMethodCreator(\n options?: BuildCloudMethodCreatorOptions,\n) {\n const buildOptions = objectDefaults(options \|\| {}, {\n requiredUserErrCode: 'uni-id-check-token-failed',\n requiredUserErrMsg: '需要登录后才能进行此操作',\n onlyLocalEnvErrMsg: '运行环境不匹配',\n appVersionTooLowErrMsg: '应用版本过低',\n appVersionTooHighErrMsg: '应用版本过高',\n respondAppend: () => ({}),\n onBefore: () => {},\n }) as Required<BuildCloudMethodCreatorOptions>;\n\n // @ts-expect-error\n const createCloudMethod: CreateCloudMethod = (arg0, arg1, arg2) => {\n // 确定选项来源：如果arg0是函数，则选项在arg1；否则在arg2\n const optionsSource = (isFunction(arg0) ? arg1 : arg2) as\n \| CreateCloudObjectOptions\n \| undefined;\n\n // 设置默认选项值\n const createOptions = objectDefaults(optionsSource \|\| {}, {\n requiredUser: false,\n onlyLocalEnv: false,\n }) as Required<CreateCloudObjectOptions>;\n\n return async function (input) {\n const cloudMethod = async () => {\n const { runtimeEnv } = this.getCloudInfo();\n\n if (createOptions.onlyLocalEnv && runtimeEnv !== 'local') {\n throw createCloudObjectError(buildOptions.onlyLocalEnvErrMsg);\n }\n\n const { appVersion } = this.getClientInfo();\n\n if (\n createOptions.minVersion &&\n versionCompare(appVersion, createOptions.minVersion) < 0\n ) {\n throw createCloudObjectError(buildOptions.appVersionTooLowErrMsg);\n }\n\n if (\n createOptions.maxVersion &&\n versionCompare(appVersion, createOptions.maxVersion) > 0\n ) {\n throw createCloudObjectError(buildOptions.appVersionTooHighErrMsg);\n }\n\n // 构建附加的上下文信息，包括用户身份和权限信息\n const user = await _parseAppendUser(this, options?.uniIdCommonModule);\n const append: _CloudObjectThisAppend = {\n options: createOptions,\n user: user,\n };\n const context = Object.assign(this, append) as CloudObjectContext;\n\n // 如果需要用户登录态但用户未登录，则抛出错误\n if (createOptions.requiredUser && !user.id) {\n throw createCloudObjectError(\n buildOptions.requiredUserErrMsg,\n buildOptions.requiredUserErrCode,\n );\n }\n\n // 执行前钩子函数\n await buildOptions.onBefore(context);\n\n // 无入参函数调用\n if (isFunction(arg0)) {\n return await arg0(context);\n }\n\n // 有入参函数调用 - 验证输入数据\n const parsed = arg0.safeParse(input);\n\n // 输入验证失败处理\n if (!parsed.success) {\n console.log(parsed.error.issues);\n\n const issue0 = parsed.error?.issues?.[0];\n\n // 处理自定义验证错误\n if (issue0?.code === 'custom') throw issue0.message;\n throw new Error('请求数据不正确');\n }\n\n // 执行业务逻辑函数，传入上下文和验证后的数据\n return await arg1(context, parsed.data);\n };\n\n // 如果设置了非响应模式，则直接执行方法，不返回响应\n if (createOptions.noRespond) {\n return await cloudMethod();\n }\n\n // 处理云对象方法响应逻辑，包括错误捕获和统一响应格式\n return await respondCloudMethod(\n cloudMethod,\n buildOptions.respondAppend(this),\n );\n };\n };\n\n return createCloudMethod;\n}\n\n/\n 解析并附加用户信息到云对象上下文\n \n 该函数用于验证用户身份并获取用户权限信息，将结果附加到云对象上下文中的user字段\n * 如果未提供uniIdCommonModule或验证失败，则返回默认的空用户信息\n \n @param objectThis 云对象上下文，包含客户端信息和token等\n * @param uniIdCommonModule 可选的UniId通用模块实例，用于验证用户token\n * @returns 返回包含用户ID、角色、权限等信息的对象\n \n @example\n * // 成功验证用户身份\n * const user = await _parseAppendUser(this, uniIdModule);\n * // 返回: { id: 'user123', role: ['user'], permission: ['read'], isAdmin: false }\n \n @example\n * // 验证失败或未提供模块\n * const user = await _parseAppendUser(this);\n * // 返回: { id: '', role: [], permission: [], isAdmin: false }\n /\nasync function _parseAppendUser(\n objectThis: CloudObjectThis,\n uniIdCommonModule?: UniIdCommonModule,\n): Promise<_CloudObjectThisAppendUser> {\n const appendUser: _CloudObjectThisAppendUser = {\n id: '',\n role: [],\n permission: [],\n isAdmin: false,\n };\n\n if (!uniIdCommonModule) return appendUser;\n\n const uic = uniIdCommonModule.createInstance({\n clientInfo: objectThis.getClientInfo(),\n });\n\n // 验证用户token，忽略验证过程中的错误\n const [_err1, user] = await tryFlatten(\n uic.checkToken(objectThis.getUniIdToken() \|\| ''),\n );\n if (!user) return appendUser;\n\n // 解析验证结果，忽略解析过程中的错误\n const [_err2, userData] = tryFlatten(() => parseCloudModuleOutput(user));\n if (!userData) return appendUser;\n\n appendUser.id = userData.uid \|\| '';\n appendUser.role = userData.role \|\| [];\n appendUser.permission = userData.permission \|\| [];\n appendUser.isAdmin =\n appendUser.role.includes('admin') && appendUser.permission.length === 0;\n\n return appendUser;\n}\n","import { qsStringify } from '@cloudcome/utils-core/qs';\nimport type { AnyObject } from '@cloudcome/utils-core/types';\n\n/\n HTTP 请求配置选项\n /\nexport type RequestOptions = {\n /\n 请求 URL 地址\n /\n url: string;\n\n /\n URL 查询参数，会自动拼接到 url 后面\n /\n query?: Record<string, string>;\n\n /\n HTTP 请求方法\n * @default 'GET'\n /\n method?: 'GET' \| 'POST' \| 'PUT' \| 'DELETE' \| 'HEAD' \| 'OPTIONS';\n\n /\n 请求头\n /\n headers?: Record<string, string>;\n\n /\n 请求体数据\n /\n data?: AnyObject;\n\n /\n 返回数据格式\n * @default 'json'\n /\n dataType?: string;\n\n /\n 请求内容类型\n * - 'json': application/json\n * - 'form': application/x-www-form-urlencoded\n * @default 'json'\n /\n contentType?: string;\n\n /\n 请求超时时间，单位毫秒\n * @default 10000\n /\n timeout?: number;\n};\n\n/\n 发起 HTTP 请求\n \n 基于 uniCloud.httpclient 发起 HTTP 请求，支持 GET、POST、PUT、DELETE 等方法。\n * 查询参数会自动通过 qsStringify 拼接到 URL 上。\n \n @template T - 响应数据的类型\n * @param options 请求配置选项\n * @returns 包含 data、status、headers 的响应对象\n \n @example\n * ```ts\n * // GET 请求\n * const res = await request<{ name: string }>({\n * url: 'https://api.example.com/users/1',\n * })\n * console.log(res.data) // { name: 'Alice' }\n * console.log(res.status) // 200\n \n // POST 请求\n * const res = await request<{ id: string }>({\n * url: 'https://api.example.com/users',\n * method: 'POST',\n * data: { name: 'Alice', age: 25 },\n * })\n \n // 带查询参数\n * const res = await request<{ list: any[] }>({\n * url: 'https://api.example.com/users',\n * query: { page: '1', size: '10' },\n * })\n * ```\n */\nexport async function request<T>(options: RequestOptions) {\n const {\n url,\n query = {},\n method = 'GET',\n headers = {},\n data,\n dataType = 'json',\n contentType = 'json',\n timeout = 10000,\n } = options;\n\n const fullUrl = `${url}?${qsStringify(query)}`;\n\n // 使用uniCloud.httpclient发起请求\n // @ts-expect-error: uniCloud类型定义中可能缺少httpclient属性\n const res = await uniCloud.httpclient.request(fullUrl, {\n method,\n headers,\n data,\n dataType,\n contentType,\n timeout,\n });\n\n return res as { data: T; status: number; headers: Record<string, string> };\n}\n"],"mappings":"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"}

package/dist/cloud.d.ts CHANGED Viewed

@@ -3,6 +3,7 @@ export type { UniError } from './_types';
 export * from './cloud/error';
 export * from './cloud/method';
 export * from './cloud/module';
+export * from './cloud/request';
 export * from './cloud/respond';
 export * from './cloud/types';
 export * from './cloud/uni-id';

package/dist/cloud.mjs CHANGED Viewed

@@ -4,6 +4,7 @@ import { errorAssign, errorNormalize } from "@cloudcome/utils-core/error";
 import { objectDefaults, objectOmit } from "@cloudcome/utils-core/object";
 import { tryFlatten } from "@cloudcome/utils-core/try";
 import { versionCompare } from "@cloudcome/utils-core/version";
+import { qsStringify } from "@cloudcome/utils-core/qs";
 //#region src/cloud/error.ts
 function createCloudObjectError(message, code) {
 	return errorAssign(new Error(message), {
@@ -182,6 +183,53 @@ async function _parseAppendUser(objectThis, uniIdCommonModule) {
 	return appendUser;
 }
 //#endregion
-export { buildCloudMethodCreator, createCloudObjectError, parseCloudMethodOutput, parseCloudModuleOutput, respondCloudMethod };
+//#region src/cloud/request.ts
+/**
+* 发起 HTTP 请求
+*
+* 基于 uniCloud.httpclient 发起 HTTP 请求，支持 GET、POST、PUT、DELETE 等方法。
+* 查询参数会自动通过 qsStringify 拼接到 URL 上。
+*
+* @template T - 响应数据的类型
+* @param options 请求配置选项
+* @returns 包含 data、status、headers 的响应对象
+*
+* @example
+* ```ts
+* // GET 请求
+* const res = await request<{ name: string }>({
+*   url: 'https://api.example.com/users/1',
+* })
+* console.log(res.data) // { name: 'Alice' }
+* console.log(res.status) // 200
+*
+* // POST 请求
+* const res = await request<{ id: string }>({
+*   url: 'https://api.example.com/users',
+*   method: 'POST',
+*   data: { name: 'Alice', age: 25 },
+* })
+*
+* // 带查询参数
+* const res = await request<{ list: any[] }>({
+*   url: 'https://api.example.com/users',
+*   query: { page: '1', size: '10' },
+* })
+* ```
+*/
+async function request(options) {
+	const { url, query = {}, method = "GET", headers = {}, data, dataType = "json", contentType = "json", timeout = 1e4 } = options;
+	const fullUrl = `${url}?${qsStringify(query)}`;
+	return await uniCloud.httpclient.request(fullUrl, {
+		method,
+		headers,
+		data,
+		dataType,
+		contentType,
+		timeout
+	});
+}
+//#endregion
+export { buildCloudMethodCreator, createCloudObjectError, parseCloudMethodOutput, parseCloudModuleOutput, request, respondCloudMethod };
 //# sourceMappingURL=cloud.mjs.map

package/dist/cloud.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cloud.mjs","names":[],"sources":["../src/cloud/error.ts","../src/cloud/module.ts","../src/cloud/respond.ts","../src/cloud/method.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\n\nexport function createCloudObjectError(\n message: string,\n code?: number \| string,\n) {\n return errorAssign(new Error(message), {\n errCode: code,\n errMsg: message,\n });\n}\n","import { objectOmit } from '@cloudcome/utils-core/object';\nimport { createCloudObjectError } from './error';\nimport type { CloudModuleOutput } from './types';\n\n/*\n 解析云模块输出结果\n \n 该函数用于处理云模块的输出，如果输出中包含错误码，则抛出相应的错误；\n * 否则返回去除错误码和错误信息后的数据部分。\n \n @template O - 输出数据的类型\n * @param output - 云模块的输出结果，包含errCode、errMsg和数据部分\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 返回去除errCode和errMsg字段后的数据对象\n * @throws {CloudObjectError} 当output中存在errCode时抛出包含错误码和错误信息的异常\n \n @example\n * // 成功情况\n * const result = parseCloudModuleOutput({ value: 'success', errCode: 0, errMsg: '' });\n * // 返回: { value: 'success' }\n \n @example\n * // 错误情况\n * try {\n * parseCloudModuleOutput({ errCode: 404, errMsg: 'Not Found' });\n * } catch (error) {\n * // 抛出错误: CloudObjectError('Not Found', 404)\n * }\n /\nexport function parseCloudModuleOutput<O>(\n output: CloudModuleOutput<O>,\n fallbackErrorMessage = '',\n): Omit<O, 'errCode' \| 'errMsg'> {\n if (output.errCode) {\n throw createCloudObjectError(\n output.errMsg \|\| fallbackErrorMessage,\n output.errCode,\n );\n }\n return objectOmit(output, ['errCode', 'errMsg']);\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { UniError } from '@/_types';\nimport type { CloudMethodOutput } from './types';\n\n/\n 执行云对象方法并标准化响应格式\n \n @template O - 函数返回值的类型\n * @param fn - 要执行的异步函数\n * @param append - 要附加到响应中的额外数据\n * @returns 标准化的云对象响应对象\n \n @example\n * ```typescript\n * const result = await respondCloudMethod(async () => {\n * return await getData();\n * }, { extra: 'data' });\n * ```\n /\nexport async function respondCloudMethod<O>(\n fn: () => MaybePromise<O>,\n append?: AnyObject,\n): Promise<CloudMethodOutput<O>> {\n try {\n const data = await fn();\n\n return {\n errCode: 0,\n errMsg: '',\n data,\n ...append,\n };\n } catch (err) {\n console.error('respondCloudObject error');\n console.error(err);\n\n const err2 = errorNormalize(err as UniError);\n\n return {\n errCode: err2.errCode \|\| -1,\n errMsg: err2.errMsg \|\| err2.message \|\| '',\n // @ts-expect-error\n data: null,\n ...append,\n };\n }\n}\n","import { objectDefaults } from '@cloudcome/utils-core/object';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport { versionCompare } from '@cloudcome/utils-core/version';\nimport type z from 'zod';\nimport type { ZodObject } from 'zod';\nimport { createCloudObjectError } from './error';\nimport { parseCloudModuleOutput } from './module';\nimport { respondCloudMethod } from './respond';\nimport type { CloudMethod, CloudObjectThis } from './types';\nimport type { UniIdCommonModule } from './uni-id';\n\ntype _CloudObjectThisAppendUser = {\n id: string;\n role: string[];\n permission: string[];\n isAdmin: boolean;\n};\n\ntype _CloudObjectThisAppend = {\n options: Required<CreateCloudObjectOptions>;\n user: _CloudObjectThisAppendUser;\n};\n\nexport type CloudObjectContext = CloudObjectThis & _CloudObjectThisAppend;\n\nexport type BuildCloudMethodCreatorOptions = {\n /\n UniId 通用模块\n * 用于处理用户身份验证和权限管理\n * 如果提供，将在云对象执行前验证用户身份\n /\n uniIdCommonModule?: UniIdCommonModule;\n\n /\n 需要用户登录态的错误码\n * @default 'uni-id-check-token-failed'\n /\n requiredUserErrCode?: number \| string;\n\n /\n 需要用户登录态的错误消息\n * @default '需要登录后才能进行此操作'\n /\n requiredUserErrMsg?: string;\n\n /\n 仅允许本地环境运行的错误消息\n * @default '运行环境不匹配'\n /\n onlyLocalEnvErrMsg?: string;\n\n /\n 版本不匹配错误消息\n * @default '应用版本过低'\n /\n appVersionTooLowErrMsg?: string;\n\n /\n 应用版本过高错误消息\n * @default '应用版本过高'\n /\n appVersionTooHighErrMsg?: string;\n\n /\n 响应附加数据函数\n * 用于在云对象响应中添加额外的上下文信息\n * @param objectThis 云对象上下文\n * @returns 返回要附加到响应中的数据对象\n /\n respondAppend?: (objectThis: CloudObjectThis) => AnyObject;\n\n /\n 所有云对象执行前钩子函数\n * @param context 云对象上下文，包含用户信息、选项等\n /\n onBefore?: (context: CloudObjectContext) => MaybePromise<unknown>;\n};\n\nexport type CreateCloudObjectOptions = {\n /\n 是否需要用户登录态\n * @default false\n /\n requiredUser?: boolean;\n\n /\n 是否仅在本地环境运行\n * @default false\n /\n onlyLocalEnv?: boolean;\n\n /\n 最小支持版本\n /\n minVersion?: string;\n\n /\n 最大支持版本\n /\n maxVersion?: string;\n\n /\n 非响应模式，常用于钩子函数中，如 _before, _after 等，\n * 文档：https://doc.dcloud.net.cn/uniCloud/cloud-obj.html#before-and-after\n /\n noRespond?: boolean;\n};\n\n/\n 云对象方法创建器类型定义\n \n 用于定义云对象方法的创建函数类型，支持两种重载形式：\n * 1. 带输入验证的版本：接收schema、处理函数和选项\n * 2. 无输入参数的版本：仅接收处理函数和选项\n /\nexport type CreateCloudMethod = {\n /\n 带输入验证的云对象方法创建器\n * @template S - Zod验证模式类型\n * @template O - 返回值类型\n * @param schema - Zod验证模式，用于验证输入数据\n * @param fn - 业务逻辑处理函数，接收上下文和验证后的输入数据\n * @param options - 云对象创建选项\n * @returns 云对象方法函数\n /\n <S extends ZodObject, O>(\n schema: S,\n fn: (context: CloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n options?: CreateCloudObjectOptions,\n ): CloudMethod<z.infer<S>, O>;\n\n /\n 无输入参数的云对象方法创建器\n * @template O - 返回值类型\n * @param fn - 业务逻辑处理函数，仅接收上下文\n * @param options - 云对象创建选项\n * @returns 云对象方法函数\n /\n <O>(\n fn: (context: CloudObjectContext) => MaybePromise<O>,\n options?: CreateCloudObjectOptions,\n ): CloudMethod<void, O>;\n};\n\n/\n 构建云对象方法创建器\n \n 该函数用于创建云对象方法的工厂函数，支持输入验证、用户身份验证、环境检查等功能。\n * 返回的创建器函数可以根据不同的配置创建云对象方法。\n \n @param options 构建选项，用于配置云对象方法创建器的行为\n * @returns 返回一个云对象方法创建器函数\n \n @example\n * // 创建一个需要用户登录的云对象方法\n * const createMethod = buildCloudMethodCreator({ uniIdCommonModule });\n * const myMethod = createMethod(async (context) => {\n * return { message: 'Hello ' + context.user.id };\n * }, { requiredUser: true });\n /\nexport function buildCloudMethodCreator(\n options?: BuildCloudMethodCreatorOptions,\n) {\n const buildOptions = objectDefaults(options \|\| {}, {\n requiredUserErrCode: 'uni-id-check-token-failed',\n requiredUserErrMsg: '需要登录后才能进行此操作',\n onlyLocalEnvErrMsg: '运行环境不匹配',\n appVersionTooLowErrMsg: '应用版本过低',\n appVersionTooHighErrMsg: '应用版本过高',\n respondAppend: () => ({}),\n onBefore: () => {},\n }) as Required<BuildCloudMethodCreatorOptions>;\n\n // @ts-expect-error\n const createCloudMethod: CreateCloudMethod = (arg0, arg1, arg2) => {\n // 确定选项来源：如果arg0是函数，则选项在arg1；否则在arg2\n const optionsSource = (isFunction(arg0) ? arg1 : arg2) as\n \| CreateCloudObjectOptions\n \| undefined;\n\n // 设置默认选项值\n const createOptions = objectDefaults(optionsSource \|\| {}, {\n requiredUser: false,\n onlyLocalEnv: false,\n }) as Required<CreateCloudObjectOptions>;\n\n return async function (input) {\n const cloudMethod = async () => {\n const { runtimeEnv } = this.getCloudInfo();\n\n if (createOptions.onlyLocalEnv && runtimeEnv !== 'local') {\n throw createCloudObjectError(buildOptions.onlyLocalEnvErrMsg);\n }\n\n const { appVersion } = this.getClientInfo();\n\n if (\n createOptions.minVersion &&\n versionCompare(appVersion, createOptions.minVersion) < 0\n ) {\n throw createCloudObjectError(buildOptions.appVersionTooLowErrMsg);\n }\n\n if (\n createOptions.maxVersion &&\n versionCompare(appVersion, createOptions.maxVersion) > 0\n ) {\n throw createCloudObjectError(buildOptions.appVersionTooHighErrMsg);\n }\n\n // 构建附加的上下文信息，包括用户身份和权限信息\n const user = await _parseAppendUser(this, options?.uniIdCommonModule);\n const append: _CloudObjectThisAppend = {\n options: createOptions,\n user: user,\n };\n const context = Object.assign(this, append) as CloudObjectContext;\n\n // 如果需要用户登录态但用户未登录，则抛出错误\n if (createOptions.requiredUser && !user.id) {\n throw createCloudObjectError(\n buildOptions.requiredUserErrMsg,\n buildOptions.requiredUserErrCode,\n );\n }\n\n // 执行前钩子函数\n await buildOptions.onBefore(context);\n\n // 无入参函数调用\n if (isFunction(arg0)) {\n return await arg0(context);\n }\n\n // 有入参函数调用 - 验证输入数据\n const parsed = arg0.safeParse(input);\n\n // 输入验证失败处理\n if (!parsed.success) {\n console.log(parsed.error.issues);\n\n const issue0 = parsed.error?.issues?.[0];\n\n // 处理自定义验证错误\n if (issue0?.code === 'custom') throw issue0.message;\n throw new Error('请求数据不正确');\n }\n\n // 执行业务逻辑函数，传入上下文和验证后的数据\n return await arg1(context, parsed.data);\n };\n\n // 如果设置了非响应模式，则直接执行方法，不返回响应\n if (createOptions.noRespond) {\n return await cloudMethod();\n }\n\n // 处理云对象方法响应逻辑，包括错误捕获和统一响应格式\n return await respondCloudMethod(\n cloudMethod,\n buildOptions.respondAppend(this),\n );\n };\n };\n\n return createCloudMethod;\n}\n\n/\n 解析并附加用户信息到云对象上下文\n \n 该函数用于验证用户身份并获取用户权限信息，将结果附加到云对象上下文中的user字段\n * 如果未提供uniIdCommonModule或验证失败，则返回默认的空用户信息\n \n @param objectThis 云对象上下文，包含客户端信息和token等\n * @param uniIdCommonModule 可选的UniId通用模块实例，用于验证用户token\n * @returns 返回包含用户ID、角色、权限等信息的对象\n \n @example\n * // 成功验证用户身份\n * const user = await _parseAppendUser(this, uniIdModule);\n * // 返回: { id: 'user123', role: ['user'], permission: ['read'], isAdmin: false }\n \n @example\n * // 验证失败或未提供模块\n * const user = await _parseAppendUser(this);\n * // 返回: { id: '', role: [], permission: [], isAdmin: false }\n */\nasync function _parseAppendUser(\n objectThis: CloudObjectThis,\n uniIdCommonModule?: UniIdCommonModule,\n): Promise<_CloudObjectThisAppendUser> {\n const appendUser: _CloudObjectThisAppendUser = {\n id: '',\n role: [],\n permission: [],\n isAdmin: false,\n };\n\n if (!uniIdCommonModule) return appendUser;\n\n const uic = uniIdCommonModule.createInstance({\n clientInfo: objectThis.getClientInfo(),\n });\n\n // 验证用户token，忽略验证过程中的错误\n const [_err1, user] = await tryFlatten(\n uic.checkToken(objectThis.getUniIdToken() \|\| ''),\n );\n if (!user) return appendUser;\n\n // 解析验证结果，忽略解析过程中的错误\n const [_err2, userData] = tryFlatten(() => parseCloudModuleOutput(user));\n if (!userData) return appendUser;\n\n appendUser.id = userData.uid \|\| '';\n appendUser.role = userData.role \|\| [];\n appendUser.permission = userData.permission \|\| [];\n appendUser.isAdmin =\n appendUser.role.includes('admin') && appendUser.permission.length === 0;\n\n return appendUser;\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"cloud.mjs","names":[],"sources":["../src/cloud/error.ts","../src/cloud/module.ts","../src/cloud/respond.ts","../src/cloud/method.ts","../src/cloud/request.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\n\nexport function createCloudObjectError(\n message: string,\n code?: number \| string,\n) {\n return errorAssign(new Error(message), {\n errCode: code,\n errMsg: message,\n });\n}\n","import { objectOmit } from '@cloudcome/utils-core/object';\nimport { createCloudObjectError } from './error';\nimport type { CloudModuleOutput } from './types';\n\n/*\n 解析云模块输出结果\n \n 该函数用于处理云模块的输出，如果输出中包含错误码，则抛出相应的错误；\n * 否则返回去除错误码和错误信息后的数据部分。\n \n @template O - 输出数据的类型\n * @param output - 云模块的输出结果，包含errCode、errMsg和数据部分\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 返回去除errCode和errMsg字段后的数据对象\n * @throws {CloudObjectError} 当output中存在errCode时抛出包含错误码和错误信息的异常\n \n @example\n * // 成功情况\n * const result = parseCloudModuleOutput({ value: 'success', errCode: 0, errMsg: '' });\n * // 返回: { value: 'success' }\n \n @example\n * // 错误情况\n * try {\n * parseCloudModuleOutput({ errCode: 404, errMsg: 'Not Found' });\n * } catch (error) {\n * // 抛出错误: CloudObjectError('Not Found', 404)\n * }\n /\nexport function parseCloudModuleOutput<O>(\n output: CloudModuleOutput<O>,\n fallbackErrorMessage = '',\n): Omit<O, 'errCode' \| 'errMsg'> {\n if (output.errCode) {\n throw createCloudObjectError(\n output.errMsg \|\| fallbackErrorMessage,\n output.errCode,\n );\n }\n return objectOmit(output, ['errCode', 'errMsg']);\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { UniError } from '@/_types';\nimport type { CloudMethodOutput } from './types';\n\n/\n 执行云对象方法并标准化响应格式\n \n @template O - 函数返回值的类型\n * @param fn - 要执行的异步函数\n * @param append - 要附加到响应中的额外数据\n * @returns 标准化的云对象响应对象\n \n @example\n * ```typescript\n * const result = await respondCloudMethod(async () => {\n * return await getData();\n * }, { extra: 'data' });\n * ```\n /\nexport async function respondCloudMethod<O>(\n fn: () => MaybePromise<O>,\n append?: AnyObject,\n): Promise<CloudMethodOutput<O>> {\n try {\n const data = await fn();\n\n return {\n errCode: 0,\n errMsg: '',\n data,\n ...append,\n };\n } catch (err) {\n console.error('respondCloudObject error');\n console.error(err);\n\n const err2 = errorNormalize(err as UniError);\n\n return {\n errCode: err2.errCode \|\| -1,\n errMsg: err2.errMsg \|\| err2.message \|\| '',\n // @ts-expect-error\n data: null,\n ...append,\n };\n }\n}\n","import { objectDefaults } from '@cloudcome/utils-core/object';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport { versionCompare } from '@cloudcome/utils-core/version';\nimport type z from 'zod';\nimport type { ZodObject } from 'zod';\nimport { createCloudObjectError } from './error';\nimport { parseCloudModuleOutput } from './module';\nimport { respondCloudMethod } from './respond';\nimport type { CloudMethod, CloudObjectThis } from './types';\nimport type { UniIdCommonModule } from './uni-id';\n\ntype _CloudObjectThisAppendUser = {\n id: string;\n role: string[];\n permission: string[];\n isAdmin: boolean;\n};\n\ntype _CloudObjectThisAppend = {\n options: Required<CreateCloudObjectOptions>;\n user: _CloudObjectThisAppendUser;\n};\n\nexport type CloudObjectContext = CloudObjectThis & _CloudObjectThisAppend;\n\nexport type BuildCloudMethodCreatorOptions = {\n /\n UniId 通用模块\n * 用于处理用户身份验证和权限管理\n * 如果提供，将在云对象执行前验证用户身份\n /\n uniIdCommonModule?: UniIdCommonModule;\n\n /\n 需要用户登录态的错误码\n * @default 'uni-id-check-token-failed'\n /\n requiredUserErrCode?: number \| string;\n\n /\n 需要用户登录态的错误消息\n * @default '需要登录后才能进行此操作'\n /\n requiredUserErrMsg?: string;\n\n /\n 仅允许本地环境运行的错误消息\n * @default '运行环境不匹配'\n /\n onlyLocalEnvErrMsg?: string;\n\n /\n 版本不匹配错误消息\n * @default '应用版本过低'\n /\n appVersionTooLowErrMsg?: string;\n\n /\n 应用版本过高错误消息\n * @default '应用版本过高'\n /\n appVersionTooHighErrMsg?: string;\n\n /\n 响应附加数据函数\n * 用于在云对象响应中添加额外的上下文信息\n * @param objectThis 云对象上下文\n * @returns 返回要附加到响应中的数据对象\n /\n respondAppend?: (objectThis: CloudObjectThis) => AnyObject;\n\n /\n 所有云对象执行前钩子函数\n * @param context 云对象上下文，包含用户信息、选项等\n /\n onBefore?: (context: CloudObjectContext) => MaybePromise<unknown>;\n};\n\nexport type CreateCloudObjectOptions = {\n /\n 是否需要用户登录态\n * @default false\n /\n requiredUser?: boolean;\n\n /\n 是否仅在本地环境运行\n * @default false\n /\n onlyLocalEnv?: boolean;\n\n /\n 最小支持版本\n /\n minVersion?: string;\n\n /\n 最大支持版本\n /\n maxVersion?: string;\n\n /\n 非响应模式，常用于钩子函数中，如 _before, _after 等，\n * 文档：https://doc.dcloud.net.cn/uniCloud/cloud-obj.html#before-and-after\n /\n noRespond?: boolean;\n};\n\n/\n 云对象方法创建器类型定义\n \n 用于定义云对象方法的创建函数类型，支持两种重载形式：\n * 1. 带输入验证的版本：接收schema、处理函数和选项\n * 2. 无输入参数的版本：仅接收处理函数和选项\n /\nexport type CreateCloudMethod = {\n /\n 带输入验证的云对象方法创建器\n * @template S - Zod验证模式类型\n * @template O - 返回值类型\n * @param schema - Zod验证模式，用于验证输入数据\n * @param fn - 业务逻辑处理函数，接收上下文和验证后的输入数据\n * @param options - 云对象创建选项\n * @returns 云对象方法函数\n /\n <S extends ZodObject, O>(\n schema: S,\n fn: (context: CloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n options?: CreateCloudObjectOptions,\n ): CloudMethod<z.infer<S>, O>;\n\n /\n 无输入参数的云对象方法创建器\n * @template O - 返回值类型\n * @param fn - 业务逻辑处理函数，仅接收上下文\n * @param options - 云对象创建选项\n * @returns 云对象方法函数\n /\n <O>(\n fn: (context: CloudObjectContext) => MaybePromise<O>,\n options?: CreateCloudObjectOptions,\n ): CloudMethod<void, O>;\n};\n\n/\n 构建云对象方法创建器\n \n 该函数用于创建云对象方法的工厂函数，支持输入验证、用户身份验证、环境检查等功能。\n * 返回的创建器函数可以根据不同的配置创建云对象方法。\n \n @param options 构建选项，用于配置云对象方法创建器的行为\n * @returns 返回一个云对象方法创建器函数\n \n @example\n * // 创建一个需要用户登录的云对象方法\n * const createMethod = buildCloudMethodCreator({ uniIdCommonModule });\n * const myMethod = createMethod(async (context) => {\n * return { message: 'Hello ' + context.user.id };\n * }, { requiredUser: true });\n /\nexport function buildCloudMethodCreator(\n options?: BuildCloudMethodCreatorOptions,\n) {\n const buildOptions = objectDefaults(options \|\| {}, {\n requiredUserErrCode: 'uni-id-check-token-failed',\n requiredUserErrMsg: '需要登录后才能进行此操作',\n onlyLocalEnvErrMsg: '运行环境不匹配',\n appVersionTooLowErrMsg: '应用版本过低',\n appVersionTooHighErrMsg: '应用版本过高',\n respondAppend: () => ({}),\n onBefore: () => {},\n }) as Required<BuildCloudMethodCreatorOptions>;\n\n // @ts-expect-error\n const createCloudMethod: CreateCloudMethod = (arg0, arg1, arg2) => {\n // 确定选项来源：如果arg0是函数，则选项在arg1；否则在arg2\n const optionsSource = (isFunction(arg0) ? arg1 : arg2) as\n \| CreateCloudObjectOptions\n \| undefined;\n\n // 设置默认选项值\n const createOptions = objectDefaults(optionsSource \|\| {}, {\n requiredUser: false,\n onlyLocalEnv: false,\n }) as Required<CreateCloudObjectOptions>;\n\n return async function (input) {\n const cloudMethod = async () => {\n const { runtimeEnv } = this.getCloudInfo();\n\n if (createOptions.onlyLocalEnv && runtimeEnv !== 'local') {\n throw createCloudObjectError(buildOptions.onlyLocalEnvErrMsg);\n }\n\n const { appVersion } = this.getClientInfo();\n\n if (\n createOptions.minVersion &&\n versionCompare(appVersion, createOptions.minVersion) < 0\n ) {\n throw createCloudObjectError(buildOptions.appVersionTooLowErrMsg);\n }\n\n if (\n createOptions.maxVersion &&\n versionCompare(appVersion, createOptions.maxVersion) > 0\n ) {\n throw createCloudObjectError(buildOptions.appVersionTooHighErrMsg);\n }\n\n // 构建附加的上下文信息，包括用户身份和权限信息\n const user = await _parseAppendUser(this, options?.uniIdCommonModule);\n const append: _CloudObjectThisAppend = {\n options: createOptions,\n user: user,\n };\n const context = Object.assign(this, append) as CloudObjectContext;\n\n // 如果需要用户登录态但用户未登录，则抛出错误\n if (createOptions.requiredUser && !user.id) {\n throw createCloudObjectError(\n buildOptions.requiredUserErrMsg,\n buildOptions.requiredUserErrCode,\n );\n }\n\n // 执行前钩子函数\n await buildOptions.onBefore(context);\n\n // 无入参函数调用\n if (isFunction(arg0)) {\n return await arg0(context);\n }\n\n // 有入参函数调用 - 验证输入数据\n const parsed = arg0.safeParse(input);\n\n // 输入验证失败处理\n if (!parsed.success) {\n console.log(parsed.error.issues);\n\n const issue0 = parsed.error?.issues?.[0];\n\n // 处理自定义验证错误\n if (issue0?.code === 'custom') throw issue0.message;\n throw new Error('请求数据不正确');\n }\n\n // 执行业务逻辑函数，传入上下文和验证后的数据\n return await arg1(context, parsed.data);\n };\n\n // 如果设置了非响应模式，则直接执行方法，不返回响应\n if (createOptions.noRespond) {\n return await cloudMethod();\n }\n\n // 处理云对象方法响应逻辑，包括错误捕获和统一响应格式\n return await respondCloudMethod(\n cloudMethod,\n buildOptions.respondAppend(this),\n );\n };\n };\n\n return createCloudMethod;\n}\n\n/\n 解析并附加用户信息到云对象上下文\n \n 该函数用于验证用户身份并获取用户权限信息，将结果附加到云对象上下文中的user字段\n * 如果未提供uniIdCommonModule或验证失败，则返回默认的空用户信息\n \n @param objectThis 云对象上下文，包含客户端信息和token等\n * @param uniIdCommonModule 可选的UniId通用模块实例，用于验证用户token\n * @returns 返回包含用户ID、角色、权限等信息的对象\n \n @example\n * // 成功验证用户身份\n * const user = await _parseAppendUser(this, uniIdModule);\n * // 返回: { id: 'user123', role: ['user'], permission: ['read'], isAdmin: false }\n \n @example\n * // 验证失败或未提供模块\n * const user = await _parseAppendUser(this);\n * // 返回: { id: '', role: [], permission: [], isAdmin: false }\n /\nasync function _parseAppendUser(\n objectThis: CloudObjectThis,\n uniIdCommonModule?: UniIdCommonModule,\n): Promise<_CloudObjectThisAppendUser> {\n const appendUser: _CloudObjectThisAppendUser = {\n id: '',\n role: [],\n permission: [],\n isAdmin: false,\n };\n\n if (!uniIdCommonModule) return appendUser;\n\n const uic = uniIdCommonModule.createInstance({\n clientInfo: objectThis.getClientInfo(),\n });\n\n // 验证用户token，忽略验证过程中的错误\n const [_err1, user] = await tryFlatten(\n uic.checkToken(objectThis.getUniIdToken() \|\| ''),\n );\n if (!user) return appendUser;\n\n // 解析验证结果，忽略解析过程中的错误\n const [_err2, userData] = tryFlatten(() => parseCloudModuleOutput(user));\n if (!userData) return appendUser;\n\n appendUser.id = userData.uid \|\| '';\n appendUser.role = userData.role \|\| [];\n appendUser.permission = userData.permission \|\| [];\n appendUser.isAdmin =\n appendUser.role.includes('admin') && appendUser.permission.length === 0;\n\n return appendUser;\n}\n","import { qsStringify } from '@cloudcome/utils-core/qs';\nimport type { AnyObject } from '@cloudcome/utils-core/types';\n\n/\n HTTP 请求配置选项\n /\nexport type RequestOptions = {\n /\n 请求 URL 地址\n /\n url: string;\n\n /\n URL 查询参数，会自动拼接到 url 后面\n /\n query?: Record<string, string>;\n\n /\n HTTP 请求方法\n * @default 'GET'\n /\n method?: 'GET' \| 'POST' \| 'PUT' \| 'DELETE' \| 'HEAD' \| 'OPTIONS';\n\n /\n 请求头\n /\n headers?: Record<string, string>;\n\n /\n 请求体数据\n /\n data?: AnyObject;\n\n /\n 返回数据格式\n * @default 'json'\n /\n dataType?: string;\n\n /\n 请求内容类型\n * - 'json': application/json\n * - 'form': application/x-www-form-urlencoded\n * @default 'json'\n /\n contentType?: string;\n\n /\n 请求超时时间，单位毫秒\n * @default 10000\n /\n timeout?: number;\n};\n\n/\n 发起 HTTP 请求\n \n 基于 uniCloud.httpclient 发起 HTTP 请求，支持 GET、POST、PUT、DELETE 等方法。\n * 查询参数会自动通过 qsStringify 拼接到 URL 上。\n \n @template T - 响应数据的类型\n * @param options 请求配置选项\n * @returns 包含 data、status、headers 的响应对象\n \n @example\n * ```ts\n * // GET 请求\n * const res = await request<{ name: string }>({\n * url: 'https://api.example.com/users/1',\n * })\n * console.log(res.data) // { name: 'Alice' }\n * console.log(res.status) // 200\n \n // POST 请求\n * const res = await request<{ id: string }>({\n * url: 'https://api.example.com/users',\n * method: 'POST',\n * data: { name: 'Alice', age: 25 },\n * })\n \n // 带查询参数\n * const res = await request<{ list: any[] }>({\n * url: 'https://api.example.com/users',\n * query: { page: '1', size: '10' },\n * })\n * ```\n */\nexport async function request<T>(options: RequestOptions) {\n const {\n url,\n query = {},\n method = 'GET',\n headers = {},\n data,\n dataType = 'json',\n contentType = 'json',\n timeout = 10000,\n } = options;\n\n const fullUrl = `${url}?${qsStringify(query)}`;\n\n // 使用uniCloud.httpclient发起请求\n // @ts-expect-error: uniCloud类型定义中可能缺少httpclient属性\n const res = await uniCloud.httpclient.request(fullUrl, {\n method,\n headers,\n data,\n dataType,\n contentType,\n timeout,\n });\n\n return res as { data: T; status: number; headers: Record<string, string> };\n}\n"],"mappings":"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"}

package/dist/database/each.d.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import { Db } from './_db.class';
+import { DbWhere } from './types';
+/**
+ * 遍历表中的每一行数据并执行回调函数
+ *
+ * 采用分批查询策略，每批查询 100 条记录，通过 skip/limit 实现分页遍历，
+ * 避免一次性加载大量数据导致内存溢出。
+ *
+ * 迭代器按顺序串行执行，即每一行数据的迭代器完成后才会处理下一行。
+ *
+ * @template T - 数据行类型
+ * @param table 数据库表代理对象
+ * @param where 查询条件
+ * @param iterator 对每一行数据执行的异步迭代器函数
+ * @param maxCount 最大遍历数量，默认值为 Number.MAX_SAFE_INTEGER。
+ *   注意：由于分批查询机制（每批 100 条），实际遍历的行数可能略大于 maxCount，
+ *   例如 maxCount=150 时，会分两批查询（0-99、100-199），实际遍历 200 行。
+ * @example
+ * ```ts
+ * // 遍历所有状态为 active 的用户
+ * await dbEach(userTable, { status: 'active' }, async (user) => {
+ *   await sendEmail(user.email);
+ * });
+ *
+ * // 限制最多遍历 500 条记录
+ * await dbEach(orderTable, { status: 'pending' }, async (order) => {
+ *   await processOrder(order);
+ * }, 500);
+ * ```
+ */
+export declare function dbEach<T>(table: Db<T>, where: DbWhere<T>, iterator: (row: T) => Promise<unknown>, maxCount?: number): Promise<void>;

package/dist/database.cjs CHANGED Viewed

@@ -163,6 +163,44 @@ var dbMutate = {
 	remove: () => new DbMutateCommand("remove", void 0)
 };
 //#endregion
+//#region src/database/each.ts
+/**
+* 遍历表中的每一行数据并执行回调函数
+*
+* 采用分批查询策略，每批查询 100 条记录，通过 skip/limit 实现分页遍历，
+* 避免一次性加载大量数据导致内存溢出。
+*
+* 迭代器按顺序串行执行，即每一行数据的迭代器完成后才会处理下一行。
+*
+* @template T - 数据行类型
+* @param table 数据库表代理对象
+* @param where 查询条件
+* @param iterator 对每一行数据执行的异步迭代器函数
+* @param maxCount 最大遍历数量，默认值为 Number.MAX_SAFE_INTEGER。
+*   注意：由于分批查询机制（每批 100 条），实际遍历的行数可能略大于 maxCount，
+*   例如 maxCount=150 时，会分两批查询（0-99、100-199），实际遍历 200 行。
+* @example
+* ```ts
+* // 遍历所有状态为 active 的用户
+* await dbEach(userTable, { status: 'active' }, async (user) => {
+*   await sendEmail(user.email);
+* });
+*
+* // 限制最多遍历 500 条记录
+* await dbEach(orderTable, { status: 'pending' }, async (order) => {
+*   await processOrder(order);
+* }, 500);
+* ```
+*/
+async function dbEach(table, where, iterator, maxCount = Number.MAX_SAFE_INTEGER) {
+	const count = Math.min(await table.where(where).count(), maxCount);
+	const limit = 100;
+	for (let skip = 0; skip < count; skip += limit) {
+		const rows = await table.where(where).limit(limit).skip(skip).many();
+		for (const row of rows) await iterator(row);
+	}
+}
+//#endregion
 //#region src/database/paging.ts
 /**
 * 数据库分页查询函数
@@ -660,6 +698,7 @@ async function dbUnique(db, options) {
 	};
 }
 //#endregion
+exports.dbEach = dbEach;
 exports.dbMutate = dbMutate;
 exports.dbPaging = dbPaging;
 exports.dbProxy = dbProxy;

package/dist/database.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"database.cjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/paging.ts","../src/database/_db.class.ts","../src/database/proxy.ts","../src/database/transaction.ts","../src/database/upsert.ts","../src/database/unique.ts"],"sourcesContent":["// 设置私有属性和静态方法是避免在 update 的时候提示类属性\n\nexport class DbBaseCommand {\n protected _isQuery = false;\n protected _isMutate = false;\n\n constructor(\n private _command: string,\n private _parameter: unknown,\n private _options?: {\n formatParameter?: (db: UniCloud.Database) => unknown;\n rewriteValue?: (db: UniCloud.Database, parameter: unknown) => unknown;\n },\n ) {}\n\n static getValue(cmd: DbBaseCommand, db: UniCloud.Database) {\n if (cmd._options?.rewriteValue) {\n return cmd._options.rewriteValue(db, cmd._parameter);\n }\n\n return (\n db.command as unknown as Record<string, (value: unknown) => unknown>\n )[cmd._command].call(\n db.command,\n cmd._options?.formatParameter?.(db) \|\| cmd._parameter,\n );\n }\n\n static getExpression(cmd: DbBaseCommand, fieldName: string) {\n return {\n [`$${cmd._command}`]: [fieldName, cmd._parameter],\n };\n }\n\n static isQueryCommand(cmd: DbBaseCommand) {\n return cmd._isQuery;\n }\n\n static isMutateCommand(cmd: DbBaseCommand) {\n return cmd._isMutate;\n }\n}\n\nexport class DbQueryCommand extends DbBaseCommand {\n protected _isQuery = true;\n}\n\nexport class DbMutateCommand extends DbBaseCommand {\n protected _isMutate = true;\n}\n","import {\n DbBaseCommand,\n DbMutateCommand,\n DbQueryCommand,\n} from './_command.class';\n\n/*\n 数据库查询命令对象，提供各种查询操作符\n /\nexport const dbQuery = {\n /\n 等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n eq: (value: unknown) => new DbQueryCommand('eq', value),\n\n /\n 不等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n neq: (value: unknown) => new DbQueryCommand('neq', value),\n\n /\n 大于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n gt: (value: unknown) => new DbQueryCommand('gt', value),\n\n /\n 大于等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n gte: (value: unknown) => new DbQueryCommand('gte', value),\n\n /\n 小于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n lt: (value: unknown) => new DbQueryCommand('lt', value),\n\n /\n 小于等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n lte: (value: unknown) => new DbQueryCommand('lte', value),\n\n /\n 包含在数组中操作符\n * @param value 值数组\n * @returns DbQueryCommand 查询命令对象\n /\n in: (value: unknown[]) => new DbQueryCommand('in', value),\n\n /\n 不包含在数组中操作符\n * @param value 值数组\n * @returns DbQueryCommand 查询命令对象\n /\n nin: (value: unknown[]) => new DbQueryCommand('nin', value),\n\n /\n 数组长度匹配操作符\n * @param size 数组长度\n * @returns DbQueryCommand 查询命令对象\n /\n size: (size: number) => new DbQueryCommand('size', size),\n\n /\n 正则表达式匹配操作符\n * @param regExp 正则表达式\n * @returns DbQueryCommand 查询命令对象\n /\n regExp: (regExp: RegExp) =>\n new DbQueryCommand('regExp', regExp, {\n rewriteValue: (_db, parameter) => parameter,\n }),\n\n /\n 逻辑与操作符\n * @param conditions 查询条件参数\n * @returns DbQueryCommand 查询命令对象\n /\n and: (conditions: DbQueryCommand[]) =>\n new DbQueryCommand('and', conditions, {\n formatParameter: (db) =>\n conditions.map((c) => DbBaseCommand.getValue(c, db)),\n }),\n\n /\n 逻辑或操作符\n * @param conditions 查询条件参数\n * @returns DbQueryCommand 查询命令对象\n /\n or: (conditions: DbQueryCommand[]) =>\n new DbQueryCommand('or', conditions, {\n formatParameter: (db) =>\n conditions.map((c) => DbBaseCommand.getValue(c, db)),\n }),\n};\n\n/\n 数据库变更命令对象，提供各种数据更新操作符\n /\nexport const dbMutate = {\n /\n 数值增加操作符\n * @param value 增加的数值\n * @returns DbMutateCommand 变更命令对象\n /\n inc: (value: number) => new DbMutateCommand('inc', value),\n\n /\n 数值乘法操作符\n * @param value 乘数\n * @returns DbMutateCommand 变更命令对象\n /\n mul: (value: number) => new DbMutateCommand('mul', value),\n\n /\n 设置字段值操作符\n * @param value 设置的值\n * @returns DbMutateCommand 变更命令对象\n /\n set: (value: unknown) => new DbMutateCommand('set', value),\n\n /\n 向数组末尾添加元素操作符\n * @param value 添加的值\n * @returns DbMutateCommand 变更命令对象\n /\n push: (value: unknown) => new DbMutateCommand('push', value),\n\n /\n 向数组开头添加元素操作符\n * @param value 添加的值\n * @returns DbMutateCommand 变更命令对象\n /\n unshift: (value: unknown) => new DbMutateCommand('unshift', value),\n\n /\n 从数组末尾移除元素操作符\n * @returns DbMutateCommand 变更命令对象\n /\n pop: () => new DbMutateCommand('pop', undefined),\n\n /\n 从数组开头移除元素操作符\n * @returns DbMutateCommand 变更命令对象\n /\n shift: () => new DbMutateCommand('shift', undefined),\n\n /\n 移除字段操作符\n * @returns DbMutateCommand 变更命令对象\n /\n remove: () => new DbMutateCommand('remove', undefined),\n};\n","import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\n/\n 数据库分页查询函数\n * @template T - 数据类型\n * @param queryDb - 数据库查询实例\n * @returns 包含数据列表和总数的对象\n /\n\nexport async function dbPaging<\n D1,\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n S1 extends DbSelect<D1> = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n D2 extends AnyObject = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n W2 extends AnyObject = {},\n>(queryDb: Db<D1, S1, D2, W2>) {\n // 获取原始查询条件，不包映射字段\n const where = queryDb.getWhere(true);\n\n // 克隆查询实例用于统计总数，避免影响原查询\n const countDb = queryDb.clone();\n\n // 执行查询获取数据列表\n const list = await queryDb.many();\n\n // 基于相同查询条件统计总数\n const total = await countDb.where(where).count();\n\n // 返回分页结果\n return {\n list,\n total,\n };\n}\n","import {\n objectEach,\n objectFilter,\n objectMap,\n objectOmit,\n} from '@cloudcome/utils-core/object';\nimport { isNumber, isObject, isString } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { DbBaseCommand, type DbQueryCommand } from './_command.class';\nimport type {\n DbCreate,\n DbForeign,\n DbOrder,\n DbQuery,\n DbRelation,\n DbSelect,\n DbUpdate,\n DbWhere,\n} from './types';\n\n/\n 数据库聚合操作符命令\n /\nconst dbAgg = uniCloud.database().command\n .aggregate as UniCloud.AggregateCommand & {\n pipeline: () => UniCloud.AggregateReference & {\n done: () => unknown;\n };\n};\n\ntype _WhereFrom = 'where' \| 'whereId';\n\nconst db0 = uniCloud.database();\n\nexport type DbOptions = {\n /\n 数据表名称\n /\n table: string;\n\n /\n 事务对象，用于事务操作\n /\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n transaction?: any;\n\n /\n 模拟数据库，用于单元测试\n /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDatabase?: any;\n\n /\n 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n /\n parseError?: (error: UniError) => UniError;\n};\n\nexport type DbLookupOptions<\n RL extends DbRelation,\n D1,\n FD1,\n AS,\n // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n US extends boolean \| undefined \| void = undefined,\n> = {\n /\n 关联类型\n /\n relation: RL;\n\n /\n 主表字段\n /\n localField: keyof D1 & string;\n\n /\n 关联表字段\n /\n foreignField: keyof FD1 & string;\n\n /\n 关联数据在结果中的字段名\n /\n as: AS;\n\n /\n 是否取消筛选关联数据\n /\n unselect?: US;\n};\n\nexport type DbLookup = DbLookupOptions<\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n any,\n unknown,\n unknown,\n string,\n boolean\n> & {\n /\n 关联表\n /\n table: Db<unknown>;\n};\n\nlet gid = 0;\n\n/\n 数据库类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @template D2 - 副表数据\n * @template W2 - 副表查询\n /\nexport class Db<\n D1,\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n S1 extends DbSelect<D1> = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n D2 extends AnyObject = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n W2 extends AnyObject = {},\n> {\n private _host: UniCloud.CollectionReference;\n\n /\n 是否为事务环境\n * - 查询条件只能是 id\n * - 不能聚合操作\n /\n private _isTransaction = false;\n\n private _options: DbOptions;\n\n /\n 构造函数，初始化数据库集合引用\n * @param collection 数据表名称\n * @param _mockDatabase 模拟数据库，用于单元测试\n /\n constructor(options: DbOptions) {\n this._options = options;\n this._host =\n options._mockDatabase \|\|\n options.transaction?.collection(options.table) \|\|\n db0.collection(options.table);\n this._isTransaction = !!options.transaction;\n }\n\n /\n 创建一个新的数据库实例，可选是否移除事务\n * @param withoutTransaction 是否移除事务，默认 false\n * @returns 新的数据库实例\n /\n clone(withoutTransaction?: boolean) {\n return new Db({\n ...this._options,\n transaction: withoutTransaction ? null : this._options.transaction,\n });\n }\n\n get table() {\n return this._options.table;\n }\n\n get options() {\n return this._options;\n }\n\n get isTransaction() {\n return this._isTransaction;\n }\n\n /\n 获取聚合操作实例\n * @returns 聚合操作实例\n /\n aggregate() {\n return this._host.aggregate();\n }\n\n private _hasWhere: _WhereFrom \| undefined = undefined;\n private _hasWhereId: _WhereFrom \| undefined = undefined;\n private _where = {};\n\n private _doWhere(where: DbWhere<D1>, from: _WhereFrom) {\n if (this._hasWhere)\n throw new Error(`已调用过一次 db.${_toWhereMethod(this._hasWhere)} 了`);\n\n // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n const realWhere = objectFilter(where, (value) => value !== undefined);\n\n const whereKeys = Object.keys(realWhere);\n\n // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n const isWhereId =\n whereKeys.length === 1 &&\n '_id' in realWhere &&\n (isString(realWhere._id) \|\| isNumber(realWhere._id));\n\n if (isWhereId && this._hasLimit) {\n throw new Error(\n `db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`,\n );\n }\n\n this._hasWhere = from;\n this._where = realWhere;\n if (isWhereId) this._hasWhereId = from;\n\n return this;\n }\n\n /\n 设置查询条件\n * @param where 查询条件对象\n * @returns 当前Db实例，支持链式调用\n /\n where(where: DbWhere<D1> & W2) {\n return this._doWhere(where, 'where');\n }\n\n /\n 获取当前查询条件\n * @param plain 是否返回原始查询条件对象，默认 false\n * @returns 当前查询条件对象\n /\n getWhere(plain?: boolean) {\n return plain\n ? // biome-ignore lint/suspicious/noTsIgnore: 必须这么用\n // @ts-ignore\n objectOmit(this._where, Object.keys(this._lookupAs))\n : this._where;\n }\n\n /\n 根据ID设置查询条件\n * @param id 记录ID\n * @returns 当前Db实例，支持链式调用\n /\n whereId(id: string \| number) {\n // @ts-expect-error\n return this._doWhere({ _id: id }, 'whereId');\n }\n\n private _hasSelect = 0;\n private _select = {};\n\n /\n 指定要返回的字段\n * @param fields 要返回的字段对象，true表示返回，false表示不返回\n * @returns 当前Db实例，支持链式调用\n /\n select<const S extends DbSelect<D1>>(fields: S) {\n if (this._hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n this._hasSelect++;\n this._select = fields;\n\n return this as Db<D1, S, D2, W2>;\n }\n\n private _hasOrder = 0;\n private _order = {};\n\n /\n 设置排序规则\n * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n * @returns 当前Db实例，支持链式调用\n /\n order(order: DbOrder<D1>) {\n this._hasOrder++;\n this._order = order;\n\n return this;\n }\n\n private _hasSkip = 0;\n private _skip = 0;\n\n /\n 跳过指定数量的记录\n * @param skip 要跳过的记录数\n * @returns 当前Db实例，支持链式调用\n /\n skip(skip: number) {\n if (this._hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n this._hasSkip++;\n this._skip = skip;\n\n return this;\n }\n\n private _hasLimit = 0;\n private _limit = 0;\n\n /\n 限制返回的记录数量\n * @param limit 最大返回记录数\n * @returns 当前Db实例，支持链式调用\n /\n limit(limit: number) {\n if (this._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n if (this._hasWhereId) {\n throw new Error(\n `db.limit() 方法不能与 ${_toWhereIdMethod(this._hasWhereId)} 方法同时调用`,\n );\n }\n\n this._hasLimit++;\n this._limit = limit;\n\n return this;\n }\n\n private _hasLookup = 0;\n get hasLookup() {\n return this._hasLookup > 0;\n }\n\n private _lookups: DbLookup[] = [];\n lookup<\n FD1,\n FS1 extends DbSelect<FD1>,\n FD2 extends AnyObject,\n FW2 extends AnyObject,\n RL extends DbRelation,\n AS extends string,\n // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n US extends boolean \| undefined \| void = undefined,\n >(\n table: Db<FD1, FS1, FD2, FW2>,\n lookup: DbLookupOptions<RL, D1, FD1, AS, US>,\n ) {\n // 对方表也记为关联查询，避免做表更新操作\n table._hasLookup++;\n this._hasLookup++;\n this._lookups.push({\n ...lookup,\n table,\n } as unknown as DbLookup);\n\n // @ts-expect-error\n return this as Db<\n D1,\n S1,\n US extends true\n ? D2\n : MergeIntersection<D2 & DbForeign<FD1, FS1, FD2, RL, AS>>,\n MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>\n >;\n }\n\n private _aggregated = false;\n private _lookupAs = {} as Record<string, true>;\n private _endAggregate(aggRef: UniCloud.AggregateReference) {\n if (this._aggregated)\n throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n this._aggregated = true;\n let returnAggRef = aggRef;\n let _hasAggSelect = 0;\n const aggSelect = {} as Record<string, true>;\n let hasAggUnselect = 0;\n const aggUnselect = {} as Record<string, false>;\n\n // 后做关联查询\n for (const {\n relation: type,\n as,\n foreignField,\n localField,\n table,\n unselect,\n } of this._lookups) {\n const letName = `let${gid++}`;\n let pipeline = dbAgg.pipeline();\n\n // 关联条件\n // @ts-expect-error\n pipeline = pipeline.match({\n $expr: {\n $and: [\n type === 'n:1'\n ? { $in: [`$${foreignField}`, `$$${letName}`] }\n : { $eq: [`$${foreignField}`, `$$${letName}`] },\n ],\n },\n });\n\n // 其他查询条件\n // @ts-expect-error\n pipeline = table._endAggregate(pipeline);\n\n // @ts-expect-error\n pipeline = pipeline.done();\n\n returnAggRef = returnAggRef.lookup({\n let: {\n [letName]: `$${localField}`,\n },\n as,\n from: table.table,\n pipeline,\n });\n\n // 1对1，展开数组\n if (type === '1:1') {\n // @ts-expect-error\n returnAggRef = returnAggRef.unwind({\n path: `$${as}`,\n preserveNullAndEmptyArrays: true,\n });\n }\n\n if (unselect) {\n hasAggUnselect++;\n aggUnselect[as] = false;\n } else {\n _hasAggSelect++;\n aggSelect[as] = true;\n }\n\n this._lookupAs[as] = true;\n }\n\n // 主表查询，注意顺序，筛选->排序->跳过->限制\n if (this._hasWhere)\n returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));\n if (this._hasOrder)\n returnAggRef = returnAggRef.sort(\n objectMap(this._order, (v) => (v === 'asc' ? 1 : -1)),\n );\n if (this._hasSkip) returnAggRef = returnAggRef.skip(this._skip);\n if (this._hasLimit) returnAggRef = returnAggRef.limit(this._limit);\n\n // 如果主表有选择字段，则合并选择字段（包括关联查询的字段和排序字段）\n if (this._hasSelect) {\n returnAggRef = returnAggRef.project(\n _mergeSelect({ ...this._select, ...aggSelect }, this._order),\n );\n }\n // 如果主表没有选择字段，则排除取消选择字段\n else if (hasAggUnselect) {\n returnAggRef = returnAggRef.project(aggUnselect);\n }\n\n return returnAggRef;\n }\n\n private _endHost(action: 'query' \| 'create' \| 'update' \| 'remove' \| 'count') {\n if (this._hasWhere) {\n // 事务模式下：更新/删除只能用 doc(id)\n if ((action === 'update' \|\| action === 'remove') && this._isTransaction) {\n // @ts-expect-error\n this._host = this._host.doc(this._where._id);\n } else {\n // @ts-expect-error\n this._host = this._host.where(_mapCommandRaw(this._where));\n }\n }\n\n if (this._hasSelect) {\n // @ts-expect-error\n this._host = this._host.field(_mergeSelect(this._select, this._order));\n }\n\n if (this._hasOrder) {\n objectEach(this._order, (val, key) => {\n // @ts-expect-error\n this._host = this._host.orderBy(key, val);\n });\n }\n\n // @ts-expect-error\n if (this._hasSkip) this._host = this._host.skip(this._skip);\n\n if (this._hasLimit && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(this._limit);\n else if (this._hasWhereId && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(1);\n }\n\n /\n 执行查询操作\n * @returns 查询结果\n /\n async many() {\n try {\n if (this._isTransaction) throw new Error('db.many() 方法不支持事务模式');\n\n let res: { data: DbQuery<D1, S1, D2>[] };\n\n // 关联查询\n if (this._hasLookup) {\n const aggRef = this.aggregate();\n this._endAggregate(aggRef);\n res = await aggRef.end();\n }\n // 单表查询\n else {\n this._endHost('query');\n res = await this._host.get();\n }\n\n const { data } = parseDatabaseOutput(res);\n return data;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 只查询一条，自动添加 limit(1) 条件\n * 如果没有匹配到记录，会抛出错误\n * @returns 查询结果\n /\n async firstOrThrow(): Promise<DbQuery<D1, S1, D2>> {\n if (this._isTransaction)\n throw new Error('db.firstOrThrow() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrThrow() 方法不支持 limit 条件');\n if (!this._hasWhereId) this.limit(1);\n\n const data = await this.many();\n const res = data.at(0);\n\n if (!res) throw createCloudObjectError('查询数据为空', 'firstOrThrow');\n return res;\n }\n\n /\n 只查询一条，自动添加 limit(1) 条件\n * 如果没有匹配到记录，返回 null\n * @returns 查询结果或 null\n /\n async firstOrNull(): Promise<DbQuery<D1, S1, D2> \| null> {\n if (this._isTransaction)\n throw new Error('db.firstOrNull() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrNull() 方法不支持 limit 条件');\n if (!this._hasWhereId) this.limit(1);\n\n const data = await this.many();\n return data.at(0) \|\| null;\n }\n\n /\n 获取匹配记录的数量\n * @returns 记录总数\n /\n async count() {\n if (this._isTransaction) throw new Error('db.count() 方法不支持事务模式');\n if (this._hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n if (this._hasSelect) throw new Error('db.count() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.count() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.count() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.count() 方法不支持 limit 条件');\n\n try {\n this._endHost('count');\n const res = await this._host.count();\n const { total } = parseDatabaseOutput<{ total: number }>(res);\n return total;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 创建新记录\n * @param data 要创建的数据\n * @returns 创建结果\n /\n async create(data: DbCreate<D1>) {\n if (this._hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n if (this._hasWhere) throw new Error('db.create() 方法不支持 where 条件');\n if (this._hasSelect) throw new Error('db.create() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.create() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.create() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.create() 方法不支持 limit 条件');\n\n try {\n this._endHost('create');\n const res = await this._host.add(data);\n const { id } = parseDatabaseOutput<{ id: string }>(res);\n return id;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 更新记录\n * @param data 要更新的数据\n * @returns 更新结果\n /\n async update(data: DbUpdate<D1>) {\n if (this._hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n if (!this._hasWhere)\n throw new Error('设置 where 条件后才能执行 db.update() 方法');\n if (this._hasSelect) throw new Error('db.update() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.update() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.update() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.update() 方法不支持 limit 条件');\n\n if (this._isTransaction && !this._hasWhereId)\n throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n try {\n this._endHost('update');\n const res = await this._host.update(\n objectOmit(_mapCommandRaw(data), ['_id']),\n );\n const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n return updated;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 删除记录\n * @returns 删除结果\n /\n async remove() {\n if (this._hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n if (!this._hasWhere)\n throw new Error('设置 where 条件后才能执行 db.remove() 方法');\n if (this._hasSelect) throw new Error('db.remove() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.remove() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.remove() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.remove() 方法不支持 limit 条件');\n\n if (this._isTransaction && !this._hasWhereId)\n throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n try {\n this._endHost('remove');\n const res = await this._host.remove();\n const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n return deleted;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: 必须这么用\nfunction _mapCommandRaw(data: any) {\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n const map = (val: any): any => {\n if (!isObject(val)) return val;\n if (val instanceof DbBaseCommand) return DbBaseCommand.getValue(val, db0);\n return objectMap(val, map);\n };\n\n return objectMap(data, map);\n}\n\nfunction _mapOrderSelect(order: DbOrder<unknown>) {\n return objectMap(order, (_val, _key) => true);\n}\n\nfunction _mergeSelect(select: DbSelect<unknown>, order: DbOrder<unknown>) {\n const noSelect = Object.keys(select).length === 0;\n // 如果没有 select 条件，默认返回所有字段\n if (noSelect) return select;\n\n const onlyOmitId =\n Object.keys(select).length === 1 && '_id' in select && select._id === false;\n // 如果只排除 _id 字段，则保持现状\n if (onlyOmitId) return select;\n\n return {\n ...select,\n ..._mapOrderSelect(order),\n };\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { UniError } from '@/_types';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\nexport type DbProxyOptions = {\n /\n 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n /\n parseError?: (error: UniError) => UniError;\n};\n\n/\n 创建一个数据库代理对象，用于延迟实例化数据库操作类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @param name - 数据库表名\n * @returns 返回一个代理对象，该对象会将属性访问转发到实际的数据库操作实例\n /\n\n// biome-ignore lint/complexity/noBannedTypes: 必须这么用\nexport function dbProxy<D1, S1 extends DbSelect<D1> = {}>(\n name: string,\n options?: DbProxyOptions,\n) {\n return new Proxy(\n {},\n {\n get(_target, prop) {\n if (prop === '_isProxy') return true;\n\n const table = new Db<D1, S1>({ table: name, ...options });\n const tableProp = prop as keyof Db<D1, S1>;\n const ref = table[tableProp];\n\n return isFunction(ref) ? ref.bind(table) : ref;\n },\n },\n ) as Db<D1, S1>;\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { Db } from './_db.class';\n\ntype _TransactionDb = {\n startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n commit: () => Promise<unknown>;\n rollback: () => Promise<unknown>;\n};\n\nexport type WithTransaction = <D1>(db: Db<D1>) => Db<D1>;\n\n/\n 在数据库事务中执行操作\n \n @template K - 事务操作返回值类型\n * @param transacting - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库对象\n * @param _mockDbInstance - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n \n @example\n * ```typescript\n * const result = await dbTransaction(async (withTransaction) => {\n * const userId = await withTransaction(db.table('user')).create({ name: 'John' });\n * const order = await withTransaction(db.table('orders')).create({ userId, amount: 100 });\n * return { user, order };\n * });\n * ```\n /\nexport async function dbTransaction<K>(\n transacting: (withTransaction: WithTransaction) => Promise<K>,\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDatabase?: any,\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any,\n) {\n const transactionDb = (_mockDatabase \|\|\n uniCloud.database()) as _TransactionDb;\n\n const [err1, transaction] = await tryFlatten(\n transactionDb.startTransaction(),\n );\n if (err1) throw err1;\n\n const withTransaction: WithTransaction = <D1>(db: Db<D1>) => {\n return _mockDbInstance \|\| new Db<D1>({ ...db.options, transaction });\n };\n\n const [err2, result] = await tryFlatten(async () => {\n const result = await transacting(withTransaction);\n await transaction.commit();\n return result;\n });\n\n if (err2) {\n await tryFlatten(transaction.rollback());\n throw err2;\n }\n\n return result as unknown as K;\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { Db } from './_db.class';\nimport type { DbCreate, DbQuery, DbUpdate } from './types';\n\nexport type DbUpsertOptions<T, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n /* 创建数据 /\n create: C;\n\n /\n 更新数据，可以是对象或根据查询结果生成更新对象的函数\n * @param row 查询到的文档数据，仅在传入函数时可用\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n update: U \| ((exist: DbQuery<T, {}, {}>) => U);\n\n /* 创建前回调函数 /\n onBeforeCreate?: () => unknown;\n\n /\n 创建后回调函数\n * @param id 创建的文档ID\n /\n onAfterCreate?: (id: string) => unknown;\n\n /\n 更新前回调函数\n * @param exist 查询到的原始文档数据\n * @returns 如果返回 false，则取消更新操作\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n onBeforeUpdate?: (exist: DbQuery<T, {}, {}>) => false \| unknown;\n\n /\n 更新后回调函数\n * @param updateData 实际更新的数据\n * @param exist 查询到的原始文档数据\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n onAfterUpdate?: (updateData: U, exist: DbQuery<T, {}, {}>) => unknown;\n\n /* 用于测试的模拟数据库实例 /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any;\n};\n\n/\n 数据库 upsert 操作的返回结果类型\n /\nexport type DbUpsertOutput = {\n /* 操作的文档ID /\n id: string;\n /* 是否为创建操作 /\n created: boolean;\n /* 是否为更新操作 /\n updated: boolean;\n};\n\nexport async function dbUpsert<\n D1,\n C extends DbCreate<D1>,\n U extends DbUpdate<D1>,\n>(db: Db<D1>, options: DbUpsertOptions<D1, C, U>): Promise<DbUpsertOutput> {\n const {\n create,\n update,\n onBeforeCreate,\n onAfterCreate,\n onBeforeUpdate,\n onAfterUpdate,\n _mockDbInstance,\n } = options;\n\n const _mutateDb = (_mockDbInstance \|\| db.clone()) as Db<D1>;\n const _queryDb = (_mockDbInstance \|\| db.clone(true)) as Db<D1>;\n\n const exist = (await _queryDb\n .where(db.getWhere(true))\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n .firstOrNull()) as DbQuery<D1, {}, {}> \| null;\n\n if (exist) {\n const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n if (skipUpdate) {\n // @ts-expect-error\n return { id: exist._id as string, updated: false, created: false };\n }\n\n const updateData = isFunction(update) ? update(exist) : update;\n // @ts-expect-error\n await _mutateDb.whereId(exist._id).update(updateData);\n onAfterUpdate?.(updateData, exist);\n\n // @ts-expect-error\n return { id: exist._id as string, updated: true, created: false };\n }\n\n await onBeforeCreate?.();\n const createdId = await _mutateDb.create(create);\n await onAfterCreate?.(createdId);\n\n return { id: createdId, updated: false, created: true };\n}\n","import type { Db } from './_db.class';\nimport type { DbCreate } from './types';\nimport { dbUpsert } from './upsert';\n\nexport type DbUniqueOptions<T, C extends DbCreate<T>> = {\n /* 创建数据 /\n create: C;\n\n /* 创建前回调函数 /\n onBeforeCreate?: () => unknown;\n\n /\n 创建后回调函数\n * @param id 创建的文档ID\n /\n onAfterCreate?: (id: string) => unknown;\n\n /* 用于测试的模拟数据库实例 /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any;\n};\n\n/\n 数据库 upsert 操作的返回结果类型\n /\nexport type DbUniqueOutput = {\n /* 操作的文档ID /\n id: string;\n /* 是否为创建操作 */\n created: boolean;\n};\n\nexport async function dbUnique<T, C extends DbCreate<T>>(\n db: Db<T>,\n options: DbUniqueOptions<T, C>,\n): Promise<DbUniqueOutput> {\n const { id, created } = await dbUpsert(db, {\n ...options,\n // @ts-expect-error\n update: {},\n onBeforeUpdate: () => false,\n });\n return { id, created };\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"database.cjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/each.ts","../src/database/paging.ts","../src/database/_db.class.ts","../src/database/proxy.ts","../src/database/transaction.ts","../src/database/upsert.ts","../src/database/unique.ts"],"sourcesContent":["// 设置私有属性和静态方法是避免在 update 的时候提示类属性\n\nexport class DbBaseCommand {\n protected _isQuery = false;\n protected _isMutate = false;\n\n constructor(\n private _command: string,\n private _parameter: unknown,\n private _options?: {\n formatParameter?: (db: UniCloud.Database) => unknown;\n rewriteValue?: (db: UniCloud.Database, parameter: unknown) => unknown;\n },\n ) {}\n\n static getValue(cmd: DbBaseCommand, db: UniCloud.Database) {\n if (cmd._options?.rewriteValue) {\n return cmd._options.rewriteValue(db, cmd._parameter);\n }\n\n return (\n db.command as unknown as Record<string, (value: unknown) => unknown>\n )[cmd._command].call(\n db.command,\n cmd._options?.formatParameter?.(db) \|\| cmd._parameter,\n );\n }\n\n static getExpression(cmd: DbBaseCommand, fieldName: string) {\n return {\n [`$${cmd._command}`]: [fieldName, cmd._parameter],\n };\n }\n\n static isQueryCommand(cmd: DbBaseCommand) {\n return cmd._isQuery;\n }\n\n static isMutateCommand(cmd: DbBaseCommand) {\n return cmd._isMutate;\n }\n}\n\nexport class DbQueryCommand extends DbBaseCommand {\n protected _isQuery = true;\n}\n\nexport class DbMutateCommand extends DbBaseCommand {\n protected _isMutate = true;\n}\n","import {\n DbBaseCommand,\n DbMutateCommand,\n DbQueryCommand,\n} from './_command.class';\n\n/*\n 数据库查询命令对象，提供各种查询操作符\n /\nexport const dbQuery = {\n /\n 等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n eq: (value: unknown) => new DbQueryCommand('eq', value),\n\n /\n 不等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n neq: (value: unknown) => new DbQueryCommand('neq', value),\n\n /\n 大于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n gt: (value: unknown) => new DbQueryCommand('gt', value),\n\n /\n 大于等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n gte: (value: unknown) => new DbQueryCommand('gte', value),\n\n /\n 小于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n lt: (value: unknown) => new DbQueryCommand('lt', value),\n\n /\n 小于等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n lte: (value: unknown) => new DbQueryCommand('lte', value),\n\n /\n 包含在数组中操作符\n * @param value 值数组\n * @returns DbQueryCommand 查询命令对象\n /\n in: (value: unknown[]) => new DbQueryCommand('in', value),\n\n /\n 不包含在数组中操作符\n * @param value 值数组\n * @returns DbQueryCommand 查询命令对象\n /\n nin: (value: unknown[]) => new DbQueryCommand('nin', value),\n\n /\n 数组长度匹配操作符\n * @param size 数组长度\n * @returns DbQueryCommand 查询命令对象\n /\n size: (size: number) => new DbQueryCommand('size', size),\n\n /\n 正则表达式匹配操作符\n * @param regExp 正则表达式\n * @returns DbQueryCommand 查询命令对象\n /\n regExp: (regExp: RegExp) =>\n new DbQueryCommand('regExp', regExp, {\n rewriteValue: (_db, parameter) => parameter,\n }),\n\n /\n 逻辑与操作符\n * @param conditions 查询条件参数\n * @returns DbQueryCommand 查询命令对象\n /\n and: (conditions: DbQueryCommand[]) =>\n new DbQueryCommand('and', conditions, {\n formatParameter: (db) =>\n conditions.map((c) => DbBaseCommand.getValue(c, db)),\n }),\n\n /\n 逻辑或操作符\n * @param conditions 查询条件参数\n * @returns DbQueryCommand 查询命令对象\n /\n or: (conditions: DbQueryCommand[]) =>\n new DbQueryCommand('or', conditions, {\n formatParameter: (db) =>\n conditions.map((c) => DbBaseCommand.getValue(c, db)),\n }),\n};\n\n/\n 数据库变更命令对象，提供各种数据更新操作符\n /\nexport const dbMutate = {\n /\n 数值增加操作符\n * @param value 增加的数值\n * @returns DbMutateCommand 变更命令对象\n /\n inc: (value: number) => new DbMutateCommand('inc', value),\n\n /\n 数值乘法操作符\n * @param value 乘数\n * @returns DbMutateCommand 变更命令对象\n /\n mul: (value: number) => new DbMutateCommand('mul', value),\n\n /\n 设置字段值操作符\n * @param value 设置的值\n * @returns DbMutateCommand 变更命令对象\n /\n set: (value: unknown) => new DbMutateCommand('set', value),\n\n /\n 向数组末尾添加元素操作符\n * @param value 添加的值\n * @returns DbMutateCommand 变更命令对象\n /\n push: (value: unknown) => new DbMutateCommand('push', value),\n\n /\n 向数组开头添加元素操作符\n * @param value 添加的值\n * @returns DbMutateCommand 变更命令对象\n /\n unshift: (value: unknown) => new DbMutateCommand('unshift', value),\n\n /\n 从数组末尾移除元素操作符\n * @returns DbMutateCommand 变更命令对象\n /\n pop: () => new DbMutateCommand('pop', undefined),\n\n /\n 从数组开头移除元素操作符\n * @returns DbMutateCommand 变更命令对象\n /\n shift: () => new DbMutateCommand('shift', undefined),\n\n /\n 移除字段操作符\n * @returns DbMutateCommand 变更命令对象\n /\n remove: () => new DbMutateCommand('remove', undefined),\n};\n","import type { Db } from './_db.class';\nimport type { DbWhere } from './types';\n\n/\n 遍历表中的每一行数据并执行回调函数\n \n 采用分批查询策略，每批查询 100 条记录，通过 skip/limit 实现分页遍历，\n * 避免一次性加载大量数据导致内存溢出。\n \n 迭代器按顺序串行执行，即每一行数据的迭代器完成后才会处理下一行。\n \n @template T - 数据行类型\n * @param table 数据库表代理对象\n * @param where 查询条件\n * @param iterator 对每一行数据执行的异步迭代器函数\n * @param maxCount 最大遍历数量，默认值为 Number.MAX_SAFE_INTEGER。\n * 注意：由于分批查询机制（每批 100 条），实际遍历的行数可能略大于 maxCount，\n * 例如 maxCount=150 时，会分两批查询（0-99、100-199），实际遍历 200 行。\n * @example\n * ```ts\n * // 遍历所有状态为 active 的用户\n * await dbEach(userTable, { status: 'active' }, async (user) => {\n * await sendEmail(user.email);\n * });\n \n // 限制最多遍历 500 条记录\n * await dbEach(orderTable, { status: 'pending' }, async (order) => {\n * await processOrder(order);\n * }, 500);\n * ```\n /\nexport async function dbEach<T>(\n table: Db<T>,\n where: DbWhere<T>,\n iterator: (row: T) => Promise<unknown>,\n maxCount = Number.MAX_SAFE_INTEGER,\n) {\n const count = Math.min(await table.where(where).count(), maxCount);\n const limit = 100;\n\n for (let skip = 0; skip < count; skip += limit) {\n const rows = await table.where(where).limit(limit).skip(skip).many();\n\n for (const row of rows) {\n await iterator(row as T);\n }\n }\n}\n","import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\n/\n 数据库分页查询函数\n * @template T - 数据类型\n * @param queryDb - 数据库查询实例\n * @returns 包含数据列表和总数的对象\n /\n\nexport async function dbPaging<\n D1,\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n S1 extends DbSelect<D1> = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n D2 extends AnyObject = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n W2 extends AnyObject = {},\n>(queryDb: Db<D1, S1, D2, W2>) {\n // 获取原始查询条件，不包映射字段\n const where = queryDb.getWhere(true);\n\n // 克隆查询实例用于统计总数，避免影响原查询\n const countDb = queryDb.clone();\n\n // 执行查询获取数据列表\n const list = await queryDb.many();\n\n // 基于相同查询条件统计总数\n const total = await countDb.where(where).count();\n\n // 返回分页结果\n return {\n list,\n total,\n };\n}\n","import {\n objectEach,\n objectFilter,\n objectMap,\n objectOmit,\n} from '@cloudcome/utils-core/object';\nimport { isNumber, isObject, isString } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { DbBaseCommand, type DbQueryCommand } from './_command.class';\nimport type {\n DbCreate,\n DbForeign,\n DbOrder,\n DbQuery,\n DbRelation,\n DbSelect,\n DbUpdate,\n DbWhere,\n} from './types';\n\n/\n 数据库聚合操作符命令\n /\nconst dbAgg = uniCloud.database().command\n .aggregate as UniCloud.AggregateCommand & {\n pipeline: () => UniCloud.AggregateReference & {\n done: () => unknown;\n };\n};\n\ntype _WhereFrom = 'where' \| 'whereId';\n\nconst db0 = uniCloud.database();\n\nexport type DbOptions = {\n /\n 数据表名称\n /\n table: string;\n\n /\n 事务对象，用于事务操作\n /\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n transaction?: any;\n\n /\n 模拟数据库，用于单元测试\n /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDatabase?: any;\n\n /\n 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n /\n parseError?: (error: UniError) => UniError;\n};\n\nexport type DbLookupOptions<\n RL extends DbRelation,\n D1,\n FD1,\n AS,\n // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n US extends boolean \| undefined \| void = undefined,\n> = {\n /\n 关联类型\n /\n relation: RL;\n\n /\n 主表字段\n /\n localField: keyof D1 & string;\n\n /\n 关联表字段\n /\n foreignField: keyof FD1 & string;\n\n /\n 关联数据在结果中的字段名\n /\n as: AS;\n\n /\n 是否取消筛选关联数据\n /\n unselect?: US;\n};\n\nexport type DbLookup = DbLookupOptions<\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n any,\n unknown,\n unknown,\n string,\n boolean\n> & {\n /\n 关联表\n /\n table: Db<unknown>;\n};\n\nlet gid = 0;\n\n/\n 数据库类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @template D2 - 副表数据\n * @template W2 - 副表查询\n /\nexport class Db<\n D1,\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n S1 extends DbSelect<D1> = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n D2 extends AnyObject = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n W2 extends AnyObject = {},\n> {\n private _host: UniCloud.CollectionReference;\n\n /\n 是否为事务环境\n * - 查询条件只能是 id\n * - 不能聚合操作\n /\n private _isTransaction = false;\n\n private _options: DbOptions;\n\n /\n 构造函数，初始化数据库集合引用\n * @param collection 数据表名称\n * @param _mockDatabase 模拟数据库，用于单元测试\n /\n constructor(options: DbOptions) {\n this._options = options;\n this._host =\n options._mockDatabase \|\|\n options.transaction?.collection(options.table) \|\|\n db0.collection(options.table);\n this._isTransaction = !!options.transaction;\n }\n\n /\n 创建一个新的数据库实例，可选是否移除事务\n * @param withoutTransaction 是否移除事务，默认 false\n * @returns 新的数据库实例\n /\n clone(withoutTransaction?: boolean) {\n return new Db({\n ...this._options,\n transaction: withoutTransaction ? null : this._options.transaction,\n });\n }\n\n get table() {\n return this._options.table;\n }\n\n get options() {\n return this._options;\n }\n\n get isTransaction() {\n return this._isTransaction;\n }\n\n /\n 获取聚合操作实例\n * @returns 聚合操作实例\n /\n aggregate() {\n return this._host.aggregate();\n }\n\n private _hasWhere: _WhereFrom \| undefined = undefined;\n private _hasWhereId: _WhereFrom \| undefined = undefined;\n private _where = {};\n\n private _doWhere(where: DbWhere<D1>, from: _WhereFrom) {\n if (this._hasWhere)\n throw new Error(`已调用过一次 db.${_toWhereMethod(this._hasWhere)} 了`);\n\n // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n const realWhere = objectFilter(where, (value) => value !== undefined);\n\n const whereKeys = Object.keys(realWhere);\n\n // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n const isWhereId =\n whereKeys.length === 1 &&\n '_id' in realWhere &&\n (isString(realWhere._id) \|\| isNumber(realWhere._id));\n\n if (isWhereId && this._hasLimit) {\n throw new Error(\n `db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`,\n );\n }\n\n this._hasWhere = from;\n this._where = realWhere;\n if (isWhereId) this._hasWhereId = from;\n\n return this;\n }\n\n /\n 设置查询条件\n * @param where 查询条件对象\n * @returns 当前Db实例，支持链式调用\n /\n where(where: DbWhere<D1> & W2) {\n return this._doWhere(where, 'where');\n }\n\n /\n 获取当前查询条件\n * @param plain 是否返回原始查询条件对象，默认 false\n * @returns 当前查询条件对象\n /\n getWhere(plain?: boolean) {\n return plain\n ? // biome-ignore lint/suspicious/noTsIgnore: 必须这么用\n // @ts-ignore\n objectOmit(this._where, Object.keys(this._lookupAs))\n : this._where;\n }\n\n /\n 根据ID设置查询条件\n * @param id 记录ID\n * @returns 当前Db实例，支持链式调用\n /\n whereId(id: string \| number) {\n // @ts-expect-error\n return this._doWhere({ _id: id }, 'whereId');\n }\n\n private _hasSelect = 0;\n private _select = {};\n\n /\n 指定要返回的字段\n * @param fields 要返回的字段对象，true表示返回，false表示不返回\n * @returns 当前Db实例，支持链式调用\n /\n select<const S extends DbSelect<D1>>(fields: S) {\n if (this._hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n this._hasSelect++;\n this._select = fields;\n\n return this as Db<D1, S, D2, W2>;\n }\n\n private _hasOrder = 0;\n private _order = {};\n\n /\n 设置排序规则\n * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n * @returns 当前Db实例，支持链式调用\n /\n order(order: DbOrder<D1>) {\n this._hasOrder++;\n this._order = order;\n\n return this;\n }\n\n private _hasSkip = 0;\n private _skip = 0;\n\n /\n 跳过指定数量的记录\n * @param skip 要跳过的记录数\n * @returns 当前Db实例，支持链式调用\n /\n skip(skip: number) {\n if (this._hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n this._hasSkip++;\n this._skip = skip;\n\n return this;\n }\n\n private _hasLimit = 0;\n private _limit = 0;\n\n /\n 限制返回的记录数量\n * @param limit 最大返回记录数\n * @returns 当前Db实例，支持链式调用\n /\n limit(limit: number) {\n if (this._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n if (this._hasWhereId) {\n throw new Error(\n `db.limit() 方法不能与 ${_toWhereIdMethod(this._hasWhereId)} 方法同时调用`,\n );\n }\n\n this._hasLimit++;\n this._limit = limit;\n\n return this;\n }\n\n private _hasLookup = 0;\n get hasLookup() {\n return this._hasLookup > 0;\n }\n\n private _lookups: DbLookup[] = [];\n lookup<\n FD1,\n FS1 extends DbSelect<FD1>,\n FD2 extends AnyObject,\n FW2 extends AnyObject,\n RL extends DbRelation,\n AS extends string,\n // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n US extends boolean \| undefined \| void = undefined,\n >(\n table: Db<FD1, FS1, FD2, FW2>,\n lookup: DbLookupOptions<RL, D1, FD1, AS, US>,\n ) {\n // 对方表也记为关联查询，避免做表更新操作\n table._hasLookup++;\n this._hasLookup++;\n this._lookups.push({\n ...lookup,\n table,\n } as unknown as DbLookup);\n\n // @ts-expect-error\n return this as Db<\n D1,\n S1,\n US extends true\n ? D2\n : MergeIntersection<D2 & DbForeign<FD1, FS1, FD2, RL, AS>>,\n MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>\n >;\n }\n\n private _aggregated = false;\n private _lookupAs = {} as Record<string, true>;\n private _endAggregate(aggRef: UniCloud.AggregateReference) {\n if (this._aggregated)\n throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n this._aggregated = true;\n let returnAggRef = aggRef;\n let _hasAggSelect = 0;\n const aggSelect = {} as Record<string, true>;\n let hasAggUnselect = 0;\n const aggUnselect = {} as Record<string, false>;\n\n // 后做关联查询\n for (const {\n relation: type,\n as,\n foreignField,\n localField,\n table,\n unselect,\n } of this._lookups) {\n const letName = `let${gid++}`;\n let pipeline = dbAgg.pipeline();\n\n // 关联条件\n // @ts-expect-error\n pipeline = pipeline.match({\n $expr: {\n $and: [\n type === 'n:1'\n ? { $in: [`$${foreignField}`, `$$${letName}`] }\n : { $eq: [`$${foreignField}`, `$$${letName}`] },\n ],\n },\n });\n\n // 其他查询条件\n // @ts-expect-error\n pipeline = table._endAggregate(pipeline);\n\n // @ts-expect-error\n pipeline = pipeline.done();\n\n returnAggRef = returnAggRef.lookup({\n let: {\n [letName]: `$${localField}`,\n },\n as,\n from: table.table,\n pipeline,\n });\n\n // 1对1，展开数组\n if (type === '1:1') {\n // @ts-expect-error\n returnAggRef = returnAggRef.unwind({\n path: `$${as}`,\n preserveNullAndEmptyArrays: true,\n });\n }\n\n if (unselect) {\n hasAggUnselect++;\n aggUnselect[as] = false;\n } else {\n _hasAggSelect++;\n aggSelect[as] = true;\n }\n\n this._lookupAs[as] = true;\n }\n\n // 主表查询，注意顺序，筛选->排序->跳过->限制\n if (this._hasWhere)\n returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));\n if (this._hasOrder)\n returnAggRef = returnAggRef.sort(\n objectMap(this._order, (v) => (v === 'asc' ? 1 : -1)),\n );\n if (this._hasSkip) returnAggRef = returnAggRef.skip(this._skip);\n if (this._hasLimit) returnAggRef = returnAggRef.limit(this._limit);\n\n // 如果主表有选择字段，则合并选择字段（包括关联查询的字段和排序字段）\n if (this._hasSelect) {\n returnAggRef = returnAggRef.project(\n _mergeSelect({ ...this._select, ...aggSelect }, this._order),\n );\n }\n // 如果主表没有选择字段，则排除取消选择字段\n else if (hasAggUnselect) {\n returnAggRef = returnAggRef.project(aggUnselect);\n }\n\n return returnAggRef;\n }\n\n private _endHost(action: 'query' \| 'create' \| 'update' \| 'remove' \| 'count') {\n if (this._hasWhere) {\n // 事务模式下：更新/删除只能用 doc(id)\n if ((action === 'update' \|\| action === 'remove') && this._isTransaction) {\n // @ts-expect-error\n this._host = this._host.doc(this._where._id);\n } else {\n // @ts-expect-error\n this._host = this._host.where(_mapCommandRaw(this._where));\n }\n }\n\n if (this._hasSelect) {\n // @ts-expect-error\n this._host = this._host.field(_mergeSelect(this._select, this._order));\n }\n\n if (this._hasOrder) {\n objectEach(this._order, (val, key) => {\n // @ts-expect-error\n this._host = this._host.orderBy(key, val);\n });\n }\n\n // @ts-expect-error\n if (this._hasSkip) this._host = this._host.skip(this._skip);\n\n if (this._hasLimit && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(this._limit);\n else if (this._hasWhereId && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(1);\n }\n\n /\n 执行查询操作\n * @returns 查询结果\n /\n async many() {\n try {\n if (this._isTransaction) throw new Error('db.many() 方法不支持事务模式');\n\n let res: { data: DbQuery<D1, S1, D2>[] };\n\n // 关联查询\n if (this._hasLookup) {\n const aggRef = this.aggregate();\n this._endAggregate(aggRef);\n res = await aggRef.end();\n }\n // 单表查询\n else {\n this._endHost('query');\n res = await this._host.get();\n }\n\n const { data } = parseDatabaseOutput(res);\n return data;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 只查询一条，自动添加 limit(1) 条件\n * 如果没有匹配到记录，会抛出错误\n * @returns 查询结果\n /\n async firstOrThrow(): Promise<DbQuery<D1, S1, D2>> {\n if (this._isTransaction)\n throw new Error('db.firstOrThrow() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrThrow() 方法不支持 limit 条件');\n if (!this._hasWhereId) this.limit(1);\n\n const data = await this.many();\n const res = data.at(0);\n\n if (!res) throw createCloudObjectError('查询数据为空', 'firstOrThrow');\n return res;\n }\n\n /\n 只查询一条，自动添加 limit(1) 条件\n * 如果没有匹配到记录，返回 null\n * @returns 查询结果或 null\n /\n async firstOrNull(): Promise<DbQuery<D1, S1, D2> \| null> {\n if (this._isTransaction)\n throw new Error('db.firstOrNull() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrNull() 方法不支持 limit 条件');\n if (!this._hasWhereId) this.limit(1);\n\n const data = await this.many();\n return data.at(0) \|\| null;\n }\n\n /\n 获取匹配记录的数量\n * @returns 记录总数\n /\n async count() {\n if (this._isTransaction) throw new Error('db.count() 方法不支持事务模式');\n if (this._hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n if (this._hasSelect) throw new Error('db.count() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.count() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.count() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.count() 方法不支持 limit 条件');\n\n try {\n this._endHost('count');\n const res = await this._host.count();\n const { total } = parseDatabaseOutput<{ total: number }>(res);\n return total;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 创建新记录\n * @param data 要创建的数据\n * @returns 创建结果\n /\n async create(data: DbCreate<D1>) {\n if (this._hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n if (this._hasWhere) throw new Error('db.create() 方法不支持 where 条件');\n if (this._hasSelect) throw new Error('db.create() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.create() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.create() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.create() 方法不支持 limit 条件');\n\n try {\n this._endHost('create');\n const res = await this._host.add(data);\n const { id } = parseDatabaseOutput<{ id: string }>(res);\n return id;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 更新记录\n * @param data 要更新的数据\n * @returns 更新结果\n /\n async update(data: DbUpdate<D1>) {\n if (this._hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n if (!this._hasWhere)\n throw new Error('设置 where 条件后才能执行 db.update() 方法');\n if (this._hasSelect) throw new Error('db.update() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.update() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.update() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.update() 方法不支持 limit 条件');\n\n if (this._isTransaction && !this._hasWhereId)\n throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n try {\n this._endHost('update');\n const res = await this._host.update(\n objectOmit(_mapCommandRaw(data), ['_id']),\n );\n const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n return updated;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 删除记录\n * @returns 删除结果\n /\n async remove() {\n if (this._hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n if (!this._hasWhere)\n throw new Error('设置 where 条件后才能执行 db.remove() 方法');\n if (this._hasSelect) throw new Error('db.remove() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.remove() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.remove() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.remove() 方法不支持 limit 条件');\n\n if (this._isTransaction && !this._hasWhereId)\n throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n try {\n this._endHost('remove');\n const res = await this._host.remove();\n const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n return deleted;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: 必须这么用\nfunction _mapCommandRaw(data: any) {\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n const map = (val: any): any => {\n if (!isObject(val)) return val;\n if (val instanceof DbBaseCommand) return DbBaseCommand.getValue(val, db0);\n return objectMap(val, map);\n };\n\n return objectMap(data, map);\n}\n\nfunction _mapOrderSelect(order: DbOrder<unknown>) {\n return objectMap(order, (_val, _key) => true);\n}\n\nfunction _mergeSelect(select: DbSelect<unknown>, order: DbOrder<unknown>) {\n const noSelect = Object.keys(select).length === 0;\n // 如果没有 select 条件，默认返回所有字段\n if (noSelect) return select;\n\n const onlyOmitId =\n Object.keys(select).length === 1 && '_id' in select && select._id === false;\n // 如果只排除 _id 字段，则保持现状\n if (onlyOmitId) return select;\n\n return {\n ...select,\n ..._mapOrderSelect(order),\n };\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { UniError } from '@/_types';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\nexport type DbProxyOptions = {\n /\n 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n /\n parseError?: (error: UniError) => UniError;\n};\n\n/\n 创建一个数据库代理对象，用于延迟实例化数据库操作类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @param name - 数据库表名\n * @returns 返回一个代理对象，该对象会将属性访问转发到实际的数据库操作实例\n /\n\n// biome-ignore lint/complexity/noBannedTypes: 必须这么用\nexport function dbProxy<D1, S1 extends DbSelect<D1> = {}>(\n name: string,\n options?: DbProxyOptions,\n) {\n return new Proxy(\n {},\n {\n get(_target, prop) {\n if (prop === '_isProxy') return true;\n\n const table = new Db<D1, S1>({ table: name, ...options });\n const tableProp = prop as keyof Db<D1, S1>;\n const ref = table[tableProp];\n\n return isFunction(ref) ? ref.bind(table) : ref;\n },\n },\n ) as Db<D1, S1>;\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { Db } from './_db.class';\n\ntype _TransactionDb = {\n startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n commit: () => Promise<unknown>;\n rollback: () => Promise<unknown>;\n};\n\nexport type WithTransaction = <D1>(db: Db<D1>) => Db<D1>;\n\n/\n 在数据库事务中执行操作\n \n @template K - 事务操作返回值类型\n * @param transacting - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库对象\n * @param _mockDbInstance - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n \n @example\n * ```typescript\n * const result = await dbTransaction(async (withTransaction) => {\n * const userId = await withTransaction(db.table('user')).create({ name: 'John' });\n * const order = await withTransaction(db.table('orders')).create({ userId, amount: 100 });\n * return { user, order };\n * });\n * ```\n /\nexport async function dbTransaction<K>(\n transacting: (withTransaction: WithTransaction) => Promise<K>,\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDatabase?: any,\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any,\n) {\n const transactionDb = (_mockDatabase \|\|\n uniCloud.database()) as _TransactionDb;\n\n const [err1, transaction] = await tryFlatten(\n transactionDb.startTransaction(),\n );\n if (err1) throw err1;\n\n const withTransaction: WithTransaction = <D1>(db: Db<D1>) => {\n return _mockDbInstance \|\| new Db<D1>({ ...db.options, transaction });\n };\n\n const [err2, result] = await tryFlatten(async () => {\n const result = await transacting(withTransaction);\n await transaction.commit();\n return result;\n });\n\n if (err2) {\n await tryFlatten(transaction.rollback());\n throw err2;\n }\n\n return result as unknown as K;\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { Db } from './_db.class';\nimport type { DbCreate, DbQuery, DbUpdate } from './types';\n\nexport type DbUpsertOptions<T, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n /* 创建数据 /\n create: C;\n\n /\n 更新数据，可以是对象或根据查询结果生成更新对象的函数\n * @param row 查询到的文档数据，仅在传入函数时可用\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n update: U \| ((exist: DbQuery<T, {}, {}>) => U);\n\n /* 创建前回调函数 /\n onBeforeCreate?: () => unknown;\n\n /\n 创建后回调函数\n * @param id 创建的文档ID\n /\n onAfterCreate?: (id: string) => unknown;\n\n /\n 更新前回调函数\n * @param exist 查询到的原始文档数据\n * @returns 如果返回 false，则取消更新操作\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n onBeforeUpdate?: (exist: DbQuery<T, {}, {}>) => false \| unknown;\n\n /\n 更新后回调函数\n * @param updateData 实际更新的数据\n * @param exist 查询到的原始文档数据\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n onAfterUpdate?: (updateData: U, exist: DbQuery<T, {}, {}>) => unknown;\n\n /* 用于测试的模拟数据库实例 /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any;\n};\n\n/\n 数据库 upsert 操作的返回结果类型\n /\nexport type DbUpsertOutput = {\n /* 操作的文档ID /\n id: string;\n /* 是否为创建操作 /\n created: boolean;\n /* 是否为更新操作 /\n updated: boolean;\n};\n\nexport async function dbUpsert<\n D1,\n C extends DbCreate<D1>,\n U extends DbUpdate<D1>,\n>(db: Db<D1>, options: DbUpsertOptions<D1, C, U>): Promise<DbUpsertOutput> {\n const {\n create,\n update,\n onBeforeCreate,\n onAfterCreate,\n onBeforeUpdate,\n onAfterUpdate,\n _mockDbInstance,\n } = options;\n\n const _mutateDb = (_mockDbInstance \|\| db.clone()) as Db<D1>;\n const _queryDb = (_mockDbInstance \|\| db.clone(true)) as Db<D1>;\n\n const exist = (await _queryDb\n .where(db.getWhere(true))\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n .firstOrNull()) as DbQuery<D1, {}, {}> \| null;\n\n if (exist) {\n const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n if (skipUpdate) {\n // @ts-expect-error\n return { id: exist._id as string, updated: false, created: false };\n }\n\n const updateData = isFunction(update) ? update(exist) : update;\n // @ts-expect-error\n await _mutateDb.whereId(exist._id).update(updateData);\n onAfterUpdate?.(updateData, exist);\n\n // @ts-expect-error\n return { id: exist._id as string, updated: true, created: false };\n }\n\n await onBeforeCreate?.();\n const createdId = await _mutateDb.create(create);\n await onAfterCreate?.(createdId);\n\n return { id: createdId, updated: false, created: true };\n}\n","import type { Db } from './_db.class';\nimport type { DbCreate } from './types';\nimport { dbUpsert } from './upsert';\n\nexport type DbUniqueOptions<T, C extends DbCreate<T>> = {\n /* 创建数据 /\n create: C;\n\n /* 创建前回调函数 /\n onBeforeCreate?: () => unknown;\n\n /\n 创建后回调函数\n * @param id 创建的文档ID\n /\n onAfterCreate?: (id: string) => unknown;\n\n /* 用于测试的模拟数据库实例 /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any;\n};\n\n/\n 数据库 upsert 操作的返回结果类型\n /\nexport type DbUniqueOutput = {\n /* 操作的文档ID /\n id: string;\n /* 是否为创建操作 */\n created: boolean;\n};\n\nexport async function dbUnique<T, C extends DbCreate<T>>(\n db: Db<T>,\n options: DbUniqueOptions<T, C>,\n): Promise<DbUniqueOutput> {\n const { id, created } = await dbUpsert(db, {\n ...options,\n // @ts-expect-error\n update: {},\n onBeforeUpdate: () => false,\n });\n return { id, created };\n}\n"],"mappings":";;;;;;;AAEA,IAAa,gBAAb,MAA2B;CACzB,WAAqB;CACrB,YAAsB;CAEtB,YACE,UACA,YACA,UAIA;EANQ,KAAA,WAAA;EACA,KAAA,aAAA;EACA,KAAA,WAAA;;CAMV,OAAO,SAAS,KAAoB,IAAuB;EACzD,IAAI,IAAI,UAAU,cAChB,OAAO,IAAI,SAAS,aAAa,IAAI,IAAI,WAAW;EAGtD,OACE,GAAG,QACH,IAAI,UAAU,KACd,GAAG,SACH,IAAI,UAAU,kBAAkB,GAAG,IAAI,IAAI,WAC5C;;CAGH,OAAO,cAAc,KAAoB,WAAmB;EAC1D,OAAO,GACJ,IAAI,IAAI,aAAa,CAAC,WAAW,IAAI,WAAW,EAClD;;CAGH,OAAO,eAAe,KAAoB;EACxC,OAAO,IAAI;;CAGb,OAAO,gBAAgB,KAAoB;EACzC,OAAO,IAAI;;;AAIf,IAAa,iBAAb,cAAoC,cAAc;CAChD,WAAqB;;AAGvB,IAAa,kBAAb,cAAqC,cAAc;CACjD,YAAsB;;;;;;;ACvCxB,IAAa,UAAU;;;;;;CAMrB,KAAK,UAAmB,IAAI,eAAe,MAAM,MAAM;;;;;;CAOvD,MAAM,UAAmB,IAAI,eAAe,OAAO,MAAM;;;;;;CAOzD,KAAK,UAAmB,IAAI,eAAe,MAAM,MAAM;;;;;;CAOvD,MAAM,UAAmB,IAAI,eAAe,OAAO,MAAM;;;;;;CAOzD,KAAK,UAAmB,IAAI,eAAe,MAAM,MAAM;;;;;;CAOvD,MAAM,UAAmB,IAAI,eAAe,OAAO,MAAM;;;;;;CAOzD,KAAK,UAAqB,IAAI,eAAe,MAAM,MAAM;;;;;;CAOzD,MAAM,UAAqB,IAAI,eAAe,OAAO,MAAM;;;;;;CAO3D,OAAO,SAAiB,IAAI,eAAe,QAAQ,KAAK;;;;;;CAOxD,SAAS,WACP,IAAI,eAAe,UAAU,QAAQ,EACnC,eAAe,KAAK,cAAc,WACnC,CAAC;;;;;;CAOJ,MAAM,eACJ,IAAI,eAAe,OAAO,YAAY,EACpC,kBAAkB,OAChB,WAAW,KAAK,MAAM,cAAc,SAAS,GAAG,GAAG,CAAC,EACvD,CAAC;;;;;;CAOJ,KAAK,eACH,IAAI,eAAe,MAAM,YAAY,EACnC,kBAAkB,OAChB,WAAW,KAAK,MAAM,cAAc,SAAS,GAAG,GAAG,CAAC,EACvD,CAAC;CACL;;;;AAKD,IAAa,WAAW;;;;;;CAMtB,MAAM,UAAkB,IAAI,gBAAgB,OAAO,MAAM;;;;;;CAOzD,MAAM,UAAkB,IAAI,gBAAgB,OAAO,MAAM;;;;;;CAOzD,MAAM,UAAmB,IAAI,gBAAgB,OAAO,MAAM;;;;;;CAO1D,OAAO,UAAmB,IAAI,gBAAgB,QAAQ,MAAM;;;;;;CAO5D,UAAU,UAAmB,IAAI,gBAAgB,WAAW,MAAM;;;;;CAMlE,WAAW,IAAI,gBAAgB,OAAO,KAAA,EAAU;;;;;CAMhD,aAAa,IAAI,gBAAgB,SAAS,KAAA,EAAU;;;;;CAMpD,cAAc,IAAI,gBAAgB,UAAU,KAAA,EAAU;CACvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACnID,eAAsB,OACpB,OACA,OACA,UACA,WAAW,OAAO,kBAClB;CACA,MAAM,QAAQ,KAAK,IAAI,MAAM,MAAM,MAAM,MAAM,CAAC,OAAO,EAAE,SAAS;CAClE,MAAM,QAAQ;CAEd,KAAK,IAAI,OAAO,GAAG,OAAO,OAAO,QAAQ,OAAO;EAC9C,MAAM,OAAO,MAAM,MAAM,MAAM,MAAM,CAAC,MAAM,MAAM,CAAC,KAAK,KAAK,CAAC,MAAM;EAEpE,KAAK,MAAM,OAAO,MAChB,MAAM,SAAS,IAAS;;;;;;;;;;;ACjC9B,eAAsB,SAQpB,SAA6B;CAE7B,MAAM,QAAQ,QAAQ,SAAS,KAAK;CAGpC,MAAM,UAAU,QAAQ,OAAO;CAS/B,OAAO;EACL,MAAA,MAPiB,QAAQ,MAAM;EAQ/B,OAAA,MALkB,QAAQ,MAAM,MAAM,CAAC,OAAO;EAM/C;;;;;;;ACVH,IAAM,QAAQ,SAAS,UAAU,CAAC,QAC/B;AAQH,IAAM,MAAM,SAAS,UAAU;AA4E/B,IAAI,MAAM;;;;;;;;AASV,IAAa,KAAb,MAAa,GAQX;CACA;;;;;;CAOA,iBAAyB;CAEzB;;;;;;CAOA,YAAY,SAAoB;EAC9B,KAAK,WAAW;EAChB,KAAK,QACH,QAAQ,iBACR,QAAQ,aAAa,WAAW,QAAQ,MAAM,IAC9C,IAAI,WAAW,QAAQ,MAAM;EAC/B,KAAK,iBAAiB,CAAC,CAAC,QAAQ;;;;;;;CAQlC,MAAM,oBAA8B;EAClC,OAAO,IAAI,GAAG;GACZ,GAAG,KAAK;GACR,aAAa,qBAAqB,OAAO,KAAK,SAAS;GACxD,CAAC;;CAGJ,IAAI,QAAQ;EACV,OAAO,KAAK,SAAS;;CAGvB,IAAI,UAAU;EACZ,OAAO,KAAK;;CAGd,IAAI,gBAAgB;EAClB,OAAO,KAAK;;;;;;CAOd,YAAY;EACV,OAAO,KAAK,MAAM,WAAW;;CAG/B,YAA4C,KAAA;CAC5C,cAA8C,KAAA;CAC9C,SAAiB,EAAE;CAEnB,SAAiB,OAAoB,MAAkB;EACrD,IAAI,KAAK,WACP,MAAM,IAAI,MAAM,aAAa,eAAe,KAAK,UAAU,CAAC,IAAI;EAGlE,MAAM,aAAA,GAAA,6BAAA,cAAyB,QAAQ,UAAU,UAAU,KAAA,EAAU;EAKrE,MAAM,YAHY,OAAO,KAAK,UAI5B,CAAU,WAAW,KACrB,SAAS,eAAA,GAAA,2BAAA,UACC,UAAU,IAAI,KAAA,GAAA,2BAAA,UAAa,UAAU,IAAI;EAErD,IAAI,aAAa,KAAK,WACpB,MAAM,IAAI,MACR,MAAM,iBAAiB,KAAK,CAAC,0BAC9B;EAGH,KAAK,YAAY;EACjB,KAAK,SAAS;EACd,IAAI,WAAW,KAAK,cAAc;EAElC,OAAO;;;;;;;CAQT,MAAM,OAAyB;EAC7B,OAAO,KAAK,SAAS,OAAO,QAAQ;;;;;;;CAQtC,SAAS,OAAiB;EACxB,OAAO,SAAA,GAAA,6BAAA,YAGQ,KAAK,QAAQ,OAAO,KAAK,KAAK,UAAU,CAAC,GACpD,KAAK;;;;;;;CAQX,QAAQ,IAAqB;EAE3B,OAAO,KAAK,SAAS,EAAE,KAAK,IAAI,EAAE,UAAU;;CAG9C,aAAqB;CACrB,UAAkB,EAAE;;;;;;CAOpB,OAAqC,QAAW;EAC9C,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,uBAAuB;EAE5D,KAAK;EACL,KAAK,UAAU;EAEf,OAAO;;CAGT,YAAoB;CACpB,SAAiB,EAAE;;;;;;CAOnB,MAAM,OAAoB;EACxB,KAAK;EACL,KAAK,SAAS;EAEd,OAAO;;CAGT,WAAmB;CACnB,QAAgB;;;;;;CAOhB,KAAK,MAAc;EACjB,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,qBAAqB;EAExD,KAAK;EACL,KAAK,QAAQ;EAEb,OAAO;;CAGT,YAAoB;CACpB,SAAiB;;;;;;CAOjB,MAAM,OAAe;EACnB,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,sBAAsB;EAE1D,IAAI,KAAK,aACP,MAAM,IAAI,MACR,oBAAoB,iBAAiB,KAAK,YAAY,CAAC,SACxD;EAGH,KAAK;EACL,KAAK,SAAS;EAEd,OAAO;;CAGT,aAAqB;CACrB,IAAI,YAAY;EACd,OAAO,KAAK,aAAa;;CAG3B,WAA+B,EAAE;CACjC,OAUE,OACA,QACA;EAEA,MAAM;EACN,KAAK;EACL,KAAK,SAAS,KAAK;GACjB,GAAG;GACH;GACD,CAAwB;EAGzB,OAAO;;CAUT,cAAsB;CACtB,YAAoB,EAAE;CACtB,cAAsB,QAAqC;EACzD,IAAI,KAAK,aACP,MAAM,IAAI,MAAM,YAAY,KAAK,MAAM,SAAS;EAElD,KAAK,cAAc;EACnB,IAAI,eAAe;EACnB,IAAI,gBAAgB;EACpB,MAAM,YAAY,EAAE;EACpB,IAAI,iBAAiB;EACrB,MAAM,cAAc,EAAE;EAGtB,KAAK,MAAM,EACT,UAAU,MACV,IACA,cACA,YACA,OACA,cACG,KAAK,UAAU;GAClB,MAAM,UAAU,MAAM;GACtB,IAAI,WAAW,MAAM,UAAU;GAI/B,WAAW,SAAS,MAAM,EACxB,OAAO,EACL,MAAM,CACJ,SAAS,QACL,EAAE,KAAK,CAAC,IAAI,gBAAgB,KAAK,UAAU,EAAE,GAC7C,EAAE,KAAK,CAAC,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAClD,EACF,EACF,CAAC;GAIF,WAAW,MAAM,cAAc,SAAS;GAGxC,WAAW,SAAS,MAAM;GAE1B,eAAe,aAAa,OAAO;IACjC,KAAK,GACF,UAAU,IAAI,cAChB;IACD;IACA,MAAM,MAAM;IACZ;IACD,CAAC;GAGF,IAAI,SAAS,OAEX,eAAe,aAAa,OAAO;IACjC,MAAM,IAAI;IACV,4BAA4B;IAC7B,CAAC;GAGJ,IAAI,UAAU;IACZ;IACA,YAAY,MAAM;UACb;IACL;IACA,UAAU,MAAM;;GAGlB,KAAK,UAAU,MAAM;;EAIvB,IAAI,KAAK,WACP,eAAe,aAAa,MAAM,eAAe,KAAK,OAAO,CAAC;EAChE,IAAI,KAAK,WACP,eAAe,aAAa,MAAA,GAAA,6BAAA,WAChB,KAAK,SAAS,MAAO,MAAM,QAAQ,IAAI,GAAI,CACtD;EACH,IAAI,KAAK,UAAU,eAAe,aAAa,KAAK,KAAK,MAAM;EAC/D,IAAI,KAAK,WAAW,eAAe,aAAa,MAAM,KAAK,OAAO;EAGlE,IAAI,KAAK,YACP,eAAe,aAAa,QAC1B,aAAa;GAAE,GAAG,KAAK;GAAS,GAAG;GAAW,EAAE,KAAK,OAAO,CAC7D;OAGE,IAAI,gBACP,eAAe,aAAa,QAAQ,YAAY;EAGlD,OAAO;;CAGT,SAAiB,QAA4D;EAC3E,IAAI,KAAK,WAEP,KAAK,WAAW,YAAY,WAAW,aAAa,KAAK,gBAEvD,KAAK,QAAQ,KAAK,MAAM,IAAI,KAAK,OAAO,IAAI;OAG5C,KAAK,QAAQ,KAAK,MAAM,MAAM,eAAe,KAAK,OAAO,CAAC;EAI9D,IAAI,KAAK,YAEP,KAAK,QAAQ,KAAK,MAAM,MAAM,aAAa,KAAK,SAAS,KAAK,OAAO,CAAC;EAGxE,IAAI,KAAK,WACP,CAAA,GAAA,6BAAA,YAAW,KAAK,SAAS,KAAK,QAAQ;GAEpC,KAAK,QAAQ,KAAK,MAAM,QAAQ,KAAK,IAAI;IACzC;EAIJ,IAAI,KAAK,UAAU,KAAK,QAAQ,KAAK,MAAM,KAAK,KAAK,MAAM;EAE3D,IAAI,KAAK,aAAa,WAAW,SAE/B,KAAK,QAAQ,KAAK,MAAM,MAAM,KAAK,OAAO;OACvC,IAAI,KAAK,eAAe,WAAW,SAEtC,KAAK,QAAQ,KAAK,MAAM,MAAM,EAAE;;;;;;CAOpC,MAAM,OAAO;EACX,IAAI;GACF,IAAI,KAAK,gBAAgB,MAAM,IAAI,MAAM,sBAAsB;GAE/D,IAAI;GAGJ,IAAI,KAAK,YAAY;IACnB,MAAM,SAAS,KAAK,WAAW;IAC/B,KAAK,cAAc,OAAO;IAC1B,MAAM,MAAM,OAAO,KAAK;UAGrB;IACH,KAAK,SAAS,QAAQ;IACtB,MAAM,MAAM,KAAK,MAAM,KAAK;;GAG9B,MAAM,EAAE,SAAS,iBAAA,oBAAoB,IAAI;GACzC,OAAO;WACA,KAAK;GACZ,MAAM,QAAQ;GACd,MAAM,KAAK,SAAS,aAAa,MAAM,IAAI;;;;;;;;CAS/C,MAAM,eAA6C;EACjD,IAAI,KAAK,gBACP,MAAM,IAAI,MAAM,8BAA8B;EAChD,IAAI,KAAK,WACP,MAAM,IAAI,MAAM,mCAAmC;EACrD,IAAI,CAAC,KAAK,aAAa,KAAK,MAAM,EAAE;EAGpC,MAAM,OAAM,MADO,KAAK,MAAM,EACb,GAAG,EAAE;EAEtB,IAAI,CAAC,KAAK,MAAM,cAAA,uBAAuB,UAAU,eAAe;EAChE,OAAO;;;;;;;CAQT,MAAM,cAAmD;EACvD,IAAI,KAAK,gBACP,MAAM,IAAI,MAAM,6BAA6B;EAC/C,IAAI,KAAK,WACP,MAAM,IAAI,MAAM,kCAAkC;EACpD,IAAI,CAAC,KAAK,aAAa,KAAK,MAAM,EAAE;EAGpC,QAAO,MADY,KAAK,MAAM,EAClB,GAAG,EAAE,IAAI;;;;;;CAOvB,MAAM,QAAQ;EACZ,IAAI,KAAK,gBAAgB,MAAM,IAAI,MAAM,uBAAuB;EAChE,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,6BAA6B;EAClE,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,6BAA6B;EAClE,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,4BAA4B;EAChE,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,2BAA2B;EAC9D,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,4BAA4B;EAEhE,IAAI;GACF,KAAK,SAAS,QAAQ;GAEtB,MAAM,EAAE,UAAU,iBAAA,oBAAuC,MADvC,KAAK,MAAM,OAAO,CACyB;GAC7D,OAAO;WACA,KAAK;GACZ,MAAM,QAAQ;GACd,MAAM,KAAK,SAAS,aAAa,MAAM,IAAI;;;;;;;;CAS/C,MAAM,OAAO,MAAoB;EAC/B,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,8BAA8B;EACnE,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,6BAA6B;EACjE,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,8BAA8B;EACnE,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,6BAA6B;EACjE,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,4BAA4B;EAC/D,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,6BAA6B;EAEjE,IAAI;GACF,KAAK,SAAS,SAAS;GAEvB,MAAM,EAAE,OAAO,iBAAA,oBAAoC,MADjC,KAAK,MAAM,IAAI,KAAK,CACiB;GACvD,OAAO;WACA,KAAK;GACZ,MAAM,QAAQ;GACd,MAAM,KAAK,SAAS,aAAa,MAAM,IAAI;;;;;;;;CAS/C,MAAM,OAAO,MAAoB;EAC/B,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,8BAA8B;EACnE,IAAI,CAAC,KAAK,WACR,MAAM,IAAI,MAAM,kCAAkC;EACpD,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,8BAA8B;EACnE,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,6BAA6B;EACjE,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,4BAA4B;EAC/D,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,6BAA6B;EAEjE,IAAI,KAAK,kBAAkB,CAAC,KAAK,aAC/B,MAAM,IAAI,MAAM,sCAAsC;EAExD,IAAI;GACF,KAAK,SAAS,SAAS;GAIvB,MAAM,EAAE,YAAY,iBAAA,oBAAyC,MAH3C,KAAK,MAAM,QAAA,GAAA,6BAAA,YAChB,eAAe,KAAK,EAAE,CAAC,MAAM,CAAC,CAC1C,CACgE;GACjE,OAAO;WACA,KAAK;GACZ,MAAM,QAAQ;GACd,MAAM,KAAK,SAAS,aAAa,MAAM,IAAI;;;;;;;CAQ/C,MAAM,SAAS;EACb,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,8BAA8B;EACnE,IAAI,CAAC,KAAK,WACR,MAAM,IAAI,MAAM,kCAAkC;EACpD,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,8BAA8B;EACnE,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,6BAA6B;EACjE,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,4BAA4B;EAC/D,IAAI,KAAK,WAAW,MAAM,IAAI,MAAM,6BAA6B;EAEjE,IAAI,KAAK,kBAAkB,CAAC,KAAK,aAC/B,MAAM,IAAI,MAAM,sCAAsC;EAExD,IAAI;GACF,KAAK,SAAS,SAAS;GAEvB,MAAM,EAAE,YAAY,iBAAA,oBAAyC,MAD3C,KAAK,MAAM,QAAQ,CAC4B;GACjE,OAAO;WACA,KAAK;GACZ,MAAM,QAAQ;GACd,MAAM,KAAK,SAAS,aAAa,MAAM,IAAI;;;;AAKjD,SAAS,eAAe,WAAuB;CAC7C,OAAO,cAAc,UAAU,iBAAiB;;AAGlD,SAAS,iBAAiB,WAAuB;CAC/C,OAAO,cAAc,UAAU,mBAAmB;;AAIpD,SAAS,eAAe,MAAW;CAEjC,MAAM,OAAO,QAAkB;EAC7B,IAAI,EAAA,GAAA,2BAAA,UAAU,IAAI,EAAE,OAAO;EAC3B,IAAI,eAAe,eAAe,OAAO,cAAc,SAAS,KAAK,IAAI;EACzE,QAAA,GAAA,6BAAA,WAAiB,KAAK,IAAI;;CAG5B,QAAA,GAAA,6BAAA,WAAiB,MAAM,IAAI;;AAG7B,SAAS,gBAAgB,OAAyB;CAChD,QAAA,GAAA,6BAAA,WAAiB,QAAQ,MAAM,SAAS,KAAK;;AAG/C,SAAS,aAAa,QAA2B,OAAyB;CAGxE,IAFiB,OAAO,KAAK,OAAO,CAAC,WAAW,GAElC,OAAO;CAKrB,IAFE,OAAO,KAAK,OAAO,CAAC,WAAW,KAAK,SAAS,UAAU,OAAO,QAAQ,OAExD,OAAO;CAEvB,OAAO;EACL,GAAG;EACH,GAAG,gBAAgB,MAAM;EAC1B;;;;;;;;;;;ACpqBH,SAAgB,QACd,MACA,SACA;CACA,OAAO,IAAI,MACT,EAAE,EACF,EACE,IAAI,SAAS,MAAM;EACjB,IAAI,SAAS,YAAY,OAAO;EAEhC,MAAM,QAAQ,IAAI,GAAW;GAAE,OAAO;GAAM,GAAG;GAAS,CAAC;EAEzD,MAAM,MAAM,MAAM;EAElB,QAAA,GAAA,2BAAA,YAAkB,IAAI,GAAG,IAAI,KAAK,MAAM,GAAG;IAE9C,CACF;;;;;;;;;;;;;;;;;;;;;;ACRH,eAAsB,cACpB,aAEA,eAEA,iBACA;CAIA,MAAM,CAAC,MAAM,eAAe,OAAA,GAAA,0BAAA,aAHL,iBACrB,SAAS,UAAU,EAGL,kBAAkB,CACjC;CACD,IAAI,MAAM,MAAM;CAEhB,MAAM,mBAAwC,OAAe;EAC3D,OAAO,mBAAmB,IAAI,GAAO;GAAE,GAAG,GAAG;GAAS;GAAa,CAAC;;CAGtE,MAAM,CAAC,MAAM,UAAU,OAAA,GAAA,0BAAA,YAAiB,YAAY;EAClD,MAAM,SAAS,MAAM,YAAY,gBAAgB;EACjD,MAAM,YAAY,QAAQ;EAC1B,OAAO;GACP;CAEF,IAAI,MAAM;EACR,OAAA,GAAA,0BAAA,YAAiB,YAAY,UAAU,CAAC;EACxC,MAAM;;CAGR,OAAO;;;;ACLT,eAAsB,SAIpB,IAAY,SAA6D;CACzE,MAAM,EACJ,QACA,QACA,gBACA,eACA,gBACA,eACA,oBACE;CAEJ,MAAM,YAAa,mBAAmB,GAAG,OAAO;CAGhD,MAAM,QAAS,OAFG,mBAAmB,GAAG,MAAM,KAAK,EAGhD,MAAM,GAAG,SAAS,KAAK,CAAC,CAExB,aAAa;CAEhB,IAAI,OAAO;EAGT,IAFoB,MAAM,iBAAiB,MAAM,KAAM,OAIrD,OAAO;GAAE,IAAI,MAAM;GAAe,SAAS;GAAO,SAAS;GAAO;EAGpE,MAAM,cAAA,GAAA,2BAAA,YAAwB,OAAO,GAAG,OAAO,MAAM,GAAG;EAExD,MAAM,UAAU,QAAQ,MAAM,IAAI,CAAC,OAAO,WAAW;EACrD,gBAAgB,YAAY,MAAM;EAGlC,OAAO;GAAE,IAAI,MAAM;GAAe,SAAS;GAAM,SAAS;GAAO;;CAGnE,MAAM,kBAAkB;CACxB,MAAM,YAAY,MAAM,UAAU,OAAO,OAAO;CAChD,MAAM,gBAAgB,UAAU;CAEhC,OAAO;EAAE,IAAI;EAAW,SAAS;EAAO,SAAS;EAAM;;;;ACrEzD,eAAsB,SACpB,IACA,SACyB;CACzB,MAAM,EAAE,IAAI,YAAY,MAAM,SAAS,IAAI;EACzC,GAAG;EAEH,QAAQ,EAAE;EACV,sBAAsB;EACvB,CAAC;CACF,OAAO;EAAE;EAAI;EAAS"}

package/dist/database.d.ts CHANGED Viewed

@@ -3,6 +3,7 @@ export type { UniError } from './_types';
 export type * from './database/_command.class';
 export type * from './database/_db.class';
 export * from './database/command';
+export * from './database/each';
 export * from './database/paging';
 export * from './database/proxy';
 export * from './database/transaction';

package/dist/database.mjs CHANGED Viewed

@@ -162,6 +162,44 @@ var dbMutate = {
 	remove: () => new DbMutateCommand("remove", void 0)
 };
 //#endregion
+//#region src/database/each.ts
+/**
+* 遍历表中的每一行数据并执行回调函数
+*
+* 采用分批查询策略，每批查询 100 条记录，通过 skip/limit 实现分页遍历，
+* 避免一次性加载大量数据导致内存溢出。
+*
+* 迭代器按顺序串行执行，即每一行数据的迭代器完成后才会处理下一行。
+*
+* @template T - 数据行类型
+* @param table 数据库表代理对象
+* @param where 查询条件
+* @param iterator 对每一行数据执行的异步迭代器函数
+* @param maxCount 最大遍历数量，默认值为 Number.MAX_SAFE_INTEGER。
+*   注意：由于分批查询机制（每批 100 条），实际遍历的行数可能略大于 maxCount，
+*   例如 maxCount=150 时，会分两批查询（0-99、100-199），实际遍历 200 行。
+* @example
+* ```ts
+* // 遍历所有状态为 active 的用户
+* await dbEach(userTable, { status: 'active' }, async (user) => {
+*   await sendEmail(user.email);
+* });
+*
+* // 限制最多遍历 500 条记录
+* await dbEach(orderTable, { status: 'pending' }, async (order) => {
+*   await processOrder(order);
+* }, 500);
+* ```
+*/
+async function dbEach(table, where, iterator, maxCount = Number.MAX_SAFE_INTEGER) {
+	const count = Math.min(await table.where(where).count(), maxCount);
+	const limit = 100;
+	for (let skip = 0; skip < count; skip += limit) {
+		const rows = await table.where(where).limit(limit).skip(skip).many();
+		for (const row of rows) await iterator(row);
+	}
+}
+//#endregion
 //#region src/database/paging.ts
 /**
 * 数据库分页查询函数
@@ -659,6 +697,6 @@ async function dbUnique(db, options) {
 	};
 }
 //#endregion
-export { dbMutate, dbPaging, dbProxy, dbQuery, dbTransaction, dbUnique, dbUpsert, parseDatabaseOutput };
+export { dbEach, dbMutate, dbPaging, dbProxy, dbQuery, dbTransaction, dbUnique, dbUpsert, parseDatabaseOutput };
 //# sourceMappingURL=database.mjs.map

package/dist/database.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"database.mjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/paging.ts","../src/database/_db.class.ts","../src/database/proxy.ts","../src/database/transaction.ts","../src/database/upsert.ts","../src/database/unique.ts"],"sourcesContent":["// 设置私有属性和静态方法是避免在 update 的时候提示类属性\n\nexport class DbBaseCommand {\n protected _isQuery = false;\n protected _isMutate = false;\n\n constructor(\n private _command: string,\n private _parameter: unknown,\n private _options?: {\n formatParameter?: (db: UniCloud.Database) => unknown;\n rewriteValue?: (db: UniCloud.Database, parameter: unknown) => unknown;\n },\n ) {}\n\n static getValue(cmd: DbBaseCommand, db: UniCloud.Database) {\n if (cmd._options?.rewriteValue) {\n return cmd._options.rewriteValue(db, cmd._parameter);\n }\n\n return (\n db.command as unknown as Record<string, (value: unknown) => unknown>\n )[cmd._command].call(\n db.command,\n cmd._options?.formatParameter?.(db) \|\| cmd._parameter,\n );\n }\n\n static getExpression(cmd: DbBaseCommand, fieldName: string) {\n return {\n [`$${cmd._command}`]: [fieldName, cmd._parameter],\n };\n }\n\n static isQueryCommand(cmd: DbBaseCommand) {\n return cmd._isQuery;\n }\n\n static isMutateCommand(cmd: DbBaseCommand) {\n return cmd._isMutate;\n }\n}\n\nexport class DbQueryCommand extends DbBaseCommand {\n protected _isQuery = true;\n}\n\nexport class DbMutateCommand extends DbBaseCommand {\n protected _isMutate = true;\n}\n","import {\n DbBaseCommand,\n DbMutateCommand,\n DbQueryCommand,\n} from './_command.class';\n\n/*\n 数据库查询命令对象，提供各种查询操作符\n /\nexport const dbQuery = {\n /\n 等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n eq: (value: unknown) => new DbQueryCommand('eq', value),\n\n /\n 不等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n neq: (value: unknown) => new DbQueryCommand('neq', value),\n\n /\n 大于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n gt: (value: unknown) => new DbQueryCommand('gt', value),\n\n /\n 大于等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n gte: (value: unknown) => new DbQueryCommand('gte', value),\n\n /\n 小于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n lt: (value: unknown) => new DbQueryCommand('lt', value),\n\n /\n 小于等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n lte: (value: unknown) => new DbQueryCommand('lte', value),\n\n /\n 包含在数组中操作符\n * @param value 值数组\n * @returns DbQueryCommand 查询命令对象\n /\n in: (value: unknown[]) => new DbQueryCommand('in', value),\n\n /\n 不包含在数组中操作符\n * @param value 值数组\n * @returns DbQueryCommand 查询命令对象\n /\n nin: (value: unknown[]) => new DbQueryCommand('nin', value),\n\n /\n 数组长度匹配操作符\n * @param size 数组长度\n * @returns DbQueryCommand 查询命令对象\n /\n size: (size: number) => new DbQueryCommand('size', size),\n\n /\n 正则表达式匹配操作符\n * @param regExp 正则表达式\n * @returns DbQueryCommand 查询命令对象\n /\n regExp: (regExp: RegExp) =>\n new DbQueryCommand('regExp', regExp, {\n rewriteValue: (_db, parameter) => parameter,\n }),\n\n /\n 逻辑与操作符\n * @param conditions 查询条件参数\n * @returns DbQueryCommand 查询命令对象\n /\n and: (conditions: DbQueryCommand[]) =>\n new DbQueryCommand('and', conditions, {\n formatParameter: (db) =>\n conditions.map((c) => DbBaseCommand.getValue(c, db)),\n }),\n\n /\n 逻辑或操作符\n * @param conditions 查询条件参数\n * @returns DbQueryCommand 查询命令对象\n /\n or: (conditions: DbQueryCommand[]) =>\n new DbQueryCommand('or', conditions, {\n formatParameter: (db) =>\n conditions.map((c) => DbBaseCommand.getValue(c, db)),\n }),\n};\n\n/\n 数据库变更命令对象，提供各种数据更新操作符\n /\nexport const dbMutate = {\n /\n 数值增加操作符\n * @param value 增加的数值\n * @returns DbMutateCommand 变更命令对象\n /\n inc: (value: number) => new DbMutateCommand('inc', value),\n\n /\n 数值乘法操作符\n * @param value 乘数\n * @returns DbMutateCommand 变更命令对象\n /\n mul: (value: number) => new DbMutateCommand('mul', value),\n\n /\n 设置字段值操作符\n * @param value 设置的值\n * @returns DbMutateCommand 变更命令对象\n /\n set: (value: unknown) => new DbMutateCommand('set', value),\n\n /\n 向数组末尾添加元素操作符\n * @param value 添加的值\n * @returns DbMutateCommand 变更命令对象\n /\n push: (value: unknown) => new DbMutateCommand('push', value),\n\n /\n 向数组开头添加元素操作符\n * @param value 添加的值\n * @returns DbMutateCommand 变更命令对象\n /\n unshift: (value: unknown) => new DbMutateCommand('unshift', value),\n\n /\n 从数组末尾移除元素操作符\n * @returns DbMutateCommand 变更命令对象\n /\n pop: () => new DbMutateCommand('pop', undefined),\n\n /\n 从数组开头移除元素操作符\n * @returns DbMutateCommand 变更命令对象\n /\n shift: () => new DbMutateCommand('shift', undefined),\n\n /\n 移除字段操作符\n * @returns DbMutateCommand 变更命令对象\n /\n remove: () => new DbMutateCommand('remove', undefined),\n};\n","import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\n/\n 数据库分页查询函数\n * @template T - 数据类型\n * @param queryDb - 数据库查询实例\n * @returns 包含数据列表和总数的对象\n /\n\nexport async function dbPaging<\n D1,\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n S1 extends DbSelect<D1> = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n D2 extends AnyObject = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n W2 extends AnyObject = {},\n>(queryDb: Db<D1, S1, D2, W2>) {\n // 获取原始查询条件，不包映射字段\n const where = queryDb.getWhere(true);\n\n // 克隆查询实例用于统计总数，避免影响原查询\n const countDb = queryDb.clone();\n\n // 执行查询获取数据列表\n const list = await queryDb.many();\n\n // 基于相同查询条件统计总数\n const total = await countDb.where(where).count();\n\n // 返回分页结果\n return {\n list,\n total,\n };\n}\n","import {\n objectEach,\n objectFilter,\n objectMap,\n objectOmit,\n} from '@cloudcome/utils-core/object';\nimport { isNumber, isObject, isString } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { DbBaseCommand, type DbQueryCommand } from './_command.class';\nimport type {\n DbCreate,\n DbForeign,\n DbOrder,\n DbQuery,\n DbRelation,\n DbSelect,\n DbUpdate,\n DbWhere,\n} from './types';\n\n/\n 数据库聚合操作符命令\n /\nconst dbAgg = uniCloud.database().command\n .aggregate as UniCloud.AggregateCommand & {\n pipeline: () => UniCloud.AggregateReference & {\n done: () => unknown;\n };\n};\n\ntype _WhereFrom = 'where' \| 'whereId';\n\nconst db0 = uniCloud.database();\n\nexport type DbOptions = {\n /\n 数据表名称\n /\n table: string;\n\n /\n 事务对象，用于事务操作\n /\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n transaction?: any;\n\n /\n 模拟数据库，用于单元测试\n /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDatabase?: any;\n\n /\n 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n /\n parseError?: (error: UniError) => UniError;\n};\n\nexport type DbLookupOptions<\n RL extends DbRelation,\n D1,\n FD1,\n AS,\n // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n US extends boolean \| undefined \| void = undefined,\n> = {\n /\n 关联类型\n /\n relation: RL;\n\n /\n 主表字段\n /\n localField: keyof D1 & string;\n\n /\n 关联表字段\n /\n foreignField: keyof FD1 & string;\n\n /\n 关联数据在结果中的字段名\n /\n as: AS;\n\n /\n 是否取消筛选关联数据\n /\n unselect?: US;\n};\n\nexport type DbLookup = DbLookupOptions<\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n any,\n unknown,\n unknown,\n string,\n boolean\n> & {\n /\n 关联表\n /\n table: Db<unknown>;\n};\n\nlet gid = 0;\n\n/\n 数据库类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @template D2 - 副表数据\n * @template W2 - 副表查询\n /\nexport class Db<\n D1,\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n S1 extends DbSelect<D1> = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n D2 extends AnyObject = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n W2 extends AnyObject = {},\n> {\n private _host: UniCloud.CollectionReference;\n\n /\n 是否为事务环境\n * - 查询条件只能是 id\n * - 不能聚合操作\n /\n private _isTransaction = false;\n\n private _options: DbOptions;\n\n /\n 构造函数，初始化数据库集合引用\n * @param collection 数据表名称\n * @param _mockDatabase 模拟数据库，用于单元测试\n /\n constructor(options: DbOptions) {\n this._options = options;\n this._host =\n options._mockDatabase \|\|\n options.transaction?.collection(options.table) \|\|\n db0.collection(options.table);\n this._isTransaction = !!options.transaction;\n }\n\n /\n 创建一个新的数据库实例，可选是否移除事务\n * @param withoutTransaction 是否移除事务，默认 false\n * @returns 新的数据库实例\n /\n clone(withoutTransaction?: boolean) {\n return new Db({\n ...this._options,\n transaction: withoutTransaction ? null : this._options.transaction,\n });\n }\n\n get table() {\n return this._options.table;\n }\n\n get options() {\n return this._options;\n }\n\n get isTransaction() {\n return this._isTransaction;\n }\n\n /\n 获取聚合操作实例\n * @returns 聚合操作实例\n /\n aggregate() {\n return this._host.aggregate();\n }\n\n private _hasWhere: _WhereFrom \| undefined = undefined;\n private _hasWhereId: _WhereFrom \| undefined = undefined;\n private _where = {};\n\n private _doWhere(where: DbWhere<D1>, from: _WhereFrom) {\n if (this._hasWhere)\n throw new Error(`已调用过一次 db.${_toWhereMethod(this._hasWhere)} 了`);\n\n // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n const realWhere = objectFilter(where, (value) => value !== undefined);\n\n const whereKeys = Object.keys(realWhere);\n\n // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n const isWhereId =\n whereKeys.length === 1 &&\n '_id' in realWhere &&\n (isString(realWhere._id) \|\| isNumber(realWhere._id));\n\n if (isWhereId && this._hasLimit) {\n throw new Error(\n `db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`,\n );\n }\n\n this._hasWhere = from;\n this._where = realWhere;\n if (isWhereId) this._hasWhereId = from;\n\n return this;\n }\n\n /\n 设置查询条件\n * @param where 查询条件对象\n * @returns 当前Db实例，支持链式调用\n /\n where(where: DbWhere<D1> & W2) {\n return this._doWhere(where, 'where');\n }\n\n /\n 获取当前查询条件\n * @param plain 是否返回原始查询条件对象，默认 false\n * @returns 当前查询条件对象\n /\n getWhere(plain?: boolean) {\n return plain\n ? // biome-ignore lint/suspicious/noTsIgnore: 必须这么用\n // @ts-ignore\n objectOmit(this._where, Object.keys(this._lookupAs))\n : this._where;\n }\n\n /\n 根据ID设置查询条件\n * @param id 记录ID\n * @returns 当前Db实例，支持链式调用\n /\n whereId(id: string \| number) {\n // @ts-expect-error\n return this._doWhere({ _id: id }, 'whereId');\n }\n\n private _hasSelect = 0;\n private _select = {};\n\n /\n 指定要返回的字段\n * @param fields 要返回的字段对象，true表示返回，false表示不返回\n * @returns 当前Db实例，支持链式调用\n /\n select<const S extends DbSelect<D1>>(fields: S) {\n if (this._hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n this._hasSelect++;\n this._select = fields;\n\n return this as Db<D1, S, D2, W2>;\n }\n\n private _hasOrder = 0;\n private _order = {};\n\n /\n 设置排序规则\n * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n * @returns 当前Db实例，支持链式调用\n /\n order(order: DbOrder<D1>) {\n this._hasOrder++;\n this._order = order;\n\n return this;\n }\n\n private _hasSkip = 0;\n private _skip = 0;\n\n /\n 跳过指定数量的记录\n * @param skip 要跳过的记录数\n * @returns 当前Db实例，支持链式调用\n /\n skip(skip: number) {\n if (this._hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n this._hasSkip++;\n this._skip = skip;\n\n return this;\n }\n\n private _hasLimit = 0;\n private _limit = 0;\n\n /\n 限制返回的记录数量\n * @param limit 最大返回记录数\n * @returns 当前Db实例，支持链式调用\n /\n limit(limit: number) {\n if (this._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n if (this._hasWhereId) {\n throw new Error(\n `db.limit() 方法不能与 ${_toWhereIdMethod(this._hasWhereId)} 方法同时调用`,\n );\n }\n\n this._hasLimit++;\n this._limit = limit;\n\n return this;\n }\n\n private _hasLookup = 0;\n get hasLookup() {\n return this._hasLookup > 0;\n }\n\n private _lookups: DbLookup[] = [];\n lookup<\n FD1,\n FS1 extends DbSelect<FD1>,\n FD2 extends AnyObject,\n FW2 extends AnyObject,\n RL extends DbRelation,\n AS extends string,\n // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n US extends boolean \| undefined \| void = undefined,\n >(\n table: Db<FD1, FS1, FD2, FW2>,\n lookup: DbLookupOptions<RL, D1, FD1, AS, US>,\n ) {\n // 对方表也记为关联查询，避免做表更新操作\n table._hasLookup++;\n this._hasLookup++;\n this._lookups.push({\n ...lookup,\n table,\n } as unknown as DbLookup);\n\n // @ts-expect-error\n return this as Db<\n D1,\n S1,\n US extends true\n ? D2\n : MergeIntersection<D2 & DbForeign<FD1, FS1, FD2, RL, AS>>,\n MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>\n >;\n }\n\n private _aggregated = false;\n private _lookupAs = {} as Record<string, true>;\n private _endAggregate(aggRef: UniCloud.AggregateReference) {\n if (this._aggregated)\n throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n this._aggregated = true;\n let returnAggRef = aggRef;\n let _hasAggSelect = 0;\n const aggSelect = {} as Record<string, true>;\n let hasAggUnselect = 0;\n const aggUnselect = {} as Record<string, false>;\n\n // 后做关联查询\n for (const {\n relation: type,\n as,\n foreignField,\n localField,\n table,\n unselect,\n } of this._lookups) {\n const letName = `let${gid++}`;\n let pipeline = dbAgg.pipeline();\n\n // 关联条件\n // @ts-expect-error\n pipeline = pipeline.match({\n $expr: {\n $and: [\n type === 'n:1'\n ? { $in: [`$${foreignField}`, `$$${letName}`] }\n : { $eq: [`$${foreignField}`, `$$${letName}`] },\n ],\n },\n });\n\n // 其他查询条件\n // @ts-expect-error\n pipeline = table._endAggregate(pipeline);\n\n // @ts-expect-error\n pipeline = pipeline.done();\n\n returnAggRef = returnAggRef.lookup({\n let: {\n [letName]: `$${localField}`,\n },\n as,\n from: table.table,\n pipeline,\n });\n\n // 1对1，展开数组\n if (type === '1:1') {\n // @ts-expect-error\n returnAggRef = returnAggRef.unwind({\n path: `$${as}`,\n preserveNullAndEmptyArrays: true,\n });\n }\n\n if (unselect) {\n hasAggUnselect++;\n aggUnselect[as] = false;\n } else {\n _hasAggSelect++;\n aggSelect[as] = true;\n }\n\n this._lookupAs[as] = true;\n }\n\n // 主表查询，注意顺序，筛选->排序->跳过->限制\n if (this._hasWhere)\n returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));\n if (this._hasOrder)\n returnAggRef = returnAggRef.sort(\n objectMap(this._order, (v) => (v === 'asc' ? 1 : -1)),\n );\n if (this._hasSkip) returnAggRef = returnAggRef.skip(this._skip);\n if (this._hasLimit) returnAggRef = returnAggRef.limit(this._limit);\n\n // 如果主表有选择字段，则合并选择字段（包括关联查询的字段和排序字段）\n if (this._hasSelect) {\n returnAggRef = returnAggRef.project(\n _mergeSelect({ ...this._select, ...aggSelect }, this._order),\n );\n }\n // 如果主表没有选择字段，则排除取消选择字段\n else if (hasAggUnselect) {\n returnAggRef = returnAggRef.project(aggUnselect);\n }\n\n return returnAggRef;\n }\n\n private _endHost(action: 'query' \| 'create' \| 'update' \| 'remove' \| 'count') {\n if (this._hasWhere) {\n // 事务模式下：更新/删除只能用 doc(id)\n if ((action === 'update' \|\| action === 'remove') && this._isTransaction) {\n // @ts-expect-error\n this._host = this._host.doc(this._where._id);\n } else {\n // @ts-expect-error\n this._host = this._host.where(_mapCommandRaw(this._where));\n }\n }\n\n if (this._hasSelect) {\n // @ts-expect-error\n this._host = this._host.field(_mergeSelect(this._select, this._order));\n }\n\n if (this._hasOrder) {\n objectEach(this._order, (val, key) => {\n // @ts-expect-error\n this._host = this._host.orderBy(key, val);\n });\n }\n\n // @ts-expect-error\n if (this._hasSkip) this._host = this._host.skip(this._skip);\n\n if (this._hasLimit && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(this._limit);\n else if (this._hasWhereId && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(1);\n }\n\n /\n 执行查询操作\n * @returns 查询结果\n /\n async many() {\n try {\n if (this._isTransaction) throw new Error('db.many() 方法不支持事务模式');\n\n let res: { data: DbQuery<D1, S1, D2>[] };\n\n // 关联查询\n if (this._hasLookup) {\n const aggRef = this.aggregate();\n this._endAggregate(aggRef);\n res = await aggRef.end();\n }\n // 单表查询\n else {\n this._endHost('query');\n res = await this._host.get();\n }\n\n const { data } = parseDatabaseOutput(res);\n return data;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 只查询一条，自动添加 limit(1) 条件\n * 如果没有匹配到记录，会抛出错误\n * @returns 查询结果\n /\n async firstOrThrow(): Promise<DbQuery<D1, S1, D2>> {\n if (this._isTransaction)\n throw new Error('db.firstOrThrow() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrThrow() 方法不支持 limit 条件');\n if (!this._hasWhereId) this.limit(1);\n\n const data = await this.many();\n const res = data.at(0);\n\n if (!res) throw createCloudObjectError('查询数据为空', 'firstOrThrow');\n return res;\n }\n\n /\n 只查询一条，自动添加 limit(1) 条件\n * 如果没有匹配到记录，返回 null\n * @returns 查询结果或 null\n /\n async firstOrNull(): Promise<DbQuery<D1, S1, D2> \| null> {\n if (this._isTransaction)\n throw new Error('db.firstOrNull() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrNull() 方法不支持 limit 条件');\n if (!this._hasWhereId) this.limit(1);\n\n const data = await this.many();\n return data.at(0) \|\| null;\n }\n\n /\n 获取匹配记录的数量\n * @returns 记录总数\n /\n async count() {\n if (this._isTransaction) throw new Error('db.count() 方法不支持事务模式');\n if (this._hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n if (this._hasSelect) throw new Error('db.count() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.count() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.count() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.count() 方法不支持 limit 条件');\n\n try {\n this._endHost('count');\n const res = await this._host.count();\n const { total } = parseDatabaseOutput<{ total: number }>(res);\n return total;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 创建新记录\n * @param data 要创建的数据\n * @returns 创建结果\n /\n async create(data: DbCreate<D1>) {\n if (this._hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n if (this._hasWhere) throw new Error('db.create() 方法不支持 where 条件');\n if (this._hasSelect) throw new Error('db.create() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.create() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.create() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.create() 方法不支持 limit 条件');\n\n try {\n this._endHost('create');\n const res = await this._host.add(data);\n const { id } = parseDatabaseOutput<{ id: string }>(res);\n return id;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 更新记录\n * @param data 要更新的数据\n * @returns 更新结果\n /\n async update(data: DbUpdate<D1>) {\n if (this._hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n if (!this._hasWhere)\n throw new Error('设置 where 条件后才能执行 db.update() 方法');\n if (this._hasSelect) throw new Error('db.update() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.update() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.update() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.update() 方法不支持 limit 条件');\n\n if (this._isTransaction && !this._hasWhereId)\n throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n try {\n this._endHost('update');\n const res = await this._host.update(\n objectOmit(_mapCommandRaw(data), ['_id']),\n );\n const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n return updated;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 删除记录\n * @returns 删除结果\n /\n async remove() {\n if (this._hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n if (!this._hasWhere)\n throw new Error('设置 where 条件后才能执行 db.remove() 方法');\n if (this._hasSelect) throw new Error('db.remove() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.remove() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.remove() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.remove() 方法不支持 limit 条件');\n\n if (this._isTransaction && !this._hasWhereId)\n throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n try {\n this._endHost('remove');\n const res = await this._host.remove();\n const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n return deleted;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: 必须这么用\nfunction _mapCommandRaw(data: any) {\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n const map = (val: any): any => {\n if (!isObject(val)) return val;\n if (val instanceof DbBaseCommand) return DbBaseCommand.getValue(val, db0);\n return objectMap(val, map);\n };\n\n return objectMap(data, map);\n}\n\nfunction _mapOrderSelect(order: DbOrder<unknown>) {\n return objectMap(order, (_val, _key) => true);\n}\n\nfunction _mergeSelect(select: DbSelect<unknown>, order: DbOrder<unknown>) {\n const noSelect = Object.keys(select).length === 0;\n // 如果没有 select 条件，默认返回所有字段\n if (noSelect) return select;\n\n const onlyOmitId =\n Object.keys(select).length === 1 && '_id' in select && select._id === false;\n // 如果只排除 _id 字段，则保持现状\n if (onlyOmitId) return select;\n\n return {\n ...select,\n ..._mapOrderSelect(order),\n };\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { UniError } from '@/_types';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\nexport type DbProxyOptions = {\n /\n 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n /\n parseError?: (error: UniError) => UniError;\n};\n\n/\n 创建一个数据库代理对象，用于延迟实例化数据库操作类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @param name - 数据库表名\n * @returns 返回一个代理对象，该对象会将属性访问转发到实际的数据库操作实例\n /\n\n// biome-ignore lint/complexity/noBannedTypes: 必须这么用\nexport function dbProxy<D1, S1 extends DbSelect<D1> = {}>(\n name: string,\n options?: DbProxyOptions,\n) {\n return new Proxy(\n {},\n {\n get(_target, prop) {\n if (prop === '_isProxy') return true;\n\n const table = new Db<D1, S1>({ table: name, ...options });\n const tableProp = prop as keyof Db<D1, S1>;\n const ref = table[tableProp];\n\n return isFunction(ref) ? ref.bind(table) : ref;\n },\n },\n ) as Db<D1, S1>;\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { Db } from './_db.class';\n\ntype _TransactionDb = {\n startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n commit: () => Promise<unknown>;\n rollback: () => Promise<unknown>;\n};\n\nexport type WithTransaction = <D1>(db: Db<D1>) => Db<D1>;\n\n/\n 在数据库事务中执行操作\n \n @template K - 事务操作返回值类型\n * @param transacting - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库对象\n * @param _mockDbInstance - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n \n @example\n * ```typescript\n * const result = await dbTransaction(async (withTransaction) => {\n * const userId = await withTransaction(db.table('user')).create({ name: 'John' });\n * const order = await withTransaction(db.table('orders')).create({ userId, amount: 100 });\n * return { user, order };\n * });\n * ```\n /\nexport async function dbTransaction<K>(\n transacting: (withTransaction: WithTransaction) => Promise<K>,\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDatabase?: any,\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any,\n) {\n const transactionDb = (_mockDatabase \|\|\n uniCloud.database()) as _TransactionDb;\n\n const [err1, transaction] = await tryFlatten(\n transactionDb.startTransaction(),\n );\n if (err1) throw err1;\n\n const withTransaction: WithTransaction = <D1>(db: Db<D1>) => {\n return _mockDbInstance \|\| new Db<D1>({ ...db.options, transaction });\n };\n\n const [err2, result] = await tryFlatten(async () => {\n const result = await transacting(withTransaction);\n await transaction.commit();\n return result;\n });\n\n if (err2) {\n await tryFlatten(transaction.rollback());\n throw err2;\n }\n\n return result as unknown as K;\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { Db } from './_db.class';\nimport type { DbCreate, DbQuery, DbUpdate } from './types';\n\nexport type DbUpsertOptions<T, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n /* 创建数据 /\n create: C;\n\n /\n 更新数据，可以是对象或根据查询结果生成更新对象的函数\n * @param row 查询到的文档数据，仅在传入函数时可用\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n update: U \| ((exist: DbQuery<T, {}, {}>) => U);\n\n /* 创建前回调函数 /\n onBeforeCreate?: () => unknown;\n\n /\n 创建后回调函数\n * @param id 创建的文档ID\n /\n onAfterCreate?: (id: string) => unknown;\n\n /\n 更新前回调函数\n * @param exist 查询到的原始文档数据\n * @returns 如果返回 false，则取消更新操作\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n onBeforeUpdate?: (exist: DbQuery<T, {}, {}>) => false \| unknown;\n\n /\n 更新后回调函数\n * @param updateData 实际更新的数据\n * @param exist 查询到的原始文档数据\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n onAfterUpdate?: (updateData: U, exist: DbQuery<T, {}, {}>) => unknown;\n\n /* 用于测试的模拟数据库实例 /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any;\n};\n\n/\n 数据库 upsert 操作的返回结果类型\n /\nexport type DbUpsertOutput = {\n /* 操作的文档ID /\n id: string;\n /* 是否为创建操作 /\n created: boolean;\n /* 是否为更新操作 /\n updated: boolean;\n};\n\nexport async function dbUpsert<\n D1,\n C extends DbCreate<D1>,\n U extends DbUpdate<D1>,\n>(db: Db<D1>, options: DbUpsertOptions<D1, C, U>): Promise<DbUpsertOutput> {\n const {\n create,\n update,\n onBeforeCreate,\n onAfterCreate,\n onBeforeUpdate,\n onAfterUpdate,\n _mockDbInstance,\n } = options;\n\n const _mutateDb = (_mockDbInstance \|\| db.clone()) as Db<D1>;\n const _queryDb = (_mockDbInstance \|\| db.clone(true)) as Db<D1>;\n\n const exist = (await _queryDb\n .where(db.getWhere(true))\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n .firstOrNull()) as DbQuery<D1, {}, {}> \| null;\n\n if (exist) {\n const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n if (skipUpdate) {\n // @ts-expect-error\n return { id: exist._id as string, updated: false, created: false };\n }\n\n const updateData = isFunction(update) ? update(exist) : update;\n // @ts-expect-error\n await _mutateDb.whereId(exist._id).update(updateData);\n onAfterUpdate?.(updateData, exist);\n\n // @ts-expect-error\n return { id: exist._id as string, updated: true, created: false };\n }\n\n await onBeforeCreate?.();\n const createdId = await _mutateDb.create(create);\n await onAfterCreate?.(createdId);\n\n return { id: createdId, updated: false, created: true };\n}\n","import type { Db } from './_db.class';\nimport type { DbCreate } from './types';\nimport { dbUpsert } from './upsert';\n\nexport type DbUniqueOptions<T, C extends DbCreate<T>> = {\n /* 创建数据 /\n create: C;\n\n /* 创建前回调函数 /\n onBeforeCreate?: () => unknown;\n\n /\n 创建后回调函数\n * @param id 创建的文档ID\n /\n onAfterCreate?: (id: string) => unknown;\n\n /* 用于测试的模拟数据库实例 /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any;\n};\n\n/\n 数据库 upsert 操作的返回结果类型\n /\nexport type DbUniqueOutput = {\n /* 操作的文档ID /\n id: string;\n /* 是否为创建操作 */\n created: boolean;\n};\n\nexport async function dbUnique<T, C extends DbCreate<T>>(\n db: Db<T>,\n options: DbUniqueOptions<T, C>,\n): Promise<DbUniqueOutput> {\n const { id, created } = await dbUpsert(db, {\n ...options,\n // @ts-expect-error\n update: {},\n onBeforeUpdate: () => false,\n });\n return { id, created };\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"database.mjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/each.ts","../src/database/paging.ts","../src/database/_db.class.ts","../src/database/proxy.ts","../src/database/transaction.ts","../src/database/upsert.ts","../src/database/unique.ts"],"sourcesContent":["// 设置私有属性和静态方法是避免在 update 的时候提示类属性\n\nexport class DbBaseCommand {\n protected _isQuery = false;\n protected _isMutate = false;\n\n constructor(\n private _command: string,\n private _parameter: unknown,\n private _options?: {\n formatParameter?: (db: UniCloud.Database) => unknown;\n rewriteValue?: (db: UniCloud.Database, parameter: unknown) => unknown;\n },\n ) {}\n\n static getValue(cmd: DbBaseCommand, db: UniCloud.Database) {\n if (cmd._options?.rewriteValue) {\n return cmd._options.rewriteValue(db, cmd._parameter);\n }\n\n return (\n db.command as unknown as Record<string, (value: unknown) => unknown>\n )[cmd._command].call(\n db.command,\n cmd._options?.formatParameter?.(db) \|\| cmd._parameter,\n );\n }\n\n static getExpression(cmd: DbBaseCommand, fieldName: string) {\n return {\n [`$${cmd._command}`]: [fieldName, cmd._parameter],\n };\n }\n\n static isQueryCommand(cmd: DbBaseCommand) {\n return cmd._isQuery;\n }\n\n static isMutateCommand(cmd: DbBaseCommand) {\n return cmd._isMutate;\n }\n}\n\nexport class DbQueryCommand extends DbBaseCommand {\n protected _isQuery = true;\n}\n\nexport class DbMutateCommand extends DbBaseCommand {\n protected _isMutate = true;\n}\n","import {\n DbBaseCommand,\n DbMutateCommand,\n DbQueryCommand,\n} from './_command.class';\n\n/*\n 数据库查询命令对象，提供各种查询操作符\n /\nexport const dbQuery = {\n /\n 等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n eq: (value: unknown) => new DbQueryCommand('eq', value),\n\n /\n 不等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n neq: (value: unknown) => new DbQueryCommand('neq', value),\n\n /\n 大于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n gt: (value: unknown) => new DbQueryCommand('gt', value),\n\n /\n 大于等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n gte: (value: unknown) => new DbQueryCommand('gte', value),\n\n /\n 小于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n lt: (value: unknown) => new DbQueryCommand('lt', value),\n\n /\n 小于等于操作符\n * @param value 比较值\n * @returns DbQueryCommand 查询命令对象\n /\n lte: (value: unknown) => new DbQueryCommand('lte', value),\n\n /\n 包含在数组中操作符\n * @param value 值数组\n * @returns DbQueryCommand 查询命令对象\n /\n in: (value: unknown[]) => new DbQueryCommand('in', value),\n\n /\n 不包含在数组中操作符\n * @param value 值数组\n * @returns DbQueryCommand 查询命令对象\n /\n nin: (value: unknown[]) => new DbQueryCommand('nin', value),\n\n /\n 数组长度匹配操作符\n * @param size 数组长度\n * @returns DbQueryCommand 查询命令对象\n /\n size: (size: number) => new DbQueryCommand('size', size),\n\n /\n 正则表达式匹配操作符\n * @param regExp 正则表达式\n * @returns DbQueryCommand 查询命令对象\n /\n regExp: (regExp: RegExp) =>\n new DbQueryCommand('regExp', regExp, {\n rewriteValue: (_db, parameter) => parameter,\n }),\n\n /\n 逻辑与操作符\n * @param conditions 查询条件参数\n * @returns DbQueryCommand 查询命令对象\n /\n and: (conditions: DbQueryCommand[]) =>\n new DbQueryCommand('and', conditions, {\n formatParameter: (db) =>\n conditions.map((c) => DbBaseCommand.getValue(c, db)),\n }),\n\n /\n 逻辑或操作符\n * @param conditions 查询条件参数\n * @returns DbQueryCommand 查询命令对象\n /\n or: (conditions: DbQueryCommand[]) =>\n new DbQueryCommand('or', conditions, {\n formatParameter: (db) =>\n conditions.map((c) => DbBaseCommand.getValue(c, db)),\n }),\n};\n\n/\n 数据库变更命令对象，提供各种数据更新操作符\n /\nexport const dbMutate = {\n /\n 数值增加操作符\n * @param value 增加的数值\n * @returns DbMutateCommand 变更命令对象\n /\n inc: (value: number) => new DbMutateCommand('inc', value),\n\n /\n 数值乘法操作符\n * @param value 乘数\n * @returns DbMutateCommand 变更命令对象\n /\n mul: (value: number) => new DbMutateCommand('mul', value),\n\n /\n 设置字段值操作符\n * @param value 设置的值\n * @returns DbMutateCommand 变更命令对象\n /\n set: (value: unknown) => new DbMutateCommand('set', value),\n\n /\n 向数组末尾添加元素操作符\n * @param value 添加的值\n * @returns DbMutateCommand 变更命令对象\n /\n push: (value: unknown) => new DbMutateCommand('push', value),\n\n /\n 向数组开头添加元素操作符\n * @param value 添加的值\n * @returns DbMutateCommand 变更命令对象\n /\n unshift: (value: unknown) => new DbMutateCommand('unshift', value),\n\n /\n 从数组末尾移除元素操作符\n * @returns DbMutateCommand 变更命令对象\n /\n pop: () => new DbMutateCommand('pop', undefined),\n\n /\n 从数组开头移除元素操作符\n * @returns DbMutateCommand 变更命令对象\n /\n shift: () => new DbMutateCommand('shift', undefined),\n\n /\n 移除字段操作符\n * @returns DbMutateCommand 变更命令对象\n /\n remove: () => new DbMutateCommand('remove', undefined),\n};\n","import type { Db } from './_db.class';\nimport type { DbWhere } from './types';\n\n/\n 遍历表中的每一行数据并执行回调函数\n \n 采用分批查询策略，每批查询 100 条记录，通过 skip/limit 实现分页遍历，\n * 避免一次性加载大量数据导致内存溢出。\n \n 迭代器按顺序串行执行，即每一行数据的迭代器完成后才会处理下一行。\n \n @template T - 数据行类型\n * @param table 数据库表代理对象\n * @param where 查询条件\n * @param iterator 对每一行数据执行的异步迭代器函数\n * @param maxCount 最大遍历数量，默认值为 Number.MAX_SAFE_INTEGER。\n * 注意：由于分批查询机制（每批 100 条），实际遍历的行数可能略大于 maxCount，\n * 例如 maxCount=150 时，会分两批查询（0-99、100-199），实际遍历 200 行。\n * @example\n * ```ts\n * // 遍历所有状态为 active 的用户\n * await dbEach(userTable, { status: 'active' }, async (user) => {\n * await sendEmail(user.email);\n * });\n \n // 限制最多遍历 500 条记录\n * await dbEach(orderTable, { status: 'pending' }, async (order) => {\n * await processOrder(order);\n * }, 500);\n * ```\n /\nexport async function dbEach<T>(\n table: Db<T>,\n where: DbWhere<T>,\n iterator: (row: T) => Promise<unknown>,\n maxCount = Number.MAX_SAFE_INTEGER,\n) {\n const count = Math.min(await table.where(where).count(), maxCount);\n const limit = 100;\n\n for (let skip = 0; skip < count; skip += limit) {\n const rows = await table.where(where).limit(limit).skip(skip).many();\n\n for (const row of rows) {\n await iterator(row as T);\n }\n }\n}\n","import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\n/\n 数据库分页查询函数\n * @template T - 数据类型\n * @param queryDb - 数据库查询实例\n * @returns 包含数据列表和总数的对象\n /\n\nexport async function dbPaging<\n D1,\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n S1 extends DbSelect<D1> = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n D2 extends AnyObject = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n W2 extends AnyObject = {},\n>(queryDb: Db<D1, S1, D2, W2>) {\n // 获取原始查询条件，不包映射字段\n const where = queryDb.getWhere(true);\n\n // 克隆查询实例用于统计总数，避免影响原查询\n const countDb = queryDb.clone();\n\n // 执行查询获取数据列表\n const list = await queryDb.many();\n\n // 基于相同查询条件统计总数\n const total = await countDb.where(where).count();\n\n // 返回分页结果\n return {\n list,\n total,\n };\n}\n","import {\n objectEach,\n objectFilter,\n objectMap,\n objectOmit,\n} from '@cloudcome/utils-core/object';\nimport { isNumber, isObject, isString } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { DbBaseCommand, type DbQueryCommand } from './_command.class';\nimport type {\n DbCreate,\n DbForeign,\n DbOrder,\n DbQuery,\n DbRelation,\n DbSelect,\n DbUpdate,\n DbWhere,\n} from './types';\n\n/\n 数据库聚合操作符命令\n /\nconst dbAgg = uniCloud.database().command\n .aggregate as UniCloud.AggregateCommand & {\n pipeline: () => UniCloud.AggregateReference & {\n done: () => unknown;\n };\n};\n\ntype _WhereFrom = 'where' \| 'whereId';\n\nconst db0 = uniCloud.database();\n\nexport type DbOptions = {\n /\n 数据表名称\n /\n table: string;\n\n /\n 事务对象，用于事务操作\n /\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n transaction?: any;\n\n /\n 模拟数据库，用于单元测试\n /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDatabase?: any;\n\n /\n 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n /\n parseError?: (error: UniError) => UniError;\n};\n\nexport type DbLookupOptions<\n RL extends DbRelation,\n D1,\n FD1,\n AS,\n // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n US extends boolean \| undefined \| void = undefined,\n> = {\n /\n 关联类型\n /\n relation: RL;\n\n /\n 主表字段\n /\n localField: keyof D1 & string;\n\n /\n 关联表字段\n /\n foreignField: keyof FD1 & string;\n\n /\n 关联数据在结果中的字段名\n /\n as: AS;\n\n /\n 是否取消筛选关联数据\n /\n unselect?: US;\n};\n\nexport type DbLookup = DbLookupOptions<\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n any,\n unknown,\n unknown,\n string,\n boolean\n> & {\n /\n 关联表\n /\n table: Db<unknown>;\n};\n\nlet gid = 0;\n\n/\n 数据库类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @template D2 - 副表数据\n * @template W2 - 副表查询\n /\nexport class Db<\n D1,\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n S1 extends DbSelect<D1> = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n D2 extends AnyObject = {},\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n W2 extends AnyObject = {},\n> {\n private _host: UniCloud.CollectionReference;\n\n /\n 是否为事务环境\n * - 查询条件只能是 id\n * - 不能聚合操作\n /\n private _isTransaction = false;\n\n private _options: DbOptions;\n\n /\n 构造函数，初始化数据库集合引用\n * @param collection 数据表名称\n * @param _mockDatabase 模拟数据库，用于单元测试\n /\n constructor(options: DbOptions) {\n this._options = options;\n this._host =\n options._mockDatabase \|\|\n options.transaction?.collection(options.table) \|\|\n db0.collection(options.table);\n this._isTransaction = !!options.transaction;\n }\n\n /\n 创建一个新的数据库实例，可选是否移除事务\n * @param withoutTransaction 是否移除事务，默认 false\n * @returns 新的数据库实例\n /\n clone(withoutTransaction?: boolean) {\n return new Db({\n ...this._options,\n transaction: withoutTransaction ? null : this._options.transaction,\n });\n }\n\n get table() {\n return this._options.table;\n }\n\n get options() {\n return this._options;\n }\n\n get isTransaction() {\n return this._isTransaction;\n }\n\n /\n 获取聚合操作实例\n * @returns 聚合操作实例\n /\n aggregate() {\n return this._host.aggregate();\n }\n\n private _hasWhere: _WhereFrom \| undefined = undefined;\n private _hasWhereId: _WhereFrom \| undefined = undefined;\n private _where = {};\n\n private _doWhere(where: DbWhere<D1>, from: _WhereFrom) {\n if (this._hasWhere)\n throw new Error(`已调用过一次 db.${_toWhereMethod(this._hasWhere)} 了`);\n\n // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n const realWhere = objectFilter(where, (value) => value !== undefined);\n\n const whereKeys = Object.keys(realWhere);\n\n // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n const isWhereId =\n whereKeys.length === 1 &&\n '_id' in realWhere &&\n (isString(realWhere._id) \|\| isNumber(realWhere._id));\n\n if (isWhereId && this._hasLimit) {\n throw new Error(\n `db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`,\n );\n }\n\n this._hasWhere = from;\n this._where = realWhere;\n if (isWhereId) this._hasWhereId = from;\n\n return this;\n }\n\n /\n 设置查询条件\n * @param where 查询条件对象\n * @returns 当前Db实例，支持链式调用\n /\n where(where: DbWhere<D1> & W2) {\n return this._doWhere(where, 'where');\n }\n\n /\n 获取当前查询条件\n * @param plain 是否返回原始查询条件对象，默认 false\n * @returns 当前查询条件对象\n /\n getWhere(plain?: boolean) {\n return plain\n ? // biome-ignore lint/suspicious/noTsIgnore: 必须这么用\n // @ts-ignore\n objectOmit(this._where, Object.keys(this._lookupAs))\n : this._where;\n }\n\n /\n 根据ID设置查询条件\n * @param id 记录ID\n * @returns 当前Db实例，支持链式调用\n /\n whereId(id: string \| number) {\n // @ts-expect-error\n return this._doWhere({ _id: id }, 'whereId');\n }\n\n private _hasSelect = 0;\n private _select = {};\n\n /\n 指定要返回的字段\n * @param fields 要返回的字段对象，true表示返回，false表示不返回\n * @returns 当前Db实例，支持链式调用\n /\n select<const S extends DbSelect<D1>>(fields: S) {\n if (this._hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n this._hasSelect++;\n this._select = fields;\n\n return this as Db<D1, S, D2, W2>;\n }\n\n private _hasOrder = 0;\n private _order = {};\n\n /\n 设置排序规则\n * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n * @returns 当前Db实例，支持链式调用\n /\n order(order: DbOrder<D1>) {\n this._hasOrder++;\n this._order = order;\n\n return this;\n }\n\n private _hasSkip = 0;\n private _skip = 0;\n\n /\n 跳过指定数量的记录\n * @param skip 要跳过的记录数\n * @returns 当前Db实例，支持链式调用\n /\n skip(skip: number) {\n if (this._hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n this._hasSkip++;\n this._skip = skip;\n\n return this;\n }\n\n private _hasLimit = 0;\n private _limit = 0;\n\n /\n 限制返回的记录数量\n * @param limit 最大返回记录数\n * @returns 当前Db实例，支持链式调用\n /\n limit(limit: number) {\n if (this._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n if (this._hasWhereId) {\n throw new Error(\n `db.limit() 方法不能与 ${_toWhereIdMethod(this._hasWhereId)} 方法同时调用`,\n );\n }\n\n this._hasLimit++;\n this._limit = limit;\n\n return this;\n }\n\n private _hasLookup = 0;\n get hasLookup() {\n return this._hasLookup > 0;\n }\n\n private _lookups: DbLookup[] = [];\n lookup<\n FD1,\n FS1 extends DbSelect<FD1>,\n FD2 extends AnyObject,\n FW2 extends AnyObject,\n RL extends DbRelation,\n AS extends string,\n // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n US extends boolean \| undefined \| void = undefined,\n >(\n table: Db<FD1, FS1, FD2, FW2>,\n lookup: DbLookupOptions<RL, D1, FD1, AS, US>,\n ) {\n // 对方表也记为关联查询，避免做表更新操作\n table._hasLookup++;\n this._hasLookup++;\n this._lookups.push({\n ...lookup,\n table,\n } as unknown as DbLookup);\n\n // @ts-expect-error\n return this as Db<\n D1,\n S1,\n US extends true\n ? D2\n : MergeIntersection<D2 & DbForeign<FD1, FS1, FD2, RL, AS>>,\n MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>\n >;\n }\n\n private _aggregated = false;\n private _lookupAs = {} as Record<string, true>;\n private _endAggregate(aggRef: UniCloud.AggregateReference) {\n if (this._aggregated)\n throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n this._aggregated = true;\n let returnAggRef = aggRef;\n let _hasAggSelect = 0;\n const aggSelect = {} as Record<string, true>;\n let hasAggUnselect = 0;\n const aggUnselect = {} as Record<string, false>;\n\n // 后做关联查询\n for (const {\n relation: type,\n as,\n foreignField,\n localField,\n table,\n unselect,\n } of this._lookups) {\n const letName = `let${gid++}`;\n let pipeline = dbAgg.pipeline();\n\n // 关联条件\n // @ts-expect-error\n pipeline = pipeline.match({\n $expr: {\n $and: [\n type === 'n:1'\n ? { $in: [`$${foreignField}`, `$$${letName}`] }\n : { $eq: [`$${foreignField}`, `$$${letName}`] },\n ],\n },\n });\n\n // 其他查询条件\n // @ts-expect-error\n pipeline = table._endAggregate(pipeline);\n\n // @ts-expect-error\n pipeline = pipeline.done();\n\n returnAggRef = returnAggRef.lookup({\n let: {\n [letName]: `$${localField}`,\n },\n as,\n from: table.table,\n pipeline,\n });\n\n // 1对1，展开数组\n if (type === '1:1') {\n // @ts-expect-error\n returnAggRef = returnAggRef.unwind({\n path: `$${as}`,\n preserveNullAndEmptyArrays: true,\n });\n }\n\n if (unselect) {\n hasAggUnselect++;\n aggUnselect[as] = false;\n } else {\n _hasAggSelect++;\n aggSelect[as] = true;\n }\n\n this._lookupAs[as] = true;\n }\n\n // 主表查询，注意顺序，筛选->排序->跳过->限制\n if (this._hasWhere)\n returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));\n if (this._hasOrder)\n returnAggRef = returnAggRef.sort(\n objectMap(this._order, (v) => (v === 'asc' ? 1 : -1)),\n );\n if (this._hasSkip) returnAggRef = returnAggRef.skip(this._skip);\n if (this._hasLimit) returnAggRef = returnAggRef.limit(this._limit);\n\n // 如果主表有选择字段，则合并选择字段（包括关联查询的字段和排序字段）\n if (this._hasSelect) {\n returnAggRef = returnAggRef.project(\n _mergeSelect({ ...this._select, ...aggSelect }, this._order),\n );\n }\n // 如果主表没有选择字段，则排除取消选择字段\n else if (hasAggUnselect) {\n returnAggRef = returnAggRef.project(aggUnselect);\n }\n\n return returnAggRef;\n }\n\n private _endHost(action: 'query' \| 'create' \| 'update' \| 'remove' \| 'count') {\n if (this._hasWhere) {\n // 事务模式下：更新/删除只能用 doc(id)\n if ((action === 'update' \|\| action === 'remove') && this._isTransaction) {\n // @ts-expect-error\n this._host = this._host.doc(this._where._id);\n } else {\n // @ts-expect-error\n this._host = this._host.where(_mapCommandRaw(this._where));\n }\n }\n\n if (this._hasSelect) {\n // @ts-expect-error\n this._host = this._host.field(_mergeSelect(this._select, this._order));\n }\n\n if (this._hasOrder) {\n objectEach(this._order, (val, key) => {\n // @ts-expect-error\n this._host = this._host.orderBy(key, val);\n });\n }\n\n // @ts-expect-error\n if (this._hasSkip) this._host = this._host.skip(this._skip);\n\n if (this._hasLimit && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(this._limit);\n else if (this._hasWhereId && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(1);\n }\n\n /\n 执行查询操作\n * @returns 查询结果\n /\n async many() {\n try {\n if (this._isTransaction) throw new Error('db.many() 方法不支持事务模式');\n\n let res: { data: DbQuery<D1, S1, D2>[] };\n\n // 关联查询\n if (this._hasLookup) {\n const aggRef = this.aggregate();\n this._endAggregate(aggRef);\n res = await aggRef.end();\n }\n // 单表查询\n else {\n this._endHost('query');\n res = await this._host.get();\n }\n\n const { data } = parseDatabaseOutput(res);\n return data;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 只查询一条，自动添加 limit(1) 条件\n * 如果没有匹配到记录，会抛出错误\n * @returns 查询结果\n /\n async firstOrThrow(): Promise<DbQuery<D1, S1, D2>> {\n if (this._isTransaction)\n throw new Error('db.firstOrThrow() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrThrow() 方法不支持 limit 条件');\n if (!this._hasWhereId) this.limit(1);\n\n const data = await this.many();\n const res = data.at(0);\n\n if (!res) throw createCloudObjectError('查询数据为空', 'firstOrThrow');\n return res;\n }\n\n /\n 只查询一条，自动添加 limit(1) 条件\n * 如果没有匹配到记录，返回 null\n * @returns 查询结果或 null\n /\n async firstOrNull(): Promise<DbQuery<D1, S1, D2> \| null> {\n if (this._isTransaction)\n throw new Error('db.firstOrNull() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrNull() 方法不支持 limit 条件');\n if (!this._hasWhereId) this.limit(1);\n\n const data = await this.many();\n return data.at(0) \|\| null;\n }\n\n /\n 获取匹配记录的数量\n * @returns 记录总数\n /\n async count() {\n if (this._isTransaction) throw new Error('db.count() 方法不支持事务模式');\n if (this._hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n if (this._hasSelect) throw new Error('db.count() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.count() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.count() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.count() 方法不支持 limit 条件');\n\n try {\n this._endHost('count');\n const res = await this._host.count();\n const { total } = parseDatabaseOutput<{ total: number }>(res);\n return total;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 创建新记录\n * @param data 要创建的数据\n * @returns 创建结果\n /\n async create(data: DbCreate<D1>) {\n if (this._hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n if (this._hasWhere) throw new Error('db.create() 方法不支持 where 条件');\n if (this._hasSelect) throw new Error('db.create() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.create() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.create() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.create() 方法不支持 limit 条件');\n\n try {\n this._endHost('create');\n const res = await this._host.add(data);\n const { id } = parseDatabaseOutput<{ id: string }>(res);\n return id;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 更新记录\n * @param data 要更新的数据\n * @returns 更新结果\n /\n async update(data: DbUpdate<D1>) {\n if (this._hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n if (!this._hasWhere)\n throw new Error('设置 where 条件后才能执行 db.update() 方法');\n if (this._hasSelect) throw new Error('db.update() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.update() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.update() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.update() 方法不支持 limit 条件');\n\n if (this._isTransaction && !this._hasWhereId)\n throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n try {\n this._endHost('update');\n const res = await this._host.update(\n objectOmit(_mapCommandRaw(data), ['_id']),\n );\n const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n return updated;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n\n /\n 删除记录\n * @returns 删除结果\n /\n async remove() {\n if (this._hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n if (!this._hasWhere)\n throw new Error('设置 where 条件后才能执行 db.remove() 方法');\n if (this._hasSelect) throw new Error('db.remove() 方法不支持 select 条件');\n if (this._hasOrder) throw new Error('db.remove() 方法不支持 order 条件');\n if (this._hasSkip) throw new Error('db.remove() 方法不支持 skip 条件');\n if (this._hasLimit) throw new Error('db.remove() 方法不支持 limit 条件');\n\n if (this._isTransaction && !this._hasWhereId)\n throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n try {\n this._endHost('remove');\n const res = await this._host.remove();\n const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n return deleted;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) \|\| dbErr;\n }\n }\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: 必须这么用\nfunction _mapCommandRaw(data: any) {\n // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n const map = (val: any): any => {\n if (!isObject(val)) return val;\n if (val instanceof DbBaseCommand) return DbBaseCommand.getValue(val, db0);\n return objectMap(val, map);\n };\n\n return objectMap(data, map);\n}\n\nfunction _mapOrderSelect(order: DbOrder<unknown>) {\n return objectMap(order, (_val, _key) => true);\n}\n\nfunction _mergeSelect(select: DbSelect<unknown>, order: DbOrder<unknown>) {\n const noSelect = Object.keys(select).length === 0;\n // 如果没有 select 条件，默认返回所有字段\n if (noSelect) return select;\n\n const onlyOmitId =\n Object.keys(select).length === 1 && '_id' in select && select._id === false;\n // 如果只排除 _id 字段，则保持现状\n if (onlyOmitId) return select;\n\n return {\n ...select,\n ..._mapOrderSelect(order),\n };\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { UniError } from '@/_types';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\nexport type DbProxyOptions = {\n /\n 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n /\n parseError?: (error: UniError) => UniError;\n};\n\n/\n 创建一个数据库代理对象，用于延迟实例化数据库操作类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @param name - 数据库表名\n * @returns 返回一个代理对象，该对象会将属性访问转发到实际的数据库操作实例\n /\n\n// biome-ignore lint/complexity/noBannedTypes: 必须这么用\nexport function dbProxy<D1, S1 extends DbSelect<D1> = {}>(\n name: string,\n options?: DbProxyOptions,\n) {\n return new Proxy(\n {},\n {\n get(_target, prop) {\n if (prop === '_isProxy') return true;\n\n const table = new Db<D1, S1>({ table: name, ...options });\n const tableProp = prop as keyof Db<D1, S1>;\n const ref = table[tableProp];\n\n return isFunction(ref) ? ref.bind(table) : ref;\n },\n },\n ) as Db<D1, S1>;\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { Db } from './_db.class';\n\ntype _TransactionDb = {\n startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n commit: () => Promise<unknown>;\n rollback: () => Promise<unknown>;\n};\n\nexport type WithTransaction = <D1>(db: Db<D1>) => Db<D1>;\n\n/\n 在数据库事务中执行操作\n \n @template K - 事务操作返回值类型\n * @param transacting - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库对象\n * @param _mockDbInstance - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n \n @example\n * ```typescript\n * const result = await dbTransaction(async (withTransaction) => {\n * const userId = await withTransaction(db.table('user')).create({ name: 'John' });\n * const order = await withTransaction(db.table('orders')).create({ userId, amount: 100 });\n * return { user, order };\n * });\n * ```\n /\nexport async function dbTransaction<K>(\n transacting: (withTransaction: WithTransaction) => Promise<K>,\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDatabase?: any,\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any,\n) {\n const transactionDb = (_mockDatabase \|\|\n uniCloud.database()) as _TransactionDb;\n\n const [err1, transaction] = await tryFlatten(\n transactionDb.startTransaction(),\n );\n if (err1) throw err1;\n\n const withTransaction: WithTransaction = <D1>(db: Db<D1>) => {\n return _mockDbInstance \|\| new Db<D1>({ ...db.options, transaction });\n };\n\n const [err2, result] = await tryFlatten(async () => {\n const result = await transacting(withTransaction);\n await transaction.commit();\n return result;\n });\n\n if (err2) {\n await tryFlatten(transaction.rollback());\n throw err2;\n }\n\n return result as unknown as K;\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { Db } from './_db.class';\nimport type { DbCreate, DbQuery, DbUpdate } from './types';\n\nexport type DbUpsertOptions<T, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n /* 创建数据 /\n create: C;\n\n /\n 更新数据，可以是对象或根据查询结果生成更新对象的函数\n * @param row 查询到的文档数据，仅在传入函数时可用\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n update: U \| ((exist: DbQuery<T, {}, {}>) => U);\n\n /* 创建前回调函数 /\n onBeforeCreate?: () => unknown;\n\n /\n 创建后回调函数\n * @param id 创建的文档ID\n /\n onAfterCreate?: (id: string) => unknown;\n\n /\n 更新前回调函数\n * @param exist 查询到的原始文档数据\n * @returns 如果返回 false，则取消更新操作\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n onBeforeUpdate?: (exist: DbQuery<T, {}, {}>) => false \| unknown;\n\n /\n 更新后回调函数\n * @param updateData 实际更新的数据\n * @param exist 查询到的原始文档数据\n /\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n onAfterUpdate?: (updateData: U, exist: DbQuery<T, {}, {}>) => unknown;\n\n /* 用于测试的模拟数据库实例 /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any;\n};\n\n/\n 数据库 upsert 操作的返回结果类型\n /\nexport type DbUpsertOutput = {\n /* 操作的文档ID /\n id: string;\n /* 是否为创建操作 /\n created: boolean;\n /* 是否为更新操作 /\n updated: boolean;\n};\n\nexport async function dbUpsert<\n D1,\n C extends DbCreate<D1>,\n U extends DbUpdate<D1>,\n>(db: Db<D1>, options: DbUpsertOptions<D1, C, U>): Promise<DbUpsertOutput> {\n const {\n create,\n update,\n onBeforeCreate,\n onAfterCreate,\n onBeforeUpdate,\n onAfterUpdate,\n _mockDbInstance,\n } = options;\n\n const _mutateDb = (_mockDbInstance \|\| db.clone()) as Db<D1>;\n const _queryDb = (_mockDbInstance \|\| db.clone(true)) as Db<D1>;\n\n const exist = (await _queryDb\n .where(db.getWhere(true))\n // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n .firstOrNull()) as DbQuery<D1, {}, {}> \| null;\n\n if (exist) {\n const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n if (skipUpdate) {\n // @ts-expect-error\n return { id: exist._id as string, updated: false, created: false };\n }\n\n const updateData = isFunction(update) ? update(exist) : update;\n // @ts-expect-error\n await _mutateDb.whereId(exist._id).update(updateData);\n onAfterUpdate?.(updateData, exist);\n\n // @ts-expect-error\n return { id: exist._id as string, updated: true, created: false };\n }\n\n await onBeforeCreate?.();\n const createdId = await _mutateDb.create(create);\n await onAfterCreate?.(createdId);\n\n return { id: createdId, updated: false, created: true };\n}\n","import type { Db } from './_db.class';\nimport type { DbCreate } from './types';\nimport { dbUpsert } from './upsert';\n\nexport type DbUniqueOptions<T, C extends DbCreate<T>> = {\n /* 创建数据 /\n create: C;\n\n /* 创建前回调函数 /\n onBeforeCreate?: () => unknown;\n\n /\n 创建后回调函数\n * @param id 创建的文档ID\n /\n onAfterCreate?: (id: string) => unknown;\n\n /* 用于测试的模拟数据库实例 /\n // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n _mockDbInstance?: any;\n};\n\n/\n 数据库 upsert 操作的返回结果类型\n /\nexport type DbUniqueOutput = {\n /* 操作的文档ID /\n id: string;\n /* 是否为创建操作 */\n created: boolean;\n};\n\nexport async function dbUnique<T, C extends DbCreate<T>>(\n db: Db<T>,\n options: DbUniqueOptions<T, C>,\n): Promise<DbUniqueOutput> {\n const { id, created } = await dbUpsert(db, {\n ...options,\n // @ts-expect-error\n update: {},\n onBeforeUpdate: () => false,\n });\n return { id, created };\n}\n"],"mappings":"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"}

package/dist/index.cjs CHANGED Viewed

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 /**
 * `@cloudcome/utils-uni` 版本号
 */
-var VERSION = "1.31.1";
+var VERSION = "1.32.0";
 //#endregion
 exports.VERSION = VERSION;

package/dist/index.mjs CHANGED Viewed

@@ -2,7 +2,7 @@
 /**
 * `@cloudcome/utils-uni` 版本号
 */
-var VERSION = "1.31.1";
+var VERSION = "1.32.0";
 //#endregion
 export { VERSION };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-uni",
-  "version": "1.31.1",
+  "version": "1.32.0",
   "description": "cloudcome utils for uni-app",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",