@rocicorp/zero 1.11.0-canary.4 → 1.11.0-canary.41

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 (1015) hide show
  1. package/out/analyze-query/src/analyze-cli.js +4 -4
  2. package/out/analyze-query/src/analyze-cli.js.map +1 -1
  3. package/out/analyze-query/src/bin-analyze.js +13 -12
  4. package/out/analyze-query/src/bin-analyze.js.map +1 -1
  5. package/out/analyze-query/src/bin-transform.js +1 -1
  6. package/out/analyze-query/src/bin-transform.js.map +1 -1
  7. package/out/ast-to-zql/src/ast-to-zql.d.ts +8 -1
  8. package/out/ast-to-zql/src/ast-to-zql.d.ts.map +1 -1
  9. package/out/ast-to-zql/src/ast-to-zql.js +25 -25
  10. package/out/ast-to-zql/src/ast-to-zql.js.map +1 -1
  11. package/out/otel/src/log-options.d.ts +16 -0
  12. package/out/otel/src/log-options.d.ts.map +1 -1
  13. package/out/otel/src/log-options.js +60 -6
  14. package/out/otel/src/log-options.js.map +1 -1
  15. package/out/replicache/src/bg-interval.d.ts +2 -1
  16. package/out/replicache/src/bg-interval.d.ts.map +1 -1
  17. package/out/replicache/src/bg-interval.js +13 -4
  18. package/out/replicache/src/bg-interval.js.map +1 -1
  19. package/out/replicache/src/btree/node.d.ts.map +1 -1
  20. package/out/replicache/src/btree/node.js +3 -6
  21. package/out/replicache/src/btree/node.js.map +1 -1
  22. package/out/replicache/src/dag/gc.d.ts.map +1 -1
  23. package/out/replicache/src/dag/gc.js +8 -11
  24. package/out/replicache/src/dag/gc.js.map +1 -1
  25. package/out/replicache/src/dag/invalid-ref-count-error.d.ts +12 -0
  26. package/out/replicache/src/dag/invalid-ref-count-error.d.ts.map +1 -0
  27. package/out/replicache/src/dag/invalid-ref-count-error.js +19 -0
  28. package/out/replicache/src/dag/invalid-ref-count-error.js.map +1 -0
  29. package/out/replicache/src/dag/lazy-store.d.ts +17 -4
  30. package/out/replicache/src/dag/lazy-store.d.ts.map +1 -1
  31. package/out/replicache/src/dag/lazy-store.js +35 -9
  32. package/out/replicache/src/dag/lazy-store.js.map +1 -1
  33. package/out/replicache/src/dag/store-impl.d.ts +12 -2
  34. package/out/replicache/src/dag/store-impl.d.ts.map +1 -1
  35. package/out/replicache/src/dag/store-impl.js +29 -9
  36. package/out/replicache/src/dag/store-impl.js.map +1 -1
  37. package/out/replicache/src/db/rebase.d.ts +14 -2
  38. package/out/replicache/src/db/rebase.d.ts.map +1 -1
  39. package/out/replicache/src/db/rebase.js +27 -5
  40. package/out/replicache/src/db/rebase.js.map +1 -1
  41. package/out/replicache/src/get-kv-store-provider.d.ts +1 -1
  42. package/out/replicache/src/get-kv-store-provider.d.ts.map +1 -1
  43. package/out/replicache/src/get-kv-store-provider.js +4 -4
  44. package/out/replicache/src/get-kv-store-provider.js.map +1 -1
  45. package/out/replicache/src/kv/expo-sqlite/store.d.ts.map +1 -1
  46. package/out/replicache/src/kv/expo-sqlite/store.js +28 -5
  47. package/out/replicache/src/kv/expo-sqlite/store.js.map +1 -1
  48. package/out/replicache/src/kv/idb-store.d.ts +18 -0
  49. package/out/replicache/src/kv/idb-store.d.ts.map +1 -1
  50. package/out/replicache/src/kv/idb-store.js +30 -2
  51. package/out/replicache/src/kv/idb-store.js.map +1 -1
  52. package/out/replicache/src/kv/mem-fallback-store.d.ts +54 -0
  53. package/out/replicache/src/kv/mem-fallback-store.d.ts.map +1 -0
  54. package/out/replicache/src/kv/mem-fallback-store.js +177 -0
  55. package/out/replicache/src/kv/mem-fallback-store.js.map +1 -0
  56. package/out/replicache/src/kv/mem-store.d.ts +1 -0
  57. package/out/replicache/src/kv/mem-store.d.ts.map +1 -1
  58. package/out/replicache/src/kv/mem-store.js +3 -0
  59. package/out/replicache/src/kv/mem-store.js.map +1 -1
  60. package/out/replicache/src/kv/op-sqlite/store.d.ts.map +1 -1
  61. package/out/replicache/src/kv/op-sqlite/store.js +4 -4
  62. package/out/replicache/src/kv/op-sqlite/store.js.map +1 -1
  63. package/out/replicache/src/kv/sqlite-store.d.ts +22 -1
  64. package/out/replicache/src/kv/sqlite-store.d.ts.map +1 -1
  65. package/out/replicache/src/kv/sqlite-store.js +159 -14
  66. package/out/replicache/src/kv/sqlite-store.js.map +1 -1
  67. package/out/replicache/src/kv/store.d.ts +6 -0
  68. package/out/replicache/src/kv/store.d.ts.map +1 -1
  69. package/out/replicache/src/new-client-channel.js.map +1 -1
  70. package/out/replicache/src/persist/client-gc.d.ts +2 -1
  71. package/out/replicache/src/persist/client-gc.d.ts.map +1 -1
  72. package/out/replicache/src/persist/client-gc.js +2 -2
  73. package/out/replicache/src/persist/client-gc.js.map +1 -1
  74. package/out/replicache/src/persist/client-group-gc.d.ts +2 -1
  75. package/out/replicache/src/persist/client-group-gc.d.ts.map +1 -1
  76. package/out/replicache/src/persist/client-group-gc.js +2 -2
  77. package/out/replicache/src/persist/client-group-gc.js.map +1 -1
  78. package/out/replicache/src/persist/clients.d.ts +2 -2
  79. package/out/replicache/src/persist/collect-idb-databases.d.ts +28 -8
  80. package/out/replicache/src/persist/collect-idb-databases.d.ts.map +1 -1
  81. package/out/replicache/src/persist/collect-idb-databases.js +97 -20
  82. package/out/replicache/src/persist/collect-idb-databases.js.map +1 -1
  83. package/out/replicache/src/persist/heartbeat.d.ts +2 -1
  84. package/out/replicache/src/persist/heartbeat.d.ts.map +1 -1
  85. package/out/replicache/src/persist/heartbeat.js +2 -2
  86. package/out/replicache/src/persist/heartbeat.js.map +1 -1
  87. package/out/replicache/src/persist/idb-databases-store-db-name.js +1 -1
  88. package/out/replicache/src/persist/idb-databases-store-db-name.js.map +1 -1
  89. package/out/replicache/src/persist/persist.d.ts.map +1 -1
  90. package/out/replicache/src/persist/persist.js +18 -8
  91. package/out/replicache/src/persist/persist.js.map +1 -1
  92. package/out/replicache/src/persist/refresh.js +6 -2
  93. package/out/replicache/src/persist/refresh.js.map +1 -1
  94. package/out/replicache/src/replicache-impl.d.ts +85 -3
  95. package/out/replicache/src/replicache-impl.d.ts.map +1 -1
  96. package/out/replicache/src/replicache-impl.js +321 -29
  97. package/out/replicache/src/replicache-impl.js.map +1 -1
  98. package/out/replicache/src/replicache-options.d.ts +9 -0
  99. package/out/replicache/src/replicache-options.d.ts.map +1 -1
  100. package/out/replicache/src/storage-failure.d.ts +37 -0
  101. package/out/replicache/src/storage-failure.d.ts.map +1 -0
  102. package/out/replicache/src/storage-failure.js +31 -0
  103. package/out/replicache/src/storage-failure.js.map +1 -0
  104. package/out/shared/src/arrays.d.ts +5 -0
  105. package/out/shared/src/arrays.d.ts.map +1 -1
  106. package/out/shared/src/arrays.js +8 -10
  107. package/out/shared/src/arrays.js.map +1 -1
  108. package/out/shared/src/centroid.d.ts +0 -1
  109. package/out/shared/src/centroid.d.ts.map +1 -1
  110. package/out/shared/src/centroid.js +1 -4
  111. package/out/shared/src/centroid.js.map +1 -1
  112. package/out/shared/src/error.d.ts +11 -0
  113. package/out/shared/src/error.d.ts.map +1 -1
  114. package/out/shared/src/error.js +35 -1
  115. package/out/shared/src/error.js.map +1 -1
  116. package/out/shared/src/hash.d.ts.map +1 -1
  117. package/out/shared/src/hash.js +32 -7
  118. package/out/shared/src/hash.js.map +1 -1
  119. package/out/shared/src/iterables.d.ts +2 -0
  120. package/out/shared/src/iterables.d.ts.map +1 -1
  121. package/out/shared/src/iterables.js +18 -1
  122. package/out/shared/src/iterables.js.map +1 -1
  123. package/out/shared/src/map.d.ts +24 -2
  124. package/out/shared/src/map.d.ts.map +1 -1
  125. package/out/shared/src/map.js +18 -4
  126. package/out/shared/src/map.js.map +1 -1
  127. package/out/shared/src/options-types.d.ts +2 -2
  128. package/out/shared/src/options.d.ts.map +1 -1
  129. package/out/shared/src/options.js +10 -7
  130. package/out/shared/src/options.js.map +1 -1
  131. package/out/shared/src/random-values.js +12 -1
  132. package/out/shared/src/random-values.js.map +1 -1
  133. package/out/shared/src/ring-buffer.d.ts +10 -0
  134. package/out/shared/src/ring-buffer.d.ts.map +1 -1
  135. package/out/shared/src/ring-buffer.js +26 -1
  136. package/out/shared/src/ring-buffer.js.map +1 -1
  137. package/out/shared/src/tdigest.d.ts +10 -0
  138. package/out/shared/src/tdigest.d.ts.map +1 -1
  139. package/out/shared/src/tdigest.js +147 -63
  140. package/out/shared/src/tdigest.js.map +1 -1
  141. package/out/shared/src/valita.d.ts +88 -0
  142. package/out/shared/src/valita.d.ts.map +1 -1
  143. package/out/shared/src/valita.js +141 -23
  144. package/out/shared/src/valita.js.map +1 -1
  145. package/out/z2s/src/compiler.d.ts.map +1 -1
  146. package/out/z2s/src/compiler.js +10 -6
  147. package/out/z2s/src/compiler.js.map +1 -1
  148. package/out/z2s/src/sql.d.ts.map +1 -1
  149. package/out/z2s/src/sql.js +9 -5
  150. package/out/z2s/src/sql.js.map +1 -1
  151. package/out/zero/package.js +5 -6
  152. package/out/zero/package.js.map +1 -1
  153. package/out/zero/src/zero.js +2 -1
  154. package/out/zero-cache/src/auth/write-authorizer.d.ts.map +1 -1
  155. package/out/zero-cache/src/auth/write-authorizer.js +1 -0
  156. package/out/zero-cache/src/auth/write-authorizer.js.map +1 -1
  157. package/out/zero-cache/src/config/normalize.d.ts +1 -0
  158. package/out/zero-cache/src/config/normalize.d.ts.map +1 -1
  159. package/out/zero-cache/src/config/normalize.js +47 -4
  160. package/out/zero-cache/src/config/normalize.js.map +1 -1
  161. package/out/zero-cache/src/config/zero-config.d.ts +148 -25
  162. package/out/zero-cache/src/config/zero-config.d.ts.map +1 -1
  163. package/out/zero-cache/src/config/zero-config.js +500 -167
  164. package/out/zero-cache/src/config/zero-config.js.map +1 -1
  165. package/out/zero-cache/src/custom/fetch.d.ts +1 -1
  166. package/out/zero-cache/src/custom/fetch.d.ts.map +1 -1
  167. package/out/zero-cache/src/custom/fetch.js.map +1 -1
  168. package/out/zero-cache/src/db/lite-tables.d.ts.map +1 -1
  169. package/out/zero-cache/src/db/lite-tables.js +3 -4
  170. package/out/zero-cache/src/db/lite-tables.js.map +1 -1
  171. package/out/zero-cache/src/db/migration-lite.d.ts.map +1 -1
  172. package/out/zero-cache/src/db/migration-lite.js +5 -3
  173. package/out/zero-cache/src/db/migration-lite.js.map +1 -1
  174. package/out/zero-cache/src/observability/events.js +4 -1
  175. package/out/zero-cache/src/observability/events.js.map +1 -1
  176. package/out/zero-cache/src/observability/log-throttle.d.ts +44 -0
  177. package/out/zero-cache/src/observability/log-throttle.d.ts.map +1 -0
  178. package/out/zero-cache/src/observability/log-throttle.js +76 -0
  179. package/out/zero-cache/src/observability/log-throttle.js.map +1 -0
  180. package/out/zero-cache/src/observability/metrics.d.ts.map +1 -1
  181. package/out/zero-cache/src/observability/metrics.js +2 -7
  182. package/out/zero-cache/src/observability/metrics.js.map +1 -1
  183. package/out/zero-cache/src/scripts/permissions.d.ts +16 -0
  184. package/out/zero-cache/src/scripts/permissions.d.ts.map +1 -1
  185. package/out/zero-cache/src/scripts/permissions.js +3 -3
  186. package/out/zero-cache/src/scripts/permissions.js.map +1 -1
  187. package/out/zero-cache/src/server/change-streamer.d.ts.map +1 -1
  188. package/out/zero-cache/src/server/change-streamer.js +123 -87
  189. package/out/zero-cache/src/server/change-streamer.js.map +1 -1
  190. package/out/zero-cache/src/server/inspector-delegate.d.ts +28 -2
  191. package/out/zero-cache/src/server/inspector-delegate.d.ts.map +1 -1
  192. package/out/zero-cache/src/server/inspector-delegate.js +37 -17
  193. package/out/zero-cache/src/server/inspector-delegate.js.map +1 -1
  194. package/out/zero-cache/src/server/main.d.ts.map +1 -1
  195. package/out/zero-cache/src/server/main.js +13 -2
  196. package/out/zero-cache/src/server/main.js.map +1 -1
  197. package/out/zero-cache/src/server/mutator.js +2 -0
  198. package/out/zero-cache/src/server/mutator.js.map +1 -1
  199. package/out/zero-cache/src/server/reaper.d.ts.map +1 -1
  200. package/out/zero-cache/src/server/reaper.js +2 -0
  201. package/out/zero-cache/src/server/reaper.js.map +1 -1
  202. package/out/zero-cache/src/server/replicator.d.ts +7 -0
  203. package/out/zero-cache/src/server/replicator.d.ts.map +1 -1
  204. package/out/zero-cache/src/server/replicator.js +103 -22
  205. package/out/zero-cache/src/server/replicator.js.map +1 -1
  206. package/out/zero-cache/src/server/runner/run-worker.d.ts.map +1 -1
  207. package/out/zero-cache/src/server/runner/run-worker.js +12 -6
  208. package/out/zero-cache/src/server/runner/run-worker.js.map +1 -1
  209. package/out/zero-cache/src/server/runner/zero-dispatcher.d.ts.map +1 -1
  210. package/out/zero-cache/src/server/runner/zero-dispatcher.js +5 -0
  211. package/out/zero-cache/src/server/runner/zero-dispatcher.js.map +1 -1
  212. package/out/zero-cache/src/server/slot-keeper.d.ts +26 -0
  213. package/out/zero-cache/src/server/slot-keeper.d.ts.map +1 -0
  214. package/out/zero-cache/src/server/slot-keeper.js +181 -0
  215. package/out/zero-cache/src/server/slot-keeper.js.map +1 -0
  216. package/out/zero-cache/src/server/syncer-assigner.d.ts +14 -0
  217. package/out/zero-cache/src/server/syncer-assigner.d.ts.map +1 -0
  218. package/out/zero-cache/src/server/syncer-assigner.js +72 -0
  219. package/out/zero-cache/src/server/syncer-assigner.js.map +1 -0
  220. package/out/zero-cache/src/server/syncer.d.ts.map +1 -1
  221. package/out/zero-cache/src/server/syncer.js +40 -2
  222. package/out/zero-cache/src/server/syncer.js.map +1 -1
  223. package/out/zero-cache/src/server/worker-dispatcher.d.ts.map +1 -1
  224. package/out/zero-cache/src/server/worker-dispatcher.js +21 -4
  225. package/out/zero-cache/src/server/worker-dispatcher.js.map +1 -1
  226. package/out/zero-cache/src/server/worker-urls.d.ts +1 -0
  227. package/out/zero-cache/src/server/worker-urls.d.ts.map +1 -1
  228. package/out/zero-cache/src/server/worker-urls.js +2 -1
  229. package/out/zero-cache/src/server/worker-urls.js.map +1 -1
  230. package/out/zero-cache/src/services/analyze.d.ts.map +1 -1
  231. package/out/zero-cache/src/services/analyze.js +11 -9
  232. package/out/zero-cache/src/services/analyze.js.map +1 -1
  233. package/out/zero-cache/src/services/change-source/common/backfill-manager.d.ts.map +1 -1
  234. package/out/zero-cache/src/services/change-source/common/backfill-manager.js +198 -24
  235. package/out/zero-cache/src/services/change-source/common/backfill-manager.js.map +1 -1
  236. package/out/zero-cache/src/services/change-source/common/change-stream-multiplexer.d.ts.map +1 -1
  237. package/out/zero-cache/src/services/change-source/common/change-stream-multiplexer.js +16 -4
  238. package/out/zero-cache/src/services/change-source/common/change-stream-multiplexer.js.map +1 -1
  239. package/out/zero-cache/src/services/change-source/common/init-cleanup.d.ts +24 -0
  240. package/out/zero-cache/src/services/change-source/common/init-cleanup.d.ts.map +1 -0
  241. package/out/zero-cache/src/services/change-source/common/init-cleanup.js +44 -0
  242. package/out/zero-cache/src/services/change-source/common/init-cleanup.js.map +1 -0
  243. package/out/zero-cache/src/services/change-source/common/replica-restore.d.ts +82 -2
  244. package/out/zero-cache/src/services/change-source/common/replica-restore.d.ts.map +1 -1
  245. package/out/zero-cache/src/services/change-source/common/replica-restore.js +21 -10
  246. package/out/zero-cache/src/services/change-source/common/replica-restore.js.map +1 -1
  247. package/out/zero-cache/src/services/change-source/common/replica-schema.d.ts +1 -0
  248. package/out/zero-cache/src/services/change-source/common/replica-schema.d.ts.map +1 -1
  249. package/out/zero-cache/src/services/change-source/common/replica-schema.js +15 -3
  250. package/out/zero-cache/src/services/change-source/common/replica-schema.js.map +1 -1
  251. package/out/zero-cache/src/services/change-source/custom/change-source.d.ts +1 -1
  252. package/out/zero-cache/src/services/change-source/custom/change-source.d.ts.map +1 -1
  253. package/out/zero-cache/src/services/change-source/custom/change-source.js +7 -3
  254. package/out/zero-cache/src/services/change-source/custom/change-source.js.map +1 -1
  255. package/out/zero-cache/src/services/change-source/pg/backfill-stream.d.ts +9 -0
  256. package/out/zero-cache/src/services/change-source/pg/backfill-stream.d.ts.map +1 -1
  257. package/out/zero-cache/src/services/change-source/pg/backfill-stream.js +213 -21
  258. package/out/zero-cache/src/services/change-source/pg/backfill-stream.js.map +1 -1
  259. package/out/zero-cache/src/services/change-source/pg/change-source-init.d.ts +65 -0
  260. package/out/zero-cache/src/services/change-source/pg/change-source-init.d.ts.map +1 -0
  261. package/out/zero-cache/src/services/change-source/pg/change-source-init.js +312 -0
  262. package/out/zero-cache/src/services/change-source/pg/change-source-init.js.map +1 -0
  263. package/out/zero-cache/src/services/change-source/pg/change-source.d.ts +31 -18
  264. package/out/zero-cache/src/services/change-source/pg/change-source.d.ts.map +1 -1
  265. package/out/zero-cache/src/services/change-source/pg/change-source.js +132 -157
  266. package/out/zero-cache/src/services/change-source/pg/change-source.js.map +1 -1
  267. package/out/zero-cache/src/services/change-source/pg/initial-sync.d.ts +44 -2
  268. package/out/zero-cache/src/services/change-source/pg/initial-sync.d.ts.map +1 -1
  269. package/out/zero-cache/src/services/change-source/pg/initial-sync.js +65 -28
  270. package/out/zero-cache/src/services/change-source/pg/initial-sync.js.map +1 -1
  271. package/out/zero-cache/src/services/change-source/pg/logical-replication/stream.d.ts +66 -1
  272. package/out/zero-cache/src/services/change-source/pg/logical-replication/stream.d.ts.map +1 -1
  273. package/out/zero-cache/src/services/change-source/pg/logical-replication/stream.js +207 -24
  274. package/out/zero-cache/src/services/change-source/pg/logical-replication/stream.js.map +1 -1
  275. package/out/zero-cache/src/services/change-source/pg/replication-slot-cleanup-monitor.d.ts +16 -0
  276. package/out/zero-cache/src/services/change-source/pg/replication-slot-cleanup-monitor.d.ts.map +1 -0
  277. package/out/zero-cache/src/services/change-source/pg/replication-slot-cleanup-monitor.js +113 -0
  278. package/out/zero-cache/src/services/change-source/pg/replication-slot-cleanup-monitor.js.map +1 -0
  279. package/out/zero-cache/src/services/change-source/pg/replication-slots.d.ts +66 -21
  280. package/out/zero-cache/src/services/change-source/pg/replication-slots.d.ts.map +1 -1
  281. package/out/zero-cache/src/services/change-source/pg/replication-slots.js +274 -68
  282. package/out/zero-cache/src/services/change-source/pg/replication-slots.js.map +1 -1
  283. package/out/zero-cache/src/services/change-source/pg/schema/index-predicate.d.ts.map +1 -1
  284. package/out/zero-cache/src/services/change-source/pg/schema/index-predicate.js +68 -8
  285. package/out/zero-cache/src/services/change-source/pg/schema/index-predicate.js.map +1 -1
  286. package/out/zero-cache/src/services/change-source/pg/schema/init.d.ts.map +1 -1
  287. package/out/zero-cache/src/services/change-source/pg/schema/init.js +46 -1
  288. package/out/zero-cache/src/services/change-source/pg/schema/init.js.map +1 -1
  289. package/out/zero-cache/src/services/change-source/pg/schema/replica-stage-enum.d.ts +10 -0
  290. package/out/zero-cache/src/services/change-source/pg/schema/replica-stage-enum.d.ts.map +1 -0
  291. package/out/zero-cache/src/services/change-source/pg/schema/replica-stage-enum.js +6 -0
  292. package/out/zero-cache/src/services/change-source/pg/schema/replica-stage-enum.js.map +1 -0
  293. package/out/zero-cache/src/services/change-source/pg/schema/shard.d.ts +68 -27
  294. package/out/zero-cache/src/services/change-source/pg/schema/shard.d.ts.map +1 -1
  295. package/out/zero-cache/src/services/change-source/pg/schema/shard.js +116 -35
  296. package/out/zero-cache/src/services/change-source/pg/schema/shard.js.map +1 -1
  297. package/out/zero-cache/src/services/change-source/protocol/backfill-progress.d.ts +68 -0
  298. package/out/zero-cache/src/services/change-source/protocol/backfill-progress.d.ts.map +1 -0
  299. package/out/zero-cache/src/services/change-source/protocol/backfill-progress.js +141 -0
  300. package/out/zero-cache/src/services/change-source/protocol/backfill-progress.js.map +1 -0
  301. package/out/zero-cache/src/services/change-source/protocol/current/data.d.ts +45 -2
  302. package/out/zero-cache/src/services/change-source/protocol/current/data.d.ts.map +1 -1
  303. package/out/zero-cache/src/services/change-source/protocol/current/data.js +10 -1
  304. package/out/zero-cache/src/services/change-source/protocol/current/data.js.map +1 -1
  305. package/out/zero-cache/src/services/change-source/protocol/current/downstream.d.ts +60 -3
  306. package/out/zero-cache/src/services/change-source/protocol/current/downstream.d.ts.map +1 -1
  307. package/out/zero-cache/src/services/change-source/protocol/current/upstream.d.ts +23 -10
  308. package/out/zero-cache/src/services/change-source/protocol/current/upstream.d.ts.map +1 -1
  309. package/out/zero-cache/src/services/change-source/protocol/current/upstream.js +17 -7
  310. package/out/zero-cache/src/services/change-source/protocol/current/upstream.js.map +1 -1
  311. package/out/zero-cache/src/services/change-source/protocol/current.js +2 -1
  312. package/out/zero-cache/src/services/change-streamer/backfill-state-tracker.d.ts +72 -0
  313. package/out/zero-cache/src/services/change-streamer/backfill-state-tracker.d.ts.map +1 -0
  314. package/out/zero-cache/src/services/change-streamer/backfill-state-tracker.js +162 -0
  315. package/out/zero-cache/src/services/change-streamer/backfill-state-tracker.js.map +1 -0
  316. package/out/zero-cache/src/services/change-streamer/backfill-state.d.ts +50 -0
  317. package/out/zero-cache/src/services/change-streamer/backfill-state.d.ts.map +1 -0
  318. package/out/zero-cache/src/services/change-streamer/backfill-state.js +268 -0
  319. package/out/zero-cache/src/services/change-streamer/backfill-state.js.map +1 -0
  320. package/out/zero-cache/src/services/change-streamer/backup-cleanup-monitor-factory.d.ts.map +1 -1
  321. package/out/zero-cache/src/services/change-streamer/backup-cleanup-monitor-factory.js +6 -17
  322. package/out/zero-cache/src/services/change-streamer/backup-cleanup-monitor-factory.js.map +1 -1
  323. package/out/zero-cache/src/services/change-streamer/backup-monitor.d.ts.map +1 -1
  324. package/out/zero-cache/src/services/change-streamer/backup-monitor.js +59 -8
  325. package/out/zero-cache/src/services/change-streamer/backup-monitor.js.map +1 -1
  326. package/out/zero-cache/src/services/change-streamer/broadcast.d.ts +8 -2
  327. package/out/zero-cache/src/services/change-streamer/broadcast.d.ts.map +1 -1
  328. package/out/zero-cache/src/services/change-streamer/broadcast.js +24 -4
  329. package/out/zero-cache/src/services/change-streamer/broadcast.js.map +1 -1
  330. package/out/zero-cache/src/services/change-streamer/change-log-codec.d.ts +19 -4
  331. package/out/zero-cache/src/services/change-streamer/change-log-codec.d.ts.map +1 -1
  332. package/out/zero-cache/src/services/change-streamer/change-log-codec.js +28 -8
  333. package/out/zero-cache/src/services/change-streamer/change-log-codec.js.map +1 -1
  334. package/out/zero-cache/src/services/change-streamer/change-log-initializer.d.ts +17 -0
  335. package/out/zero-cache/src/services/change-streamer/change-log-initializer.d.ts.map +1 -1
  336. package/out/zero-cache/src/services/change-streamer/change-log-initializer.js +44 -1
  337. package/out/zero-cache/src/services/change-streamer/change-log-initializer.js.map +1 -1
  338. package/out/zero-cache/src/services/change-streamer/change-streamer-http.d.ts +54 -6
  339. package/out/zero-cache/src/services/change-streamer/change-streamer-http.d.ts.map +1 -1
  340. package/out/zero-cache/src/services/change-streamer/change-streamer-http.js +145 -35
  341. package/out/zero-cache/src/services/change-streamer/change-streamer-http.js.map +1 -1
  342. package/out/zero-cache/src/services/change-streamer/change-streamer-service.d.ts +36 -0
  343. package/out/zero-cache/src/services/change-streamer/change-streamer-service.d.ts.map +1 -1
  344. package/out/zero-cache/src/services/change-streamer/change-streamer-service.js +267 -118
  345. package/out/zero-cache/src/services/change-streamer/change-streamer-service.js.map +1 -1
  346. package/out/zero-cache/src/services/change-streamer/change-streamer.d.ts +161 -17
  347. package/out/zero-cache/src/services/change-streamer/change-streamer.d.ts.map +1 -1
  348. package/out/zero-cache/src/services/change-streamer/change-streamer.js +33 -2
  349. package/out/zero-cache/src/services/change-streamer/change-streamer.js.map +1 -1
  350. package/out/zero-cache/src/services/change-streamer/drain-tracker.d.ts +24 -0
  351. package/out/zero-cache/src/services/change-streamer/drain-tracker.d.ts.map +1 -0
  352. package/out/zero-cache/src/services/change-streamer/drain-tracker.js +67 -0
  353. package/out/zero-cache/src/services/change-streamer/drain-tracker.js.map +1 -0
  354. package/out/zero-cache/src/services/change-streamer/forwarder.d.ts +3 -3
  355. package/out/zero-cache/src/services/change-streamer/forwarder.d.ts.map +1 -1
  356. package/out/zero-cache/src/services/change-streamer/forwarder.js +36 -5
  357. package/out/zero-cache/src/services/change-streamer/forwarder.js.map +1 -1
  358. package/out/zero-cache/src/services/change-streamer/litestream-sync-requester.d.ts +53 -0
  359. package/out/zero-cache/src/services/change-streamer/litestream-sync-requester.d.ts.map +1 -0
  360. package/out/zero-cache/src/services/change-streamer/litestream-sync-requester.js +156 -0
  361. package/out/zero-cache/src/services/change-streamer/litestream-sync-requester.js.map +1 -0
  362. package/out/zero-cache/src/services/change-streamer/restore-admission.d.ts +243 -0
  363. package/out/zero-cache/src/services/change-streamer/restore-admission.d.ts.map +1 -0
  364. package/out/zero-cache/src/services/change-streamer/restore-admission.js +317 -0
  365. package/out/zero-cache/src/services/change-streamer/restore-admission.js.map +1 -0
  366. package/out/zero-cache/src/services/change-streamer/schema/tables.d.ts +78 -1
  367. package/out/zero-cache/src/services/change-streamer/schema/tables.d.ts.map +1 -1
  368. package/out/zero-cache/src/services/change-streamer/schema/tables.js +173 -47
  369. package/out/zero-cache/src/services/change-streamer/schema/tables.js.map +1 -1
  370. package/out/zero-cache/src/services/change-streamer/snapshot-message.d.ts +92 -0
  371. package/out/zero-cache/src/services/change-streamer/snapshot-message.d.ts.map +1 -0
  372. package/out/zero-cache/src/services/change-streamer/snapshot-message.js +42 -0
  373. package/out/zero-cache/src/services/change-streamer/snapshot-message.js.map +1 -0
  374. package/out/zero-cache/src/services/change-streamer/snapshot-reservations.d.ts +14 -2
  375. package/out/zero-cache/src/services/change-streamer/snapshot-reservations.d.ts.map +1 -1
  376. package/out/zero-cache/src/services/change-streamer/snapshot-reservations.js +23 -10
  377. package/out/zero-cache/src/services/change-streamer/snapshot-reservations.js.map +1 -1
  378. package/out/zero-cache/src/services/change-streamer/snapshot.d.ts +7 -69
  379. package/out/zero-cache/src/services/change-streamer/snapshot.d.ts.map +1 -1
  380. package/out/zero-cache/src/services/change-streamer/snapshot.js +21 -53
  381. package/out/zero-cache/src/services/change-streamer/snapshot.js.map +1 -1
  382. package/out/zero-cache/src/services/change-streamer/sqlite-change-log-writer.d.ts +6 -1
  383. package/out/zero-cache/src/services/change-streamer/sqlite-change-log-writer.d.ts.map +1 -1
  384. package/out/zero-cache/src/services/change-streamer/sqlite-change-log-writer.js +27 -9
  385. package/out/zero-cache/src/services/change-streamer/sqlite-change-log-writer.js.map +1 -1
  386. package/out/zero-cache/src/services/change-streamer/storer.d.ts +106 -5
  387. package/out/zero-cache/src/services/change-streamer/storer.d.ts.map +1 -1
  388. package/out/zero-cache/src/services/change-streamer/storer.js +299 -86
  389. package/out/zero-cache/src/services/change-streamer/storer.js.map +1 -1
  390. package/out/zero-cache/src/services/change-streamer/subscribe.d.ts +485 -0
  391. package/out/zero-cache/src/services/change-streamer/subscribe.d.ts.map +1 -0
  392. package/out/zero-cache/src/services/change-streamer/subscribe.js +93 -0
  393. package/out/zero-cache/src/services/change-streamer/subscribe.js.map +1 -0
  394. package/out/zero-cache/src/services/change-streamer/subscriber.d.ts +80 -2
  395. package/out/zero-cache/src/services/change-streamer/subscriber.d.ts.map +1 -1
  396. package/out/zero-cache/src/services/change-streamer/subscriber.js +157 -20
  397. package/out/zero-cache/src/services/change-streamer/subscriber.js.map +1 -1
  398. package/out/zero-cache/src/services/change-streamer/upstream-acker.d.ts +19 -1
  399. package/out/zero-cache/src/services/change-streamer/upstream-acker.d.ts.map +1 -1
  400. package/out/zero-cache/src/services/change-streamer/upstream-acker.js +23 -3
  401. package/out/zero-cache/src/services/change-streamer/upstream-acker.js.map +1 -1
  402. package/out/zero-cache/src/services/http-service.d.ts +7 -1
  403. package/out/zero-cache/src/services/http-service.d.ts.map +1 -1
  404. package/out/zero-cache/src/services/http-service.js +14 -2
  405. package/out/zero-cache/src/services/http-service.js.map +1 -1
  406. package/out/zero-cache/src/services/life-cycle.d.ts +68 -2
  407. package/out/zero-cache/src/services/life-cycle.d.ts.map +1 -1
  408. package/out/zero-cache/src/services/life-cycle.js +155 -19
  409. package/out/zero-cache/src/services/life-cycle.js.map +1 -1
  410. package/out/zero-cache/src/services/litestream/commands.d.ts +35 -3
  411. package/out/zero-cache/src/services/litestream/commands.d.ts.map +1 -1
  412. package/out/zero-cache/src/services/litestream/commands.js +137 -35
  413. package/out/zero-cache/src/services/litestream/commands.js.map +1 -1
  414. package/out/zero-cache/src/services/litestream/config-v5.yml +6 -7
  415. package/out/zero-cache/src/services/litestream/litestream-checkpointer.js +51 -24
  416. package/out/zero-cache/src/services/litestream/litestream-checkpointer.js.map +1 -1
  417. package/out/zero-cache/src/services/litestream/litestream-controller.d.ts +10 -2
  418. package/out/zero-cache/src/services/litestream/litestream-controller.d.ts.map +1 -1
  419. package/out/zero-cache/src/services/litestream/litestream-controller.js +3 -2
  420. package/out/zero-cache/src/services/litestream/litestream-controller.js.map +1 -1
  421. package/out/zero-cache/src/services/litestream/restore-progress.d.ts +24 -0
  422. package/out/zero-cache/src/services/litestream/restore-progress.d.ts.map +1 -0
  423. package/out/zero-cache/src/services/litestream/restore-progress.js +91 -0
  424. package/out/zero-cache/src/services/litestream/restore-progress.js.map +1 -0
  425. package/out/zero-cache/src/services/mutagen/mutagen.d.ts +5 -0
  426. package/out/zero-cache/src/services/mutagen/mutagen.d.ts.map +1 -1
  427. package/out/zero-cache/src/services/mutagen/mutagen.js +7 -1
  428. package/out/zero-cache/src/services/mutagen/mutagen.js.map +1 -1
  429. package/out/zero-cache/src/services/mutagen/pusher.d.ts.map +1 -1
  430. package/out/zero-cache/src/services/mutagen/pusher.js +5 -6
  431. package/out/zero-cache/src/services/mutagen/pusher.js.map +1 -1
  432. package/out/zero-cache/src/services/plannerz.d.ts +163 -0
  433. package/out/zero-cache/src/services/plannerz.d.ts.map +1 -0
  434. package/out/zero-cache/src/services/plannerz.js +267 -0
  435. package/out/zero-cache/src/services/plannerz.js.map +1 -0
  436. package/out/zero-cache/src/services/profz.d.ts +30 -0
  437. package/out/zero-cache/src/services/profz.d.ts.map +1 -0
  438. package/out/zero-cache/src/services/profz.js +163 -0
  439. package/out/zero-cache/src/services/profz.js.map +1 -0
  440. package/out/zero-cache/src/services/replicator/change-log-cookies.js +1 -1
  441. package/out/zero-cache/src/services/replicator/change-log-cookies.js.map +1 -1
  442. package/out/zero-cache/src/services/replicator/change-log-stream-writer.d.ts +5 -4
  443. package/out/zero-cache/src/services/replicator/change-log-stream-writer.d.ts.map +1 -1
  444. package/out/zero-cache/src/services/replicator/change-log-stream-writer.js +20 -22
  445. package/out/zero-cache/src/services/replicator/change-log-stream-writer.js.map +1 -1
  446. package/out/zero-cache/src/services/replicator/change-processor.d.ts.map +1 -1
  447. package/out/zero-cache/src/services/replicator/change-processor.js +51 -5
  448. package/out/zero-cache/src/services/replicator/change-processor.js.map +1 -1
  449. package/out/zero-cache/src/services/replicator/drain-handler.d.ts +74 -0
  450. package/out/zero-cache/src/services/replicator/drain-handler.d.ts.map +1 -0
  451. package/out/zero-cache/src/services/replicator/drain-handler.js +185 -0
  452. package/out/zero-cache/src/services/replicator/drain-handler.js.map +1 -0
  453. package/out/zero-cache/src/services/replicator/incremental-sync.d.ts +6 -2
  454. package/out/zero-cache/src/services/replicator/incremental-sync.d.ts.map +1 -1
  455. package/out/zero-cache/src/services/replicator/incremental-sync.js +114 -28
  456. package/out/zero-cache/src/services/replicator/incremental-sync.js.map +1 -1
  457. package/out/zero-cache/src/services/replicator/replication-status.d.ts +35 -1
  458. package/out/zero-cache/src/services/replicator/replication-status.d.ts.map +1 -1
  459. package/out/zero-cache/src/services/replicator/replication-status.js +99 -8
  460. package/out/zero-cache/src/services/replicator/replication-status.js.map +1 -1
  461. package/out/zero-cache/src/services/replicator/replicator.d.ts +5 -1
  462. package/out/zero-cache/src/services/replicator/replicator.d.ts.map +1 -1
  463. package/out/zero-cache/src/services/replicator/replicator.js +5 -2
  464. package/out/zero-cache/src/services/replicator/replicator.js.map +1 -1
  465. package/out/zero-cache/src/services/replicator/reporter/recorder.d.ts +16 -1
  466. package/out/zero-cache/src/services/replicator/reporter/recorder.d.ts.map +1 -1
  467. package/out/zero-cache/src/services/replicator/reporter/recorder.js +70 -27
  468. package/out/zero-cache/src/services/replicator/reporter/recorder.js.map +1 -1
  469. package/out/zero-cache/src/services/replicator/schema/backfilling.d.ts +23 -2
  470. package/out/zero-cache/src/services/replicator/schema/backfilling.d.ts.map +1 -1
  471. package/out/zero-cache/src/services/replicator/schema/backfilling.js +54 -2
  472. package/out/zero-cache/src/services/replicator/schema/backfilling.js.map +1 -1
  473. package/out/zero-cache/src/services/replicator/sqlite-change-log-observability.d.ts +6 -6
  474. package/out/zero-cache/src/services/replicator/sqlite-change-log-observability.d.ts.map +1 -1
  475. package/out/zero-cache/src/services/replicator/sqlite-change-log-observability.js +19 -14
  476. package/out/zero-cache/src/services/replicator/sqlite-change-log-observability.js.map +1 -1
  477. package/out/zero-cache/src/services/replicator/write-worker-client.d.ts +11 -3
  478. package/out/zero-cache/src/services/replicator/write-worker-client.d.ts.map +1 -1
  479. package/out/zero-cache/src/services/replicator/write-worker-client.js.map +1 -1
  480. package/out/zero-cache/src/services/replicator/write-worker.js +5 -1
  481. package/out/zero-cache/src/services/replicator/write-worker.js.map +1 -1
  482. package/out/zero-cache/src/services/run-ast.d.ts +12 -0
  483. package/out/zero-cache/src/services/run-ast.d.ts.map +1 -1
  484. package/out/zero-cache/src/services/run-ast.js +42 -22
  485. package/out/zero-cache/src/services/run-ast.js.map +1 -1
  486. package/out/zero-cache/src/services/runner.d.ts +2 -1
  487. package/out/zero-cache/src/services/runner.d.ts.map +1 -1
  488. package/out/zero-cache/src/services/runner.js +10 -2
  489. package/out/zero-cache/src/services/runner.js.map +1 -1
  490. package/out/zero-cache/src/services/statz.d.ts +4 -0
  491. package/out/zero-cache/src/services/statz.d.ts.map +1 -1
  492. package/out/zero-cache/src/services/statz.js +22 -5
  493. package/out/zero-cache/src/services/statz.js.map +1 -1
  494. package/out/zero-cache/src/services/view-syncer/advancement-metrics.d.ts +26 -0
  495. package/out/zero-cache/src/services/view-syncer/advancement-metrics.d.ts.map +1 -0
  496. package/out/zero-cache/src/services/view-syncer/advancement-metrics.js +26 -0
  497. package/out/zero-cache/src/services/view-syncer/advancement-metrics.js.map +1 -0
  498. package/out/zero-cache/src/services/view-syncer/batch-pacer.d.ts +79 -0
  499. package/out/zero-cache/src/services/view-syncer/batch-pacer.d.ts.map +1 -0
  500. package/out/zero-cache/src/services/view-syncer/batch-pacer.js +249 -0
  501. package/out/zero-cache/src/services/view-syncer/batch-pacer.js.map +1 -0
  502. package/out/zero-cache/src/services/view-syncer/client-handler.d.ts +19 -2
  503. package/out/zero-cache/src/services/view-syncer/client-handler.d.ts.map +1 -1
  504. package/out/zero-cache/src/services/view-syncer/client-handler.js +42 -30
  505. package/out/zero-cache/src/services/view-syncer/client-handler.js.map +1 -1
  506. package/out/zero-cache/src/services/view-syncer/cvr-store.d.ts +27 -2
  507. package/out/zero-cache/src/services/view-syncer/cvr-store.d.ts.map +1 -1
  508. package/out/zero-cache/src/services/view-syncer/cvr-store.js +86 -21
  509. package/out/zero-cache/src/services/view-syncer/cvr-store.js.map +1 -1
  510. package/out/zero-cache/src/services/view-syncer/cvr.d.ts +75 -12
  511. package/out/zero-cache/src/services/view-syncer/cvr.d.ts.map +1 -1
  512. package/out/zero-cache/src/services/view-syncer/cvr.js +234 -43
  513. package/out/zero-cache/src/services/view-syncer/cvr.js.map +1 -1
  514. package/out/zero-cache/src/services/view-syncer/deferred-writes-budget.d.ts +81 -0
  515. package/out/zero-cache/src/services/view-syncer/deferred-writes-budget.d.ts.map +1 -0
  516. package/out/zero-cache/src/services/view-syncer/deferred-writes-budget.js +128 -0
  517. package/out/zero-cache/src/services/view-syncer/deferred-writes-budget.js.map +1 -0
  518. package/out/zero-cache/src/services/view-syncer/drain-coordinator.d.ts +14 -1
  519. package/out/zero-cache/src/services/view-syncer/drain-coordinator.d.ts.map +1 -1
  520. package/out/zero-cache/src/services/view-syncer/drain-coordinator.js +30 -4
  521. package/out/zero-cache/src/services/view-syncer/drain-coordinator.js.map +1 -1
  522. package/out/zero-cache/src/services/view-syncer/hydration-circuit-breaker.d.ts +51 -0
  523. package/out/zero-cache/src/services/view-syncer/hydration-circuit-breaker.d.ts.map +1 -0
  524. package/out/zero-cache/src/services/view-syncer/hydration-circuit-breaker.js +78 -0
  525. package/out/zero-cache/src/services/view-syncer/hydration-circuit-breaker.js.map +1 -0
  526. package/out/zero-cache/src/services/view-syncer/inspect-handler.d.ts +12 -2
  527. package/out/zero-cache/src/services/view-syncer/inspect-handler.d.ts.map +1 -1
  528. package/out/zero-cache/src/services/view-syncer/inspect-handler.js +29 -5
  529. package/out/zero-cache/src/services/view-syncer/inspect-handler.js.map +1 -1
  530. package/out/zero-cache/src/services/view-syncer/pipeline-driver.d.ts +165 -9
  531. package/out/zero-cache/src/services/view-syncer/pipeline-driver.d.ts.map +1 -1
  532. package/out/zero-cache/src/services/view-syncer/pipeline-driver.js +953 -209
  533. package/out/zero-cache/src/services/view-syncer/pipeline-driver.js.map +1 -1
  534. package/out/zero-cache/src/services/view-syncer/plan-warnings.d.ts +7 -0
  535. package/out/zero-cache/src/services/view-syncer/plan-warnings.d.ts.map +1 -0
  536. package/out/zero-cache/src/services/view-syncer/plan-warnings.js +35 -0
  537. package/out/zero-cache/src/services/view-syncer/plan-warnings.js.map +1 -0
  538. package/out/zero-cache/src/services/view-syncer/push-cost.d.ts +132 -0
  539. package/out/zero-cache/src/services/view-syncer/push-cost.d.ts.map +1 -0
  540. package/out/zero-cache/src/services/view-syncer/push-cost.js +164 -0
  541. package/out/zero-cache/src/services/view-syncer/push-cost.js.map +1 -0
  542. package/out/zero-cache/src/services/view-syncer/push-cutoff.d.ts +55 -0
  543. package/out/zero-cache/src/services/view-syncer/push-cutoff.d.ts.map +1 -0
  544. package/out/zero-cache/src/services/view-syncer/push-cutoff.js +56 -0
  545. package/out/zero-cache/src/services/view-syncer/push-cutoff.js.map +1 -0
  546. package/out/zero-cache/src/services/view-syncer/query-covering.d.ts.map +1 -1
  547. package/out/zero-cache/src/services/view-syncer/query-covering.js +2 -6
  548. package/out/zero-cache/src/services/view-syncer/query-covering.js.map +1 -1
  549. package/out/zero-cache/src/services/view-syncer/query-shape.d.ts +25 -0
  550. package/out/zero-cache/src/services/view-syncer/query-shape.d.ts.map +1 -0
  551. package/out/zero-cache/src/services/view-syncer/query-shape.js +28 -0
  552. package/out/zero-cache/src/services/view-syncer/query-shape.js.map +1 -0
  553. package/out/zero-cache/src/services/view-syncer/query-stats.d.ts +89 -0
  554. package/out/zero-cache/src/services/view-syncer/query-stats.d.ts.map +1 -0
  555. package/out/zero-cache/src/services/view-syncer/query-stats.js +233 -0
  556. package/out/zero-cache/src/services/view-syncer/query-stats.js.map +1 -0
  557. package/out/zero-cache/src/services/view-syncer/schema/types.d.ts +2 -107
  558. package/out/zero-cache/src/services/view-syncer/schema/types.d.ts.map +1 -1
  559. package/out/zero-cache/src/services/view-syncer/schema/types.js +5 -20
  560. package/out/zero-cache/src/services/view-syncer/schema/types.js.map +1 -1
  561. package/out/zero-cache/src/services/view-syncer/snapshot-row-cache.d.ts +95 -0
  562. package/out/zero-cache/src/services/view-syncer/snapshot-row-cache.d.ts.map +1 -0
  563. package/out/zero-cache/src/services/view-syncer/snapshot-row-cache.js +155 -0
  564. package/out/zero-cache/src/services/view-syncer/snapshot-row-cache.js.map +1 -0
  565. package/out/zero-cache/src/services/view-syncer/snapshotter.d.ts +229 -16
  566. package/out/zero-cache/src/services/view-syncer/snapshotter.d.ts.map +1 -1
  567. package/out/zero-cache/src/services/view-syncer/snapshotter.js +455 -43
  568. package/out/zero-cache/src/services/view-syncer/snapshotter.js.map +1 -1
  569. package/out/zero-cache/src/services/view-syncer/view-syncer.d.ts +8 -2
  570. package/out/zero-cache/src/services/view-syncer/view-syncer.d.ts.map +1 -1
  571. package/out/zero-cache/src/services/view-syncer/view-syncer.js +788 -71
  572. package/out/zero-cache/src/services/view-syncer/view-syncer.js.map +1 -1
  573. package/out/zero-cache/src/types/pg-data-type.d.ts +2 -0
  574. package/out/zero-cache/src/types/pg-data-type.d.ts.map +1 -1
  575. package/out/zero-cache/src/types/pg-data-type.js +6 -1
  576. package/out/zero-cache/src/types/pg-data-type.js.map +1 -1
  577. package/out/zero-cache/src/types/pg.d.ts.map +1 -1
  578. package/out/zero-cache/src/types/pg.js +2 -2
  579. package/out/zero-cache/src/types/pg.js.map +1 -1
  580. package/out/zero-cache/src/types/processes.d.ts +50 -0
  581. package/out/zero-cache/src/types/processes.d.ts.map +1 -1
  582. package/out/zero-cache/src/types/processes.js +43 -4
  583. package/out/zero-cache/src/types/processes.js.map +1 -1
  584. package/out/zero-cache/src/types/profiler.d.ts +12 -0
  585. package/out/zero-cache/src/types/profiler.d.ts.map +1 -1
  586. package/out/zero-cache/src/types/profiler.js +46 -1
  587. package/out/zero-cache/src/types/profiler.js.map +1 -1
  588. package/out/zero-cache/src/types/row-key.d.ts +1 -15
  589. package/out/zero-cache/src/types/row-key.d.ts.map +1 -1
  590. package/out/zero-cache/src/types/row-key.js +6 -8
  591. package/out/zero-cache/src/types/row-key.js.map +1 -1
  592. package/out/zero-cache/src/types/streams.d.ts +49 -7
  593. package/out/zero-cache/src/types/streams.d.ts.map +1 -1
  594. package/out/zero-cache/src/types/streams.js +190 -58
  595. package/out/zero-cache/src/types/streams.js.map +1 -1
  596. package/out/zero-cache/src/types/subscription.d.ts +15 -0
  597. package/out/zero-cache/src/types/subscription.d.ts.map +1 -1
  598. package/out/zero-cache/src/types/subscription.js +123 -31
  599. package/out/zero-cache/src/types/subscription.js.map +1 -1
  600. package/out/zero-cache/src/types/websocket-handoff.d.ts +1 -1
  601. package/out/zero-cache/src/types/websocket-handoff.d.ts.map +1 -1
  602. package/out/zero-cache/src/types/websocket-handoff.js +18 -9
  603. package/out/zero-cache/src/types/websocket-handoff.js.map +1 -1
  604. package/out/zero-cache/src/types/ws.d.ts.map +1 -1
  605. package/out/zero-cache/src/types/ws.js +1 -16
  606. package/out/zero-cache/src/types/ws.js.map +1 -1
  607. package/out/zero-cache/src/workers/connect-params.d.ts +1 -0
  608. package/out/zero-cache/src/workers/connect-params.d.ts.map +1 -1
  609. package/out/zero-cache/src/workers/connect-params.js.map +1 -1
  610. package/out/zero-cache/src/workers/connection.d.ts +2 -1
  611. package/out/zero-cache/src/workers/connection.d.ts.map +1 -1
  612. package/out/zero-cache/src/workers/connection.js +9 -1
  613. package/out/zero-cache/src/workers/connection.js.map +1 -1
  614. package/out/zero-cache/src/workers/replicator.d.ts.map +1 -1
  615. package/out/zero-cache/src/workers/replicator.js +24 -7
  616. package/out/zero-cache/src/workers/replicator.js.map +1 -1
  617. package/out/zero-cache/src/workers/syncer-ws-message-handler.d.ts.map +1 -1
  618. package/out/zero-cache/src/workers/syncer-ws-message-handler.js +21 -16
  619. package/out/zero-cache/src/workers/syncer-ws-message-handler.js.map +1 -1
  620. package/out/zero-cache/src/workers/syncer.d.ts.map +1 -1
  621. package/out/zero-cache/src/workers/syncer.js +55 -4
  622. package/out/zero-cache/src/workers/syncer.js.map +1 -1
  623. package/out/zero-client/src/client/active-clients-manager.d.ts.map +1 -1
  624. package/out/zero-client/src/client/active-clients-manager.js +4 -1
  625. package/out/zero-client/src/client/active-clients-manager.js.map +1 -1
  626. package/out/zero-client/src/client/connection-manager.d.ts +20 -0
  627. package/out/zero-client/src/client/connection-manager.d.ts.map +1 -1
  628. package/out/zero-client/src/client/connection-manager.js +77 -13
  629. package/out/zero-client/src/client/connection-manager.js.map +1 -1
  630. package/out/zero-client/src/client/connection-status-enum.d.ts +2 -0
  631. package/out/zero-client/src/client/connection-status-enum.d.ts.map +1 -1
  632. package/out/zero-client/src/client/connection-status-enum.js +3 -1
  633. package/out/zero-client/src/client/connection-status-enum.js.map +1 -1
  634. package/out/zero-client/src/client/connection.d.ts +6 -0
  635. package/out/zero-client/src/client/connection.d.ts.map +1 -1
  636. package/out/zero-client/src/client/connection.js +2 -1
  637. package/out/zero-client/src/client/connection.js.map +1 -1
  638. package/out/zero-client/src/client/context.d.ts +23 -13
  639. package/out/zero-client/src/client/context.d.ts.map +1 -1
  640. package/out/zero-client/src/client/context.js +94 -26
  641. package/out/zero-client/src/client/context.js.map +1 -1
  642. package/out/zero-client/src/client/crud-impl.d.ts.map +1 -1
  643. package/out/zero-client/src/client/crud-impl.js +1 -1
  644. package/out/zero-client/src/client/crud-impl.js.map +1 -1
  645. package/out/zero-client/src/client/custom.d.ts +5 -4
  646. package/out/zero-client/src/client/custom.d.ts.map +1 -1
  647. package/out/zero-client/src/client/custom.js +3 -3
  648. package/out/zero-client/src/client/custom.js.map +1 -1
  649. package/out/zero-client/src/client/inspector/lazy-inspector.js +1 -1
  650. package/out/zero-client/src/client/ivm-branch.d.ts.map +1 -1
  651. package/out/zero-client/src/client/ivm-branch.js +20 -3
  652. package/out/zero-client/src/client/ivm-branch.js.map +1 -1
  653. package/out/zero-client/src/client/keys.d.ts.map +1 -1
  654. package/out/zero-client/src/client/keys.js +19 -1
  655. package/out/zero-client/src/client/keys.js.map +1 -1
  656. package/out/zero-client/src/client/make-mutate-property.d.ts +1 -1
  657. package/out/zero-client/src/client/make-mutate-property.d.ts.map +1 -1
  658. package/out/zero-client/src/client/make-mutate-property.js.map +1 -1
  659. package/out/zero-client/src/client/make-replicache-mutators.d.ts.map +1 -1
  660. package/out/zero-client/src/client/make-replicache-mutators.js +1 -1
  661. package/out/zero-client/src/client/make-replicache-mutators.js.map +1 -1
  662. package/out/zero-client/src/client/mutation-tracker.d.ts +2 -2
  663. package/out/zero-client/src/client/mutation-tracker.d.ts.map +1 -1
  664. package/out/zero-client/src/client/mutation-tracker.js +3 -7
  665. package/out/zero-client/src/client/mutation-tracker.js.map +1 -1
  666. package/out/zero-client/src/client/mutator-proxy.d.ts.map +1 -1
  667. package/out/zero-client/src/client/mutator-proxy.js +9 -4
  668. package/out/zero-client/src/client/mutator-proxy.js.map +1 -1
  669. package/out/zero-client/src/client/options.d.ts +33 -0
  670. package/out/zero-client/src/client/options.d.ts.map +1 -1
  671. package/out/zero-client/src/client/options.js.map +1 -1
  672. package/out/zero-client/src/client/query-manager.d.ts +9 -0
  673. package/out/zero-client/src/client/query-manager.d.ts.map +1 -1
  674. package/out/zero-client/src/client/query-manager.js +47 -14
  675. package/out/zero-client/src/client/query-manager.js.map +1 -1
  676. package/out/zero-client/src/client/reload-error-handler.js +2 -2
  677. package/out/zero-client/src/client/reload-error-handler.js.map +1 -1
  678. package/out/zero-client/src/client/storage-version.d.ts +23 -0
  679. package/out/zero-client/src/client/storage-version.d.ts.map +1 -0
  680. package/out/zero-client/src/client/version.js +1 -1
  681. package/out/zero-client/src/client/zero-rep.d.ts +1 -0
  682. package/out/zero-client/src/client/zero-rep.d.ts.map +1 -1
  683. package/out/zero-client/src/client/zero-rep.js +8 -6
  684. package/out/zero-client/src/client/zero-rep.js.map +1 -1
  685. package/out/zero-client/src/client/zero.d.ts +18 -3
  686. package/out/zero-client/src/client/zero.d.ts.map +1 -1
  687. package/out/zero-client/src/client/zero.js +86 -48
  688. package/out/zero-client/src/client/zero.js.map +1 -1
  689. package/out/zero-client/src/mod.d.ts +2 -1
  690. package/out/zero-client/src/mod.d.ts.map +1 -1
  691. package/out/zero-client/src/mod.js +1 -0
  692. package/out/zero-client/src/types/query-result.d.ts +2 -0
  693. package/out/zero-client/src/types/query-result.d.ts.map +1 -1
  694. package/out/zero-events/src/status.d.ts +64 -0
  695. package/out/zero-events/src/status.d.ts.map +1 -1
  696. package/out/zero-protocol/src/analyze-query-result.d.ts +12 -12
  697. package/out/zero-protocol/src/analyze-query-result.d.ts.map +1 -1
  698. package/out/zero-protocol/src/analyze-query-result.js +3 -3
  699. package/out/zero-protocol/src/analyze-query-result.js.map +1 -1
  700. package/out/zero-protocol/src/ast.d.ts +24 -0
  701. package/out/zero-protocol/src/ast.d.ts.map +1 -1
  702. package/out/zero-protocol/src/ast.js +39 -16
  703. package/out/zero-protocol/src/ast.js.map +1 -1
  704. package/out/zero-protocol/src/down.d.ts +36 -36
  705. package/out/zero-protocol/src/inspect-down.d.ts +31 -31
  706. package/out/zero-protocol/src/inspect-up.d.ts +158 -61
  707. package/out/zero-protocol/src/inspect-up.d.ts.map +1 -1
  708. package/out/zero-protocol/src/inspect-up.js +12 -6
  709. package/out/zero-protocol/src/inspect-up.js.map +1 -1
  710. package/out/zero-protocol/src/protocol-version.d.ts +4 -1
  711. package/out/zero-protocol/src/protocol-version.d.ts.map +1 -1
  712. package/out/zero-protocol/src/protocol-version.js.map +1 -1
  713. package/out/zero-protocol/src/queries-patch.js +2 -2
  714. package/out/zero-protocol/src/queries-patch.js.map +1 -1
  715. package/out/zero-protocol/src/query-hash.d.ts.map +1 -1
  716. package/out/zero-protocol/src/query-hash.js +2 -5
  717. package/out/zero-protocol/src/query-hash.js.map +1 -1
  718. package/out/zero-protocol/src/up.d.ts +766 -256
  719. package/out/zero-protocol/src/up.d.ts.map +1 -1
  720. package/out/zero-protocol/src/up.js +25 -3
  721. package/out/zero-protocol/src/up.js.map +1 -1
  722. package/out/zero-react/src/use-query.d.ts +5 -4
  723. package/out/zero-react/src/use-query.d.ts.map +1 -1
  724. package/out/zero-react/src/use-query.js +75 -8
  725. package/out/zero-react/src/use-query.js.map +1 -1
  726. package/out/zero-react/src/zero.js +1 -0
  727. package/out/zero-server/src/adapters/drizzle.d.ts +16 -4
  728. package/out/zero-server/src/adapters/drizzle.d.ts.map +1 -1
  729. package/out/zero-server/src/adapters/drizzle.js +19 -11
  730. package/out/zero-server/src/adapters/drizzle.js.map +1 -1
  731. package/out/zero-server/src/adapters/kysely.d.ts +6 -3
  732. package/out/zero-server/src/adapters/kysely.d.ts.map +1 -1
  733. package/out/zero-server/src/adapters/kysely.js +16 -6
  734. package/out/zero-server/src/adapters/kysely.js.map +1 -1
  735. package/out/zero-server/src/adapters/pg.d.ts +7 -2
  736. package/out/zero-server/src/adapters/pg.d.ts.map +1 -1
  737. package/out/zero-server/src/adapters/pg.js +34 -10
  738. package/out/zero-server/src/adapters/pg.js.map +1 -1
  739. package/out/zero-server/src/adapters/postgresjs.d.ts +4 -2
  740. package/out/zero-server/src/adapters/postgresjs.d.ts.map +1 -1
  741. package/out/zero-server/src/adapters/postgresjs.js +15 -5
  742. package/out/zero-server/src/adapters/postgresjs.js.map +1 -1
  743. package/out/zero-server/src/adapters/prisma.d.ts +17 -5
  744. package/out/zero-server/src/adapters/prisma.d.ts.map +1 -1
  745. package/out/zero-server/src/adapters/prisma.js +20 -6
  746. package/out/zero-server/src/adapters/prisma.js.map +1 -1
  747. package/out/zero-server/src/closable-db-transaction.d.ts +16 -0
  748. package/out/zero-server/src/closable-db-transaction.d.ts.map +1 -0
  749. package/out/zero-server/src/closable-db-transaction.js +31 -0
  750. package/out/zero-server/src/closable-db-transaction.js.map +1 -0
  751. package/out/zero-server/src/custom.d.ts +10 -4
  752. package/out/zero-server/src/custom.d.ts.map +1 -1
  753. package/out/zero-server/src/custom.js +15 -6
  754. package/out/zero-server/src/custom.js.map +1 -1
  755. package/out/zero-server/src/logging.d.ts +2 -2
  756. package/out/zero-server/src/logging.d.ts.map +1 -1
  757. package/out/zero-server/src/logging.js +2 -2
  758. package/out/zero-server/src/logging.js.map +1 -1
  759. package/out/zero-server/src/mod.d.ts +2 -1
  760. package/out/zero-server/src/mod.d.ts.map +1 -1
  761. package/out/zero-server/src/pg-query-executor.d.ts +2 -2
  762. package/out/zero-server/src/pg-query-executor.d.ts.map +1 -1
  763. package/out/zero-server/src/pg-query-executor.js +2 -2
  764. package/out/zero-server/src/pg-query-executor.js.map +1 -1
  765. package/out/zero-server/src/process-mutations.d.ts +25 -4
  766. package/out/zero-server/src/process-mutations.d.ts.map +1 -1
  767. package/out/zero-server/src/process-mutations.js +103 -52
  768. package/out/zero-server/src/process-mutations.js.map +1 -1
  769. package/out/zero-server/src/push-processor.d.ts +8 -2
  770. package/out/zero-server/src/push-processor.d.ts.map +1 -1
  771. package/out/zero-server/src/push-processor.js +12 -4
  772. package/out/zero-server/src/push-processor.js.map +1 -1
  773. package/out/zero-server/src/queries/process-queries.d.ts.map +1 -1
  774. package/out/zero-server/src/queries/process-queries.js +1 -1
  775. package/out/zero-server/src/queries/process-queries.js.map +1 -1
  776. package/out/zero-server/src/schema.d.ts +2 -2
  777. package/out/zero-server/src/schema.d.ts.map +1 -1
  778. package/out/zero-server/src/schema.js +3 -2
  779. package/out/zero-server/src/schema.js.map +1 -1
  780. package/out/zero-server/src/transaction-options.d.ts +24 -0
  781. package/out/zero-server/src/transaction-options.d.ts.map +1 -0
  782. package/out/zero-server/src/transaction-options.js +11 -0
  783. package/out/zero-server/src/transaction-options.js.map +1 -0
  784. package/out/zero-server/src/zql-database.d.ts +21 -1
  785. package/out/zero-server/src/zql-database.d.ts.map +1 -1
  786. package/out/zero-server/src/zql-database.js +61 -24
  787. package/out/zero-server/src/zql-database.js.map +1 -1
  788. package/out/zero-solid/src/solid-view.d.ts +17 -0
  789. package/out/zero-solid/src/solid-view.d.ts.map +1 -1
  790. package/out/zero-solid/src/solid-view.js +39 -1
  791. package/out/zero-solid/src/solid-view.js.map +1 -1
  792. package/out/zero-solid/src/use-query.js +1 -2
  793. package/out/zero-solid/src/use-query.js.map +1 -1
  794. package/out/zero-solid/src/zero.js +1 -0
  795. package/out/zql/src/builder/builder.d.ts +25 -0
  796. package/out/zql/src/builder/builder.d.ts.map +1 -1
  797. package/out/zql/src/builder/builder.js +69 -19
  798. package/out/zql/src/builder/builder.js.map +1 -1
  799. package/out/zql/src/builder/correlated-predicate-pushdown.d.ts +43 -0
  800. package/out/zql/src/builder/correlated-predicate-pushdown.d.ts.map +1 -0
  801. package/out/zql/src/builder/correlated-predicate-pushdown.js +161 -0
  802. package/out/zql/src/builder/correlated-predicate-pushdown.js.map +1 -0
  803. package/out/zql/src/builder/debug-delegate.d.ts +6 -1
  804. package/out/zql/src/builder/debug-delegate.d.ts.map +1 -1
  805. package/out/zql/src/builder/debug-delegate.js +14 -2
  806. package/out/zql/src/builder/debug-delegate.js.map +1 -1
  807. package/out/zql/src/ivm/array-view.d.ts +29 -0
  808. package/out/zql/src/ivm/array-view.d.ts.map +1 -1
  809. package/out/zql/src/ivm/array-view.js +74 -16
  810. package/out/zql/src/ivm/array-view.js.map +1 -1
  811. package/out/zql/src/ivm/cap.d.ts +2 -1
  812. package/out/zql/src/ivm/cap.d.ts.map +1 -1
  813. package/out/zql/src/ivm/cap.js +14 -4
  814. package/out/zql/src/ivm/cap.js.map +1 -1
  815. package/out/zql/src/ivm/data.d.ts.map +1 -1
  816. package/out/zql/src/ivm/data.js +8 -3
  817. package/out/zql/src/ivm/data.js.map +1 -1
  818. package/out/zql/src/ivm/deferred-input.d.ts.map +1 -1
  819. package/out/zql/src/ivm/deferred-input.js +3 -2
  820. package/out/zql/src/ivm/deferred-input.js.map +1 -1
  821. package/out/zql/src/ivm/exists.d.ts +3 -1
  822. package/out/zql/src/ivm/exists.d.ts.map +1 -1
  823. package/out/zql/src/ivm/exists.js +4 -1
  824. package/out/zql/src/ivm/exists.js.map +1 -1
  825. package/out/zql/src/ivm/fan-in.d.ts +6 -2
  826. package/out/zql/src/ivm/fan-in.d.ts.map +1 -1
  827. package/out/zql/src/ivm/fan-in.js +13 -5
  828. package/out/zql/src/ivm/fan-in.js.map +1 -1
  829. package/out/zql/src/ivm/fan-out.d.ts +5 -2
  830. package/out/zql/src/ivm/fan-out.d.ts.map +1 -1
  831. package/out/zql/src/ivm/fan-out.js +4 -0
  832. package/out/zql/src/ivm/fan-out.js.map +1 -1
  833. package/out/zql/src/ivm/filter-operators.d.ts +8 -6
  834. package/out/zql/src/ivm/filter-operators.d.ts.map +1 -1
  835. package/out/zql/src/ivm/filter-operators.js +19 -8
  836. package/out/zql/src/ivm/filter-operators.js.map +1 -1
  837. package/out/zql/src/ivm/filter.d.ts +5 -2
  838. package/out/zql/src/ivm/filter.d.ts.map +1 -1
  839. package/out/zql/src/ivm/filter.js +10 -4
  840. package/out/zql/src/ivm/filter.js.map +1 -1
  841. package/out/zql/src/ivm/flipped-join.d.ts +9 -4
  842. package/out/zql/src/ivm/flipped-join.d.ts.map +1 -1
  843. package/out/zql/src/ivm/flipped-join.js +97 -46
  844. package/out/zql/src/ivm/flipped-join.js.map +1 -1
  845. package/out/zql/src/ivm/join-index-tap.d.ts +33 -0
  846. package/out/zql/src/ivm/join-index-tap.d.ts.map +1 -0
  847. package/out/zql/src/ivm/join-index-tap.js +70 -0
  848. package/out/zql/src/ivm/join-index-tap.js.map +1 -0
  849. package/out/zql/src/ivm/join-index.d.ts +35 -0
  850. package/out/zql/src/ivm/join-index.d.ts.map +1 -0
  851. package/out/zql/src/ivm/join-index.js +141 -0
  852. package/out/zql/src/ivm/join-index.js.map +1 -0
  853. package/out/zql/src/ivm/join-utils.d.ts +6 -0
  854. package/out/zql/src/ivm/join-utils.d.ts.map +1 -1
  855. package/out/zql/src/ivm/join-utils.js +22 -1
  856. package/out/zql/src/ivm/join-utils.js.map +1 -1
  857. package/out/zql/src/ivm/join.d.ts +19 -1
  858. package/out/zql/src/ivm/join.d.ts.map +1 -1
  859. package/out/zql/src/ivm/join.js +107 -15
  860. package/out/zql/src/ivm/join.js.map +1 -1
  861. package/out/zql/src/ivm/maybe-split-and-push-edit-change.d.ts +1 -1
  862. package/out/zql/src/ivm/maybe-split-and-push-edit-change.d.ts.map +1 -1
  863. package/out/zql/src/ivm/maybe-split-and-push-edit-change.js +6 -4
  864. package/out/zql/src/ivm/maybe-split-and-push-edit-change.js.map +1 -1
  865. package/out/zql/src/ivm/memory-source.d.ts +29 -4
  866. package/out/zql/src/ivm/memory-source.d.ts.map +1 -1
  867. package/out/zql/src/ivm/memory-source.js +70 -34
  868. package/out/zql/src/ivm/memory-source.js.map +1 -1
  869. package/out/zql/src/ivm/memory-storage.d.ts +1 -0
  870. package/out/zql/src/ivm/memory-storage.d.ts.map +1 -1
  871. package/out/zql/src/ivm/memory-storage.js +1 -0
  872. package/out/zql/src/ivm/memory-storage.js.map +1 -1
  873. package/out/zql/src/ivm/operator.d.ts +45 -10
  874. package/out/zql/src/ivm/operator.d.ts.map +1 -1
  875. package/out/zql/src/ivm/operator.js +9 -4
  876. package/out/zql/src/ivm/operator.js.map +1 -1
  877. package/out/zql/src/ivm/push-accumulated.d.ts +6 -1
  878. package/out/zql/src/ivm/push-accumulated.d.ts.map +1 -1
  879. package/out/zql/src/ivm/push-accumulated.js +47 -2
  880. package/out/zql/src/ivm/push-accumulated.js.map +1 -1
  881. package/out/zql/src/ivm/skip.d.ts +2 -1
  882. package/out/zql/src/ivm/skip.d.ts.map +1 -1
  883. package/out/zql/src/ivm/skip.js +3 -0
  884. package/out/zql/src/ivm/skip.js.map +1 -1
  885. package/out/zql/src/ivm/take-gate.d.ts +57 -0
  886. package/out/zql/src/ivm/take-gate.d.ts.map +1 -0
  887. package/out/zql/src/ivm/take-gate.js +106 -0
  888. package/out/zql/src/ivm/take-gate.js.map +1 -0
  889. package/out/zql/src/ivm/take.d.ts +8 -2
  890. package/out/zql/src/ivm/take.d.ts.map +1 -1
  891. package/out/zql/src/ivm/take.js +139 -103
  892. package/out/zql/src/ivm/take.js.map +1 -1
  893. package/out/zql/src/ivm/union-fan-in.d.ts +3 -0
  894. package/out/zql/src/ivm/union-fan-in.d.ts.map +1 -1
  895. package/out/zql/src/ivm/union-fan-in.js +63 -10
  896. package/out/zql/src/ivm/union-fan-in.js.map +1 -1
  897. package/out/zql/src/ivm/union-fan-out.d.ts +2 -1
  898. package/out/zql/src/ivm/union-fan-out.d.ts.map +1 -1
  899. package/out/zql/src/ivm/union-fan-out.js +5 -0
  900. package/out/zql/src/ivm/union-fan-out.js.map +1 -1
  901. package/out/zql/src/ivm/view-apply-change.d.ts.map +1 -1
  902. package/out/zql/src/ivm/view-apply-change.js +9 -4
  903. package/out/zql/src/ivm/view-apply-change.js.map +1 -1
  904. package/out/zql/src/ivm/view.d.ts +15 -0
  905. package/out/zql/src/ivm/view.d.ts.map +1 -1
  906. package/out/zql/src/mutate/custom.d.ts +53 -1
  907. package/out/zql/src/mutate/custom.d.ts.map +1 -1
  908. package/out/zql/src/mutate/custom.js.map +1 -1
  909. package/out/zql/src/mutate/mutator-registry.d.ts.map +1 -1
  910. package/out/zql/src/mutate/mutator-registry.js +3 -3
  911. package/out/zql/src/mutate/mutator-registry.js.map +1 -1
  912. package/out/zql/src/mutate/mutator.d.ts +2 -2
  913. package/out/zql/src/mutate/mutator.d.ts.map +1 -1
  914. package/out/zql/src/mutate/mutator.js.map +1 -1
  915. package/out/zql/src/planner/planner-builder.d.ts +23 -3
  916. package/out/zql/src/planner/planner-builder.d.ts.map +1 -1
  917. package/out/zql/src/planner/planner-builder.js +34 -17
  918. package/out/zql/src/planner/planner-builder.js.map +1 -1
  919. package/out/zql/src/planner/planner-connection.d.ts +58 -2
  920. package/out/zql/src/planner/planner-connection.d.ts.map +1 -1
  921. package/out/zql/src/planner/planner-connection.js +103 -11
  922. package/out/zql/src/planner/planner-connection.js.map +1 -1
  923. package/out/zql/src/planner/planner-debug.d.ts.map +1 -1
  924. package/out/zql/src/planner/planner-debug.js +3 -8
  925. package/out/zql/src/planner/planner-debug.js.map +1 -1
  926. package/out/zql/src/planner/planner-graph.d.ts +10 -0
  927. package/out/zql/src/planner/planner-graph.d.ts.map +1 -1
  928. package/out/zql/src/planner/planner-graph.js +14 -0
  929. package/out/zql/src/planner/planner-graph.js.map +1 -1
  930. package/out/zql/src/planner/planner-source.d.ts +2 -2
  931. package/out/zql/src/planner/planner-source.d.ts.map +1 -1
  932. package/out/zql/src/planner/planner-source.js +2 -2
  933. package/out/zql/src/planner/planner-source.js.map +1 -1
  934. package/out/zql/src/planner/planner-warnings.d.ts +83 -0
  935. package/out/zql/src/planner/planner-warnings.d.ts.map +1 -0
  936. package/out/zql/src/planner/planner-warnings.js +78 -0
  937. package/out/zql/src/planner/planner-warnings.js.map +1 -0
  938. package/out/zql/src/query/expression.d.ts +2 -2
  939. package/out/zql/src/query/expression.d.ts.map +1 -1
  940. package/out/zql/src/query/expression.js.map +1 -1
  941. package/out/zql/src/query/measure-push-operator.d.ts +9 -2
  942. package/out/zql/src/query/measure-push-operator.d.ts.map +1 -1
  943. package/out/zql/src/query/measure-push-operator.js +52 -5
  944. package/out/zql/src/query/measure-push-operator.js.map +1 -1
  945. package/out/zql/src/query/query-delegate-base.d.ts +4 -2
  946. package/out/zql/src/query/query-delegate-base.d.ts.map +1 -1
  947. package/out/zql/src/query/query-delegate-base.js +66 -33
  948. package/out/zql/src/query/query-delegate-base.js.map +1 -1
  949. package/out/zql/src/query/query-delegate.d.ts +33 -6
  950. package/out/zql/src/query/query-delegate.d.ts.map +1 -1
  951. package/out/zql/src/query/query-impl.d.ts +1 -0
  952. package/out/zql/src/query/query-impl.d.ts.map +1 -1
  953. package/out/zql/src/query/query-impl.js +6 -23
  954. package/out/zql/src/query/query-impl.js.map +1 -1
  955. package/out/zql/src/query/query-registry.js +1 -1
  956. package/out/zql/src/query/query-transitions.d.ts.map +1 -1
  957. package/out/zql/src/query/query-transitions.js +2 -5
  958. package/out/zql/src/query/query-transitions.js.map +1 -1
  959. package/out/zql/src/query/query.d.ts +26 -10
  960. package/out/zql/src/query/query.d.ts.map +1 -1
  961. package/out/zql/src/query/runnable-query-impl.d.ts +1 -0
  962. package/out/zql/src/query/runnable-query-impl.d.ts.map +1 -1
  963. package/out/zql/src/query/runnable-query-impl.js +2 -10
  964. package/out/zql/src/query/runnable-query-impl.js.map +1 -1
  965. package/out/zql/src/query/typed-view.d.ts +1 -1
  966. package/out/zql/src/query/typed-view.d.ts.map +1 -1
  967. package/out/zqlite/src/database-storage.d.ts.map +1 -1
  968. package/out/zqlite/src/database-storage.js +9 -1
  969. package/out/zqlite/src/database-storage.js.map +1 -1
  970. package/out/zqlite/src/db.d.ts +17 -1
  971. package/out/zqlite/src/db.d.ts.map +1 -1
  972. package/out/zqlite/src/db.js +73 -30
  973. package/out/zqlite/src/db.js.map +1 -1
  974. package/out/zqlite/src/index-usage.d.ts +19 -0
  975. package/out/zqlite/src/index-usage.d.ts.map +1 -0
  976. package/out/zqlite/src/index-usage.js +49 -0
  977. package/out/zqlite/src/index-usage.js.map +1 -0
  978. package/out/zqlite/src/pending-delta.d.ts +110 -0
  979. package/out/zqlite/src/pending-delta.d.ts.map +1 -0
  980. package/out/zqlite/src/pending-delta.js +278 -0
  981. package/out/zqlite/src/pending-delta.js.map +1 -0
  982. package/out/zqlite/src/query-builder.d.ts +17 -1
  983. package/out/zqlite/src/query-builder.d.ts.map +1 -1
  984. package/out/zqlite/src/query-builder.js +111 -20
  985. package/out/zqlite/src/query-builder.js.map +1 -1
  986. package/out/zqlite/src/query-delegate.d.ts.map +1 -1
  987. package/out/zqlite/src/query-delegate.js +10 -7
  988. package/out/zqlite/src/query-delegate.js.map +1 -1
  989. package/out/zqlite/src/resolve-scalar-subqueries.d.ts +3 -1
  990. package/out/zqlite/src/resolve-scalar-subqueries.d.ts.map +1 -1
  991. package/out/zqlite/src/resolve-scalar-subqueries.js +1 -0
  992. package/out/zqlite/src/resolve-scalar-subqueries.js.map +1 -1
  993. package/out/zqlite/src/sqlite-cost-model.d.ts.map +1 -1
  994. package/out/zqlite/src/sqlite-cost-model.js +53 -1
  995. package/out/zqlite/src/sqlite-cost-model.js.map +1 -1
  996. package/out/zqlite/src/sqlite-stat-fanout.d.ts.map +1 -1
  997. package/out/zqlite/src/sqlite-stat-fanout.js +5 -31
  998. package/out/zqlite/src/sqlite-stat-fanout.js.map +1 -1
  999. package/out/zqlite/src/sqlite-stat4-sample.d.ts +37 -0
  1000. package/out/zqlite/src/sqlite-stat4-sample.d.ts.map +1 -0
  1001. package/out/zqlite/src/sqlite-stat4-sample.js +61 -0
  1002. package/out/zqlite/src/sqlite-stat4-sample.js.map +1 -0
  1003. package/out/zqlite/src/table-source.d.ts +87 -2
  1004. package/out/zqlite/src/table-source.d.ts.map +1 -1
  1005. package/out/zqlite/src/table-source.js +276 -42
  1006. package/out/zqlite/src/table-source.js.map +1 -1
  1007. package/package.json +5 -6
  1008. package/out/replicache/src/kv/idb-store-with-mem-fallback.d.ts +0 -25
  1009. package/out/replicache/src/kv/idb-store-with-mem-fallback.d.ts.map +0 -1
  1010. package/out/replicache/src/kv/idb-store-with-mem-fallback.js +0 -83
  1011. package/out/replicache/src/kv/idb-store-with-mem-fallback.js.map +0 -1
  1012. package/out/zero-cache/src/services/change-streamer/vfs-watermark-poller.d.ts +0 -29
  1013. package/out/zero-cache/src/services/change-streamer/vfs-watermark-poller.d.ts.map +0 -1
  1014. package/out/zero-cache/src/services/change-streamer/vfs-watermark-poller.js +0 -154
  1015. package/out/zero-cache/src/services/change-streamer/vfs-watermark-poller.js.map +0 -1
