@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,6 +1,6 @@
1
1
  import { sql } from "drizzle-orm";
2
2
  /**
3
- * Creating the three reader-signal tables, with row level security switched on.
3
+ * Creating the seven reader-signal tables, with row level security switched on.
4
4
  *
5
5
  * The same shape as the store's and the journal's migrations, and here for the
6
6
  * same reason: a DDL statement that lives in a document is a DDL statement a
@@ -10,11 +10,27 @@ import { sql } from "drizzle-orm";
10
10
  * Nothing in these tables identifies a reader — that is 0146's whole argument —
11
11
  * but the buffer holds view keys, and a view key plus another deployment's rows
12
12
  * is the only combination in Loom that could correlate anything across a
13
- * tenancy boundary. It expires within hours; the policy does not depend on
14
- * that.
13
+ * tenancy boundary. It used to expire within hours and now expires within the
14
+ * window the deployment states, thirty days by default (0349, 0351); the policy
15
+ * never depended on that and now carries more of the weight.
16
+ *
17
+ * Every table is led by `application_id` (0269). The backfill is the column
18
+ * default rather than an `UPDATE`: these seven never carried `project_id`, so
19
+ * there is no earlier spelling to correct the way `APPLICATION_ID_MIGRATION`
20
+ * corrects the store's — rows that predate the column belong to the deployment
21
+ * that wrote them, which is what `app_default` names.
22
+ *
23
+ * Every table then carries `audience_id`, the second migration 0273 owed and
24
+ * [0284](../../decisions/0284-a-signal-names-the-audience-it-was-collected-under-and-the-predicate-stays-in-the-control-plane.md)
25
+ * settles. Backfilled by its default for the stronger version of the same
26
+ * reason: a row written before the dimension existed was collected when there
27
+ * was one form of every page, so `aud_everyone` is what was true of it rather
28
+ * than a value somebody picked. The four counters take it into their keys; the
29
+ * buffer takes the column and keeps its key and its index, because nothing
30
+ * reads the buffer by audience.
15
31
  */
16
32
  /**
17
- * The three tables, as statements a host can run.
33
+ * The seven tables, as statements a host can run.
18
34
  *
19
35
  * One statement per entry for the same reason the store's DDL is a list: a
20
36
  * driver may refuse several commands in a single prepared statement, and
@@ -23,17 +39,93 @@ import { sql } from "drizzle-orm";
23
39
  */
