@aztec/kv-store 0.0.1-commit.9ef841308 → 0.0.1-commit.a5db02d

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. package/README.md +10 -1
  2. package/dest/bench/shared_map_bench.d.ts +19 -0
  3. package/dest/bench/shared_map_bench.d.ts.map +1 -0
  4. package/dest/bench/shared_map_bench.js +91 -0
  5. package/dest/deprecated/indexeddb/array.d.ts +22 -0
  6. package/dest/deprecated/indexeddb/array.d.ts.map +1 -0
  7. package/dest/deprecated/indexeddb/index.d.ts +7 -0
  8. package/dest/deprecated/indexeddb/index.d.ts.map +1 -0
  9. package/dest/deprecated/indexeddb/index.js +8 -0
  10. package/dest/deprecated/indexeddb/map.d.ts +38 -0
  11. package/dest/deprecated/indexeddb/map.d.ts.map +1 -0
  12. package/dest/deprecated/indexeddb/multi_map.d.ts +14 -0
  13. package/dest/deprecated/indexeddb/multi_map.d.ts.map +1 -0
  14. package/dest/deprecated/indexeddb/set.d.ts +17 -0
  15. package/dest/deprecated/indexeddb/set.d.ts.map +1 -0
  16. package/dest/deprecated/indexeddb/singleton.d.ts +17 -0
  17. package/dest/deprecated/indexeddb/singleton.d.ts.map +1 -0
  18. package/dest/deprecated/indexeddb/store.d.ts +98 -0
  19. package/dest/deprecated/indexeddb/store.d.ts.map +1 -0
  20. package/dest/{indexeddb → deprecated/indexeddb}/store.js +2 -0
  21. package/dest/interfaces/array_test_suite.d.ts +1 -1
  22. package/dest/interfaces/array_test_suite.d.ts.map +1 -1
  23. package/dest/interfaces/array_test_suite.js +33 -34
  24. package/dest/interfaces/index.d.ts +2 -2
  25. package/dest/interfaces/index.d.ts.map +1 -1
  26. package/dest/interfaces/map_test_suite.d.ts +1 -1
  27. package/dest/interfaces/map_test_suite.d.ts.map +1 -1
  28. package/dest/interfaces/map_test_suite.js +32 -33
  29. package/dest/interfaces/multi_map_test_suite.d.ts +1 -1
  30. package/dest/interfaces/multi_map_test_suite.d.ts.map +1 -1
  31. package/dest/interfaces/multi_map_test_suite.js +68 -69
  32. package/dest/interfaces/set_test_suite.d.ts +1 -1
  33. package/dest/interfaces/set_test_suite.d.ts.map +1 -1
  34. package/dest/interfaces/set_test_suite.js +13 -14
  35. package/dest/interfaces/singleton_test_suite.d.ts +1 -1
  36. package/dest/interfaces/singleton_test_suite.d.ts.map +1 -1
  37. package/dest/interfaces/singleton_test_suite.js +6 -7
  38. package/dest/lmdb/index.js +2 -2
  39. package/dest/lmdb-v2/factory.d.ts +29 -3
  40. package/dest/lmdb-v2/factory.d.ts.map +1 -1
  41. package/dest/lmdb-v2/factory.js +62 -10
  42. package/dest/lmdb-v2/read_transaction.js +21 -19
  43. package/dest/lmdb-v2/store.d.ts +2 -2
  44. package/dest/lmdb-v2/store.d.ts.map +1 -1
  45. package/dest/lmdb-v2/store.js +4 -4
  46. package/dest/sqlite-opfs/array.d.ts +21 -0
  47. package/dest/sqlite-opfs/array.d.ts.map +1 -0
  48. package/dest/sqlite-opfs/array.js +128 -0
  49. package/dest/sqlite-opfs/errors.d.ts +27 -0
  50. package/dest/sqlite-opfs/errors.d.ts.map +1 -0
  51. package/dest/sqlite-opfs/errors.js +34 -0
  52. package/dest/sqlite-opfs/index.d.ts +14 -0
  53. package/dest/sqlite-opfs/index.d.ts.map +1 -0
  54. package/dest/sqlite-opfs/index.js +16 -0
  55. package/dest/sqlite-opfs/internal/ordered-binary-browser.d.ts +32 -0
  56. package/dest/sqlite-opfs/internal/ordered-binary-browser.d.ts.map +1 -0
  57. package/dest/sqlite-opfs/internal/ordered-binary-browser.js +448 -0
  58. package/dest/sqlite-opfs/manage.d.ts +20 -0
  59. package/dest/sqlite-opfs/manage.d.ts.map +1 -0
  60. package/dest/sqlite-opfs/manage.js +31 -0
  61. package/dest/sqlite-opfs/map.d.ts +35 -0
  62. package/dest/sqlite-opfs/map.d.ts.map +1 -0
  63. package/dest/sqlite-opfs/map.js +163 -0
  64. package/dest/sqlite-opfs/messages.d.ts +66 -0
  65. package/dest/sqlite-opfs/messages.d.ts.map +1 -0
  66. package/dest/sqlite-opfs/messages.js +5 -0
  67. package/dest/sqlite-opfs/multi_map.d.ts +16 -0
  68. package/dest/sqlite-opfs/multi_map.d.ts.map +1 -0
  69. package/dest/sqlite-opfs/multi_map.js +67 -0
  70. package/dest/sqlite-opfs/set.d.ts +13 -0
  71. package/dest/sqlite-opfs/set.d.ts.map +1 -0
  72. package/dest/sqlite-opfs/set.js +19 -0
  73. package/dest/sqlite-opfs/singleton.d.ts +13 -0
  74. package/dest/sqlite-opfs/singleton.d.ts.map +1 -0
  75. package/dest/sqlite-opfs/singleton.js +48 -0
  76. package/dest/sqlite-opfs/store.d.ts +79 -0
  77. package/dest/sqlite-opfs/store.d.ts.map +1 -0
  78. package/dest/sqlite-opfs/store.js +281 -0
  79. package/dest/sqlite-opfs/worker.d.ts +2 -0
  80. package/dest/sqlite-opfs/worker.d.ts.map +1 -0
  81. package/dest/sqlite-opfs/worker.js +264 -0
  82. package/dest/stores/l2_tips_store.d.ts +7 -13
  83. package/dest/stores/l2_tips_store.d.ts.map +1 -1
  84. package/dest/stores/l2_tips_store.js +24 -43
  85. package/package.json +23 -20
  86. package/src/bench/shared_map_bench.ts +111 -0
  87. package/src/{indexeddb → deprecated/indexeddb}/array.ts +2 -2
  88. package/src/deprecated/indexeddb/index.ts +12 -0
  89. package/src/{indexeddb → deprecated/indexeddb}/map.ts +2 -2
  90. package/src/{indexeddb → deprecated/indexeddb}/multi_map.ts +2 -2
  91. package/src/{indexeddb → deprecated/indexeddb}/set.ts +2 -2
  92. package/src/{indexeddb → deprecated/indexeddb}/singleton.ts +2 -2
  93. package/src/{indexeddb → deprecated/indexeddb}/store.ts +10 -9
  94. package/src/interfaces/array_test_suite.ts +33 -35
  95. package/src/interfaces/index.ts +1 -1
  96. package/src/interfaces/map_test_suite.ts +32 -34
  97. package/src/interfaces/multi_map_test_suite.ts +65 -67
  98. package/src/interfaces/set_test_suite.ts +13 -15
  99. package/src/interfaces/singleton_test_suite.ts +6 -8
  100. package/src/lmdb/index.ts +2 -2
  101. package/src/lmdb-v2/factory.ts +85 -9
  102. package/src/lmdb-v2/read_transaction.ts +23 -23
  103. package/src/lmdb-v2/store.ts +4 -2
  104. package/src/sqlite-opfs/array.ts +124 -0
  105. package/src/sqlite-opfs/errors.ts +44 -0
  106. package/src/sqlite-opfs/index.ts +22 -0
  107. package/src/sqlite-opfs/internal/ordered-binary-browser.js +465 -0
  108. package/src/sqlite-opfs/manage.ts +36 -0
  109. package/src/sqlite-opfs/map.ts +163 -0
  110. package/src/sqlite-opfs/messages.ts +39 -0
  111. package/src/sqlite-opfs/multi_map.ts +74 -0
  112. package/src/sqlite-opfs/set.ts +29 -0
  113. package/src/sqlite-opfs/singleton.ts +48 -0
  114. package/src/sqlite-opfs/store.ts +296 -0
  115. package/src/sqlite-opfs/worker.ts +248 -0
  116. package/src/stores/l2_tips_store.ts +20 -41
  117. package/dest/indexeddb/array.d.ts +0 -22
  118. package/dest/indexeddb/array.d.ts.map +0 -1
  119. package/dest/indexeddb/index.d.ts +0 -7
  120. package/dest/indexeddb/index.d.ts.map +0 -1
  121. package/dest/indexeddb/index.js +0 -16
  122. package/dest/indexeddb/map.d.ts +0 -38
  123. package/dest/indexeddb/map.d.ts.map +0 -1
  124. package/dest/indexeddb/multi_map.d.ts +0 -14
  125. package/dest/indexeddb/multi_map.d.ts.map +0 -1
  126. package/dest/indexeddb/set.d.ts +0 -17
  127. package/dest/indexeddb/set.d.ts.map +0 -1
  128. package/dest/indexeddb/singleton.d.ts +0 -17
  129. package/dest/indexeddb/singleton.d.ts.map +0 -1
  130. package/dest/indexeddb/store.d.ts +0 -96
  131. package/dest/indexeddb/store.d.ts.map +0 -1
  132. package/src/indexeddb/index.ts +0 -31
  133. /package/dest/{indexeddb → deprecated/indexeddb}/array.js +0 -0
  134. /package/dest/{indexeddb → deprecated/indexeddb}/map.js +0 -0
  135. /package/dest/{indexeddb → deprecated/indexeddb}/multi_map.js +0 -0
  136. /package/dest/{indexeddb → deprecated/indexeddb}/set.js +0 -0
  137. /package/dest/{indexeddb → deprecated/indexeddb}/singleton.js +0 -0
