npm - @spooky-sync/core - Versions diffs - 0.0.1-canary.240 → 0.0.1-canary.241 - Mend

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

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 (289) hide show

package/AGENTS.md +34 -15
package/README.md +56 -16
package/dist/index.d.ts +1136 -1846
package/dist/index.js +10168 -11267
package/dist/types.d.ts +22 -79
package/package.json +8 -4
package/skills/sp00ky-core/SKILL.md +18 -0
package/src/boot/auth-flip.saga.test.ts +82 -0
package/src/boot/auth-flip.saga.ts +62 -0
package/src/boot/boot.saga.test.ts +151 -0
package/src/boot/boot.saga.ts +128 -0
package/src/boot/bucket-switch.saga.test.ts +158 -0
package/src/boot/bucket-switch.saga.ts +115 -0
package/src/boot/preload.saga.test.ts +51 -0
package/src/boot/preload.saga.ts +31 -0
package/src/client/bucket-handle.test.ts +117 -0
package/src/client/bucket-handle.ts +227 -0
package/src/client/router.test.ts +56 -0
package/src/client/router.ts +94 -0
package/src/client/runtime.test.ts +192 -0
package/src/client/runtime.ts +296 -0
package/src/client/services.ts +349 -0
package/src/client/sp00ky-client.test.ts +241 -0
package/src/client/sp00ky-client.ts +482 -0
package/src/index.ts +1 -0
package/src/kernel/constants.test.ts +19 -0
package/src/kernel/constants.ts +54 -0
package/src/kernel/effects.test.ts +40 -0
package/src/kernel/effects.ts +159 -0
package/src/kernel/events.ts +55 -0
package/src/kernel/interpreter.test.ts +116 -0
package/src/kernel/interpreter.ts +143 -0
package/src/kernel/saga.test.ts +89 -0
package/src/kernel/saga.ts +73 -0
package/src/modules/app-release/index.ts +13 -5
package/src/modules/devtools/index.ts +10 -3
package/src/modules/devtools/state-shape.test.ts +4 -1
package/src/modules/feature-flag/index.ts +13 -5
package/src/mutation/jobs.test.ts +25 -0
package/src/mutation/jobs.ts +41 -0
package/src/{modules/data → mutation}/mutation-id.test.ts +12 -0
package/src/mutation/push.saga.test.ts +285 -0
package/src/mutation/push.saga.ts +215 -0
package/src/mutation/rows.test.ts +201 -0
package/src/mutation/rows.ts +377 -0
package/src/mutation/tray.saga.test.ts +63 -0
package/src/mutation/tray.saga.ts +48 -0
package/src/mutation/write.saga.test.ts +163 -0
package/src/mutation/write.saga.ts +166 -0
package/src/query/env.test.ts +23 -0
package/src/query/env.ts +56 -0
package/src/query/fetch.saga.test.ts +156 -0
package/src/query/fetch.saga.ts +109 -0
package/src/query/hash.test.ts +14 -0
package/src/query/hash.ts +18 -0
package/src/{modules/data → query}/id-set-plan.test.ts +12 -2
package/src/query/lifecycle.saga.test.ts +122 -0
package/src/query/lifecycle.saga.ts +101 -0
package/src/query/materialize.saga.test.ts +82 -0
package/src/query/materialize.saga.ts +75 -0
package/src/query/materialize.test.ts +50 -0
package/src/query/materialize.ts +44 -0
package/src/query/membership.saga.test.ts +246 -0
package/src/query/membership.saga.ts +208 -0
package/src/query/membership.test.ts +118 -0
package/src/query/membership.ts +158 -0
package/src/query/register.saga.test.ts +251 -0
package/src/query/register.saga.ts +190 -0
package/src/query/render-set.test.ts +36 -0
package/src/query/render-set.ts +60 -0
package/src/query/sql.test.ts +62 -0
package/src/query/sql.ts +79 -0
package/src/{modules/data → query}/window-query.test.ts +18 -0
package/src/{modules/data → query}/window-query.ts +2 -1
package/src/services/database/connection-supervisor.test.ts +29 -0
package/src/services/database/connection-supervisor.ts +7 -0
package/src/services/database/database.responses.test.ts +43 -0
package/src/services/database/database.ts +25 -10
package/src/services/database/local-migrator.ts +2 -2
package/src/services/database/plan-render.test.ts +1 -1
package/src/services/database/sqlite-cache-engine.test.ts +4 -3
package/src/services/database/sqlite-cache-engine.ts +2 -11
package/src/services/database/sqlite-devtools-queries.integration.test.ts +1 -1
package/src/services/tabs/protocol.ts +7 -3
package/src/sp00ky.ts +5 -1854
package/src/state/client-state.ts +184 -0
package/src/state/lifecycle.test.ts +118 -0
package/src/state/lifecycle.ts +86 -0
package/src/state/reducers.test.ts +280 -0
package/src/state/reducers.ts +476 -0
package/src/state/selectors.test.ts +149 -0
package/src/state/selectors.ts +184 -0
package/src/sync/connection.saga.test.ts +86 -0
package/src/sync/connection.saga.ts +85 -0
package/src/sync/live.saga.test.ts +69 -0
package/src/sync/live.saga.ts +49 -0
package/src/sync/policy.health.test.ts +56 -0
package/src/{modules/sync/utils.test.ts → sync/policy.test.ts} +31 -3
package/src/{modules/sync/utils.ts → sync/policy.ts} +67 -5
package/src/sync/poll.saga.test.ts +51 -0
package/src/sync/poll.saga.ts +36 -0
package/src/sync/tabs.saga.test.ts +74 -0
package/src/sync/tabs.saga.ts +92 -0
package/src/testing/adapters.ts +133 -0
package/src/testing/build.ts +61 -0
package/src/testing/fake-services.ts +34 -0
package/src/testing/run-pure.test.ts +92 -0
package/src/testing/run-pure.ts +128 -0
package/src/testing/services.ts +17 -0
package/src/types.ts +8 -7
package/src/utils/utils.test.ts +2 -1
package/vitest.config.ts +48 -0
package/coverage/lcov-report/base.css +0 -224
package/coverage/lcov-report/block-navigation.js +0 -87
package/coverage/lcov-report/favicon.png +0 -0
package/coverage/lcov-report/index.html +0 -476
package/coverage/lcov-report/prettify.css +0 -1
package/coverage/lcov-report/prettify.js +0 -2
package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
package/coverage/lcov-report/sorter.js +0 -210
package/coverage/lcov-report/src/boot/auth-flip.saga.ts.html +0 -271
package/coverage/lcov-report/src/boot/boot.saga.ts.html +0 -469
package/coverage/lcov-report/src/boot/bucket-switch.saga.ts.html +0 -430
package/coverage/lcov-report/src/boot/index.html +0 -161
package/coverage/lcov-report/src/boot/preload.saga.ts.html +0 -178
package/coverage/lcov-report/src/client/bucket-handle.ts.html +0 -766
package/coverage/lcov-report/src/client/index.html +0 -161
package/coverage/lcov-report/src/client/router.ts.html +0 -367
package/coverage/lcov-report/src/client/runtime.ts.html +0 -940
package/coverage/lcov-report/src/client/sp00ky-client.ts.html +0 -1531
package/coverage/lcov-report/src/events/index.html +0 -116
package/coverage/lcov-report/src/events/index.ts.html +0 -877
package/coverage/lcov-report/src/index.html +0 -146
package/coverage/lcov-report/src/index.ts.html +0 -202
package/coverage/lcov-report/src/kernel/constants.ts.html +0 -247
package/coverage/lcov-report/src/kernel/effects.ts.html +0 -562
package/coverage/lcov-report/src/kernel/events.ts.html +0 -250
package/coverage/lcov-report/src/kernel/index.html +0 -176
package/coverage/lcov-report/src/kernel/interpreter.ts.html +0 -514
package/coverage/lcov-report/src/kernel/saga.ts.html +0 -304
package/coverage/lcov-report/src/modules/app-release/index.html +0 -116
package/coverage/lcov-report/src/modules/app-release/index.ts.html +0 -712
package/coverage/lcov-report/src/modules/auth/events/index.html +0 -116
package/coverage/lcov-report/src/modules/auth/events/index.ts.html +0 -142
package/coverage/lcov-report/src/modules/auth/index.html +0 -116
package/coverage/lcov-report/src/modules/auth/index.ts.html +0 -1225
package/coverage/lcov-report/src/modules/crdt/crdt-field.ts.html +0 -967
package/coverage/lcov-report/src/modules/crdt/index.html +0 -146
package/coverage/lcov-report/src/modules/crdt/index.ts.html +0 -1474
package/coverage/lcov-report/src/modules/crdt/loro-loader.ts.html +0 -160
package/coverage/lcov-report/src/modules/devtools/flags.ts.html +0 -1132
package/coverage/lcov-report/src/modules/devtools/index.html +0 -161
package/coverage/lcov-report/src/modules/devtools/index.ts.html +0 -2413
package/coverage/lcov-report/src/modules/devtools/storage-info.ts.html +0 -589
package/coverage/lcov-report/src/modules/devtools/versions.ts.html +0 -415
package/coverage/lcov-report/src/modules/feature-flag/index.html +0 -116
package/coverage/lcov-report/src/modules/feature-flag/index.ts.html +0 -1033
package/coverage/lcov-report/src/modules/index.html +0 -116
package/coverage/lcov-report/src/modules/ref-tables.ts.html +0 -349
package/coverage/lcov-report/src/mutation/index.html +0 -191
package/coverage/lcov-report/src/mutation/jobs.ts.html +0 -208
package/coverage/lcov-report/src/mutation/mutation-id.ts.html +0 -190
package/coverage/lcov-report/src/mutation/push.saga.ts.html +0 -730
package/coverage/lcov-report/src/mutation/rows.ts.html +0 -1216
package/coverage/lcov-report/src/mutation/tray.saga.ts.html +0 -229
package/coverage/lcov-report/src/mutation/write.saga.ts.html +0 -583
package/coverage/lcov-report/src/otel/index.html +0 -116
package/coverage/lcov-report/src/otel/index.ts.html +0 -466
package/coverage/lcov-report/src/query/env.ts.html +0 -253
package/coverage/lcov-report/src/query/fetch.saga.ts.html +0 -412
package/coverage/lcov-report/src/query/hash.ts.html +0 -139
package/coverage/lcov-report/src/query/index.html +0 -281
package/coverage/lcov-report/src/query/lifecycle.saga.ts.html +0 -388
package/coverage/lcov-report/src/query/materialize.saga.ts.html +0 -310
package/coverage/lcov-report/src/query/materialize.ts.html +0 -217
package/coverage/lcov-report/src/query/membership.saga.ts.html +0 -709
package/coverage/lcov-report/src/query/membership.ts.html +0 -559
package/coverage/lcov-report/src/query/register.saga.ts.html +0 -655
package/coverage/lcov-report/src/query/render-set.ts.html +0 -265
package/coverage/lcov-report/src/query/sql.ts.html +0 -322
package/coverage/lcov-report/src/query/window-query.ts.html +0 -670
package/coverage/lcov-report/src/services/blobs/blob-cache.ts.html +0 -1894
package/coverage/lcov-report/src/services/blobs/blob-manifest.ts.html +0 -766
package/coverage/lcov-report/src/services/blobs/blob-store.ts.html +0 -1162
package/coverage/lcov-report/src/services/blobs/index.html +0 -161
package/coverage/lcov-report/src/services/blobs/index.ts.html +0 -295
package/coverage/lcov-report/src/services/database/cache-engine.ts.html +0 -664
package/coverage/lcov-report/src/services/database/connection-supervisor.ts.html +0 -1330
package/coverage/lcov-report/src/services/database/database.ts.html +0 -658
package/coverage/lcov-report/src/services/database/engine-factory.ts.html +0 -184
package/coverage/lcov-report/src/services/database/errors.ts.html +0 -187
package/coverage/lcov-report/src/services/database/events/index.html +0 -116
package/coverage/lcov-report/src/services/database/events/index.ts.html +0 -184
package/coverage/lcov-report/src/services/database/index.html +0 -386
package/coverage/lcov-report/src/services/database/index.ts.html +0 -121
package/coverage/lcov-report/src/services/database/local-migrator.ts.html +0 -703
package/coverage/lcov-report/src/services/database/local.ts.html +0 -1633
package/coverage/lcov-report/src/services/database/plan-render.ts.html +0 -409
package/coverage/lcov-report/src/services/database/relation-resolver.ts.html +0 -682
package/coverage/lcov-report/src/services/database/remote.ts.html +0 -1036
package/coverage/lcov-report/src/services/database/sqlite-cache-engine.ts.html +0 -4132
package/coverage/lcov-report/src/services/database/sqlite-lock-verify.ts.html +0 -220
package/coverage/lcov-report/src/services/database/sqlite-open.ts.html +0 -577
package/coverage/lcov-report/src/services/database/sqlite-plan-sql.ts.html +0 -499
package/coverage/lcov-report/src/services/database/sqlite-select.ts.html +0 -478
package/coverage/lcov-report/src/services/database/sqlite-transport.ts.html +0 -757
package/coverage/lcov-report/src/services/database/surql-translate.ts.html +0 -1333
package/coverage/lcov-report/src/services/database/surreal-cache-engine.ts.html +0 -568
package/coverage/lcov-report/src/services/logger/index.html +0 -116
package/coverage/lcov-report/src/services/logger/index.ts.html +0 -154
package/coverage/lcov-report/src/services/persistence/index.html +0 -146
package/coverage/lcov-report/src/services/persistence/localstorage.ts.html +0 -163
package/coverage/lcov-report/src/services/persistence/resilient.ts.html +0 -208
package/coverage/lcov-report/src/services/persistence/surrealdb.ts.html +0 -271
package/coverage/lcov-report/src/services/stream-processor/index.html +0 -146
package/coverage/lcov-report/src/services/stream-processor/index.ts.html +0 -3313
package/coverage/lcov-report/src/services/stream-processor/permissions.ts.html +0 -244
package/coverage/lcov-report/src/services/stream-processor/wasm-types.ts.html +0 -346
package/coverage/lcov-report/src/services/tabs/broker-client.ts.html +0 -934
package/coverage/lcov-report/src/services/tabs/coordinator.ts.html +0 -1984
package/coverage/lcov-report/src/services/tabs/index.html +0 -191
package/coverage/lcov-report/src/services/tabs/leader-locks.ts.html +0 -310
package/coverage/lcov-report/src/services/tabs/protocol.ts.html +0 -871
package/coverage/lcov-report/src/services/tabs/support.ts.html +0 -193
package/coverage/lcov-report/src/services/tabs/tabs-broker-worker.ts.html +0 -2005
package/coverage/lcov-report/src/sp00ky.ts.html +0 -100
package/coverage/lcov-report/src/state/client-state.ts.html +0 -637
package/coverage/lcov-report/src/state/index.html +0 -161
package/coverage/lcov-report/src/state/lifecycle.ts.html +0 -343
package/coverage/lcov-report/src/state/reducers.ts.html +0 -1471
package/coverage/lcov-report/src/state/selectors.ts.html +0 -637
package/coverage/lcov-report/src/sync/connection.saga.ts.html +0 -343
package/coverage/lcov-report/src/sync/index.html +0 -176
package/coverage/lcov-report/src/sync/live.saga.ts.html +0 -232
package/coverage/lcov-report/src/sync/policy.ts.html +0 -1606
package/coverage/lcov-report/src/sync/poll.saga.ts.html +0 -193
package/coverage/lcov-report/src/sync/tabs.saga.ts.html +0 -361
package/coverage/lcov-report/src/types.ts.html +0 -2419
package/coverage/lcov-report/src/utils/blurhash.ts.html +0 -355
package/coverage/lcov-report/src/utils/error-classification.ts.html +0 -244
package/coverage/lcov-report/src/utils/index.html +0 -191
package/coverage/lcov-report/src/utils/index.ts.html +0 -820
package/coverage/lcov-report/src/utils/parser.ts.html +0 -313
package/coverage/lcov-report/src/utils/semver.ts.html +0 -175
package/coverage/lcov-report/src/utils/surql.ts.html +0 -667
package/coverage/lcov.info +0 -19079
package/src/modules/cache/cache.relay.test.ts +0 -95
package/src/modules/cache/index.ts +0 -361
package/src/modules/cache/types.ts +0 -19
package/src/modules/data/data.activity.test.ts +0 -109
package/src/modules/data/data.authority.test.ts +0 -122
package/src/modules/data/data.heartbeat-wake.test.ts +0 -115
package/src/modules/data/data.hydration.test.ts +0 -142
package/src/modules/data/data.membership.test.ts +0 -623
package/src/modules/data/data.notify-table.test.ts +0 -41
package/src/modules/data/data.pending-ids.test.ts +0 -199
package/src/modules/data/data.rebind.test.ts +0 -170
package/src/modules/data/data.rematerialize.test.ts +0 -114
package/src/modules/data/data.run.test.ts +0 -113
package/src/modules/data/data.settled-writes.test.ts +0 -235
package/src/modules/data/data.status.test.ts +0 -249
package/src/modules/data/data.test.ts +0 -58
package/src/modules/data/index.ts +0 -2745
package/src/modules/sync/engine.ts +0 -250
package/src/modules/sync/events/index.ts +0 -84
package/src/modules/sync/index.ts +0 -3
package/src/modules/sync/queue/index.ts +0 -2
package/src/modules/sync/queue/queue-down.test.ts +0 -228
package/src/modules/sync/queue/queue-down.ts +0 -184
package/src/modules/sync/queue/queue-up.forwarded.test.ts +0 -164
package/src/modules/sync/queue/queue-up.ts +0 -407
package/src/modules/sync/scheduler.pause.test.ts +0 -109
package/src/modules/sync/scheduler.retry.test.ts +0 -237
package/src/modules/sync/scheduler.ts +0 -286
package/src/modules/sync/sync.cleanup.test.ts +0 -116
package/src/modules/sync/sync.health.test.ts +0 -167
package/src/modules/sync/sync.heartbeat.test.ts +0 -80
package/src/modules/sync/sync.list-ref-meta.test.ts +0 -193
package/src/modules/sync/sync.live-removal.test.ts +0 -289
package/src/modules/sync/sync.reconnect.test.ts +0 -145
package/src/modules/sync/sync.rematerialize-after-fetch.test.ts +0 -93
package/src/modules/sync/sync.settled-poll.test.ts +0 -58
package/src/modules/sync/sync.subquery.test.ts +0 -82
package/src/modules/sync/sync.tabs.test.ts +0 -249
package/src/modules/sync/sync.ts +0 -2626
package/src/sp00ky.auth-order.test.ts +0 -112
package/src/sp00ky.init-query.test.ts +0 -183
package/src/sp00ky.local-first.test.ts +0 -60
/package/src/{modules/data → mutation}/mutation-id.ts +0 -0

