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/client/bucket-handle.ts.html DELETED Viewed

@@ -1,766 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-    <title>Code coverage report for src/client/bucket-handle.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/client</a> bucket-handle.ts</h1>
-        <div class='clearfix'>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
-                <span class="quiet">Statements</span>
-                <span class='fraction'>141/141</span>
-            </div>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
-                <span class="quiet">Branches</span>
-                <span class='fraction'>68/68</span>
-            </div>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
-                <span class="quiet">Functions</span>
-                <span class='fraction'>18/18</span>
-            </div>
-            <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
-                <span class="quiet">Lines</span>
-                <span class='fraction'>141/141</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>
-<a name='L201'></a><a href='#L201'>201</a>
-<a name='L202'></a><a href='#L202'>202</a>
-<a name='L203'></a><a href='#L203'>203</a>
-<a name='L204'></a><a href='#L204'>204</a>
-<a name='L205'></a><a href='#L205'>205</a>
-<a name='L206'></a><a href='#L206'>206</a>
-<a name='L207'></a><a href='#L207'>207</a>
-<a name='L208'></a><a href='#L208'>208</a>
-<a name='L209'></a><a href='#L209'>209</a>
-<a name='L210'></a><a href='#L210'>210</a>
-<a name='L211'></a><a href='#L211'>211</a>
-<a name='L212'></a><a href='#L212'>212</a>
-<a name='L213'></a><a href='#L213'>213</a>
-<a name='L214'></a><a href='#L214'>214</a>
-<a name='L215'></a><a href='#L215'>215</a>
-<a name='L216'></a><a href='#L216'>216</a>
-<a name='L217'></a><a href='#L217'>217</a>
-<a name='L218'></a><a href='#L218'>218</a>
-<a name='L219'></a><a href='#L219'>219</a>
-<a name='L220'></a><a href='#L220'>220</a>
-<a name='L221'></a><a href='#L221'>221</a>
-<a name='L222'></a><a href='#L222'>222</a>
-<a name='L223'></a><a href='#L223'>223</a>
-<a name='L224'></a><a href='#L224'>224</a>
-<a name='L225'></a><a href='#L225'>225</a>
-<a name='L226'></a><a href='#L226'>226</a>
-<a name='L227'></a><a href='#L227'>227</a>
-<a name='L228'></a><a href='#L228'>228</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-yes">1x</span>
-<span class="cline-any cline-yes">10x</span>
-<span class="cline-any cline-yes">10x</span>
-<span class="cline-any cline-yes">9x</span>
-<span class="cline-any cline-yes">7x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">7x</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-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-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">22x</span>
-<span class="cline-any cline-yes">22x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">22x</span>
-<span class="cline-any cline-yes">22x</span>
-<span class="cline-any cline-yes">22x</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">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">7x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">11x</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">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">11x</span>
-<span class="cline-any cline-yes">6x</span>
-<span class="cline-any cline-yes">6x</span>
-<span class="cline-any cline-yes">6x</span>
-<span class="cline-any cline-yes">6x</span>
-<span class="cline-any cline-yes">6x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">11x</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">11x</span>
-<span class="cline-any cline-yes">11x</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">10x</span>
-<span class="cline-any cline-yes">10x</span>
-<span class="cline-any cline-yes">8x</span>
-<span class="cline-any cline-yes">8x</span>
-<span class="cline-any cline-yes">10x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">10x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">3x</span>
-<span class="cline-any cline-yes">10x</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">10x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">5x</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">10x</span>
-<span class="cline-any cline-yes">6x</span>
-<span class="cline-any cline-yes">10x</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">2x</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">2x</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-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-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-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-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">5x</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">3x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">3x</span>
-<span class="cline-any cline-yes">3x</span>
-<span class="cline-any cline-yes">5x</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-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-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-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-yes">1x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</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></td><td class="text"><pre class="prettyprint lang-js">import type { RemoteDatabaseService } from '../services/database/remote';
-import type { BlobCache, BlobReadOptions, BlobUrlLease } from '../services/blobs/index';
-import {
-  blurhashSidecarPath,
-  encodeImageToBlurhash,
-  isImagePath,
-  isBlurhashValid,
-  type BlurhashSetting,
-  type BlurhashEncodeOptions,
-} from '../utils/blurhash';
-&nbsp;
-/** Coerce whatever the `.get()` RPC hands back into a Blob. */
-export function bucketContentToBlob(content: unknown): Blob | null {
-  if (content == null) return null;
-  if (content instanceof Blob) return content;
-  if (typeof content === 'string') return new Blob([content]);
-  if (content instanceof ArrayBuffer) return new Blob([content]);
-  // Uint8Array and friends. The cast sidesteps `ArrayBufferLike` vs
-  // `ArrayBuffer` (SharedArrayBuffer) in lib.dom's BlobPart.
-  if (ArrayBuffer.isView(content)) return new Blob([content as unknown as BlobPart]);
-  return null;
-}
-&nbsp;
-export interface BucketPutOptions {
-  /** Override the client-level {@link Sp00kyConfig.blurhash} setting for this put. */
-  blurhash?: BlurhashSetting;
-}
-&nbsp;
-export interface BucketPutResult {
-  /** The computed blurhash when the content was a hashable image; else null. */
-  blurhash: string | null;
-}
-&nbsp;
-interface BucketHandleSettings {
-  blurhash?: BlurhashSetting;
-  logger?: { warn: (obj: unknown, msg?: string) =&gt; void };
-}
-&nbsp;
-/**
- * Paths known to have no blurhash sidecar, per tab. The blob cache has no
- * negative caching, so without this every mount of a hashless image would pay
- * one serialized remote read. Cleared when a put writes a sidecar or a delete
- * removes the image. Keyed `${bucket}:${path}` (the image path, not the sidecar).
- */
-const missingBlurhash = new Set&lt;string&gt;();
-&nbsp;
-export class BucketHandle {
-  constructor(
-    private bucketName: string,
-    private remote: RemoteDatabaseService,
-    /** Absent on the raw handle the cache itself reads through. */
-    private blobs?: BlobCache | null,
-    private settings?: BucketHandleSettings
-  ) {}
-&nbsp;
-  /** Effective blurhash setting: per-call option &gt; client config &gt; default ON. */
-  private resolveBlurhash(option?: BlurhashSetting): BlurhashEncodeOptions | null {
-    const setting = option ?? this.settings?.blurhash ?? true;
-    if (setting === false) return null;
-    return setting === true ? {} : setting;
-  }
-&nbsp;
-  async put(
-    path: string,
-    content: string | Uint8Array | Blob,
-    options?: BucketPutOptions
-  ): Promise&lt;BucketPutResult&gt; {
-    // Start hashing while the upload is in flight; both browser-side costs
-    // overlap and the sidecar put only queues once the main put resolved.
-    const encodeOptions = this.resolveBlurhash(options?.blurhash);
-    const hashPromise =
-      encodeOptions &amp;&amp; isImagePath(path)
-        ? encodeImageToBlurhash(content, encodeOptions)
-        : Promise.resolve(null);
-&nbsp;
-    await this.remote.query(`RETURN f"${this.bucketName}:/${path}".put($content);`, { content });
-    // A path can be overwritten, so anything cached under it is now wrong.
-    await this.blobs?.invalidate({ bucket: this.bucketName, path });
-&nbsp;
-    // The sidecar is best-effort: a hash or sidecar failure must never fail
-    // the image put that triggered it.
-    let hash: string | null = null;
-    try {
-      hash = await hashPromise;
-      if (hash) {
-        const sidecar = blurhashSidecarPath(path);
-        await this.remote.query(`RETURN f"${this.bucketName}:/${sidecar}".put($content);`, {
-          content: hash,
-        });
-        await this.blobs?.invalidate({ bucket: this.bucketName, path: sidecar });
-        missingBlurhash.delete(`${this.bucketName}:${path}`);
-      }
-    } catch (error) {
-      hash = null;
-      this.settings?.logger?.warn({ error, path }, 'blurhash sidecar put failed');
-    }
-    return { blurhash: hash };
-  }
-&nbsp;
-  /**
-   * The blurhash stored alongside an uploaded image (see
-   * {@link blurhashSidecarPath}), or null when there is none. Reads through the
-   * blob cache, so a warm client answers from OPFS without a network hop, and
-   * misses are remembered per tab so a hashless image costs at most one
-   * serialized remote read per session.
-   */
-  async blurhash(path: string): Promise&lt;string | null&gt; {
-    const cacheKey = `${this.bucketName}:${path}`;
-    if (missingBlurhash.has(cacheKey)) return null;
-    try {
-      const blob = await this.read(blurhashSidecarPath(path), { persist: true });
-      if (!blob) {
-        missingBlurhash.add(cacheKey);
-        return null;
-      }
-      const hash = (await blob.text()).trim();
-      if (!isBlurhashValid(hash).result) {
-        this.settings?.logger?.warn({ path }, 'blurhash sidecar holds an invalid hash');
-        missingBlurhash.add(cacheKey);
-        return null;
-      }
-      return hash;
-    } catch (error) {
-      // Transient failure: do NOT negative-cache, the next mount may succeed.
-      this.settings?.logger?.warn({ error, path }, 'blurhash sidecar read failed');
-      return null;
-    }
-  }
-&nbsp;
-  async get(path: string): Promise&lt;unknown&gt; {
-    const [result] = await this.remote.query&lt;[unknown]&gt;(
-      `RETURN f"${this.bucketName}:/${path}".get();`
-    );
-    return result;
-  }
-&nbsp;
-  /**
-   * Read through the local blob cache: OPFS first, the bucket second. Unlike
-   * {@link get} this survives a reload and works offline. Returns null when the
-   * file exists in neither place.
-   */
-  async read(path: string, options?: BlobReadOptions): Promise&lt;Blob | null&gt; {
-    if (!this.blobs) return bucketContentToBlob(await this.get(path));
-    return this.blobs.read({ bucket: this.bucketName, path }, options);
-  }
-&nbsp;
-  /**
-   * A refcounted object URL for `path`, suitable for `&lt;img src&gt;`. The caller
-   * MUST call `release()` when the URL goes off screen. Returns null when the
-   * file does not exist, or when object URLs are unavailable (non-browser).
-   */
-  async url(path: string, options?: BlobReadOptions): Promise&lt;BlobUrlLease | null&gt; {
-    if (!this.blobs) return null;
-    return this.blobs.acquireUrl({ bucket: this.bucketName, path }, options);
-  }
-&nbsp;
-  /** Exempt `path` from pressure eviction. Pinned bytes never expire. */
-  pin(path: string): void {
-    this.blobs?.setPinned({ bucket: this.bucketName, path }, true);
-  }
-&nbsp;
-  unpin(path: string): void {
-    this.blobs?.setPinned({ bucket: this.bucketName, path }, false);
-  }
-&nbsp;
-  /** Drop `path` from the local cache without touching the remote file. */
-  async evict(path: string): Promise&lt;void&gt; {
-    await this.blobs?.invalidate({ bucket: this.bucketName, path });
-  }
-&nbsp;
-  /** Warm the cache for offline use. Already-cached paths are skipped. */
-  async prefetch(paths: string[]): Promise&lt;void&gt; {
-    await this.blobs?.prefetch(paths.map((path) =&gt; ({ bucket: this.bucketName, path })));
-  }
-&nbsp;
-  async delete(path: string): Promise&lt;void&gt; {
-    await this.remote.query(`RETURN f"${this.bucketName}:/${path}".delete();`);
-    await this.blobs?.invalidate({ bucket: this.bucketName, path });
-    // Symmetry with put: an image's blurhash sidecar dies with it. Best-effort,
-    // the sidecar may simply not exist.
-    if (isImagePath(path)) {
-      const sidecar = blurhashSidecarPath(path);
-      try {
-        await this.remote.query(`RETURN f"${this.bucketName}:/${sidecar}".delete();`);
-        await this.blobs?.invalidate({ bucket: this.bucketName, path: sidecar });
-      } catch {
-        // Nothing to clean up.
-      }
-      missingBlurhash.delete(`${this.bucketName}:${path}`);
-    }
-  }
-&nbsp;
-  async exists(path: string): Promise&lt;boolean&gt; {
-    const [result] = await this.remote.query&lt;[boolean]&gt;(
-      `RETURN f"${this.bucketName}:/${path}".exists();`
-    );
-    return result;
-  }
-&nbsp;
-  async head(path: string): Promise&lt;Record&lt;string, unknown&gt;&gt; {
-    const [result] = await this.remote.query&lt;[Record&lt;string, unknown&gt;]&gt;(
-      `RETURN f"${this.bucketName}:/${path}".head();`
-    );
-    return result;
-  }
-&nbsp;
-  async copy(sourcePath: string, targetPath: string): Promise&lt;void&gt; {
-    await this.remote.query(`RETURN f"${this.bucketName}:/${sourcePath}".copy($target);`, {
-      target: targetPath,
-    });
-  }
-&nbsp;
-  async rename(sourcePath: string, targetPath: string): Promise&lt;void&gt; {
-    await this.remote.query(`RETURN f"${this.bucketName}:/${sourcePath}".rename($target);`, {
-      target: targetPath,
-    });
-  }
-&nbsp;
-  async list(prefix?: string): Promise&lt;string[]&gt; {
-    const p = prefix ?? '';
-    const [result] = await this.remote.query&lt;[string[]]&gt;(
-      `RETURN f"${this.bucketName}:/${p}".list();`
-    );
-    return result;
-  }
-}
-&nbsp;
-&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>