@procedures/client 0.2.0 → 0.2.1

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 (236) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +4 -4
  3. package/dist/.tsbuildinfo +1 -1
  4. package/dist/browser.d.ts +1 -1
  5. package/dist/browser.d.ts.map +1 -1
  6. package/dist/browser.js.map +1 -1
  7. package/dist/procedures/invoke.d.ts +6 -1
  8. package/dist/procedures/invoke.d.ts.map +1 -1
  9. package/dist/procedures/invoke.js +2 -2
  10. package/dist/procedures/invoke.js.map +1 -1
  11. package/dist/server/host-policy.d.ts +3 -3
  12. package/dist/server/host-policy.d.ts.map +1 -1
  13. package/dist/server/procedure-server.d.ts +2 -2
  14. package/dist/server/procedure-server.d.ts.map +1 -1
  15. package/dist/server/procedure-server.js.map +1 -1
  16. package/package.json +1 -1
  17. package/src/browser.ts +1 -0
  18. package/src/procedures/invoke.ts +10 -4
  19. package/src/server/host-policy.ts +3 -3
  20. package/src/server/procedure-server.ts +2 -2
  21. package/dist/client/middleware/batching.d.ts +0 -102
  22. package/dist/client/middleware/batching.d.ts.map +0 -1
  23. package/dist/client/middleware/batching.js +0 -245
  24. package/dist/client/middleware/batching.js.map +0 -1
  25. package/dist/collections/async/async-queue.d.ts +0 -144
  26. package/dist/collections/async/async-queue.d.ts.map +0 -1
  27. package/dist/collections/async/async-queue.js +0 -347
  28. package/dist/collections/async/async-queue.js.map +0 -1
  29. package/dist/collections/async/channels.d.ts +0 -188
  30. package/dist/collections/async/channels.d.ts.map +0 -1
  31. package/dist/collections/async/channels.js +0 -312
  32. package/dist/collections/async/channels.js.map +0 -1
  33. package/dist/collections/behaviors/bounded.d.ts +0 -79
  34. package/dist/collections/behaviors/bounded.d.ts.map +0 -1
  35. package/dist/collections/behaviors/bounded.js +0 -384
  36. package/dist/collections/behaviors/bounded.js.map +0 -1
  37. package/dist/collections/behaviors/evented.d.ts +0 -154
  38. package/dist/collections/behaviors/evented.d.ts.map +0 -1
  39. package/dist/collections/behaviors/evented.js +0 -299
  40. package/dist/collections/behaviors/evented.js.map +0 -1
  41. package/dist/collections/behaviors/lru.d.ts +0 -84
  42. package/dist/collections/behaviors/lru.d.ts.map +0 -1
  43. package/dist/collections/behaviors/lru.js +0 -330
  44. package/dist/collections/behaviors/lru.js.map +0 -1
  45. package/dist/collections/behaviors/readonly.d.ts +0 -73
  46. package/dist/collections/behaviors/readonly.d.ts.map +0 -1
  47. package/dist/collections/behaviors/readonly.js +0 -158
  48. package/dist/collections/behaviors/readonly.js.map +0 -1
  49. package/dist/collections/behaviors/safe.d.ts +0 -163
  50. package/dist/collections/behaviors/safe.d.ts.map +0 -1
  51. package/dist/collections/behaviors/safe.js +0 -172
  52. package/dist/collections/behaviors/safe.js.map +0 -1
  53. package/dist/collections/behaviors/synchronized.d.ts +0 -88
  54. package/dist/collections/behaviors/synchronized.d.ts.map +0 -1
  55. package/dist/collections/behaviors/synchronized.js +0 -294
  56. package/dist/collections/behaviors/synchronized.js.map +0 -1
  57. package/dist/collections/behaviors/ttl.d.ts +0 -118
  58. package/dist/collections/behaviors/ttl.d.ts.map +0 -1
  59. package/dist/collections/behaviors/ttl.js +0 -338
  60. package/dist/collections/behaviors/ttl.js.map +0 -1
  61. package/dist/collections/core/effects.d.ts +0 -176
  62. package/dist/collections/core/effects.d.ts.map +0 -1
  63. package/dist/collections/core/effects.js +0 -180
  64. package/dist/collections/core/effects.js.map +0 -1
  65. package/dist/collections/core/events.d.ts +0 -192
  66. package/dist/collections/core/events.d.ts.map +0 -1
  67. package/dist/collections/core/events.js +0 -291
  68. package/dist/collections/core/events.js.map +0 -1
  69. package/dist/collections/core/middleware.d.ts +0 -231
  70. package/dist/collections/core/middleware.d.ts.map +0 -1
  71. package/dist/collections/core/middleware.js +0 -161
  72. package/dist/collections/core/middleware.js.map +0 -1
  73. package/dist/collections/core/policies.d.ts +0 -220
  74. package/dist/collections/core/policies.d.ts.map +0 -1
  75. package/dist/collections/core/policies.js +0 -48
  76. package/dist/collections/core/policies.js.map +0 -1
  77. package/dist/collections/core/traits.d.ts +0 -142
  78. package/dist/collections/core/traits.d.ts.map +0 -1
  79. package/dist/collections/core/traits.js +0 -8
  80. package/dist/collections/core/traits.js.map +0 -1
  81. package/dist/collections/examples.d.ts +0 -13
  82. package/dist/collections/examples.d.ts.map +0 -1
  83. package/dist/collections/examples.js +0 -302
  84. package/dist/collections/examples.js.map +0 -1
  85. package/dist/collections/fx/collectors.d.ts +0 -190
  86. package/dist/collections/fx/collectors.d.ts.map +0 -1
  87. package/dist/collections/fx/collectors.js +0 -369
  88. package/dist/collections/fx/collectors.js.map +0 -1
  89. package/dist/collections/fx/iter.d.ts +0 -166
  90. package/dist/collections/fx/iter.d.ts.map +0 -1
  91. package/dist/collections/fx/iter.js +0 -421
  92. package/dist/collections/fx/iter.js.map +0 -1
  93. package/dist/collections/impl/array-deque.d.ts +0 -107
  94. package/dist/collections/impl/array-deque.d.ts.map +0 -1
  95. package/dist/collections/impl/array-deque.js +0 -381
  96. package/dist/collections/impl/array-deque.js.map +0 -1
  97. package/dist/collections/impl/array-list.d.ts +0 -101
  98. package/dist/collections/impl/array-list.d.ts.map +0 -1
  99. package/dist/collections/impl/array-list.js +0 -387
  100. package/dist/collections/impl/array-list.js.map +0 -1
  101. package/dist/collections/impl/hash-map.d.ts +0 -141
  102. package/dist/collections/impl/hash-map.d.ts.map +0 -1
  103. package/dist/collections/impl/hash-map.js +0 -450
  104. package/dist/collections/impl/hash-map.js.map +0 -1
  105. package/dist/collections/impl/hash-set.d.ts +0 -125
  106. package/dist/collections/impl/hash-set.d.ts.map +0 -1
  107. package/dist/collections/impl/hash-set.js +0 -264
  108. package/dist/collections/impl/hash-set.js.map +0 -1
  109. package/dist/collections/impl/linked-hash-map.d.ts +0 -141
  110. package/dist/collections/impl/linked-hash-map.d.ts.map +0 -1
  111. package/dist/collections/impl/linked-hash-map.js +0 -472
  112. package/dist/collections/impl/linked-hash-map.js.map +0 -1
  113. package/dist/collections/impl/linked-list.d.ts +0 -109
  114. package/dist/collections/impl/linked-list.d.ts.map +0 -1
  115. package/dist/collections/impl/linked-list.js +0 -491
  116. package/dist/collections/impl/linked-list.js.map +0 -1
  117. package/dist/collections/impl/priority-queue.d.ts +0 -134
  118. package/dist/collections/impl/priority-queue.d.ts.map +0 -1
  119. package/dist/collections/impl/priority-queue.js +0 -336
  120. package/dist/collections/impl/priority-queue.js.map +0 -1
  121. package/dist/collections/impl/tree-map.d.ts +0 -146
  122. package/dist/collections/impl/tree-map.d.ts.map +0 -1
  123. package/dist/collections/impl/tree-map.js +0 -781
  124. package/dist/collections/impl/tree-map.js.map +0 -1
  125. package/dist/collections/impl/tree-set.d.ts +0 -112
  126. package/dist/collections/impl/tree-set.d.ts.map +0 -1
  127. package/dist/collections/impl/tree-set.js +0 -374
  128. package/dist/collections/impl/tree-set.js.map +0 -1
  129. package/dist/collections/index.d.ts +0 -105
  130. package/dist/collections/index.d.ts.map +0 -1
  131. package/dist/collections/index.js +0 -135
  132. package/dist/collections/index.js.map +0 -1
  133. package/dist/collections/interfaces/collection.d.ts +0 -119
  134. package/dist/collections/interfaces/collection.d.ts.map +0 -1
  135. package/dist/collections/interfaces/collection.js +0 -8
  136. package/dist/collections/interfaces/collection.js.map +0 -1
  137. package/dist/collections/interfaces/list.d.ts +0 -247
  138. package/dist/collections/interfaces/list.d.ts.map +0 -1
  139. package/dist/collections/interfaces/list.js +0 -8
  140. package/dist/collections/interfaces/list.js.map +0 -1
  141. package/dist/collections/interfaces/map.d.ts +0 -344
  142. package/dist/collections/interfaces/map.d.ts.map +0 -1
  143. package/dist/collections/interfaces/map.js +0 -8
  144. package/dist/collections/interfaces/map.js.map +0 -1
  145. package/dist/collections/interfaces/queue.d.ts +0 -304
  146. package/dist/collections/interfaces/queue.d.ts.map +0 -1
  147. package/dist/collections/interfaces/queue.js +0 -8
  148. package/dist/collections/interfaces/queue.js.map +0 -1
  149. package/dist/collections/interfaces/set.d.ts +0 -137
  150. package/dist/collections/interfaces/set.d.ts.map +0 -1
  151. package/dist/collections/interfaces/set.js +0 -8
  152. package/dist/collections/interfaces/set.js.map +0 -1
  153. package/dist/collections/storage/api.d.ts +0 -109
  154. package/dist/collections/storage/api.d.ts.map +0 -1
  155. package/dist/collections/storage/api.js +0 -182
  156. package/dist/collections/storage/api.js.map +0 -1
  157. package/dist/collections/storage/hybrid.d.ts +0 -164
  158. package/dist/collections/storage/hybrid.d.ts.map +0 -1
  159. package/dist/collections/storage/hybrid.js +0 -416
  160. package/dist/collections/storage/hybrid.js.map +0 -1
  161. package/dist/collections/storage/index.d.ts +0 -16
  162. package/dist/collections/storage/index.d.ts.map +0 -1
  163. package/dist/collections/storage/index.js +0 -13
  164. package/dist/collections/storage/index.js.map +0 -1
  165. package/dist/collections/storage/interface.d.ts +0 -141
  166. package/dist/collections/storage/interface.d.ts.map +0 -1
  167. package/dist/collections/storage/interface.js +0 -23
  168. package/dist/collections/storage/interface.js.map +0 -1
  169. package/dist/collections/storage/memory.d.ts +0 -68
  170. package/dist/collections/storage/memory.d.ts.map +0 -1
  171. package/dist/collections/storage/memory.js +0 -154
  172. package/dist/collections/storage/memory.js.map +0 -1
  173. package/dist/collections/utils/defaults.d.ts +0 -135
  174. package/dist/collections/utils/defaults.d.ts.map +0 -1
  175. package/dist/collections/utils/defaults.js +0 -322
  176. package/dist/collections/utils/defaults.js.map +0 -1
  177. package/dist/collections/utils/factories.d.ts +0 -144
  178. package/dist/collections/utils/factories.d.ts.map +0 -1
  179. package/dist/collections/utils/factories.js +0 -293
  180. package/dist/collections/utils/factories.js.map +0 -1
  181. package/dist/collections/utils/helpers.d.ts +0 -137
  182. package/dist/collections/utils/helpers.d.ts.map +0 -1
  183. package/dist/collections/utils/helpers.js +0 -221
  184. package/dist/collections/utils/helpers.js.map +0 -1
  185. package/dist/collections.d.ts +0 -12
  186. package/dist/collections.d.ts.map +0 -1
  187. package/dist/collections.js +0 -10
  188. package/dist/collections.js.map +0 -1
  189. package/dist/components/define.d.ts +0 -134
  190. package/dist/components/define.d.ts.map +0 -1
  191. package/dist/components/define.js +0 -486
  192. package/dist/components/define.js.map +0 -1
  193. package/dist/components/index.d.ts +0 -39
  194. package/dist/components/index.d.ts.map +0 -1
  195. package/dist/components/index.js +0 -38
  196. package/dist/components/index.js.map +0 -1
  197. package/dist/components/types.d.ts +0 -264
  198. package/dist/components/types.d.ts.map +0 -1
  199. package/dist/components/types.js +0 -46
  200. package/dist/components/types.js.map +0 -1
  201. package/dist/procedures/storage/adapter.d.ts +0 -148
  202. package/dist/procedures/storage/adapter.d.ts.map +0 -1
  203. package/dist/procedures/storage/adapter.js +0 -214
  204. package/dist/procedures/storage/adapter.js.map +0 -1
  205. package/dist/procedures/storage/api.d.ts +0 -125
  206. package/dist/procedures/storage/api.d.ts.map +0 -1
  207. package/dist/procedures/storage/api.js +0 -220
  208. package/dist/procedures/storage/api.js.map +0 -1
  209. package/dist/procedures/storage/factory.d.ts +0 -134
  210. package/dist/procedures/storage/factory.d.ts.map +0 -1
  211. package/dist/procedures/storage/factory.js +0 -166
  212. package/dist/procedures/storage/factory.js.map +0 -1
  213. package/dist/procedures/storage/hybrid.d.ts +0 -193
  214. package/dist/procedures/storage/hybrid.d.ts.map +0 -1
  215. package/dist/procedures/storage/hybrid.js +0 -519
  216. package/dist/procedures/storage/hybrid.js.map +0 -1
  217. package/dist/procedures/storage/index.d.ts +0 -17
  218. package/dist/procedures/storage/index.d.ts.map +0 -1
  219. package/dist/procedures/storage/index.js +0 -17
  220. package/dist/procedures/storage/index.js.map +0 -1
  221. package/dist/procedures/storage/procedures.d.ts +0 -39
  222. package/dist/procedures/storage/procedures.d.ts.map +0 -1
  223. package/dist/procedures/storage/procedures.js +0 -261
  224. package/dist/procedures/storage/procedures.js.map +0 -1
  225. package/dist/procedures/storage/serialization.d.ts +0 -123
  226. package/dist/procedures/storage/serialization.d.ts.map +0 -1
  227. package/dist/procedures/storage/serialization.js +0 -216
  228. package/dist/procedures/storage/serialization.js.map +0 -1
  229. package/dist/procedures/storage/synced-registry.d.ts +0 -246
  230. package/dist/procedures/storage/synced-registry.d.ts.map +0 -1
  231. package/dist/procedures/storage/synced-registry.js +0 -575
  232. package/dist/procedures/storage/synced-registry.js.map +0 -1
  233. package/dist/procedures/storage/types.d.ts +0 -130
  234. package/dist/procedures/storage/types.d.ts.map +0 -1
  235. package/dist/procedures/storage/types.js +0 -8
  236. package/dist/procedures/storage/types.js.map +0 -1
