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