@spooky-sync/core 0.0.1-canary.240 → 0.0.1-canary.242

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 (292) hide show
  1. package/AGENTS.md +34 -15
  2. package/README.md +56 -16
  3. package/dist/index.d.ts +1136 -1846
  4. package/dist/index.js +10168 -11267
  5. package/dist/sqlite-open.js +10 -1
  6. package/dist/types.d.ts +22 -79
  7. package/package.json +8 -4
  8. package/skills/sp00ky-core/SKILL.md +18 -0
  9. package/src/boot/auth-flip.saga.test.ts +82 -0
  10. package/src/boot/auth-flip.saga.ts +62 -0
  11. package/src/boot/boot.saga.test.ts +151 -0
  12. package/src/boot/boot.saga.ts +128 -0
  13. package/src/boot/bucket-switch.saga.test.ts +158 -0
  14. package/src/boot/bucket-switch.saga.ts +115 -0
  15. package/src/boot/preload.saga.test.ts +51 -0
  16. package/src/boot/preload.saga.ts +31 -0
  17. package/src/client/bucket-handle.test.ts +117 -0
  18. package/src/client/bucket-handle.ts +227 -0
  19. package/src/client/router.test.ts +56 -0
  20. package/src/client/router.ts +94 -0
  21. package/src/client/runtime.test.ts +192 -0
  22. package/src/client/runtime.ts +296 -0
  23. package/src/client/services.ts +349 -0
  24. package/src/client/sp00ky-client.test.ts +241 -0
  25. package/src/client/sp00ky-client.ts +482 -0
  26. package/src/index.ts +1 -0
  27. package/src/kernel/constants.test.ts +19 -0
  28. package/src/kernel/constants.ts +54 -0
  29. package/src/kernel/effects.test.ts +40 -0
  30. package/src/kernel/effects.ts +159 -0
  31. package/src/kernel/events.ts +55 -0
  32. package/src/kernel/interpreter.test.ts +116 -0
  33. package/src/kernel/interpreter.ts +143 -0
  34. package/src/kernel/saga.test.ts +89 -0
  35. package/src/kernel/saga.ts +73 -0
  36. package/src/modules/app-release/index.ts +13 -5
  37. package/src/modules/devtools/index.ts +10 -3
  38. package/src/modules/devtools/state-shape.test.ts +4 -1
  39. package/src/modules/feature-flag/index.ts +13 -5
  40. package/src/mutation/jobs.test.ts +25 -0
  41. package/src/mutation/jobs.ts +41 -0
  42. package/src/{modules/data → mutation}/mutation-id.test.ts +12 -0
  43. package/src/mutation/push.saga.test.ts +285 -0
  44. package/src/mutation/push.saga.ts +215 -0
  45. package/src/mutation/rows.test.ts +201 -0
  46. package/src/mutation/rows.ts +377 -0
  47. package/src/mutation/tray.saga.test.ts +63 -0
  48. package/src/mutation/tray.saga.ts +48 -0
  49. package/src/mutation/write.saga.test.ts +163 -0
  50. package/src/mutation/write.saga.ts +166 -0
  51. package/src/query/env.test.ts +23 -0
  52. package/src/query/env.ts +56 -0
  53. package/src/query/fetch.saga.test.ts +156 -0
  54. package/src/query/fetch.saga.ts +109 -0
  55. package/src/query/hash.test.ts +14 -0
  56. package/src/query/hash.ts +18 -0
  57. package/src/{modules/data → query}/id-set-plan.test.ts +12 -2
  58. package/src/query/lifecycle.saga.test.ts +122 -0
  59. package/src/query/lifecycle.saga.ts +101 -0
  60. package/src/query/materialize.saga.test.ts +82 -0
  61. package/src/query/materialize.saga.ts +75 -0
  62. package/src/query/materialize.test.ts +50 -0
  63. package/src/query/materialize.ts +44 -0
  64. package/src/query/membership.saga.test.ts +246 -0
  65. package/src/query/membership.saga.ts +208 -0
  66. package/src/query/membership.test.ts +118 -0
  67. package/src/query/membership.ts +158 -0
  68. package/src/query/register.saga.test.ts +251 -0
  69. package/src/query/register.saga.ts +190 -0
  70. package/src/query/render-set.test.ts +36 -0
  71. package/src/query/render-set.ts +60 -0
  72. package/src/query/sql.test.ts +62 -0
  73. package/src/query/sql.ts +79 -0
  74. package/src/{modules/data → query}/window-query.test.ts +18 -0
  75. package/src/{modules/data → query}/window-query.ts +2 -1
  76. package/src/services/database/connection-supervisor.test.ts +29 -0
  77. package/src/services/database/connection-supervisor.ts +7 -0
  78. package/src/services/database/database.responses.test.ts +43 -0
  79. package/src/services/database/database.ts +25 -10
  80. package/src/services/database/local-migrator.ts +2 -2
  81. package/src/services/database/plan-render.test.ts +1 -1
  82. package/src/services/database/sqlite-cache-engine.test.ts +4 -3
  83. package/src/services/database/sqlite-cache-engine.ts +2 -11
  84. package/src/services/database/sqlite-devtools-queries.integration.test.ts +1 -1
  85. package/src/services/database/sqlite-plan-sql.ts +16 -1
  86. package/src/services/database/sqlite-projection.test.ts +25 -3
  87. package/src/services/tabs/protocol.ts +7 -3
  88. package/src/sp00ky.ts +5 -1854
  89. package/src/state/client-state.ts +184 -0
  90. package/src/state/lifecycle.test.ts +118 -0
  91. package/src/state/lifecycle.ts +86 -0
  92. package/src/state/reducers.test.ts +280 -0
  93. package/src/state/reducers.ts +476 -0
  94. package/src/state/selectors.test.ts +149 -0
  95. package/src/state/selectors.ts +184 -0
  96. package/src/sync/connection.saga.test.ts +86 -0
  97. package/src/sync/connection.saga.ts +85 -0
  98. package/src/sync/live.saga.test.ts +69 -0
  99. package/src/sync/live.saga.ts +49 -0
  100. package/src/sync/policy.health.test.ts +56 -0
  101. package/src/{modules/sync/utils.test.ts → sync/policy.test.ts} +31 -3
  102. package/src/{modules/sync/utils.ts → sync/policy.ts} +67 -5
  103. package/src/sync/poll.saga.test.ts +51 -0
  104. package/src/sync/poll.saga.ts +36 -0
  105. package/src/sync/tabs.saga.test.ts +74 -0
  106. package/src/sync/tabs.saga.ts +92 -0
  107. package/src/testing/adapters.ts +133 -0
  108. package/src/testing/build.ts +61 -0
  109. package/src/testing/fake-services.ts +34 -0
  110. package/src/testing/run-pure.test.ts +92 -0
  111. package/src/testing/run-pure.ts +128 -0
  112. package/src/testing/services.ts +17 -0
  113. package/src/types.ts +8 -7
  114. package/src/utils/utils.test.ts +2 -1
  115. package/vitest.config.ts +48 -0
  116. package/coverage/lcov-report/base.css +0 -224
  117. package/coverage/lcov-report/block-navigation.js +0 -87
  118. package/coverage/lcov-report/favicon.png +0 -0
  119. package/coverage/lcov-report/index.html +0 -476
  120. package/coverage/lcov-report/prettify.css +0 -1
  121. package/coverage/lcov-report/prettify.js +0 -2
  122. package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  123. package/coverage/lcov-report/sorter.js +0 -210
  124. package/coverage/lcov-report/src/boot/auth-flip.saga.ts.html +0 -271
  125. package/coverage/lcov-report/src/boot/boot.saga.ts.html +0 -469
  126. package/coverage/lcov-report/src/boot/bucket-switch.saga.ts.html +0 -430
  127. package/coverage/lcov-report/src/boot/index.html +0 -161
  128. package/coverage/lcov-report/src/boot/preload.saga.ts.html +0 -178
  129. package/coverage/lcov-report/src/client/bucket-handle.ts.html +0 -766
  130. package/coverage/lcov-report/src/client/index.html +0 -161
  131. package/coverage/lcov-report/src/client/router.ts.html +0 -367
  132. package/coverage/lcov-report/src/client/runtime.ts.html +0 -940
  133. package/coverage/lcov-report/src/client/sp00ky-client.ts.html +0 -1531
  134. package/coverage/lcov-report/src/events/index.html +0 -116
  135. package/coverage/lcov-report/src/events/index.ts.html +0 -877
  136. package/coverage/lcov-report/src/index.html +0 -146
  137. package/coverage/lcov-report/src/index.ts.html +0 -202
  138. package/coverage/lcov-report/src/kernel/constants.ts.html +0 -247
  139. package/coverage/lcov-report/src/kernel/effects.ts.html +0 -562
  140. package/coverage/lcov-report/src/kernel/events.ts.html +0 -250
  141. package/coverage/lcov-report/src/kernel/index.html +0 -176
  142. package/coverage/lcov-report/src/kernel/interpreter.ts.html +0 -514
  143. package/coverage/lcov-report/src/kernel/saga.ts.html +0 -304
  144. package/coverage/lcov-report/src/modules/app-release/index.html +0 -116
  145. package/coverage/lcov-report/src/modules/app-release/index.ts.html +0 -712
  146. package/coverage/lcov-report/src/modules/auth/events/index.html +0 -116
  147. package/coverage/lcov-report/src/modules/auth/events/index.ts.html +0 -142
  148. package/coverage/lcov-report/src/modules/auth/index.html +0 -116
  149. package/coverage/lcov-report/src/modules/auth/index.ts.html +0 -1225
  150. package/coverage/lcov-report/src/modules/crdt/crdt-field.ts.html +0 -967
  151. package/coverage/lcov-report/src/modules/crdt/index.html +0 -146
  152. package/coverage/lcov-report/src/modules/crdt/index.ts.html +0 -1474
  153. package/coverage/lcov-report/src/modules/crdt/loro-loader.ts.html +0 -160
  154. package/coverage/lcov-report/src/modules/devtools/flags.ts.html +0 -1132
  155. package/coverage/lcov-report/src/modules/devtools/index.html +0 -161
  156. package/coverage/lcov-report/src/modules/devtools/index.ts.html +0 -2413
  157. package/coverage/lcov-report/src/modules/devtools/storage-info.ts.html +0 -589
  158. package/coverage/lcov-report/src/modules/devtools/versions.ts.html +0 -415
  159. package/coverage/lcov-report/src/modules/feature-flag/index.html +0 -116
  160. package/coverage/lcov-report/src/modules/feature-flag/index.ts.html +0 -1033
  161. package/coverage/lcov-report/src/modules/index.html +0 -116
  162. package/coverage/lcov-report/src/modules/ref-tables.ts.html +0 -349
  163. package/coverage/lcov-report/src/mutation/index.html +0 -191
  164. package/coverage/lcov-report/src/mutation/jobs.ts.html +0 -208
  165. package/coverage/lcov-report/src/mutation/mutation-id.ts.html +0 -190
  166. package/coverage/lcov-report/src/mutation/push.saga.ts.html +0 -730
  167. package/coverage/lcov-report/src/mutation/rows.ts.html +0 -1216
  168. package/coverage/lcov-report/src/mutation/tray.saga.ts.html +0 -229
  169. package/coverage/lcov-report/src/mutation/write.saga.ts.html +0 -583
  170. package/coverage/lcov-report/src/otel/index.html +0 -116
  171. package/coverage/lcov-report/src/otel/index.ts.html +0 -466
  172. package/coverage/lcov-report/src/query/env.ts.html +0 -253
  173. package/coverage/lcov-report/src/query/fetch.saga.ts.html +0 -412
  174. package/coverage/lcov-report/src/query/hash.ts.html +0 -139
  175. package/coverage/lcov-report/src/query/index.html +0 -281
  176. package/coverage/lcov-report/src/query/lifecycle.saga.ts.html +0 -388
  177. package/coverage/lcov-report/src/query/materialize.saga.ts.html +0 -310
  178. package/coverage/lcov-report/src/query/materialize.ts.html +0 -217
  179. package/coverage/lcov-report/src/query/membership.saga.ts.html +0 -709
  180. package/coverage/lcov-report/src/query/membership.ts.html +0 -559
  181. package/coverage/lcov-report/src/query/register.saga.ts.html +0 -655
  182. package/coverage/lcov-report/src/query/render-set.ts.html +0 -265
  183. package/coverage/lcov-report/src/query/sql.ts.html +0 -322
  184. package/coverage/lcov-report/src/query/window-query.ts.html +0 -670
  185. package/coverage/lcov-report/src/services/blobs/blob-cache.ts.html +0 -1894
  186. package/coverage/lcov-report/src/services/blobs/blob-manifest.ts.html +0 -766
  187. package/coverage/lcov-report/src/services/blobs/blob-store.ts.html +0 -1162
  188. package/coverage/lcov-report/src/services/blobs/index.html +0 -161
  189. package/coverage/lcov-report/src/services/blobs/index.ts.html +0 -295
  190. package/coverage/lcov-report/src/services/database/cache-engine.ts.html +0 -664
  191. package/coverage/lcov-report/src/services/database/connection-supervisor.ts.html +0 -1330
  192. package/coverage/lcov-report/src/services/database/database.ts.html +0 -658
  193. package/coverage/lcov-report/src/services/database/engine-factory.ts.html +0 -184
  194. package/coverage/lcov-report/src/services/database/errors.ts.html +0 -187
  195. package/coverage/lcov-report/src/services/database/events/index.html +0 -116
  196. package/coverage/lcov-report/src/services/database/events/index.ts.html +0 -184
  197. package/coverage/lcov-report/src/services/database/index.html +0 -386
  198. package/coverage/lcov-report/src/services/database/index.ts.html +0 -121
  199. package/coverage/lcov-report/src/services/database/local-migrator.ts.html +0 -703
  200. package/coverage/lcov-report/src/services/database/local.ts.html +0 -1633
  201. package/coverage/lcov-report/src/services/database/plan-render.ts.html +0 -409
  202. package/coverage/lcov-report/src/services/database/relation-resolver.ts.html +0 -682
  203. package/coverage/lcov-report/src/services/database/remote.ts.html +0 -1036
  204. package/coverage/lcov-report/src/services/database/sqlite-cache-engine.ts.html +0 -4132
  205. package/coverage/lcov-report/src/services/database/sqlite-lock-verify.ts.html +0 -220
  206. package/coverage/lcov-report/src/services/database/sqlite-open.ts.html +0 -577
  207. package/coverage/lcov-report/src/services/database/sqlite-plan-sql.ts.html +0 -499
  208. package/coverage/lcov-report/src/services/database/sqlite-select.ts.html +0 -478
  209. package/coverage/lcov-report/src/services/database/sqlite-transport.ts.html +0 -757
  210. package/coverage/lcov-report/src/services/database/surql-translate.ts.html +0 -1333
  211. package/coverage/lcov-report/src/services/database/surreal-cache-engine.ts.html +0 -568
  212. package/coverage/lcov-report/src/services/logger/index.html +0 -116
  213. package/coverage/lcov-report/src/services/logger/index.ts.html +0 -154
  214. package/coverage/lcov-report/src/services/persistence/index.html +0 -146
  215. package/coverage/lcov-report/src/services/persistence/localstorage.ts.html +0 -163
  216. package/coverage/lcov-report/src/services/persistence/resilient.ts.html +0 -208
  217. package/coverage/lcov-report/src/services/persistence/surrealdb.ts.html +0 -271
  218. package/coverage/lcov-report/src/services/stream-processor/index.html +0 -146
  219. package/coverage/lcov-report/src/services/stream-processor/index.ts.html +0 -3313
  220. package/coverage/lcov-report/src/services/stream-processor/permissions.ts.html +0 -244
  221. package/coverage/lcov-report/src/services/stream-processor/wasm-types.ts.html +0 -346
  222. package/coverage/lcov-report/src/services/tabs/broker-client.ts.html +0 -934
  223. package/coverage/lcov-report/src/services/tabs/coordinator.ts.html +0 -1984
  224. package/coverage/lcov-report/src/services/tabs/index.html +0 -191
  225. package/coverage/lcov-report/src/services/tabs/leader-locks.ts.html +0 -310
  226. package/coverage/lcov-report/src/services/tabs/protocol.ts.html +0 -871
  227. package/coverage/lcov-report/src/services/tabs/support.ts.html +0 -193
  228. package/coverage/lcov-report/src/services/tabs/tabs-broker-worker.ts.html +0 -2005
  229. package/coverage/lcov-report/src/sp00ky.ts.html +0 -100
  230. package/coverage/lcov-report/src/state/client-state.ts.html +0 -637
  231. package/coverage/lcov-report/src/state/index.html +0 -161
  232. package/coverage/lcov-report/src/state/lifecycle.ts.html +0 -343
  233. package/coverage/lcov-report/src/state/reducers.ts.html +0 -1471
  234. package/coverage/lcov-report/src/state/selectors.ts.html +0 -637
  235. package/coverage/lcov-report/src/sync/connection.saga.ts.html +0 -343
  236. package/coverage/lcov-report/src/sync/index.html +0 -176
  237. package/coverage/lcov-report/src/sync/live.saga.ts.html +0 -232
  238. package/coverage/lcov-report/src/sync/policy.ts.html +0 -1606
  239. package/coverage/lcov-report/src/sync/poll.saga.ts.html +0 -193
  240. package/coverage/lcov-report/src/sync/tabs.saga.ts.html +0 -361
  241. package/coverage/lcov-report/src/types.ts.html +0 -2419
  242. package/coverage/lcov-report/src/utils/blurhash.ts.html +0 -355
  243. package/coverage/lcov-report/src/utils/error-classification.ts.html +0 -244
  244. package/coverage/lcov-report/src/utils/index.html +0 -191
  245. package/coverage/lcov-report/src/utils/index.ts.html +0 -820
  246. package/coverage/lcov-report/src/utils/parser.ts.html +0 -313
  247. package/coverage/lcov-report/src/utils/semver.ts.html +0 -175
  248. package/coverage/lcov-report/src/utils/surql.ts.html +0 -667
  249. package/coverage/lcov.info +0 -19079
  250. package/src/modules/cache/cache.relay.test.ts +0 -95
  251. package/src/modules/cache/index.ts +0 -361
  252. package/src/modules/cache/types.ts +0 -19
  253. package/src/modules/data/data.activity.test.ts +0 -109
  254. package/src/modules/data/data.authority.test.ts +0 -122
  255. package/src/modules/data/data.heartbeat-wake.test.ts +0 -115
  256. package/src/modules/data/data.hydration.test.ts +0 -142
  257. package/src/modules/data/data.membership.test.ts +0 -623
  258. package/src/modules/data/data.notify-table.test.ts +0 -41
  259. package/src/modules/data/data.pending-ids.test.ts +0 -199
  260. package/src/modules/data/data.rebind.test.ts +0 -170
  261. package/src/modules/data/data.rematerialize.test.ts +0 -114
  262. package/src/modules/data/data.run.test.ts +0 -113
  263. package/src/modules/data/data.settled-writes.test.ts +0 -235
  264. package/src/modules/data/data.status.test.ts +0 -249
  265. package/src/modules/data/data.test.ts +0 -58
  266. package/src/modules/data/index.ts +0 -2745
  267. package/src/modules/sync/engine.ts +0 -250
  268. package/src/modules/sync/events/index.ts +0 -84
  269. package/src/modules/sync/index.ts +0 -3
  270. package/src/modules/sync/queue/index.ts +0 -2
  271. package/src/modules/sync/queue/queue-down.test.ts +0 -228
  272. package/src/modules/sync/queue/queue-down.ts +0 -184
  273. package/src/modules/sync/queue/queue-up.forwarded.test.ts +0 -164
  274. package/src/modules/sync/queue/queue-up.ts +0 -407
  275. package/src/modules/sync/scheduler.pause.test.ts +0 -109
  276. package/src/modules/sync/scheduler.retry.test.ts +0 -237
  277. package/src/modules/sync/scheduler.ts +0 -286
  278. package/src/modules/sync/sync.cleanup.test.ts +0 -116
  279. package/src/modules/sync/sync.health.test.ts +0 -167
  280. package/src/modules/sync/sync.heartbeat.test.ts +0 -80
  281. package/src/modules/sync/sync.list-ref-meta.test.ts +0 -193
  282. package/src/modules/sync/sync.live-removal.test.ts +0 -289
  283. package/src/modules/sync/sync.reconnect.test.ts +0 -145
  284. package/src/modules/sync/sync.rematerialize-after-fetch.test.ts +0 -93
  285. package/src/modules/sync/sync.settled-poll.test.ts +0 -58
  286. package/src/modules/sync/sync.subquery.test.ts +0 -82
  287. package/src/modules/sync/sync.tabs.test.ts +0 -249
  288. package/src/modules/sync/sync.ts +0 -2626
  289. package/src/sp00ky.auth-order.test.ts +0 -112
  290. package/src/sp00ky.init-query.test.ts +0 -183
  291. package/src/sp00ky.local-first.test.ts +0 -60
  292. /package/src/{modules/data → mutation}/mutation-id.ts +0 -0