@@ -0,0 +1,163 @@
1
+ import { Encoder } from '#msgpackr';
2
+ import { fromBufferKey, toBufferKey } from '#ordered-binary';
3
+ import { Buffer } from 'buffer';
4
+ import { hash } from 'ohash';
5
+ /** A map backed by SQLite in OPFS. Mirrors `IndexedDBAztecMap`. */ export class SQLiteOPFSAztecMap {
6
+ store;
7
+ name;
8
+ container;
9
+ encoder;
10
+ constructor(store, mapName){
11
+ this.store = store;
12
+ this.encoder = new Encoder();
13
+ this.name = mapName;
14
+ this.container = `map:${mapName}`;
15
+ }
16
+ async getAsync(key) {
17
+ const rows = await this.store.allAsync('SELECT value FROM data WHERE slot = ? LIMIT 1', [
18
+ this.slot(key)
19
+ ]);
20
+ if (rows.length === 0) {
21
+ return undefined;
22
+ }
23
+ const raw = rows[0][0];
24
+ return raw == null ? undefined : this.decodeValue(raw);
25
+ }
26
+ async hasAsync(key) {
27
+ const rows = await this.store.allAsync('SELECT 1 FROM data WHERE slot = ? LIMIT 1', [
28
+ this.slot(key)
29
+ ]);
30
+ return rows.length > 0;
31
+ }
32
+ async sizeAsync() {
33
+ const rows = await this.store.allAsync('SELECT COUNT(*) FROM data WHERE container = ?', [
34
+ this.container
35
+ ]);
36
+ return Number(rows[0]?.[0] ?? 0);
37
+ }
38
+ async set(key, val) {
39
+ await this.store.runAsync(`INSERT OR REPLACE INTO data (slot, container, key, key_count, hash, value)
40
+ VALUES (?, ?, ?, ?, ?, ?)`, [
41
+ this.slot(key),
42
+ this.container,
43
+ this.encodedKey(key),
44
+ 1,
45
+ hash(val),
46
+ this.encoder.pack(val)
47
+ ]);
48
+ }
49
+ async setMany(entries) {
50
+ if (entries.length === 0) {
51
+ return;
52
+ }
53
+ await this.store.transactionAsync(async ()=>{
54
+ for (const { key, value } of entries){
55
+ await this.set(key, value);
56
+ }
57
+ });
58
+ }
59
+ swap(_key, _fn) {
60
+ throw new Error('Not implemented');
61
+ }
62
+ async setIfNotExists(key, val) {
63
+ return await this.store.transactionAsync(async ()=>{
64
+ if (await this.hasAsync(key)) {
65
+ return false;
66
+ }
67
+ await this.set(key, val);
68
+ return true;
69
+ });
70
+ }
71
+ async delete(key) {
72
+ await this.store.runAsync('DELETE FROM data WHERE slot = ?', [
73
+ this.slot(key)
74
+ ]);
75
+ }
76
+ async *entriesAsync(range = {}) {
77
+ const rows = await this.rangeQuery(range);
78
+ for (const row of rows){
79
+ const [_slot, keyBlob, value] = row;
80
+ if (keyBlob == null || value == null) {
81
+ continue;
82
+ }
83
+ yield [
84
+ this.decodeKey(keyBlob),
85
+ this.decodeValue(value)
86
+ ];
87
+ }
88
+ }
89
+ async *valuesAsync(range = {}) {
90
+ for await (const [, value] of this.entriesAsync(range)){
91
+ yield value;
92
+ }
93
+ }
94
+ async *keysAsync(range = {}) {
95
+ for await (const [key] of this.entriesAsync(range)){
96
+ yield key;
97
+ }
98
+ }
99
+ async rangeQuery(range) {
100
+ // Inclusivity flips with direction to match the IndexedDB backend:
101
+ // forward: [start, end) reverse: (start, end]
102
+ // That asymmetry is load-bearing — tests pin the exact inclusivity at boundaries.
103
+ const reverse = !!range.reverse;
104
+ const parts = [
105
+ 'container = ?'
106
+ ];
107
+ const bind = [
108
+ this.container
109
+ ];
110
+ if (range.start !== undefined) {
111
+ parts.push(reverse ? 'key > ?' : 'key >= ?');
112
+ bind.push(this.encodedKey(range.start));
113
+ }
114
+ if (range.end !== undefined) {
115
+ parts.push(reverse ? 'key <= ?' : 'key < ?');
116
+ bind.push(this.encodedKey(range.end));
117
+ }
118
+ const order = reverse ? 'DESC' : 'ASC';
119
+ let sql = `SELECT slot, key, value FROM data WHERE ${parts.join(' AND ')} ORDER BY key ${order}, key_count ${order}`;
120
+ if (range.limit !== undefined) {
121
+ sql += ' LIMIT ?';
122
+ bind.push(range.limit);
123
+ }
124
+ const rows = await this.store.allAsync(sql, bind);
125
+ return rows.map((r)=>[
126
+ String(r[0]),
127
+ r[1],
128
+ r[2]
129
+ ]);
130
+ }
131
+ decodeValue(val) {
132
+ if (!(val instanceof Uint8Array)) {
133
+ return val;
134
+ }
135
+ const unpacked = this.encoder.unpack(val);
136
+ // msgpackr returns plain Uint8Array in browsers for packed Buffers. Callers that
137
+ // stored Buffers (walletDB uses Buffer.from(...).toString('utf8') round-trips)
138
+ // rely on Buffer-flavored behavior — re-wrap at the storage boundary, mirroring
139
+ // IndexedDBAztecMap.restoreBuffers.
140
+ if (unpacked instanceof Uint8Array && !Buffer.isBuffer(unpacked)) {
141
+ return Buffer.from(unpacked);
142
+ }
143
+ return unpacked;
144
+ }
145
+ decodeKey(raw) {
146
+ const parsed = fromBufferKey(Buffer.from(raw));
147
+ if (Array.isArray(parsed)) {
148
+ return parsed.length > 1 ? parsed : parsed[0];
149
+ }
150
+ return parsed;
151
+ }
152
+ encodedKey(key) {
153
+ return toBufferKey(this.normalizeKey(key));
154
+ }
155
+ normalizeKey(key) {
156
+ return Array.isArray(key) ? key : [
157
+ key
158
+ ];
159
+ }
160
+ slot(key, index = 0) {
161
+ return `map:${this.name}:slot:${this.normalizeKey(key)}:${index}`;
162
+ }
163
+ }
@@ -0,0 +1,66 @@
1
+ /**
2
+ * RPC protocol between the main thread and the SQLite worker.
3
+ * All requests carry a unique `id`; responses echo the same id so the main thread
4
+ * can resolve the right pending promise.
5
+ */
6
+ import type { SqliteEncryptionErrorCode } from './errors.js';
7
+ /** Matches `@sqlite.org/sqlite-wasm`'s internal SqlValue type. Boolean is not a native SQLite type. */
8
+ export type SqlValue = string | number | bigint | null | Uint8Array;
9
+ /** A row returned in 'array' rowMode — one value per column, in select order. */
10
+ export type ResultRow = SqlValue[];
11
+ export type WorkerRequest = {
12
+ type: 'init';
13
+ id: number;
14
+ dbName: string;
15
+ ephemeral: boolean;
16
+ poolDirectory?: string;
17
+ encryptionKey?: Uint8Array;
18
+ } | {
19
+ type: 'close';
20
+ id: number;
21
+ } | {
22
+ type: 'deleteDb';
23
+ id: number;
24
+ dbName: string;
25
+ } | {
26
+ type: 'run';
27
+ id: number;
28
+ sql: string;
29
+ bind?: SqlValue[];
30
+ } | {
31
+ type: 'all';
32
+ id: number;
33
+ sql: string;
34
+ bind?: SqlValue[];
35
+ } | {
36
+ type: 'export';
37
+ id: number;
38
+ } | {
39
+ type: 'begin';
40
+ id: number;
41
+ } | {
42
+ type: 'commit';
43
+ id: number;
44
+ } | {
45
+ type: 'rollback';
46
+ id: number;
47
+ };
48
+ export type WorkerResponse = {
49
+ type: 'ok';
50
+ id: number;
51
+ rows?: ResultRow[];
52
+ changes?: number;
53
+ bytes?: Uint8Array;
54
+ } | {
55
+ type: 'err';
56
+ id: number;
57
+ message: string;
58
+ /**
59
+ * Set when the worker detected an encryption-shaped failure. The main thread
60
+ * uses this to re-throw the error as a {@link SqliteEncryptionError} with the
61
+ * matching code. Absent on non-encryption failures (untyped paths preserved).
62
+ */
63
+ encryptionCode?: SqliteEncryptionErrorCode;
64
+ };
65
+ export type WorkerRequestType = WorkerRequest['type'];
66
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVzc2FnZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zcWxpdGUtb3Bmcy9tZXNzYWdlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gsT0FBTyxLQUFLLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFN0QsdUdBQXVHO0FBQ3ZHLE1BQU0sTUFBTSxRQUFRLEdBQUcsTUFBTSxHQUFHLE1BQU0sR0FBRyxNQUFNLEdBQUcsSUFBSSxHQUFHLFVBQVUsQ0FBQztBQUVwRSxtRkFBaUY7QUFDakYsTUFBTSxNQUFNLFNBQVMsR0FBRyxRQUFRLEVBQUUsQ0FBQztBQUVuQyxNQUFNLE1BQU0sYUFBYSxHQUNyQjtJQUFFLElBQUksRUFBRSxNQUFNLENBQUM7SUFBQyxFQUFFLEVBQUUsTUFBTSxDQUFDO0lBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQztJQUFDLFNBQVMsRUFBRSxPQUFPLENBQUM7SUFBQyxhQUFhLENBQUMsRUFBRSxNQUFNLENBQUM7SUFBQyxhQUFhLENBQUMsRUFBRSxVQUFVLENBQUE7Q0FBRSxHQUNwSDtJQUFFLElBQUksRUFBRSxPQUFPLENBQUM7SUFBQyxFQUFFLEVBQUUsTUFBTSxDQUFBO0NBQUUsR0FDN0I7SUFBRSxJQUFJLEVBQUUsVUFBVSxDQUFDO0lBQUMsRUFBRSxFQUFFLE1BQU0sQ0FBQztJQUFDLE1BQU0sRUFBRSxNQUFNLENBQUE7Q0FBRSxHQUNoRDtJQUFFLElBQUksRUFBRSxLQUFLLENBQUM7SUFBQyxFQUFFLEVBQUUsTUFBTSxDQUFDO0lBQUMsR0FBRyxFQUFFLE1BQU0sQ0FBQztJQUFDLElBQUksQ0FBQyxFQUFFLFFBQVEsRUFBRSxDQUFBO0NBQUUsR0FDM0Q7SUFBRSxJQUFJLEVBQUUsS0FBSyxDQUFDO0lBQUMsRUFBRSxFQUFFLE1BQU0sQ0FBQztJQUFDLEdBQUcsRUFBRSxNQUFNLENBQUM7SUFBQyxJQUFJLENBQUMsRUFBRSxRQUFRLEVBQUUsQ0FBQTtDQUFFLEdBQzNEO0lBQUUsSUFBSSxFQUFFLFFBQVEsQ0FBQztJQUFDLEVBQUUsRUFBRSxNQUFNLENBQUE7Q0FBRSxHQUM5QjtJQUFFLElBQUksRUFBRSxPQUFPLENBQUM7SUFBQyxFQUFFLEVBQUUsTUFBTSxDQUFBO0NBQUUsR0FDN0I7SUFBRSxJQUFJLEVBQUUsUUFBUSxDQUFDO0lBQUMsRUFBRSxFQUFFLE1BQU0sQ0FBQTtDQUFFLEdBQzlCO0lBQUUsSUFBSSxFQUFFLFVBQVUsQ0FBQztJQUFDLEVBQUUsRUFBRSxNQUFNLENBQUE7Q0FBRSxDQUFDO0FBRXJDLE1BQU0sTUFBTSxjQUFjLEdBQ3RCO0lBQUUsSUFBSSxFQUFFLElBQUksQ0FBQztJQUFDLEVBQUUsRUFBRSxNQUFNLENBQUM7SUFBQyxJQUFJLENBQUMsRUFBRSxTQUFTLEVBQUUsQ0FBQztJQUFDLE9BQU8sQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUFDLEtBQUssQ0FBQyxFQUFFLFVBQVUsQ0FBQTtDQUFFLEdBQ3BGO0lBQ0UsSUFBSSxFQUFFLEtBQUssQ0FBQztJQUNaLEVBQUUsRUFBRSxNQUFNLENBQUM7SUFDWCxPQUFPLEVBQUUsTUFBTSxDQUFDO0lBQ2hCOzs7O09BSUc7SUFDSCxjQUFjLENBQUMsRUFBRSx5QkFBeUIsQ0FBQztDQUM1QyxDQUFDO0FBRU4sTUFBTSxNQUFNLGlCQUFpQixHQUFHLGFBQWEsQ0FBQyxNQUFNLENBQUMsQ0FBQyJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/sqlite-opfs/messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,uGAAuG;AACvG,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,UAAU,CAAC;AAEpE,mFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC;AAEnC,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,UAAU,CAAA;CAAE,GACpH;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,GACpF;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,yBAAyB,CAAC;CAC5C,CAAC;AAEN,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * RPC protocol between the main thread and the SQLite worker.
3
+ * All requests carry a unique `id`; responses echo the same id so the main thread
4
+ * can resolve the right pending promise.
5
+ */ export { };
@@ -0,0 +1,16 @@
1
+ import type { Key, Value } from '../interfaces/common.js';
2
+ import type { AztecAsyncMultiMap } from '../interfaces/multi_map.js';
3
+ import { SQLiteOPFSAztecMap } from './map.js';
4
+ /**
5
+ * Multi-map backed by SQLite. Extends the base map with always-incrementing
6
+ * `key_count` per-key so the same slot is never reused across deletions — this
7
+ * matches the IndexedDB backend's sparse-multi-map semantics.
8
+ */
9
+ export declare class SQLiteOPFSAztecMultiMap<K extends Key, V extends Value> extends SQLiteOPFSAztecMap<K, V> implements AztecAsyncMultiMap<K, V> {
10
+ set(key: K, val: V): Promise<void>;
11
+ getValuesAsync(key: K): AsyncIterableIterator<V>;
12
+ getValueCountAsync(key: K): Promise<number>;
13
+ deleteValue(key: K, val: V): Promise<void>;
14
+ delete(key: K): Promise<void>;
15
+ }
16
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibXVsdGlfbWFwLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc3FsaXRlLW9wZnMvbXVsdGlfbWFwLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sS0FBSyxFQUFFLEdBQUcsRUFBRSxLQUFLLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUMxRCxPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ3JFLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUU5Qzs7OztHQUlHO0FBQ0gscUJBQWEsdUJBQXVCLENBQUMsQ0FBQyxTQUFTLEdBQUcsRUFBRSxDQUFDLFNBQVMsS0FBSyxDQUNqRSxTQUFRLGtCQUFrQixDQUFDLENBQUMsRUFBRSxDQUFDLENBQy9CLFlBQVcsa0JBQWtCLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUVwQixHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FxQmhEO0lBRU0sY0FBYyxDQUFDLEdBQUcsRUFBRSxDQUFDLEdBQUcscUJBQXFCLENBQUMsQ0FBQyxDQUFDLENBV3REO0lBRUssa0JBQWtCLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBTWhEO0lBRUssV0FBVyxDQUFDLEdBQUcsRUFBRSxDQUFDLEVBQUUsR0FBRyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBTS9DO0lBRWMsTUFBTSxDQUFDLEdBQUcsRUFBRSxDQUFDLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUszQztDQUNGIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"multi_map.d.ts","sourceRoot":"","sources":["../../src/sqlite-opfs/multi_map.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,uBAAuB,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,KAAK,CACjE,SAAQ,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAC/B,YAAW,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;IAEpB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBhD;IAEM,cAAc,CAAC,GAAG,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAWtD;IAEK,kBAAkB,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhD;IAEK,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/C;IAEc,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3C;CACF"}
@@ -0,0 +1,67 @@
1
+ import { hash } from 'ohash';
2
+ import { SQLiteOPFSAztecMap } from './map.js';
3
+ /**
4
+ * Multi-map backed by SQLite. Extends the base map with always-incrementing
5
+ * `key_count` per-key so the same slot is never reused across deletions — this
6
+ * matches the IndexedDB backend's sparse-multi-map semantics.
7
+ */ export class SQLiteOPFSAztecMultiMap extends SQLiteOPFSAztecMap {
8
+ async set(key, val) {
9
+ const valueHash = hash(val);
10
+ await this.store.transactionAsync(async ()=>{
11
+ const exists = await this.store.allAsync('SELECT 1 FROM data WHERE container = ? AND key = ? AND hash = ? LIMIT 1', [
12
+ this.container,
13
+ this.encodedKey(key),
14
+ valueHash
15
+ ]);
16
+ if (exists.length > 0) {
17
+ return;
18
+ }
19
+ const maxRow = await this.store.allAsync('SELECT MAX(key_count) FROM data WHERE container = ? AND key = ?', [
20
+ this.container,
21
+ this.encodedKey(key)
22
+ ]);
23
+ const count = Number(maxRow[0]?.[0] ?? 0);
24
+ await this.store.runAsync(`INSERT INTO data (slot, container, key, key_count, hash, value)
25
+ VALUES (?, ?, ?, ?, ?, ?)`, [
26
+ this.slot(key, count),
27
+ this.container,
28
+ this.encodedKey(key),
29
+ count + 1,
30
+ valueHash,
31
+ this.encoder.pack(val)
32
+ ]);
33
+ });
34
+ }
35
+ async *getValuesAsync(key) {
36
+ const rows = await this.store.allAsync('SELECT value FROM data WHERE container = ? AND key = ? ORDER BY key_count ASC', [
37
+ this.container,
38
+ this.encodedKey(key)
39
+ ]);
40
+ for (const row of rows){
41
+ const raw = row[0];
42
+ if (raw instanceof Uint8Array) {
43
+ yield this.decodeValue(raw);
44
+ }
45
+ }
46
+ }
47
+ async getValueCountAsync(key) {
48
+ const rows = await this.store.allAsync('SELECT COUNT(*) FROM data WHERE container = ? AND key = ?', [
49
+ this.container,
50
+ this.encodedKey(key)
51
+ ]);
52
+ return Number(rows[0]?.[0] ?? 0);
53
+ }
54
+ async deleteValue(key, val) {
55
+ await this.store.runAsync('DELETE FROM data WHERE container = ? AND key = ? AND hash = ?', [
56
+ this.container,
57
+ this.encodedKey(key),
58
+ hash(val)
59
+ ]);
60
+ }
61
+ async delete(key) {
62
+ await this.store.runAsync('DELETE FROM data WHERE container = ? AND key = ?', [
63
+ this.container,
64
+ this.encodedKey(key)
65
+ ]);
66
+ }
67
+ }
@@ -0,0 +1,13 @@
1
+ import type { Key, Range } from '../interfaces/common.js';
2
+ import type { AztecAsyncSet } from '../interfaces/set.js';
3
+ import type { AztecSQLiteOPFSStore } from './store.js';
4
+ /** Set backed by SQLite. Composes a Map<K, true>. */
5
+ export declare class SQLiteOPFSAztecSet<K extends Key> implements AztecAsyncSet<K> {
6
+ #private;
7
+ constructor(store: AztecSQLiteOPFSStore, name: string);
8
+ hasAsync(key: K): Promise<boolean>;
9
+ add(key: K): Promise<void>;
10
+ delete(key: K): Promise<void>;
11
+ entriesAsync(range?: Range<K>): AsyncIterableIterator<K>;
12
+ }
13
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2V0LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc3FsaXRlLW9wZnMvc2V0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLEdBQUcsRUFBRSxLQUFLLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUMxRCxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUUxRCxPQUFPLEtBQUssRUFBRSxvQkFBb0IsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUV2RCxxREFBcUQ7QUFDckQscUJBQWEsa0JBQWtCLENBQUMsQ0FBQyxTQUFTLEdBQUcsQ0FBRSxZQUFXLGFBQWEsQ0FBQyxDQUFDLENBQUM7O0lBR3hFLFlBQVksS0FBSyxFQUFFLG9CQUFvQixFQUFFLElBQUksRUFBRSxNQUFNLEVBRXBEO0lBRUQsUUFBUSxDQUFDLEdBQUcsRUFBRSxDQUFDLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUVqQztJQUVELEdBQUcsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FFekI7SUFFRCxNQUFNLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBRTVCO0lBRU0sWUFBWSxDQUFDLEtBQUssR0FBRSxLQUFLLENBQUMsQ0FBQyxDQUFNLEdBQUcscUJBQXFCLENBQUMsQ0FBQyxDQUFDLENBRWxFO0NBQ0YifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/sqlite-opfs/set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,qDAAqD;AACrD,qBAAa,kBAAkB,CAAC,CAAC,SAAS,GAAG,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;;IAGxE,YAAY,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,EAEpD;IAED,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjC;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzB;IAED,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5B;IAEM,YAAY,CAAC,KAAK,GAAE,KAAK,CAAC,CAAC,CAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAElE;CACF"}
@@ -0,0 +1,19 @@
1
+ import { SQLiteOPFSAztecMap } from './map.js';
2
+ /** Set backed by SQLite. Composes a Map<K, true>. */ export class SQLiteOPFSAztecSet {
3
+ #map;
4
+ constructor(store, name){
5
+ this.#map = new SQLiteOPFSAztecMap(store, name);
6
+ }
7
+ hasAsync(key) {
8
+ return this.#map.hasAsync(key);
9
+ }
10
+ add(key) {
11
+ return this.#map.set(key, true);
12
+ }
13
+ delete(key) {
14
+ return this.#map.delete(key);
15
+ }
16
+ async *entriesAsync(range = {}) {
17
+ yield* this.#map.keysAsync(range);
18
+ }
19
+ }
@@ -0,0 +1,13 @@
1
+ import type { Value } from '../interfaces/common.js';
2
+ import type { AztecAsyncSingleton } from '../interfaces/singleton.js';
3
+ import type { AztecSQLiteOPFSStore } from './store.js';
4
+ /** Stores a single value identified by `name`. */
5
+ export declare class SQLiteOPFSAztecSingleton<T extends Value> implements AztecAsyncSingleton<T> {
6
+ #private;
7
+ private readonly store;
8
+ constructor(store: AztecSQLiteOPFSStore, name: string);
9
+ getAsync(): Promise<T | undefined>;
10
+ set(val: T): Promise<boolean>;
11
+ delete(): Promise<boolean>;
12
+ }
13
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2luZ2xldG9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc3FsaXRlLW9wZnMvc2luZ2xldG9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUlBLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ3JELE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDdEUsT0FBTyxLQUFLLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFdkQsa0RBQWtEO0FBQ2xELHFCQUFhLHdCQUF3QixDQUFDLENBQUMsU0FBUyxLQUFLLENBQUUsWUFBVyxtQkFBbUIsQ0FBQyxDQUFDLENBQUM7O0lBTXBGLE9BQU8sQ0FBQyxRQUFRLENBQUMsS0FBSztJQUR4QixZQUNtQixLQUFLLEVBQUUsb0JBQW9CLEVBQzVDLElBQUksRUFBRSxNQUFNLEVBSWI7SUFFSyxRQUFRLElBQUksT0FBTyxDQUFDLENBQUMsR0FBRyxTQUFTLENBQUMsQ0FVdkM7SUFFSyxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBT2xDO0lBRUssTUFBTSxJQUFJLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FHL0I7Q0FDRiJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/sqlite-opfs/singleton.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,kDAAkD;AAClD,qBAAa,wBAAwB,CAAC,CAAC,SAAS,KAAK,CAAE,YAAW,mBAAmB,CAAC,CAAC,CAAC;;IAMpF,OAAO,CAAC,QAAQ,CAAC,KAAK;IADxB,YACmB,KAAK,EAAE,oBAAoB,EAC5C,IAAI,EAAE,MAAM,EAIb;IAEK,QAAQ,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAUvC;IAEK,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlC;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAG/B;CACF"}
@@ -0,0 +1,48 @@
1
+ import { Encoder } from '#msgpackr';
2
+ import { toBufferKey } from '#ordered-binary';
3
+ import { hash } from 'ohash';
4
+ /** Stores a single value identified by `name`. */ export class SQLiteOPFSAztecSingleton {
5
+ store;
6
+ #container;
7
+ #slot;
8
+ #encoder;
9
+ constructor(store, name){
10
+ this.store = store;
11
+ this.#encoder = new Encoder();
12
+ this.#container = `singleton:${name}`;
13
+ this.#slot = `singleton:${name}:value`;
14
+ }
15
+ async getAsync() {
16
+ const rows = await this.store.allAsync('SELECT value FROM data WHERE slot = ? LIMIT 1', [
17
+ this.#slot
18
+ ]);
19
+ if (rows.length === 0) {
20
+ return undefined;
21
+ }
22
+ const raw = rows[0][0];
23
+ if (raw instanceof Uint8Array) {
24
+ return this.#encoder.unpack(raw);
25
+ }
26
+ return undefined;
27
+ }
28
+ async set(val) {
29
+ const { changes } = await this.store.runAsync(`INSERT OR REPLACE INTO data (slot, container, key, key_count, hash, value)
30
+ VALUES (?, ?, ?, ?, ?, ?)`, [
31
+ this.#slot,
32
+ this.#container,
33
+ toBufferKey([
34
+ this.#slot
35
+ ]),
36
+ 1,
37
+ hash(val),
38
+ this.#encoder.pack(val)
39
+ ]);
40
+ return changes > 0;
41
+ }
42
+ async delete() {
43
+ await this.store.runAsync('DELETE FROM data WHERE slot = ?', [
44
+ this.#slot
45
+ ]);
46
+ return true;
47
+ }
48
+ }
@@ -0,0 +1,79 @@
1
+ import type { Logger } from '@aztec/foundation/log';
2
+ import type { AztecAsyncArray } from '../interfaces/array.js';
3
+ import type { Key, StoreSize, Value } from '../interfaces/common.js';
4
+ import type { AztecAsyncCounter } from '../interfaces/counter.js';
5
+ import type { AztecAsyncMap } from '../interfaces/map.js';
6
+ import type { AztecAsyncMultiMap } from '../interfaces/multi_map.js';
7
+ import type { AztecAsyncSet } from '../interfaces/set.js';
8
+ import type { AztecAsyncSingleton } from '../interfaces/singleton.js';
9
+ import type { AztecAsyncKVStore } from '../interfaces/store.js';
10
+ import type { ResultRow, SqlValue } from './messages.js';
11
+ /**
12
+ * Main-thread handle for a SQLite database persisted to OPFS via the `opfs-sahpool`
13
+ * VFS. Owns a dedicated Web Worker (the SAH Pool VFS requires Worker context) and
14
+ * routes every SQL op through it via typed postMessage RPC.
15
+ *
16
+ * Transaction ordering is guaranteed by a `SerialQueue` on the main thread combined
17
+ * with an `#inTx` flag: outside a `transactionAsync` block, each op acquires the
18
+ * queue for its own auto-commit; inside a block, the outer call holds the queue and
19
+ * nested ops bypass it to avoid deadlock.
20
+ */
21
+ export declare class AztecSQLiteOPFSStore implements AztecAsyncKVStore {
22
+ #private;
23
+ readonly isEphemeral: boolean;
24
+ private constructor();
25
+ /**
26
+ * Opens (or creates) a SQLite database stored in the OPFS SAH Pool. When `ephemeral`
27
+ * is true the database lives only in memory and is lost when the worker terminates.
28
+ * Pass `poolDirectory` to place the SAH Pool in a non-default OPFS subdirectory —
29
+ * required when multiple stores coexist in the same tab, because the SAH Pool holds
30
+ * an exclusive lock on its directory.
31
+ *
32
+ * Pass `encryptionKey` (exactly 32 bytes) to enable at-rest encryption via sqlite3mc's
33
+ * ChaCha20 page cipher. The key buffer is **transferred** to the worker — its
34
+ * ArrayBuffer detaches on the caller side after `postMessage`. This is intentional:
35
+ * the API encodes a one-key-one-owner invariant. A caller that wants to use the same
36
+ * key for multiple stores must explicitly clone it per call (e.g.
37
+ * `new Uint8Array(savedKey)`), making the duplication a visible, deliberate decision
38
+ * rather than a silent structured-clone operation. The default path (one `.open()`,
39
+ * one consumption of the key) leaves zero key bytes on the main thread after the call.
40
+ */
41
+ static open(log: Logger, name?: string, ephemeral?: boolean, poolDirectory?: string, encryptionKey?: Uint8Array): Promise<AztecSQLiteOPFSStore>;
42
+ openMap<K extends Key, V extends Value>(name: string): AztecAsyncMap<K, V>;
43
+ openSet<K extends Key>(name: string): AztecAsyncSet<K>;
44
+ openMultiMap<K extends Key, V extends Value>(name: string): AztecAsyncMultiMap<K, V>;
45
+ openCounter<K extends Key>(_name: string): AztecAsyncCounter<K>;
46
+ openArray<T extends Value>(name: string): AztecAsyncArray<T>;
47
+ openSingleton<T extends Value>(name: string): AztecAsyncSingleton<T>;
48
+ transactionAsync<T>(callback: () => Promise<T>): Promise<T>;
49
+ clear(): Promise<void>;
50
+ delete(): Promise<void>;
51
+ /**
52
+ * Placeholder — returns zeros to mirror the IndexedDB backend. SQLite exposes real
53
+ * numbers cheaply via `PRAGMA page_count` / `page_size` / `freelist_count` and
54
+ * `SELECT COUNT(*) FROM data`, which would populate `physicalFileSize`, `actualSize`,
55
+ * and `numItems` meaningfully (`mappingSize` stays 0 — it's an LMDB mmap concept).
56
+ * Upgrade when any caller actually consumes these values; all current consumers
57
+ * tolerate zeros.
58
+ */
59
+ estimateSize(): Promise<StoreSize>;
60
+ close(): Promise<void>;
61
+ backupTo(_dstPath: string, _compact?: boolean): Promise<void>;
62
+ /**
63
+ * Returns a raw SQLite image (bytes suitable for writing as a `.sqlite` file and
64
+ * opening in any SQLite tool). Works only for non-ephemeral DBs because the OPFS
65
+ * SAH Pool has to be initialized. Useful for inspection/debugging.
66
+ */
67
+ exportDb(): Promise<Uint8Array>;
68
+ /**
69
+ * Runs a write statement (INSERT/UPDATE/DELETE/DDL). If called inside a
70
+ * `transactionAsync` block, bypasses the queue; otherwise acquires it so the
71
+ * op runs in its own auto-commit.
72
+ */
73
+ runAsync(sql: string, bind?: SqlValue[]): Promise<{
74
+ changes: number;
75
+ }>;
76
+ /** Runs a SELECT statement and returns rows in array row-mode. */
77
+ allAsync(sql: string, bind?: SqlValue[]): Promise<ResultRow[]>;
78
+ }
79
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zcWxpdGUtb3Bmcy9zdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUdwRCxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUM5RCxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsU0FBUyxFQUFFLEtBQUssRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ3JFLE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDbEUsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDMUQsT0FBTyxLQUFLLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUNyRSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUMxRCxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ3RFLE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFJaEUsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLFFBQVEsRUFBaUMsTUFBTSxlQUFlLENBQUM7QUFLeEY7Ozs7Ozs7OztHQVNHO0FBQ0gscUJBQWEsb0JBQXFCLFlBQVcsaUJBQWlCOzthQWMxQyxXQUFXLEVBQUUsT0FBTztJQUp0QyxPQUFPLGVBd0JOO0lBRUQ7Ozs7Ozs7Ozs7Ozs7OztPQWVHO0lBQ0gsT0FBYSxJQUFJLENBQ2YsR0FBRyxFQUFFLE1BQU0sRUFDWCxJQUFJLENBQUMsRUFBRSxNQUFNLEVBQ2IsU0FBUyxHQUFFLE9BQWUsRUFDMUIsYUFBYSxDQUFDLEVBQUUsTUFBTSxFQUN0QixhQUFhLENBQUMsRUFBRSxVQUFVLEdBQ3pCLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBQyxDQWlDL0I7SUFFRCxPQUFPLENBQUMsQ0FBQyxTQUFTLEdBQUcsRUFBRSxDQUFDLFNBQVMsS0FBSyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsYUFBYSxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FFekU7SUFFRCxPQUFPLENBQUMsQ0FBQyxTQUFTLEdBQUcsRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLGFBQWEsQ0FBQyxDQUFDLENBQUMsQ0FFckQ7SUFFRCxZQUFZLENBQUMsQ0FBQyxTQUFTLEdBQUcsRUFBRSxDQUFDLFNBQVMsS0FBSyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsa0JBQWtCLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUVuRjtJQUVELFdBQVcsQ0FBQyxDQUFDLFNBQVMsR0FBRyxFQUFFLEtBQUssRUFBRSxNQUFNLEdBQUcsaUJBQWlCLENBQUMsQ0FBQyxDQUFDLENBRTlEO0lBRUQsU0FBUyxDQUFDLENBQUMsU0FBUyxLQUFLLEVBQUUsSUFBSSxFQUFFLE1BQU0sR0FBRyxlQUFlLENBQUMsQ0FBQyxDQUFDLENBRTNEO0lBRUQsYUFBYSxDQUFDLENBQUMsU0FBUyxLQUFLLEVBQUUsSUFBSSxFQUFFLE1BQU0sR0FBRyxtQkFBbUIsQ0FBQyxDQUFDLENBQUMsQ0FFbkU7SUFFRCxnQkFBZ0IsQ0FBQyxDQUFDLEVBQUUsUUFBUSxFQUFFLE1BQU0sT0FBTyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0F3QjFEO0lBRUssS0FBSyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FFM0I7SUFFSyxNQUFNLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQVc1QjtJQUVEOzs7Ozs7O09BT0c7SUFDSCxZQUFZLElBQUksT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUVqQztJQUVLLEtBQUssSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBUzNCO0lBRUQsUUFBUSxDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsUUFBUSxDQUFDLEVBQUUsT0FBTyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FFNUQ7SUFFRDs7OztPQUlHO0lBQ0csUUFBUSxJQUFJLE9BQU8sQ0FBQyxVQUFVLENBQUMsQ0FNcEM7SUFFRDs7OztPQUlHO0lBQ0gsUUFBUSxDQUFDLEdBQUcsRUFBRSxNQUFNLEVBQUUsSUFBSSxDQUFDLEVBQUUsUUFBUSxFQUFFLEdBQUcsT0FBTyxDQUFDO1FBQUUsT0FBTyxFQUFFLE1BQU0sQ0FBQTtLQUFFLENBQUMsQ0FNckU7SUFFRCxrRUFBa0U7SUFDbEUsUUFBUSxDQUFDLEdBQUcsRUFBRSxNQUFNLEVBQUUsSUFBSSxDQUFDLEVBQUUsUUFBUSxFQUFFLEdBQUcsT0FBTyxDQUFDLFNBQVMsRUFBRSxDQUFDLENBSTdEO0NBZ0RGIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/sqlite-opfs/store.ts"],"names":[],"mappings":"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"}