@jam-overture/loom 0.1.0 → 0.3.0

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 (414) hide show
  1. package/README.md +3 -1
  2. package/dist/application/application.d.ts +109 -0
  3. package/dist/application/application.js +97 -0
  4. package/dist/application/memory.d.ts +20 -0
  5. package/dist/application/memory.js +79 -0
  6. package/dist/application/store.d.ts +101 -0
  7. package/dist/application/store.js +25 -0
  8. package/dist/audience/audience.d.ts +36 -0
  9. package/dist/audience/audience.js +41 -0
  10. package/dist/audience/compose.d.ts +112 -0
  11. package/dist/audience/compose.js +134 -0
  12. package/dist/audience/memory.d.ts +14 -0
  13. package/dist/audience/memory.js +71 -0
  14. package/dist/audience/overlay-store.d.ts +343 -0
  15. package/dist/audience/overlay-store.js +217 -0
  16. package/dist/audience/rule.d.ts +121 -0
  17. package/dist/audience/rule.js +78 -0
  18. package/dist/cli/index.d.ts +3 -4
  19. package/dist/cli/index.js +3 -4
  20. package/dist/cli/templates.js +19 -0
  21. package/dist/data/adapter.d.ts +9 -1
  22. package/dist/data/adapter.js +2 -0
  23. package/dist/data/plan.js +0 -0
  24. package/dist/data/resolution.d.ts +23 -1
  25. package/dist/data/resolve.d.ts +31 -4
  26. package/dist/data/resolve.js +11 -3
  27. package/dist/ids.d.ts +10 -0
  28. package/dist/ids.js +11 -1
  29. package/dist/index.d.ts +1 -0
  30. package/dist/index.js +1 -0
  31. package/dist/interpretation/anthropic.d.ts +1 -1
  32. package/dist/interpretation/anthropic.js +2 -22
  33. package/dist/interpretation/client.d.ts +1 -1
  34. package/dist/interpretation/materialize.js +67 -22
  35. package/dist/interpretation/openai-compatible.d.ts +36 -0
  36. package/dist/interpretation/openai-compatible.js +79 -0
  37. package/dist/interpretation/status.d.ts +19 -0
  38. package/dist/interpretation/status.js +26 -0
  39. package/dist/live/index.d.ts +73 -0
  40. package/dist/live/index.js +73 -0
  41. package/dist/live/pages.d.ts +187 -0
  42. package/dist/live/pages.js +161 -0
  43. package/dist/live/pull.d.ts +147 -0
  44. package/dist/live/pull.js +398 -0
  45. package/dist/live/pulling.d.ts +79 -0
  46. package/dist/live/pulling.js +117 -0
  47. package/dist/live/window.d.ts +129 -0
  48. package/dist/live/window.js +132 -0
  49. package/dist/patch.d.ts +54 -0
  50. package/dist/patch.js +44 -0
  51. package/dist/project/closing.d.ts +51 -0
  52. package/dist/project/closing.js +53 -0
  53. package/dist/project/memory.d.ts +20 -0
  54. package/dist/project/memory.js +97 -0
  55. package/dist/project/project.d.ts +90 -0
  56. package/dist/project/project.js +91 -0
  57. package/dist/project/store.d.ts +135 -0
  58. package/dist/project/store.js +41 -0
  59. package/dist/registered.d.ts +64 -0
  60. package/dist/registered.js +118 -0
  61. package/dist/render/addressed.d.ts +35 -0
  62. package/dist/render/addressed.js +79 -0
  63. package/dist/render/behaviour-adjust.d.ts +11 -19
  64. package/dist/render/behaviour-adjust.js +75 -21
  65. package/dist/render/behaviour-present.d.ts +8 -0
  66. package/dist/render/behaviour-present.js +57 -6
  67. package/dist/render/behaviour.d.ts +98 -17
  68. package/dist/render/behaviour.js +91 -26
  69. package/dist/render/control-name.d.ts +68 -0
  70. package/dist/render/control-name.js +37 -0
  71. package/dist/render/diagnostics.d.ts +72 -0
  72. package/dist/render/diagnostics.js +7 -0
  73. package/dist/render/document-theme.d.ts +70 -0
  74. package/dist/render/document-theme.js +139 -0
  75. package/dist/render/editable.d.ts +15 -1
  76. package/dist/render/editable.js +13 -1
  77. package/dist/render/expected.d.ts +98 -0
  78. package/dist/render/expected.js +88 -0
  79. package/dist/render/index.d.ts +4 -0
  80. package/dist/render/index.js +4 -0
  81. package/dist/render/reads.d.ts +11 -0
  82. package/dist/render/reads.js +12 -1
  83. package/dist/render/render.d.ts +11 -0
  84. package/dist/render/render.js +294 -53
  85. package/dist/render/request.d.ts +8 -1
  86. package/dist/render/request.js +1 -0
  87. package/dist/render/slots.d.ts +52 -0
  88. package/dist/render/slots.js +24 -0
  89. package/dist/render/theme.d.ts +54 -1
  90. package/dist/render/theme.js +23 -1
  91. package/dist/render/unshown.d.ts +152 -0
  92. package/dist/render/unshown.js +80 -0
  93. package/dist/runtime/analysis.d.ts +94 -9
  94. package/dist/runtime/analysis.js +54 -9
  95. package/dist/runtime/assessment.d.ts +36 -2
  96. package/dist/runtime/assessment.js +27 -2
  97. package/dist/runtime/auto-apply-ceiling.d.ts +54 -0
  98. package/dist/runtime/auto-apply-ceiling.js +66 -0
  99. package/dist/runtime/checks.d.ts +148 -0
  100. package/dist/runtime/checks.js +112 -0
  101. package/dist/runtime/disposition.d.ts +96 -0
  102. package/dist/runtime/disposition.js +46 -0
  103. package/dist/runtime/gate.js +91 -10
  104. package/dist/runtime/index.d.ts +4 -0
  105. package/dist/runtime/index.js +4 -0
  106. package/dist/runtime/irreversibility.d.ts +64 -0
  107. package/dist/runtime/irreversibility.js +45 -0
  108. package/dist/runtime/nesting.d.ts +13 -1
  109. package/dist/runtime/nesting.js +41 -24
  110. package/dist/runtime/pipeline.d.ts +43 -0
  111. package/dist/runtime/pipeline.js +10 -2
  112. package/dist/runtime/policy-change.d.ts +93 -0
  113. package/dist/runtime/policy-change.js +305 -0
  114. package/dist/runtime/policy-log.d.ts +406 -0
  115. package/dist/runtime/policy-log.js +285 -0
  116. package/dist/runtime/policy.d.ts +8 -6
  117. package/dist/runtime/policy.js +5 -2
  118. package/dist/runtime/repointing.js +0 -0
  119. package/dist/runtime/reversibility.d.ts +11 -9
  120. package/dist/runtime/stakes.d.ts +129 -1
  121. package/dist/runtime/stakes.js +240 -26
  122. package/dist/runtime/vocabulary.d.ts +164 -7
  123. package/dist/runtime/vocabulary.js +181 -8
  124. package/dist/sdk/audit.d.ts +174 -3
  125. package/dist/sdk/audit.js +176 -17
  126. package/dist/sdk/catalogue.d.ts +9 -1
  127. package/dist/sdk/conformance.d.ts +37 -3
  128. package/dist/sdk/conformance.js +25 -4
  129. package/dist/sdk/definition.d.ts +129 -5
  130. package/dist/sdk/definition.js +66 -0
  131. package/dist/sdk/registry.d.ts +45 -2
  132. package/dist/sdk/registry.js +102 -1
  133. package/dist/signals/acted.contract.d.ts +21 -0
  134. package/dist/signals/acted.contract.js +236 -0
  135. package/dist/signals/acted.d.ts +359 -0
  136. package/dist/signals/acted.js +135 -0
  137. package/dist/signals/action-change.d.ts +507 -0
  138. package/dist/signals/action-change.js +265 -0
  139. package/dist/signals/action.d.ts +331 -0
  140. package/dist/signals/action.js +182 -0
  141. package/dist/signals/agenda.d.ts +585 -0
  142. package/dist/signals/agenda.js +295 -0
  143. package/dist/signals/applied-window.contract.d.ts +23 -0
  144. package/dist/signals/applied-window.contract.js +160 -0
  145. package/dist/signals/arrivals.contract.d.ts +21 -0
  146. package/dist/signals/arrivals.contract.js +180 -0
  147. package/dist/signals/arrivals.d.ts +375 -0
  148. package/dist/signals/arrivals.js +254 -0
  149. package/dist/signals/arriving.d.ts +210 -0
  150. package/dist/signals/arriving.js +133 -0
  151. package/dist/signals/audiences.d.ts +528 -0
  152. package/dist/signals/audiences.js +255 -0
  153. package/dist/signals/broadcast.d.ts +33 -17
  154. package/dist/signals/broadcast.js +255 -32
  155. package/dist/signals/change.d.ts +378 -0
  156. package/dist/signals/change.js +327 -0
  157. package/dist/signals/collect.d.ts +169 -34
  158. package/dist/signals/collect.js +186 -38
  159. package/dist/signals/conversion.d.ts +348 -0
  160. package/dist/signals/conversion.js +235 -0
  161. package/dist/signals/copy-change.d.ts +553 -0
  162. package/dist/signals/copy-change.js +377 -0
  163. package/dist/signals/copy.d.ts +337 -0
  164. package/dist/signals/copy.js +211 -0
  165. package/dist/signals/correlated.contract.d.ts +24 -0
  166. package/dist/signals/correlated.contract.js +94 -0
  167. package/dist/signals/counters.d.ts +97 -0
  168. package/dist/signals/counters.js +160 -0
  169. package/dist/signals/deliver.d.ts +23 -4
  170. package/dist/signals/deliver.js +34 -6
  171. package/dist/signals/deployment-change.d.ts +395 -0
  172. package/dist/signals/deployment-change.js +309 -0
  173. package/dist/signals/deployment.d.ts +278 -0
  174. package/dist/signals/deployment.js +178 -0
  175. package/dist/signals/door.d.ts +114 -0
  176. package/dist/signals/door.js +77 -0
  177. package/dist/signals/expire.d.ts +192 -0
  178. package/dist/signals/expire.js +213 -0
  179. package/dist/signals/fold.d.ts +10 -0
  180. package/dist/signals/fold.js +5 -1
  181. package/dist/signals/form-action.d.ts +302 -0
  182. package/dist/signals/form-action.js +169 -0
  183. package/dist/signals/form-copy.d.ts +523 -0
  184. package/dist/signals/form-copy.js +346 -0
  185. package/dist/signals/forms.d.ts +247 -0
  186. package/dist/signals/forms.js +147 -0
  187. package/dist/signals/frontier.d.ts +268 -0
  188. package/dist/signals/frontier.js +145 -0
  189. package/dist/signals/funnel-change.d.ts +548 -0
  190. package/dist/signals/funnel-change.js +361 -0
  191. package/dist/signals/funnel-hours.contract.d.ts +21 -0
  192. package/dist/signals/funnel-hours.contract.js +221 -0
  193. package/dist/signals/funnel-hours.d.ts +293 -0
  194. package/dist/signals/funnel-hours.js +99 -0
  195. package/dist/signals/funnel.d.ts +592 -0
  196. package/dist/signals/funnel.js +231 -0
  197. package/dist/signals/health.d.ts +694 -0
  198. package/dist/signals/health.js +573 -0
  199. package/dist/signals/index.d.ts +60 -0
  200. package/dist/signals/index.js +60 -0
  201. package/dist/signals/ingest.d.ts +56 -1
  202. package/dist/signals/ingest.js +91 -1
  203. package/dist/signals/inside.d.ts +190 -0
  204. package/dist/signals/inside.js +263 -0
  205. package/dist/signals/join.d.ts +56 -0
  206. package/dist/signals/join.js +60 -0
  207. package/dist/signals/journal.d.ts +123 -9
  208. package/dist/signals/kept.contract.d.ts +22 -0
  209. package/dist/signals/kept.contract.js +111 -0
  210. package/dist/signals/kinds.d.ts +8 -6
  211. package/dist/signals/kinds.js +14 -6
  212. package/dist/signals/library-action.d.ts +430 -0
  213. package/dist/signals/library-action.js +336 -0
  214. package/dist/signals/library-agenda-change.d.ts +324 -0
  215. package/dist/signals/library-agenda-change.js +199 -0
  216. package/dist/signals/library-agenda.d.ts +258 -0
  217. package/dist/signals/library-agenda.js +167 -0
  218. package/dist/signals/library-change.d.ts +477 -0
  219. package/dist/signals/library-change.js +335 -0
  220. package/dist/signals/library-copy-change.d.ts +498 -0
  221. package/dist/signals/library-copy-change.js +476 -0
  222. package/dist/signals/library-pace.d.ts +319 -0
  223. package/dist/signals/library-pace.js +305 -0
  224. package/dist/signals/library-reach-change.d.ts +646 -0
  225. package/dist/signals/library-reach-change.js +542 -0
  226. package/dist/signals/library-reach.d.ts +377 -0
  227. package/dist/signals/library-reach.js +227 -0
  228. package/dist/signals/library-senders-change.d.ts +457 -0
  229. package/dist/signals/library-senders-change.js +367 -0
  230. package/dist/signals/library-senders-reach-change.d.ts +486 -0
  231. package/dist/signals/library-senders-reach-change.js +538 -0
  232. package/dist/signals/library-senders-reach.d.ts +340 -0
  233. package/dist/signals/library-senders-reach.js +252 -0
  234. package/dist/signals/library-senders.d.ts +271 -0
  235. package/dist/signals/library-senders.js +180 -0
  236. package/dist/signals/library-word-reach-change.d.ts +567 -0
  237. package/dist/signals/library-word-reach-change.js +564 -0
  238. package/dist/signals/library.d.ts +306 -0
  239. package/dist/signals/library.js +178 -0
  240. package/dist/signals/memory.d.ts +9 -0
  241. package/dist/signals/memory.js +246 -14
  242. package/dist/signals/migrate.d.ts +20 -4
  243. package/dist/signals/migrate.js +269 -8
  244. package/dist/signals/notice.d.ts +389 -0
  245. package/dist/signals/notice.js +250 -0
  246. package/dist/signals/pace-change.d.ts +501 -0
  247. package/dist/signals/pace-change.js +310 -0
  248. package/dist/signals/pace.d.ts +296 -0
  249. package/dist/signals/pace.js +291 -0
  250. package/dist/signals/page-views.d.ts +365 -0
  251. package/dist/signals/page-views.js +218 -0
  252. package/dist/signals/part-pace.d.ts +378 -0
  253. package/dist/signals/part-pace.js +333 -0
  254. package/dist/signals/parts.d.ts +354 -0
  255. package/dist/signals/parts.js +232 -0
  256. package/dist/signals/postgres.d.ts +16 -2
  257. package/dist/signals/postgres.js +753 -76
  258. package/dist/signals/progress.d.ts +212 -0
  259. package/dist/signals/progress.js +150 -0
  260. package/dist/signals/ratios.d.ts +108 -0
  261. package/dist/signals/ratios.js +40 -0
  262. package/dist/signals/reach.d.ts +309 -0
  263. package/dist/signals/reach.js +93 -0
  264. package/dist/signals/readable.d.ts +34 -0
  265. package/dist/signals/readable.js +34 -0
  266. package/dist/signals/readership.d.ts +381 -0
  267. package/dist/signals/readership.js +308 -0
  268. package/dist/signals/region-pages.d.ts +173 -0
  269. package/dist/signals/region-pages.js +62 -0
  270. package/dist/signals/region.d.ts +287 -0
  271. package/dist/signals/region.js +198 -0
  272. package/dist/signals/retention.d.ts +163 -0
  273. package/dist/signals/retention.js +75 -0
  274. package/dist/signals/rhythm.d.ts +302 -0
  275. package/dist/signals/rhythm.js +262 -0
  276. package/dist/signals/rollup.d.ts +194 -4
  277. package/dist/signals/rollup.js +0 -0
  278. package/dist/signals/schema.d.ts +1069 -1
  279. package/dist/signals/schema.js +393 -3
  280. package/dist/signals/signal.d.ts +237 -11
  281. package/dist/signals/signal.js +70 -10
  282. package/dist/signals/silence-census.d.ts +205 -0
  283. package/dist/signals/silence-census.js +87 -0
  284. package/dist/signals/silences.d.ts +1147 -0
  285. package/dist/signals/silences.js +996 -0
  286. package/dist/signals/subtrees.d.ts +123 -0
  287. package/dist/signals/subtrees.js +102 -0
  288. package/dist/signals/tally.d.ts +262 -12
  289. package/dist/signals/unread.d.ts +292 -0
  290. package/dist/signals/unread.js +137 -0
  291. package/dist/signals/window-agenda.d.ts +276 -0
  292. package/dist/signals/window-agenda.js +83 -0
  293. package/dist/signals/window-figures.d.ts +148 -0
  294. package/dist/signals/window-figures.js +42 -0
  295. package/dist/signals/window-funnels.d.ts +88 -0
  296. package/dist/signals/window-funnels.js +47 -0
  297. package/dist/signals/window.d.ts +866 -0
  298. package/dist/signals/window.js +693 -0
  299. package/dist/signals/words.d.ts +24 -0
  300. package/dist/signals/words.js +24 -0
  301. package/dist/store/cache.d.ts +101 -0
  302. package/dist/store/cache.js +149 -0
  303. package/dist/store/history.d.ts +82 -0
  304. package/dist/store/history.js +36 -0
  305. package/dist/store/index.d.ts +30 -0
  306. package/dist/store/index.js +30 -0
  307. package/dist/store/memory.d.ts +2 -1
  308. package/dist/store/memory.js +48 -12
  309. package/dist/store/migrate.d.ts +106 -0
  310. package/dist/store/migrate.js +323 -7
  311. package/dist/store/postgres-applications.d.ts +4 -0
  312. package/dist/store/postgres-applications.js +197 -0
  313. package/dist/store/postgres-audience.d.ts +14 -0
  314. package/dist/store/postgres-audience.js +272 -0
  315. package/dist/store/postgres-holds.d.ts +10 -1
  316. package/dist/store/postgres-holds.js +116 -101
  317. package/dist/store/postgres-policy-log.d.ts +14 -0
  318. package/dist/store/postgres-policy-log.js +240 -0
  319. package/dist/store/postgres-projects.d.ts +4 -0
  320. package/dist/store/postgres-projects.js +217 -0
  321. package/dist/store/postgres.d.ts +17 -1
  322. package/dist/store/postgres.js +60 -9
  323. package/dist/store/replay.d.ts +102 -1
  324. package/dist/store/replay.js +190 -19
  325. package/dist/store/reseed.d.ts +238 -0
  326. package/dist/store/reseed.js +308 -0
  327. package/dist/store/schema.d.ts +762 -2
  328. package/dist/store/schema.js +218 -5
  329. package/dist/store/source.d.ts +57 -1
  330. package/dist/store/source.js +65 -1
  331. package/dist/store/store.d.ts +29 -6
  332. package/dist/submit/resolve.d.ts +1 -1
  333. package/dist/submit/resolve.js +2 -1
  334. package/dist/telemetry/calibration.d.ts +25 -0
  335. package/dist/telemetry/calibration.js +27 -1
  336. package/dist/telemetry/event.d.ts +391 -33
  337. package/dist/telemetry/event.js +84 -20
  338. package/dist/telemetry/index.d.ts +2 -0
  339. package/dist/telemetry/index.js +2 -0
  340. package/dist/telemetry/journal.d.ts +104 -3
  341. package/dist/telemetry/journal.js +9 -0
  342. package/dist/telemetry/lookup.d.ts +27 -0
  343. package/dist/telemetry/lookup.js +18 -0
  344. package/dist/telemetry/memory.js +33 -1
  345. package/dist/telemetry/migrate.js +22 -1
  346. package/dist/telemetry/postgres.d.ts +10 -1
  347. package/dist/telemetry/postgres.js +188 -90
  348. package/dist/telemetry/remeasure.d.ts +78 -0
  349. package/dist/telemetry/remeasure.js +83 -0
  350. package/dist/telemetry/retention.d.ts +2 -2
  351. package/dist/telemetry/schema.d.ts +17 -0
  352. package/dist/telemetry/schema.js +27 -1
  353. package/dist/telemetry/sink.d.ts +2 -2
  354. package/dist/telemetry/window.d.ts +135 -0
  355. package/dist/telemetry/window.js +101 -0
  356. package/dist/testing/application-contract.d.ts +14 -0
  357. package/dist/testing/application-contract.js +270 -0
  358. package/dist/testing/audience-overlay-contract.d.ts +31 -0
  359. package/dist/testing/audience-overlay-contract.js +354 -0
  360. package/dist/testing/contracts.d.ts +13 -7
  361. package/dist/testing/contracts.js +13 -7
  362. package/dist/testing/definitions.d.ts +78 -0
  363. package/dist/testing/definitions.js +134 -9
  364. package/dist/testing/doubles.d.ts +103 -0
  365. package/dist/testing/doubles.js +143 -0
  366. package/dist/testing/index.d.ts +2 -2
  367. package/dist/testing/index.js +2 -2
  368. package/dist/testing/journal-contract.js +297 -6
  369. package/dist/testing/model-contract.d.ts +110 -0
  370. package/dist/testing/model-contract.js +150 -0
  371. package/dist/testing/policy-log-contract.d.ts +26 -0
  372. package/dist/testing/policy-log-contract.js +344 -0
  373. package/dist/testing/project-contract.d.ts +14 -0
  374. package/dist/testing/project-contract.js +266 -0
  375. package/dist/testing/reader-signal-contract.d.ts +27 -2
  376. package/dist/testing/reader-signal-contract.js +475 -5
  377. package/dist/testing/store-contract.d.ts +7 -1
  378. package/dist/testing/store-contract.js +84 -3
  379. package/dist/theme/apply.d.ts +20 -1
  380. package/dist/theme/apply.js +5 -3
  381. package/dist/theme/contrast.d.ts +19 -14
  382. package/dist/theme/contrast.js +181 -17
  383. package/dist/theme/derive.d.ts +22 -0
  384. package/dist/theme/derive.js +54 -1
  385. package/dist/theme/library.js +1 -1
  386. package/dist/theme/measure.d.ts +34 -0
  387. package/dist/theme/measure.js +30 -1
  388. package/dist/theme/palettes.js +7 -7
  389. package/dist/theme/ramp.d.ts +64 -0
  390. package/dist/theme/ramp.js +114 -0
  391. package/dist/theme/registry.d.ts +9 -0
  392. package/dist/theme/registry.js +11 -1
  393. package/dist/theme/separation.d.ts +97 -3
  394. package/dist/theme/separation.js +75 -0
  395. package/dist/tree/apply.js +13 -0
  396. package/dist/tree/compare.d.ts +9 -0
  397. package/dist/tree/compare.js +18 -0
  398. package/dist/tree/mutation.d.ts +18 -0
  399. package/dist/tree/mutation.js +24 -12
  400. package/dist/tree/navigation.d.ts +5 -0
  401. package/dist/tree/navigation.js +32 -10
  402. package/dist/tree/outline.d.ts +7 -0
  403. package/dist/tree/outline.js +9 -5
  404. package/dist/write/computed.d.ts +60 -0
  405. package/dist/write/computed.js +61 -0
  406. package/dist/write/held.d.ts +59 -0
  407. package/dist/write/index.d.ts +5 -2
  408. package/dist/write/index.js +5 -2
  409. package/dist/write/reseed.d.ts +151 -0
  410. package/dist/write/reseed.js +184 -0
  411. package/dist/write/revert.js +2 -16
  412. package/package.json +25 -3
  413. package/dist/runtime/inverse-interpreter.d.ts +0 -90
  414. package/dist/runtime/inverse-interpreter.js +0 -56
