@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
@@ -0,0 +1,197 @@
1
+ import { and, asc, eq, isNull } from "drizzle-orm";
2
+ import { applicationSchema } from "../application/application.js";
3
+ import { applyPatch } from "../patch.js";
4
+ import { matchesListing } from "../project/store.js";
5
+ import { err, ok } from "../result.js";
6
+ import { isUniqueViolation, unavailable } from "./driver.js";
7
+ import { loomApplications } from "./schema.js";
8
+ /**
9
+ * The projects a deployment has, backed by Postgres (0022).
10
+ *
11
+ * The one store here that is not scoped by a project, for the obvious reason:
12
+ * it holds them. Every other store takes a `StoreScope` and filters on it; this
13
+ * one is what that scope's id refers to, so a handle for it would have nothing
14
+ * to be scoped by.
15
+ *
16
+ * Like the others, the database handle is injected rather than opened here —
17
+ * choosing a driver, a pooler and a connection lifetime belongs to the host,
18
+ * and injecting it is what lets the tests run this exact code against an
19
+ * embedded Postgres rather than against a double that agrees with them.
20
+ */
21
+ /**
22
+ * A row on the way out, checked rather than cast.
23
+ *
24
+ * `host` is nullable in the column and optional in the type, which is the one
25
+ * place the two shapes genuinely differ: SQL has no way to say *absent*, so the
26
+ * null is dropped here rather than handed to a schema that would refuse it.
27
+ */
28
+ const toProject = (row) => {
29
+ const parsed = applicationSchema.safeParse({
30
+ applicationId: row.applicationId,
31
+ projectId: row.projectId,
32
+ name: row.name,
33
+ createdAt: row.createdAt,
34
+ ...(row.host === null ? {} : { host: row.host }),
35
+ /** Absent rather than `null`, so *this is open* has one spelling (0289). */
36
+ ...(row.closedAt === null ? {} : { closedAt: row.closedAt }),
37
+ });
38
+ return parsed.success
39
+ ? ok(parsed.data)
40
+ : err({
41
+ code: "unreadable",
42
+ applicationId: row.applicationId,
43
+ detail: parsed.error.issues[0]?.message ?? "invalid",
44
+ });
45
+ };
46
+ export const postgresApplicationStore = (db) => ({
47
+ create: async (application) => {
48
+ try {
49
+ await db.insert(loomApplications).values({
50
+ applicationId: application.applicationId,
51
+ projectId: application.projectId,
52
+ name: application.name,
53
+ createdAt: application.createdAt,
54
+ host: application.host ?? null,
55
+ });
56
+ return ok(application);
57
+ }
58
+ catch (cause) {
59
+ /**
60
+ * The key is what makes *already taken* a fact the database establishes
61
+ * rather than a check this code races against — the same argument the
62
+ * hold store makes about its primary key, and it matters more here: the
63
+ * loser of a race between two people registering the same project would
64
+ * otherwise silently take ownership of the winner's rows.
65
+ */
66
+ if (isUniqueViolation(cause)) {
67
+ return err({ code: "already-exists", applicationId: application.applicationId });
68
+ }
69
+ return err(unavailable(cause, `could not create project ${application.applicationId}`));
70
+ }
71
+ },
72
+ get: async (applicationId) => {
73
+ try {
74
+ const rows = await db
75
+ .select()
76
+ .from(loomApplications)
77
+ .where(eq(loomApplications.applicationId, applicationId))
78
+ .limit(1);
79
+ const row = rows[0];
80
+ return row === undefined ? err({ code: "not-found", applicationId }) : toProject(row);
81
+ }
82
+ catch (cause) {
83
+ return err(unavailable(cause, `could not read project ${applicationId}`));
84
+ }
85
+ },
86
+ list: async (listing) => {
87
+ try {
88
+ /**
89
+ * Ordered in the statement rather than after it, so the order is the
90
+ * database's job and an index can serve it. `created_at` is an ISO string,
91
+ * which sorts lexicographically into chronological order — that is the
92
+ * property the format is chosen for, and `applicationSchema` requires it.
93
+ */
94
+ const rows = await db.select().from(loomApplications).orderBy(asc(loomApplications.createdAt));
95
+ const projects = [];
96
+ for (const row of rows) {
97
+ const project = toProject(row);
98
+ if (!project.ok)
99
+ return project;
100
+ /** One rule about what `closed` means, called by both stores (0289). */
101
+ if (matchesListing(project.value.closedAt, listing))
102
+ projects.push(project.value);
103
+ }
104
+ return ok(projects);
105
+ }
106
+ catch (cause) {
107
+ return err(unavailable(cause, "could not list projects"));
108
+ }
109
+ },
110
+ /**
111
+ * Read, merge, parse, write — rather than setting the columns given.
112
+ *
113
+ * The first draft set them directly, and the shared contract caught what that
114
+ * costs: `text` accepts an empty string and `applicationSchema` does not, so a
115
+ * rename to `""` was written happily and then could not be read back at all.
116
+ * The row was corrupt, and the store that had refused the same call was the
117
+ * one in a `Map`. Parsing the merged project is what makes the two stores
118
+ * agree about what a project is, rather than about what fits in a column.
119
+ *
120
+ * The read and the write are not in one transaction, which is a real race and
121
+ * an acceptable one: two people renaming one project at the same instant get
122
+ * last-write-wins on a display name. Nothing downstream keys on it.
123
+ *
124
+ * A cleared host reaches the column as `NULL` by the same route an absent one
125
+ * always did: `applyPatch` removes the key, so the parsed application has no
126
+ * host, and the write already coalesced a missing one.
127
+ */
128
+ rename: async (applicationId, to) => {
129
+ try {
130
+ const rows = await db
131
+ .select()
132
+ .from(loomApplications)
133
+ .where(eq(loomApplications.applicationId, applicationId))
134
+ .limit(1);
135
+ const row = rows[0];
136
+ if (row === undefined)
137
+ return err({ code: "not-found", applicationId });
138
+ const current = toProject(row);
139
+ if (!current.ok)
140
+ return current;
141
+ const next = applicationSchema.safeParse(applyPatch(current.value, to));
142
+ if (!next.success) {
143
+ return err({
144
+ code: "unreadable",
145
+ applicationId,
146
+ detail: next.error.issues[0]?.message ?? "invalid",
147
+ });
148
+ }
149
+ await db
150
+ .update(loomApplications)
151
+ .set({ name: next.data.name, host: next.data.host ?? null })
152
+ .where(eq(loomApplications.applicationId, applicationId));
153
+ return ok(next.data);
154
+ }
155
+ catch (cause) {
156
+ return err(unavailable(cause, `could not rename project ${applicationId}`));
157
+ }
158
+ },
159
+ /** Idempotent in the statement — see the project store's note (0289). */
160
+ close: async (applicationId, at) => {
161
+ try {
162
+ await db
163
+ .update(loomApplications)
164
+ .set({ closedAt: at })
165
+ .where(and(eq(loomApplications.applicationId, applicationId), isNull(loomApplications.closedAt)));
166
+ const rows = await db
167
+ .select()
168
+ .from(loomApplications)
169
+ .where(eq(loomApplications.applicationId, applicationId))
170
+ .limit(1);
171
+ const row = rows[0];
172
+ return row === undefined ? err({ code: "not-found", applicationId }) : toProject(row);
173
+ }
174
+ catch (cause) {
175
+ return err(unavailable(cause, `could not close application ${applicationId}`));
176
+ }
177
+ },
178
+ reopen: async (applicationId) => {
179
+ try {
180
+ await db
181
+ .update(loomApplications)
182
+ .set({ closedAt: null })
183
+ .where(eq(loomApplications.applicationId, applicationId));
184
+ const rows = await db
185
+ .select()
186
+ .from(loomApplications)
187
+ .where(eq(loomApplications.applicationId, applicationId))
188
+ .limit(1);
189
+ const row = rows[0];
190
+ return row === undefined ? err({ code: "not-found", applicationId }) : toProject(row);
191
+ }
192
+ catch (cause) {
193
+ return err(unavailable(cause, `could not reopen application ${applicationId}`));
194
+ }
195
+ },
196
+ });
197
+ //# sourceMappingURL=postgres-applications.js.map
@@ -0,0 +1,14 @@
1
+ import { type StoreScope } from "../application/application.js";
2
+ import { type AudienceOverlayStore } from "../audience/overlay-store.js";
3
+ import type { LoomDatabase } from "./database.js";
4
+ /**
5
+ * Every query is filtered by the application this handle speaks for (0260), and
6
+ * every write sets it.
7
+ *
8
+ * Without it a page's rules would be read across applications, and two
9
+ * deployments that happened to name their trees alike would serve each other's
10
+ * forms — which is the one thing a dimension that decides *who sees what* cannot
11
+ * get wrong.
12
+ */
13
+ export declare const postgresAudienceOverlayStore: (db: LoomDatabase, scope?: StoreScope) => AudienceOverlayStore;
14
+ //# sourceMappingURL=postgres-audience.d.ts.map
@@ -0,0 +1,272 @@
1
+ import { and, desc, eq } from "drizzle-orm";
2
+ import { DEFAULT_APPLICATION_ID } from "../application/application.js";
3
+ import { audienceFormListingsOf, audienceOverlayOf, audienceRulesOutcomeOf, clampAudienceRuleHistoryLimit, parseAudienceRuleRevision, parseStoredAudienceForm, servedFormsOf, withdrawnFormOf, } from "../audience/overlay-store.js";
4
+ import { err, ok } from "../result.js";
5
+ import { isUniqueViolation, unavailable } from "./driver.js";
6
+ import { loomAudienceForms, loomAudienceRules } from "./schema.js";
7
+ /**
8
+ * The audience dimension, backed by Postgres (0022). It is the table that
9
+ * `AudienceOverlaySource` was declared as a seam in place of, and it is the
10
+ * store dimension a page served per audience has been waiting on (0263, 0359).
11
+ *
12
+ * **There is no transaction here, and that is the point of the composite primary
13
+ * key.** `recordRules` reads the head, computes the next revision and inserts
14
+ * it; two editors racing at the same head both compute `N + 1` and the database
15
+ * refuses the second. `loom_revisions` and `loom_policy_revisions` get their
16
+ * ordering guarantee the same way, and a `SELECT … FOR UPDATE` could not serve
17
+ * here anyway: the first revision of a page's rules has no row to lock.
18
+ *
19
+ * A refused insert is reported as `out-of-date` against the head as it is *now*,
20
+ * which is the truth the caller needs rather than the one it raced against.
21
+ */
22
+ /**
23
+ * Rows come back as `unknown` and are parsed, never cast — storage is a boundary
24
+ * like any other, and it is the one where the data outlives the code that wrote
25
+ * it. A rule is edited rarely and read on every request for as long as the page
26
+ * is published, so of everything in this schema it is among the likeliest to be
27
+ * read back by code that did not write it.
28
+ */
29
+ const toRevision = (row, treeId) => parseAudienceRuleRevision({
30
+ treeId: row.treeId,
31
+ revision: row.revision,
32
+ rules: row.rules,
33
+ actor: row.actor,
34
+ recordedAt: row.recordedAt,
35
+ }, treeId);
36
+ /**
37
+ * **Two columns become one field or none**, which is where the backend's
38
+ * spelling of *not withdrawn* stops: `NULL` is mapped to an absent key here, so
39
+ * what the parser and every caller downstream see is the single shape
40
+ * `StoredAudienceForm` declares. A half-set pair — `withdrawn_at` with no
41
+ * `withdrawn_by` — is no write this module makes, and reaches the parser as a
42
+ * withdrawal missing its actor, which `unreadable` is for.
43
+ */
44
+ const toForm = (row, treeId) => parseStoredAudienceForm({
45
+ treeId: row.treeId,
46
+ audienceId: row.audienceId,
47
+ delta: row.delta,
48
+ actor: row.actor,
49
+ authoredAt: row.authoredAt,
50
+ ...(row.withdrawnBy === null && row.withdrawnAt === null
51
+ ? {}
52
+ : { withdrawn: { actor: row.withdrawnBy, at: row.withdrawnAt } }),
53
+ }, treeId);
54
+ /**
55
+ * Every query is filtered by the application this handle speaks for (0260), and
56
+ * every write sets it.
57
+ *
58
+ * Without it a page's rules would be read across applications, and two
59
+ * deployments that happened to name their trees alike would serve each other's
60
+ * forms — which is the one thing a dimension that decides *who sees what* cannot
61
+ * get wrong.
62
+ */
63
+ export const postgresAudienceOverlayStore = (db, scope = {}) => {
64
+ const application = scope.application ?? DEFAULT_APPLICATION_ID;
65
+ const head = async (treeId) => {
66
+ try {
67
+ const rows = await db
68
+ .select()
69
+ .from(loomAudienceRules)
70
+ .where(mineRules(application, eq(loomAudienceRules.treeId, treeId)))
71
+ .orderBy(desc(loomAudienceRules.revision))
72
+ .limit(1);
73
+ const row = rows[0];
74
+ return row === undefined ? ok(undefined) : toRevision(row, treeId);
75
+ }
76
+ catch (cause) {
77
+ return err(unavailable(cause, `could not read ${treeId}'s audience rules`));
78
+ }
79
+ };
80
+ const storedForms = async (treeId) => {
81
+ try {
82
+ const rows = await db
83
+ .select()
84
+ .from(loomAudienceForms)
85
+ .where(mineForms(application, eq(loomAudienceForms.treeId, treeId)))
86
+ .orderBy(loomAudienceForms.audienceId);
87
+ const forms = [];
88
+ for (const row of rows) {
89
+ const form = toForm(row, treeId);
90
+ if (!form.ok)
91
+ return form;
92
+ forms.push(form.value);
93
+ }
94
+ return ok(forms);
95
+ }
96
+ catch (cause) {
97
+ return err(unavailable(cause, `could not read ${treeId}'s audience forms`));
98
+ }
99
+ };
100
+ return {
101
+ overlay: async (treeId) => {
102
+ const rules = await head(treeId);
103
+ if (!rules.ok)
104
+ return rules;
105
+ const forms = await storedForms(treeId);
106
+ if (!forms.ok)
107
+ return forms;
108
+ return ok(audienceOverlayOf(rules.value, servedFormsOf(forms.value)));
109
+ },
110
+ rules: async (treeId) => head(treeId),
111
+ history: async (treeId, request) => {
112
+ try {
113
+ const rows = await db
114
+ .select()
115
+ .from(loomAudienceRules)
116
+ .where(mineRules(application, eq(loomAudienceRules.treeId, treeId)))
117
+ .orderBy(desc(loomAudienceRules.revision))
118
+ .limit(clampAudienceRuleHistoryLimit(request?.limit));
119
+ const revisions = [];
120
+ for (const row of rows) {
121
+ const revision = toRevision(row, treeId);
122
+ if (!revision.ok)
123
+ return revision;
124
+ revisions.push(revision.value);
125
+ }
126
+ return ok(revisions);
127
+ }
128
+ catch (cause) {
129
+ return err(unavailable(cause, `could not read ${treeId}'s audience rule history`));
130
+ }
131
+ },
132
+ forms: async (treeId) => {
133
+ const forms = await storedForms(treeId);
134
+ return forms.ok ? ok(audienceFormListingsOf(forms.value)) : forms;
135
+ },
136
+ recordRules: async (treeId, request) => {
137
+ /**
138
+ * Outside the `try`, because `head` is total: the only statement here that
139
+ * can collide is the insert, and a narrow `try` is what lets the `catch`
140
+ * say *a unique violation on this insert means somebody else recorded*
141
+ * rather than guessing which of two statements threw.
142
+ */
143
+ const current = await head(treeId);
144
+ if (!current.ok)
145
+ return current;
146
+ const outcome = audienceRulesOutcomeOf(treeId, request, current.value);
147
+ if (!outcome.ok || outcome.value.outcome === "unchanged")
148
+ return outcome;
149
+ const revision = outcome.value.revision;
150
+ try {
151
+ await db.insert(loomAudienceRules).values({
152
+ applicationId: application,
153
+ treeId: revision.treeId,
154
+ revision: revision.revision,
155
+ rules: revision.rules,
156
+ actor: revision.actor,
157
+ recordedAt: revision.recordedAt,
158
+ });
159
+ }
160
+ catch (cause) {
161
+ if (!isUniqueViolation(cause)) {
162
+ return err(unavailable(cause, `could not record ${treeId}'s audience rules`));
163
+ }
164
+ /**
165
+ * Somebody else took this revision between the read and the insert. The
166
+ * head is re-read rather than guessed at, so the number reported is the
167
+ * one the caller now has to edit from.
168
+ */
169
+ const raced = await head(treeId);
170
+ return err({
171
+ code: "out-of-date",
172
+ treeId,
173
+ expected: request.expectedRevision ?? current.value?.revision ?? 0,
174
+ current: raced.ok ? (raced.value?.revision ?? 0) : revision.revision,
175
+ });
176
+ }
177
+ return outcome;
178
+ },
179
+ setForm: async (treeId, request) => {
180
+ if (request.delta.treeId !== treeId) {
181
+ return err({
182
+ code: "tree-mismatch",
183
+ treeId,
184
+ delta: request.delta.treeId,
185
+ });
186
+ }
187
+ const stored = { treeId, ...request, withdrawn: undefined };
188
+ try {
189
+ await db
190
+ .insert(loomAudienceForms)
191
+ .values({
192
+ applicationId: application,
193
+ treeId,
194
+ audienceId: request.audienceId,
195
+ delta: request.delta,
196
+ baseRevision: request.delta.baseRevision,
197
+ actor: request.actor,
198
+ authoredAt: request.authoredAt,
199
+ withdrawnBy: null,
200
+ withdrawnAt: null,
201
+ })
202
+ /**
203
+ * The rebase, as one statement. A form replaced by reading it, deciding
204
+ * it has moved and writing it back is a form two editors can lose half
205
+ * of; the key is already the identity, so the database can be asked to
206
+ * do it in one.
207
+ */
208
+ .onConflictDoUpdate({
209
+ target: [
210
+ loomAudienceForms.applicationId,
211
+ loomAudienceForms.treeId,
212
+ loomAudienceForms.audienceId,
213
+ ],
214
+ set: {
215
+ delta: request.delta,
216
+ baseRevision: request.delta.baseRevision,
217
+ actor: request.actor,
218
+ authoredAt: request.authoredAt,
219
+ /**
220
+ * Writing a form puts it back into service (0403). Left out of
221
+ * the `set`, a form withdrawn and then written again would keep
222
+ * its withdrawal and go on not being served — the work rebuilt
223
+ * and the segment still getting the base, with nothing naming
224
+ * the reason.
225
+ */
226
+ withdrawnBy: null,
227
+ withdrawnAt: null,
228
+ },
229
+ });
230
+ }
231
+ catch (cause) {
232
+ return err(unavailable(cause, `could not store ${request.audienceId}'s form of ${treeId}`));
233
+ }
234
+ return ok(stored);
235
+ },
236
+ /**
237
+ * **Read, then a conditional update, and no transaction**, which is the
238
+ * shape the rest of this module earns the right to: the row is read to
239
+ * answer with it and to tell *withdrew one* from *there was none*, and the
240
+ * `UPDATE`'s own `WHERE` is what makes the write safe rather than the read
241
+ * being fresh. A `setForm` racing it either lands first — and is withdrawn,
242
+ * which is what the caller asked — or lands after and puts the form back,
243
+ * which is the later of two acts winning.
244
+ */
245
+ withdrawForm: async (treeId, request) => {
246
+ const forms = await storedForms(treeId);
247
+ if (!forms.ok)
248
+ return forms;
249
+ const held = forms.value.find((form) => form.audienceId === request.audienceId);
250
+ if (held === undefined)
251
+ return ok(undefined);
252
+ try {
253
+ await db
254
+ .update(loomAudienceForms)
255
+ .set({ withdrawnBy: request.actor, withdrawnAt: request.withdrawnAt })
256
+ .where(mineForms(application, eq(loomAudienceForms.treeId, treeId), eq(loomAudienceForms.audienceId, request.audienceId)));
257
+ }
258
+ catch (cause) {
259
+ return err(unavailable(cause, `could not withdraw ${request.audienceId}'s form of ${treeId}`));
260
+ }
261
+ return ok(withdrawnFormOf(held, request));
262
+ },
263
+ };
264
+ };
265
+ /**
266
+ * Every read starts at one of these, so a query cannot forget the application by
267
+ * omission — the device `postgresTreeStore` and `postgresPolicyLog` both use,
268
+ * written per table because the two tables are two sets of columns.
269
+ */
270
+ const mineRules = (application, ...rest) => and(eq(loomAudienceRules.applicationId, application), ...rest);
271
+ const mineForms = (application, ...rest) => and(eq(loomAudienceForms.applicationId, application), ...rest);
272
+ //# sourceMappingURL=postgres-audience.js.map
@@ -1,4 +1,13 @@
1
+ import { type StoreScope } from "../application/application.js";
1
2
  import { type HoldStore } from "../write/held.js";
2
3
  import type { LoomDatabase } from "./database.js";
3
- export declare const postgresHoldStore: (db: LoomDatabase) => HoldStore;
4
+ /**
5
+ * Every query is filtered by the project this handle speaks for (0260), and
6
+ * every write sets it.
7
+ *
8
+ * This is the table the failure was named for: *a hold listing that spanned
9
+ * two apps would put one app's changes in another's queue*, which is the one
10
+ * thing a review queue cannot do. `waiting` is that listing.
11
+ */
12
+ export declare const postgresHoldStore: (db: LoomDatabase, scope?: StoreScope) => HoldStore;
4
13
  //# sourceMappingURL=postgres-holds.d.ts.map