@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
|
@@ -0,0 +1,354 @@
|
|
|
1
|
+
import { describe, expect, it } from "vitest";
|
|
2
|
+
import { audienceIdSchema } from "../audience/audience.js";
|
|
3
|
+
import { treeIdSchema } from "../ids.js";
|
|
4
|
+
import { treeDeltaSchema } from "../tree/delta.js";
|
|
5
|
+
/**
|
|
6
|
+
* One suite, run against every `AudienceOverlayStore`.
|
|
7
|
+
*
|
|
8
|
+
* `memoryAudienceOverlayStore` calls itself the reference implementation; this
|
|
9
|
+
* is what makes that claim checkable rather than aspirational, on the terms
|
|
10
|
+
* `store-contract.ts`, `policy-log-contract.ts` and `project-contract.ts`
|
|
11
|
+
* already set. The alternative — each store asserted against its own
|
|
12
|
+
* expectations — is how two stores that disagree both stay green.
|
|
13
|
+
*
|
|
14
|
+
* What is checked here is what the type cannot say: that the rules are a log
|
|
15
|
+
* rather than a column, that their order survives a round trip, that a save
|
|
16
|
+
* with nothing in it does not append, that two editors racing cannot both
|
|
17
|
+
* commit, that a form is replaced rather than accumulated, and that a
|
|
18
|
+
* withdrawn form stops being served without ceasing to exist (0403).
|
|
19
|
+
*/
|
|
20
|
+
export const CONTRACT_TREE = treeIdSchema.parse("t_overlaycontract");
|
|
21
|
+
export const audienceNamed = (name) => audienceIdSchema.parse(`aud_${name}`);
|
|
22
|
+
export const ruleFor = (audienceId, key, value) => ({
|
|
23
|
+
audienceId,
|
|
24
|
+
clauses: [{ key, anyOf: [value] }],
|
|
25
|
+
});
|
|
26
|
+
/**
|
|
27
|
+
* A delta that is well-formed and is never applied by this suite — what is
|
|
28
|
+
* under test is custody, not composition, which `compose.test.ts` covers
|
|
29
|
+
* against the tree it belongs to.
|
|
30
|
+
*/
|
|
31
|
+
export const formDelta = (over = {}) => treeDeltaSchema.parse({
|
|
32
|
+
deltaId: "d_contract",
|
|
33
|
+
treeId: CONTRACT_TREE,
|
|
34
|
+
baseRevision: 3,
|
|
35
|
+
operations: [{ op: "remove", nodeId: "n_footer" }],
|
|
36
|
+
...over,
|
|
37
|
+
});
|
|
38
|
+
const EU = audienceNamed("eu");
|
|
39
|
+
const UK = audienceNamed("uk");
|
|
40
|
+
const recording = (rules, over = {}) => ({
|
|
41
|
+
rules,
|
|
42
|
+
actor: "person:ana",
|
|
43
|
+
recordedAt: "2026-11-10T09:00:00.000Z",
|
|
44
|
+
...over,
|
|
45
|
+
});
|
|
46
|
+
const authoring = (audienceId, delta = formDelta()) => ({
|
|
47
|
+
audienceId,
|
|
48
|
+
delta,
|
|
49
|
+
actor: "person:ana",
|
|
50
|
+
authoredAt: "2026-11-10T09:00:00.000Z",
|
|
51
|
+
});
|
|
52
|
+
/** A different person at a later hour than `authoring`, so an overwritten author would show. */
|
|
53
|
+
const withdrawing = (audienceId, over = {}) => ({
|
|
54
|
+
audienceId,
|
|
55
|
+
actor: "person:ben",
|
|
56
|
+
withdrawnAt: "2026-11-11T09:00:00.000Z",
|
|
57
|
+
...over,
|
|
58
|
+
});
|
|
59
|
+
export const describeAudienceOverlayStoreContract = (name, make) => {
|
|
60
|
+
describe(`${name} — the audience overlay contract`, () => {
|
|
61
|
+
it("answers an empty overlay for a page nobody has written rules for, rather than not-found", async () => {
|
|
62
|
+
const store = await make();
|
|
63
|
+
expect(await store.overlay(CONTRACT_TREE)).toEqual({
|
|
64
|
+
ok: true,
|
|
65
|
+
value: { rules: [], forms: [] },
|
|
66
|
+
});
|
|
67
|
+
expect(await store.rules(CONTRACT_TREE)).toEqual({ ok: true, value: undefined });
|
|
68
|
+
});
|
|
69
|
+
it("reads back the rules it recorded, as revision 1", async () => {
|
|
70
|
+
const store = await make();
|
|
71
|
+
const rules = [ruleFor(EU, "region", "eu")];
|
|
72
|
+
const recorded = await store.recordRules(CONTRACT_TREE, recording(rules));
|
|
73
|
+
expect(recorded.ok && recorded.value.outcome).toBe("recorded");
|
|
74
|
+
expect(recorded.ok && recorded.value.revision.revision).toBe(1);
|
|
75
|
+
expect(recorded.ok && recorded.value.revision.actor).toBe("person:ana");
|
|
76
|
+
const read = await store.rules(CONTRACT_TREE);
|
|
77
|
+
expect(read.ok && read.value?.rules).toEqual(rules);
|
|
78
|
+
});
|
|
79
|
+
/**
|
|
80
|
+
* The property the whole table exists for. The order is the precedence — the
|
|
81
|
+
* last matching rule wins a contested node — so a store that round-trips
|
|
82
|
+
* the same rules in another order has changed what the deployment serves
|
|
83
|
+
* without anybody editing anything (0359).
|
|
84
|
+
*/
|
|
85
|
+
it("keeps the rule order, which is the precedence", async () => {
|
|
86
|
+
const store = await make();
|
|
87
|
+
const general = ruleFor(EU, "region", "eu");
|
|
88
|
+
const specific = ruleFor(UK, "country", "gb");
|
|
89
|
+
await store.recordRules(CONTRACT_TREE, recording([general, specific]));
|
|
90
|
+
const read = await store.overlay(CONTRACT_TREE);
|
|
91
|
+
expect(read.ok && read.value.rules.map((rule) => rule.audienceId)).toEqual([EU, UK]);
|
|
92
|
+
});
|
|
93
|
+
it("appends rather than overwriting, so who changed who sees what is a record", async () => {
|
|
94
|
+
const store = await make();
|
|
95
|
+
await store.recordRules(CONTRACT_TREE, recording([ruleFor(EU, "region", "eu")]));
|
|
96
|
+
const second = await store.recordRules(CONTRACT_TREE, recording([ruleFor(EU, "region", "eu"), ruleFor(UK, "country", "gb")], {
|
|
97
|
+
actor: "person:ben",
|
|
98
|
+
recordedAt: "2026-11-10T10:00:00.000Z",
|
|
99
|
+
}));
|
|
100
|
+
expect(second.ok && second.value.revision.revision).toBe(2);
|
|
101
|
+
expect(second.ok && second.value.revision.actor).toBe("person:ben");
|
|
102
|
+
});
|
|
103
|
+
/**
|
|
104
|
+
* The read that makes the log a record. A store that overwrote instead of
|
|
105
|
+
* appending would pass every other assertion here: the revision numbers
|
|
106
|
+
* come off the head either way.
|
|
107
|
+
*/
|
|
108
|
+
it("keeps every edit, newest first, so who changed who sees what can be read back", async () => {
|
|
109
|
+
const store = await make();
|
|
110
|
+
await store.recordRules(CONTRACT_TREE, recording([ruleFor(EU, "region", "eu")]));
|
|
111
|
+
await store.recordRules(CONTRACT_TREE, recording([ruleFor(UK, "country", "gb")], {
|
|
112
|
+
actor: "person:ben",
|
|
113
|
+
recordedAt: "2026-11-10T10:00:00.000Z",
|
|
114
|
+
}));
|
|
115
|
+
const history = await store.history(CONTRACT_TREE);
|
|
116
|
+
expect(history.ok && history.value.map((edit) => [edit.revision, edit.actor])).toEqual([
|
|
117
|
+
[2, "person:ben"],
|
|
118
|
+
[1, "person:ana"],
|
|
119
|
+
]);
|
|
120
|
+
});
|
|
121
|
+
it("answers an empty history for a page nobody has written rules for", async () => {
|
|
122
|
+
const store = await make();
|
|
123
|
+
expect(await store.history(CONTRACT_TREE)).toEqual({ ok: true, value: [] });
|
|
124
|
+
});
|
|
125
|
+
it("bounds the history it hands back, whether a caller names a large limit or none", async () => {
|
|
126
|
+
const store = await make();
|
|
127
|
+
for (const index of [0, 1, 2]) {
|
|
128
|
+
await store.recordRules(CONTRACT_TREE, recording([ruleFor(EU, "region", `eu${index}`)], {
|
|
129
|
+
recordedAt: `2026-11-10T0${index}:00:00.000Z`,
|
|
130
|
+
}));
|
|
131
|
+
}
|
|
132
|
+
const asked = await store.history(CONTRACT_TREE, { limit: 2 });
|
|
133
|
+
const flooded = await store.history(CONTRACT_TREE, { limit: 10_000 });
|
|
134
|
+
expect(asked.ok && asked.value).toHaveLength(2);
|
|
135
|
+
expect(flooded.ok && flooded.value).toHaveLength(3);
|
|
136
|
+
});
|
|
137
|
+
it("does not record an unchanged save in the history", async () => {
|
|
138
|
+
const store = await make();
|
|
139
|
+
const rules = [ruleFor(EU, "region", "eu")];
|
|
140
|
+
await store.recordRules(CONTRACT_TREE, recording(rules));
|
|
141
|
+
await store.recordRules(CONTRACT_TREE, recording(rules, { actor: "person:ben" }));
|
|
142
|
+
const history = await store.history(CONTRACT_TREE);
|
|
143
|
+
expect(history.ok && history.value).toHaveLength(1);
|
|
144
|
+
});
|
|
145
|
+
it("treats the same rules in the same order as unchanged, so a screen that saves on blur writes nothing", async () => {
|
|
146
|
+
const store = await make();
|
|
147
|
+
const rules = [ruleFor(EU, "region", "eu")];
|
|
148
|
+
await store.recordRules(CONTRACT_TREE, recording(rules));
|
|
149
|
+
const again = await store.recordRules(CONTRACT_TREE, recording(rules, { actor: "person:ben", recordedAt: "2026-11-10T11:00:00.000Z" }));
|
|
150
|
+
expect(again.ok && again.value.outcome).toBe("unchanged");
|
|
151
|
+
expect(again.ok && again.value.revision.revision).toBe(1);
|
|
152
|
+
expect(again.ok && again.value.revision.actor).toBe("person:ana");
|
|
153
|
+
});
|
|
154
|
+
/** A reorder is an edit, because the order is the thing that decides. */
|
|
155
|
+
it("treats the same rules in another order as an edit", async () => {
|
|
156
|
+
const store = await make();
|
|
157
|
+
const general = ruleFor(EU, "region", "eu");
|
|
158
|
+
const specific = ruleFor(UK, "country", "gb");
|
|
159
|
+
await store.recordRules(CONTRACT_TREE, recording([general, specific]));
|
|
160
|
+
const flipped = await store.recordRules(CONTRACT_TREE, recording([specific, general]));
|
|
161
|
+
expect(flipped.ok && flipped.value.outcome).toBe("recorded");
|
|
162
|
+
expect(flipped.ok && flipped.value.revision.revision).toBe(2);
|
|
163
|
+
});
|
|
164
|
+
it("refuses an edit of a revision that is no longer the current one", async () => {
|
|
165
|
+
const store = await make();
|
|
166
|
+
await store.recordRules(CONTRACT_TREE, recording([ruleFor(EU, "region", "eu")]));
|
|
167
|
+
const lost = await store.recordRules(CONTRACT_TREE, recording([ruleFor(UK, "country", "gb")], { expectedRevision: 0 }));
|
|
168
|
+
expect(lost).toEqual({
|
|
169
|
+
ok: false,
|
|
170
|
+
error: { code: "out-of-date", treeId: CONTRACT_TREE, expected: 0, current: 1 },
|
|
171
|
+
});
|
|
172
|
+
const read = await store.rules(CONTRACT_TREE);
|
|
173
|
+
expect(read.ok && read.value?.rules[0]?.audienceId).toBe(EU);
|
|
174
|
+
});
|
|
175
|
+
it("records an empty list, because a page served to everybody the same way is a decision somebody made", async () => {
|
|
176
|
+
const store = await make();
|
|
177
|
+
await store.recordRules(CONTRACT_TREE, recording([ruleFor(EU, "region", "eu")]));
|
|
178
|
+
const cleared = await store.recordRules(CONTRACT_TREE, recording([]));
|
|
179
|
+
expect(cleared.ok && cleared.value.revision.revision).toBe(2);
|
|
180
|
+
const read = await store.overlay(CONTRACT_TREE);
|
|
181
|
+
expect(read.ok && read.value.rules).toEqual([]);
|
|
182
|
+
});
|
|
183
|
+
it("refuses an actor nobody is named by and a stamp that is not an instant", async () => {
|
|
184
|
+
const store = await make();
|
|
185
|
+
const unattributed = await store.recordRules(CONTRACT_TREE, recording([], { actor: "" }));
|
|
186
|
+
const unstamped = await store.recordRules(CONTRACT_TREE, recording([], { recordedAt: "yesterday" }));
|
|
187
|
+
expect(unattributed.ok).toBe(false);
|
|
188
|
+
expect(unstamped.ok).toBe(false);
|
|
189
|
+
expect(await store.rules(CONTRACT_TREE)).toEqual({ ok: true, value: undefined });
|
|
190
|
+
});
|
|
191
|
+
it("reads back a form under the audience that earned it", async () => {
|
|
192
|
+
const store = await make();
|
|
193
|
+
expect(await store.setForm(CONTRACT_TREE, authoring(EU))).toEqual({
|
|
194
|
+
ok: true,
|
|
195
|
+
value: {
|
|
196
|
+
treeId: CONTRACT_TREE,
|
|
197
|
+
audienceId: EU,
|
|
198
|
+
delta: formDelta(),
|
|
199
|
+
actor: "person:ana",
|
|
200
|
+
authoredAt: "2026-11-10T09:00:00.000Z",
|
|
201
|
+
},
|
|
202
|
+
});
|
|
203
|
+
const read = await store.overlay(CONTRACT_TREE);
|
|
204
|
+
expect(read.ok && read.value.forms).toEqual([{ audienceId: EU, delta: formDelta() }]);
|
|
205
|
+
});
|
|
206
|
+
it("replaces an audience's form rather than keeping both, which is what rebasing one is", async () => {
|
|
207
|
+
const store = await make();
|
|
208
|
+
await store.setForm(CONTRACT_TREE, authoring(EU));
|
|
209
|
+
const rebased = formDelta({ baseRevision: 4 });
|
|
210
|
+
await store.setForm(CONTRACT_TREE, authoring(EU, rebased));
|
|
211
|
+
const read = await store.overlay(CONTRACT_TREE);
|
|
212
|
+
expect(read.ok && read.value.forms).toEqual([{ audienceId: EU, delta: rebased }]);
|
|
213
|
+
});
|
|
214
|
+
it("keeps two audiences' forms apart", async () => {
|
|
215
|
+
const store = await make();
|
|
216
|
+
await store.setForm(CONTRACT_TREE, authoring(EU));
|
|
217
|
+
await store.setForm(CONTRACT_TREE, authoring(UK, formDelta({ baseRevision: 5 })));
|
|
218
|
+
const read = await store.overlay(CONTRACT_TREE);
|
|
219
|
+
expect(read.ok && read.value.forms.map((form) => form.audienceId)).toEqual([EU, UK]);
|
|
220
|
+
});
|
|
221
|
+
/**
|
|
222
|
+
* The reading a moved base makes necessary — *a base edit stales every
|
|
223
|
+
* audience delta* — without the deltas, which is the whole reason the
|
|
224
|
+
* listing is a separate read (0359).
|
|
225
|
+
*/
|
|
226
|
+
it("lists a form's base revision without handing over its delta", async () => {
|
|
227
|
+
const store = await make();
|
|
228
|
+
await store.setForm(CONTRACT_TREE, authoring(EU, formDelta({ baseRevision: 7 })));
|
|
229
|
+
expect(await store.forms(CONTRACT_TREE)).toEqual({
|
|
230
|
+
ok: true,
|
|
231
|
+
value: [
|
|
232
|
+
{
|
|
233
|
+
audienceId: EU,
|
|
234
|
+
baseRevision: 7,
|
|
235
|
+
actor: "person:ana",
|
|
236
|
+
authoredAt: "2026-11-10T09:00:00.000Z",
|
|
237
|
+
withdrawn: undefined,
|
|
238
|
+
},
|
|
239
|
+
],
|
|
240
|
+
});
|
|
241
|
+
});
|
|
242
|
+
it("refuses a form carrying a delta for another page, which could never be served", async () => {
|
|
243
|
+
const store = await make();
|
|
244
|
+
const elsewhere = treeIdSchema.parse("t_elsewhere");
|
|
245
|
+
const refused = await store.setForm(CONTRACT_TREE, authoring(EU, formDelta({ treeId: elsewhere })));
|
|
246
|
+
expect(refused).toEqual({
|
|
247
|
+
ok: false,
|
|
248
|
+
error: { code: "tree-mismatch", treeId: CONTRACT_TREE, delta: elsewhere },
|
|
249
|
+
});
|
|
250
|
+
const read = await store.overlay(CONTRACT_TREE);
|
|
251
|
+
expect(read.ok && read.value.forms).toEqual([]);
|
|
252
|
+
});
|
|
253
|
+
/**
|
|
254
|
+
* The act a withdrawal exists for (0403), and the one assertion in this
|
|
255
|
+
* file that is about what a **reader** is served rather than about custody:
|
|
256
|
+
* a segment whose form has been withdrawn composes to the base, because the
|
|
257
|
+
* render path is handed no form for it at all.
|
|
258
|
+
*/
|
|
259
|
+
it("stops serving a withdrawn form, which is how a segment's last change is undone", async () => {
|
|
260
|
+
const store = await make();
|
|
261
|
+
await store.setForm(CONTRACT_TREE, authoring(EU));
|
|
262
|
+
const withdrawn = await store.withdrawForm(CONTRACT_TREE, withdrawing(EU));
|
|
263
|
+
expect(withdrawn.ok && withdrawn.value?.withdrawn).toEqual({
|
|
264
|
+
actor: "person:ben",
|
|
265
|
+
at: "2026-11-11T09:00:00.000Z",
|
|
266
|
+
});
|
|
267
|
+
const read = await store.overlay(CONTRACT_TREE);
|
|
268
|
+
expect(read.ok && read.value.forms).toEqual([]);
|
|
269
|
+
});
|
|
270
|
+
/**
|
|
271
|
+
* The no-delete rule, kept (0376). A withdrawal that deleted the row would
|
|
272
|
+
* pass the assertion above and fail this one, which is the difference that
|
|
273
|
+
* matters: *we stopped serving this* and *we threw the work away* are two
|
|
274
|
+
* acts, and only the first one happened.
|
|
275
|
+
*/
|
|
276
|
+
it("keeps a withdrawn form's delta and its author, so the work is there when it is wanted", async () => {
|
|
277
|
+
const store = await make();
|
|
278
|
+
await store.setForm(CONTRACT_TREE, authoring(EU, formDelta({ baseRevision: 7 })));
|
|
279
|
+
await store.withdrawForm(CONTRACT_TREE, withdrawing(EU));
|
|
280
|
+
expect(await store.forms(CONTRACT_TREE)).toEqual({
|
|
281
|
+
ok: true,
|
|
282
|
+
value: [
|
|
283
|
+
{
|
|
284
|
+
audienceId: EU,
|
|
285
|
+
baseRevision: 7,
|
|
286
|
+
actor: "person:ana",
|
|
287
|
+
authoredAt: "2026-11-10T09:00:00.000Z",
|
|
288
|
+
withdrawn: { actor: "person:ben", at: "2026-11-11T09:00:00.000Z" },
|
|
289
|
+
},
|
|
290
|
+
],
|
|
291
|
+
});
|
|
292
|
+
});
|
|
293
|
+
it("puts a withdrawn form back into service when it is written again", async () => {
|
|
294
|
+
const store = await make();
|
|
295
|
+
await store.setForm(CONTRACT_TREE, authoring(EU));
|
|
296
|
+
await store.withdrawForm(CONTRACT_TREE, withdrawing(EU));
|
|
297
|
+
const again = await store.setForm(CONTRACT_TREE, authoring(EU));
|
|
298
|
+
expect(again.ok && again.value.withdrawn).toBeUndefined();
|
|
299
|
+
const read = await store.overlay(CONTRACT_TREE);
|
|
300
|
+
expect(read.ok && read.value.forms.map((form) => form.audienceId)).toEqual([EU]);
|
|
301
|
+
const listed = await store.forms(CONTRACT_TREE);
|
|
302
|
+
expect(listed.ok && listed.value[0]?.withdrawn).toBeUndefined();
|
|
303
|
+
});
|
|
304
|
+
/**
|
|
305
|
+
* Not an error, because the caller undoing a change wants that segment
|
|
306
|
+
* served the base and a page with no form for it is already in that state.
|
|
307
|
+
* `undefined` rather than a row is how a caller tells the two apart.
|
|
308
|
+
*/
|
|
309
|
+
it("answers nothing, and not an error, for a form the page does not have", async () => {
|
|
310
|
+
const store = await make();
|
|
311
|
+
expect(await store.withdrawForm(CONTRACT_TREE, withdrawing(EU))).toEqual({
|
|
312
|
+
ok: true,
|
|
313
|
+
value: undefined,
|
|
314
|
+
});
|
|
315
|
+
});
|
|
316
|
+
it("restamps a form that is already withdrawn rather than refusing", async () => {
|
|
317
|
+
const store = await make();
|
|
318
|
+
await store.setForm(CONTRACT_TREE, authoring(EU));
|
|
319
|
+
await store.withdrawForm(CONTRACT_TREE, withdrawing(EU));
|
|
320
|
+
const again = await store.withdrawForm(CONTRACT_TREE, withdrawing(EU, { actor: "person:cat", withdrawnAt: "2026-11-12T09:00:00.000Z" }));
|
|
321
|
+
expect(again.ok && again.value?.withdrawn).toEqual({
|
|
322
|
+
actor: "person:cat",
|
|
323
|
+
at: "2026-11-12T09:00:00.000Z",
|
|
324
|
+
});
|
|
325
|
+
});
|
|
326
|
+
it("withdraws one audience's form and leaves the other's being served", async () => {
|
|
327
|
+
const store = await make();
|
|
328
|
+
await store.setForm(CONTRACT_TREE, authoring(EU));
|
|
329
|
+
await store.setForm(CONTRACT_TREE, authoring(UK));
|
|
330
|
+
await store.withdrawForm(CONTRACT_TREE, withdrawing(EU));
|
|
331
|
+
const read = await store.overlay(CONTRACT_TREE);
|
|
332
|
+
expect(read.ok && read.value.forms.map((form) => form.audienceId)).toEqual([UK]);
|
|
333
|
+
const listed = await store.forms(CONTRACT_TREE);
|
|
334
|
+
expect(listed.ok && listed.value.map((form) => form.audienceId)).toEqual([EU, UK]);
|
|
335
|
+
});
|
|
336
|
+
it("withdraws under one page without touching another's form for the same audience", async () => {
|
|
337
|
+
const store = await make();
|
|
338
|
+
const other = treeIdSchema.parse("t_otherpage");
|
|
339
|
+
await store.setForm(CONTRACT_TREE, authoring(EU));
|
|
340
|
+
await store.setForm(other, authoring(EU, formDelta({ treeId: other })));
|
|
341
|
+
await store.withdrawForm(CONTRACT_TREE, withdrawing(EU));
|
|
342
|
+
const read = await store.overlay(other);
|
|
343
|
+
expect(read.ok && read.value.forms.map((form) => form.audienceId)).toEqual([EU]);
|
|
344
|
+
});
|
|
345
|
+
it("keeps one page's rules and forms out of another's", async () => {
|
|
346
|
+
const store = await make();
|
|
347
|
+
const other = treeIdSchema.parse("t_otherpage");
|
|
348
|
+
await store.recordRules(CONTRACT_TREE, recording([ruleFor(EU, "region", "eu")]));
|
|
349
|
+
await store.setForm(CONTRACT_TREE, authoring(EU));
|
|
350
|
+
expect(await store.overlay(other)).toEqual({ ok: true, value: { rules: [], forms: [] } });
|
|
351
|
+
});
|
|
352
|
+
});
|
|
353
|
+
};
|
|
354
|
+
//# sourceMappingURL=audience-overlay-contract.js.map
|
|
@@ -2,13 +2,16 @@
|
|
|
2
2
|
* The suites a host runs against its own implementation, published as
|
|
3
3
|
* `@jam-overture/loom/testing/contracts`.
|
|
4
4
|
*
|
|
5
|
-
* A `TreeStore`, a `HoldStore` and a `
|
|
6
|
-
* an in-memory implementation of each and a Postgres one, and a host
|
|
7
|
-
* expected to be able to write a third.
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
5
|
+
* A `TreeStore`, a `HoldStore`, a `TelemetryJournal` and a `PolicyLog` are seams:
|
|
6
|
+
* Loom ships an in-memory implementation of each and a Postgres one, and a host
|
|
7
|
+
* is expected to be able to write a third. A `ModelClient` is the same kind of
|
|
8
|
+
* thing one step further out — Loom ships *one* implementation of it, and 0005
|
|
9
|
+
* made even that one opt-in so a host could bring its own. What it cannot do from
|
|
10
|
+
* outside this repository is find out whether the third one is *right*. The
|
|
11
|
+
* promises are not in the type — an append is ordered, a hold is exclusive, a
|
|
12
|
+
* journal is append-only, a policy's revisions are dense and attributed — and a
|
|
13
|
+
* host discovering each of them from a production incident is the seam being
|
|
14
|
+
* offered without the thing that makes it safe to take.
|
|
12
15
|
*
|
|
13
16
|
* So the suite this package runs against its own two implementations is the
|
|
14
17
|
* suite it hands anybody writing a third. It is the same code, not a
|
|
@@ -27,8 +30,11 @@
|
|
|
27
30
|
* reason — it asks a live Postgres about a table, so it needs `drizzle-orm`,
|
|
28
31
|
* which the Postgres suites already do.
|
|
29
32
|
*/
|
|
33
|
+
export { audienceNamed, CONTRACT_TREE, describeAudienceOverlayStoreContract, formDelta, ruleFor, } from "./audience-overlay-contract.js";
|
|
30
34
|
export { describeHoldStoreContract, heldProposalFixture } from "./hold-contract.js";
|
|
35
|
+
export { CONTRACT_REPLY, CONTRACT_SERVED_BY, contractRequest, describeModelClientContract, MODEL_SITUATIONS, type ModelClientContract, type ModelSituation, type ModelSituationClient, } from "./model-contract.js";
|
|
31
36
|
export { describeTelemetryJournalContract, sampleEpisode } from "./journal-contract.js";
|
|
37
|
+
export { describePolicyLogContract, policyNamed, recordingOf } from "./policy-log-contract.js";
|
|
32
38
|
export { rowSecurityOn } from "./row-security.js";
|
|
33
39
|
export { appendOf, describeTreeStoreContract, removalOf, treeNamed, } from "./store-contract.js";
|
|
34
40
|
//# sourceMappingURL=contracts.d.ts.map
|
|
@@ -2,13 +2,16 @@
|
|
|
2
2
|
* The suites a host runs against its own implementation, published as
|
|
3
3
|
* `@jam-overture/loom/testing/contracts`.
|
|
4
4
|
*
|
|
5
|
-
* A `TreeStore`, a `HoldStore` and a `
|
|
6
|
-
* an in-memory implementation of each and a Postgres one, and a host
|
|
7
|
-
* expected to be able to write a third.
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
5
|
+
* A `TreeStore`, a `HoldStore`, a `TelemetryJournal` and a `PolicyLog` are seams:
|
|
6
|
+
* Loom ships an in-memory implementation of each and a Postgres one, and a host
|
|
7
|
+
* is expected to be able to write a third. A `ModelClient` is the same kind of
|
|
8
|
+
* thing one step further out — Loom ships *one* implementation of it, and 0005
|
|
9
|
+
* made even that one opt-in so a host could bring its own. What it cannot do from
|
|
10
|
+
* outside this repository is find out whether the third one is *right*. The
|
|
11
|
+
* promises are not in the type — an append is ordered, a hold is exclusive, a
|
|
12
|
+
* journal is append-only, a policy's revisions are dense and attributed — and a
|
|
13
|
+
* host discovering each of them from a production incident is the seam being
|
|
14
|
+
* offered without the thing that makes it safe to take.
|
|
12
15
|
*
|
|
13
16
|
* So the suite this package runs against its own two implementations is the
|
|
14
17
|
* suite it hands anybody writing a third. It is the same code, not a
|
|
@@ -27,8 +30,11 @@
|
|
|
27
30
|
* reason — it asks a live Postgres about a table, so it needs `drizzle-orm`,
|
|
28
31
|
* which the Postgres suites already do.
|
|
29
32
|
*/
|
|
33
|
+
export { audienceNamed, CONTRACT_TREE, describeAudienceOverlayStoreContract, formDelta, ruleFor, } from "./audience-overlay-contract.js";
|
|
30
34
|
export { describeHoldStoreContract, heldProposalFixture } from "./hold-contract.js";
|
|
35
|
+
export { CONTRACT_REPLY, CONTRACT_SERVED_BY, contractRequest, describeModelClientContract, MODEL_SITUATIONS, } from "./model-contract.js";
|
|
31
36
|
export { describeTelemetryJournalContract, sampleEpisode } from "./journal-contract.js";
|
|
37
|
+
export { describePolicyLogContract, policyNamed, recordingOf } from "./policy-log-contract.js";
|
|
32
38
|
export { rowSecurityOn } from "./row-security.js";
|
|
33
39
|
export { appendOf, describeTreeStoreContract, removalOf, treeNamed, } from "./store-contract.js";
|
|
34
40
|
//# sourceMappingURL=contracts.js.map
|
|
@@ -12,4 +12,82 @@ export declare const testDefinitions: readonly PrimitiveEntry[];
|
|
|
12
12
|
*/
|
|
13
13
|
export declare const registryOf: (entries: readonly PrimitiveEntry[]) => PrimitiveRegistry;
|
|
14
14
|
export declare const testRegistry: () => PrimitiveRegistry;
|
|
15
|
+
/**
|
|
16
|
+
* The ways a primitive's declaration of what it could not show can fail to be
|
|
17
|
+
* believed, named for what the author's code did rather than for the sentence
|
|
18
|
+
* the runtime writes about it.
|
|
19
|
+
*
|
|
20
|
+
* `throws` is the fault `UnshownFault` calls `threw`. The other six are its
|
|
21
|
+
* `impossible` arm, which is one kind carrying six details — and the details
|
|
22
|
+
* are what a lane demonstrating the diagnostic needs, because the kind is the
|
|
23
|
+
* same word for a declaration that returned a number and one that said it
|
|
24
|
+
* showed thirteen of twelve rows.
|
|
25
|
+
*/
|
|
26
|
+
declare const BREAKAGES: readonly ["throws", "not-an-array", "not-a-reading", "unnamed", "uncountable-given", "uncountable-shown", "more-shown-than-given"];
|
|
27
|
+
export type UnshownBreakage = (typeof BREAKAGES)[number];
|
|
28
|
+
/**
|
|
29
|
+
* Every breakage, in the order `readUnshown` refuses them, so a lane showing
|
|
30
|
+
* the fault once per shape can iterate rather than keep its own list.
|
|
31
|
+
*
|
|
32
|
+
* The list is the type rather than a copy of it: `UnshownBreakage` is read off
|
|
33
|
+
* these entries and `BROKEN_DECLARATIONS` is keyed on the type, so a member
|
|
34
|
+
* added here without a declaration, or a declaration without a member, is a
|
|
35
|
+
* typecheck error rather than a gap.
|
|
36
|
+
*
|
|
37
|
+
* **What is maintained rather than proved is the other direction** — against the
|
|
38
|
+
* runtime. No construction here makes a refusal path added to `readUnshown`
|
|
39
|
+
* with nothing added to this list fail a test, so this door could fall one fault
|
|
40
|
+
* behind the walk it stands in for, silently. `definitions.test.ts` holds the
|
|
41
|
+
* next best thing: every member is refused, no two members produce the same
|
|
42
|
+
* fault, and each detail is pinned to the exact sentence the runtime writes — so
|
|
43
|
+
* a message that moves goes red here and somebody looks at the list.
|
|
44
|
+
*/
|
|
45
|
+
export declare const UNSHOWN_BREAKAGES: readonly UnshownBreakage[];
|
|
46
|
+
/**
|
|
47
|
+
* A primitive that breaks the one declaration no tree and no deployment can
|
|
48
|
+
* break for it, in whichever way the caller names.
|
|
49
|
+
*
|
|
50
|
+
* `unshown-unreadable` is the single member of `RenderDiagnostic` addressed to
|
|
51
|
+
* whoever wrote the component (0206): the declaration lives *inside* the
|
|
52
|
+
* primitive, so only a primitive can break it. Nothing in the starter library
|
|
53
|
+
* does — all five that declare `unshown` compute the figure from the answer
|
|
54
|
+
* they were handed, which is the whole point of declaring the function the
|
|
55
|
+
* component already calls — and neither `testPrimitives` nor
|
|
56
|
+
* `undecoratedPrimitive` stood in for one. So every lane wanting to demonstrate
|
|
57
|
+
* the code wrote its own broken component, and `Loom docs` wrote one for *What
|
|
58
|
+
* a render reports* before filing for this.
|
|
59
|
+
*
|
|
60
|
+
* **One parameterised stand-in rather than a catalogue of broken components**,
|
|
61
|
+
* which is what the filing asked for in those words: a catalogue in the testing
|
|
62
|
+
* door would be a second library to keep true.
|
|
63
|
+
*
|
|
64
|
+
* Well-behaved in every other respect, deliberately. It spreads
|
|
65
|
+
* `loom.editable`, places what it is handed, and declares its props — so the
|
|
66
|
+
* one thing wrong with it is the thing the caller asked to be wrong, and a
|
|
67
|
+
* render of it raises exactly one diagnostic.
|
|
68
|
+
*
|
|
69
|
+
* Its props are declared **open**, where `loom.card` next door is strict, and
|
|
70
|
+
* that is the one place this fixture prefers forgiveness to realism: props the
|
|
71
|
+
* schema refuses omit the node altogether, which would take the declaration
|
|
72
|
+
* with them and hand a lane an empty diagnostic list instead of the fault it
|
|
73
|
+
* asked for. A stand-in that can be silenced by an unrelated prop is a stand-in
|
|
74
|
+
* that will be.
|
|
75
|
+
*
|
|
76
|
+
* The type carries the breakage, so all seven can be registered together and
|
|
77
|
+
* rendered in one tree. Read it off the entry rather than writing it out:
|
|
78
|
+
*
|
|
79
|
+
* ```ts
|
|
80
|
+
* const definition = brokenUnshownDefinition("throws")
|
|
81
|
+
* const registry = registryOf([definition])
|
|
82
|
+
* // …then a node of `definition.type` carrying a `loom:data` declaration.
|
|
83
|
+
* ```
|
|
84
|
+
*
|
|
85
|
+
* It declares no `reads`, and that absence is load-bearing. A declared name the
|
|
86
|
+
* caller did not answer under would add `data-unread` to the render, so the
|
|
87
|
+
* list a lane asserts would depend on which name it chose to answer. Silent
|
|
88
|
+
* unless declared is the bargain `reads` makes, and taking it is what keeps the
|
|
89
|
+
* one-diagnostic promise above true whatever the caller does.
|
|
90
|
+
*/
|
|
91
|
+
export declare const brokenUnshownDefinition: (breakage: UnshownBreakage) => PrimitiveEntry;
|
|
92
|
+
export {};
|
|
15
93
|
//# sourceMappingURL=definitions.d.ts.map
|