package/coverage/lcov-report/src/services/database/cache-engine.ts.html DELETED Viewed

@@ -1,664 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-    <title>Code coverage report for src/services/database/cache-engine.ts</title>
-    <meta charset="utf-8" />
-    <link rel="stylesheet" href="../../../prettify.css" />
-    <link rel="stylesheet" href="../../../base.css" />
-    <link rel="shortcut icon" type="image/x-icon" href="../../../favicon.png" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <style type='text/css'>
-        .coverage-summary .sorter {
-            background-image: url(../../../sort-arrow-sprite.png);
-        }
-    </style>
-</head>
-<body>
-<div class='wrapper'>
-    <div class='pad1'>
-        <h1><a href="../../../index.html">All files</a> / <a href="index.html">src/services/database</a> cache-engine.ts</h1>
-        <div class='clearfix'>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
-                <span class="quiet">Statements</span>
-                <span class='fraction'>7/7</span>
-            </div>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
-                <span class="quiet">Branches</span>
-                <span class='fraction'>1/1</span>
-            </div>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
-                <span class="quiet">Functions</span>
-                <span class='fraction'>1/1</span>
-            </div>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
-                <span class="quiet">Lines</span>
-                <span class='fraction'>7/7</span>
-            </div>
-        </div>
-        <p class="quiet">
-            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.
-        </p>
-        <template id="filterTemplate">
-            <div class="quiet">
-                Filter:
-                <input type="search" id="fileSearch">
-            </div>
-        </template>
-    </div>
-    <div class='status-line high'></div>
-    <pre><table class="coverage">
-<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
-<a name='L2'></a><a href='#L2'>2</a>
-<a name='L3'></a><a href='#L3'>3</a>
-<a name='L4'></a><a href='#L4'>4</a>
-<a name='L5'></a><a href='#L5'>5</a>
-<a name='L6'></a><a href='#L6'>6</a>
-<a name='L7'></a><a href='#L7'>7</a>
-<a name='L8'></a><a href='#L8'>8</a>
-<a name='L9'></a><a href='#L9'>9</a>
-<a name='L10'></a><a href='#L10'>10</a>
-<a name='L11'></a><a href='#L11'>11</a>
-<a name='L12'></a><a href='#L12'>12</a>
-<a name='L13'></a><a href='#L13'>13</a>
-<a name='L14'></a><a href='#L14'>14</a>
-<a name='L15'></a><a href='#L15'>15</a>
-<a name='L16'></a><a href='#L16'>16</a>
-<a name='L17'></a><a href='#L17'>17</a>
-<a name='L18'></a><a href='#L18'>18</a>
-<a name='L19'></a><a href='#L19'>19</a>
-<a name='L20'></a><a href='#L20'>20</a>
-<a name='L21'></a><a href='#L21'>21</a>
-<a name='L22'></a><a href='#L22'>22</a>
-<a name='L23'></a><a href='#L23'>23</a>
-<a name='L24'></a><a href='#L24'>24</a>
-<a name='L25'></a><a href='#L25'>25</a>
-<a name='L26'></a><a href='#L26'>26</a>
-<a name='L27'></a><a href='#L27'>27</a>
-<a name='L28'></a><a href='#L28'>28</a>
-<a name='L29'></a><a href='#L29'>29</a>
-<a name='L30'></a><a href='#L30'>30</a>
-<a name='L31'></a><a href='#L31'>31</a>
-<a name='L32'></a><a href='#L32'>32</a>
-<a name='L33'></a><a href='#L33'>33</a>
-<a name='L34'></a><a href='#L34'>34</a>
-<a name='L35'></a><a href='#L35'>35</a>
-<a name='L36'></a><a href='#L36'>36</a>
-<a name='L37'></a><a href='#L37'>37</a>
-<a name='L38'></a><a href='#L38'>38</a>
-<a name='L39'></a><a href='#L39'>39</a>
-<a name='L40'></a><a href='#L40'>40</a>
-<a name='L41'></a><a href='#L41'>41</a>
-<a name='L42'></a><a href='#L42'>42</a>
-<a name='L43'></a><a href='#L43'>43</a>
-<a name='L44'></a><a href='#L44'>44</a>
-<a name='L45'></a><a href='#L45'>45</a>
-<a name='L46'></a><a href='#L46'>46</a>
-<a name='L47'></a><a href='#L47'>47</a>
-<a name='L48'></a><a href='#L48'>48</a>
-<a name='L49'></a><a href='#L49'>49</a>
-<a name='L50'></a><a href='#L50'>50</a>
-<a name='L51'></a><a href='#L51'>51</a>
-<a name='L52'></a><a href='#L52'>52</a>
-<a name='L53'></a><a href='#L53'>53</a>
-<a name='L54'></a><a href='#L54'>54</a>
-<a name='L55'></a><a href='#L55'>55</a>
-<a name='L56'></a><a href='#L56'>56</a>
-<a name='L57'></a><a href='#L57'>57</a>
-<a name='L58'></a><a href='#L58'>58</a>
-<a name='L59'></a><a href='#L59'>59</a>
-<a name='L60'></a><a href='#L60'>60</a>
-<a name='L61'></a><a href='#L61'>61</a>
-<a name='L62'></a><a href='#L62'>62</a>
-<a name='L63'></a><a href='#L63'>63</a>
-<a name='L64'></a><a href='#L64'>64</a>
-<a name='L65'></a><a href='#L65'>65</a>
-<a name='L66'></a><a href='#L66'>66</a>
-<a name='L67'></a><a href='#L67'>67</a>
-<a name='L68'></a><a href='#L68'>68</a>
-<a name='L69'></a><a href='#L69'>69</a>
-<a name='L70'></a><a href='#L70'>70</a>
-<a name='L71'></a><a href='#L71'>71</a>
-<a name='L72'></a><a href='#L72'>72</a>
-<a name='L73'></a><a href='#L73'>73</a>
-<a name='L74'></a><a href='#L74'>74</a>
-<a name='L75'></a><a href='#L75'>75</a>
-<a name='L76'></a><a href='#L76'>76</a>
-<a name='L77'></a><a href='#L77'>77</a>
-<a name='L78'></a><a href='#L78'>78</a>
-<a name='L79'></a><a href='#L79'>79</a>
-<a name='L80'></a><a href='#L80'>80</a>
-<a name='L81'></a><a href='#L81'>81</a>
-<a name='L82'></a><a href='#L82'>82</a>
-<a name='L83'></a><a href='#L83'>83</a>
-<a name='L84'></a><a href='#L84'>84</a>
-<a name='L85'></a><a href='#L85'>85</a>
-<a name='L86'></a><a href='#L86'>86</a>
-<a name='L87'></a><a href='#L87'>87</a>
-<a name='L88'></a><a href='#L88'>88</a>
-<a name='L89'></a><a href='#L89'>89</a>
-<a name='L90'></a><a href='#L90'>90</a>
-<a name='L91'></a><a href='#L91'>91</a>
-<a name='L92'></a><a href='#L92'>92</a>
-<a name='L93'></a><a href='#L93'>93</a>
-<a name='L94'></a><a href='#L94'>94</a>
-<a name='L95'></a><a href='#L95'>95</a>
-<a name='L96'></a><a href='#L96'>96</a>
-<a name='L97'></a><a href='#L97'>97</a>
-<a name='L98'></a><a href='#L98'>98</a>
-<a name='L99'></a><a href='#L99'>99</a>
-<a name='L100'></a><a href='#L100'>100</a>
-<a name='L101'></a><a href='#L101'>101</a>
-<a name='L102'></a><a href='#L102'>102</a>
-<a name='L103'></a><a href='#L103'>103</a>
-<a name='L104'></a><a href='#L104'>104</a>
-<a name='L105'></a><a href='#L105'>105</a>
-<a name='L106'></a><a href='#L106'>106</a>
-<a name='L107'></a><a href='#L107'>107</a>
-<a name='L108'></a><a href='#L108'>108</a>
-<a name='L109'></a><a href='#L109'>109</a>
-<a name='L110'></a><a href='#L110'>110</a>
-<a name='L111'></a><a href='#L111'>111</a>
-<a name='L112'></a><a href='#L112'>112</a>
-<a name='L113'></a><a href='#L113'>113</a>
-<a name='L114'></a><a href='#L114'>114</a>
-<a name='L115'></a><a href='#L115'>115</a>
-<a name='L116'></a><a href='#L116'>116</a>
-<a name='L117'></a><a href='#L117'>117</a>
-<a name='L118'></a><a href='#L118'>118</a>
-<a name='L119'></a><a href='#L119'>119</a>
-<a name='L120'></a><a href='#L120'>120</a>
-<a name='L121'></a><a href='#L121'>121</a>
-<a name='L122'></a><a href='#L122'>122</a>
-<a name='L123'></a><a href='#L123'>123</a>
-<a name='L124'></a><a href='#L124'>124</a>
-<a name='L125'></a><a href='#L125'>125</a>
-<a name='L126'></a><a href='#L126'>126</a>
-<a name='L127'></a><a href='#L127'>127</a>
-<a name='L128'></a><a href='#L128'>128</a>
-<a name='L129'></a><a href='#L129'>129</a>
-<a name='L130'></a><a href='#L130'>130</a>
-<a name='L131'></a><a href='#L131'>131</a>
-<a name='L132'></a><a href='#L132'>132</a>
-<a name='L133'></a><a href='#L133'>133</a>
-<a name='L134'></a><a href='#L134'>134</a>
-<a name='L135'></a><a href='#L135'>135</a>
-<a name='L136'></a><a href='#L136'>136</a>
-<a name='L137'></a><a href='#L137'>137</a>
-<a name='L138'></a><a href='#L138'>138</a>
-<a name='L139'></a><a href='#L139'>139</a>
-<a name='L140'></a><a href='#L140'>140</a>
-<a name='L141'></a><a href='#L141'>141</a>
-<a name='L142'></a><a href='#L142'>142</a>
-<a name='L143'></a><a href='#L143'>143</a>
-<a name='L144'></a><a href='#L144'>144</a>
-<a name='L145'></a><a href='#L145'>145</a>
-<a name='L146'></a><a href='#L146'>146</a>
-<a name='L147'></a><a href='#L147'>147</a>
-<a name='L148'></a><a href='#L148'>148</a>
-<a name='L149'></a><a href='#L149'>149</a>
-<a name='L150'></a><a href='#L150'>150</a>
-<a name='L151'></a><a href='#L151'>151</a>
-<a name='L152'></a><a href='#L152'>152</a>
-<a name='L153'></a><a href='#L153'>153</a>
-<a name='L154'></a><a href='#L154'>154</a>
-<a name='L155'></a><a href='#L155'>155</a>
-<a name='L156'></a><a href='#L156'>156</a>
-<a name='L157'></a><a href='#L157'>157</a>
-<a name='L158'></a><a href='#L158'>158</a>
-<a name='L159'></a><a href='#L159'>159</a>
-<a name='L160'></a><a href='#L160'>160</a>
-<a name='L161'></a><a href='#L161'>161</a>
-<a name='L162'></a><a href='#L162'>162</a>
-<a name='L163'></a><a href='#L163'>163</a>
-<a name='L164'></a><a href='#L164'>164</a>
-<a name='L165'></a><a href='#L165'>165</a>
-<a name='L166'></a><a href='#L166'>166</a>
-<a name='L167'></a><a href='#L167'>167</a>
-<a name='L168'></a><a href='#L168'>168</a>
-<a name='L169'></a><a href='#L169'>169</a>
-<a name='L170'></a><a href='#L170'>170</a>
-<a name='L171'></a><a href='#L171'>171</a>
-<a name='L172'></a><a href='#L172'>172</a>
-<a name='L173'></a><a href='#L173'>173</a>
-<a name='L174'></a><a href='#L174'>174</a>
-<a name='L175'></a><a href='#L175'>175</a>
-<a name='L176'></a><a href='#L176'>176</a>
-<a name='L177'></a><a href='#L177'>177</a>
-<a name='L178'></a><a href='#L178'>178</a>
-<a name='L179'></a><a href='#L179'>179</a>
-<a name='L180'></a><a href='#L180'>180</a>
-<a name='L181'></a><a href='#L181'>181</a>
-<a name='L182'></a><a href='#L182'>182</a>
-<a name='L183'></a><a href='#L183'>183</a>
-<a name='L184'></a><a href='#L184'>184</a>
-<a name='L185'></a><a href='#L185'>185</a>
-<a name='L186'></a><a href='#L186'>186</a>
-<a name='L187'></a><a href='#L187'>187</a>
-<a name='L188'></a><a href='#L188'>188</a>
-<a name='L189'></a><a href='#L189'>189</a>
-<a name='L190'></a><a href='#L190'>190</a>
-<a name='L191'></a><a href='#L191'>191</a>
-<a name='L192'></a><a href='#L192'>192</a>
-<a name='L193'></a><a href='#L193'>193</a>
-<a name='L194'></a><a href='#L194'>194</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import type { QueryPlan, RelationPlan, WhereNode } from '@spooky-sync/query-builder';
-import type { SealedQuery } from '../../utils/surql';
-import type { DatabaseEventSystem } from './events/index';
-import type { Sp00kyConfig, StorageHealth } from '../../types';
-import type { EngineStorageDiagnostics } from '../../modules/devtools/storage-info';
-&nbsp;
-/**
- * A materialized row. Keys are field names; values are already decoded to the
- * client's runtime shapes (RecordId stays a RecordId, bytes a Uint8Array, …) so
- * every backend hands `DataModule` the same shape SurrealDB does today.
- */
-export type Row = Record&lt;string, unknown&gt;;
-&nbsp;
-/** A record identifier — a `RecordId` or its stable string form (`table:id`). */
-export type Id = unknown;
-&nbsp;
-/** How an order clause is expressed everywhere in the engine layer. */
-export type OrderBy = [field: string, direction: 'asc' | 'desc'][];
-&nbsp;
-/**
- * Batched relation fetch: "give me every row of `table` whose `matchField` is
- * one of `keys`, filtered by `where`, ordered by `orderBy`". This is the single
- * primitive relation decomposition (§3) leans on — implemented as
- * `SELECT … WHERE &lt;matchField&gt; IN (…)` on SQLite, `SELECT … FROM $keys` /
- * `WHERE &lt;matchField&gt; IN $keys` on SurrealDB, or an index scan elsewhere. Order
- * here is a hint; the resolver re-applies order+limit PER PARENT after grouping.
- */
-export interface RelationFetch {
-  table: string;
-  matchField: string;
-  keys: Id[];
-  where?: WhereNode[];
-  orderBy?: OrderBy;
-  select?: string[];
-}
-&nbsp;
-/**
- * The read side of an engine, minus relation resolution — the surface a
- * {@link RelationResolver} needs. Kept separate so the resolver can be unit
- * tested against an in-memory fake without a full engine.
- */
-export interface RowFetcher {
-  /** Batched fan-out fetch. See {@link RelationFetch}. */
-  fetchRelation(req: RelationFetch): Promise&lt;Row[]&gt;;
-}
-&nbsp;
-/** A transaction handle — the same verbs as the engine, but atomic. */
-export interface EngineTx {
-  upsert(table: string, id: Id, data: Row, mode: 'replace' | 'merge'): Promise&lt;void&gt;;
-  patch(table: string, id: Id, patches: unknown[]): Promise&lt;void&gt;;
-  delete(table: string, id: Id): Promise&lt;void&gt;;
-}
-&nbsp;
-/**
- * A pluggable local cache backend. SurrealDB (the default) and SQLite both
- * implement this; the rest of the client talks verbs, never SurrealQL.
- *
- * Reactivity is NOT part of this contract: the local cache is passive. The SSP
- * (remote) drives change; `DataModule` writes rows here and re-reads them. The
- * `epoch` field preserves the existing bucket-switch fencing (see
- * `LocalDatabaseService.epoch`): an async chain captures it at start and its
- * write is dropped if the epoch moved (a bucket switch) in between.
- */
-export interface LocalCacheEngine extends RowFetcher {
-  /** Monotonic store generation; bumped on every bucket switch. */
-  readonly epoch: number;
-&nbsp;
-  connect(bucketId: string): Promise&lt;void&gt;;
-  switchBucket(bucketId: string): Promise&lt;void&gt;;
-  close(): Promise&lt;void&gt;;
-&nbsp;
-  /** Run `fn` inside a single atomic transaction. */
-  transaction&lt;T&gt;(fn: (tx: EngineTx) =&gt; Promise&lt;T&gt;): Promise&lt;T&gt;;
-&nbsp;
-  /**
-   * Materialize a query, including its `.related()` tree (via §3
-   * decomposition). Params bind `where` `paramRef`s and any windowing id-set.
-   */
-  select(plan: QueryPlan, params?: Record&lt;string, unknown&gt;): Promise&lt;Row[]&gt;;
-&nbsp;
-  /** Fetch rows by primary id, preserving `ids` order; missing ids are skipped. */
-  selectByIds(table: string, ids: Id[], opts?: { select?: string[]; orderBy?: OrderBy }): Promise&lt;Row[]&gt;;
-&nbsp;
-  /** Single-record read by primary id, or `null`. */
-  getById(table: string, id: Id): Promise&lt;Row | null&gt;;
-&nbsp;
-  upsert(table: string, id: Id, data: Row, mode: 'replace' | 'merge'): Promise&lt;void&gt;;
-  patch(table: string, id: Id, patches: unknown[]): Promise&lt;void&gt;;
-  delete(table: string, id: Id): Promise&lt;void&gt;;
-}
-&nbsp;
-/**
- * The full surface the client's `this.local` field depends on: the
- * engine-neutral {@link LocalCacheEngine} verbs PLUS the legacy
- * SurrealQL/lifecycle methods the not-yet-migrated call sites still use.
- * `SurrealCacheEngine` (subclass of `LocalDatabaseService`) and
- * `SqliteCacheEngine` (via a SurrealQL-vocabulary shim) both satisfy this, so
- * either can back `this.local`.
- *
- * `getClient()` returns the underlying SurrealDB `Surreal` handle where one
- * exists (SurrealDB backend); backends without one (SQLite) throw — it is only
- * used by advanced/DevTools paths, never on the hot path.
- */
-export interface LocalStore extends LocalCacheEngine {
-  /**
-   * Whether this engine needs SurrealQL schema provisioning (`DEFINE TABLE`,
-   * `DEFINE FIELD`, …) run against it at init / bucket switch. SurrealDB → true;
-   * schemaless engines (SQLite creates tables lazily) → false, so the client
-   * skips the `LocalMigrator` entirely for them.
-   */
-  readonly usesSurqlSchema: boolean;
-  query&lt;T extends unknown[]&gt;(
-    query: string,
-    vars?: Record&lt;string, unknown&gt;,
-    opts?: { epoch?: number }
-  ): Promise&lt;T&gt;;
-  execute&lt;T&gt;(query: SealedQuery&lt;T&gt;, vars?: Record&lt;string, unknown&gt;, opts?: { epoch?: number }): Promise&lt;T&gt;;
-  queryUngated&lt;T extends unknown[]&gt;(query: string, vars?: Record&lt;string, unknown&gt;): Promise&lt;T&gt;;
-  switchStore(bucketId: string): Promise&lt;void&gt;;
-  beginSwitch(): () =&gt; void;
-  getEvents(): DatabaseEventSystem;
-  getClient(): unknown;
-  getConfig(): Sp00kyConfig&lt;any&gt;['database'];
-  readonly currentBucketId: string;
-  /** Which built-in backend this is. OPTIONAL: absent (custom engines) is
-   *  reported as `'custom'` by DevTools. More robust than `instanceof` for
-   *  engines constructed outside this package. */
-  readonly engineKind?: 'surrealdb' | 'sqlite';
-  /** Engine-specific storage numbers for DevTools (DB file size, per-table
-   *  row counts). OPTIONAL: only engines with something to report implement it. */
-  getStorageDiagnostics?(opts?: { tableCounts?: boolean }): Promise&lt;EngineStorageDiagnostics&gt;;
-  /**
-   * Durability of this engine's local store. OPTIONAL: engines that don't
-   * report it (SurrealDB, custom engines) are treated as `'unknown'` by the
-   * client facade, so adding this needs no change on their side.
-   */
-  readonly storageHealth?: StorageHealth;
-  /** Fires immediately with the current snapshot, then on every change.
-   *  Returns an unsubscribe function. */
-  subscribeToStorageHealth?(cb: (health: StorageHealth) =&gt; void): () =&gt; void;
-  /**
-   * Every cached row's `(id, _00_rv)` per table, ids in stable `table:id`
-   * form. The in-browser circuit primes and reconciles itself from this on
-   * boot instead of re-downloading the working set. OPTIONAL: an engine
-   * without it boots the circuit empty, as before.
-   */
-  scanVersions?(tables: string[]): Promise&lt;Record&lt;string, [string, number][]&gt;&gt;;
-  /**
-   * Circuit snapshot storage, keyed. Lives in the same durable store as the
-   * rows (OPFS SQLite), so it is per-bucket by construction, atomic, and
-   * readable by follower tabs over the port transport. OPTIONAL: an engine
-   * without it primes from `scanVersions` alone.
-   */
-  getSnapshot?(key: string): Promise&lt;StoredSnapshot | null&gt;;
-  putSnapshot?(key: string, bytes: Uint8Array, meta: SnapshotMeta): Promise&lt;void&gt;;
-  deleteSnapshot?(key: string): Promise&lt;void&gt;;
-}
-&nbsp;
-/** Describes a stored circuit snapshot; what decides whether it is usable. */
-export interface SnapshotMeta {
-  /** Bump when the wire shape the circuit reads changes. */
-  formatVersion: number;
-  /** Hash of the schema the rows were projected under. */
-  schemaHash: string;
-  savedAt: number;
-  /** Highest `_00_rv` per table at save time (diagnostics). */
-  maxRv?: Record&lt;string, number&gt;;
-  [key: string]: unknown;
-}
-&nbsp;
-export interface StoredSnapshot {
-  bytes: Uint8Array;
-  meta: SnapshotMeta;
-}
-&nbsp;
-/** Selected local cache backend. Mirrors the `persistenceClient` config pattern. */
-export type LocalEngineChoice = 'surrealdb' | 'sqlite' | LocalStore;
-&nbsp;
-/** Thrown when relation decomposition nests past {@link MAX_RELATION_DEPTH} —
- *  a guard against a cyclic schema producing unbounded fan-out. */
-export class RelationCycleError extends Error {
-  constructor(path: string[]) {
-    super(`Relation nesting exceeded safe depth; possible cyclic schema: ${path.join(' -&gt; ')}`);
-    this.name = 'RelationCycleError';
-  }
-}
-&nbsp;
-/** Defensive ceiling on relation nesting depth. A finite plan tree never hits
- *  this in practice; it exists so a malformed/cyclic plan fails loudly instead
- *  of running away. */
-export const MAX_RELATION_DEPTH = 12;
-&nbsp;
-export type { QueryPlan, RelationPlan, WhereNode };
-&nbsp;</pre></td></tr></table></pre>
-                <div class='push'></div><!-- for sticky footer -->
-            </div><!-- /wrapper -->
-            <div class='footer quiet pad2 space-top1 center small'>
-                Code coverage generated by
-                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-09-09T09:49:51.780Z
-            </div>
-        <script src="../../../prettify.js"></script>
-        <script>
-            window.onload = function () {
-                prettyPrint();
-            };
-        </script>
-        <script src="../../../sorter.js"></script>
-        <script src="../../../block-navigation.js"></script>
-    </body>
-</html>