@jam-overture/loom 0.1.0 → 0.2.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 (290) 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/cli/templates.js +19 -0
  11. package/dist/data/plan.js +0 -0
  12. package/dist/data/resolution.d.ts +23 -1
  13. package/dist/data/resolve.d.ts +30 -3
  14. package/dist/data/resolve.js +11 -3
  15. package/dist/ids.d.ts +10 -0
  16. package/dist/ids.js +11 -1
  17. package/dist/index.d.ts +1 -0
  18. package/dist/index.js +1 -0
  19. package/dist/patch.d.ts +54 -0
  20. package/dist/patch.js +44 -0
  21. package/dist/project/closing.d.ts +51 -0
  22. package/dist/project/closing.js +53 -0
  23. package/dist/project/memory.d.ts +20 -0
  24. package/dist/project/memory.js +97 -0
  25. package/dist/project/project.d.ts +90 -0
  26. package/dist/project/project.js +91 -0
  27. package/dist/project/store.d.ts +135 -0
  28. package/dist/project/store.js +41 -0
  29. package/dist/registered.d.ts +64 -0
  30. package/dist/registered.js +118 -0
  31. package/dist/render/behaviour-adjust.d.ts +11 -19
  32. package/dist/render/behaviour-adjust.js +75 -21
  33. package/dist/render/behaviour-present.d.ts +8 -0
  34. package/dist/render/behaviour-present.js +57 -6
  35. package/dist/render/behaviour.d.ts +98 -17
  36. package/dist/render/behaviour.js +91 -26
  37. package/dist/render/control-name.d.ts +68 -0
  38. package/dist/render/control-name.js +37 -0
  39. package/dist/render/diagnostics.d.ts +72 -0
  40. package/dist/render/diagnostics.js +7 -0
  41. package/dist/render/index.d.ts +2 -0
  42. package/dist/render/index.js +2 -0
  43. package/dist/render/reads.d.ts +11 -0
  44. package/dist/render/reads.js +12 -1
  45. package/dist/render/render.js +102 -7
  46. package/dist/render/slots.d.ts +52 -0
  47. package/dist/render/slots.js +24 -0
  48. package/dist/render/theme.d.ts +54 -1
  49. package/dist/render/theme.js +23 -1
  50. package/dist/render/unshown.d.ts +152 -0
  51. package/dist/render/unshown.js +80 -0
  52. package/dist/runtime/analysis.d.ts +94 -9
  53. package/dist/runtime/analysis.js +54 -9
  54. package/dist/runtime/assessment.d.ts +36 -2
  55. package/dist/runtime/assessment.js +27 -2
  56. package/dist/runtime/checks.d.ts +148 -0
  57. package/dist/runtime/checks.js +112 -0
  58. package/dist/runtime/disposition.d.ts +96 -0
  59. package/dist/runtime/disposition.js +46 -0
  60. package/dist/runtime/gate.js +22 -0
  61. package/dist/runtime/index.d.ts +3 -0
  62. package/dist/runtime/index.js +3 -0
  63. package/dist/runtime/irreversibility.d.ts +64 -0
  64. package/dist/runtime/irreversibility.js +45 -0
  65. package/dist/runtime/pipeline.d.ts +43 -0
  66. package/dist/runtime/pipeline.js +10 -2
  67. package/dist/runtime/policy-change.d.ts +93 -0
  68. package/dist/runtime/policy-change.js +299 -0
  69. package/dist/runtime/policy-log.d.ts +406 -0
  70. package/dist/runtime/policy-log.js +285 -0
  71. package/dist/runtime/reversibility.d.ts +11 -9
  72. package/dist/runtime/stakes.d.ts +129 -1
  73. package/dist/runtime/stakes.js +240 -26
  74. package/dist/runtime/vocabulary.d.ts +164 -7
  75. package/dist/runtime/vocabulary.js +181 -8
  76. package/dist/sdk/audit.d.ts +174 -3
  77. package/dist/sdk/audit.js +176 -17
  78. package/dist/sdk/catalogue.d.ts +9 -1
  79. package/dist/sdk/conformance.d.ts +37 -3
  80. package/dist/sdk/conformance.js +25 -4
  81. package/dist/sdk/definition.d.ts +65 -0
  82. package/dist/sdk/definition.js +22 -0
  83. package/dist/sdk/registry.d.ts +29 -2
  84. package/dist/sdk/registry.js +63 -1
  85. package/dist/signals/action-change.d.ts +507 -0
  86. package/dist/signals/action-change.js +265 -0
  87. package/dist/signals/action.d.ts +331 -0
  88. package/dist/signals/action.js +182 -0
  89. package/dist/signals/applied-window.contract.d.ts +23 -0
  90. package/dist/signals/applied-window.contract.js +160 -0
  91. package/dist/signals/arriving.d.ts +210 -0
  92. package/dist/signals/arriving.js +133 -0
  93. package/dist/signals/audiences.d.ts +528 -0
  94. package/dist/signals/audiences.js +255 -0
  95. package/dist/signals/broadcast.d.ts +8 -2
  96. package/dist/signals/broadcast.js +58 -8
  97. package/dist/signals/change.d.ts +378 -0
  98. package/dist/signals/change.js +327 -0
  99. package/dist/signals/collect.d.ts +41 -0
  100. package/dist/signals/collect.js +88 -7
  101. package/dist/signals/copy-change.d.ts +553 -0
  102. package/dist/signals/copy-change.js +377 -0
  103. package/dist/signals/copy.d.ts +337 -0
  104. package/dist/signals/copy.js +211 -0
  105. package/dist/signals/counters.d.ts +46 -0
  106. package/dist/signals/counters.js +102 -0
  107. package/dist/signals/deliver.d.ts +23 -4
  108. package/dist/signals/deliver.js +34 -6
  109. package/dist/signals/deployment-change.d.ts +371 -0
  110. package/dist/signals/deployment-change.js +268 -0
  111. package/dist/signals/deployment.d.ts +265 -0
  112. package/dist/signals/deployment.js +152 -0
  113. package/dist/signals/door.d.ts +92 -0
  114. package/dist/signals/door.js +53 -0
  115. package/dist/signals/fold.d.ts +10 -0
  116. package/dist/signals/fold.js +5 -1
  117. package/dist/signals/form-action.d.ts +302 -0
  118. package/dist/signals/form-action.js +169 -0
  119. package/dist/signals/form-copy.d.ts +523 -0
  120. package/dist/signals/form-copy.js +346 -0
  121. package/dist/signals/forms.d.ts +247 -0
  122. package/dist/signals/forms.js +147 -0
  123. package/dist/signals/funnel-change.d.ts +548 -0
  124. package/dist/signals/funnel-change.js +361 -0
  125. package/dist/signals/funnel.d.ts +532 -0
  126. package/dist/signals/funnel.js +216 -0
  127. package/dist/signals/health.d.ts +497 -0
  128. package/dist/signals/health.js +361 -0
  129. package/dist/signals/index.d.ts +41 -0
  130. package/dist/signals/index.js +41 -0
  131. package/dist/signals/ingest.d.ts +56 -1
  132. package/dist/signals/ingest.js +91 -1
  133. package/dist/signals/journal.d.ts +11 -0
  134. package/dist/signals/kinds.d.ts +8 -6
  135. package/dist/signals/kinds.js +14 -6
  136. package/dist/signals/library-action.d.ts +430 -0
  137. package/dist/signals/library-action.js +336 -0
  138. package/dist/signals/library-change.d.ts +477 -0
  139. package/dist/signals/library-change.js +335 -0
  140. package/dist/signals/library-copy-change.d.ts +498 -0
  141. package/dist/signals/library-copy-change.js +476 -0
  142. package/dist/signals/library-pace.d.ts +319 -0
  143. package/dist/signals/library-pace.js +305 -0
  144. package/dist/signals/library-reach-change.d.ts +636 -0
  145. package/dist/signals/library-reach-change.js +534 -0
  146. package/dist/signals/library-reach.d.ts +377 -0
  147. package/dist/signals/library-reach.js +227 -0
  148. package/dist/signals/library-word-reach-change.d.ts +567 -0
  149. package/dist/signals/library-word-reach-change.js +568 -0
  150. package/dist/signals/library.d.ts +306 -0
  151. package/dist/signals/library.js +178 -0
  152. package/dist/signals/memory.d.ts +9 -0
  153. package/dist/signals/memory.js +105 -14
  154. package/dist/signals/migrate.d.ts +17 -2
  155. package/dist/signals/migrate.js +122 -5
  156. package/dist/signals/notice.d.ts +334 -0
  157. package/dist/signals/notice.js +228 -0
  158. package/dist/signals/pace-change.d.ts +501 -0
  159. package/dist/signals/pace-change.js +310 -0
  160. package/dist/signals/pace.d.ts +296 -0
  161. package/dist/signals/pace.js +291 -0
  162. package/dist/signals/page-views.d.ts +365 -0
  163. package/dist/signals/page-views.js +218 -0
  164. package/dist/signals/parts.d.ts +344 -0
  165. package/dist/signals/parts.js +273 -0
  166. package/dist/signals/postgres.d.ts +16 -2
  167. package/dist/signals/postgres.js +390 -87
  168. package/dist/signals/progress.d.ts +212 -0
  169. package/dist/signals/progress.js +150 -0
  170. package/dist/signals/ratios.d.ts +108 -0
  171. package/dist/signals/ratios.js +40 -0
  172. package/dist/signals/reach.d.ts +309 -0
  173. package/dist/signals/reach.js +93 -0
  174. package/dist/signals/readable.d.ts +34 -0
  175. package/dist/signals/readable.js +34 -0
  176. package/dist/signals/readership.d.ts +381 -0
  177. package/dist/signals/readership.js +308 -0
  178. package/dist/signals/region-pages.d.ts +173 -0
  179. package/dist/signals/region-pages.js +62 -0
  180. package/dist/signals/region.d.ts +287 -0
  181. package/dist/signals/region.js +198 -0
  182. package/dist/signals/retention.d.ts +141 -0
  183. package/dist/signals/retention.js +58 -0
  184. package/dist/signals/rollup.d.ts +67 -3
  185. package/dist/signals/rollup.js +0 -0
  186. package/dist/signals/schema.d.ts +432 -1
  187. package/dist/signals/schema.js +157 -3
  188. package/dist/signals/signal.d.ts +237 -11
  189. package/dist/signals/signal.js +70 -10
  190. package/dist/signals/silence-census.d.ts +205 -0
  191. package/dist/signals/silence-census.js +87 -0
  192. package/dist/signals/silences.d.ts +848 -0
  193. package/dist/signals/silences.js +753 -0
  194. package/dist/signals/tally.d.ts +140 -11
  195. package/dist/signals/window-figures.d.ts +148 -0
  196. package/dist/signals/window-figures.js +42 -0
  197. package/dist/signals/window.d.ts +866 -0
  198. package/dist/signals/window.js +693 -0
  199. package/dist/signals/words.d.ts +24 -0
  200. package/dist/signals/words.js +24 -0
  201. package/dist/store/index.d.ts +19 -0
  202. package/dist/store/index.js +19 -0
  203. package/dist/store/memory.d.ts +2 -1
  204. package/dist/store/memory.js +48 -12
  205. package/dist/store/migrate.d.ts +80 -0
  206. package/dist/store/migrate.js +259 -7
  207. package/dist/store/postgres-applications.d.ts +4 -0
  208. package/dist/store/postgres-applications.js +197 -0
  209. package/dist/store/postgres-holds.d.ts +10 -1
  210. package/dist/store/postgres-holds.js +116 -101
  211. package/dist/store/postgres-policy-log.d.ts +14 -0
  212. package/dist/store/postgres-policy-log.js +240 -0
  213. package/dist/store/postgres-projects.d.ts +4 -0
  214. package/dist/store/postgres-projects.js +217 -0
  215. package/dist/store/postgres.d.ts +16 -1
  216. package/dist/store/postgres.js +59 -9
  217. package/dist/store/replay.d.ts +102 -1
  218. package/dist/store/replay.js +190 -19
  219. package/dist/store/reseed.d.ts +238 -0
  220. package/dist/store/reseed.js +308 -0
  221. package/dist/store/schema.d.ts +450 -2
  222. package/dist/store/schema.js +141 -5
  223. package/dist/store/store.d.ts +29 -6
  224. package/dist/submit/resolve.js +2 -1
  225. package/dist/telemetry/calibration.d.ts +25 -0
  226. package/dist/telemetry/calibration.js +27 -1
  227. package/dist/telemetry/event.d.ts +391 -33
  228. package/dist/telemetry/event.js +84 -20
  229. package/dist/telemetry/index.d.ts +1 -0
  230. package/dist/telemetry/index.js +1 -0
  231. package/dist/telemetry/journal.d.ts +72 -3
  232. package/dist/telemetry/journal.js +9 -0
  233. package/dist/telemetry/lookup.d.ts +27 -0
  234. package/dist/telemetry/lookup.js +18 -0
  235. package/dist/telemetry/memory.js +23 -0
  236. package/dist/telemetry/migrate.js +22 -1
  237. package/dist/telemetry/postgres.d.ts +10 -1
  238. package/dist/telemetry/postgres.js +172 -90
  239. package/dist/telemetry/remeasure.d.ts +78 -0
  240. package/dist/telemetry/remeasure.js +83 -0
  241. package/dist/telemetry/retention.d.ts +2 -2
  242. package/dist/telemetry/schema.d.ts +17 -0
  243. package/dist/telemetry/schema.js +27 -1
  244. package/dist/telemetry/sink.d.ts +2 -2
  245. package/dist/testing/application-contract.d.ts +14 -0
  246. package/dist/testing/application-contract.js +270 -0
  247. package/dist/testing/contracts.d.ts +12 -7
  248. package/dist/testing/contracts.js +12 -7
  249. package/dist/testing/definitions.d.ts +78 -0
  250. package/dist/testing/definitions.js +134 -9
  251. package/dist/testing/doubles.d.ts +103 -0
  252. package/dist/testing/doubles.js +143 -0
  253. package/dist/testing/index.d.ts +2 -2
  254. package/dist/testing/index.js +2 -2
  255. package/dist/testing/journal-contract.js +140 -2
  256. package/dist/testing/model-contract.d.ts +110 -0
  257. package/dist/testing/model-contract.js +150 -0
  258. package/dist/testing/policy-log-contract.d.ts +26 -0
  259. package/dist/testing/policy-log-contract.js +344 -0
  260. package/dist/testing/project-contract.d.ts +14 -0
  261. package/dist/testing/project-contract.js +266 -0
  262. package/dist/testing/reader-signal-contract.d.ts +27 -2
  263. package/dist/testing/reader-signal-contract.js +475 -5
  264. package/dist/testing/store-contract.d.ts +7 -1
  265. package/dist/testing/store-contract.js +84 -3
  266. package/dist/theme/apply.d.ts +20 -1
  267. package/dist/theme/apply.js +5 -3
  268. package/dist/theme/derive.d.ts +22 -0
  269. package/dist/theme/derive.js +54 -1
  270. package/dist/theme/library.js +1 -1
  271. package/dist/theme/measure.d.ts +34 -0
  272. package/dist/theme/measure.js +30 -1
  273. package/dist/theme/palettes.js +7 -7
  274. package/dist/theme/ramp.d.ts +64 -0
  275. package/dist/theme/ramp.js +114 -0
  276. package/dist/theme/registry.d.ts +9 -0
  277. package/dist/theme/registry.js +11 -1
  278. package/dist/theme/separation.d.ts +97 -3
  279. package/dist/theme/separation.js +75 -0
  280. package/dist/tree/compare.d.ts +9 -0
  281. package/dist/tree/compare.js +18 -0
  282. package/dist/write/computed.d.ts +60 -0
  283. package/dist/write/computed.js +61 -0
  284. package/dist/write/held.d.ts +59 -0
  285. package/dist/write/index.d.ts +5 -2
  286. package/dist/write/index.js +5 -2
  287. package/dist/write/reseed.d.ts +151 -0
  288. package/dist/write/reseed.js +184 -0
  289. package/dist/write/revert.js +2 -16
  290. package/package.json +98 -19
@@ -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
@@ -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
@@ -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