@@ -15,7 +15,7 @@ import { timingSafeEqual } from "node:crypto";
15
15
  var ZERO_ENV_VAR_PREFIX = "ZERO_";
16
16
  var appOptions = {
17
17
  id: {
18
- type: valita_exports.string().default("zero").assert((id) => ALLOWED_APP_ID_CHARACTERS.test(id), INVALID_APP_ID_MESSAGE),
18
+ type: valita_exports.string().optional(() => "zero").assert((id) => ALLOWED_APP_ID_CHARACTERS.test(id), INVALID_APP_ID_MESSAGE),
19
19
  desc: [
20
20
  "Unique identifier for the app.",
21
21
  "",
@@ -65,7 +65,7 @@ var shardOptions = {
65
65
  hidden: true
66
66
  },
67
67
  num: {
68
- type: valita_exports.number().default(0),
68
+ type: valita_exports.number().optional(() => 0),
69
69
  desc: [
70
70
  `The shard number (from 0 to NUM_SHARDS) of the App. zero will eventually`,
71
71
  `support data sharding as a first-class primitive; until then, deploying`,
@@ -77,7 +77,7 @@ var shardOptions = {
77
77
  };
78
78
  var replicaOptions = {
79
79
  file: {
80
- type: valita_exports.string().default("zero.db"),
80
+ type: valita_exports.string().optional(() => "zero.db"),
81
81
  desc: [
82
82
  `File path to the SQLite replica that zero-cache maintains.`,
83
83
  `This can be lost, but if it is, zero-cache will have to re-replicate next`,
@@ -100,7 +100,7 @@ var perUserMutationLimit = {
100
100
  desc: [`The maximum mutations per user within the specified {bold windowMs}.`, `If unset, no rate limiting is enforced.`]
101
101
  },
102
102
  windowMs: {
103
- type: valita_exports.number().default(6e4),
103
+ type: valita_exports.number().optional(() => 6e4),
104
104
  desc: [`The sliding window over which the {bold perUserMutationLimitMax} is enforced.`]
105
105
  }
106
106
  };
@@ -131,11 +131,11 @@ var authOptions = {
131
131
  deprecated: [`Use cookie-based authentication or an auth token instead - see https://zero.rocicorp.dev/docs/auth.`]
132
132
  },
133
133
  revalidateIntervalSeconds: {
134
- type: valita_exports.number().default(300),
134
+ type: valita_exports.number().optional(() => 300),
135
135
  desc: [`The interval in seconds between periodic /query auth revalidation for validated connections.`, `If unset, periodic auth revalidation is disabled.`]
136
136
  },
137
137
  retransformIntervalSeconds: {
138
- type: valita_exports.number().default(300),
138
+ type: valita_exports.number().optional(() => 300),
139
139
  desc: [`The interval in seconds between periodic shared /query retransform work for a client group.`, `If unset, periodic shared retransform is disabled.`]
140
140
  }
141
141
  };
@@ -192,7 +192,7 @@ var makeMutatorQueryOptions = (replacement, suffix) => ({
192
192
  ...replacement ? { deprecated: [makeDeprecationMessage(`${replacement}-api-key`)] } : {}
193
193
  },
194
194
  forwardCookies: {
195
- type: valita_exports.boolean().default(false),
195
+ type: valita_exports.boolean().optional(() => false),
196
196
  desc: [
197
197
  `If true, zero-cache will forward cookies from the request.`,
198
198
  `This is useful for passing authentication cookies to the API server.`,
@@ -236,7 +236,7 @@ var zeroOptions = {
236
236
  desc: [`The "upstream" authoritative postgres database.`, `In the future we will support other types of upstream besides PG.`]
237
237
  },
238
238
  type: {
239
- type: literalUnion("pg", "custom").default("pg"),
239
+ type: literalUnion("pg", "custom").optional(() => "pg"),
240
240
  desc: [
241
241
  `The meaning of the {bold upstream-db} depends on the upstream type:`,
242
242
  `* {bold pg}: The connection database string, e.g. "postgres://..."`,
@@ -246,7 +246,7 @@ var zeroOptions = {
246
246
  hidden: true
247
247
  },
248
248
  maxConns: {
249
- type: valita_exports.number().default(20),
249
+ type: valita_exports.number().optional(() => 20),
250
250
  desc: [
251
251
  `The maximum number of connections to open to the upstream database`,
252
252
  `for committing mutations. This is divided evenly amongst sync workers.`,
@@ -274,8 +274,78 @@ var zeroOptions = {
274
274
  `(Note that this option has no effect for Postgres versions before 17.)`
275
275
  ]
276
276
  },
277
+ pgReplicationSlotPerReplica: {
278
+ type: valita_exports.boolean().optional(() => false),
279
+ desc: [
280
+ `Creates a dedicated replication slot for each replication-manager, rather than`,
281
+ `having a new replication-manager take over the slot of the one it replaces.`,
282
+ ``,
283
+ `A new replication-manager restores its replica from the backup, creates its own slot`,
284
+ `and starts replicating from the head of the change-db's change log while the previous`,
285
+ `replication-manager continues to serve. Once it has caught up to that head, it takes`,
286
+ `over the change log. The replica's backup and the change-db remain compatible with`,
287
+ `the default (shared slot) mode, so disabling this option does not trigger a resync.`,
288
+ ``,
289
+ `This is a rollback-safe intermediate step towards an upcoming high-availability mode,`,
290
+ `in which multiple replication-managers run concurrently with their own slots, each`,
291
+ `maintaining a local change log instead of the global change log in the change-db.`,
292
+ `Running with this option first validates the per-replica slot setup, and rolling back`,
293
+ `from high-availability mode to this configuration re-initializes the change-db's change`,
294
+ `log from the replica rather than requiring a resync.`,
295
+ ``,
296
+ `Requires litestream v5 backups. Each slot retains upstream WAL until it is consumed or`,
297
+ `dropped. Slots of replication-managers that are no longer running are dropped`,
298
+ `automatically.`
299
+ ]
300
+ },
301
+ pgHighAvailabilityReplication: {
302
+ type: valita_exports.boolean().optional(),
303
+ desc: [
304
+ `Runs replication-managers in high-availability mode, allowing multiple tasks to`,
305
+ `run concurrently, each using their own replication slot and maintaining a local`,
306
+ `change-log in sqlite.`,
307
+ ``,
308
+ `In this configuration, the PG change-streamer db is not used or maintained. Consequently`,
309
+ `after running servers in high-availability mode, rolling back to a legacy singleton-mode task`,
310
+ `will trigger a resync in order to re-intialize the PG change-streamer db.`
311
+ ],
312
+ hidden: true
313
+ },
314
+ pgResumeOrphanedSlotGracePeriodMs: {
315
+ type: valita_exports.number().optional(() => 2e4),
316
+ desc: [
317
+ `The grace period to wait before taking over an inactive replication slot, "resuming"`,
318
+ `the replica. With high availability replication, a new replica is generally "forked"`,
319
+ `from a running, active replica. Resumption happens as a last resort when no there are no`,
320
+ `active replicas, as it carries the risk of stealing the slot from a task that is attempting`,
321
+ `to reconnect to its slot.`,
322
+ ``,
323
+ `In local development, where it is often expected for slots to be inactive, it is reasonable to set`,
324
+ `this to value to 0.`
325
+ ],
326
+ hidden: true
327
+ },
328
+ pgReplicationEpoch: {
329
+ type: valita_exports.number().optional(() => 0),
330
+ desc: [
331
+ `Replication managers sharing the same epoch attempt to converge on a single`,
332
+ `generation (i.e. the result of an initial-sync); if multiple tasks are started`,
333
+ `simultaneously, they coordinate with each other such that one performs the`,
334
+ `initial-sync while the others wait for it.`,
335
+ ``,
336
+ `Incrementing the epoch is the way to reliably force a resync; a replication manager`,
337
+ `on a new epoch will ignore any replicas on other epochs.`,
338
+ ``,
339
+ `Note that changing the {bold ZERO_LITESTREAM_BACKUP_URL} generally achieves a resync`,
340
+ `as well, but with high available replication managers, changing only the backup url can`,
341
+ `lead to confusion if an old replication manager is performing initial sync, causing the`,
342
+ `new replication manager to wait for it. Incrementing the replication epoch is recommended`,
343
+ `instead.`
344
+ ],
345
+ hidden: true
346
+ },
277
347
  pgPartialIndexTriggers: {
278
- type: valita_exports.boolean().default(false),
348
+ type: valita_exports.boolean().optional(() => false),
279
349
  hidden: true
280
350
  },
281
351
  pgStreamInboundTimeoutMs: {
@@ -307,7 +377,7 @@ var zeroOptions = {
307
377
  getQueries: getQueriesOptions,
308
378
  query: queryOptions,
309
379
  enableCrudMutations: {
310
- type: valita_exports.boolean().default(true),
380
+ type: valita_exports.boolean().optional(() => true),
311
381
  desc: [
312
382
  `Enables support for legacy CRUD mutations. When this is {bold false}, no connections`,
313
383
  `are made from view-syncers to the upstream db, and push messages with CRUD mutations`,
@@ -315,7 +385,7 @@ var zeroOptions = {
315
385
  ]
316
386
  },
317
387
  allowLegacyQueries: {
318
- type: valita_exports.boolean().default(false),
388
+ type: valita_exports.boolean().optional(() => false),
319
389
  desc: [
320
390
  `Allows clients to send legacy query ASTs directly to zero-cache.`,
321
391
  `Keep this disabled when using custom queries so that zero-cache rejects`,
@@ -332,7 +402,7 @@ var zeroOptions = {
332
402
  ]
333
403
  },
334
404
  maxConns: {
335
- type: valita_exports.number().default(30),
405
+ type: valita_exports.number().optional(() => 30),
336
406
  desc: [
337
407
  `The maximum number of connections to open to the CVR database.`,
338
408
  `This is divided evenly amongst sync workers.`,
@@ -346,7 +416,7 @@ var zeroOptions = {
346
416
  hidden: true
347
417
  },
348
418
  garbageCollectionInactivityThresholdHours: {
349
- type: valita_exports.number().default(168),
419
+ type: valita_exports.number().optional(() => 168),
350
420
  desc: [
351
421
  `The duration after which an inactive CVR is eligible for garbage collection.`,
352
422
  `Purging a CVR forces the next connection from that client group to`,
@@ -357,7 +427,7 @@ var zeroOptions = {
357
427
  ]
358
428
  },
359
429
  garbageCollectionInitialIntervalSeconds: {
360
- type: valita_exports.number().default(60),
430
+ type: valita_exports.number().optional(() => 60),
361
431
  desc: [
362
432
  `The initial interval at which to check and garbage collect inactive CVRs.`,
363
433
  `This interval is increased exponentially (up to 16 minutes) when there is`,
@@ -365,7 +435,7 @@ var zeroOptions = {
365
435
  ]
366
436
  },
367
437
  garbageCollectionInitialBatchSize: {
368
- type: valita_exports.number().default(25),
438
+ type: valita_exports.number().optional(() => 25),
369
439
  desc: [
370
440
  `The initial number of CVRs to purge per garbage collection interval.`,
371
441
  `This number is increased linearly if the rate of new CVRs exceeds the rate of`,
@@ -384,12 +454,25 @@ var zeroOptions = {
384
454
  ]
385
455
  },
386
456
  sqliteCorruptionChecks: {
387
- type: valita_exports.boolean().default(false),
457
+ type: valita_exports.boolean().optional(() => false),
388
458
  desc: [`Run SQLite quick_check and integrity_check when corruption is detected.`, `These checks scan the replica and can take a long time on large databases.`],
389
459
  hidden: true
390
460
  },
461
+ snapshotRowCacheSize: {
462
+ type: valita_exports.number().optional(() => 5e4),
463
+ desc: [
464
+ `The maximum number of entries in the per-worker cache of replica rows`,
465
+ `read while advancing IVM pipelines. Every client group on a sync worker`,
466
+ `reads the new and previous value of each replicated row change; the`,
467
+ `cache lets the client groups on a worker share those reads. A replicated`,
468
+ `transaction of N rows produces up to 2N entries.`,
469
+ ``,
470
+ `Setting this to 0 disables the cache.`
471
+ ],
472
+ hidden: true
473
+ },
391
474
  enableQueryPlanner: {
392
- type: valita_exports.boolean().default(true),
475
+ type: valita_exports.boolean().optional(() => true),
393
476
  desc: [
394
477
  `Enable the query planner for optimizing ZQL queries.`,
395
478
  ``,
@@ -399,8 +482,30 @@ var zeroOptions = {
399
482
  `You can disable the planner if it is picking bad strategies.`
400
483
  ]
401
484
  },
485
+ enableCorrelatedPredicatePushdown: {
486
+ type: valita_exports.boolean().optional(() => true),
487
+ desc: [
488
+ `Copy a query's equality conditions on a relationship's join columns`,
489
+ `into the related subquery. This reduces the rows that are read when a`,
490
+ `change is pushed through the query.`,
491
+ ``,
492
+ `This is a kill switch. It will be removed.`
493
+ ],
494
+ hidden: true
495
+ },
496
+ enablePlannerAwarePushdown: {
497
+ type: valita_exports.boolean().optional(() => true),
498
+ desc: [
499
+ `Copy the conditions of correlated predicate pushdown before the query`,
500
+ `planner runs instead of after, so that the planner can use them. This`,
501
+ `can change the plans that the planner picks.`,
502
+ ``,
503
+ `Has no effect when correlated predicate pushdown is off.`
504
+ ],
505
+ hidden: true
506
+ },
402
507
  enableQueryCovering: {
403
- type: valita_exports.boolean().default(true),
508
+ type: valita_exports.boolean().optional(() => true),
404
509
  desc: [
405
510
  `Enable shadow-mode query covering detection during query hydration.`,
406
511
  ``,
@@ -410,8 +515,96 @@ var zeroOptions = {
410
515
  `You can disable this if covering detection adds too much CPU overhead.`
411
516
  ]
412
517
  },
518
+ deferIvmWrites: {
519
+ type: valita_exports.boolean().optional(() => true),
520
+ desc: [
521
+ `Derive IVM advancements without writing to the replica snapshot.`,
522
+ ``,
523
+ `A view-syncer normally makes each change durable in the SQLite snapshot`,
524
+ `it is reading from, because the next change has to read a base that`,
525
+ `includes the previous ones. Those writes are always rolled back -- the`,
526
+ `replicator is the only committer -- so they exist only to serve reads`,
527
+ `for the rest of the advancement.`,
528
+ ``,
529
+ `When enabled (the default), the changes are held in memory and merged`,
530
+ `into each leaf scan instead, leaving the snapshot read-only, within the`,
531
+ `budget set by {bold deferIvmWritesHeapProportion}. Disable it to write`,
532
+ `every advancement through to the snapshot. The two modes are required`,
533
+ `to be indistinguishable to the pipelines above the source.`
534
+ ],
535
+ hidden: true
536
+ },
537
+ deferIvmWritesHeapProportion: {
538
+ type: valita_exports.number().assert((value) => value > 0 && value <= 1, "must be greater than 0 and at most 1").optional(() => .25),
539
+ desc: [
540
+ `With {bold deferIvmWrites}, the proportion of {bold --max-old-space-size}`,
541
+ `that the client groups of one sync worker may hold in memory at once.`,
542
+ `Each client group holds its own copy of the changes it is advancing`,
543
+ `through. Before an advancement starts, the number of rows it will`,
544
+ `change is reserved from this budget, at an assumed 1 KiB per row; an`,
545
+ `advancement that does not fit is written`,
546
+ `through to the replica snapshot instead, as when {bold deferIvmWrites}`,
547
+ `is off. The bytes the rows are estimated to hold are also added up as`,
548
+ `the client groups go, and a client group that takes the total past the`,
549
+ `budget writes the rows it holds through to the replica snapshot, and`,
550
+ `the rest of its changes after them.`
551
+ ],
552
+ hidden: true
553
+ },
554
+ costBasedSyncEnabled: {
555
+ type: valita_exports.boolean().optional(() => false),
556
+ desc: [
557
+ `Choose per query, by cost, between pushing a batch of changes through`,
558
+ `its pipeline and hydrating it again, and pace the batches of the client`,
559
+ `groups of a sync worker.`,
560
+ ``,
561
+ `When enabled, a query that is estimated to be cheaper to hydrate again`,
562
+ `than to push a batch of changes to (counting what the batch costs to`,
563
+ `read), or whose pushes turn out to have taken as long as hydrating it`,
564
+ `did, is hydrated again at the batch's snapshot, within the same poke.`,
565
+ `This replaces the advancement time limit, which resets every query of`,
566
+ `a client group. A sync worker whose client groups spend more than`,
567
+ `{bold syncUpdateShareTarget} of its time on batches makes them wait`,
568
+ `between batches, in proportion to what their batches cost.`,
569
+ ``,
570
+ `When disabled (the default), a batch of changes is pushed through`,
571
+ `every query that reads it as soon as it is replicated, unless that`,
572
+ `runs into the advancement time limit.`
573
+ ],
574
+ hidden: true
575
+ },
576
+ syncUpdateShareTarget: {
577
+ type: valita_exports.number().assert((value) => value > 0 && value <= .9 || value === 1, "must be greater than 0 and at most 0.9, or 1").optional(() => .7),
578
+ desc: [
579
+ `With {bold costBasedSyncEnabled}, the largest share of its time that a`,
580
+ `sync worker may be busy before its client groups are made to wait`,
581
+ `between batches of changes: at most 0.9, or 1 for them never to be`,
582
+ `made to wait.`
583
+ ],
584
+ hidden: true
585
+ },
586
+ syncMaxBatchIntervalMs: {
587
+ type: valita_exports.number().assert((value) => value >= 0, "must be nonnegative").optional(() => 3e4),
588
+ desc: [
589
+ `With {bold costBasedSyncEnabled}, the longest that a client group is`,
590
+ `made to wait between batches of changes, in milliseconds. This bounds`,
591
+ `how stale the data of a paced client group can get.`
592
+ ],
593
+ hidden: true
594
+ },
595
+ syncRebuildMargin: {
596
+ type: valita_exports.number().assert((value) => value >= 1, "must be at least 1").optional(() => 2),
597
+ desc: [
598
+ `With {bold costBasedSyncEnabled}, how many times the cost of hydrating`,
599
+ `a query again the cost of pushing a batch of changes to it must be`,
600
+ `estimated to be, for the query to be hydrated again without pushing.`,
601
+ `A query below the margin is pushed, until the pushes have taken as`,
602
+ `long as hydrating it did.`
603
+ ],
604
+ hidden: true
605
+ },
413
606
  yieldThresholdMs: {
414
- type: valita_exports.number().default(10),
607
+ type: valita_exports.number().optional(() => 10),
415
608
  desc: [
416
609
  `The maximum amount of time in milliseconds that a sync worker will`,
417
610
  `spend in IVM (processing query hydration and advancement) before yielding`,
@@ -420,7 +613,7 @@ var zeroOptions = {
420
613
  ]
421
614
  },
422
615
  viewSyncerHydrationBudgetMs: {
423
- type: valita_exports.number().assert((value) => Number.isSafeInteger(value) && value >= 0, "must be a nonnegative integer").default(0),
616
+ type: valita_exports.number().assert((value) => Number.isSafeInteger(value) && value >= 0, "must be a nonnegative integer").optional(() => 0),
424
617
  desc: [
425
618
  `The soft time budget in milliseconds for hydrating inactive queries`,
426
619
  `during a view-syncer hydration pass. Active and internal queries always`,
@@ -431,6 +624,18 @@ var zeroOptions = {
431
624
  `hydration-budget eviction.`
432
625
  ]
433
626
  },
627
+ viewSyncerQueryHydrationTimeoutMs: {
628
+ type: valita_exports.number().assert((value) => Number.isSafeInteger(value) && value >= 0, "must be a nonnegative integer").optional(() => 0),
629
+ desc: [
630
+ `The maximum processing time in milliseconds that a view-syncer spends`,
631
+ `hydrating a single client query. Time spent yielding to other work is`,
632
+ `not counted. A query whose hydration exceeds this limit is aborted and`,
633
+ `removed from the client's view, and affected clients receive an error`,
634
+ `for the query. The query is then rejected without being run again for`,
635
+ `a cooldown period, after which a retry is allowed. Internal queries are`,
636
+ `never aborted. A value of 0 disables the limit.`
637
+ ]
638
+ },
434
639
  change: {
435
640
  db: {
436
641
  type: valita_exports.string().optional(),
@@ -442,12 +647,12 @@ var zeroOptions = {
442
647
  },
443
648
  /** @deprecated */
444
649
  maxConns: {
445
- type: valita_exports.number().default(5),
650
+ type: valita_exports.number().optional(() => 5),
446
651
  deprecated: [`Connections to the change db are created dynamically for subscriber catchup. Ensure`, `that the database supports sufficient connections for at least 5 + numViewSyncers.`],
447
652
  hidden: true
448
653
  },
449
654
  statementTimeoutMs: {
450
- type: valita_exports.number().default(3e4),
655
+ type: valita_exports.number().optional(() => 3e4),
451
656
  desc: [
452
657
  `Fail change-log db operations that make no progress within the specified timeout. This`,
453
658
  `differs from a postgres {bold statement_timeout} in that it is implemented to handle a`,
@@ -457,7 +662,7 @@ var zeroOptions = {
457
662
  hidden: true
458
663
  },
459
664
  logBatchSize: {
460
- type: valita_exports.number().assert((n) => Number.isInteger(n) && n >= 1, `change.logBatchSize must be an integer >= 1`).default(2e3),
665
+ type: valita_exports.number().assert((n) => Number.isInteger(n) && n >= 1, `change.logBatchSize must be an integer >= 1`).optional(() => 2e3),
461
666
  desc: [
462
667
  `The maximum number of change-log rows written per multi-row INSERT to the change`,
463
668
  `database. Larger upstream transactions are persisted in batches of this size rather`,
@@ -475,9 +680,23 @@ var zeroOptions = {
475
680
  shard: shardOptions,
476
681
  auth: authOptions,
477
682
  port: {
478
- type: valita_exports.number().default(4848),
683
+ type: valita_exports.number().optional(() => 4848),
479
684
  desc: [`The port for sync connections.`]
480
685
  },
686
+ selfDrainDelayMs: {
687
+ type: valita_exports.number().optional(() => 0),
688
+ desc: [
689
+ `When the server initiates its own graceful restart (e.g. a view-syncer that restores a`,
690
+ `new replica after a resync), it immediately fails health checks (both "/" and`,
691
+ `"/keepalive") so that the container runner stops routing to it and shuts it down as usual`,
692
+ `(e.g. running pre-stop hooks before sending {bold SIGTERM}). After this delay, the server`,
693
+ `sends itself a {bold SIGTERM} if it has not already received one.`,
694
+ ``,
695
+ `The default of 0 drains immediately. In environments with liveness checks, set this to`,
696
+ `exceed the time for the container runner to detect the failed liveness check plus any`,
697
+ `pre-stop delay.`
698
+ ]
699
+ },
481
700
  keepaliveTimeoutMs: {
482
701
  type: valita_exports.number().optional(),
483
702
  desc: [
@@ -508,18 +727,15 @@ var zeroOptions = {
508
727
  `on port 4849.`
509
728
  ]
510
729
  },
730
+ /** @deprecated */
511
731
  mode: {
512
- type: literalUnion("dedicated", "discover").default("dedicated"),
513
- desc: [
514
- `As an alternative to {bold ZERO_CHANGE_STREAMER_URI}, the {bold ZERO_CHANGE_STREAMER_MODE}`,
515
- `can be set to "{bold discover}" to instruct the {bold view-syncer} to connect to the `,
516
- `ip address registered by the {bold replication-manager} upon startup.`,
517
- ``,
518
- `This may not work in all networking configurations, e.g. certain private `,
519
- `networking or port forwarding configurations. Using the {bold ZERO_CHANGE_STREAMER_URI}`,
520
- `with an explicit routable hostname is recommended instead.`,
732
+ type: literalUnion("dedicated", "discover").optional(() => "dedicated"),
733
+ deprecated: [
734
+ `Set the {bold ZERO_CHANGE_STREAMER_URI} on view-syncers instead.`,
521
735
  ``,
522
- `Note: This option is ignored if the {bold ZERO_CHANGE_STREAMER_URI} is set.`
736
+ `When {bold ZERO_UPSTREAM_PG_HIGH_AVAILABILITY_REPLICATION} (i.e. "RMv2") is enabled`,
737
+ `the zero-cache will no longer support automatic change-streamer discovery,`,
738
+ `and setting this flag to "discover" will result in an error.`
523
739
  ]
524
740
  },
525
741
  port: {
@@ -540,12 +756,12 @@ var zeroOptions = {
540
756
  },
541
757
  /** @deprecated */
542
758
  protocol: {
543
- type: literalUnion("ws", "wss").default("ws"),
759
+ type: literalUnion("ws", "wss").optional(() => "ws"),
544
760
  deprecated: [`Set the {bold ZERO_CHANGE_STREAMER_URI} on view-syncers instead.`],
545
761
  hidden: true
546
762
  },
547
763
  discoveryInterfacePreferences: {
548
- type: valita_exports.array(valita_exports.string()).default([...DEFAULT_PREFERRED_PREFIXES]),
764
+ type: valita_exports.array(valita_exports.string()).optional(() => [...DEFAULT_PREFERRED_PREFIXES]),
549
765
  desc: [
550
766
  `The name prefixes to prefer when introspecting the network interfaces to determine`,
551
767
  `the externally reachable IP address for change-streamer discovery. This defaults`,
@@ -555,7 +771,7 @@ var zeroOptions = {
555
771
  hidden: true
556
772
  },
557
773
  startupDelayMs: {
558
- type: valita_exports.number().default(15e3),
774
+ type: valita_exports.number().optional(() => 15e3),
559
775
  desc: [
560
776
  `The delay to wait before the change-streamer takes over the replication stream`,
561
777
  `(i.e. the handoff during replication-manager updates), to allow loadbalancers to register`,
@@ -565,17 +781,26 @@ var zeroOptions = {
565
781
  ]
566
782
  },
567
783
  sqliteChangeLogMode: {
568
- type: literalUnion("off", "write", "compare", "serve").default("off"),
784
+ type: literalUnion("off", "write", "compare", "serve").optional(() => "off"),
569
785
  desc: [`Controls the staged SQLite change-log rollout. Modes are cumulative:`, `{bold off}, {bold write}, {bold compare}, and {bold serve}.`],
570
786
  hidden: true
571
787
  },
788
+ pgChangeLogEnabled: {
789
+ type: valita_exports.boolean().optional(() => true),
790
+ desc: [
791
+ `Whether the legacy Postgres change log remains authoritative for`,
792
+ `stream initialization, persistence, catchup, and upstream ACKs.`,
793
+ `Disabling it requires SQLite serve mode at 100 percent and a v5 backup.`
794
+ ],
795
+ hidden: true
796
+ },
572
797
  sqliteChangeLogReadPercent: {
573
- type: valita_exports.number().default(0),
798
+ type: valita_exports.number().optional(() => 0),
574
799
  desc: [`The stable percentage of eligible catchup subscriptions served from SQLite.`],
575
800
  hidden: true
576
801
  },
577
802
  sqliteChangeLogColdReadPercent: {
578
- type: valita_exports.number().default(0),
803
+ type: valita_exports.number().optional(() => 0),
579
804
  desc: [
580
805
  `The stable percentage of eligible catchup subscriptions served from a`,
581
806
  `SQLite change log that is younger than its retention window, i.e. one`,
@@ -587,27 +812,27 @@ var zeroOptions = {
587
812
  hidden: true
588
813
  },
589
814
  sqliteChangeLogComparePercent: {
590
- type: valita_exports.number().default(1),
815
+ type: valita_exports.number().optional(() => 1),
591
816
  desc: [`The stable percentage of committed transactions whose catchup output is`, `compared between the Postgres and SQLite change logs in {bold compare} mode.`],
592
817
  hidden: true
593
818
  },
594
819
  sqliteChangeLogRetentionMs: {
595
- type: valita_exports.number().default(6e4),
820
+ type: valita_exports.number().optional(() => 6e4),
596
821
  desc: [`The minimum time window retained in the SQLite change log.`],
597
822
  hidden: true
598
823
  },
599
824
  sqliteChangeLogReadBatchRows: {
600
- type: valita_exports.number().default(1e3),
825
+ type: valita_exports.number().optional(() => 1e3),
601
826
  desc: [`The target number of rows in each SQLite catchup read batch.`],
602
827
  hidden: true
603
828
  },
604
829
  sqliteChangeLogPurgeBatchRows: {
605
- type: valita_exports.number().default(1e3),
830
+ type: valita_exports.number().optional(() => 1e3),
606
831
  desc: [`The target number of rows in each SQLite purge batch.`],
607
832
  hidden: true
608
833
  },
609
834
  sqliteChangeLogBarrierTimeoutMs: {
610
- type: valita_exports.number().default(3e5),
835
+ type: valita_exports.number().optional(() => 3e5),
611
836
  desc: [
612
837
  `The maximum wait for the SQLite required-head barrier. This is a`,
613
838
  `backstop for a wedged replica on an idle shard, where waiting costs`,
@@ -619,7 +844,7 @@ var zeroOptions = {
619
844
  hidden: true
620
845
  },
621
846
  backPressureLimitHeapProportion: {
622
- type: valita_exports.number().default(.04),
847
+ type: valita_exports.number().optional(() => .04),
623
848
  desc: [
624
849
  `The percentage of {bold --max-old-space-size} to use as a buffer for absorbing replication`,
625
850
  `stream spikes. When the estimated amount of queued data exceeds this threshold, back pressure`,
@@ -642,7 +867,7 @@ var zeroOptions = {
642
867
  ]
643
868
  },
644
869
  flowControlConsensusTimeoutProportion: {
645
- type: valita_exports.number().default(2),
870
+ type: valita_exports.number().optional(() => 4),
646
871
  desc: [
647
872
  `During periodic flow control checks (every 64kb), the amount of time to wait after the majority`,
648
873
  `of subscribers have acked, proportional to that interval, after which replication will continue`,
@@ -656,7 +881,7 @@ var zeroOptions = {
656
881
  ``,
657
882
  `For example, if the majority of subscribers ack a message in 2.5ms, a padding proportion of`,
658
883
  `1.0 instructs replication to continue after an additional 2.5ms; for a proportion of 2.0, an`,
659
- `additional 5.0ms, etc. The default value of 2.0 allows for a subscriber to be 3x slower than the`,
884
+ `additional 5.0ms, etc. The default value of 4.0 allows for a subscriber to be 5x slower than the`,
660
885
  `majority in the steady state, while similarly bounding the extent to which a temporarily lagging`,
661
886
  `subscriber (e.g. due to catchup) slows down the fleet.`,
662
887
  ``,
@@ -669,7 +894,7 @@ var zeroOptions = {
669
894
  ]
670
895
  },
671
896
  flowControlSlowSubscriberGracePeriodSeconds: {
672
- type: valita_exports.number().default(30),
897
+ type: valita_exports.number().optional(() => 30),
673
898
  desc: [
674
899
  `The period of time after which a lagging subscriber is disconnected and instructed to`,
675
900
  `restart. A subscriber is considered lagging if it {italic continuously} (1) exceeds the`,
@@ -693,6 +918,23 @@ var zeroOptions = {
693
918
  `Set this to 0 or a negative number to disable laggard detection. (Not recommended, but`,
694
919
  `available as an emergency measure.)`
695
920
  ]
921
+ },
922
+ maxConcurrentSwitchoverRestores: {
923
+ type: valita_exports.number().optional(() => 1),
924
+ desc: [
925
+ `The targeted number of view-syncers allowed to restart and replace their replica with`,
926
+ `this replication-manager's backup at a given time, when view-syncers with an incompatible`,
927
+ `replica (e.g. after a resync) switch over from a draining replication-manager. These`,
928
+ `view-syncers wait for permission to restore before switching over, so that not all of`,
929
+ `them stop serving at once.`,
930
+ ``,
931
+ `Any view-syncer that replaces an incompatible or outdated local replica counts towards`,
932
+ `this number (e.g. one that restarted on its own), but is not itself limited by it.`,
933
+ `View-syncers restoring onto an empty disk (e.g. new pods) are not counted or limited.`,
934
+ ``,
935
+ `This parameter only has effect when {bold ZERO_UPSTREAM_PG_HIGH_AVAILABILITY_REPLICATION}`,
936
+ `is enabled.`
937
+ ]
696
938
  }
697
939
  },
698
940
  taskID: {
@@ -716,7 +958,7 @@ var zeroOptions = {
716
958
  ]
717
959
  },
718
960
  autoReset: {
719
- type: valita_exports.boolean().default(true),
961
+ type: valita_exports.boolean().optional(() => true),
720
962
  desc: [
721
963
  `Automatically wipe and resync the replica when replication is halted.`,
722
964
  `This situation can occur for configurations in which the upstream database`,
@@ -731,29 +973,89 @@ var zeroOptions = {
731
973
  `slowness or downtime if compute resources are scarce.`
732
974
  ]
733
975
  },
734
- replicationLag: { reportIntervalMs: {
735
- type: valita_exports.number().default(3e4),
736
- desc: [
737
- `The minimum interval at which replication lag reports are written upstream and`,
738
- `reported via the {bold zero.replication.total_lag} opentelemetry metric. If`,
739
- `an expected report is not received before the next interval, Zero retries with`,
740
- `a new report and increments {bold zero.replication.lag_report_retries}. A`,
741
- `negative or 0 value disables lag reporting.`,
742
- ``,
743
- `This monitoring feature is only support on the postgres upstream type.`
744
- ]
745
- } },
976
+ replicationLag: {
977
+ reportIntervalMs: {
978
+ type: valita_exports.number().optional(() => 1e4),
979
+ desc: [
980
+ `The approximate interval at which replication lag reports are written upstream and`,
981
+ `reported via the {bold zero.replication.total_lag} opentelemetry metric. If`,
982
+ `an expected report is not received before the next interval, Zero retries with`,
983
+ `a new report and increments {bold zero.replication.lag_report_retries}.`,
984
+ ``,
985
+ `Note that the interval is approximate and scheduled with ~1 second jitter to allow`,
986
+ `multiple replication-managers (in RMv2) to cooperatively share the same reports.`,
987
+ ``,
988
+ `When enabled, lag reports are used to gate readiness of servers coming online by waiting`,
989
+ `for lag to fall below the {bold ZERO_REPLICATION_LAG_INITIAL_READINESS_THRESHOLD_MS}.`,
990
+ `As such, the reporting interval determines the time for which a new server waits for`,
991
+ `the next report to determine readiness.`,
992
+ ``,
993
+ `A negative or 0 value disables lag reporting and the associated readiness gating.`,
994
+ ``,
995
+ `This feature is only supported on the postgres upstream type.`
996
+ ]
997
+ },
998
+ initialReadinessThresholdMs: {
999
+ type: valita_exports.number().optional(() => 1e3),
1000
+ desc: [
1001
+ `The maximum replication lag in milliseconds that a server is allowed to have`,
1002
+ `before it advertises readiness (to serve traffic). This prevents the server`,
1003
+ `from serving stale data to clients when it is first started.`,
1004
+ ``,
1005
+ `Note that this is an initial readiness gate only. Once the server announces readiness,`,
1006
+ `it will continue to serve traffic even if the replication lag exceeds this threshold`,
1007
+ `thereafter.`,
1008
+ ``,
1009
+ `When lag reporting is disabled, readiness is not gated by replication lag.`
1010
+ ]
1011
+ },
1012
+ maxReadinessDelayMs: {
1013
+ type: valita_exports.number().optional(() => 6e5),
1014
+ desc: [
1015
+ `The maximum time in milliseconds that a server will wait for replication lag`,
1016
+ `to fall below the {bold ZERO_REPLICATION_LAG_INITIAL_READINESS_THRESHOLD_MS}`,
1017
+ `before it announces readiness. This prevents the server from waiting indefinitely`,
1018
+ `for lag to fall below the threshold, which can occur if the upstream database`,
1019
+ `is under heavy load or if there is a network partition.`
1020
+ ]
1021
+ }
1022
+ },
746
1023
  adminPassword: {
747
1024
  type: valita_exports.string().optional(),
748
1025
  desc: [
749
1026
  `A password used to administer zero-cache server, for example to access the`,
750
1027
  `/statz endpoint.`,
751
1028
  "",
752
- "A password is optional in development mode but {bold required in production} mode."
1029
+ "A password is optional in development mode but {bold required in production} mode.",
1030
+ "",
1031
+ "The admin password also grants access to everything that the",
1032
+ "{bold operator-password} does."
1033
+ ]
1034
+ },
1035
+ operatorPassword: {
1036
+ type: valita_exports.string().optional(),
1037
+ desc: [
1038
+ `A password that grants access only to the diagnostic endpoints that cannot`,
1039
+ `expose application data, so that people who operate zero-cache can`,
1040
+ `diagnose it without being able to read the data it serves. These are:`,
1041
+ "",
1042
+ `* {bold /profz} and {bold /profrmz}: CPU profiles. Profiles served for the`,
1043
+ ` operator password have the source of every regular expression redacted,`,
1044
+ ` since those can contain LIKE patterns from client queries.`,
1045
+ `* {bold /statz}: counts and sizes.`,
1046
+ `* {bold /plannerz}: the replica's schema and planner statistics.`,
1047
+ "",
1048
+ `All other protected endpoints (the inspector and {bold /heapz}) still`,
1049
+ `require the {bold admin-password}.`,
1050
+ "",
1051
+ `For {bold /profrmz} in a multi-node deployment, the replication-manager`,
1052
+ `must be configured with the same operator password.`,
1053
+ "",
1054
+ `If it is the same as the {bold admin-password}, it grants admin access.`
753
1055
  ]
754
1056
  },
755
1057
  websocketCompression: {
756
- type: valita_exports.boolean().default(false),
1058
+ type: valita_exports.boolean().optional(() => false),
757
1059
  desc: [
758
1060
  "Enable WebSocket per-message deflate compression.",
759
1061
  "",
@@ -776,7 +1078,7 @@ var zeroOptions = {
776
1078
  ]
777
1079
  },
778
1080
  websocketMaxPayloadBytes: {
779
- type: valita_exports.number().default(10 * 1024 * 1024),
1081
+ type: valita_exports.number().optional(() => 10 * 1024 * 1024),
780
1082
  desc: [
781
1083
  "Maximum size of incoming WebSocket messages in bytes.",
782
1084
  "",
@@ -804,7 +1106,7 @@ var zeroOptions = {
804
1106
  ]
805
1107
  },
806
1108
  restoreUsingV5: {
807
- type: valita_exports.boolean().default(true),
1109
+ type: valita_exports.boolean().optional(() => true),
808
1110
  desc: [
809
1111
  `Restores the backup using the {bold ZERO_LITESTREAM_EXECUTABLE_V5} if specified.`,
810
1112
  `This provides a recovery path if rolling back from {bold ZERO_LITESTREAM_BACKUP_USING_V5}`,
@@ -812,16 +1114,42 @@ var zeroOptions = {
812
1114
  ]
813
1115
  },
814
1116
  backupUsingV5: {
815
- type: valita_exports.boolean().default(false),
1117
+ type: valita_exports.boolean().optional(() => true),
816
1118
  desc: [
817
- `Backs up the replica using Litestream v0.5.x and monitors cleanup`,
818
- `watermarks by reading the backup through the Litestream SQLite VFS.`,
819
- `This requires {bold ZERO_LITESTREAM_RESTORE_USING_V5} and`,
820
- `{bold ZERO_LITESTREAM_VFS_QUERY_EXECUTABLE}`
1119
+ `Backs up the replica using Litestream v0.5.x. This is required for (upcoming)`,
1120
+ `high-availability replication. Set to false to revert to Litestream v0.3.x backups.`,
1121
+ ``,
1122
+ `zero-cache requests an incremental backup every`,
1123
+ `{bold ZERO_LITESTREAM_INCREMENTAL_BACKUP_INTERVAL_SECONDS} and only acknowledges`,
1124
+ `changes upstream once a backup containing them has completed.`,
1125
+ ``,
1126
+ `Litestream v0.5.x allows only one writer per backup location, so each`,
1127
+ `replication-manager backs up to its own subfolder of the backup URL. Subfolders`,
1128
+ `left by previous replication-managers are not cleaned up automatically; that is`,
1129
+ `up to the operator. The simplest approach is a lifecycle expiration rule on the`,
1130
+ `object store (e.g. S3). Every file needed for a restore is at most about`,
1131
+ `{bold ZERO_LITESTREAM_SNAPSHOT_BACKUP_INTERVAL_HOURS} old, so an expiration of at`,
1132
+ `least twice that interval is safe.`,
1133
+ ``,
1134
+ `Requires {bold ZERO_LITESTREAM_RESTORE_USING_V5} (enabled by default).`
1135
+ ]
1136
+ },
1137
+ forkBackup: {
1138
+ type: valita_exports.boolean().optional(() => true),
1139
+ hidden: true,
1140
+ desc: [
1141
+ `When a replication-manager restores from another replication-manager's`,
1142
+ `backup, also copies the restored backup files into its own (new) backup`,
1143
+ `subfolder, so that its first backup continues incrementally instead of`,
1144
+ `uploading a full snapshot of the replica.`,
1145
+ ``,
1146
+ `This only works with a {bold ZERO_LITESTREAM_EXECUTABLE_V5} that supports`,
1147
+ `{bold restore -fork-to-url}. The flag is ignored if {bold ZERO_LITESTREAM_BACKUP_USING_V5}`,
1148
+ `is disabled.`
821
1149
  ]
822
1150
  },
823
1151
  configPath: {
824
- type: valita_exports.string().default("./src/services/litestream/config.yml"),
1152
+ type: valita_exports.string().optional(() => "./src/services/litestream/config.yml"),
825
1153
  desc: [
826
1154
  `Path to the litestream yaml config file. zero-cache will run this with its`,
827
1155
  `environment variables, which can be referenced in the file via $\\{ENV\\}`,
@@ -833,7 +1161,7 @@ var zeroOptions = {
833
1161
  ]
834
1162
  },
835
1163
  configPathV5: {
836
- type: valita_exports.string().default("./src/services/litestream/config-v5.yml"),
1164
+ type: valita_exports.string().optional(() => "./src/services/litestream/config-v5.yml"),
837
1165
  desc: [
838
1166
  `Path to the litestream v5 yaml config file. zero-cache will run this with its`,
839
1167
  `environment variables, which can be referenced in the file via $\\{ENV\\}`,
@@ -844,29 +1172,7 @@ var zeroOptions = {
844
1172
  `* {bold ZERO_LOG_FORMAT} for the log type`
845
1173
  ]
846
1174
  },
847
- vfsQueryExecutable: {
848
- type: valita_exports.string().optional(),
849
- desc: [`Path to the rocicorp vfs-query executable that runs the VFS-based`, `polling of backup watermark. This is required when backing up with V5.`]
850
- },
851
- vfsPollIntervalMs: {
852
- type: valita_exports.number().default(15 * 1e3),
853
- desc: [
854
- `Interval in milliseconds litestream vfs extension polls the backup store (e.g. s3)`,
855
- `to determine the most recent backup.`,
856
- ``,
857
- `This, in turn, influences how quickly new backups are confirmed, allowing the`,
858
- `change-streamer to ack the upstream change-source (e.g. replication slot).`
859
- ]
860
- },
861
- vfsPollTimeoutMs: {
862
- type: valita_exports.number().default(10 * 1e3),
863
- desc: [`Timeout in milliseconds for requests to the Litestream VFS poller.`]
864
- },
865
- vfsLogFile: {
866
- type: valita_exports.string().optional(),
867
- desc: [`Optional file path for logs emitted by the Litestream VFS native`, `extension. If unset, the extension writes to stdout.`]
868
- },
869
- logLevel: { type: literalUnion("debug", "info", "warn", "error").default("warn") },
1175
+ logLevel: { type: literalUnion("debug", "info", "warn", "error").optional(() => "warn") },
870
1176
  backupURL: {
871
1177
  type: valita_exports.string().optional(),
872
1178
  desc: [
@@ -875,6 +1181,11 @@ var zeroOptions = {
875
1181
  `{bold view-syncers} receive this information from the {bold replication-manager}.`
876
1182
  ]
877
1183
  },
1184
+ backupURLOverride: {
1185
+ type: valita_exports.string().optional(),
1186
+ desc: [`Overrides the backup URL when present.`],
1187
+ hidden: true
1188
+ },
878
1189
  endpoint: {
879
1190
  type: valita_exports.string().optional(),
880
1191
  desc: [`The S3-compatible endpoint URL to use for the litestream backup. Only required for non-AWS services.`, `The {bold replication-manager} and {bold view-syncers} must have the same endpoint.`]
@@ -897,7 +1208,7 @@ var zeroOptions = {
897
1208
  ]
898
1209
  },
899
1210
  checkpointThresholdMB: {
900
- type: valita_exports.number().default(40),
1211
+ type: valita_exports.number().optional(() => 40),
901
1212
  desc: [
902
1213
  `The size of the WAL file at which litestream performs background, best-effort (PASSIVE)`,
903
1214
  `SQLite checkpoints to apply the writes in the WAL to the main database file. Checkpoints`,
@@ -924,7 +1235,7 @@ var zeroOptions = {
924
1235
  ]
925
1236
  },
926
1237
  forceCheckpointThresholdMB: {
927
- type: valita_exports.number().default(0),
1238
+ type: valita_exports.number().optional(() => 256),
928
1239
  desc: [
929
1240
  `The size of the WAL file at which to pause writes and explicitly initiate a`,
930
1241
  `local litestream sync. This is a safeguard for the situation in which litestream's`,
@@ -943,11 +1254,10 @@ var zeroOptions = {
943
1254
  `emergency break.`,
944
1255
  ``,
945
1256
  `This feature is only enabled with {bold ZERO_LITESTREAM_BACKUP_USING_V5}.`
946
- ],
947
- hidden: true
1257
+ ]
948
1258
  },
949
1259
  maxWalSizeMB: {
950
- type: valita_exports.number().default(10240),
1260
+ type: valita_exports.number().optional(() => 10240),
951
1261
  desc: [
952
1262
  `A fail-safe that pauses writes once the un-checkpointed WAL reaches this size,`,
953
1263
  `resuming when litestream manages to checkpoint it. This bounds WAL growth (and`,
@@ -961,11 +1271,10 @@ var zeroOptions = {
961
1271
  `normal operation. Set to {bold 0} to disable.`,
962
1272
  ``,
963
1273
  `This feature is only enabled with {bold ZERO_LITESTREAM_BACKUP_USING_V5}.`
964
- ],
965
- hidden: true
1274
+ ]
966
1275
  },
967
1276
  incrementalBackupIntervalMinutes: {
968
- type: valita_exports.number().default(5),
1277
+ type: valita_exports.number().optional(() => 15),
969
1278
  desc: [
970
1279
  `The interval between incremental v3 backups of the replica. Shorter intervals`,
971
1280
  `reduce the amount of change history that needs to be replayed when catching`,
@@ -978,21 +1287,25 @@ var zeroOptions = {
978
1287
  ]
979
1288
  },
980
1289
  snapshotBackupIntervalHours: {
981
- type: valita_exports.number().default(4),
1290
+ type: valita_exports.number().optional(() => 12),
982
1291
  desc: [
983
- `The interval between snapshot backups of the replica. Snapshot backups`,
984
- `make a full copy of the database to a new litestream generation. This`,
985
- `improves restore time at the expense of bandwidth. Applications with a`,
986
- `large database and low write rate can increase this interval to reduce`,
987
- `network usage for backups (litestream defaults to 24 hours).`,
1292
+ `The interval between snapshot backups of the replica. Applies to both`,
1293
+ `litestream v3 and v5 backups.`,
988
1294
  ``,
989
- `This option only applies to litestream v3 backups and will be deprecated/removed`,
990
- `once the zero-cache is transitioned to litestream v5. For configuring v5 backup`,
991
- `frequency, use {bold ZERO_LITESTREAM_SNAPSHOT_BACKUP_INTERVAL_HOURS_V5}.`
1295
+ `For v3, each snapshot makes a full copy of the database to a new litestream`,
1296
+ `generation. This improves restore time at the expense of bandwidth.`,
1297
+ `Applications with a large database and low write rate can increase this`,
1298
+ `interval to reduce network usage for backups (litestream defaults to 24 hours).`,
1299
+ ``,
1300
+ `For v5, continuous compaction already keeps restore times low, so snapshots`,
1301
+ `serve a different purpose: they keep every file a restore needs within about`,
1302
+ `one interval of age, so that lifecycle policies can clean up old backups.`,
1303
+ `v5 snapshots are built by compacting the existing backup files rather than`,
1304
+ `reading the replica, so they do not block WAL checkpoints.`
992
1305
  ]
993
1306
  },
994
1307
  incrementalBackupIntervalSeconds: {
995
- type: valita_exports.number().default(15),
1308
+ type: valita_exports.number().optional(() => 15),
996
1309
  desc: [
997
1310
  `The interval between incremental v5 backups of the replica. With litestream v5`,
998
1311
  `the upstream change source is not ACKed until the corresponding changes have been`,
@@ -1006,40 +1319,21 @@ var zeroOptions = {
1006
1319
  `{bold ZERO_LITESTREAM_INCREMENTAL_BACKUP_INTERVAL_MINUTES}.`
1007
1320
  ]
1008
1321
  },
1009
- snapshotBackupIntervalHoursV5: {
1010
- type: valita_exports.number().default(720),
1011
- desc: [
1012
- `The interval between snapshot backups of the replica when`,
1013
- `{bold ZERO_LITESTREAM_BACKUP_USING_V5} is enabled.`,
1014
- ``,
1015
- `By default, snapshots are effectively disabled (i.e. every 30 days)`,
1016
- `because v5 compaction fulfills the role that snapshots played in v3`,
1017
- `(i.e. because of litestream v5 compaction, restores will generally involve`,
1018
- `O(db-size) bytes.`,
1019
- ``,
1020
- `Snapshots are disabled by default because they hold a read-lock on`,
1021
- `the database and prevent wal checkpoints, introducing the risk of large wal`,
1022
- `files for large databases with a high write rate.`,
1023
- ``,
1024
- `If configuring the zero-cache to actually perform v5 snapshots, the`,
1025
- `{bold ZERO_LITESTREAM_MAX_WAL_SIZE_MB} option can be used to pause replication`,
1026
- `if the wal reaches a certain size and cannot be checkpointed because of an`,
1027
- `in-progress snapshot.`,
1028
- ``,
1029
- `This option only applies to litestream v5 backups. For v3 backups, use`,
1030
- `{bold ZERO_LITESTREAM_SNAPSHOT_BACKUP_INTERVAL_HOURS}.`
1031
- ]
1032
- },
1033
1322
  restoreParallelism: {
1034
- type: valita_exports.number().default(48),
1323
+ type: valita_exports.number().optional(() => 48),
1035
1324
  desc: [`The number of WAL files to download in parallel when performing the`, `initial restore of the replica from the backup.`]
1036
1325
  },
1037
1326
  multipartConcurrency: {
1038
- type: valita_exports.number().default(48),
1039
- desc: [`The number of parts (of size {bold --litestream-multipart-size} bytes)`, `to upload or download in parallel when backing up or restoring the snapshot.`]
1327
+ type: valita_exports.number().optional(),
1328
+ desc: [
1329
+ `The number of parts (of size {bold --litestream-multipart-size} bytes)`,
1330
+ `to upload or download in parallel when backing up or restoring the snapshot.`,
1331
+ `Leave this unset to use 48, reduced as needed to keep the parts within`,
1332
+ `a quarter of the memory available to the container.`
1333
+ ]
1040
1334
  },
1041
1335
  multipartSize: {
1042
- type: valita_exports.number().default(16 * 1024 * 1024),
1336
+ type: valita_exports.number().optional(() => 16 * 1024 * 1024),
1043
1337
  desc: [
1044
1338
  `The size of each part when uploading or downloading the snapshot with`,
1045
1339
  `{bold --multipart-concurrency}. Note that up to {bold concurrency * size}`,
@@ -1053,7 +1347,7 @@ var zeroOptions = {
1053
1347
  },
1054
1348
  initialSync: {
1055
1349
  tableCopyWorkers: {
1056
- type: valita_exports.number().default(5),
1350
+ type: valita_exports.number().optional(() => 5),
1057
1351
  desc: [
1058
1352
  `The number of parallel workers used to copy tables during initial sync.`,
1059
1353
  `Each worker uses a database connection and will buffer up to (approximately)`,
@@ -1068,7 +1362,7 @@ var zeroOptions = {
1068
1362
  desc: [`Takes a cpu profile during the copy phase initial-sync, storing it as a JSON file`, `initial-copy.cpuprofile in the tmp directory.`]
1069
1363
  },
1070
1364
  textCopy: {
1071
- type: valita_exports.boolean().default(false),
1365
+ type: valita_exports.boolean().optional(() => false),
1072
1366
  desc: [
1073
1367
  `Use text-format COPY instead of binary COPY for initial sync and`,
1074
1368
  `backfill streaming. This is slower but can work around issues with`,
@@ -1078,7 +1372,7 @@ var zeroOptions = {
1078
1372
  },
1079
1373
  shadowSync: {
1080
1374
  enabled: {
1081
- type: valita_exports.boolean().default(false),
1375
+ type: valita_exports.boolean().optional(() => false),
1082
1376
  desc: [
1083
1377
  `Periodically exercises the initial-sync code path against a sample of`,
1084
1378
  `rows from every published table, writing to a throwaway SQLite database.`,
@@ -1088,7 +1382,7 @@ var zeroOptions = {
1088
1382
  ]
1089
1383
  },
1090
1384
  intervalHours: {
1091
- type: valita_exports.number().default(12),
1385
+ type: valita_exports.number().optional(() => 12),
1092
1386
  desc: [
1093
1387
  `The interval between shadow initial-sync runs, in hours. The first`,
1094
1388
  `run fires within [2/3, 1) of this interval after startup, so the`,
@@ -1098,7 +1392,7 @@ var zeroOptions = {
1098
1392
  ]
1099
1393
  },
1100
1394
  sampleRate: {
1101
- type: valita_exports.number().default(.1),
1395
+ type: valita_exports.number().optional(() => .1),
1102
1396
  desc: [
1103
1397
  `The BERNOULLI sampling rate for each table (0 < rate <= 1). A value of`,
1104
1398
  `1 disables sampling and copies all rows (still subject to`,
@@ -1106,13 +1400,13 @@ var zeroOptions = {
1106
1400
  ]
1107
1401
  },
1108
1402
  maxRowsPerTable: {
1109
- type: valita_exports.number().default(1e4),
1403
+ type: valita_exports.number().optional(() => 1e4),
1110
1404
  desc: [`The hard upper bound on rows copied per table per shadow run. Guards`, `against unexpectedly large tables consuming disk / upstream bandwidth.`]
1111
1405
  }
1112
1406
  },
1113
1407
  /** @deprecated */
1114
1408
  targetClientRowCount: {
1115
- type: valita_exports.number().default(2e4),
1409
+ type: valita_exports.number().optional(() => 2e4),
1116
1410
  deprecated: [
1117
1411
  "This option is no longer used and will be removed in a future version.",
1118
1412
  "The client-side cache no longer enforces a row limit. Instead, TTL-based expiration",
@@ -1121,7 +1415,7 @@ var zeroOptions = {
1121
1415
  hidden: true
1122
1416
  },
1123
1417
  lazyStartup: {
1124
- type: valita_exports.boolean().default(false),
1418
+ type: valita_exports.boolean().optional(() => false),
1125
1419
  desc: [
1126
1420
  "Delay starting the majority of zero-cache until first request.",
1127
1421
  "",
@@ -1136,7 +1430,7 @@ var zeroOptions = {
1136
1430
  desc: [`The version string outputted to logs when the server starts up.`]
1137
1431
  },
1138
1432
  enableTelemetry: {
1139
- type: valita_exports.boolean().default(true),
1433
+ type: valita_exports.boolean().optional(() => true),
1140
1434
  desc: [
1141
1435
  `Set to false to opt out of telemetry collection.`,
1142
1436
  ``,
@@ -1183,6 +1477,19 @@ function getZeroConfig(opts = {}) {
1183
1477
  return loadedConfig;
1184
1478
  }
1185
1479
  /**
1480
+ * Parses only the log options, ignoring all other flags and environment
1481
+ * variables. For lightweight workers that need to set up logging but do not
1482
+ * need (or require) the rest of the zero config to be present or normalized.
1483
+ */
1484
+ function getLogConfig(opts = {}) {
1485
+ return parseOptions({ log: logOptions }, {
1486
+ envNamePrefix: ZERO_ENV_VAR_PREFIX,
1487
+ emitDeprecationWarnings: false,
1488
+ allowUnknown: true,
1489
+ ...opts
1490
+ });
1491
+ }
1492
+ /**
1186
1493
  * Same as {@link getZeroConfig}, with an additional check that the
1187
1494
  * config has already been normalized (i.e. by the top level server/runner).
1188
1495
  */
@@ -1198,28 +1505,54 @@ function getNormalizedZeroConfig(opts = {}) {
1198
1505
  function getServerVersion(config) {
1199
1506
  return config?.serverVersion ?? package_default.version;
1200
1507
  }
1508
+ /**
1509
+ * Returns whether `password` is the admin password. Endpoints that can expose
1510
+ * application data must use this, which never accepts the operator password.
1511
+ */
1201
1512
  function isAdminPasswordValid(lc, config, password) {
1202
- if (!password && !config.adminPassword && isDevelopmentMode()) {
1513
+ return getAccess(lc, config, void 0, password) === "admin";
1514
+ }
1515
+ /**
1516
+ * Returns the access that `password` grants, accepting either the admin
1517
+ * password or the operator password, or `undefined` if it grants none.
1518
+ *
1519
+ * Only endpoints that cannot expose application data may use this, and they
1520
+ * must not serve anything to `operator` access that `--operator-password`
1521
+ * documents as withheld.
1522
+ */
1523
+ function getOperatorAccess(lc, config, password) {
1524
+ return getAccess(lc, config, config.operatorPassword, password);
1525
+ }
1526
+ function getAccess(lc, { adminPassword }, operatorPassword, password) {
1527
+ if (!password && !adminPassword && isDevelopmentMode()) {
1203
1528
  warnOnce(lc, "No admin password set; allowing access in development mode only");
1204
- return true;
1529
+ return "admin";
1205
1530
  }
1206
- if (!config.adminPassword) {
1531
+ if (!adminPassword && !operatorPassword) {
1207
1532
  lc.warn?.("No admin password set; denying access");
1208
- return false;
1533
+ return;
1209
1534
  }
1210
- const passwordBuffer = Buffer.from(password ?? "");
1211
- const configBuffer = Buffer.from(config.adminPassword);
1212
- if (passwordBuffer.length !== configBuffer.length) {
1213
- timingSafeEqual(configBuffer, configBuffer);
1214
- lc.warn?.("Invalid admin password");
1215
- return false;
1535
+ const isAdmin = passwordMatches(password, adminPassword);
1536
+ const isOperator = passwordMatches(password, operatorPassword);
1537
+ if (isAdmin) {
1538
+ lc.debug?.("Admin password accepted");
1539
+ return "admin";
1540
+ }
1541
+ if (isOperator) {
1542
+ lc.debug?.("Operator password accepted");
1543
+ return "operator";
1216
1544
  }
1217
- if (!timingSafeEqual(passwordBuffer, configBuffer)) {
1218
- lc.warn?.("Invalid admin password");
1545
+ lc.warn?.(operatorPassword ? "Invalid admin or operator password" : "Invalid admin password");
1546
+ }
1547
+ function passwordMatches(password, expected) {
1548
+ if (!expected) return false;
1549
+ const passwordBuffer = Buffer.from(password ?? "");
1550
+ const expectedBuffer = Buffer.from(expected);
1551
+ if (passwordBuffer.length !== expectedBuffer.length) {
1552
+ timingSafeEqual(expectedBuffer, expectedBuffer);
1219
1553
  return false;
1220
1554
  }
1221
- lc.debug?.("Admin password accepted");
1222
- return true;
1555
+ return timingSafeEqual(passwordBuffer, expectedBuffer);
1223
1556
  }
1224
1557
  var hasWarned = false;
1225
1558
  function warnOnce(lc, msg) {
@@ -1229,6 +1562,6 @@ function warnOnce(lc, msg) {
1229
1562
  }
1230
1563
  }
1231
1564
  //#endregion
1232
- export { ZERO_ENV_VAR_PREFIX, appOptions, getNormalizedZeroConfig, getServerVersion, getZeroConfig, isAdminPasswordValid, shardOptions, zeroOptions };
1565
+ export { ZERO_ENV_VAR_PREFIX, appOptions, getLogConfig, getNormalizedZeroConfig, getOperatorAccess, getServerVersion, getZeroConfig, isAdminPasswordValid, shardOptions, zeroOptions };
1233
1566
 
1234
1567
  //# sourceMappingURL=zero-config.js.map