@@ -1,4 +1,5 @@
1
- import { asc, eq, sql } from "drizzle-orm";
1
+ import { and, asc, eq, sql } from "drizzle-orm";
2
+ import { DEFAULT_APPLICATION_ID } from "../application/application.js";
2
3
  import { err, ok } from "../result.js";
3
4
  import { clampHoldLimit, describeHoldError, holdCursor, holdCursorPosition, holdPosition, parseHeldProposal, } from "../write/held.js";
4
5
  import { isUniqueViolation, unavailable } from "./driver.js";
@@ -87,106 +88,120 @@ const pageEnd = (rows) => {
87
88
  const last = rows.at(-1);
88
89
  return last === undefined ? undefined : holdPosition(last);
89
90
  };
90
- export const postgresHoldStore = (db) => ({
91
- hold: async (held) => {
92
- try {
93
- await db.insert(loomHolds).values({
94
- proposalId: held.proposalId,
95
- treeId: held.treeId,
96
- baseRevision: held.baseRevision,
97
- intent: held.intent,
98
- proposal: held.proposal,
99
- disposition: held.disposition,
100
- heldAt: held.heldAt,
101
- });
102
- return ok(held);
103
- }
104
- catch (cause) {
105
- /**
106
- * The primary key on `proposal_id` is what makes "already held" a fact the
107
- * database establishes rather than a check this code races against. Two
108
- * requests holding the same proposal cannot both win, and the loser arrives
109
- * here rather than overwriting a hold somebody may already be reading.
110
- */
111
- return isUniqueViolation(cause)
112
- ? err({ code: "already-held", proposalId: held.proposalId })
113
- : err(unavailable(cause, `could not hold ${held.proposalId}`));
114
- }
115
- },
116
- get: async (proposalId) => {
117
- try {
118
- const rows = await db.select().from(loomHolds).where(eq(loomHolds.proposalId, proposalId)).limit(1);
119
- const row = rows[0];
120
- return row === undefined ? err({ code: "not-held", proposalId }) : toHeld(row);
121
- }
122
- catch (cause) {
123
- return err(unavailable(cause, `could not read the hold on ${proposalId}`));
124
- }
125
- },
126
- forTree: async (treeId) => {
127
- try {
128
- const rows = await db
129
- .select()
130
- .from(loomHolds)
131
- .where(eq(loomHolds.treeId, treeId))
132
- .orderBy(...HOLD_ORDER);
133
- return parseAll(rows);
134
- }
135
- catch (cause) {
136
- return err(unavailable(cause, `could not list what is held against ${treeId}`));
137
- }
138
- },
139
- waiting: async (request) => {
140
- const limit = clampHoldLimit(request?.limit);
141
- const from = holdCursorPosition(request?.cursor);
142
- try {
143
- const rows = await db
144
- .select()
145
- .from(loomHolds)
91
+ /**
92
+ * Every query is filtered by the project this handle speaks for (0260), and
93
+ * every write sets it.
94
+ *
95
+ * This is the table the failure was named for: *a hold listing that spanned
96
+ * two apps would put one app's changes in another's queue*, which is the one
97
+ * thing a review queue cannot do. `waiting` is that listing.
98
+ */
99
+ export const postgresHoldStore = (db, scope = {}) => {
100
+ const project = scope.application ?? DEFAULT_APPLICATION_ID;
101
+ /** Every read starts here, so a query cannot forget the project by omission. */
102
+ const mine = (...rest) => and(eq(loomHolds.applicationId, project), ...rest);
103
+ return {
104
+ hold: async (held) => {
105
+ try {
106
+ await db.insert(loomHolds).values({
107
+ applicationId: project,
108
+ proposalId: held.proposalId,
109
+ treeId: held.treeId,
110
+ baseRevision: held.baseRevision,
111
+ intent: held.intent,
112
+ proposal: held.proposal,
113
+ disposition: held.disposition,
114
+ heldAt: held.heldAt,
115
+ });
116
+ return ok(held);
117
+ }
118
+ catch (cause) {
146
119
  /**
147
- * A row-value comparison, which is `compareHolds` said in SQL: Postgres
148
- * compares the tuple left to right, so this is "later than that instant,
149
- * or the same instant under a later id" without writing that out as
150
- * three predicates one of which will eventually be wrong.
120
+ * The primary key on `proposal_id` is what makes "already held" a fact the
121
+ * database establishes rather than a check this code races against. Two
122
+ * requests holding the same proposal cannot both win, and the loser arrives
123
+ * here rather than overwriting a hold somebody may already be reading.
151
124
  */
152
- .where(from === undefined
153
- ? undefined
154
- : sql `(${loomHolds.heldAt}, ${loomHolds.proposalId}) > (${from.heldAt}, ${from.proposalId})`)
155
- .orderBy(...HOLD_ORDER)
156
- /** One extra row answers "is there another page" without a count. */
157
- .limit(limit + 1);
158
- const inPage = rows.slice(0, limit);
159
- const parsed = parseAll(inPage);
160
- if (!parsed.ok)
161
- return parsed;
162
- const last = pageEnd(inPage);
163
- return ok({
164
- ...parsed.value,
165
- cursor: rows.length > limit && last !== undefined ? holdCursor(last) : null,
166
- });
167
- }
168
- catch (cause) {
169
- return err(unavailable(cause, "could not list what is held"));
170
- }
171
- },
172
- /**
173
- * One statement, because `release` is a take rather than a read.
174
- *
175
- * `DELETE … RETURNING` is what makes answering happen exactly once a property
176
- * of the database instead of a rule this code has to be trusted to follow: a
177
- * select-then-delete would let two reviewers confirming at the same moment both
178
- * come away holding the same change, and both apply it. The in-memory store
179
- * gets that from being single-threaded; here it has to come from the statement.
180
- */
181
- release: async (proposalId) => {
182
- try {
183
- const rows = await db.delete(loomHolds).where(eq(loomHolds.proposalId, proposalId)).returning();
184
- const row = rows[0];
185
- return row === undefined ? err({ code: "not-held", proposalId }) : toHeld(row);
186
- }
187
- catch (cause) {
188
- return err(unavailable(cause, `could not release ${proposalId}`));
189
- }
190
- },
191
- });
125
+ return isUniqueViolation(cause)
126
+ ? err({ code: "already-held", proposalId: held.proposalId })
127
+ : err(unavailable(cause, `could not hold ${held.proposalId}`));
128
+ }
129
+ },
130
+ get: async (proposalId) => {
131
+ try {
132
+ const rows = await db.select().from(loomHolds).where(mine(eq(loomHolds.proposalId, proposalId))).limit(1);
133
+ const row = rows[0];
134
+ return row === undefined ? err({ code: "not-held", proposalId }) : toHeld(row);
135
+ }
136
+ catch (cause) {
137
+ return err(unavailable(cause, `could not read the hold on ${proposalId}`));
138
+ }
139
+ },
140
+ forTree: async (treeId) => {
141
+ try {
142
+ const rows = await db
143
+ .select()
144
+ .from(loomHolds)
145
+ .where(mine(eq(loomHolds.treeId, treeId)))
146
+ .orderBy(...HOLD_ORDER);
147
+ return parseAll(rows);
148
+ }
149
+ catch (cause) {
150
+ return err(unavailable(cause, `could not list what is held against ${treeId}`));
151
+ }
152
+ },
153
+ waiting: async (request) => {
154
+ const limit = clampHoldLimit(request?.limit);
155
+ const from = holdCursorPosition(request?.cursor);
156
+ try {
157
+ const rows = await db
158
+ .select()
159
+ .from(loomHolds)
160
+ /**
161
+ * A row-value comparison, which is `compareHolds` said in SQL: Postgres
162
+ * compares the tuple left to right, so this is "later than that instant,
163
+ * or the same instant under a later id" without writing that out as
164
+ * three predicates one of which will eventually be wrong.
165
+ */
166
+ .where(mine(from === undefined
167
+ ? undefined
168
+ : sql `(${loomHolds.heldAt}, ${loomHolds.proposalId}) > (${from.heldAt}, ${from.proposalId})`))
169
+ .orderBy(...HOLD_ORDER)
170
+ /** One extra row answers "is there another page" without a count. */
171
+ .limit(limit + 1);
172
+ const inPage = rows.slice(0, limit);
173
+ const parsed = parseAll(inPage);
174
+ if (!parsed.ok)
175
+ return parsed;
176
+ const last = pageEnd(inPage);
177
+ return ok({
178
+ ...parsed.value,
179
+ cursor: rows.length > limit && last !== undefined ? holdCursor(last) : null,
180
+ });
181
+ }
182
+ catch (cause) {
183
+ return err(unavailable(cause, "could not list what is held"));
184
+ }
185
+ },
186
+ /**
187
+ * One statement, because `release` is a take rather than a read.
188
+ *
189
+ * `DELETE … RETURNING` is what makes answering happen exactly once a property
190
+ * of the database instead of a rule this code has to be trusted to follow: a
191
+ * select-then-delete would let two reviewers confirming at the same moment both
192
+ * come away holding the same change, and both apply it. The in-memory store
193
+ * gets that from being single-threaded; here it has to come from the statement.
194
+ */
195
+ release: async (proposalId) => {
196
+ try {
197
+ const rows = await db.delete(loomHolds).where(mine(eq(loomHolds.proposalId, proposalId))).returning();
198
+ const row = rows[0];
199
+ return row === undefined ? err({ code: "not-held", proposalId }) : toHeld(row);
200
+ }
201
+ catch (cause) {
202
+ return err(unavailable(cause, `could not release ${proposalId}`));
203
+ }
204
+ },
205
+ };
206
+ };
192
207
  //# sourceMappingURL=postgres-holds.js.map
