@yydb/light-db 0.0.18 → 0.1.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/api/index.d.ts +4 -9
- package/dist/api/index.d.ts.map +1 -1
- package/dist/api/index.js +3 -6
- package/dist/api/index.js.map +1 -1
- package/dist/api/types.d.ts +71 -42
- package/dist/api/types.d.ts.map +1 -1
- package/dist/api/types.js +5 -3
- package/dist/api/types.js.map +1 -1
- package/dist/api/wasm-database.d.ts +134 -27
- package/dist/api/wasm-database.d.ts.map +1 -1
- package/dist/api/wasm-database.js +172 -28
- package/dist/api/wasm-database.js.map +1 -1
- package/dist/index.d.ts +14 -11
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +14 -11
- package/dist/index.js.map +1 -1
- package/dist/shared/micro.d.ts +86 -0
- package/dist/shared/micro.d.ts.map +1 -0
- package/dist/shared/micro.js +194 -0
- package/dist/shared/micro.js.map +1 -0
- package/dist/shared/udf-types.d.ts +31 -0
- package/dist/shared/udf-types.d.ts.map +1 -0
- package/dist/shared/udf-types.js +12 -0
- package/dist/shared/udf-types.js.map +1 -0
- package/package.json +5 -7
- package/readme.md +60 -63
- package/dist/api/database.d.ts +0 -101
- package/dist/api/database.d.ts.map +0 -1
- package/dist/api/database.js +0 -149
- package/dist/api/database.js.map +0 -1
- package/dist/api/schema.d.ts +0 -33
- package/dist/api/schema.d.ts.map +0 -1
- package/dist/api/schema.js +0 -80
- package/dist/api/schema.js.map +0 -1
- package/dist/api/transaction.d.ts +0 -26
- package/dist/api/transaction.d.ts.map +0 -1
- package/dist/api/transaction.js +0 -52
- package/dist/api/transaction.js.map +0 -1
- package/dist/codec/binary.d.ts +0 -196
- package/dist/codec/binary.d.ts.map +0 -1
- package/dist/codec/binary.js +0 -342
- package/dist/codec/binary.js.map +0 -1
- package/dist/codec/checksum.d.ts +0 -21
- package/dist/codec/checksum.d.ts.map +0 -1
- package/dist/codec/checksum.js +0 -46
- package/dist/codec/checksum.js.map +0 -1
- package/dist/codec/index.d.ts +0 -12
- package/dist/codec/index.d.ts.map +0 -1
- package/dist/codec/index.js +0 -10
- package/dist/codec/index.js.map +0 -1
- package/dist/codec/page.d.ts +0 -114
- package/dist/codec/page.d.ts.map +0 -1
- package/dist/codec/page.js +0 -225
- package/dist/codec/page.js.map +0 -1
- package/dist/codec/record.d.ts +0 -62
- package/dist/codec/record.d.ts.map +0 -1
- package/dist/codec/record.js +0 -82
- package/dist/codec/record.js.map +0 -1
- package/dist/core/broadcast.d.ts +0 -39
- package/dist/core/broadcast.d.ts.map +0 -1
- package/dist/core/broadcast.js +0 -54
- package/dist/core/broadcast.js.map +0 -1
- package/dist/core/checkpoint.d.ts +0 -23
- package/dist/core/checkpoint.d.ts.map +0 -1
- package/dist/core/checkpoint.js +0 -49
- package/dist/core/checkpoint.js.map +0 -1
- package/dist/core/engine.d.ts +0 -142
- package/dist/core/engine.d.ts.map +0 -1
- package/dist/core/engine.js +0 -304
- package/dist/core/engine.js.map +0 -1
- package/dist/core/index.d.ts +0 -17
- package/dist/core/index.d.ts.map +0 -1
- package/dist/core/index.js +0 -13
- package/dist/core/index.js.map +0 -1
- package/dist/core/lease.d.ts +0 -32
- package/dist/core/lease.d.ts.map +0 -1
- package/dist/core/lease.js +0 -81
- package/dist/core/lease.js.map +0 -1
- package/dist/core/records.d.ts +0 -49
- package/dist/core/records.d.ts.map +0 -1
- package/dist/core/records.js +0 -70
- package/dist/core/records.js.map +0 -1
- package/dist/core/recovery.d.ts +0 -43
- package/dist/core/recovery.d.ts.map +0 -1
- package/dist/core/recovery.js +0 -99
- package/dist/core/recovery.js.map +0 -1
- package/dist/core/wal.d.ts +0 -50
- package/dist/core/wal.d.ts.map +0 -1
- package/dist/core/wal.js +0 -114
- package/dist/core/wal.js.map +0 -1
- package/dist/storage/StorageAdapter.d.ts +0 -97
- package/dist/storage/StorageAdapter.d.ts.map +0 -1
- package/dist/storage/StorageAdapter.js +0 -9
- package/dist/storage/StorageAdapter.js.map +0 -1
- package/dist/storage/index.d.ts +0 -11
- package/dist/storage/index.d.ts.map +0 -1
- package/dist/storage/index.js +0 -10
- package/dist/storage/index.js.map +0 -1
- package/dist/storage/indexeddb/IndexedDbStorageAdapter.d.ts +0 -140
- package/dist/storage/indexeddb/IndexedDbStorageAdapter.d.ts.map +0 -1
- package/dist/storage/indexeddb/IndexedDbStorageAdapter.js +0 -403
- package/dist/storage/indexeddb/IndexedDbStorageAdapter.js.map +0 -1
- package/dist/storage/memory/MemoryStorageAdapter.d.ts +0 -76
- package/dist/storage/memory/MemoryStorageAdapter.d.ts.map +0 -1
- package/dist/storage/memory/MemoryStorageAdapter.js +0 -212
- package/dist/storage/memory/MemoryStorageAdapter.js.map +0 -1
- package/dist/storage/opfs/OpfsStorageAdapter.d.ts +0 -141
- package/dist/storage/opfs/OpfsStorageAdapter.d.ts.map +0 -1
- package/dist/storage/opfs/OpfsStorageAdapter.js +0 -400
- package/dist/storage/opfs/OpfsStorageAdapter.js.map +0 -1
|
@@ -1,212 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 内存存储适配器
|
|
3
|
-
*
|
|
4
|
-
* 用于测试、无持久化需求的一次性会话,以及适配器合同的参考实现。
|
|
5
|
-
*/
|
|
6
|
-
import { LightDbError, LightDbErrorCodes } from '../../errors';
|
|
7
|
-
import { STORAGE_FILES } from '../StorageAdapter';
|
|
8
|
-
/**
|
|
9
|
-
* 内存存储后端
|
|
10
|
-
*
|
|
11
|
-
* 只有共用同一个后端实例才能跨 `openDatabase` 读到上一会话的数据,
|
|
12
|
-
* 测试据此模拟「关闭后重开」。
|
|
13
|
-
*/
|
|
14
|
-
export class MemoryStorageBackend {
|
|
15
|
-
/** 适配器类型 */
|
|
16
|
-
kind = 'memory';
|
|
17
|
-
/** 会话结束后数据不保留 */
|
|
18
|
-
persistent = false;
|
|
19
|
-
directories = new Map();
|
|
20
|
-
/**
|
|
21
|
-
* 打开数据库适配器
|
|
22
|
-
* @param name 数据库名
|
|
23
|
-
*/
|
|
24
|
-
async openDatabase(name) {
|
|
25
|
-
let directory = this.directories.get(name);
|
|
26
|
-
if (!directory) {
|
|
27
|
-
directory = new Map();
|
|
28
|
-
this.directories.set(name, directory);
|
|
29
|
-
}
|
|
30
|
-
return new MemoryStorageAdapter(name, directory);
|
|
31
|
-
}
|
|
32
|
-
/** 清空所有数据库 */
|
|
33
|
-
reset() {
|
|
34
|
-
this.directories.clear();
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
/**
|
|
38
|
-
* 内存存储适配器
|
|
39
|
-
*/
|
|
40
|
-
export class MemoryStorageAdapter {
|
|
41
|
-
/** 适配器类型 */
|
|
42
|
-
kind = 'memory';
|
|
43
|
-
/** 会话结束后数据不保留 */
|
|
44
|
-
persistent = false;
|
|
45
|
-
name;
|
|
46
|
-
directory;
|
|
47
|
-
closed = false;
|
|
48
|
-
constructor(name, directory) {
|
|
49
|
-
this.name = name;
|
|
50
|
-
this.directory = directory;
|
|
51
|
-
}
|
|
52
|
-
/**
|
|
53
|
-
* 打开逻辑文件
|
|
54
|
-
* @param file 逻辑文件名
|
|
55
|
-
* @param mode 打开模式
|
|
56
|
-
*/
|
|
57
|
-
async open(file, mode = 'readwrite') {
|
|
58
|
-
this.assertOpen('open');
|
|
59
|
-
const existing = this.directory.get(file);
|
|
60
|
-
if (!existing && mode === 'read') {
|
|
61
|
-
throw new LightDbError(LightDbErrorCodes.io, `storage file "${file}" does not exist in "${this.name}"`, {
|
|
62
|
-
operation: 'storageOpen',
|
|
63
|
-
});
|
|
64
|
-
}
|
|
65
|
-
if (!existing) {
|
|
66
|
-
this.directory.set(file, new Uint8Array(0));
|
|
67
|
-
}
|
|
68
|
-
return new MemoryStorageHandle(this.directory, file);
|
|
69
|
-
}
|
|
70
|
-
/**
|
|
71
|
-
* 判断文件是否存在
|
|
72
|
-
* @param file 逻辑文件名
|
|
73
|
-
*/
|
|
74
|
-
async exists(file) {
|
|
75
|
-
this.assertOpen('exists');
|
|
76
|
-
return this.directory.has(file);
|
|
77
|
-
}
|
|
78
|
-
/**
|
|
79
|
-
* 删除文件
|
|
80
|
-
* @param file 逻辑文件名
|
|
81
|
-
*/
|
|
82
|
-
async delete(file) {
|
|
83
|
-
this.assertOpen('delete');
|
|
84
|
-
this.directory.delete(file);
|
|
85
|
-
}
|
|
86
|
-
/**
|
|
87
|
-
* 原子重命名
|
|
88
|
-
* @param from 源文件
|
|
89
|
-
* @param to 目标文件
|
|
90
|
-
*/
|
|
91
|
-
async rename(from, to) {
|
|
92
|
-
this.assertOpen('rename');
|
|
93
|
-
const data = this.directory.get(from);
|
|
94
|
-
if (!data) {
|
|
95
|
-
throw new LightDbError(LightDbErrorCodes.io, `cannot rename missing storage file "${from}"`, {
|
|
96
|
-
operation: 'storageRename',
|
|
97
|
-
});
|
|
98
|
-
}
|
|
99
|
-
this.directory.set(to, data);
|
|
100
|
-
this.directory.delete(from);
|
|
101
|
-
}
|
|
102
|
-
/**
|
|
103
|
-
* 列出已存在的文件
|
|
104
|
-
*/
|
|
105
|
-
async list() {
|
|
106
|
-
this.assertOpen('list');
|
|
107
|
-
return STORAGE_FILES.filter((file) => this.directory.has(file));
|
|
108
|
-
}
|
|
109
|
-
/** 关闭适配器 */
|
|
110
|
-
async close() {
|
|
111
|
-
this.closed = true;
|
|
112
|
-
}
|
|
113
|
-
/**
|
|
114
|
-
* 断言适配器未关闭
|
|
115
|
-
* @param operation 操作名
|
|
116
|
-
*/
|
|
117
|
-
assertOpen(operation) {
|
|
118
|
-
if (this.closed) {
|
|
119
|
-
throw new LightDbError(LightDbErrorCodes.sessionClosed, 'storage adapter is closed', { operation });
|
|
120
|
-
}
|
|
121
|
-
}
|
|
122
|
-
}
|
|
123
|
-
/**
|
|
124
|
-
* 内存文件句柄
|
|
125
|
-
*/
|
|
126
|
-
class MemoryStorageHandle {
|
|
127
|
-
directory;
|
|
128
|
-
file;
|
|
129
|
-
closed = false;
|
|
130
|
-
constructor(directory, file) {
|
|
131
|
-
this.directory = directory;
|
|
132
|
-
this.file = file;
|
|
133
|
-
}
|
|
134
|
-
/**
|
|
135
|
-
* 读取指定区间
|
|
136
|
-
* @param position 起始位置
|
|
137
|
-
* @param length 期望长度
|
|
138
|
-
*/
|
|
139
|
-
async read(position, length) {
|
|
140
|
-
this.assertOpen('read');
|
|
141
|
-
const data = this.readData();
|
|
142
|
-
if (position >= data.length) {
|
|
143
|
-
return new Uint8Array(0);
|
|
144
|
-
}
|
|
145
|
-
return data.slice(position, Math.min(position + length, data.length));
|
|
146
|
-
}
|
|
147
|
-
/**
|
|
148
|
-
* 写入指定位置
|
|
149
|
-
* @param position 起始位置
|
|
150
|
-
* @param data 数据
|
|
151
|
-
*/
|
|
152
|
-
async write(position, data) {
|
|
153
|
-
this.assertOpen('write');
|
|
154
|
-
const current = this.readData();
|
|
155
|
-
const required = position + data.length;
|
|
156
|
-
const next = current.length >= required ? current : grow(current, required);
|
|
157
|
-
next.set(data, position);
|
|
158
|
-
this.directory.set(this.file, next);
|
|
159
|
-
}
|
|
160
|
-
/**
|
|
161
|
-
* 截断文件
|
|
162
|
-
* @param size 目标大小
|
|
163
|
-
*/
|
|
164
|
-
async truncate(size) {
|
|
165
|
-
this.assertOpen('truncate');
|
|
166
|
-
const current = this.readData();
|
|
167
|
-
if (size <= current.length) {
|
|
168
|
-
this.directory.set(this.file, current.slice(0, size));
|
|
169
|
-
return;
|
|
170
|
-
}
|
|
171
|
-
this.directory.set(this.file, grow(current, size));
|
|
172
|
-
}
|
|
173
|
-
/** 内存写入无需落盘 */
|
|
174
|
-
async sync() {
|
|
175
|
-
this.assertOpen('sync');
|
|
176
|
-
}
|
|
177
|
-
/** 当前文件大小 */
|
|
178
|
-
async size() {
|
|
179
|
-
this.assertOpen('size');
|
|
180
|
-
return this.readData().length;
|
|
181
|
-
}
|
|
182
|
-
/** 关闭句柄 */
|
|
183
|
-
async close() {
|
|
184
|
-
this.closed = true;
|
|
185
|
-
}
|
|
186
|
-
/**
|
|
187
|
-
* 读取当前文件内容
|
|
188
|
-
*/
|
|
189
|
-
readData() {
|
|
190
|
-
return this.directory.get(this.file) ?? new Uint8Array(0);
|
|
191
|
-
}
|
|
192
|
-
/**
|
|
193
|
-
* 断言句柄未关闭
|
|
194
|
-
* @param operation 操作名
|
|
195
|
-
*/
|
|
196
|
-
assertOpen(operation) {
|
|
197
|
-
if (this.closed) {
|
|
198
|
-
throw new LightDbError(LightDbErrorCodes.sessionClosed, 'storage handle is closed', { operation });
|
|
199
|
-
}
|
|
200
|
-
}
|
|
201
|
-
}
|
|
202
|
-
/**
|
|
203
|
-
* 扩展到指定大小,新增区间填零
|
|
204
|
-
* @param current 当前内容
|
|
205
|
-
* @param size 目标大小
|
|
206
|
-
*/
|
|
207
|
-
function grow(current, size) {
|
|
208
|
-
const next = new Uint8Array(size);
|
|
209
|
-
next.set(current, 0);
|
|
210
|
-
return next;
|
|
211
|
-
}
|
|
212
|
-
//# sourceMappingURL=MemoryStorageAdapter.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"MemoryStorageAdapter.js","sourceRoot":"","sources":["../../../src/storage/memory/MemoryStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKlD;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAC7B,YAAY;IACI,IAAI,GAAG,QAAiB,CAAC;IAEzC,iBAAiB;IACD,UAAU,GAAG,KAAK,CAAC;IAElB,WAAW,GAAiC,IAAI,GAAG,EAAE,CAAC;IAEvE;;;OAGG;IACI,KAAK,CAAC,YAAY,CAAC,IAAY;QAClC,IAAI,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,cAAc;IACP,KAAK;QACR,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAC7B,YAAY;IACI,IAAI,GAAG,QAAiB,CAAC;IAEzC,iBAAiB;IACD,UAAU,GAAG,KAAK,CAAC;IAElB,IAAI,CAAS;IACb,SAAS,CAAkB;IACpC,MAAM,GAAY,KAAK,CAAC;IAEhC,YAAY,IAAY,EAAE,SAA0B;QAChD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAI,CAAC,IAAiB,EAAE,OAAwB,WAAW;QACpE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,IAAI,wBAAwB,IAAI,CAAC,IAAI,GAAG,EAAE;gBACpG,SAAS,EAAE,aAAa;aAC3B,CAAC,CAAC;QACP,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,MAAM,CAAC,IAAiB;QACjC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,MAAM,CAAC,IAAiB;QACjC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM,CAAC,IAAiB,EAAE,EAAe;QAClD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,EAAE,EAAE,uCAAuC,IAAI,GAAG,EAAE;gBACzF,SAAS,EAAE,eAAe;aAC7B,CAAC,CAAC;QACP,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAI;QACb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,YAAY;IACL,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,SAAiB;QAChC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,aAAa,EAAE,2BAA2B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACxG,CAAC;IACL,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,mBAAmB;IACJ,SAAS,CAAkB;IAC3B,IAAI,CAAc;IAC3B,MAAM,GAAY,KAAK,CAAC;IAEhC,YAAY,SAA0B,EAAE,IAAiB;QACrD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,MAAc;QAC9C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,IAAI,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,IAAgB;QACjD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5E,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ,CAAC,IAAY;QAC9B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YACtD,OAAO;QACX,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,eAAe;IACR,KAAK,CAAC,IAAI;QACb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,aAAa;IACN,KAAK,CAAC,IAAI;QACb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,WAAW;IACJ,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,QAAQ;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,SAAiB;QAChC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,aAAa,EAAE,0BAA0B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACvG,CAAC;IACL,CAAC;CACJ;AAED;;;;GAIG;AACH,SAAS,IAAI,CAAC,OAAmB,EAAE,IAAY;IAC3C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AAChB,CAAC"}
|
|
@@ -1,141 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* OPFS 存储适配器
|
|
3
|
-
*
|
|
4
|
-
* 默认持久化后端。优先使用 sync access handle(需 Worker 上下文),
|
|
5
|
-
* 主线程退化为 `createWritable` + `getFile`,两条路径共享同一套逻辑文件语义。
|
|
6
|
-
*
|
|
7
|
-
* 不把 OPFS 目录结构暴露给上层:上层只认识 `main` / `main.tmp` / `wal` / `shm`。
|
|
8
|
-
*/
|
|
9
|
-
import type { StorageAdapter, StorageAdapterFactory, StorageFile, StorageHandle, StorageOpenMode } from '../StorageAdapter';
|
|
10
|
-
/** 文件元信息 */
|
|
11
|
-
interface FileLike {
|
|
12
|
-
size: number;
|
|
13
|
-
arrayBuffer(): Promise<ArrayBuffer>;
|
|
14
|
-
}
|
|
15
|
-
/** 可写流 */
|
|
16
|
-
interface WritableLike {
|
|
17
|
-
write(options: {
|
|
18
|
-
type: 'write';
|
|
19
|
-
position: number;
|
|
20
|
-
data: Uint8Array;
|
|
21
|
-
}): Promise<void>;
|
|
22
|
-
truncate(size: number): Promise<void>;
|
|
23
|
-
close(): Promise<void>;
|
|
24
|
-
}
|
|
25
|
-
/** 同步访问句柄 */
|
|
26
|
-
interface SyncAccessHandleLike {
|
|
27
|
-
read(buffer: Uint8Array, options?: {
|
|
28
|
-
at?: number;
|
|
29
|
-
}): number;
|
|
30
|
-
write(buffer: Uint8Array, options?: {
|
|
31
|
-
at?: number;
|
|
32
|
-
}): number;
|
|
33
|
-
truncate(size: number): void;
|
|
34
|
-
flush(): void;
|
|
35
|
-
getSize(): number;
|
|
36
|
-
close(): void;
|
|
37
|
-
}
|
|
38
|
-
/** 文件句柄 */
|
|
39
|
-
interface FileHandleLike {
|
|
40
|
-
getFile(): Promise<FileLike>;
|
|
41
|
-
createWritable(options?: {
|
|
42
|
-
keepExistingData?: boolean;
|
|
43
|
-
}): Promise<WritableLike>;
|
|
44
|
-
createSyncAccessHandle?(): Promise<SyncAccessHandleLike>;
|
|
45
|
-
move?(name: string): Promise<void>;
|
|
46
|
-
}
|
|
47
|
-
/** 目录句柄 */
|
|
48
|
-
interface DirectoryHandleLike {
|
|
49
|
-
getFileHandle(name: string, options?: {
|
|
50
|
-
create?: boolean;
|
|
51
|
-
}): Promise<FileHandleLike>;
|
|
52
|
-
getDirectoryHandle(name: string, options?: {
|
|
53
|
-
create?: boolean;
|
|
54
|
-
}): Promise<DirectoryHandleLike>;
|
|
55
|
-
removeEntry(name: string, options?: {
|
|
56
|
-
recursive?: boolean;
|
|
57
|
-
}): Promise<void>;
|
|
58
|
-
}
|
|
59
|
-
/**
|
|
60
|
-
* 判断当前宿主是否提供 OPFS
|
|
61
|
-
*/
|
|
62
|
-
export declare function isOpfsAvailable(): boolean;
|
|
63
|
-
/**
|
|
64
|
-
* OPFS 适配器工厂
|
|
65
|
-
*/
|
|
66
|
-
export declare class OpfsStorageAdapterFactory implements StorageAdapterFactory {
|
|
67
|
-
/** 适配器类型 */
|
|
68
|
-
readonly kind: "opfs";
|
|
69
|
-
/** 数据持久化 */
|
|
70
|
-
readonly persistent = true;
|
|
71
|
-
private root;
|
|
72
|
-
/**
|
|
73
|
-
* 打开数据库适配器
|
|
74
|
-
* @param name 数据库名
|
|
75
|
-
*/
|
|
76
|
-
openDatabase(name: string): Promise<StorageAdapter>;
|
|
77
|
-
/**
|
|
78
|
-
* 取得 OPFS 根目录
|
|
79
|
-
*/
|
|
80
|
-
private getRoot;
|
|
81
|
-
/**
|
|
82
|
-
* 取得或创建目录
|
|
83
|
-
* @param parent 父目录
|
|
84
|
-
* @param name 目录名
|
|
85
|
-
* @param operation 操作名
|
|
86
|
-
*/
|
|
87
|
-
private getDirectory;
|
|
88
|
-
}
|
|
89
|
-
/**
|
|
90
|
-
* OPFS 存储适配器
|
|
91
|
-
*/
|
|
92
|
-
export declare class OpfsStorageAdapter implements StorageAdapter {
|
|
93
|
-
/** 适配器类型 */
|
|
94
|
-
readonly kind: "opfs";
|
|
95
|
-
/** 数据持久化 */
|
|
96
|
-
readonly persistent = true;
|
|
97
|
-
private readonly name;
|
|
98
|
-
private readonly directory;
|
|
99
|
-
private closed;
|
|
100
|
-
constructor(name: string, directory: DirectoryHandleLike);
|
|
101
|
-
/**
|
|
102
|
-
* 打开逻辑文件
|
|
103
|
-
* @param file 逻辑文件名
|
|
104
|
-
* @param mode 打开模式
|
|
105
|
-
*/
|
|
106
|
-
open(file: StorageFile, mode?: StorageOpenMode): Promise<StorageHandle>;
|
|
107
|
-
/**
|
|
108
|
-
* 判断文件是否存在
|
|
109
|
-
* @param file 逻辑文件名
|
|
110
|
-
*/
|
|
111
|
-
exists(file: StorageFile): Promise<boolean>;
|
|
112
|
-
/**
|
|
113
|
-
* 删除文件
|
|
114
|
-
* @param file 逻辑文件名
|
|
115
|
-
*/
|
|
116
|
-
delete(file: StorageFile): Promise<void>;
|
|
117
|
-
/**
|
|
118
|
-
* 发布快照:优先 `move`,否则复制后删除
|
|
119
|
-
* @param from 源文件
|
|
120
|
-
* @param to 目标文件
|
|
121
|
-
*/
|
|
122
|
-
rename(from: StorageFile, to: StorageFile): Promise<void>;
|
|
123
|
-
/**
|
|
124
|
-
* 列出已存在的文件
|
|
125
|
-
*/
|
|
126
|
-
list(): Promise<StorageFile[]>;
|
|
127
|
-
/** 关闭适配器 */
|
|
128
|
-
close(): Promise<void>;
|
|
129
|
-
/**
|
|
130
|
-
* 读取逻辑文件全部内容
|
|
131
|
-
* @param file 逻辑文件名
|
|
132
|
-
*/
|
|
133
|
-
private readAll;
|
|
134
|
-
/**
|
|
135
|
-
* 断言适配器未关闭
|
|
136
|
-
* @param operation 操作名
|
|
137
|
-
*/
|
|
138
|
-
private assertOpen;
|
|
139
|
-
}
|
|
140
|
-
export {};
|
|
141
|
-
//# sourceMappingURL=OpfsStorageAdapter.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"OpfsStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/storage/opfs/OpfsStorageAdapter.ts"],"names":[],"mappings":"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"}
|