24
40
  export const READER_SIGNALS_DDL = [
25
41
  `CREATE TABLE IF NOT EXISTS loom_reader_signals (
42
+ application_id text NOT NULL DEFAULT 'app_default',
43
+ audience_id text NOT NULL DEFAULT 'aud_everyone',
26
44
  seq bigserial PRIMARY KEY,
27
45
  tree_id text NOT NULL,
28
46
  revision integer NOT NULL,
29
47
  sent_at bigint NOT NULL,
30
48
  view text,
31
49
  signals jsonb NOT NULL,
32
- received_at timestamptz NOT NULL DEFAULT now()
50
+ received_at timestamptz NOT NULL DEFAULT now(),
51
+ folded_at timestamptz
33
52
  )`,
34
- `CREATE INDEX IF NOT EXISTS loom_reader_signals_tree_seq_idx ON loom_reader_signals (tree_id, seq)`,
53
+ /**
54
+ * **When the fold counted the delivery**, for a deployment whose buffer
55
+ * predates the kept window (0351).
56
+ *
57
+ * Additive, nullable and undefaulted, and the absence is a state the readings
58
+ * publish: *not yet counted*. There is no backfill and none is wanted — a row
59
+ * still in this table on a deployment that upgrades was, by the old rule, one
60
+ * no fold had reached, and a backfill that guessed otherwise would make
61
+ * retention eligible to delete a delivery the counters never saw.
62
+ */
63
+ `ALTER TABLE loom_reader_signals ADD COLUMN IF NOT EXISTS folded_at timestamptz`,
64
+ /**
65
+ * **The application, for a database that predates it (0269).** The same
66
+ * shape the store's tables take: the column is additive and defaulted, and
67
+ * then the index is rebuilt to lead with it.
68
+ *
69
+ * The buffer's key does not widen, unlike the four counters below. It is
70
+ * `seq`, a `bigserial`, which is already unique across every application the
71
+ * database holds — so leading the key with the application would be a wider
72
+ * key for no constraint that was not already enforced. The index is the part
73
+ * that matters here, because the index is what the reads use.
74
+ *
75
+ * Dropped by name rather than created `IF NOT EXISTS`, for the reason the
76
+ * store's note gives: the name does not change, so an existing index on the
77
+ * old columns would be left exactly as it was and every read would go on
78
+ * scanning across applications while appearing to be indexed.
79
+ */
80
+ `ALTER TABLE loom_reader_signals ADD COLUMN IF NOT EXISTS application_id text NOT NULL DEFAULT 'app_default'`,
81
+ /**
82
+ * **The audience, for a database that predates it (0284).** Additive and
83
+ * defaulted, and here the index is *not* rebuilt around it — the one place
84
+ * this dimension departs from the shape the application took.
85
+ *
86
+ * Every read of the buffer filters the application, optionally the tree, and
87
+ * the sequence; none of them filters the audience, because a rollup folds a
88
+ * whole window and groups by the column afterwards. Leading the index with it
89
+ * would push `tree_id` and `seq` out of the prefix and widen every scan that
90
+ * exists to serve a filter nothing expresses.
91
+ */
92
+ `ALTER TABLE loom_reader_signals ADD COLUMN IF NOT EXISTS audience_id text NOT NULL DEFAULT 'aud_everyone'`,
93
+ `DROP INDEX IF EXISTS loom_reader_signals_tree_seq_idx`,
94
+ `CREATE INDEX IF NOT EXISTS loom_reader_signals_tree_seq_idx ON loom_reader_signals (application_id, tree_id, seq)`,
95
+ /**
96
+ * **The oldest end across every tree** (0351), which is where both sweeps
97
+ * start: the fold scans for the oldest uncounted delivery and retention for
98
+ * the oldest kept one.
99
+ *
100
+ * Created rather than inherited because the table's lifetime changed. An hour
101
+ * of deliveries is a cheap scan however it is served; thirty days of them,
102
+ * with a deployment invited to state more, is not.
103
+ */
104
+ `CREATE INDEX IF NOT EXISTS loom_reader_signals_seq_idx ON loom_reader_signals (application_id, seq)`,
105
+ /**
106
+ * **The uncounted prefix** (0351), which is the fold's own read and the one
107
+ * index here that is partial.
108
+ *
109
+ * It is partial because the set it serves is bounded by the collection window
110
+ * and the rest of the table is not: on a deployment folding every hour and
111
+ * keeping thirty days, this covers about a seven-hundredth of the rows, and
112
+ * it shrinks to nothing every time the sweep runs. An index on `folded_at`
113
+ * across the whole table would be one entry per kept delivery to answer a
114
+ * question only ever asked about the newest few.
115
+ */
116
+ `CREATE INDEX IF NOT EXISTS loom_reader_signals_uncounted_idx ON loom_reader_signals (application_id, seq) WHERE folded_at IS NULL`,
117
+ /**
118
+ * **One page view's deliveries** (0355), which is the *Events* drawer's read.
119
+ *
120
+ * Partial for the reason the uncounted index is partial, though the set it
121
+ * leaves out is the other one: a delivery that names no page view is never
122
+ * looked up by one, so an entry for it would be paid for and never read.
123
+ */
124
+ `CREATE INDEX IF NOT EXISTS loom_reader_signals_view_idx ON loom_reader_signals (application_id, view) WHERE view IS NOT NULL`,
35
125
  `ALTER TABLE loom_reader_signals ENABLE ROW LEVEL SECURITY`,
36
126
  `CREATE TABLE IF NOT EXISTS loom_reader_tallies (
127
+ application_id text NOT NULL DEFAULT 'app_default',
128
+ audience_id text NOT NULL DEFAULT 'aud_everyone',
37
129
  tree_id text NOT NULL,
38
130
  revision integer NOT NULL,
39
131
  node_id text NOT NULL,
@@ -45,8 +137,9 @@ export const READER_SIGNALS_DDL = [
45
137
  activations bigint NOT NULL,
46
138
  opens bigint NOT NULL,
47
139
  closes bigint NOT NULL,
140
+ completions bigint NOT NULL DEFAULT 0,
48
141
  updated_at timestamptz NOT NULL,
49
- PRIMARY KEY (tree_id, revision, node_id)
142
+ PRIMARY KEY (application_id, audience_id, tree_id, revision, node_id)
50
143
  )`,
51
144
  /**
52
145
  * For a deployment whose tallies table predates the counter regions are
@@ -54,8 +147,22 @@ export const READER_SIGNALS_DDL = [
54
147
  * measured doing anything in here*, which is what was true of them.
55
148
  */
56
149
  `ALTER TABLE loom_reader_tallies ADD COLUMN IF NOT EXISTS engaged bigint NOT NULL DEFAULT 0`,
150
+ /**
151
+ * For a deployment whose tallies table predates the fifth kind. Additive and
152
+ * defaulted, so existing rows read as *nothing was submitted here*, which is
153
+ * what nobody was counting.
154
+ */
155
+ `ALTER TABLE loom_reader_tallies ADD COLUMN IF NOT EXISTS completions bigint NOT NULL DEFAULT 0`,
156
+ /** The application, for a database that predates it — see the buffer's note above. */
157
+ `ALTER TABLE loom_reader_tallies ADD COLUMN IF NOT EXISTS application_id text NOT NULL DEFAULT 'app_default'`,
158
+ /** The audience, for a database that predates it — see the buffer's note above. */
159
+ `ALTER TABLE loom_reader_tallies ADD COLUMN IF NOT EXISTS audience_id text NOT NULL DEFAULT 'aud_everyone'`,
160
+ `ALTER TABLE loom_reader_tallies DROP CONSTRAINT IF EXISTS loom_reader_tallies_pkey`,
161
+ `ALTER TABLE loom_reader_tallies ADD PRIMARY KEY (application_id, audience_id, tree_id, revision, node_id)`,
57
162
  `ALTER TABLE loom_reader_tallies ENABLE ROW LEVEL SECURITY`,
58
163
  `CREATE TABLE IF NOT EXISTS loom_reader_funnels (
164
+ application_id text NOT NULL DEFAULT 'app_default',
165
+ audience_id text NOT NULL DEFAULT 'aud_everyone',
59
166
  tree_id text NOT NULL,
60
167
  revision integer NOT NULL,
61
168
  from_node_id text NOT NULL,
@@ -65,9 +172,163 @@ export const READER_SIGNALS_DDL = [
65
172
  reached bigint NOT NULL,
66
173
  converted bigint NOT NULL,
67
174
  updated_at timestamptz NOT NULL,
68
- PRIMARY KEY (tree_id, revision, from_node_id, from_kind, to_node_id, to_kind)
175
+ PRIMARY KEY (application_id, audience_id, tree_id, revision, from_node_id, from_kind, to_node_id, to_kind)
69
176
  )`,
177
+ /** The application, for a database that predates it — see the buffer's note above. */
178
+ `ALTER TABLE loom_reader_funnels ADD COLUMN IF NOT EXISTS application_id text NOT NULL DEFAULT 'app_default'`,
179
+ /** The audience, for a database that predates it — see the buffer's note above. */
180
+ `ALTER TABLE loom_reader_funnels ADD COLUMN IF NOT EXISTS audience_id text NOT NULL DEFAULT 'aud_everyone'`,
181
+ `ALTER TABLE loom_reader_funnels DROP CONSTRAINT IF EXISTS loom_reader_funnels_pkey`,
182
+ `ALTER TABLE loom_reader_funnels ADD PRIMARY KEY (application_id, audience_id, tree_id, revision, from_node_id, from_kind, to_node_id, to_kind)`,
70
183
  `ALTER TABLE loom_reader_funnels ENABLE ROW LEVEL SECURITY`,
184
+ `CREATE TABLE IF NOT EXISTS loom_reader_regions (
185
+ application_id text NOT NULL DEFAULT 'app_default',
186
+ audience_id text NOT NULL DEFAULT 'aud_everyone',
187
+ tree_id text NOT NULL,
188
+ revision integer NOT NULL,
189
+ region text NOT NULL,
190
+ views bigint NOT NULL,
191
+ updated_at timestamptz NOT NULL,
192
+ PRIMARY KEY (application_id, audience_id, tree_id, revision, region)
193
+ )`,
194
+ /** The application, for a database that predates it — see the buffer's note above. */
195
+ `ALTER TABLE loom_reader_regions ADD COLUMN IF NOT EXISTS application_id text NOT NULL DEFAULT 'app_default'`,
196
+ /** The audience, for a database that predates it — see the buffer's note above. */
197
+ `ALTER TABLE loom_reader_regions ADD COLUMN IF NOT EXISTS audience_id text NOT NULL DEFAULT 'aud_everyone'`,
198
+ `ALTER TABLE loom_reader_regions DROP CONSTRAINT IF EXISTS loom_reader_regions_pkey`,
199
+ `ALTER TABLE loom_reader_regions ADD PRIMARY KEY (application_id, audience_id, tree_id, revision, region)`,
200
+ `ALTER TABLE loom_reader_regions ENABLE ROW LEVEL SECURITY`,
201
+ `CREATE TABLE IF NOT EXISTS loom_reader_page_views (
202
+ application_id text NOT NULL DEFAULT 'app_default',
203
+ audience_id text NOT NULL DEFAULT 'aud_everyone',
204
+ tree_id text NOT NULL,
205
+ revision integer NOT NULL,
206
+ opened bigint NOT NULL DEFAULT 0,
207
+ appearances bigint NOT NULL DEFAULT 0,
208
+ updated_at timestamptz NOT NULL,
209
+ folded_at timestamptz,
210
+ PRIMARY KEY (application_id, audience_id, tree_id, revision)
211
+ )`,
212
+ /**
213
+ * **When the fold last touched the row**, for a deployment whose page-view
214
+ * table predates the question.
215
+ *
216
+ * Additive, nullable and undefaulted, which is the only honest value: no
217
+ * backfill exists, because nothing wrote down when those rows were folded
218
+ * and `updated_at` cannot be read as it — it is written by the door as well.
219
+ * An existing row therefore reads *nothing attests a fold*, which is a state
220
+ * the reading publishes and raises no fault from, and the first fold after
221
+ * the migration fills it in.
222
+ */
223
+ `ALTER TABLE loom_reader_page_views ADD COLUMN IF NOT EXISTS folded_at timestamptz`,
224
+ /** The application, for a database that predates it — see the buffer's note above. */
225
+ `ALTER TABLE loom_reader_page_views ADD COLUMN IF NOT EXISTS application_id text NOT NULL DEFAULT 'app_default'`,
226
+ /** The audience, for a database that predates it — see the buffer's note above. */
227
+ `ALTER TABLE loom_reader_page_views ADD COLUMN IF NOT EXISTS audience_id text NOT NULL DEFAULT 'aud_everyone'`,
228
+ `ALTER TABLE loom_reader_page_views DROP CONSTRAINT IF EXISTS loom_reader_page_views_pkey`,
229
+ `ALTER TABLE loom_reader_page_views ADD PRIMARY KEY (application_id, audience_id, tree_id, revision)`,
230
+ `ALTER TABLE loom_reader_page_views ENABLE ROW LEVEL SECURITY`,
231
+ /**
232
+ * **When the page views began**, which is the sixth table and the first
233
+ * here with a clock in its key (`arrivals.ts`); the seventh below is the
234
+ * other.
235
+ *
236
+ * No `ALTER` beside it and no backfill, which is the one thing about this
237
+ * table an operator has to know: nothing but this counter ever knew which
238
+ * hour an arrival was in, so a deployment that upgrades starts counting hours
239
+ * from the moment it runs this and has no earlier ones. The reading publishes
240
+ * that as the hour counting began, so a chart over thirty days on a
241
+ * deployment that has counted for a week draws a week and says so rather than
242
+ * drawing three empty weeks.
243
+ */
244
+ `CREATE TABLE IF NOT EXISTS loom_reader_arrivals (
245
+ application_id text NOT NULL DEFAULT 'app_default',
246
+ audience_id text NOT NULL DEFAULT 'aud_everyone',
247
+ tree_id text NOT NULL,
248
+ revision integer NOT NULL,
249
+ hour timestamptz NOT NULL,
250
+ views bigint NOT NULL,
251
+ updated_at timestamptz NOT NULL,
252
+ PRIMARY KEY (application_id, audience_id, tree_id, revision, hour)
253
+ )`,
254
+ /**
255
+ * **Every tree of one application, by hour**, which is the deployment-wide
256
+ * chart. The primary key already serves a reading of one page, because that
257
+ * read names the tree and the revision.
258
+ */
259
+ `CREATE INDEX IF NOT EXISTS loom_reader_arrivals_hour_idx ON loom_reader_arrivals (application_id, hour)`,
260
+ `ALTER TABLE loom_reader_arrivals ENABLE ROW LEVEL SECURITY`,
261
+ /**
262
+ * **What readers did to a part, by the hour they did it in**, which is the
263
+ * seventh table and the second with a clock in its key (`acted.ts`).
264
+ *
265
+ * No `ALTER` beside it and no backfill, for the reason the sixth table has
266
+ * none: nothing but this counter ever knew which hour a press was in, so a
267
+ * deployment that upgrades starts counting from the moment it runs this. The
268
+ * reading publishes the hour counting began, so a goal's figure over thirty
269
+ * days on a deployment that has counted for a week draws a week and says so.
270
+ */
271
+ `CREATE TABLE IF NOT EXISTS loom_reader_acted_hours (
272
+ application_id text NOT NULL DEFAULT 'app_default',
273
+ audience_id text NOT NULL DEFAULT 'aud_everyone',
274
+ tree_id text NOT NULL,
275
+ revision integer NOT NULL,
276
+ node_id text NOT NULL,
277
+ hour timestamptz NOT NULL,
278
+ type text NOT NULL,
279
+ activations bigint NOT NULL DEFAULT 0,
280
+ opens bigint NOT NULL DEFAULT 0,
281
+ closes bigint NOT NULL DEFAULT 0,
282
+ completions bigint NOT NULL DEFAULT 0,
283
+ updated_at timestamptz NOT NULL,
284
+ PRIMARY KEY (application_id, audience_id, tree_id, revision, node_id, hour)
285
+ )`,
286
+ /**
287
+ * **One part of one page over a range**, which is a goal's series: the
288
+ * primary key cannot serve it, because a goal names the tree and the part and
289
+ * neither of the two columns between them.
290
+ */
291
+ `CREATE INDEX IF NOT EXISTS loom_reader_acted_part_idx ON loom_reader_acted_hours (application_id, tree_id, node_id, hour)`,
292
+ /** **Every part of one application, by hour**, which is the deployment-wide reading. */
293
+ `CREATE INDEX IF NOT EXISTS loom_reader_acted_hour_idx ON loom_reader_acted_hours (application_id, hour)`,
294
+ `ALTER TABLE loom_reader_acted_hours ENABLE ROW LEVEL SECURITY`,
295
+ /**
296
+ * **A funnel pair's answer, by the hour the readers in it entered the
297
+ * funnel**, which is the eighth table and the third with a clock in its key
298
+ * (`funnel-hours.ts`).
299
+ *
300
+ * No `ALTER` beside it and no backfill, for the reason the two tables above
301
+ * have none: nothing but this counter ever knew which hour a reach was in,
302
+ * and the view keys that would be needed to work it out afterwards are gone
303
+ * with the window they were folded from (0146). A deployment that upgrades
304
+ * starts counting from the moment it runs this, and the reading publishes
305
+ * the hour counting began — so a step compared over two fortnights on a
306
+ * deployment that has counted for a week draws a week and says so.
307
+ */
308
+ `CREATE TABLE IF NOT EXISTS loom_reader_funnel_hours (
309
+ application_id text NOT NULL DEFAULT 'app_default',
310
+ audience_id text NOT NULL DEFAULT 'aud_everyone',
311
+ tree_id text NOT NULL,
312
+ revision integer NOT NULL,
313
+ from_node_id text NOT NULL,
314
+ from_kind text NOT NULL,
315
+ to_node_id text NOT NULL,
316
+ to_kind text NOT NULL,
317
+ hour timestamptz NOT NULL,
318
+ reached bigint NOT NULL,
319
+ converted bigint NOT NULL,
320
+ updated_at timestamptz NOT NULL,
321
+ PRIMARY KEY (application_id, audience_id, tree_id, revision, from_node_id, from_kind, to_node_id, to_kind, hour)
322
+ )`,
323
+ /**
324
+ * **One pair of one page over a range**, which is a step's two sides: the
325
+ * primary key cannot serve it, because a step names the tree and the two ends
326
+ * and neither of the columns between them.
327
+ */
328
+ `CREATE INDEX IF NOT EXISTS loom_reader_funnel_hours_pair_idx ON loom_reader_funnel_hours (application_id, tree_id, from_node_id, to_node_id, hour)`,
329
+ /** **Every pair of one application, by hour**, which is the deployment-wide reading. */
330
+ `CREATE INDEX IF NOT EXISTS loom_reader_funnel_hours_hour_idx ON loom_reader_funnel_hours (application_id, hour)`,
331
+ `ALTER TABLE loom_reader_funnel_hours ENABLE ROW LEVEL SECURITY`,
71
332
  ];
72
333
  /** Idempotent, so running it against a populated database is a no-op. */
73
334
  export const ensureReaderSignalsSchema = async (db) => {