@@ -0,0 +1,14 @@
1
+ import { type StoreScope } from "../application/application.js";
2
+ import { type PolicyLog } from "../runtime/policy-log.js";
3
+ import type { LoomDatabase } from "./database.js";
4
+ /**
5
+ * Every query is filtered by the project this handle speaks for (0260), and
6
+ * every write sets it.
7
+ *
8
+ * Without it `judgedUnder` would resolve a fingerprint against every policy
9
+ * revision the deployment holds, and answer with another project's policy text
10
+ * whenever two happened to fingerprint alike — which is a change reported as
11
+ * judged under rules it was never judged under.
12
+ */
13
+ export declare const postgresPolicyLog: (db: LoomDatabase, scope?: StoreScope) => PolicyLog;
14
+ //# sourceMappingURL=postgres-policy-log.d.ts.map
@@ -0,0 +1,240 @@
1
+ import { and, asc, desc, eq, gt, lt } from "drizzle-orm";
2
+ import { DEFAULT_APPLICATION_ID } from "../application/application.js";
3
+ import { cursorPosition, pageEnds } from "../paging.js";
4
+ import { err, ok } from "../result.js";
5
+ import { policyShapeOf } from "../runtime/policy-fingerprint.js";
6
+ import { clampPolicyRevisionLimit, MAX_POLICY_REVISION_LIMIT, parsePolicyRevision, policyProvenanceOf, recordOutcomeOf, } from "../runtime/policy-log.js";
7
+ import { isUniqueViolation, unavailable } from "./driver.js";
8
+ import { loomPolicyRevisions } from "./schema.js";
9
+ /**
10
+ * The policy's own log, backed by Postgres (0022).
11
+ *
12
+ * The counterpart `memoryPolicyLog` was always going to need, and for a sharper
13
+ * reason than the hold store's: a policy log that lived in a process would be
14
+ * reset by every deployment, which is precisely when a policy is most likely to
15
+ * have changed. A `Map` cannot record the one event this log exists to record.
16
+ *
17
+ * **There is no transaction here, and that is the point of the composite primary
18
+ * key.** The write reads the head, computes the next revision and inserts it; two
19
+ * writers racing at the same head both compute `N + 1` and the database refuses
20
+ * the second. `loom_revisions` gets its ordering guarantee the same way, and
21
+ * `store.ts` says so. A `SELECT … FOR UPDATE` could not have served here anyway:
22
+ * the first revision of a policy has no row to lock.
23
+ *
24
+ * A refused insert is reported as `out-of-date` against the head as it is *now*,
25
+ * which is the truth the caller needs rather than the one it raced against.
26
+ */
27
+ /**
28
+ * A row on the way out, checked rather than cast.
29
+ *
30
+ * `policy` was written by whatever version of the code was running then, and a
31
+ * policy revision is among the longest-lived documents in the system: a log kept
32
+ * across a year of deployments is exactly what makes a calibration window
33
+ * legible, which is the whole reason to keep one.
34
+ */
35
+ const toRevision = (row) => parsePolicyRevision({
36
+ policyId: row.policyId,
37
+ revision: row.revision,
38
+ fingerprint: row.fingerprint,
39
+ policy: row.policy,
40
+ actor: row.actor,
41
+ recordedAt: row.recordedAt,
42
+ ...(row.note === null ? {} : { note: row.note }),
43
+ });
44
+ /**
45
+ * `null` and an absent key are one thing on the way back in and two things in
46
+ * the type, which is what `toRevision` spreads around: a `text` column with no
47
+ * value reads as `null`, and `exactOptionalPropertyTypes` distinguishes that
48
+ * from a key the shape does not have.
49
+ */
50
+ const newest = async (db, project, policyId) => {
51
+ try {
52
+ const rows = await db
53
+ .select()
54
+ .from(loomPolicyRevisions)
55
+ .where(and(eq(loomPolicyRevisions.applicationId, project), eq(loomPolicyRevisions.policyId, policyId)))
56
+ .orderBy(desc(loomPolicyRevisions.revision))
57
+ .limit(1);
58
+ const row = rows[0];
59
+ return row === undefined ? ok(undefined) : toRevision(row);
60
+ }
61
+ catch (cause) {
62
+ return err(unavailable(cause, `could not read the policy ${policyId}`));
63
+ }
64
+ };
65
+ /**
66
+ * Every query is filtered by the project this handle speaks for (0260), and
67
+ * every write sets it.
68
+ *
69
+ * Without it `judgedUnder` would resolve a fingerprint against every policy
70
+ * revision the deployment holds, and answer with another project's policy text
71
+ * whenever two happened to fingerprint alike — which is a change reported as
72
+ * judged under rules it was never judged under.
73
+ */
74
+ export const postgresPolicyLog = (db, scope = {}) => {
75
+ const project = scope.application ?? DEFAULT_APPLICATION_ID;
76
+ const mine = (...rest) => and(eq(loomPolicyRevisions.applicationId, project), ...rest);
77
+ return {
78
+ record: async (request) => {
79
+ const policyId = request.policy.policyId;
80
+ /**
81
+ * Outside the `try`, because `newest` is total: the only statement here that
82
+ * can collide is the insert, and a narrow `try` is what lets the `catch`
83
+ * below say *a unique violation on this insert means somebody else recorded*
84
+ * rather than guessing which of two statements threw.
85
+ */
86
+ const head = await newest(db, project, policyId);
87
+ if (!head.ok)
88
+ return head;
89
+ const racedAgainst = head.value?.revision ?? 0;
90
+ const outcome = recordOutcomeOf(request, head.value);
91
+ if (!outcome.ok || outcome.value.outcome === "unchanged")
92
+ return outcome;
93
+ const revision = outcome.value.revision;
94
+ try {
95
+ await db.insert(loomPolicyRevisions).values({
96
+ applicationId: project,
97
+ policyId: revision.policyId,
98
+ revision: revision.revision,
99
+ fingerprint: revision.fingerprint,
100
+ policy: revision.policy,
101
+ actor: revision.actor,
102
+ recordedAt: revision.recordedAt,
103
+ note: revision.note ?? null,
104
+ });
105
+ return ok(outcome.value);
106
+ }
107
+ catch (cause) {
108
+ /**
109
+ * Somebody else recorded between the read and the insert, so this is the
110
+ * staleness `recordOutcomeOf` could not see: the head was right when it was
111
+ * read and wrong by the time the row was written.
112
+ *
113
+ * `expected` is the head this call actually proceeded from rather than
114
+ * whatever the caller named — a caller that passed no `expectedRevision`
115
+ * still raced against a revision, and reporting `0` for it would say the
116
+ * caller believed the log was empty. `current` is re-read, because
117
+ * re-reading is what the caller has to do next and the number it lost to is
118
+ * of no use to it.
119
+ */
120
+ if (isUniqueViolation(cause)) {
121
+ const current = await newest(db, project, policyId);
122
+ return err({
123
+ code: "out-of-date",
124
+ policyId,
125
+ expected: racedAgainst,
126
+ current: current.ok && current.value !== undefined ? current.value.revision : racedAgainst,
127
+ });
128
+ }
129
+ return err(unavailable(cause, `could not record a revision of ${policyId}`));
130
+ }
131
+ },
132
+ current: async (policyId) => {
133
+ const head = await newest(db, project, policyId);
134
+ if (!head.ok)
135
+ return head;
136
+ return head.value === undefined
137
+ ? err({ code: "no-such-policy", policyId })
138
+ : ok(head.value);
139
+ },
140
+ revisions: async (policyId, request) => {
141
+ const direction = request?.direction ?? "newer";
142
+ const limit = clampPolicyRevisionLimit(request?.limit);
143
+ const from = cursorPosition(request?.cursor);
144
+ /**
145
+ * "No policy" and "a policy at some revision" are different answers, and
146
+ * the head read is what separates them — a page that came back empty because
147
+ * the cursor was at the end is not a name nobody has recorded.
148
+ */
149
+ const head = await newest(db, project, policyId);
150
+ if (!head.ok)
151
+ return head;
152
+ if (head.value === undefined)
153
+ return err({ code: "no-such-policy", policyId });
154
+ try {
155
+ /**
156
+ * `older` scans descending so the newest page costs one seek on the
157
+ * primary key rather than a walk from the start, then the rows are put
158
+ * back in ascending order — the contract's promise that a page's order
159
+ * never depends on which end it came from.
160
+ */
161
+ const rows = await db
162
+ .select()
163
+ .from(loomPolicyRevisions)
164
+ .where(mine(eq(loomPolicyRevisions.policyId, policyId), from === undefined
165
+ ? undefined
166
+ : direction === "older"
167
+ ? lt(loomPolicyRevisions.revision, from)
168
+ : gt(loomPolicyRevisions.revision, from)))
169
+ .orderBy(direction === "older"
170
+ ? desc(loomPolicyRevisions.revision)
171
+ : asc(loomPolicyRevisions.revision))
172
+ /** One extra row answers "is there another page" without a count. */
173
+ .limit(limit + 1);
174
+ const taken = direction === "older" ? rows.slice(0, limit).reverse() : rows.slice(0, limit);
175
+ const revisions = [];
176
+ for (const row of taken) {
177
+ const parsed = toRevision(row);
178
+ if (!parsed.ok)
179
+ return parsed;
180
+ revisions.push(parsed.value);
181
+ }
182
+ return ok({
183
+ revisions,
184
+ ...pageEnds(revisions.map((entry) => entry.revision), direction, { beyond: rows.length > limit, resumed: from !== undefined }),
185
+ });
186
+ }
187
+ catch (cause) {
188
+ return err(unavailable(cause, `could not read the history of ${policyId}`));
189
+ }
190
+ },
191
+ /**
192
+ * The seek the fingerprint column exists for. Two statements rather than one:
193
+ * the matches come off the index, and the shapes are only read when nothing
194
+ * matched — so the ordinary answer costs one indexed read and the explanation
195
+ * of a miss costs a second that a hit never pays for.
196
+ */
197
+ judgedUnder: async (policyId, fingerprint) => {
198
+ try {
199
+ const matched = await db
200
+ .select()
201
+ .from(loomPolicyRevisions)
202
+ .where(mine(eq(loomPolicyRevisions.policyId, policyId), eq(loomPolicyRevisions.fingerprint, fingerprint)))
203
+ .orderBy(asc(loomPolicyRevisions.revision))
204
+ /**
205
+ * Bounded like every read in Loom, and the bound cannot change the
206
+ * answer: one match is `recorded`, and two or more is `ambiguous`
207
+ * whether or not the list is complete, because the verdict is *nothing
208
+ * can say which* either way. Oldest first, so a truncated list is the
209
+ * beginning of the range rather than an arbitrary slice of it.
210
+ */
211
+ .limit(MAX_POLICY_REVISION_LIMIT);
212
+ const matches = [];
213
+ for (const row of matched) {
214
+ const parsed = toRevision(row);
215
+ if (!parsed.ok)
216
+ return parsed;
217
+ matches.push(parsed.value);
218
+ }
219
+ if (matches.length > 0)
220
+ return ok(policyProvenanceOf(policyId, fingerprint, matches, []));
221
+ const held = await db
222
+ .selectDistinct({ fingerprint: loomPolicyRevisions.fingerprint })
223
+ .from(loomPolicyRevisions)
224
+ .where(and(eq(loomPolicyRevisions.applicationId, project), eq(loomPolicyRevisions.policyId, policyId)))
225
+ /**
226
+ * Bounded for the same reason, and again without cost to the answer:
227
+ * `heldShapes` only has to separate *nothing was recorded under this
228
+ * name* from *everything recorded here came from another build*, and one
229
+ * row settles that.
230
+ */
231
+ .limit(MAX_POLICY_REVISION_LIMIT);
232
+ return ok(policyProvenanceOf(policyId, fingerprint, [], held.map((row) => policyShapeOf(row.fingerprint))));
233
+ }
234
+ catch (cause) {
235
+ return err(unavailable(cause, `could not resolve a policy fingerprint for ${policyId}`));
236
+ }
237
+ },
238
+ };
239
+ };
240
+ //# sourceMappingURL=postgres-policy-log.js.map
@@ -0,0 +1,4 @@
1
+ import { type ProjectStore } from "../project/store.js";
2
+ import type { LoomDatabase } from "./database.js";
3
+ export declare const postgresProjectStore: (db: LoomDatabase) => ProjectStore;
4
+ //# sourceMappingURL=postgres-projects.d.ts.map