package/coverage/lcov-report/src/services/database/plan-render.ts.html DELETED
@@ -1,409 +0,0 @@
1
-
2
- <!doctype html>
3
- <html lang="en">
4
-
5
- <head>
6
- <title>Code coverage report for src/services/database/plan-render.ts</title>
7
- <meta charset="utf-8" />
8
- <link rel="stylesheet" href="../../../prettify.css" />
9
- <link rel="stylesheet" href="../../../base.css" />
10
- <link rel="shortcut icon" type="image/x-icon" href="../../../favicon.png" />
11
- <meta name="viewport" content="width=device-width, initial-scale=1" />
12
- <style type='text/css'>
13
- .coverage-summary .sorter {
14
- background-image: url(../../../sort-arrow-sprite.png);
15
- }
16
- </style>
17
- </head>
18
-
19
- <body>
20
- <div class='wrapper'>
21
- <div class='pad1'>
22
- <h1><a href="../../../index.html">All files</a> / <a href="index.html">src/services/database</a> plan-render.ts</h1>
23
- <div class='clearfix'>
24
-
25
- <div class='fl pad1y space-right2'>
26
- <span class="strong">100% </span>
27
- <span class="quiet">Statements</span>
28
- <span class='fraction'>53/53</span>
29
- </div>
30
-
31
-
32
- <div class='fl pad1y space-right2'>
33
- <span class="strong">93.75% </span>
34
- <span class="quiet">Branches</span>
35
- <span class='fraction'>30/32</span>
36
- </div>
37
-
38
-
39
- <div class='fl pad1y space-right2'>
40
- <span class="strong">100% </span>
41
- <span class="quiet">Functions</span>
42
- <span class='fraction'>6/6</span>
43
- </div>
44
-
45
-
46
- <div class='fl pad1y space-right2'>
47
- <span class="strong">100% </span>
48
- <span class="quiet">Lines</span>
49
- <span class='fraction'>53/53</span>
50
- </div>
51
-
52
-
53
- </div>
54
- <p class="quiet">
55
- Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
56
- </p>
57
- <template id="filterTemplate">
58
- <div class="quiet">
59
- Filter:
60
- <input type="search" id="fileSearch">
61
- </div>
62
- </template>
63
- </div>
64
- <div class='status-line high'></div>
65
- <pre><table class="coverage">
66
- <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
67
- <a name='L2'></a><a href='#L2'>2</a>
68
- <a name='L3'></a><a href='#L3'>3</a>
69
- <a name='L4'></a><a href='#L4'>4</a>
70
- <a name='L5'></a><a href='#L5'>5</a>
71
- <a name='L6'></a><a href='#L6'>6</a>
72
- <a name='L7'></a><a href='#L7'>7</a>
73
- <a name='L8'></a><a href='#L8'>8</a>
74
- <a name='L9'></a><a href='#L9'>9</a>
75
- <a name='L10'></a><a href='#L10'>10</a>
76
- <a name='L11'></a><a href='#L11'>11</a>
77
- <a name='L12'></a><a href='#L12'>12</a>
78
- <a name='L13'></a><a href='#L13'>13</a>
79
- <a name='L14'></a><a href='#L14'>14</a>
80
- <a name='L15'></a><a href='#L15'>15</a>
81
- <a name='L16'></a><a href='#L16'>16</a>
82
- <a name='L17'></a><a href='#L17'>17</a>
83
- <a name='L18'></a><a href='#L18'>18</a>
84
- <a name='L19'></a><a href='#L19'>19</a>
85
- <a name='L20'></a><a href='#L20'>20</a>
86
- <a name='L21'></a><a href='#L21'>21</a>
87
- <a name='L22'></a><a href='#L22'>22</a>
88
- <a name='L23'></a><a href='#L23'>23</a>
89
- <a name='L24'></a><a href='#L24'>24</a>
90
- <a name='L25'></a><a href='#L25'>25</a>
91
- <a name='L26'></a><a href='#L26'>26</a>
92
- <a name='L27'></a><a href='#L27'>27</a>
93
- <a name='L28'></a><a href='#L28'>28</a>
94
- <a name='L29'></a><a href='#L29'>29</a>
95
- <a name='L30'></a><a href='#L30'>30</a>
96
- <a name='L31'></a><a href='#L31'>31</a>
97
- <a name='L32'></a><a href='#L32'>32</a>
98
- <a name='L33'></a><a href='#L33'>33</a>
99
- <a name='L34'></a><a href='#L34'>34</a>
100
- <a name='L35'></a><a href='#L35'>35</a>
101
- <a name='L36'></a><a href='#L36'>36</a>
102
- <a name='L37'></a><a href='#L37'>37</a>
103
- <a name='L38'></a><a href='#L38'>38</a>
104
- <a name='L39'></a><a href='#L39'>39</a>
105
- <a name='L40'></a><a href='#L40'>40</a>
106
- <a name='L41'></a><a href='#L41'>41</a>
107
- <a name='L42'></a><a href='#L42'>42</a>
108
- <a name='L43'></a><a href='#L43'>43</a>
109
- <a name='L44'></a><a href='#L44'>44</a>
110
- <a name='L45'></a><a href='#L45'>45</a>
111
- <a name='L46'></a><a href='#L46'>46</a>
112
- <a name='L47'></a><a href='#L47'>47</a>
113
- <a name='L48'></a><a href='#L48'>48</a>
114
- <a name='L49'></a><a href='#L49'>49</a>
115
- <a name='L50'></a><a href='#L50'>50</a>
116
- <a name='L51'></a><a href='#L51'>51</a>
117
- <a name='L52'></a><a href='#L52'>52</a>
118
- <a name='L53'></a><a href='#L53'>53</a>
119
- <a name='L54'></a><a href='#L54'>54</a>
120
- <a name='L55'></a><a href='#L55'>55</a>
121
- <a name='L56'></a><a href='#L56'>56</a>
122
- <a name='L57'></a><a href='#L57'>57</a>
123
- <a name='L58'></a><a href='#L58'>58</a>
124
- <a name='L59'></a><a href='#L59'>59</a>
125
- <a name='L60'></a><a href='#L60'>60</a>
126
- <a name='L61'></a><a href='#L61'>61</a>
127
- <a name='L62'></a><a href='#L62'>62</a>
128
- <a name='L63'></a><a href='#L63'>63</a>
129
- <a name='L64'></a><a href='#L64'>64</a>
130
- <a name='L65'></a><a href='#L65'>65</a>
131
- <a name='L66'></a><a href='#L66'>66</a>
132
- <a name='L67'></a><a href='#L67'>67</a>
133
- <a name='L68'></a><a href='#L68'>68</a>
134
- <a name='L69'></a><a href='#L69'>69</a>
135
- <a name='L70'></a><a href='#L70'>70</a>
136
- <a name='L71'></a><a href='#L71'>71</a>
137
- <a name='L72'></a><a href='#L72'>72</a>
138
- <a name='L73'></a><a href='#L73'>73</a>
139
- <a name='L74'></a><a href='#L74'>74</a>
140
- <a name='L75'></a><a href='#L75'>75</a>
141
- <a name='L76'></a><a href='#L76'>76</a>
142
- <a name='L77'></a><a href='#L77'>77</a>
143
- <a name='L78'></a><a href='#L78'>78</a>
144
- <a name='L79'></a><a href='#L79'>79</a>
145
- <a name='L80'></a><a href='#L80'>80</a>
146
- <a name='L81'></a><a href='#L81'>81</a>
147
- <a name='L82'></a><a href='#L82'>82</a>
148
- <a name='L83'></a><a href='#L83'>83</a>
149
- <a name='L84'></a><a href='#L84'>84</a>
150
- <a name='L85'></a><a href='#L85'>85</a>
151
- <a name='L86'></a><a href='#L86'>86</a>
152
- <a name='L87'></a><a href='#L87'>87</a>
153
- <a name='L88'></a><a href='#L88'>88</a>
154
- <a name='L89'></a><a href='#L89'>89</a>
155
- <a name='L90'></a><a href='#L90'>90</a>
156
- <a name='L91'></a><a href='#L91'>91</a>
157
- <a name='L92'></a><a href='#L92'>92</a>
158
- <a name='L93'></a><a href='#L93'>93</a>
159
- <a name='L94'></a><a href='#L94'>94</a>
160
- <a name='L95'></a><a href='#L95'>95</a>
161
- <a name='L96'></a><a href='#L96'>96</a>
162
- <a name='L97'></a><a href='#L97'>97</a>
163
- <a name='L98'></a><a href='#L98'>98</a>
164
- <a name='L99'></a><a href='#L99'>99</a>
165
- <a name='L100'></a><a href='#L100'>100</a>
166
- <a name='L101'></a><a href='#L101'>101</a>
167
- <a name='L102'></a><a href='#L102'>102</a>
168
- <a name='L103'></a><a href='#L103'>103</a>
169
- <a name='L104'></a><a href='#L104'>104</a>
170
- <a name='L105'></a><a href='#L105'>105</a>
171
- <a name='L106'></a><a href='#L106'>106</a>
172
- <a name='L107'></a><a href='#L107'>107</a>
173
- <a name='L108'></a><a href='#L108'>108</a>
174
- <a name='L109'></a><a href='#L109'>109</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
175
- <span class="cline-any cline-neutral">&nbsp;</span>
176
- <span class="cline-any cline-neutral">&nbsp;</span>
177
- <span class="cline-any cline-neutral">&nbsp;</span>
178
- <span class="cline-any cline-neutral">&nbsp;</span>
179
- <span class="cline-any cline-neutral">&nbsp;</span>
180
- <span class="cline-any cline-neutral">&nbsp;</span>
181
- <span class="cline-any cline-neutral">&nbsp;</span>
182
- <span class="cline-any cline-neutral">&nbsp;</span>
183
- <span class="cline-any cline-neutral">&nbsp;</span>
184
- <span class="cline-any cline-neutral">&nbsp;</span>
185
- <span class="cline-any cline-neutral">&nbsp;</span>
186
- <span class="cline-any cline-neutral">&nbsp;</span>
187
- <span class="cline-any cline-neutral">&nbsp;</span>
188
- <span class="cline-any cline-neutral">&nbsp;</span>
189
- <span class="cline-any cline-neutral">&nbsp;</span>
190
- <span class="cline-any cline-neutral">&nbsp;</span>
191
- <span class="cline-any cline-neutral">&nbsp;</span>
192
- <span class="cline-any cline-neutral">&nbsp;</span>
193
- <span class="cline-any cline-neutral">&nbsp;</span>
194
- <span class="cline-any cline-neutral">&nbsp;</span>
195
- <span class="cline-any cline-yes">11x</span>
196
- <span class="cline-any cline-yes">11x</span>
197
- <span class="cline-any cline-yes">11x</span>
198
- <span class="cline-any cline-yes">11x</span>
199
- <span class="cline-any cline-yes">11x</span>
200
- <span class="cline-any cline-neutral">&nbsp;</span>
201
- <span class="cline-any cline-yes">14x</span>
202
- <span class="cline-any cline-neutral">&nbsp;</span>
203
- <span class="cline-any cline-neutral">&nbsp;</span>
204
- <span class="cline-any cline-neutral">&nbsp;</span>
205
- <span class="cline-any cline-neutral">&nbsp;</span>
206
- <span class="cline-any cline-neutral">&nbsp;</span>
207
- <span class="cline-any cline-yes">14x</span>
208
- <span class="cline-any cline-yes">14x</span>
209
- <span class="cline-any cline-yes">4x</span>
210
- <span class="cline-any cline-yes">14x</span>
211
- <span class="cline-any cline-neutral">&nbsp;</span>
212
- <span class="cline-any cline-neutral">&nbsp;</span>
213
- <span class="cline-any cline-neutral">&nbsp;</span>
214
- <span class="cline-any cline-neutral">&nbsp;</span>
215
- <span class="cline-any cline-neutral">&nbsp;</span>
216
- <span class="cline-any cline-neutral">&nbsp;</span>
217
- <span class="cline-any cline-neutral">&nbsp;</span>
218
- <span class="cline-any cline-yes">14x</span>
219
- <span class="cline-any cline-yes">14x</span>
220
- <span class="cline-any cline-yes">14x</span>
221
- <span class="cline-any cline-yes">14x</span>
222
- <span class="cline-any cline-neutral">&nbsp;</span>
223
- <span class="cline-any cline-neutral">&nbsp;</span>
224
- <span class="cline-any cline-yes">1x</span>
225
- <span class="cline-any cline-yes">10x</span>
226
- <span class="cline-any cline-yes">10x</span>
227
- <span class="cline-any cline-yes">12x</span>
228
- <span class="cline-any cline-yes">2x</span>
229
- <span class="cline-any cline-yes">2x</span>
230
- <span class="cline-any cline-yes">10x</span>
231
- <span class="cline-any cline-yes">10x</span>
232
- <span class="cline-any cline-yes">10x</span>
233
- <span class="cline-any cline-yes">10x</span>
234
- <span class="cline-any cline-neutral">&nbsp;</span>
235
- <span class="cline-any cline-yes">2x</span>
236
- <span class="cline-any cline-yes">2x</span>
237
- <span class="cline-any cline-yes">2x</span>
238
- <span class="cline-any cline-neutral">&nbsp;</span>
239
- <span class="cline-any cline-neutral">&nbsp;</span>
240
- <span class="cline-any cline-neutral">&nbsp;</span>
241
- <span class="cline-any cline-neutral">&nbsp;</span>
242
- <span class="cline-any cline-neutral">&nbsp;</span>
243
- <span class="cline-any cline-neutral">&nbsp;</span>
244
- <span class="cline-any cline-yes">1x</span>
245
- <span class="cline-any cline-yes">9x</span>
246
- <span class="cline-any cline-yes">9x</span>
247
- <span class="cline-any cline-yes">9x</span>
248
- <span class="cline-any cline-yes">9x</span>
249
- <span class="cline-any cline-yes">9x</span>
250
- <span class="cline-any cline-yes">9x</span>
251
- <span class="cline-any cline-yes">9x</span>
252
- <span class="cline-any cline-yes">9x</span>
253
- <span class="cline-any cline-yes">9x</span>
254
- <span class="cline-any cline-yes">9x</span>
255
- <span class="cline-any cline-yes">9x</span>
256
- <span class="cline-any cline-yes">9x</span>
257
- <span class="cline-any cline-yes">9x</span>
258
- <span class="cline-any cline-yes">9x</span>
259
- <span class="cline-any cline-neutral">&nbsp;</span>
260
- <span class="cline-any cline-neutral">&nbsp;</span>
261
- <span class="cline-any cline-neutral">&nbsp;</span>
262
- <span class="cline-any cline-neutral">&nbsp;</span>
263
- <span class="cline-any cline-neutral">&nbsp;</span>
264
- <span class="cline-any cline-neutral">&nbsp;</span>
265
- <span class="cline-any cline-neutral">&nbsp;</span>
266
- <span class="cline-any cline-yes">1x</span>
267
- <span class="cline-any cline-yes">2x</span>
268
- <span class="cline-any cline-yes">2x</span>
269
- <span class="cline-any cline-yes">2x</span>
270
- <span class="cline-any cline-neutral">&nbsp;</span>
271
- <span class="cline-any cline-neutral">&nbsp;</span>
272
- <span class="cline-any cline-neutral">&nbsp;</span>
273
- <span class="cline-any cline-neutral">&nbsp;</span>
274
- <span class="cline-any cline-neutral">&nbsp;</span>
275
- <span class="cline-any cline-yes">2x</span>
276
- <span class="cline-any cline-yes">2x</span>
277
- <span class="cline-any cline-yes">1x</span>
278
- <span class="cline-any cline-yes">1x</span>
279
- <span class="cline-any cline-yes">2x</span>
280
- <span class="cline-any cline-yes">2x</span>
281
- <span class="cline-any cline-yes">2x</span>
282
- <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import type { QueryPlan, WhereNode, WhereComparison } from '@spooky-sync/query-builder';
283
- import type { OrderBy, RelationFetch } from './cache-engine';
284
- &nbsp;
285
- /**
286
- * Render helpers that turn an engine-neutral {@link QueryPlan} into a concrete
287
- * dialect. Two consumers: `SurrealCacheEngine` (SurrealQL) and, indirectly, the
288
- * SQLite worker (which uses the SQL variants). Relations are NOT rendered here —
289
- * they are resolved by `resolveRelations` via the {@link RelationFetch}
290
- * primitive, so both engines share the exact same decomposition.
291
- */
292
- &nbsp;
293
- export interface RenderedQuery {
294
- sql: string;
295
- vars: Record&lt;string, unknown&gt;;
296
- }
297
- &nbsp;
298
- interface RenderCtx {
299
- vars: Record&lt;string, unknown&gt;;
300
- n: number;
301
- }
302
- &nbsp;
303
- function bind(ctx: RenderCtx, value: unknown): string {
304
- const name = `__p${ctx.n++}`;
305
- ctx.vars[name] = value;
306
- return `$${name}`;
307
- }
308
- &nbsp;
309
- function renderComparisonSurql(c: WhereComparison, ctx: RenderCtx): string {
310
- // Prefer the query's own param (`paramRef`) so a filter materializes from
311
- // `params` (the query's identity), not a baked literal — this is what slaves
312
- // a query's rows to its id. A pure `$`-ref node has no `value`, so it always
313
- // uses the param. A slave-mode node also carries `value` as a fallback for
314
- // when the param is absent (e.g. a non-column field stripped by parseParams).
315
- const useParam =
316
- c.paramRef !== undefined &amp;&amp;
317
- (c.value === undefined || Object.prototype.hasOwnProperty.call(ctx.vars, c.paramRef));
318
- const rawRight = useParam ? `$${c.paramRef}` : bind(ctx, c.value);
319
- // `id` is a RecordId, but correlation/filter values arrive as record-id
320
- // STRINGS (e.g. "thread:abc"). On SurrealDB `id = "thread:abc"` never matches
321
- // (string ≠ record), so a base select filtered by id (e.g. the ThreadDetail
322
- // query `… FROM thread WHERE id = $id`) resolves empty — and its whole
323
- // `.related()` subtree (author, comments) then loads nothing. Coerce with
324
- // `type::record(&lt;string&gt; …)` (idempotent if already a RecordId), mirroring
325
- // renderRelationFetchSurql's matchField coercion.
326
- const right =
327
- c.field === 'id' ? `type::record(&lt;string&gt; ${rawRight})` : rawRight;
328
- return c.swap ? `${right} ${c.op} ${c.field}` : `${c.field} ${c.op} ${right}`;
329
- }
330
- &nbsp;
331
- /** Render a WHERE conjunction (AND of comparisons / OR-groups) to SurrealQL. */
332
- export function renderWhereSurql(nodes: WhereNode[], ctx: RenderCtx): string {
333
- return nodes
334
- .map((node) =&gt; {
335
- if ('or' in node) {
336
- return `(${node.or.map((c) =&gt; renderComparisonSurql(c, ctx)).join(' OR ')})`;
337
- }
338
- return renderComparisonSurql(node, ctx);
339
- })
340
- .join(' AND ');
341
- }
342
- &nbsp;
343
- function renderOrderBy(orderBy: OrderBy): string {
344
- return ` ORDER BY ${orderBy.map(([f, d]) =&gt; `${f} ${d}`).join(', ')}`;
345
- }
346
- &nbsp;
347
- /**
348
- * Render the BASE of a SELECT (no relations) to SurrealQL. `params` supplies
349
- * pre-existing bound params (e.g. `$__win` for windowing, or `paramRef` values)
350
- * and is merged into the returned vars.
351
- */
352
- export function renderBaseSelectSurql(
353
- plan: QueryPlan,
354
- params: Record&lt;string, unknown&gt; = {}
355
- ): RenderedQuery {
356
- const ctx: RenderCtx = { vars: { ...params }, n: 0 };
357
- const projection = plan.select &amp;&amp; plan.select.length &gt; 0 ? plan.select.join(', ') : '*';
358
- let sql = `SELECT ${projection} FROM ${plan.table}`;
359
- if (plan.where &amp;&amp; plan.where.length &gt; 0) {
360
- sql += ` WHERE ${renderWhereSurql(plan.where, ctx)}`;
361
- }
362
- if (plan.orderBy &amp;&amp; plan.orderBy.length &gt; 0) sql += renderOrderBy(plan.orderBy);
363
- if (plan.limit !== undefined) sql += ` LIMIT ${plan.limit}`;
364
- if (plan.offset !== undefined) sql += ` START ${plan.offset}`;
365
- return { sql: `${sql};`, vars: ctx.vars };
366
- }
367
- &nbsp;
368
- /**
369
- * Render a batched relation fetch to SurrealQL:
370
- * `SELECT &lt;select&gt; FROM &lt;table&gt; WHERE &lt;matchField&gt; IN $__keys [AND &lt;where&gt;] [ORDER BY]`.
371
- * The resolver re-applies per-parent ORDER/LIMIT after grouping, so LIMIT is
372
- * intentionally omitted here.
373
- */
374
- export function renderRelationFetchSurql(req: RelationFetch): RenderedQuery {
375
- const ctx: RenderCtx = { vars: { __keys: req.keys }, n: 0 };
376
- const projection =
377
- req.<span class="branch-0 cbranch-no" title="branch not covered" >select &amp;&amp; req.select.length &gt; <span class="branch-0 cbranch-no" title="branch not covered" >0 ? [</span>'id', ...req.select].join(', ') : '</span>*';
378
- // The correlation keys arrive as record-id STRINGS (`"user:abc"`), but the
379
- // matched column (`id`, or a `record&lt;…&gt;` foreign key) is a RecordId. In
380
- // SurrealDB `id IN ["user:abc"]` never matches (string ≠ record), so every
381
- // `.related()` field would resolve empty. Coerce each key to a record id with
382
- // `type::record(&lt;string&gt; …)` (idempotent if a key is already a RecordId).
383
- let sql = `SELECT ${projection} FROM ${req.table} WHERE ${req.matchField} IN $__keys.map(|$__k| type::record(&lt;string&gt; $__k))`;
384
- if (req.where &amp;&amp; req.where.length &gt; 0) {
385
- sql += ` AND ${renderWhereSurql(req.where, ctx)}`;
386
- }
387
- if (req.orderBy &amp;&amp; req.orderBy.length &gt; 0) sql += renderOrderBy(req.orderBy);
388
- return { sql: `${sql};`, vars: ctx.vars };
389
- }
390
- &nbsp;</pre></td></tr></table></pre>
391
-
392
- <div class='push'></div><!-- for sticky footer -->
393
- </div><!-- /wrapper -->
394
- <div class='footer quiet pad2 space-top1 center small'>
395
- Code coverage generated by
396
- <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
397
- at 2026-09-09T09:49:51.780Z
398
- </div>
399
- <script src="../../../prettify.js"></script>
400
- <script>
401
- window.onload = function () {
402
- prettyPrint();
403
- };
404
- </script>
405
- <script src="../../../sorter.js"></script>
406
- <script src="../../../block-navigation.js"></script>
407
- </body>
408
- </html>
409
-