@cloudcome/utils-uni 1.7.1 → 1.9.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.
- package/dist/cloud/expose.d.ts +39 -0
- package/dist/cloud/object.d.ts +0 -1
- package/dist/cloud/respond.d.ts +22 -1
- package/dist/cloud.cjs +10 -9
- package/dist/cloud.cjs.map +1 -1
- package/dist/cloud.mjs +10 -9
- package/dist/cloud.mjs.map +1 -1
- package/dist/database/db.d.ts +81 -19
- package/dist/database/fns.d.ts +34 -33
- package/dist/database/test.d.ts +1 -0
- package/dist/database/types.d.ts +135 -0
- package/dist/database.cjs +155 -53
- package/dist/database.cjs.map +1 -1
- package/dist/database.mjs +157 -55
- package/dist/database.mjs.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.mjs +1 -1
- package/package.json +3 -3
package/dist/database.mjs
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
import { errorAssign } from "@cloudcome/utils-core/error";
|
|
2
|
-
import { objectEach, objectOmit } from "@cloudcome/utils-core/object";
|
|
3
|
-
import { isString, isNumber, isFunction } from "@cloudcome/utils-core/type";
|
|
2
|
+
import { objectMap, objectEach, objectOmit } from "@cloudcome/utils-core/object";
|
|
3
|
+
import { isString, isNumber, isArray, isFunction } from "@cloudcome/utils-core/type";
|
|
4
4
|
import { tryFlatten } from "@cloudcome/utils-core/try";
|
|
5
5
|
const db0 = uniCloud.database();
|
|
6
6
|
const dbCmd = db0.command;
|
|
7
7
|
const dbAgg = db0.command.aggregate;
|
|
8
|
+
let gid = 0;
|
|
8
9
|
class Db {
|
|
9
10
|
#host;
|
|
10
11
|
/**
|
|
@@ -12,27 +13,32 @@ class Db {
|
|
|
12
13
|
* - 查询条件只能是 id
|
|
13
14
|
* - 不能聚合操作
|
|
14
15
|
*/
|
|
15
|
-
#isTransaction;
|
|
16
|
+
#isTransaction = false;
|
|
17
|
+
#options;
|
|
16
18
|
/**
|
|
17
19
|
* 构造函数,初始化数据库集合引用
|
|
18
20
|
* @param collection 数据表名称
|
|
19
21
|
* @param _mockDatabase 模拟数据库,用于单元测试
|
|
20
22
|
*/
|
|
21
23
|
constructor(options) {
|
|
22
|
-
this.#
|
|
24
|
+
this.#options = options;
|
|
25
|
+
this.#host = options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);
|
|
23
26
|
this.#isTransaction = !!options.transaction;
|
|
24
27
|
}
|
|
28
|
+
get table() {
|
|
29
|
+
return this.#options.table;
|
|
30
|
+
}
|
|
25
31
|
/**
|
|
26
|
-
*
|
|
32
|
+
* 获取聚合操作实例
|
|
27
33
|
* @returns 聚合操作实例
|
|
28
34
|
*/
|
|
29
35
|
aggregate() {
|
|
30
|
-
if (!this.#isTransaction) throw new Error("db.aggregate() 不支持事务模式");
|
|
31
36
|
return this.#host.aggregate();
|
|
32
37
|
}
|
|
33
38
|
#hasWhere = void 0;
|
|
34
39
|
#hasWhereId = void 0;
|
|
35
|
-
#where
|
|
40
|
+
#where = {};
|
|
41
|
+
#doWhere(where, from) {
|
|
36
42
|
if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);
|
|
37
43
|
const whereKeys = Object.keys(where);
|
|
38
44
|
const isWhereId = whereKeys.length === 1 && "_id" in where && (isString(where._id) || isNumber(where._id));
|
|
@@ -40,12 +46,8 @@ class Db {
|
|
|
40
46
|
throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);
|
|
41
47
|
}
|
|
42
48
|
this.#hasWhere = from;
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
this.#host = this.#host.doc(where._id);
|
|
46
|
-
} else {
|
|
47
|
-
this.#host = this.#host.where(where);
|
|
48
|
-
}
|
|
49
|
+
this.#where = where;
|
|
50
|
+
if (isWhereId) this.#hasWhereId = from;
|
|
49
51
|
return this;
|
|
50
52
|
}
|
|
51
53
|
/**
|
|
@@ -54,7 +56,7 @@ class Db {
|
|
|
54
56
|
* @returns 当前Db实例,支持链式调用
|
|
55
57
|
*/
|
|
56
58
|
where(where) {
|
|
57
|
-
return this.#
|
|
59
|
+
return this.#doWhere(where, "where");
|
|
58
60
|
}
|
|
59
61
|
/**
|
|
60
62
|
* 根据ID设置查询条件
|
|
@@ -62,9 +64,10 @@ class Db {
|
|
|
62
64
|
* @returns 当前Db实例,支持链式调用
|
|
63
65
|
*/
|
|
64
66
|
whereId(id) {
|
|
65
|
-
return this.#
|
|
67
|
+
return this.#doWhere({ _id: id }, "whereId");
|
|
66
68
|
}
|
|
67
69
|
#hasSelect = 0;
|
|
70
|
+
#select = {};
|
|
68
71
|
/**
|
|
69
72
|
* 指定要返回的字段
|
|
70
73
|
* @param fields 要返回的字段对象,true表示返回,false表示不返回
|
|
@@ -73,10 +76,11 @@ class Db {
|
|
|
73
76
|
select(fields) {
|
|
74
77
|
if (this.#hasSelect) throw new Error("db.select() 方法只能调用一次");
|
|
75
78
|
this.#hasSelect++;
|
|
76
|
-
this.#
|
|
79
|
+
this.#select = fields;
|
|
77
80
|
return this;
|
|
78
81
|
}
|
|
79
82
|
#hasOrder = 0;
|
|
83
|
+
#order = {};
|
|
80
84
|
/**
|
|
81
85
|
* 设置排序规则
|
|
82
86
|
* @param order 排序规则对象,key为字段名,value为"asc"或"desc"
|
|
@@ -84,12 +88,11 @@ class Db {
|
|
|
84
88
|
*/
|
|
85
89
|
order(order) {
|
|
86
90
|
this.#hasOrder++;
|
|
87
|
-
|
|
88
|
-
this.#host = this.#host.orderBy(key, val);
|
|
89
|
-
});
|
|
91
|
+
this.#order = order;
|
|
90
92
|
return this;
|
|
91
93
|
}
|
|
92
94
|
#hasSkip = 0;
|
|
95
|
+
#skip = 0;
|
|
93
96
|
/**
|
|
94
97
|
* 跳过指定数量的记录
|
|
95
98
|
* @param skip 要跳过的记录数
|
|
@@ -98,10 +101,11 @@ class Db {
|
|
|
98
101
|
skip(skip) {
|
|
99
102
|
if (this.#hasSkip) throw new Error("db.skip() 方法只能调用一次");
|
|
100
103
|
this.#hasSkip++;
|
|
101
|
-
this.#
|
|
104
|
+
this.#skip = skip;
|
|
102
105
|
return this;
|
|
103
106
|
}
|
|
104
107
|
#hasLimit = 0;
|
|
108
|
+
#limit = 0;
|
|
105
109
|
/**
|
|
106
110
|
* 限制返回的记录数量
|
|
107
111
|
* @param limit 最大返回记录数
|
|
@@ -113,30 +117,97 @@ class Db {
|
|
|
113
117
|
throw new Error(`db.limit() 方法不能与 ${_toWhereIdMethod(this.#hasWhereId)} 方法同时调用`);
|
|
114
118
|
}
|
|
115
119
|
this.#hasLimit++;
|
|
116
|
-
this.#
|
|
120
|
+
this.#limit = limit;
|
|
117
121
|
return this;
|
|
118
122
|
}
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
return
|
|
123
|
+
#hasLookup = 0;
|
|
124
|
+
get hasLookup() {
|
|
125
|
+
return this.#hasLookup > 0;
|
|
126
|
+
}
|
|
127
|
+
#lookups = [];
|
|
128
|
+
lookup(table, lookup) {
|
|
129
|
+
table.#hasLookup++;
|
|
130
|
+
this.#hasLookup++;
|
|
131
|
+
this.#lookups.push({
|
|
132
|
+
...lookup,
|
|
133
|
+
table,
|
|
134
|
+
from: table.table
|
|
135
|
+
});
|
|
136
|
+
return this;
|
|
137
|
+
}
|
|
138
|
+
#aggregated = false;
|
|
139
|
+
#endAggregate(aggRef) {
|
|
140
|
+
if (this.#aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);
|
|
141
|
+
this.#aggregated = true;
|
|
142
|
+
let returnAggRef = aggRef;
|
|
143
|
+
const projects = {};
|
|
144
|
+
for (const { type, as, foreignField, from, localField, table } of this.#lookups) {
|
|
145
|
+
const varName = `v${gid++}`;
|
|
146
|
+
let pipeline = dbAgg.pipeline();
|
|
147
|
+
pipeline = pipeline.match(
|
|
148
|
+
dbCmd.expr(
|
|
149
|
+
type === "n:1" ? (
|
|
150
|
+
// @ts-ignore
|
|
151
|
+
dbAgg.in([`$${foreignField}`, `$$${varName}`])
|
|
152
|
+
) : dbAgg.eq([`$${foreignField}`, `$$${varName}`])
|
|
153
|
+
)
|
|
154
|
+
);
|
|
155
|
+
pipeline = table.#endAggregate(pipeline);
|
|
156
|
+
pipeline = pipeline.done();
|
|
157
|
+
returnAggRef = returnAggRef.lookup({
|
|
158
|
+
let: {
|
|
159
|
+
[varName]: `$${localField}`
|
|
160
|
+
},
|
|
161
|
+
as,
|
|
162
|
+
from,
|
|
163
|
+
pipeline
|
|
164
|
+
});
|
|
165
|
+
if (type === "1:1") {
|
|
166
|
+
returnAggRef = returnAggRef.unwind({
|
|
167
|
+
path: `$${as}`,
|
|
168
|
+
preserveNullAndEmptyArrays: true
|
|
169
|
+
});
|
|
170
|
+
}
|
|
171
|
+
projects[as] = true;
|
|
172
|
+
}
|
|
173
|
+
if (this.#hasWhere) returnAggRef = returnAggRef.match(this.#where);
|
|
174
|
+
if (this.#hasSelect) returnAggRef = returnAggRef.project({ ...this.#select, ...projects });
|
|
175
|
+
if (this.#hasOrder) returnAggRef = returnAggRef.sort(objectMap(this.#order, (v) => v === "asc" ? 1 : -1));
|
|
176
|
+
if (this.#hasSkip) returnAggRef = returnAggRef.skip(this.#skip);
|
|
177
|
+
if (this.#hasLimit) returnAggRef = returnAggRef.limit(this.#limit);
|
|
178
|
+
return returnAggRef;
|
|
179
|
+
}
|
|
180
|
+
#endHost() {
|
|
181
|
+
if (this.#hasWhere) {
|
|
182
|
+
this.#host = this.#host.where(this.#where);
|
|
183
|
+
}
|
|
184
|
+
if (this.#hasSelect) {
|
|
185
|
+
this.#host = this.#host.field(this.#select);
|
|
186
|
+
}
|
|
187
|
+
if (this.#hasOrder) {
|
|
188
|
+
objectEach(this.#order, (val, key) => {
|
|
189
|
+
this.#host = this.#host.orderBy(key, val);
|
|
190
|
+
});
|
|
191
|
+
}
|
|
192
|
+
if (this.#hasSkip) this.#host = this.#host.skip(this.#skip);
|
|
193
|
+
if (this.#hasLimit) this.#host = this.#host.limit(this.#limit);
|
|
194
|
+
else if (this.#hasWhereId) this.#host = this.#host.limit(1);
|
|
133
195
|
}
|
|
134
196
|
/**
|
|
135
197
|
* 执行查询操作
|
|
136
198
|
* @returns 查询结果
|
|
137
199
|
*/
|
|
138
200
|
async query() {
|
|
139
|
-
|
|
201
|
+
let res;
|
|
202
|
+
if (this.#hasLookup) {
|
|
203
|
+
const aggRef = this.aggregate();
|
|
204
|
+
this.#endAggregate(aggRef);
|
|
205
|
+
res = await aggRef.end();
|
|
206
|
+
} else {
|
|
207
|
+
this.#endHost();
|
|
208
|
+
res = await this.#host.get();
|
|
209
|
+
}
|
|
210
|
+
isArray(res.data) ? res.data : [res.data];
|
|
140
211
|
const { data } = parseDatabaseOutput(res);
|
|
141
212
|
return data;
|
|
142
213
|
}
|
|
@@ -153,26 +224,47 @@ class Db {
|
|
|
153
224
|
* @returns 记录总数
|
|
154
225
|
*/
|
|
155
226
|
async count() {
|
|
227
|
+
if (this.#hasLookup) throw new Error("db.count() 方法不支持 lookup 聚合");
|
|
156
228
|
if (this.#hasSelect) throw new Error("db.count() 方法不支持 select 条件");
|
|
157
229
|
if (this.#hasOrder) throw new Error("db.count() 方法不支持 order 条件");
|
|
158
230
|
if (this.#hasSkip) throw new Error("db.count() 方法不支持 skip 条件");
|
|
159
231
|
if (this.#hasLimit) throw new Error("db.count() 方法不支持 limit 条件");
|
|
232
|
+
this.#endHost();
|
|
160
233
|
const res = await this.#host.count();
|
|
161
234
|
const { total } = parseDatabaseOutput(res);
|
|
162
235
|
return total;
|
|
163
236
|
}
|
|
237
|
+
/**
|
|
238
|
+
* 创建新记录
|
|
239
|
+
* @param data 要创建的数据
|
|
240
|
+
* @returns 创建结果
|
|
241
|
+
*/
|
|
242
|
+
async create(data) {
|
|
243
|
+
if (this.#hasLookup) throw new Error("db.create() 方法不支持 lookup 聚合");
|
|
244
|
+
if (this.#hasWhere) throw new Error("db.create() 方法不支持 where 条件");
|
|
245
|
+
if (this.#hasSelect) throw new Error("db.create() 方法不支持 select 条件");
|
|
246
|
+
if (this.#hasOrder) throw new Error("db.create() 方法不支持 order 条件");
|
|
247
|
+
if (this.#hasSkip) throw new Error("db.create() 方法不支持 skip 条件");
|
|
248
|
+
if (this.#hasLimit) throw new Error("db.create() 方法不支持 limit 条件");
|
|
249
|
+
this.#endHost();
|
|
250
|
+
const res = await this.#host.add(data);
|
|
251
|
+
const { id } = parseDatabaseOutput(res);
|
|
252
|
+
return id;
|
|
253
|
+
}
|
|
164
254
|
/**
|
|
165
255
|
* 更新记录
|
|
166
256
|
* @param data 要更新的数据
|
|
167
257
|
* @returns 更新结果
|
|
168
258
|
*/
|
|
169
259
|
async update(data) {
|
|
260
|
+
if (this.#hasLookup) throw new Error("db.update() 方法不支持 lookup 聚合");
|
|
170
261
|
if (!this.#hasWhere) throw new Error("设置 where 条件后才能执行 db.update() 方法");
|
|
171
262
|
if (this.#hasSelect) throw new Error("db.update() 方法不支持 select 条件");
|
|
172
263
|
if (this.#hasOrder) throw new Error("db.update() 方法不支持 order 条件");
|
|
173
264
|
if (this.#hasSkip) throw new Error("db.update() 方法不支持 skip 条件");
|
|
174
265
|
if (this.#hasLimit) throw new Error("db.update() 方法不支持 limit 条件");
|
|
175
266
|
if (this.#isTransaction && !this.#hasWhereId) throw new Error("事务模式下 db.update() 的 where 条件必须是 _id");
|
|
267
|
+
this.#endHost();
|
|
176
268
|
const res = await this.#host.update(data);
|
|
177
269
|
const { updated } = parseDatabaseOutput(res);
|
|
178
270
|
return updated;
|
|
@@ -182,12 +274,14 @@ class Db {
|
|
|
182
274
|
* @returns 删除结果
|
|
183
275
|
*/
|
|
184
276
|
async remove() {
|
|
277
|
+
if (this.#hasLookup) throw new Error("db.remove() 方法不支持 lookup 聚合");
|
|
185
278
|
if (!this.#hasWhere) throw new Error("设置 where 条件后才能执行 db.remove() 方法");
|
|
186
279
|
if (this.#hasSelect) throw new Error("db.remove() 方法不支持 select 条件");
|
|
187
280
|
if (this.#hasOrder) throw new Error("db.remove() 方法不支持 order 条件");
|
|
188
281
|
if (this.#hasSkip) throw new Error("db.remove() 方法不支持 skip 条件");
|
|
189
282
|
if (this.#hasLimit) throw new Error("db.remove() 方法不支持 limit 条件");
|
|
190
283
|
if (this.#isTransaction && !this.#hasWhereId) throw new Error("事务模式下 db.remove() 的 where 条件必须是 _id");
|
|
284
|
+
this.#endHost();
|
|
191
285
|
const res = await this.#host.remove();
|
|
192
286
|
const { deleted } = parseDatabaseOutput(res);
|
|
193
287
|
return deleted;
|
|
@@ -199,13 +293,17 @@ const db = {
|
|
|
199
293
|
* @param name 数据表名称
|
|
200
294
|
* @returns Db类实例,用于执行数据库操作
|
|
201
295
|
*/
|
|
296
|
+
// biome-ignore lint/complexity/noBannedTypes: <explanation>
|
|
202
297
|
table(name) {
|
|
203
298
|
return new Proxy(
|
|
204
299
|
{},
|
|
205
300
|
{
|
|
206
301
|
get(target, prop) {
|
|
302
|
+
if (prop === "_isProxy") return true;
|
|
207
303
|
const table = new Db({ table: name });
|
|
208
|
-
|
|
304
|
+
const tableProp = prop;
|
|
305
|
+
const ref = table[tableProp];
|
|
306
|
+
return isFunction(ref) ? ref.bind(table) : ref;
|
|
209
307
|
}
|
|
210
308
|
}
|
|
211
309
|
);
|
|
@@ -227,9 +325,8 @@ function _toWhereMethod(whereFrom) {
|
|
|
227
325
|
function _toWhereIdMethod(whereFrom) {
|
|
228
326
|
return whereFrom === "where" ? "where({ _id })" : "whereId(id)";
|
|
229
327
|
}
|
|
230
|
-
async function dbUpsert(options) {
|
|
328
|
+
async function dbUpsert(dbProxy, options) {
|
|
231
329
|
const {
|
|
232
|
-
collection,
|
|
233
330
|
where,
|
|
234
331
|
select = {},
|
|
235
332
|
create,
|
|
@@ -238,30 +335,35 @@ async function dbUpsert(options) {
|
|
|
238
335
|
onAfterCreate,
|
|
239
336
|
onBeforeUpdate,
|
|
240
337
|
onAfterUpdate,
|
|
241
|
-
|
|
338
|
+
_mockDbInstance
|
|
242
339
|
} = options;
|
|
243
340
|
if ("_id" in select) throw new Error("select 条件不能包含 _id 字段");
|
|
244
|
-
const _db =
|
|
245
|
-
const
|
|
246
|
-
if (
|
|
247
|
-
await onBeforeUpdate?.(
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
341
|
+
const _db = _mockDbInstance || dbProxy;
|
|
342
|
+
const exist = await _db.where(where).select(select || {}).queryOne(true);
|
|
343
|
+
if (exist) {
|
|
344
|
+
const skipUpdate = await onBeforeUpdate?.(exist) === false;
|
|
345
|
+
if (skipUpdate) {
|
|
346
|
+
return { id: exist._id, updated: false, created: false };
|
|
347
|
+
}
|
|
348
|
+
const updateData = isFunction(update) ? update(exist) : update;
|
|
349
|
+
await _db.whereId(exist._id).update(updateData);
|
|
350
|
+
onAfterUpdate?.(updateData, exist);
|
|
351
|
+
return { id: exist._id, updated: true, created: false };
|
|
252
352
|
}
|
|
253
353
|
await onBeforeCreate?.();
|
|
254
|
-
const createdId = await _db
|
|
354
|
+
const createdId = await _db.create(create);
|
|
255
355
|
await onAfterCreate?.(createdId);
|
|
256
|
-
return createdId;
|
|
356
|
+
return { id: createdId, updated: false, created: true };
|
|
257
357
|
}
|
|
258
|
-
async function dbTransaction(
|
|
259
|
-
const
|
|
260
|
-
const [err1, transaction] = await tryFlatten(
|
|
358
|
+
async function dbTransaction(transacting, _mockDatabase, _mockDbInstance) {
|
|
359
|
+
const transactionDb = _mockDatabase || uniCloud.database();
|
|
360
|
+
const [err1, transaction] = await tryFlatten(transactionDb.startTransaction());
|
|
261
361
|
if (err1) throw err1;
|
|
262
|
-
const
|
|
362
|
+
const withTransaction = (dbProxy) => {
|
|
363
|
+
return _mockDbInstance || new Db({ table: dbProxy.table, transaction });
|
|
364
|
+
};
|
|
263
365
|
const [err2, result] = await tryFlatten(async () => {
|
|
264
|
-
const result2 = await
|
|
366
|
+
const result2 = await transacting(withTransaction);
|
|
265
367
|
await transaction.commit();
|
|
266
368
|
return result2;
|
|
267
369
|
});
|
package/dist/database.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"database.mjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectOmit } from '@cloudcome/utils-core/object';\nimport { isNumber, isString } from '@cloudcome/utils-core/type';\nimport type { AnyObject, HasProperty, IsEmptyObject, IsOnlyProperty } from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';\n\nexport type DbWhere<T> = {\n [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n ? // 默认全部字段\n DbFieldsDefault<T>\n : // 判断 _id 是否为唯一属性\n IsOnlyProperty<S, '_id'> extends true\n ? // 从默认字段里排除 _id\n Omit<DbFieldsDefault<T>, '_id'>\n : // 判断是否有 _id\n HasProperty<S, '_id'> extends true\n ? // 有的话保留 {_id, ...}\n S\n : // 没有的话补上 {_id, ...}\n S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>> = _DbQuery<T, _DbFields<T, S>>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command;\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate;\n\nclass Aggregate {\n #db: UniCloud.CollectionReference;\n\n constructor(db: UniCloud.CollectionReference) {\n this.#db = db;\n }\n\n start() {\n return this.#db.aggregate();\n }\n}\n\nexport type DbOptions = {\n /**\n * 数据表名称\n */\n table: string;\n\n /**\n * 事务对象,用于事务操作\n */\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n transaction?: any;\n\n /**\n * 模拟数据库,用于单元测试\n */\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n _mockDatabase?: any;\n};\n\nexport class Db<T, S extends DbSelect<T> = Record<string, never>> {\n #host: UniCloud.CollectionReference;\n\n /**\n * 是否为事务环境\n * - 查询条件只能是 id\n * - 不能聚合操作\n */\n #isTransaction: boolean;\n\n /**\n * 构造函数,初始化数据库集合引用\n * @param collection 数据表名称\n * @param _mockDatabase 模拟数据库,用于单元测试\n */\n constructor(options: DbOptions) {\n this.#host = options._mockDatabase || options.transaction || db0.collection(options.table);\n this.#isTransaction = !!options.transaction;\n }\n\n /**\n * 创建聚合操作实例\n * @returns 聚合操作实例\n */\n aggregate() {\n if (!this.#isTransaction) throw new Error('db.aggregate() 不支持事务模式');\n\n return this.#host.aggregate();\n }\n\n #hasWhere: _WhereFrom | undefined = undefined;\n #hasWhereId: _WhereFrom | undefined = undefined;\n\n #where(where: DbWhere<T>, from: _WhereFrom) {\n if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n const whereKeys = Object.keys(where);\n // 只有 _id 值为字符串或数字时,才能调用 doc 方法\n const isWhereId = whereKeys.length === 1 && '_id' in where && (isString(where._id) || isNumber(where._id));\n\n if (isWhereId && this.#hasLimit) {\n throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n }\n\n this.#hasWhere = from;\n\n if (isWhereId) {\n this.#hasWhereId = from;\n // @ts-ignore\n this.#host = this.#host.doc(where._id);\n } else {\n // @ts-ignore\n this.#host = this.#host.where(where);\n }\n\n return this;\n }\n\n /**\n * 设置查询条件\n * @param where 查询条件对象\n * @returns 当前Db实例,支持链式调用\n */\n where(where: DbWhere<T>) {\n return this.#where(where, 'where');\n }\n\n /**\n * 根据ID设置查询条件\n * @param id 记录ID\n * @returns 当前Db实例,支持链式调用\n */\n whereId(id: string | number) {\n // @ts-ignore\n return this.#where({ _id: id }, 'whereId');\n }\n\n #hasSelect = 0;\n\n /**\n * 指定要返回的字段\n * @param fields 要返回的字段对象,true表示返回,false表示不返回\n * @returns 当前Db实例,支持链式调用\n */\n select<U extends DbSelect<T>>(fields: U): Db<T, U> {\n if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n this.#hasSelect++;\n // @ts-ignore\n this.#host = this.#host.field(fields);\n // @ts-ignore\n return this;\n }\n\n #hasOrder = 0;\n\n /**\n * 设置排序规则\n * @param order 排序规则对象,key为字段名,value为\"asc\"或\"desc\"\n * @returns 当前Db实例,支持链式调用\n */\n order(order: DbOrder<T>) {\n this.#hasOrder++;\n objectEach(order, (val, key) => {\n // @ts-ignore\n this.#host = this.#host.orderBy(key, val);\n });\n\n return this;\n }\n\n #hasSkip = 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 // @ts-ignore\n this.#host = this.#host.skip(skip);\n return this;\n }\n\n #hasLimit = 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(`db.limit() 方法不能与 ${_toWhereIdMethod(this.#hasWhereId)} 方法同时调用`);\n }\n\n this.#hasLimit++;\n // @ts-ignore\n this.#host = this.#host.limit(limit);\n return this;\n }\n\n /**\n * 创建新记录\n * @param data 要创建的数据\n * @returns 创建结果\n */\n async create(data: DbCreate<T>) {\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 const res = await this.#host.add(data);\n const { id } = parseDatabaseOutput<{ id: string }>(res);\n return id;\n }\n\n /**\n * 执行查询操作\n * @returns 查询结果\n */\n async query() {\n const res = await this.#host.get();\n const { data } = parseDatabaseOutput<{ data: DbQuery<T, S>[] }>(res);\n return data;\n }\n\n /**\n * 只查询一条,自动添加 limit(1) 条件\n * @param ignoreMiss 是否忽略没有匹配到记录\n * @returns 查询结果\n */\n async queryOne(): Promise<DbQuery<T, S>>;\n async queryOne(ignoreMiss: false): Promise<DbQuery<T, S>>;\n async queryOne(ignoreMiss: true): Promise<DbQuery<T, S> | undefined>;\n async queryOne(ignoreMiss = false): Promise<DbQuery<T, S> | undefined> {\n if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n if (!this.#hasWhereId) this.limit(1);\n\n const data = await this.query();\n const res = data.at(0);\n\n if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n return res;\n }\n\n /**\n * 获取匹配记录的数量\n * @returns 记录总数\n */\n async count() {\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 const res = await this.#host.count();\n const { total } = parseDatabaseOutput<{ total: number }>(res);\n return total;\n }\n\n /**\n * 更新记录\n * @param data 要更新的数据\n * @returns 更新结果\n */\n async update(data: AnyObject) {\n if (!this.#hasWhere) 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) throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n const res = await this.#host.update(data);\n const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n return updated;\n }\n\n /**\n * 删除记录\n * @returns 删除结果\n */\n async remove() {\n if (!this.#hasWhere) 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) throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n const res = await this.#host.remove();\n const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n return deleted;\n }\n}\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n /**\n * 获取指定名称的数据库集合实例\n * @param name 数据表名称\n * @returns Db类实例,用于执行数据库操作\n */\n table<T>(name: string) {\n return new Proxy(\n {},\n {\n get(target, prop) {\n const table = new Db<T>({ table: name });\n return table[prop as keyof Db<T>].bind(table);\n },\n },\n ) as Db<T>;\n },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<T>) {\n const keys = Object.keys(res as AnyObject);\n // 客户端 { result: {errCode: 0, errMsg: 'ok'} & 数据 }\n const isClient = keys.length === 1 && keys[0] === 'result';\n\n if (isClient) {\n const { result } = res as UniClientDatabaseOutput<T>;\n if (!result.errCode) return objectOmit(result, ['errCode', 'errMsg', 'code', 'message']);\n throw errorAssign(new Error(result.errMsg), result);\n }\n\n // 云端 数据\n return res as T;\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","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\n/**\n * 数据库 upsert 操作的配置选项\n *\n * @template W - 查询条件类型\n * @template S - 查询返回字段类型\n * @template C - 创建数据类型\n * @template U - 更新数据类型\n * @template R - 查询结果类型\n */\nexport type DbUpsertOptions<\n T,\n W extends DbWhere<T>,\n S extends DbSelect<T>,\n C extends DbCreate<T>,\n U extends DbUpdate<T>,\n> = {\n /** 集合名称 */\n collection: string;\n\n /** 查询条件 */\n where: W;\n\n /** 查询返回字段 */\n select?: S;\n\n /** 创建数据 */\n create: C;\n\n /**\n * 更新数据,可以是对象或根据查询结果生成更新对象的函数\n * @param row 查询到的文档数据,仅在传入函数时可用\n */\n update: U | ((row: DbQuery<T, S>) => U);\n\n /** 创建前回调函数 */\n onBeforeCreate?: () => unknown;\n\n /**\n * 创建后回调函数\n * @param id 创建的文档ID\n */\n onAfterCreate?: (id: string) => unknown;\n\n /**\n * 更新前回调函数\n * @param row 查询到的文档\n */\n onBeforeUpdate?: (row: DbQuery<T, S>) => unknown;\n\n /** 更新后回调函数 */\n onAfterUpdate?: () => unknown;\n\n /** 用于测试的模拟数据库实例 */\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n _mockDb?: (collection: string) => any;\n};\n\nexport async function dbUpsert<\n T,\n W extends DbWhere<T>,\n S extends DbSelect<T>,\n C extends DbCreate<T>,\n U extends DbUpdate<T>,\n>(options: DbUpsertOptions<T, W, S, C, U>) {\n const {\n collection,\n where,\n select = {},\n create,\n update,\n onBeforeCreate,\n onAfterCreate,\n onBeforeUpdate,\n onAfterUpdate,\n _mockDb,\n } = options;\n\n // @ts-ignore\n if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n const _db = () => (_mockDb?.(collection) || db.table(collection)) as Db<T, S>;\n const found = (await _db()\n .where(where)\n .select(select || {})\n .limit(1)\n .queryOne(true)) as DbQuery<T, S> | undefined;\n\n if (found) {\n await onBeforeUpdate?.(found);\n const updateData = isFunction(update) ? update(found) : update;\n // @ts-ignore\n const updated = await _db().whereId(found._id).update(updateData);\n onAfterUpdate?.();\n\n return updated;\n }\n\n await onBeforeCreate?.();\n const createdId = await _db().create(create);\n await onAfterCreate?.(createdId);\n\n return createdId;\n}\n\ntype _TransactionDb = {\n startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n commit: () => Promise<unknown>;\n rollback: () => Promise<unknown>;\n};\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\n * @param transact - 事务执行函数,接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n *\n * @example\n * ```typescript\n * const result = await dbTransaction(async (ta) => {\n * const user = await ta.collection('users').create({ name: 'John' });\n * const order = await ta.collection('orders').create({ userId: user.id, amount: 100 });\n * return { user, order };\n * });\n * ```\n */\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport async function dbTransaction<T, S extends DbSelect<T> = {}>(\n transact: (ta: Db<T, S>) => Promise<unknown>,\n _mockDatabase?: _TransactionDb,\n) {\n const db = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n const [err1, transaction] = await tryFlatten(db.startTransaction());\n if (err1) throw err1;\n\n const ta = new Db<T, S>({ table: '', transaction });\n const [err2, result] = await tryFlatten(async () => {\n const result = await transact(ta);\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;\n}\n"],"names":["db","result"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"database.mjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isArray, isFunction, isNumber, isString } from '@cloudcome/utils-core/type';\nimport type {\n AnyObject,\n HasProperty,\n IsEmptyObject,\n IsOnlyProperty,\n MergeIntersection,\n UnionToIntersection,\n} from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput, UniDatabaseCommand } from './types';\n\nexport type DbWhere<T> = {\n [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n ? // 默认全部字段\n DbFieldsDefault<T>\n : // 判断 _id 是否为唯一属性\n IsOnlyProperty<S, '_id'> extends true\n ? // 从默认字段里排除 _id\n Omit<DbFieldsDefault<T>, '_id'>\n : // 判断是否有 _id\n HasProperty<S, '_id'> extends true\n ? // 有的话保留 {_id, ...}\n S\n : // 没有的话补上 {_id, ...}\n S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>, R> = _DbQuery<T, _DbFields<T, S>> & R;\nexport type DbForeign<T, S extends DbSelect<T>, R, J extends DbJoinType, A> = Record<\n A & string,\n J extends '1:1' ? DbQuery<T, S, R> : DbQuery<T, S, R>[]\n>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command as unknown as UniDatabaseCommand;\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate as UniCloud.AggregateCommand & {\n pipeline: () => UniCloud.AggregateReference & {\n done: () => unknown;\n };\n};\n\nexport type DbOptions = {\n /**\n * 数据表名称\n */\n table: string;\n\n /**\n * 事务对象,用于事务操作\n */\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n transaction?: any;\n\n /**\n * 模拟数据库,用于单元测试\n */\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n _mockDatabase?: any;\n};\n\n/**\n * 数据库关联类型\n * - '1:1': 一对一关联,返回值 1 个\n * - '1:n': 一对多关联,返回值 n 个\n * - 'n:1': 多对一关联,返回值 n 个\n */\nexport type DbJoinType = '1:1' | '1:n' | 'n:1';\nexport type DbLookupOptions<J extends DbJoinType, L, F, A> = {\n /**\n * 关联类型\n */\n type: J;\n\n /**\n * 主表字段\n */\n localField: keyof L & string;\n\n /**\n * 关联表字段\n */\n foreignField: keyof F & string;\n\n /**\n * 关联数据在结果中的字段名\n */\n as: A;\n};\n\nexport type DbLookup = {\n /**\n * 关联表\n */\n table: Db<unknown>;\n\n /**\n * 关联类型\n */\n type: DbJoinType;\n\n /**\n * 主表字段\n */\n localField: string;\n\n /**\n * 关联表字段\n */\n foreignField: string;\n\n /**\n * 关联表名称\n */\n from: string;\n\n /**\n * 关联数据在结果中的字段名\n */\n as: string;\n};\n\nlet gid = 0;\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport class Db<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> {\n #host: UniCloud.CollectionReference;\n\n /**\n * 是否为事务环境\n * - 查询条件只能是 id\n * - 不能聚合操作\n */\n #isTransaction = false;\n\n #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 || options.transaction?.collection(options.table) || db0.collection(options.table);\n this.#isTransaction = !!options.transaction;\n }\n\n get table() {\n return this.#options.table;\n }\n\n /**\n * 获取聚合操作实例\n * @returns 聚合操作实例\n */\n aggregate() {\n return this.#host.aggregate();\n }\n\n #hasWhere: _WhereFrom | undefined = undefined;\n #hasWhereId: _WhereFrom | undefined = undefined;\n #where = {};\n\n #doWhere(where: DbWhere<T>, from: _WhereFrom) {\n if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n const whereKeys = Object.keys(where);\n // 只有 _id 值为字符串或数字时,才能调用 doc 方法\n const isWhereId = whereKeys.length === 1 && '_id' in where && (isString(where._id) || isNumber(where._id));\n\n if (isWhereId && this.#hasLimit) {\n throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n }\n\n this.#hasWhere = from;\n this.#where = where;\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<T>) {\n return this.#doWhere(where, 'where');\n }\n\n /**\n * 根据ID设置查询条件\n * @param id 记录ID\n * @returns 当前Db实例,支持链式调用\n */\n whereId(id: string | number) {\n // @ts-ignore\n return this.#doWhere({ _id: id }, 'whereId');\n }\n\n #hasSelect = 0;\n #select = {};\n\n /**\n * 指定要返回的字段\n * @param fields 要返回的字段对象,true表示返回,false表示不返回\n * @returns 当前Db实例,支持链式调用\n */\n select<U extends DbSelect<T>>(fields: U) {\n if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n this.#hasSelect++;\n this.#select = fields;\n\n return this as Db<T, S & U, R>;\n }\n\n #hasOrder = 0;\n #order = {};\n\n /**\n * 设置排序规则\n * @param order 排序规则对象,key为字段名,value为\"asc\"或\"desc\"\n * @returns 当前Db实例,支持链式调用\n */\n order(order: DbOrder<T>) {\n this.#hasOrder++;\n this.#order = order;\n\n return this;\n }\n\n #hasSkip = 0;\n #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 #hasLimit = 0;\n #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(`db.limit() 方法不能与 ${_toWhereIdMethod(this.#hasWhereId)} 方法同时调用`);\n }\n\n this.#hasLimit++;\n this.#limit = limit;\n\n return this;\n }\n\n #hasLookup = 0;\n get hasLookup() {\n return this.#hasLookup > 0;\n }\n\n #lookups: DbLookup[] = [];\n lookup<FT, FS extends DbSelect<FT>, FR extends AnyObject, J extends DbJoinType, A extends string>(\n table: Db<FT, FS, FR>,\n lookup: DbLookupOptions<J, T, FT, A>,\n ) {\n // 对方表也记为关联查询,避免做表更新操作\n table.#hasLookup++;\n this.#hasLookup++;\n this.#lookups.push({\n ...lookup,\n table,\n from: table.table,\n });\n\n // 这里必须合并联合类型,否则类型结果会丢失最后一次 lookup\n // @ts-ignore\n return this as Db<T, S, MergeIntersection<R & DbForeign<FT, FS, FR, J, A>>>;\n }\n\n #aggregated = false;\n #endAggregate(aggRef: UniCloud.AggregateReference) {\n if (this.#aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n this.#aggregated = true;\n let returnAggRef = aggRef;\n const projects: Record<string, true> = {};\n\n for (const { type, as, foreignField, from, localField, table } of this.#lookups) {\n const varName = `v${gid++}`;\n let pipeline = dbAgg.pipeline();\n\n // 关联条件\n // @ts-ignore\n pipeline = pipeline.match(\n dbCmd.expr(\n type === 'n:1'\n ? // @ts-ignore\n dbAgg.in([`$${foreignField}`, `$$${varName}`])\n : dbAgg.eq([`$${foreignField}`, `$$${varName}`]),\n ),\n );\n\n // 其他查询条件\n // @ts-ignore\n pipeline = table.#endAggregate(pipeline);\n\n // @ts-ignore\n pipeline = pipeline.done();\n\n returnAggRef = returnAggRef.lookup({\n let: {\n [varName]: `$${localField}`,\n },\n as,\n from,\n pipeline,\n });\n\n // 1对1,展开数组\n if (type === '1:1') {\n // @ts-ignore\n returnAggRef = returnAggRef.unwind({\n path: `$${as}`,\n preserveNullAndEmptyArrays: true,\n });\n }\n\n projects[as] = true;\n }\n\n // 主表查询\n if (this.#hasWhere) returnAggRef = returnAggRef.match(this.#where);\n if (this.#hasSelect) returnAggRef = returnAggRef.project({ ...this.#select, ...projects });\n if (this.#hasOrder) returnAggRef = returnAggRef.sort(objectMap(this.#order, (v) => (v === 'asc' ? 1 : -1)));\n if (this.#hasSkip) returnAggRef = returnAggRef.skip(this.#skip);\n if (this.#hasLimit) returnAggRef = returnAggRef.limit(this.#limit);\n\n return returnAggRef;\n }\n\n #endHost() {\n if (this.#hasWhere) {\n // @ts-ignore\n this.#host = this.#host.where(this.#where);\n }\n\n if (this.#hasSelect) {\n // @ts-ignore\n this.#host = this.#host.field(this.#select);\n }\n\n if (this.#hasOrder) {\n objectEach(this.#order, (val, key) => {\n // @ts-ignore\n this.#host = this.#host.orderBy(key, val);\n });\n }\n\n // @ts-ignore\n if (this.#hasSkip) this.#host = this.#host.skip(this.#skip);\n\n // @ts-ignore\n if (this.#hasLimit) this.#host = this.#host.limit(this.#limit);\n // @ts-ignore\n else if (this.#hasWhereId) this.#host = this.#host.limit(1);\n }\n\n /**\n * 执行查询操作\n * @returns 查询结果\n */\n async query() {\n let res: { data: DbQuery<T, S, R>[] };\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();\n res = await this.#host.get();\n }\n\n const rows = isArray(res.data) ? res.data : [res.data];\n const { data } = parseDatabaseOutput(res);\n return data;\n }\n\n /**\n * 只查询一条,自动添加 limit(1) 条件\n * @param ignoreMiss 是否忽略没有匹配到记录\n * @returns 查询结果\n */\n async queryOne(): Promise<DbQuery<T, S, R>>;\n async queryOne(ignoreMiss: false): Promise<DbQuery<T, S, R>>;\n async queryOne(ignoreMiss: true): Promise<DbQuery<T, S, R> | undefined>;\n async queryOne(ignoreMiss = false): Promise<DbQuery<T, S, R> | undefined> {\n if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n if (!this.#hasWhereId) this.limit(1);\n\n const data = await this.query();\n const res = data.at(0);\n\n if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n return res;\n }\n\n /**\n * 获取匹配记录的数量\n * @returns 记录总数\n */\n async 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 this.#endHost();\n const res = await this.#host.count();\n const { total } = parseDatabaseOutput<{ total: number }>(res);\n return total;\n }\n\n /**\n * 创建新记录\n * @param data 要创建的数据\n * @returns 创建结果\n */\n async create(data: DbCreate<T>) {\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 this.#endHost();\n const res = await this.#host.add(data);\n const { id } = parseDatabaseOutput<{ id: string }>(res);\n return id;\n }\n\n /**\n * 更新记录\n * @param data 要更新的数据\n * @returns 更新结果\n */\n async update(data: AnyObject) {\n if (this.#hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n if (!this.#hasWhere) 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) throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n this.#endHost();\n const res = await this.#host.update(data);\n const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n return updated;\n }\n\n /**\n * 删除记录\n * @returns 删除结果\n */\n async remove() {\n if (this.#hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n if (!this.#hasWhere) 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) throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n this.#endHost();\n const res = await this.#host.remove();\n const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n return deleted;\n }\n}\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport type DbProxy<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> = Db<T, S, R> & {\n _isProxy: true;\n};\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n /**\n * 获取指定名称的数据库集合实例\n * @param name 数据表名称\n * @returns Db类实例,用于执行数据库操作\n */\n // biome-ignore lint/complexity/noBannedTypes: <explanation>\n table<T, S extends DbSelect<T> = {}, R extends AnyObject = {}>(name: string) {\n return new Proxy(\n {},\n {\n get(target, prop) {\n if (prop === '_isProxy') return true;\n\n const table = new Db<T, S, R>({ table: name });\n const tableProp = prop as keyof Db<T, S, R>;\n const ref = table[tableProp];\n\n return isFunction(ref) ? ref.bind(table) : ref;\n },\n },\n ) as DbProxy<T>;\n },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<T>) {\n const keys = Object.keys(res as AnyObject);\n // 客户端 { result: {errCode: 0, errMsg: 'ok'} & 数据 }\n const isClient = keys.length === 1 && keys[0] === 'result';\n\n if (isClient) {\n const { result } = res as UniClientDatabaseOutput<T>;\n if (!result.errCode) return objectOmit(result, ['errCode', 'errMsg', 'code', 'message']);\n throw errorAssign(new Error(result.errMsg), result);\n }\n\n // 云端 数据\n return res as T;\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","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbProxy, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\nexport type DbUpsertOptions<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n /** 查询条件 */\n where: DbWhere<T>;\n\n /** 查询返回字段 */\n select?: S;\n\n /** 创建数据 */\n create: C;\n\n /**\n * 更新数据,可以是对象或根据查询结果生成更新对象的函数\n * @param row 查询到的文档数据,仅在传入函数时可用\n */\n // biome-ignore lint/complexity/noBannedTypes: <explanation>\n update: U | ((exist: DbQuery<T, S, {}>) => 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: <explanation>\n onBeforeUpdate?: (exist: DbQuery<T, S, {}>) => false | unknown;\n\n /**\n * 更新后回调函数\n * @param updateData 实际更新的数据\n * @param exist 查询到的原始文档数据\n */\n // biome-ignore lint/complexity/noBannedTypes: <explanation>\n onAfterUpdate?: (updateData: U, exist: DbQuery<T, S, {}>) => unknown;\n\n /** 用于测试的模拟数据库实例 */\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\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<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>>(\n dbProxy: DbProxy<T>,\n options: DbUpsertOptions<T, S, C, U>,\n): Promise<DbUpsertOutput> {\n const {\n where,\n select = {},\n create,\n update,\n onBeforeCreate,\n onAfterCreate,\n onBeforeUpdate,\n onAfterUpdate,\n _mockDbInstance,\n } = options;\n\n // @ts-ignore\n if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n const _db = (_mockDbInstance || dbProxy) as DbProxy<T, S>;\n const exist = (await _db\n .where(where)\n .select(select || {})\n // biome-ignore lint/complexity/noBannedTypes: <explanation>\n .queryOne(true)) as DbQuery<T, S, {}> | undefined;\n\n if (exist) {\n const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n if (skipUpdate) {\n // @ts-ignore\n return { id: exist._id as string, updated: false, created: false };\n }\n\n const updateData = isFunction(update) ? update(exist) : update;\n // @ts-ignore\n const updated = await _db.whereId(exist._id).update(updateData);\n onAfterUpdate?.(updateData, exist);\n\n // @ts-ignore\n return { id: exist._id as string, updated: true, created: false };\n }\n\n await onBeforeCreate?.();\n const createdId = await _db.create(create);\n await onAfterCreate?.(createdId);\n\n return { id: createdId, updated: false, created: true };\n}\n\ntype _TransactionDb = {\n startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n commit: () => Promise<unknown>;\n rollback: () => Promise<unknown>;\n};\n\ntype _WithTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(table: DbProxy<T, S, R>) => Db<T, S, R>;\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\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: <explanation>\n _mockDatabase?: any,\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n _mockDbInstance?: any,\n) {\n const transactionDb = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n const [err1, transaction] = await tryFlatten(transactionDb.startTransaction());\n if (err1) throw err1;\n\n const withTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(dbProxy: DbProxy<T, S, R>) => {\n return _mockDbInstance || new Db<T, S, R>({ table: dbProxy.table, 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"],"names":["result"],"mappings":"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"}
|
package/dist/index.cjs
CHANGED
package/dist/index.mjs
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cloudcome/utils-uni",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.0",
|
|
4
4
|
"description": "cloudcome utils for uni-app",
|
|
5
5
|
"engines": {
|
|
6
6
|
"node": ">=22"
|
|
@@ -58,8 +58,8 @@
|
|
|
58
58
|
"dist"
|
|
59
59
|
],
|
|
60
60
|
"dependencies": {
|
|
61
|
-
"@cloudcome/utils-core": "~1.9.
|
|
62
|
-
"@cloudcome/utils-vue": "~1.9.
|
|
61
|
+
"@cloudcome/utils-core": "~1.9.2",
|
|
62
|
+
"@cloudcome/utils-vue": "~1.9.7",
|
|
63
63
|
"@dcloudio/types": "^3.4.21",
|
|
64
64
|
"@dcloudio/uni-app": "vue3",
|
|
65
65
|
"vue": "^3.5.13",
|