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/relation-resolver.ts.html DELETED Viewed

@@ -1,682 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-    <title>Code coverage report for src/services/database/relation-resolver.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> relation-resolver.ts</h1>
-        <div class='clearfix'>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">95.08% </span>
-                <span class="quiet">Statements</span>
-                <span class='fraction'>116/122</span>
-            </div>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">90.47% </span>
-                <span class="quiet">Branches</span>
-                <span class='fraction'>76/84</span>
-            </div>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
-                <span class="quiet">Functions</span>
-                <span class='fraction'>7/7</span>
-            </div>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">95.08% </span>
-                <span class="quiet">Lines</span>
-                <span class='fraction'>116/122</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>
-<a name='L195'></a><a href='#L195'>195</a>
-<a name='L196'></a><a href='#L196'>196</a>
-<a name='L197'></a><a href='#L197'>197</a>
-<a name='L198'></a><a href='#L198'>198</a>
-<a name='L199'></a><a href='#L199'>199</a>
-<a name='L200'></a><a href='#L200'>200</a></td><td class="line-coverage quiet"><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-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">449x</span>
-<span class="cline-any cline-yes">449x</span>
-<span class="cline-any cline-yes">449x</span>
-<span class="cline-any cline-yes">449x</span>
-<span class="cline-any cline-yes">449x</span>
-<span class="cline-any cline-yes">449x</span>
-<span class="cline-any cline-yes">449x</span>
-<span class="cline-any cline-yes">449x</span>
-<span class="cline-any cline-yes">449x</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-yes">190x</span>
-<span class="cline-any cline-yes">190x</span>
-<span class="cline-any cline-yes">190x</span>
-<span class="cline-any cline-yes">178x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">262x</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">262x</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">528x</span>
-<span class="cline-any cline-yes">528x</span>
-<span class="cline-any cline-yes">528x</span>
-<span class="cline-any cline-yes">461x</span>
-<span class="cline-any cline-yes">528x</span>
-<span class="cline-any cline-yes">528x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">250x</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">250x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">250x</span>
-<span class="cline-any cline-yes">135x</span>
-<span class="cline-any cline-yes">135x</span>
-<span class="cline-any cline-yes">135x</span>
-<span class="cline-any cline-yes">116x</span>
-<span class="cline-any cline-yes">135x</span>
-<span class="cline-any cline-yes">238x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">262x</span>
-<span class="cline-any cline-yes">516x</span>
-<span class="cline-any cline-yes">516x</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">516x</span>
-<span class="cline-any cline-yes">229x</span>
-<span class="cline-any cline-yes">229x</span>
-<span class="cline-any cline-yes">516x</span>
-<span class="cline-any cline-yes">216x</span>
-<span class="cline-any cline-yes">216x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">516x</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">263x</span>
-<span class="cline-any cline-yes">263x</span>
-<span class="cline-any cline-yes">263x</span>
-<span class="cline-any cline-yes">263x</span>
-<span class="cline-any cline-yes">516x</span>
-<span class="cline-any cline-yes">253x</span>
-<span class="cline-any cline-yes">253x</span>
-<span class="cline-any cline-yes">516x</span>
-<span class="cline-any cline-yes">250x</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">231x</span>
-<span class="cline-any cline-yes">231x</span>
-<span class="cline-any cline-yes">225x</span>
-<span class="cline-any cline-yes">3x</span>
-<span class="cline-any cline-yes">3x</span>
-<span class="cline-any cline-yes">3x</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-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">3449x</span>
-<span class="cline-any cline-yes">3449x</span>
-<span class="cline-any cline-yes">3449x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">16x</span>
-<span class="cline-any cline-yes">16x</span>
-<span class="cline-any cline-yes">16x</span>
-<span class="cline-any cline-yes">7x</span>
-<span class="cline-any cline-yes">7x</span>
-<span class="cline-any cline-yes">9x</span>
-<span class="cline-any cline-yes">9x</span>
-<span class="cline-any cline-yes">9x</span>
-<span class="cline-any cline-yes">9x</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&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">764x</span>
-<span class="cline-any cline-yes">764x</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-yes">8x</span>
-<span class="cline-any cline-yes">764x</span>
-<span class="cline-any cline-yes">764x</span>
-<span class="cline-any cline-yes">764x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-yes">42x</span>
-<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import type { RelationPlan } from '@spooky-sync/query-builder';
-import {
-  MAX_RELATION_DEPTH,
-  RelationCycleError,
-  type OrderBy,
-  type Row,
-  type RowFetcher,
-} from './cache-engine';
-&nbsp;
-/**
- * Resolve the `.related()` tree of a query by **level-ordered, batched
- * fan-out** — the engine-neutral replacement for SurrealQL's nested
- * `(SELECT..) AS alias` projections. One batched fetch per relation per level
- * (never per-row N+1, never a flat join); grouping, per-parent ORDER/LIMIT and
- * attachment happen in JS.
- *
- * Correlation (mirrors `buildSubquery`):
- * - `one`  → parent[`foreignKeyField`] = child.id  → attach `bucket[0] ?? null`
- * - `many` → child[`foreignKeyField`] = parent.id   → attach `bucket`
- *
- * Cross-level dependency is handled by ordering: a child's correlation key is a
- * field on its parent, known only once the parent level has resolved, so each
- * level's batch runs after the previous level's rows exist. `parents` is
- * mutated in place — each resolved alias is appended LAST so key order matches
- * SurrealQL's `SELECT *, &lt;sub&gt; AS alias` (base fields, then alias).
- *
- * @throws {RelationCycleError} if nesting exceeds {@link MAX_RELATION_DEPTH}.
- */
-export async function resolveRelations(
-  parents: Row[],
-  relations: RelationPlan[] | undefined,
-  fetcher: RowFetcher,
-  depth = 0,
-  path: string[] = []
-): Promise&lt;void&gt; {
-  if (!relations || relations.length === 0 || parents.length === 0) return;
-  if (depth &gt;= MAX_RELATION_DEPTH) {
-    throw new RelationCycleError([...path, relations.map((r) =&gt; r.alias).join('|')]);
-  }
-&nbsp;
-  // Siblings are independent — resolve them concurrently.
-  await Promise.all(
-    relations.map((relation) =&gt; resolveOne(parents, relation, fetcher, depth, path))
-  );
-}
-&nbsp;
-async function resolveOne(
-  parents: Row[],
-  relation: RelationPlan,
-  fetcher: RowFetcher,
-  depth: number,
-  path: string[]
-): Promise&lt;void&gt; {
-  const isOne = relation.cardinality === 'one';
-  // The child field to match parent keys against.
-  const matchField = isOne ? 'id' : relation.foreignKeyField;
-  // How to read a parent's correlation key.
-  const parentKeyOf = (parent: Row): unknown =&gt; (isOne ? parent[relation.foreignKeyField] : parent['id']);
-&nbsp;
-  // Distinct, defined correlation keys — a null/absent FK contributes nothing
-  // (never a spurious `WHERE id = null` fetch). For a to-one relation the key
-  // must also LOOK like a record id: a `string | record&lt;t&gt;` column (whitepawn's
-  // `game.white`, a legacy plain player name in old rows) carries values that
-  // are not links, and `type::record(&lt;string&gt; "Magnus")` in the batched fetch
-  // would throw and take every sibling's name down with it.
-  const keySet = new Map&lt;string, unknown&gt;();
-  for (const parent of parents) {
-    const key = parentKeyOf(parent);
-    if (key == null) continue;
-    if (isOne &amp;&amp; !looksLikeRecordId(key)) continue;
-    const k = stableKey(key);
-    if (!keySet.has(k)) keySet.set(k, key);
-  }
-&nbsp;
-  const grouped = new Map&lt;string, Row[]&gt;();
-  if (keySet.size &gt; 0) {
-    const children = await fetcher.fetchRelation({
-      table: relation.table,
-      matchField,
-      keys: [...keySet.values()],
-      where: relation.where,
-      orderBy: relation.orderBy,
-      select: relation.select,
-    });
-&nbsp;
-    // Recurse into the next level BEFORE grouping — each child is a parent for
-    // its own relations. Resolving the full deduped child set once (rather than
-    // per parent) keeps nested fan-out at O(depth) batches. Children later
-    // dropped by a per-parent LIMIT carry resolved nested data harmlessly (they
-    // are never attached to any output row).
-    await resolveRelations(children, relation.relations, fetcher, depth + 1, [
-      ...path,
-      relation.alias,
-    ]);
-&nbsp;
-    for (const child of children) {
-      const k = stableKey(child[matchField]);
-      const bucket = grouped.get(k);
-      if (bucket) bucket.push(child);
-      else grouped.set(k, [child]);
-    }
-  }
-&nbsp;
-  for (const parent of parents) {
-    const key = parentKeyOf(parent);
-    let bucket = key == null ? [] : grouped.get(stableKey(key)) ?? [];
-&nbsp;
-    // Per-parent ORDER then LIMIT — the batch fetch's order is only a hint; a
-    // shared batch cannot express "top N per parent", so re-apply here.
-    if (relation.orderBy &amp;&amp; relation.orderBy.length &gt; 0) {
-      bucket = sortRows(bucket, relation.orderBy);
-    }
-    if (relation.limit !== undefined) {
-      bucket = bucket.slice(0, relation.limit);
-    }
-&nbsp;
-    if (isOne) {
-      // A to-one alias usually IS the foreign-key column (`.related('white')`
-      // projects onto `white`). A dangling LINK resolves to null, as SurrealQL's
-      // `(SELECT …)[0] AS alias` would. A value that is not a link at all (a
-      // legacy plain player name in a `string | record&lt;t&gt;` column) is kept: it
-      // was never going to resolve, and a renderer's fallback still needs it.
-      const raw = parent[relation.alias];
-      const keepRaw =
-        relation.alias === relation.foreignKeyField &amp;&amp; raw != null &amp;&amp; !looksLikeRecordId(raw);
-      parent[relation.alias] = bucket[0] ?? (keepRaw ? raw : null);
-    } else {
-      parent[relation.alias] = bucket;
-    }
-  }
-}
-&nbsp;
-/**
- * Whether a correlation value can address a record: a RecordId (duck-typed) or
- * a `table:id` string. Anything else (a plain display string, a number) cannot
- * be the target of a to-one relation and is skipped rather than fetched.
- */
-export function looksLikeRecordId(value: unknown): boolean {
-  if (value == null) return false;
-  if (typeof value === 'string') return /^[A-Za-z_][A-Za-z0-9_]*:.+/.test(value);
-  if (typeof value === 'object') {
-    const rid = value as { tb?: unknown; id?: unknown };
-    return rid.tb !== undefined &amp;&amp; rid.id !== undefined;
-  }
-  return false;
-}
-&nbsp;
-/**
- * Stable grouping key for a correlation value. A `RecordId` (duck-typed to
- * avoid a hard surrealdb dependency here) and its `table:id` string form must
- * collapse to the same key so a parent FK stored either way matches the child.
- */
-export function stableKey(value: unknown): string {
-  if (value == null) return 'null';
-  if (typeof value === 'string') return value;
-  if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
-    return String(value);
-  }
-  // Duck-type RecordId: { tb, id } or a toString yielding `table:id`.
-  if (typeof value === 'object') {
-    const rid = value as { tb?: unknown; id?: unknown; toString?: () =&gt; string };
-    if (rid.tb !== undefined &amp;&amp; rid.id !== undefined) {
-      return `${String(rid.tb)}:${stableKey(rid.id)}`;
-    }
-    if (typeof rid.toString === 'function') {
-      const s = rid.toString();
-      if (s !== '[object Object]') return s;
-<span class="branch-0 cbranch-no" title="branch not covered" >    }</span>
-<span class="cstat-no" title="statement not covered" >    return JSON.stringify(value);</span>
-<span class="cstat-no" title="statement not covered" ><span class="branch-0 cbranch-no" title="branch not covered" >  }</span></span>
-<span class="cstat-no" title="statement not covered" >  return String(value);</span>
-<span class="cstat-no" title="statement not covered" >}</span>
-&nbsp;
-/**
- * Stable, multi-key sort matching SurrealQL `ORDER BY` semantics closely
- * enough for cache display order: ascending null-last, type-aware compare, and
- * a stable tiebreak (original index) so equal rows keep input order.
- */
-export function sortRows(rows: Row[], orderBy: OrderBy): Row[] {
-  const indexed = rows.map((row, i) =&gt; [row, i] as const);
-  indexed.sort((a, b) =&gt; {
-    for (const [field, direction] of orderBy) {
-      const cmp = compareValues(a[0][field], b[0][field]);
-      if (cmp !== 0) return direction === 'desc' ? -cmp : cmp;
-    }
-    return a[1] - b[1]; // stable tiebreak
-  });
-  return indexed.map(([row]) =&gt; row);
-}
-&nbsp;
-function compareValues(a: unknown, b: unknown): number {
-  if (a == <span class="branch-0 cbranch-no" title="branch not covered" >null &amp;&amp; b == null) <span class="branch-0 cbranch-no" title="branch not covered" >r</span>eturn 0;</span>
-  if (a == null) <span class="branch-0 cbranch-no" title="branch not covered" >return 1; // nulls sort last (ascending)</span>
-  if (b == null) <span class="branch-0 cbranch-no" title="branch not covered" >return -1;</span>
-  if (typeof a === 'number' &amp;&amp; typeof b === 'number') return a - <span class="branch-0 cbranch-no" title="branch not covered" >b;</span>
-<span class="cstat-no" title="statement not covered" >  const as = stableKey(a);</span>
-<span class="cstat-no" title="statement not covered" >  const bs = stableKey(b);</span>
-  return as &lt; bs ? <span class="branch-0 cbranch-no" title="branch not covered" >-1 : as &gt; bs ? 1 : 0;</span>
-}
-&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>