@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,231 @@
|
|
|
1
|
+
import { everyMemberOf } from "../closed-set.js";
|
|
2
|
+
import { audienceScopeOf, audiencesIn } from "./audiences.js";
|
|
3
|
+
import { atDoorScale, doorOf } from "./door.js";
|
|
4
|
+
import { pageViewsFor } from "./page-views.js";
|
|
5
|
+
export const FUNNEL_STAGES = everyMemberOf()([
|
|
6
|
+
"before",
|
|
7
|
+
"between",
|
|
8
|
+
]);
|
|
9
|
+
/** One line per stage, for a surface putting the reading in front of a person. */
|
|
10
|
+
export const describeFunnelStage = (stage) => {
|
|
11
|
+
switch (stage) {
|
|
12
|
+
case "before":
|
|
13
|
+
return "most of the readers lost never got to the start of this funnel";
|
|
14
|
+
case "between":
|
|
15
|
+
return "most of the readers lost got to the start of this funnel and did not finish it";
|
|
16
|
+
}
|
|
17
|
+
};
|
|
18
|
+
export const END_STANDINGS = everyMemberOf()([
|
|
19
|
+
"present",
|
|
20
|
+
"absent",
|
|
21
|
+
]);
|
|
22
|
+
/** One line per standing, for a surface putting the reading in front of a person. */
|
|
23
|
+
export const describeEndStanding = (standing) => {
|
|
24
|
+
switch (standing) {
|
|
25
|
+
case "present":
|
|
26
|
+
return "this revision still has the part the question names";
|
|
27
|
+
case "absent":
|
|
28
|
+
return "this revision has no part with that id, so the question is stale";
|
|
29
|
+
}
|
|
30
|
+
};
|
|
31
|
+
const NOTHING_SHARED = {
|
|
32
|
+
share: null,
|
|
33
|
+
atMost: null,
|
|
34
|
+
readers: null,
|
|
35
|
+
atMostReaders: null,
|
|
36
|
+
};
|
|
37
|
+
const endKey = (end) => `${end.nodeId} ${end.kind}`;
|
|
38
|
+
/**
|
|
39
|
+
* What makes two funnel rows the same question: the two nodes a deployment
|
|
40
|
+
* named, in the two kinds it named them with.
|
|
41
|
+
*
|
|
42
|
+
* Published rather than private because a second reading needs the same rule —
|
|
43
|
+
* a comparison of two windows pairs its rows by it — and two spellings of one
|
|
44
|
+
* identity is what the counter keys were before `counters.ts` wrote them once,
|
|
45
|
+
* and what the door's scale was before `door.ts` did. It is also the rule that
|
|
46
|
+
* decides what a **duplicate** row is, which 0158 makes permanent if it is got
|
|
47
|
+
* wrong in either place.
|
|
48
|
+
*
|
|
49
|
+
* Deliberately not the node ids alone: a pair asking `viewed → completed` and
|
|
50
|
+
* one asking `viewed → activated` over the same two nodes are two questions,
|
|
51
|
+
* and a reading that collapsed them would hold one window's conversions
|
|
52
|
+
* against another window's presses.
|
|
53
|
+
*/
|
|
54
|
+
export const funnelPairKey = (pair) => `${endKey(pair.from)} ${endKey(pair.to)}`;
|
|
55
|
+
const shareOf = (count, of, drawable) => {
|
|
56
|
+
if (!drawable)
|
|
57
|
+
return NOTHING_SHARED;
|
|
58
|
+
return {
|
|
59
|
+
share: count / of.appearances,
|
|
60
|
+
atMost: Math.min(1, count / of.opened),
|
|
61
|
+
readers: of.pending > 0 ? null : (count * of.opened) / of.appearances,
|
|
62
|
+
atMostReaders: Math.min(count, of.opened),
|
|
63
|
+
};
|
|
64
|
+
};
|
|
65
|
+
/**
|
|
66
|
+
* The most the true rate could be, with both of the straddle's worst cases
|
|
67
|
+
* applied: every conversion it could have lost recovered into the numerator,
|
|
68
|
+
* and every duplicate it could have made taken out of the denominator.
|
|
69
|
+
*
|
|
70
|
+
* **The recovery deliberately has no cap of its own**, and that is worth a
|
|
71
|
+
* sentence because the obvious shape has one. A recovered conversion cannot be
|
|
72
|
+
* one the row already counted, so the honest numerator looks like
|
|
73
|
+
* `converted + min(drift, reached − converted)` — and that clause can never
|
|
74
|
+
* change the result. The two spellings differ only where
|
|
75
|
+
* `converted + drift > reached`, and there both numerators are above the
|
|
76
|
+
* denominator, so both are capped at 1. A clause that cannot be observed is a
|
|
77
|
+
* clause nothing could falsify, so the cap at 1 is the whole of it.
|
|
78
|
+
*
|
|
79
|
+
* The denominator is floored at 1 rather than at `converted`, for the same
|
|
80
|
+
* reason: it only has to keep the division defined.
|
|
81
|
+
*/
|
|
82
|
+
const rateCeilingOf = (reached, converted, drift) => Math.min(1, (converted + drift) / Math.max(1, reached - drift));
|
|
83
|
+
/**
|
|
84
|
+
* The readers a pair loses between its two ends, at each end of the rate's own
|
|
85
|
+
* interval, on the scale the page's door counts in.
|
|
86
|
+
*
|
|
87
|
+
* **Both ends are one expression over two rates**, which is the whole of why
|
|
88
|
+
* they can be compared: the reach is put on the door's scale once and then taken
|
|
89
|
+
* at each bound of the rate. Spelling the ceiling as the loss instead —
|
|
90
|
+
* `atDoorScale(reached − converted)`, which is the same number — is the shape
|
|
91
|
+
* that looks more direct and is wrong, because at a drift of nought
|
|
92
|
+
* `reached × (1 − converted ÷ reached)` and `reached − converted` differ in the
|
|
93
|
+
* last place for three readers out of three and one conversion. A floor four
|
|
94
|
+
* hundred-quadrillionths above its own ceiling is a floor that is not one.
|
|
95
|
+
*
|
|
96
|
+
* Only ever called where the door can scale, which is what `drawable` means at
|
|
97
|
+
* the call site.
|
|
98
|
+
*/
|
|
99
|
+
const leakOf = (reached, rate, rateAtMost, of) => {
|
|
100
|
+
const atDoor = atDoorScale(reached, of);
|
|
101
|
+
return { atLeast: atDoor * (1 - rateAtMost), atMost: atDoor * (1 - rate) };
|
|
102
|
+
};
|
|
103
|
+
const standingIn = (parts, end) => parts.has(end.nodeId) ? "present" : "absent";
|
|
104
|
+
const reachOf = (row, of, silenced, ends) => {
|
|
105
|
+
const { reached, converted } = row;
|
|
106
|
+
const unreconciled = !silenced && reached > of.appearances;
|
|
107
|
+
const drawable = !silenced && !unreconciled;
|
|
108
|
+
/**
|
|
109
|
+
* The two gates are separate because they withhold for different reasons: a
|
|
110
|
+
* silence means there is no denominator, and an absent end means there is no
|
|
111
|
+
* question. `rate` needs only the second, which is why it survives a silence
|
|
112
|
+
* and not a stale end.
|
|
113
|
+
*/
|
|
114
|
+
const fromAsked = ends.from === "present";
|
|
115
|
+
const bothAsked = fromAsked && ends.to === "present";
|
|
116
|
+
const lost = of.appearances - reached;
|
|
117
|
+
const between = reached - converted;
|
|
118
|
+
const rate = bothAsked && reached > 0 ? converted / reached : null;
|
|
119
|
+
const rateAtMost = bothAsked && !silenced && reached > 0 ? rateCeilingOf(reached, converted, of.drift) : null;
|
|
120
|
+
return {
|
|
121
|
+
pair: row.pair,
|
|
122
|
+
reached,
|
|
123
|
+
converted,
|
|
124
|
+
updatedAt: row.updatedAt,
|
|
125
|
+
ends,
|
|
126
|
+
stale: !bothAsked,
|
|
127
|
+
orphaned: (!fromAsked && reached > 0) || (ends.to === "absent" && converted > 0),
|
|
128
|
+
rate,
|
|
129
|
+
rateAtMost,
|
|
130
|
+
/**
|
|
131
|
+
* Under `drawable` the two rates are null together — a silence is the only
|
|
132
|
+
* thing the ceiling withholds for that the floor does not — so the second
|
|
133
|
+
* check is the narrowing and not a second case.
|
|
134
|
+
*/
|
|
135
|
+
leak: drawable && rate !== null && rateAtMost !== null ? leakOf(reached, rate, rateAtMost, of) : null,
|
|
136
|
+
entry: shareOf(reached, of, drawable && fromAsked),
|
|
137
|
+
conversion: shareOf(converted, of, drawable && bothAsked),
|
|
138
|
+
lostBefore: drawable && fromAsked ? lost / of.appearances : null,
|
|
139
|
+
lostBetween: drawable && bothAsked ? between / of.appearances : null,
|
|
140
|
+
worse: drawable && bothAsked && lost !== between ? (lost > between ? "before" : "between") : null,
|
|
141
|
+
unreconciled,
|
|
142
|
+
};
|
|
143
|
+
};
|
|
144
|
+
/**
|
|
145
|
+
* Read a revision's funnels against the readers that revision had, and against
|
|
146
|
+
* the tree that revision is.
|
|
147
|
+
*
|
|
148
|
+
* **The reading is the revision.** Handing in a `PageReading` rather than a
|
|
149
|
+
* tree id and a number keeps the property 0231 recorded — the revision is
|
|
150
|
+
* handed in rather than inferred, and both sets of rows are filtered to it here
|
|
151
|
+
* rather than trusted — and closes the gap it left: a caller can no longer name
|
|
152
|
+
* one revision and hold another revision's tree, because there is only the one
|
|
153
|
+
* object. The two mistakes that would make every figure quietly wrong are a row
|
|
154
|
+
* from the wrong revision and a row counted twice, and the third is a question
|
|
155
|
+
* asked of a page that has not had those nodes since March.
|
|
156
|
+
*
|
|
157
|
+
* Linear in the pairs, the page-view rows and the reading's parts, with one
|
|
158
|
+
* pass over each.
|
|
159
|
+
*/
|
|
160
|
+
export const funnelReachOf = (reading, funnels, rows) => {
|
|
161
|
+
const where = {
|
|
162
|
+
treeId: reading.treeId,
|
|
163
|
+
revision: reading.revision,
|
|
164
|
+
audienceId: reading.audienceId,
|
|
165
|
+
};
|
|
166
|
+
const { measured, foreign, duplicated } = pageViewsFor(where, rows);
|
|
167
|
+
const of = doorOf(measured);
|
|
168
|
+
const { opened, appearances, drift, pending } = of;
|
|
169
|
+
const silence = of.silence;
|
|
170
|
+
const { inflation, updatedAt } = measured ?? { inflation: null, updatedAt: null };
|
|
171
|
+
const here = funnels.filter((row) => row.treeId === where.treeId && row.revision === where.revision);
|
|
172
|
+
/**
|
|
173
|
+
* A funnel pair is asked of a page, and a page served in two forms answers
|
|
174
|
+
* it twice — one row per audience (0284), the same two ends, two different
|
|
175
|
+
* populations. Scoped to the reading's own audience so the other form's
|
|
176
|
+
* answer is neither taken as this one's nor counted as the same question
|
|
177
|
+
* asked twice, which is what `duplicatedPairs` means and what a double count
|
|
178
|
+
* makes permanent (0158) if the two are confused.
|
|
179
|
+
*
|
|
180
|
+
* **A window of two forms with none asked for is read as neither**, which the
|
|
181
|
+
* scope makes a case rather than the `null` it was. The populations are those
|
|
182
|
+
* of the reading and of these rows together: a reading of one form held
|
|
183
|
+
* against funnel rows of two is as ambiguous as the reverse, and both were
|
|
184
|
+
* reachable.
|
|
185
|
+
*/
|
|
186
|
+
const scope = audienceScopeOf([...reading.audiences, ...audiencesIn(here)], where.audienceId ?? undefined);
|
|
187
|
+
const mixed = scope.reading === "mixed";
|
|
188
|
+
const matching = mixed
|
|
189
|
+
? []
|
|
190
|
+
: scope.audienceId === null
|
|
191
|
+
? here
|
|
192
|
+
: here.filter((row) => row.audienceId === scope.audienceId);
|
|
193
|
+
const present = new Set(reading.parts.map((part) => part.nodeId));
|
|
194
|
+
const seen = new Set();
|
|
195
|
+
const pairs = matching
|
|
196
|
+
.filter((row) => {
|
|
197
|
+
const key = funnelPairKey(row.pair);
|
|
198
|
+
if (seen.has(key))
|
|
199
|
+
return false;
|
|
200
|
+
seen.add(key);
|
|
201
|
+
return true;
|
|
202
|
+
})
|
|
203
|
+
.sort((one, other) => funnelPairKey(one.pair).localeCompare(funnelPairKey(other.pair)))
|
|
204
|
+
.map((row) => reachOf(row, of, silence !== null, {
|
|
205
|
+
from: standingIn(present, row.pair.from),
|
|
206
|
+
to: standingIn(present, row.pair.to),
|
|
207
|
+
}));
|
|
208
|
+
return {
|
|
209
|
+
treeId: where.treeId,
|
|
210
|
+
revision: where.revision,
|
|
211
|
+
audienceId: where.audienceId,
|
|
212
|
+
audiences: scope.audiences,
|
|
213
|
+
opened,
|
|
214
|
+
appearances,
|
|
215
|
+
drift,
|
|
216
|
+
pending,
|
|
217
|
+
inflation,
|
|
218
|
+
updatedAt,
|
|
219
|
+
silence,
|
|
220
|
+
exact: silence === null && appearances === opened,
|
|
221
|
+
pairs,
|
|
222
|
+
foreign,
|
|
223
|
+
duplicated,
|
|
224
|
+
foreignPairs: funnels.length - here.length,
|
|
225
|
+
otherAudiencePairs: here.length - matching.length,
|
|
226
|
+
duplicatedPairs: matching.length - pairs.length,
|
|
227
|
+
stalePairs: pairs.filter((pair) => pair.stale).length,
|
|
228
|
+
orphanedPairs: pairs.filter((pair) => pair.orphaned).length,
|
|
229
|
+
};
|
|
230
|
+
};
|
|
231
|
+
//# sourceMappingURL=funnel.js.map
|