@@ -1,519 +0,0 @@
1
- /**
2
- * Hybrid Storage Implementation
3
- *
4
- * Combines local cache (InMemoryStorage) with remote persistence (ApiStorage).
5
- * Provides fast local reads with remote backup and sync.
6
- *
7
- * Features:
8
- * - Local cache for fast reads, with a remote read on a miss
9
- * - Write-through or write-back strategies
10
- * - Automatic sync on initialization
11
- * - Conflict resolution
12
- * - Offline operation queue
13
- */
14
- import { InMemoryStorage } from "@mark1russell7/client-collections";
15
- /** The ids that an operation changes ("*" for clear). */
16
- function idsOf(op) {
17
- const data = op.data;
18
- switch (op.type) {
19
- case "set":
20
- case "delete":
21
- return data.id === undefined ? [] : [data.id];
22
- case "setBatch":
23
- return (data.items ?? []).map(([id]) => id);
24
- case "deleteBatch":
25
- return data.ids ?? [];
26
- case "clear":
27
- return ["*"];
28
- }
29
- }
30
- const defaultKeyOf = (item) => {
31
- const id = item?.id;
32
- return typeof id === "string" && id.length > 0 ? id : undefined;
33
- };
34
- /**
35
- * Hybrid storage combining local cache with remote persistence.
36
- *
37
- * @example
38
- * ```typescript
39
- * const client = new Client({
40
- * transport: new HttpTransport({ baseUrl: "https://api.example.com" })
41
- * });
42
- *
43
- * const remote = new ApiStorage(client, { collection: "users" });
44
- * const hybrid = new HybridStorage(remote, {
45
- * writeStrategy: "write-through",
46
- * conflictResolution: "remote",
47
- * syncInterval: 5000
48
- * });
49
- *
50
- * // Fast local reads
51
- * const user = await hybrid.get("123"); // From cache, or from the remote on a miss
52
- *
53
- * // Writes go to both local and remote
54
- * await hybrid.set("123", { name: "John" });
55
- * ```
56
- */
57
- export class HybridStorage {
58
- local;
59
- remote;
60
- options;
61
- offlineOps = [];
62
- syncTimer = null;
63
- isOnline = true;
64
- /** A counter of local writes for each id, so a sync does not restore an older remote value */
65
- writeVersions = new Map();
66
- clearVersion = 0;
67
- /** The running sync: syncs run one at a time */
68
- syncChain = Promise.resolve();
69
- stats = {
70
- cacheHits: 0,
71
- cacheMisses: 0,
72
- syncCount: 0,
73
- conflicts: 0,
74
- };
75
- constructor(remote, options = {}) {
76
- this.local = new InMemoryStorage();
77
- this.remote = remote;
78
- this.options = {
79
- writeStrategy: options.writeStrategy ?? "write-through",
80
- conflictResolution: options.conflictResolution ?? "remote",
81
- ...(options.mergeFn !== undefined && { mergeFn: options.mergeFn }),
82
- keyOf: options.keyOf ?? defaultKeyOf,
83
- syncInterval: options.syncInterval ?? 5000,
84
- syncOnInit: options.syncOnInit ?? true,
85
- maxOfflineOps: options.maxOfflineOps ?? 1000,
86
- offlineQueue: options.offlineQueue ?? true,
87
- };
88
- // Initialize with remote data
89
- if (this.options.syncOnInit) {
90
- this.syncFromRemote().catch((err) => {
91
- console.error("Failed to sync on init:", err);
92
- });
93
- }
94
- // Start periodic sync for write-back mode
95
- if (this.options.writeStrategy === "write-back" &&
96
- this.options.syncInterval > 0) {
97
- this.startPeriodicSync();
98
- }
99
- }
100
- //
101
- // ═══ Read Operations ═══
102
- //
103
- /**
104
- * The local item, or else the remote item (which the cache then keeps). When the remote
105
- * cannot answer, the storage is offline and the result is undefined.
106
- */
107
- async get(id) {
108
- // Try local cache first
109
- const cached = await this.local.get(id);
110
- if (cached !== undefined) {
111
- this.stats.cacheHits++;
112
- return cached;
113
- }
114
- this.stats.cacheMisses++;
115
- // A pending local delete means "no item": do not read it back from the remote
116
- if (this.hasPendingOp(id)) {
117
- return undefined;
118
- }
119
- const version = this.versionOf(id);
120
- try {
121
- const remote = await this.remote.get(id);
122
- this.isOnline = true;
123
- if (remote !== undefined && this.versionOf(id) === version) {
124
- await this.local.set(id, remote);
125
- }
126
- return remote;
127
- }
128
- catch {
129
- this.isOnline = false;
130
- return undefined;
131
- }
132
- }
133
- async getAll() {
134
- // Return local cache
135
- return this.local.getAll();
136
- }
137
- async find(predicate) {
138
- // Search local cache
139
- return this.local.find(predicate);
140
- }
141
- async has(id) {
142
- return this.local.has(id);
143
- }
144
- async size() {
145
- return this.local.size();
146
- }
147
- //
148
- // ═══ Write Operations ═══
149
- //
150
- async set(id, value) {
151
- this.bump(id);
152
- // Always write to local immediately
153
- await this.local.set(id, value);
154
- if (this.options.writeStrategy === "write-through") {
155
- // Write-through: sync to remote immediately
156
- try {
157
- await this.remote.set(id, value);
158
- }
159
- catch (error) {
160
- this.handleRemoteFailure("set", { id, value });
161
- throw error;
162
- }
163
- }
164
- else {
165
- // Write-back: queue for later sync
166
- this.queueOperation({
167
- type: "set",
168
- data: { id, value },
169
- timestamp: Date.now(),
170
- });
171
- }
172
- }
173
- async delete(id) {
174
- this.bump(id);
175
- const existed = await this.local.delete(id);
176
- if (this.options.writeStrategy === "write-through") {
177
- try {
178
- await this.remote.delete(id);
179
- }
180
- catch (error) {
181
- this.handleRemoteFailure("delete", { id });
182
- throw error;
183
- }
184
- }
185
- else {
186
- this.queueOperation({
187
- type: "delete",
188
- data: { id },
189
- timestamp: Date.now(),
190
- });
191
- }
192
- return existed;
193
- }
194
- async clear() {
195
- this.clearVersion++;
196
- await this.local.clear();
197
- if (this.options.writeStrategy === "write-through") {
198
- try {
199
- await this.remote.clear();
200
- }
201
- catch (error) {
202
- this.handleRemoteFailure("clear", {});
203
- throw error;
204
- }
205
- }
206
- else {
207
- this.queueOperation({
208
- type: "clear",
209
- data: {},
210
- timestamp: Date.now(),
211
- });
212
- }
213
- }
214
- //
215
- // ═══ Bulk Operations ═══
216
- //
217
- async setBatch(items) {
218
- for (const [id] of items)
219
- this.bump(id);
220
- await this.local.setBatch(items);
221
- if (this.options.writeStrategy === "write-through") {
222
- try {
223
- await this.remote.setBatch(items);
224
- }
225
- catch (error) {
226
- this.handleRemoteFailure("setBatch", { items });
227
- throw error;
228
- }
229
- }
230
- else {
231
- this.queueOperation({
232
- type: "setBatch",
233
- data: { items },
234
- timestamp: Date.now(),
235
- });
236
- }
237
- }
238
- async deleteBatch(ids) {
239
- for (const id of ids)
240
- this.bump(id);
241
- const deleted = await this.local.deleteBatch(ids);
242
- if (this.options.writeStrategy === "write-through") {
243
- try {
244
- await this.remote.deleteBatch(ids);
245
- }
246
- catch (error) {
247
- this.handleRemoteFailure("deleteBatch", { ids });
248
- throw error;
249
- }
250
- }
251
- else {
252
- this.queueOperation({
253
- type: "deleteBatch",
254
- data: { ids },
255
- timestamp: Date.now(),
256
- });
257
- }
258
- return deleted;
259
- }
260
- getBatch(ids) {
261
- return this.local.getBatch(ids);
262
- }
263
- //
264
- // ═══ Sync Operations ═══
265
- //
266
- /**
267
- * Sync all data from remote to local.
268
- * Handles conflicts according to conflict resolution strategy.
269
- *
270
- * - Each remote item goes into the cache under `keyOf(item)`.
271
- * - A local item that the remote does not have is removed, unless a queued local operation
272
- * changes it (the remote deleted it).
273
- * - An id that a local write changed during the sync keeps the local value: the remote value
274
- * is older.
275
- * - Syncs run one at a time.
276
- */
277
- syncFromRemote() {
278
- return this.serialize(() => this.pullRemote());
279
- }
280
- /**
281
- * Sync all pending offline operations to remote.
282
- * Processes queued operations in order. When one fails, it and the later operations stay in
283
- * the queue: the operations that reached the remote are not sent again.
284
- */
285
- syncToRemote() {
286
- return this.serialize(() => this.pushQueue());
287
- }
288
- /**
289
- * Force a full sync (both directions).
290
- */
291
- async sync() {
292
- await this.syncToRemote();
293
- await this.syncFromRemote();
294
- }
295
- //
296
- // ═══ Lifecycle & Metadata ═══
297
- //
298
- async close() {
299
- // Stop periodic sync
300
- if (this.syncTimer) {
301
- clearInterval(this.syncTimer);
302
- this.syncTimer = null;
303
- }
304
- // Sync pending operations before closing
305
- if (this.offlineOps.length > 0) {
306
- try {
307
- await this.syncToRemote();
308
- }
309
- catch (error) {
310
- console.error("Failed to sync before close:", error);
311
- }
312
- }
313
- // Close remote storage (an ApiStorage leaves the caller's client open)
314
- await this.remote.close();
315
- }
316
- async getMetadata() {
317
- const totalOps = this.stats.cacheHits + this.stats.cacheMisses;
318
- const hitRate = totalOps > 0 ? (this.stats.cacheHits / totalOps) * 100 : 0;
319
- const currentSize = await this.local.size();
320
- return {
321
- type: "hybrid",
322
- size: currentSize,
323
- stats: {
324
- hitRate: Math.round(hitRate * 100) / 100,
325
- cacheHits: this.stats.cacheHits,
326
- cacheMisses: this.stats.cacheMisses,
327
- syncCount: this.stats.syncCount,
328
- conflicts: this.stats.conflicts,
329
- pendingOps: this.offlineOps.length,
330
- isOnline: this.isOnline,
331
- writeStrategy: this.options.writeStrategy,
332
- conflictResolution: this.options.conflictResolution,
333
- },
334
- };
335
- }
336
- //
337
- // ═══ Internal Helpers ═══
338
- //
339
- async pullRemote() {
340
- const versions = new Map(this.writeVersions);
341
- const clearVersion = this.clearVersion;
342
- // True when a local write changed the id after the sync started
343
- const changedLocally = (id) => this.clearVersion !== clearVersion || (this.writeVersions.get(id) ?? 0) !== (versions.get(id) ?? 0);
344
- let remoteData;
345
- try {
346
- remoteData = await this.remote.getAll();
347
- }
348
- catch (error) {
349
- this.isOnline = false;
350
- throw error;
351
- }
352
- const remoteIds = new Set();
353
- for (const item of remoteData) {
354
- const id = this.options.keyOf(item);
355
- if (!id) {
356
- console.warn("Item has no key, skipping:", item);
357
- continue;
358
- }
359
- remoteIds.add(id);
360
- if (changedLocally(id) || this.hasPendingOp(id)) {
361
- continue;
362
- }
363
- const localItem = await this.local.get(id);
364
- if (localItem === undefined) {
365
- // No local version - just store remote
366
- await this.local.set(id, item);
367
- }
368
- else if (JSON.stringify(localItem) !== JSON.stringify(item)) {
369
- // Conflict - resolve according to strategy
370
- const resolved = this.resolveConflict(localItem, item);
371
- await this.local.set(id, resolved);
372
- this.stats.conflicts++;
373
- }
374
- }
375
- // The remote deleted these items
376
- for (const id of await this.localIds()) {
377
- if (!remoteIds.has(id) && !changedLocally(id) && !this.hasPendingOp(id)) {
378
- await this.local.delete(id);
379
- }
380
- }
381
- this.stats.syncCount++;
382
- this.isOnline = true;
383
- }
384
- async pushQueue() {
385
- while (this.offlineOps.length > 0) {
386
- const op = this.offlineOps[0];
387
- try {
388
- await this.executeOperation(op);
389
- }
390
- catch (error) {
391
- // This operation and the later ones stay queued
392
- this.isOnline = false;
393
- throw error;
394
- }
395
- // Remove the operation only after it reached the remote
396
- if (this.offlineOps[0] === op) {
397
- this.offlineOps.shift();
398
- }
399
- }
400
- this.isOnline = true;
401
- }
402
- /** Run syncs one at a time. */
403
- serialize(run) {
404
- const next = this.syncChain.then(run, run);
405
- this.syncChain = next.catch(() => undefined);
406
- return next;
407
- }
408
- async localIds() {
409
- return [...this.local.keys()];
410
- }
411
- bump(id) {
412
- this.writeVersions.set(id, (this.writeVersions.get(id) ?? 0) + 1);
413
- }
414
- versionOf(id) {
415
- return `${this.clearVersion}:${this.writeVersions.get(id) ?? 0}`;
416
- }
417
- hasPendingOp(id) {
418
- return this.offlineOps.some((op) => {
419
- const ids = idsOf(op);
420
- return ids.includes(id) || ids.includes("*");
421
- });
422
- }
423
- /**
424
- * Resolve conflict between local and remote versions.
425
- */
426
- resolveConflict(local, remote) {
427
- switch (this.options.conflictResolution) {
428
- case "local":
429
- return local;
430
- case "remote":
431
- return remote;
432
- case "merge":
433
- if (!this.options.mergeFn) {
434
- throw new Error("Merge function required for conflict resolution strategy 'merge'");
435
- }
436
- return this.options.mergeFn(local, remote);
437
- case "error":
438
- throw new Error(`Conflict detected between local and remote versions`);
439
- default:
440
- return remote;
441
- }
442
- }
443
- /**
444
- * Queue operation for later sync.
445
- */
446
- queueOperation(op) {
447
- if (!this.options.offlineQueue) {
448
- return;
449
- }
450
- this.offlineOps.push(op);
451
- // Enforce max queue size
452
- if (this.offlineOps.length > this.options.maxOfflineOps) {
453
- this.offlineOps.shift(); // Remove oldest
454
- }
455
- }
456
- /**
457
- * Execute a queued operation against remote storage.
458
- */
459
- async executeOperation(op) {
460
- const data = op.data;
461
- switch (op.type) {
462
- case "set":
463
- await this.remote.set(data.id, data.value);
464
- break;
465
- case "delete":
466
- await this.remote.delete(data.id);
467
- break;
468
- case "setBatch":
469
- await this.remote.setBatch(data.items);
470
- break;
471
- case "deleteBatch":
472
- await this.remote.deleteBatch(data.ids);
473
- break;
474
- case "clear":
475
- await this.remote.clear();
476
- break;
477
- }
478
- }
479
- /**
480
- * Handle remote operation failure.
481
- */
482
- handleRemoteFailure(operation, data) {
483
- console.error(`Remote ${operation} failed, marking offline`);
484
- this.isOnline = false;
485
- // Queue operation if offline queue enabled
486
- if (this.options.offlineQueue) {
487
- this.queueOperation({
488
- type: operation,
489
- data,
490
- timestamp: Date.now(),
491
- });
492
- }
493
- }
494
- /**
495
- * Start periodic background sync.
496
- */
497
- startPeriodicSync() {
498
- this.syncTimer = setInterval(() => {
499
- this.syncToRemote().catch((err) => {
500
- console.error("Periodic sync failed:", err);
501
- });
502
- }, this.options.syncInterval);
503
- // The timer must not keep the process alive (deep dive DATA-9)
504
- this.syncTimer.unref?.();
505
- }
506
- /**
507
- * Get current online status.
508
- */
509
- isRemoteOnline() {
510
- return this.isOnline;
511
- }
512
- /**
513
- * Get pending offline operations count.
514
- */
515
- getPendingOpsCount() {
516
- return this.offlineOps.length;
517
- }
518
- }
519
- //# sourceMappingURL=hybrid.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"hybrid.js","sourceRoot":"","sources":["../../../src/procedures/storage/hybrid.ts"],"names":[],"mappings":"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"}
@@ -1,17 +0,0 @@
1
- /**
2
- * Procedure Storage Module
3
- *
4
- * Enables procedure registry to be backed by CollectionStorage.
5
- * Provides persistence, sync, and remote registry capabilities.
6
- */
7
- export type { SerializedProcedure, HandlerReference, HandlerLoader, SyncDirection, ConflictResolution, WriteStrategy, SyncConflict, SyncResult, SyncStatus, SyncedRegistryOptions, ProcedureStorageConfig, } from "./types.js";
8
- export { serializeProcedure, deserializeProcedure, deserializeProcedureSync, getProcedureKey, getSerializedKey, serializeProcedures, deserializeProcedures, createDynamicHandlerLoader, } from "./serialization.js";
9
- export type { SerializeOptions, DeserializeOptions } from "./serialization.js";
10
- export { ProcedureStorageAdapter } from "./adapter.js";
11
- export type { ProcedureStorageAdapterOptions } from "./adapter.js";
12
- export { SyncedProcedureRegistry, getProcedureStore } from "./synced-registry.js";
13
- export type { SyncedRegistrationOptions } from "./synced-registry.js";
14
- export { createSyncedRegistry, createMemorySyncedRegistry, createApiSyncedRegistry, createHybridSyncedRegistry, createCustomSyncedRegistry, } from "./factory.js";
15
- export type { CreateSyncedRegistryConfig } from "./factory.js";
16
- export { procedureRegisterProcedure, procedureStoreProcedure, procedureLoadProcedure, procedureSyncProcedure, procedureRemoteProcedure, procedureStorageModule, procedureStorageProcedures, ProcedureStoreError, } from "./procedures.js";
17
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGtE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}
@@ -1,17 +0,0 @@
1
- /**
2
- * Procedure Storage Module
3
- *
4
- * Enables procedure registry to be backed by CollectionStorage.
5
- * Provides persistence, sync, and remote registry capabilities.
6
- */
7
- // Serialization
8
- export { serializeProcedure, deserializeProcedure, deserializeProcedureSync, getProcedureKey, getSerializedKey, serializeProcedures, deserializeProcedures, createDynamicHandlerLoader, } from "./serialization.js";
9
- // Adapter
10
- export { ProcedureStorageAdapter } from "./adapter.js";
11
- // Synced Registry
12
- export { SyncedProcedureRegistry, getProcedureStore } from "./synced-registry.js";
13
- // Factory
14
- export { createSyncedRegistry, createMemorySyncedRegistry, createApiSyncedRegistry, createHybridSyncedRegistry, createCustomSyncedRegistry, } from "./factory.js";
15
- // Procedures
16
- export { procedureRegisterProcedure, procedureStoreProcedure, procedureLoadProcedure, procedureSyncProcedure, procedureRemoteProcedure, procedureStorageModule, procedureStorageProcedures, ProcedureStoreError, } from "./procedures.js";
17
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,gBAAgB;AAChB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,UAAU;AACV,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGvD,kBAAkB;AAClB,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGlF,UAAU;AACV,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAGtB,aAAa;AACb,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}
@@ -1,39 +0,0 @@
1
- /**
2
- * Procedure Storage Procedures
3
- *
4
- * CLI procedures for managing the procedure registry storage:
5
- * - procedure.register - Register a procedure at runtime
6
- * - procedure.store - Persist a procedure to storage
7
- * - procedure.load - Load procedures from storage
8
- * - procedure.sync - Sync registry with storage
9
- * - procedure.remote - Configure remote connection
10
- *
11
- * The procedures work on the store of the caller's registry: the `SyncedProcedureRegistry`
12
- * that wraps it (`createSyncedRegistry()`). When the registry has no store, they fail with
13
- * the code `NOT_CONFIGURED`. (Before, they reported success and did nothing: deep dive
14
- * CORE-16, DATA-10.)
15
- */
16
- import type { AnyProcedure } from "../types.js";
17
- /** An error of a storage procedure that cannot do its work. */
18
- export declare class ProcedureStoreError extends Error {
19
- readonly name = "ProcedureStoreError";
20
- readonly code: "NOT_CONFIGURED" | "NOT_IMPLEMENTED" | "NO_HANDLER";
21
- constructor(code: "NOT_CONFIGURED" | "NOT_IMPLEMENTED" | "NO_HANDLER", message: string);
22
- }
23
- export declare const procedureRegisterProcedure: AnyProcedure;
24
- export declare const procedureStoreProcedure: AnyProcedure;
25
- export declare const procedureLoadProcedure: AnyProcedure;
26
- export declare const procedureSyncProcedure: AnyProcedure;
27
- export declare const procedureRemoteProcedure: AnyProcedure;
28
- /**
29
- * All procedure storage procedures as a module.
30
- */
31
- export declare const procedureStorageModule: {
32
- name: string;
33
- procedures: AnyProcedure[];
34
- };
35
- /**
36
- * Array of all procedure storage procedures.
37
- */
38
- export declare const procedureStorageProcedures: AnyProcedure[];
39
- //# sourceMappingURL=procedures.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../../../src/procedures/storage/procedures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAmC,MAAM,aAAa,CAAC;AAyBjF,+DAA+D;AAC/D,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAkB,IAAI,yBAAyB;IAC/C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,YAAY,CAAC;IAEnE,YAAY,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,YAAY,EAAE,OAAO,EAAE,MAAM,EAGrF;CACF;AAiDD,eAAO,MAAM,0BAA0B,EAAE,YA6DvC,CAAC;AAqBH,eAAO,MAAM,uBAAuB,EAAE,YAwBpC,CAAC;AAwBH,eAAO,MAAM,sBAAsB,EAAE,YAuCnC,CAAC;AAqBH,eAAO,MAAM,sBAAsB,EAAE,YAmBnC,CAAC;AA0BH,eAAO,MAAM,wBAAwB,EAAE,YA4CrC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,IAAI;IACJ,UAAU,EAML,YAAY,EAAE;CACpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,YAAY,EAAsC,CAAC"}