@open-agent-docs/db 0.0.0-stage → 0.3.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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Kada Liao
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,9 @@
1
- # Temporary Holding Version
1
+ # @open-agent-docs/db
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ [Open Agent Docs](https://github.com/kadaliao/open-agent-docs) 数据库的计算引擎(WASM):筛选、排序、分组、公式、汇总,和服务器同一份 Rust 代码。
4
+ 一般不用直接装:`@open-agent-docs/client` 的 `client.database(id)` 用它在本地算,`@open-agent-docs/editor` 的数据库视图也用它。
5
+
6
+ The Open Agent Docs database engine as WASM (filters, sorts, groups, formulas, totals), the same Rust code as the server.
7
+ You normally get it through `@open-agent-docs/client` (`client.database(id)`) rather than installing it directly.
8
+
9
+ 更多:[嵌入到自己的应用](https://github.com/kadaliao/open-agent-docs/blob/main/docs/zh/embedding.md) · [English](https://github.com/kadaliao/open-agent-docs/blob/main/docs/en/embedding.md)
@@ -0,0 +1,76 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+
4
+ export class RawEngine {
5
+ free(): void;
6
+ [Symbol.dispose](): void;
7
+ apply(changes: string): string;
8
+ checkFormula(src: string, key?: string | null): string;
9
+ computed(row: string): string;
10
+ displayRow(row: string): string;
11
+ display(key: string, value: string): string;
12
+ loadRelated(db: string, schema: string, rows: string): void;
13
+ loadRows(rows: string): void;
14
+ /**
15
+ * `schema`、`opts`(`{ id?, now?, tz?, people? }`)都是 JSON。
16
+ */
17
+ constructor(schema: string, opts: string);
18
+ normalize(key: string, input: string): string;
19
+ query(view: string): string;
20
+ schemaErrors(): string;
21
+ /**
22
+ * 固定时钟(毫秒时间戳、时区分钟数);之后不再跟着浏览器走。
23
+ */
24
+ setClock(now_ms: number, tz: number): void;
25
+ setPeople(people: string): void;
26
+ setSchema(schema: string): void;
27
+ }
28
+
29
+ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
30
+
31
+ export interface InitOutput {
32
+ readonly memory: WebAssembly.Memory;
33
+ readonly __wbg_rawengine_free: (a: number, b: number) => void;
34
+ readonly rawengine_apply: (a: number, b: number, c: number) => [number, number, number, number];
35
+ readonly rawengine_checkFormula: (a: number, b: number, c: number, d: number, e: number) => [number, number];
36
+ readonly rawengine_computed: (a: number, b: number, c: number) => [number, number];
37
+ readonly rawengine_display: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
38
+ readonly rawengine_displayRow: (a: number, b: number, c: number) => [number, number];
39
+ readonly rawengine_loadRelated: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
40
+ readonly rawengine_loadRows: (a: number, b: number, c: number) => [number, number];
41
+ readonly rawengine_new: (a: number, b: number, c: number, d: number) => [number, number, number];
42
+ readonly rawengine_normalize: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
43
+ readonly rawengine_query: (a: number, b: number, c: number) => [number, number, number, number];
44
+ readonly rawengine_schemaErrors: (a: number) => [number, number];
45
+ readonly rawengine_setClock: (a: number, b: number, c: number) => void;
46
+ readonly rawengine_setPeople: (a: number, b: number, c: number) => [number, number];
47
+ readonly rawengine_setSchema: (a: number, b: number, c: number) => [number, number];
48
+ readonly __wbindgen_externrefs: WebAssembly.Table;
49
+ readonly __wbindgen_malloc: (a: number, b: number) => number;
50
+ readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
51
+ readonly __wbindgen_free: (a: number, b: number, c: number) => void;
52
+ readonly __externref_table_dealloc: (a: number) => void;
53
+ readonly __wbindgen_start: () => void;
54
+ }
55
+
56
+ export type SyncInitInput = BufferSource | WebAssembly.Module;
57
+
58
+ /**
59
+ * Instantiates the given `module`, which can either be bytes or
60
+ * a precompiled `WebAssembly.Module`.
61
+ *
62
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
63
+ *
64
+ * @returns {InitOutput}
65
+ */
66
+ export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
67
+
68
+ /**
69
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
70
+ * for everything else, calls `WebAssembly.instantiate` directly.
71
+ *
72
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
73
+ *
74
+ * @returns {Promise<InitOutput>}
75
+ */
76
+ export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;
package/dist/oad_db.js ADDED
@@ -0,0 +1,535 @@
1
+ /* @ts-self-types="./oad_db.d.ts" */
2
+
3
+ export class RawEngine {
4
+ __destroy_into_raw() {
5
+ const ptr = this.__wbg_ptr;
6
+ this.__wbg_ptr = 0;
7
+ RawEngineFinalization.unregister(this);
8
+ return ptr;
9
+ }
10
+ free() {
11
+ const ptr = this.__destroy_into_raw();
12
+ wasm.__wbg_rawengine_free(ptr, 0);
13
+ }
14
+ /**
15
+ * @param {string} changes
16
+ * @returns {string}
17
+ */
18
+ apply(changes) {
19
+ let deferred3_0;
20
+ let deferred3_1;
21
+ try {
22
+ const ptr0 = passStringToWasm0(changes, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
23
+ const len0 = WASM_VECTOR_LEN;
24
+ const ret = wasm.rawengine_apply(this.__wbg_ptr, ptr0, len0);
25
+ var ptr2 = ret[0];
26
+ var len2 = ret[1];
27
+ if (ret[3]) {
28
+ ptr2 = 0; len2 = 0;
29
+ throw takeFromExternrefTable0(ret[2]);
30
+ }
31
+ deferred3_0 = ptr2;
32
+ deferred3_1 = len2;
33
+ return getStringFromWasm0(ptr2, len2);
34
+ } finally {
35
+ wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
36
+ }
37
+ }
38
+ /**
39
+ * @param {string} src
40
+ * @param {string | null} [key]
41
+ * @returns {string}
42
+ */
43
+ checkFormula(src, key) {
44
+ let deferred3_0;
45
+ let deferred3_1;
46
+ try {
47
+ let ptr0, len0, ptr1, len1;
48
+ try {
49
+ ptr0 = passStringToWasm0(src, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
50
+ len0 = WASM_VECTOR_LEN;
51
+ ptr1 = isLikeNone(key) ? 0 : passStringToWasm0(key, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
52
+ len1 = WASM_VECTOR_LEN;
53
+ } catch (e) {
54
+ if (ptr1) { wasm.__wbindgen_free(ptr1, len1 * 1, 1); }
55
+ if (ptr0) { wasm.__wbindgen_free(ptr0, len0 * 1, 1); }
56
+ throw e;
57
+ }
58
+ const ret = wasm.rawengine_checkFormula(this.__wbg_ptr, ptr0, len0, ptr1, len1);
59
+ deferred3_0 = ret[0];
60
+ deferred3_1 = ret[1];
61
+ return getStringFromWasm0(ret[0], ret[1]);
62
+ } finally {
63
+ wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
64
+ }
65
+ }
66
+ /**
67
+ * @param {string} row
68
+ * @returns {string}
69
+ */
70
+ computed(row) {
71
+ let deferred2_0;
72
+ let deferred2_1;
73
+ try {
74
+ const ptr0 = passStringToWasm0(row, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
75
+ const len0 = WASM_VECTOR_LEN;
76
+ const ret = wasm.rawengine_computed(this.__wbg_ptr, ptr0, len0);
77
+ deferred2_0 = ret[0];
78
+ deferred2_1 = ret[1];
79
+ return getStringFromWasm0(ret[0], ret[1]);
80
+ } finally {
81
+ wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
82
+ }
83
+ }
84
+ /**
85
+ * @param {string} row
86
+ * @returns {string}
87
+ */
88
+ displayRow(row) {
89
+ let deferred2_0;
90
+ let deferred2_1;
91
+ try {
92
+ const ptr0 = passStringToWasm0(row, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
93
+ const len0 = WASM_VECTOR_LEN;
94
+ const ret = wasm.rawengine_displayRow(this.__wbg_ptr, ptr0, len0);
95
+ deferred2_0 = ret[0];
96
+ deferred2_1 = ret[1];
97
+ return getStringFromWasm0(ret[0], ret[1]);
98
+ } finally {
99
+ wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
100
+ }
101
+ }
102
+ /**
103
+ * @param {string} key
104
+ * @param {string} value
105
+ * @returns {string}
106
+ */
107
+ display(key, value) {
108
+ let deferred4_0;
109
+ let deferred4_1;
110
+ try {
111
+ let ptr0, len0, ptr1, len1;
112
+ try {
113
+ ptr0 = passStringToWasm0(key, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
114
+ len0 = WASM_VECTOR_LEN;
115
+ ptr1 = passStringToWasm0(value, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
116
+ len1 = WASM_VECTOR_LEN;
117
+ } catch (e) {
118
+ if (ptr1) { wasm.__wbindgen_free(ptr1, len1 * 1, 1); }
119
+ if (ptr0) { wasm.__wbindgen_free(ptr0, len0 * 1, 1); }
120
+ throw e;
121
+ }
122
+ const ret = wasm.rawengine_display(this.__wbg_ptr, ptr0, len0, ptr1, len1);
123
+ var ptr3 = ret[0];
124
+ var len3 = ret[1];
125
+ if (ret[3]) {
126
+ ptr3 = 0; len3 = 0;
127
+ throw takeFromExternrefTable0(ret[2]);
128
+ }
129
+ deferred4_0 = ptr3;
130
+ deferred4_1 = len3;
131
+ return getStringFromWasm0(ptr3, len3);
132
+ } finally {
133
+ wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
134
+ }
135
+ }
136
+ /**
137
+ * @param {string} db
138
+ * @param {string} schema
139
+ * @param {string} rows
140
+ */
141
+ loadRelated(db, schema, rows) {
142
+ let ptr0, len0, ptr1, len1, ptr2, len2;
143
+ try {
144
+ ptr0 = passStringToWasm0(db, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
145
+ len0 = WASM_VECTOR_LEN;
146
+ ptr1 = passStringToWasm0(schema, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
147
+ len1 = WASM_VECTOR_LEN;
148
+ ptr2 = passStringToWasm0(rows, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
149
+ len2 = WASM_VECTOR_LEN;
150
+ } catch (e) {
151
+ if (ptr2) { wasm.__wbindgen_free(ptr2, len2 * 1, 1); }
152
+ if (ptr1) { wasm.__wbindgen_free(ptr1, len1 * 1, 1); }
153
+ if (ptr0) { wasm.__wbindgen_free(ptr0, len0 * 1, 1); }
154
+ throw e;
155
+ }
156
+ const ret = wasm.rawengine_loadRelated(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2);
157
+ if (ret[1]) {
158
+ throw takeFromExternrefTable0(ret[0]);
159
+ }
160
+ }
161
+ /**
162
+ * @param {string} rows
163
+ */
164
+ loadRows(rows) {
165
+ const ptr0 = passStringToWasm0(rows, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
166
+ const len0 = WASM_VECTOR_LEN;
167
+ const ret = wasm.rawengine_loadRows(this.__wbg_ptr, ptr0, len0);
168
+ if (ret[1]) {
169
+ throw takeFromExternrefTable0(ret[0]);
170
+ }
171
+ }
172
+ /**
173
+ * `schema`、`opts`(`{ id?, now?, tz?, people? }`)都是 JSON。
174
+ * @param {string} schema
175
+ * @param {string} opts
176
+ */
177
+ constructor(schema, opts) {
178
+ let ptr0, len0, ptr1, len1;
179
+ try {
180
+ ptr0 = passStringToWasm0(schema, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
181
+ len0 = WASM_VECTOR_LEN;
182
+ ptr1 = passStringToWasm0(opts, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
183
+ len1 = WASM_VECTOR_LEN;
184
+ } catch (e) {
185
+ if (ptr1) { wasm.__wbindgen_free(ptr1, len1 * 1, 1); }
186
+ if (ptr0) { wasm.__wbindgen_free(ptr0, len0 * 1, 1); }
187
+ throw e;
188
+ }
189
+ const ret = wasm.rawengine_new(ptr0, len0, ptr1, len1);
190
+ if (ret[2]) {
191
+ throw takeFromExternrefTable0(ret[1]);
192
+ }
193
+ this.__wbg_ptr = ret[0];
194
+ RawEngineFinalization.register(this, this.__wbg_ptr, this);
195
+ return this;
196
+ }
197
+ /**
198
+ * @param {string} key
199
+ * @param {string} input
200
+ * @returns {string}
201
+ */
202
+ normalize(key, input) {
203
+ let deferred4_0;
204
+ let deferred4_1;
205
+ try {
206
+ let ptr0, len0, ptr1, len1;
207
+ try {
208
+ ptr0 = passStringToWasm0(key, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
209
+ len0 = WASM_VECTOR_LEN;
210
+ ptr1 = passStringToWasm0(input, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
211
+ len1 = WASM_VECTOR_LEN;
212
+ } catch (e) {
213
+ if (ptr1) { wasm.__wbindgen_free(ptr1, len1 * 1, 1); }
214
+ if (ptr0) { wasm.__wbindgen_free(ptr0, len0 * 1, 1); }
215
+ throw e;
216
+ }
217
+ const ret = wasm.rawengine_normalize(this.__wbg_ptr, ptr0, len0, ptr1, len1);
218
+ var ptr3 = ret[0];
219
+ var len3 = ret[1];
220
+ if (ret[3]) {
221
+ ptr3 = 0; len3 = 0;
222
+ throw takeFromExternrefTable0(ret[2]);
223
+ }
224
+ deferred4_0 = ptr3;
225
+ deferred4_1 = len3;
226
+ return getStringFromWasm0(ptr3, len3);
227
+ } finally {
228
+ wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
229
+ }
230
+ }
231
+ /**
232
+ * @param {string} view
233
+ * @returns {string}
234
+ */
235
+ query(view) {
236
+ let deferred3_0;
237
+ let deferred3_1;
238
+ try {
239
+ const ptr0 = passStringToWasm0(view, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
240
+ const len0 = WASM_VECTOR_LEN;
241
+ const ret = wasm.rawengine_query(this.__wbg_ptr, ptr0, len0);
242
+ var ptr2 = ret[0];
243
+ var len2 = ret[1];
244
+ if (ret[3]) {
245
+ ptr2 = 0; len2 = 0;
246
+ throw takeFromExternrefTable0(ret[2]);
247
+ }
248
+ deferred3_0 = ptr2;
249
+ deferred3_1 = len2;
250
+ return getStringFromWasm0(ptr2, len2);
251
+ } finally {
252
+ wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
253
+ }
254
+ }
255
+ /**
256
+ * @returns {string}
257
+ */
258
+ schemaErrors() {
259
+ let deferred1_0;
260
+ let deferred1_1;
261
+ try {
262
+ const ret = wasm.rawengine_schemaErrors(this.__wbg_ptr);
263
+ deferred1_0 = ret[0];
264
+ deferred1_1 = ret[1];
265
+ return getStringFromWasm0(ret[0], ret[1]);
266
+ } finally {
267
+ wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
268
+ }
269
+ }
270
+ /**
271
+ * 固定时钟(毫秒时间戳、时区分钟数);之后不再跟着浏览器走。
272
+ * @param {number} now_ms
273
+ * @param {number} tz
274
+ */
275
+ setClock(now_ms, tz) {
276
+ wasm.rawengine_setClock(this.__wbg_ptr, now_ms, tz);
277
+ }
278
+ /**
279
+ * @param {string} people
280
+ */
281
+ setPeople(people) {
282
+ const ptr0 = passStringToWasm0(people, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
283
+ const len0 = WASM_VECTOR_LEN;
284
+ const ret = wasm.rawengine_setPeople(this.__wbg_ptr, ptr0, len0);
285
+ if (ret[1]) {
286
+ throw takeFromExternrefTable0(ret[0]);
287
+ }
288
+ }
289
+ /**
290
+ * @param {string} schema
291
+ */
292
+ setSchema(schema) {
293
+ const ptr0 = passStringToWasm0(schema, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
294
+ const len0 = WASM_VECTOR_LEN;
295
+ const ret = wasm.rawengine_setSchema(this.__wbg_ptr, ptr0, len0);
296
+ if (ret[1]) {
297
+ throw takeFromExternrefTable0(ret[0]);
298
+ }
299
+ }
300
+ }
301
+ if (Symbol.dispose) RawEngine.prototype[Symbol.dispose] = RawEngine.prototype.free;
302
+ function __wbg_get_imports() {
303
+ const import0 = {
304
+ __proto__: null,
305
+ __wbg_Error_208446807d0d1e30: function(arg0, arg1) {
306
+ const ret = Error(getStringFromWasm0(arg0, arg1));
307
+ return ret;
308
+ },
309
+ __wbg___wbindgen_throw_4c88d8bf264fd984: function(arg0, arg1) {
310
+ throw new Error(getStringFromWasm0(arg0, arg1));
311
+ },
312
+ __wbg_getTimezoneOffset_87127d92c2c117e9: function(arg0) {
313
+ const ret = arg0.getTimezoneOffset();
314
+ return ret;
315
+ },
316
+ __wbg_new_0_36d738a0c8cfac43: function() {
317
+ const ret = new Date();
318
+ return ret;
319
+ },
320
+ __wbg_now_463ac581d2fc7ea3: function() {
321
+ const ret = Date.now();
322
+ return ret;
323
+ },
324
+ __wbindgen_init_externref_table: function() {
325
+ const table = wasm.__wbindgen_externrefs;
326
+ table.set(0, undefined);
327
+ table.set(1024, undefined);
328
+ table.set(1025, null);
329
+ table.set(1026, true);
330
+ table.set(1027, false);
331
+ },
332
+ };
333
+ return {
334
+ __proto__: null,
335
+ "./oad_db_bg.js": import0,
336
+ };
337
+ }
338
+
339
+ const RawEngineFinalization = (typeof FinalizationRegistry === 'undefined')
340
+ ? { register: () => {}, unregister: () => {} }
341
+ : new FinalizationRegistry(ptr => wasm.__wbg_rawengine_free(ptr, 1));
342
+
343
+ function getStringFromWasm0(ptr, len) {
344
+ ptr = ptr >>> 0;
345
+ return decodeText(getUint8ArrayMemory0().subarray(ptr, ptr + len));
346
+ }
347
+
348
+ let cachedUint8ArrayMemory0 = null;
349
+ function getUint8ArrayMemory0() {
350
+ if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
351
+ cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
352
+ }
353
+ return cachedUint8ArrayMemory0;
354
+ }
355
+
356
+ function isLikeNone(x) {
357
+ return x === undefined || x === null;
358
+ }
359
+
360
+ function passStringToWasm0(arg, malloc, realloc) {
361
+ if (realloc === undefined) {
362
+ const buf = cachedTextEncoder.encode(arg);
363
+ const ptr = malloc(buf.length, 1) >>> 0;
364
+ getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
365
+ WASM_VECTOR_LEN = buf.length;
366
+ return ptr;
367
+ }
368
+
369
+ let len = arg.length;
370
+ let ptr = malloc(len, 1) >>> 0;
371
+
372
+ const mem = getUint8ArrayMemory0();
373
+
374
+ let offset = 0;
375
+
376
+ for (; offset < len; offset++) {
377
+ const code = arg.charCodeAt(offset);
378
+ if (code > 0x7F) break;
379
+ mem[ptr + offset] = code;
380
+ }
381
+ if (offset !== len) {
382
+ if (offset !== 0) {
383
+ arg = arg.slice(offset);
384
+ }
385
+ ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
386
+ const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
387
+ const ret = cachedTextEncoder.encodeInto(arg, view);
388
+
389
+ offset += ret.written;
390
+ ptr = realloc(ptr, len, offset, 1) >>> 0;
391
+ }
392
+
393
+ WASM_VECTOR_LEN = offset;
394
+ return ptr;
395
+ }
396
+
397
+ function takeFromExternrefTable0(idx) {
398
+ const value = wasm.__wbindgen_externrefs.get(idx);
399
+ wasm.__externref_table_dealloc(idx);
400
+ return value;
401
+ }
402
+
403
+ let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true });
404
+ cachedTextDecoder.decode();
405
+ const MAX_SAFARI_DECODE_BYTES = 2146435072;
406
+ let numBytesDecoded = 0;
407
+ function decodeText(bytes) {
408
+ numBytesDecoded += bytes.length;
409
+ if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
410
+ cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true });
411
+ cachedTextDecoder.decode();
412
+ numBytesDecoded = bytes.length;
413
+ }
414
+ return cachedTextDecoder.decode(bytes);
415
+ }
416
+
417
+ const cachedTextEncoder = new TextEncoder();
418
+
419
+ if (!('encodeInto' in cachedTextEncoder)) {
420
+ cachedTextEncoder.encodeInto = function (arg, view) {
421
+ const buf = cachedTextEncoder.encode(arg);
422
+ view.set(buf);
423
+ return {
424
+ read: arg.length,
425
+ written: buf.length
426
+ };
427
+ };
428
+ }
429
+
430
+ let WASM_VECTOR_LEN = 0;
431
+
432
+ let wasmModule, wasmInstance, wasm;
433
+ function __wbg_finalize_init(instance, module) {
434
+ wasmInstance = instance;
435
+ wasm = instance.exports;
436
+ wasmModule = module;
437
+ cachedUint8ArrayMemory0 = null;
438
+ wasm.__wbindgen_start();
439
+ return wasm;
440
+ }
441
+
442
+ async function __wbg_load(module, imports) {
443
+ if (typeof Response === 'function' && module instanceof Response) {
444
+ if (!module.ok) {
445
+ throw new Error(`failed to fetch Wasm: ${module.status} ${module.statusText} fetching '${module.url}'`);
446
+ }
447
+
448
+ if (typeof WebAssembly.instantiateStreaming === 'function') {
449
+ try {
450
+ return await WebAssembly.instantiateStreaming(module, imports);
451
+ } catch (e) {
452
+ const validResponse = expectedResponseType(module.type);
453
+
454
+ if (validResponse && module.headers.get('Content-Type') !== 'application/wasm') {
455
+ console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);
456
+
457
+ } else { throw e; }
458
+ }
459
+ }
460
+
461
+ const bytes = await module.arrayBuffer();
462
+ return await WebAssembly.instantiate(bytes, imports);
463
+ } else {
464
+ const instance = await WebAssembly.instantiate(module, imports);
465
+
466
+ if (instance instanceof WebAssembly.Instance) {
467
+ return { instance, module };
468
+ } else {
469
+ return instance;
470
+ }
471
+ }
472
+
473
+ function expectedResponseType(type) {
474
+ switch (type) {
475
+ case 'basic': case 'cors': case 'default': return true;
476
+ }
477
+ return false;
478
+ }
479
+ }
480
+
481
+ function initSync(module) {
482
+ if (wasm !== undefined) return wasm;
483
+
484
+
485
+ if (module !== undefined) {
486
+ if (Object.getPrototypeOf(module) === Object.prototype) {
487
+ ({module} = module)
488
+ } else {
489
+ console.warn('using deprecated parameters for `initSync()`; pass a single object instead')
490
+ }
491
+ }
492
+
493
+ const imports = __wbg_get_imports();
494
+ if (!(module instanceof WebAssembly.Module)) {
495
+ module = new WebAssembly.Module(module);
496
+ }
497
+ const instance = new WebAssembly.Instance(module, imports);
498
+ return __wbg_finalize_init(instance, module);
499
+ }
500
+
501
+ let __wbg_init_promise;
502
+ async function __wbg_init(module_or_path) {
503
+ if (wasm !== undefined) return wasm;
504
+ if (__wbg_init_promise === undefined) {
505
+ __wbg_init_promise = __wbg_init_once(module_or_path);
506
+ __wbg_init_promise.catch(() => { __wbg_init_promise = undefined; });
507
+ }
508
+ return __wbg_init_promise;
509
+ }
510
+
511
+ async function __wbg_init_once(module_or_path) {
512
+
513
+ if (module_or_path !== undefined) {
514
+ if (Object.getPrototypeOf(module_or_path) === Object.prototype) {
515
+ ({module_or_path} = module_or_path)
516
+ } else {
517
+ console.warn('using deprecated parameters for the initialization function; pass a single object instead')
518
+ }
519
+ }
520
+
521
+ if (module_or_path === undefined) {
522
+ module_or_path = new URL('oad_db_bg.wasm', import.meta.url);
523
+ }
524
+ const imports = __wbg_get_imports();
525
+
526
+ if (typeof module_or_path === 'string' || (typeof Request === 'function' && module_or_path instanceof Request) || (typeof URL === 'function' && module_or_path instanceof URL)) {
527
+ module_or_path = fetch(module_or_path);
528
+ }
529
+
530
+ const { instance, module } = await __wbg_load(await module_or_path, imports);
531
+
532
+ return __wbg_finalize_init(instance, module);
533
+ }
534
+
535
+ export { initSync, __wbg_init as default };
Binary file
@@ -0,0 +1,24 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ export const memory: WebAssembly.Memory;
4
+ export const __wbg_rawengine_free: (a: number, b: number) => void;
5
+ export const rawengine_apply: (a: number, b: number, c: number) => [number, number, number, number];
6
+ export const rawengine_checkFormula: (a: number, b: number, c: number, d: number, e: number) => [number, number];
7
+ export const rawengine_computed: (a: number, b: number, c: number) => [number, number];
8
+ export const rawengine_display: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
9
+ export const rawengine_displayRow: (a: number, b: number, c: number) => [number, number];
10
+ export const rawengine_loadRelated: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
11
+ export const rawengine_loadRows: (a: number, b: number, c: number) => [number, number];
12
+ export const rawengine_new: (a: number, b: number, c: number, d: number) => [number, number, number];
13
+ export const rawengine_normalize: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
14
+ export const rawengine_query: (a: number, b: number, c: number) => [number, number, number, number];
15
+ export const rawengine_schemaErrors: (a: number) => [number, number];
16
+ export const rawengine_setClock: (a: number, b: number, c: number) => void;
17
+ export const rawengine_setPeople: (a: number, b: number, c: number) => [number, number];
18
+ export const rawengine_setSchema: (a: number, b: number, c: number) => [number, number];
19
+ export const __wbindgen_externrefs: WebAssembly.Table;
20
+ export const __wbindgen_malloc: (a: number, b: number) => number;
21
+ export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
22
+ export const __wbindgen_free: (a: number, b: number, c: number) => void;
23
+ export const __externref_table_dealloc: (a: number) => void;
24
+ export const __wbindgen_start: () => void;
package/index.d.ts ADDED
@@ -0,0 +1,172 @@
1
+ // @open-agent-docs/db 的类型。数据结构见 docs/phase4-contract.md「模型」,引擎的取舍见「引擎实现说明」。
2
+ import type { InitInput, InitOutput, SyncInitInput } from './dist/oad_db'
3
+
4
+ export type PropType =
5
+ | 'title' | 'text' | 'number' | 'select' | 'multi_select' | 'status' | 'date' | 'person' | 'checkbox' | 'url' | 'email'
6
+ | 'phone' | 'files' | 'created_time' | 'updated_time' | 'created_by' | 'updated_by' | 'relation' | 'rollup' | 'formula'
7
+ | 'unique_id' | 'button'
8
+
9
+ export interface SelectOption {
10
+ id: string
11
+ name: string
12
+ color?: string
13
+ /** status:todo | doing | done */
14
+ group?: 'todo' | 'doing' | 'done'
15
+ }
16
+
17
+ export interface Prop {
18
+ key: string
19
+ name: string
20
+ type: PropType
21
+ options?: SelectOption[]
22
+ /** 数字:number | comma | percent(乘 100)| cny | usd */
23
+ format?: string
24
+ /** 数字显示几位小数 */
25
+ precision?: number
26
+ /** 日期显示:iso(默认)| zh | slash | relative */
27
+ date_format?: string
28
+ formula?: string
29
+ /** mirror_of 有值:双向关联在这边的反向那一半 */
30
+ relation?: { db_id: string; mirror_of?: string; [k: string]: unknown }
31
+ /** 沿 relation(这个库的关联属性 key)取对方库的 prop,按 fn 归总 */
32
+ rollup?: { relation: string; prop: string; fn: RollupFn | string }
33
+ prefix?: string
34
+ [k: string]: unknown
35
+ }
36
+
37
+ export interface Schema {
38
+ props: Prop[]
39
+ next_id?: number
40
+ [k: string]: unknown
41
+ }
42
+
43
+ export interface Row {
44
+ id: string
45
+ seq?: number
46
+ props: Record<string, unknown>
47
+ /** 毫秒时间戳 */
48
+ created_at?: number
49
+ created_by?: string
50
+ updated_at?: number
51
+ updated_by?: string
52
+ unique_id?: number
53
+ }
54
+
55
+ /** row:整行换掉(同步来的);props:只改给了的格子(null / "" / [] 是清空);deleted:删行。没有这一行时是加。 */
56
+ export interface Change {
57
+ row_id: string
58
+ props?: Record<string, unknown>
59
+ row?: Row
60
+ deleted?: boolean
61
+ }
62
+
63
+ export type RollupFn =
64
+ | 'show_original' | 'show_unique' | 'count' | 'count_values' | 'count_unique' | 'count_empty' | 'count_not_empty'
65
+ | 'percent_empty' | 'percent_not_empty' | 'sum' | 'average' | 'median' | 'min' | 'max' | 'range' | 'earliest' | 'latest'
66
+ | 'date_range' | 'checked' | 'unchecked' | 'percent_checked' | 'percent_unchecked'
67
+
68
+ export type Cond =
69
+ | 'eq' | 'neq' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with' | 'gt' | 'gte' | 'lt' | 'lte'
70
+ | 'empty' | 'not_empty' | 'is_within' | 'checked' | 'unchecked' | 'in_group'
71
+
72
+ export interface Condition {
73
+ /** 属性 key(也认名字) */
74
+ prop: string
75
+ cond: Cond | string
76
+ value?: unknown
77
+ }
78
+
79
+ export interface Filter {
80
+ op: 'and' | 'or'
81
+ items: (Condition | Filter)[]
82
+ }
83
+
84
+ export interface Sort {
85
+ prop: string
86
+ dir?: 'asc' | 'desc'
87
+ }
88
+
89
+ export interface View {
90
+ filter?: Filter | Condition[] | null
91
+ sorts?: Sort[]
92
+ group_by?: string | null
93
+ sub_group_by?: string | null
94
+ /** 按日期分组:day | week | month(默认)| year | relative */
95
+ group_date?: string
96
+ sub_group_date?: string
97
+ hide_empty_groups?: boolean
98
+ /** 每列底部的汇总:{ key: fn },fn 同 RollupFn,也认 avg、unique、empty、not_empty */
99
+ totals?: Record<string, string>
100
+ /** 本人临时的搜索 */
101
+ search?: string
102
+ limit?: number
103
+ offset?: number
104
+ [k: string]: unknown
105
+ }
106
+
107
+ export interface Group {
108
+ /** 选项 id、人的 id、日期分段(2026-11)……;空值的分组是 "" */
109
+ key: string
110
+ name: string
111
+ color?: string
112
+ ids: string[]
113
+ count: number
114
+ groups?: Group[]
115
+ totals?: Record<string, unknown>
116
+ }
117
+
118
+ export interface QueryResult {
119
+ ids: string[]
120
+ /** 符合条件的总行数(给了 limit / offset 时 ids 只是一段) */
121
+ total: number
122
+ groups?: Group[]
123
+ /** 占比(percent_*)是 0–1 */
124
+ totals?: Record<string, unknown>
125
+ }
126
+
127
+ export interface Person {
128
+ id: string
129
+ name: string
130
+ }
131
+
132
+ export interface EngineOptions {
133
+ /** 主库自己的 id(关联指向自己时用) */
134
+ id?: string
135
+ /** 固定“现在”(毫秒时间戳,测试用);不给就每次调用前取浏览器的时间 */
136
+ now?: number
137
+ /** 当地时间比 UTC 快几分钟(北京时间 480);不给用浏览器的 */
138
+ tz?: number
139
+ people?: Person[]
140
+ }
141
+
142
+ export declare class DbEngine {
143
+ static create(schema: Schema | string, opts?: EngineOptions): Promise<DbEngine>
144
+ /** 已经 init / initSync 过时同步建 */
145
+ static createSync(schema: Schema | string, opts?: EngineOptions): DbEngine
146
+ loadRows(rows: Row[] | string): void
147
+ loadRelated(dbId: string, schema: Schema | string, rows: Row[] | string): void
148
+ /** 返回受影响的行 id(改了的,和通过关联连着、算出来的值可能变了的) */
149
+ apply(changes: Change[] | string): string[]
150
+ setSchema(schema: Schema | string): void
151
+ setPeople(people: Person[]): void
152
+ /** 固定时钟(之后不再跟着浏览器走) */
153
+ setClock(nowMs: number, tzOffsetMinutes: number): void
154
+ /** 出错(属性、选项不存在,条件不对)会抛 Error,信息是中文 */
155
+ query(view: View | string): QueryResult
156
+ /** 公式、汇总、反向关联(对方行 id)、创建 / 编辑时间({ start, time })、创建 / 编辑人、自动编号 */
157
+ computed(rowId: string): Record<string, unknown>
158
+ display(key: string, value: unknown): string
159
+ /** 一行每格给人看的文字(空的不列) */
160
+ displayRow(rowId: string): Record<string, string>
161
+ /** at 是出错处在 src 里的下标(UTF-16);给了 key 还查用没用到自己、成没成环 */
162
+ checkFormula(src: string, key?: string): { ok: true } | { error: string; at: number }
163
+ /** 用户输入 / 粘贴的文字(或存的样子)→ 存的样子;空是 null;认不出抛 Error(中文,说清楚该怎么写) */
164
+ normalize(key: string, input: unknown): unknown
165
+ /** 表结构里有问题的属性(公式写错、成环、汇总的关联不在了) */
166
+ schemaErrors(): { key: string; error: string; at?: number }[]
167
+ free(): void
168
+ }
169
+
170
+ export declare function init(input?: InitInput | Promise<InitInput> | { module_or_path: InitInput | Promise<InitInput> }): Promise<InitOutput>
171
+ export declare function initSync(module: SyncInitInput | { module: SyncInitInput }): InitOutput
172
+ export default init
package/index.js ADDED
@@ -0,0 +1,87 @@
1
+ // @open-agent-docs/db:数据库计算引擎(crates/oad-db 编的 WASM,和服务器同一份 Rust 代码)。接口见 docs/phase4-contract.md「计算引擎」。
2
+ // 进出 WASM 都是 JSON 字符串(一次解析最快);这里包成对象。行、表结构、改动、视图也可以直接给 JSON 字符串(比如 fetch 来的原文),省一次转换。
3
+ import init, { initSync, RawEngine } from './dist/oad_db.js'
4
+
5
+ export { init, initSync }
6
+ export default init
7
+
8
+ const text = (x) => (typeof x === 'string' ? x : JSON.stringify(x ?? null))
9
+ const value = (x) => JSON.stringify(x === undefined ? null : x)
10
+
11
+ let ready = null
12
+ // 已经 initSync 过的话 init 直接返回
13
+ const ensure = () => (ready ??= init())
14
+
15
+ export class DbEngine {
16
+ /** @param {RawEngine} raw */
17
+ constructor(raw) {
18
+ this.raw = raw
19
+ }
20
+
21
+ /** 建引擎:先加载 WASM(只加载一次)。opts:{ id?, now?, tz?, people? } */
22
+ static async create(schema, opts) {
23
+ await ensure()
24
+ return DbEngine.createSync(schema, opts)
25
+ }
26
+
27
+ /** 已经 init / initSync 过时同步建 */
28
+ static createSync(schema, opts) {
29
+ return new DbEngine(new RawEngine(text(schema), text(opts ?? {})))
30
+ }
31
+
32
+ loadRows(rows) {
33
+ this.raw.loadRows(text(rows))
34
+ }
35
+
36
+ loadRelated(dbId, schema, rows) {
37
+ this.raw.loadRelated(dbId, text(schema), text(rows))
38
+ }
39
+
40
+ apply(changes) {
41
+ return JSON.parse(this.raw.apply(text(changes)))
42
+ }
43
+
44
+ setSchema(schema) {
45
+ this.raw.setSchema(text(schema))
46
+ }
47
+
48
+ setPeople(people) {
49
+ this.raw.setPeople(text(people))
50
+ }
51
+
52
+ setClock(nowMs, tzOffsetMinutes) {
53
+ this.raw.setClock(nowMs, tzOffsetMinutes)
54
+ }
55
+
56
+ query(view) {
57
+ return JSON.parse(this.raw.query(text(view ?? {})))
58
+ }
59
+
60
+ computed(rowId) {
61
+ return JSON.parse(this.raw.computed(rowId))
62
+ }
63
+
64
+ display(key, v) {
65
+ return this.raw.display(key, value(v))
66
+ }
67
+
68
+ displayRow(rowId) {
69
+ return JSON.parse(this.raw.displayRow(rowId))
70
+ }
71
+
72
+ checkFormula(src, key) {
73
+ return JSON.parse(this.raw.checkFormula(src, key ?? undefined))
74
+ }
75
+
76
+ normalize(key, input) {
77
+ return JSON.parse(this.raw.normalize(key, value(input)))
78
+ }
79
+
80
+ schemaErrors() {
81
+ return JSON.parse(this.raw.schemaErrors())
82
+ }
83
+
84
+ free() {
85
+ this.raw.free()
86
+ }
87
+ }
package/package.json CHANGED
@@ -1,6 +1,32 @@
1
1
  {
2
2
  "name": "@open-agent-docs/db",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.3.0",
4
+ "description": "oad-db 的 WASM 版:数据库的筛选、排序、分组、公式、汇总,和服务器同一份代码",
5
+ "type": "module",
6
+ "main": "index.js",
7
+ "module": "index.js",
8
+ "types": "index.d.ts",
9
+ "files": [
10
+ "index.js",
11
+ "index.d.ts",
12
+ "dist",
13
+ "README.md"
14
+ ],
15
+ "sideEffects": false,
16
+ "license": "MIT",
17
+ "repository": {
18
+ "type": "git",
19
+ "url": "git+https://github.com/kadaliao/open-agent-docs.git",
20
+ "directory": "packages/db-wasm"
21
+ },
22
+ "homepage": "https://github.com/kadaliao/open-agent-docs#readme",
23
+ "bugs": "https://github.com/kadaliao/open-agent-docs/issues",
24
+ "publishConfig": {
25
+ "access": "public"
26
+ },
27
+ "scripts": {
28
+ "build": "sh build.sh",
29
+ "test": "node --test 'test/*.test.mjs'",
30
+ "bench": "node test/bench.mjs"
31
+ }
6
32
  }