@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,97 @@
|
|
|
1
|
+
import type { AudienceId } from "../audience/audience.js";
|
|
2
|
+
import type { ActedHourCount } from "./acted.js";
|
|
3
|
+
import type { FunnelHourCount } from "./funnel-hours.js";
|
|
4
|
+
import type { ArrivalHourCount } from "./arrivals.js";
|
|
5
|
+
import type { ReaderRegionCount } from "./region.js";
|
|
6
|
+
import type { FunnelAnswer, ReaderTally } from "./rollup.js";
|
|
7
|
+
import type { RevisionViews } from "./page-views.js";
|
|
8
|
+
export declare const pageViewKey: (count: RevisionViews) => string;
|
|
9
|
+
export declare const tallyKey: (tally: ReaderTally) => string;
|
|
10
|
+
export declare const funnelKey: (answer: FunnelAnswer) => string;
|
|
11
|
+
export declare const regionKey: (count: ReaderRegionCount) => string;
|
|
12
|
+
/**
|
|
13
|
+
* A revision and an hour.
|
|
14
|
+
*
|
|
15
|
+
* The fourth counter the door writes and the second it composes by hand: one
|
|
16
|
+
* delivery's openings all carry the same hour, so two of these can only collide
|
|
17
|
+
* where a delivery opened page views of one revision twice over — which
|
|
18
|
+
* `openingsOf` has already folded. The key is here anyway, with the other
|
|
19
|
+
* three, because *today's callers cannot emit a duplicate* is a property of
|
|
20
|
+
* today's callers (see the note above).
|
|
21
|
+
*/
|
|
22
|
+
export declare const arrivalKey: (count: ArrivalHourCount) => string;
|
|
23
|
+
/**
|
|
24
|
+
* A revision, a part and an hour, which is the fifth counter and the second
|
|
25
|
+
* with a clock in its key (`acted.ts`).
|
|
26
|
+
*
|
|
27
|
+
* The hour is last for the reason it is last in the table's primary key: a
|
|
28
|
+
* reading of one part over a range is a prefix of this, and a reading of one
|
|
29
|
+
* hour across a page is the index beside it.
|
|
30
|
+
*/
|
|
31
|
+
export declare const actedKey: (count: ActedHourCount) => string;
|
|
32
|
+
/**
|
|
33
|
+
* A revision, a pair's two ends and an hour, which is the sixth counter and the
|
|
34
|
+
* third with a clock in its key (`funnel-hours.ts`).
|
|
35
|
+
*
|
|
36
|
+
* The ends are spelled by `endOf` above, so the hourly row and the total row
|
|
37
|
+
* agree about what makes two funnels the same question — the identity 0158
|
|
38
|
+
* makes permanent if the two places disagree about it.
|
|
39
|
+
*/
|
|
40
|
+
export declare const funnelHourKey: (count: FunnelHourCount) => string;
|
|
41
|
+
/**
|
|
42
|
+
* The same counter, in one audience (0284).
|
|
43
|
+
*
|
|
44
|
+
* The four keys above identify a counter *within* one audience, which is all a
|
|
45
|
+
* fold in front of the driver needs: `apply` and `count` are handed one
|
|
46
|
+
* audience's rows per call, so two entries sharing a key in one call are the
|
|
47
|
+
* same row however many audiences the window held.
|
|
48
|
+
*
|
|
49
|
+
* A store that keeps its rows across calls needs more than that, and only the
|
|
50
|
+
* memory one does — Postgres has the audience in the primary key, so the
|
|
51
|
+
* database is already holding two audiences apart. This is the memory store's
|
|
52
|
+
* half of that same identity, and it is **here rather than beside it** for the
|
|
53
|
+
* reason the rest of this file is: two spellings of a key that agree today are
|
|
54
|
+
* the shape this subsystem has already been bitten by.
|
|
55
|
+
*/
|
|
56
|
+
export declare const inAudience: (audience: AudienceId, key: string) => string;
|
|
57
|
+
/**
|
|
58
|
+
* Rows that name the same counter, added together, in the order they arrived.
|
|
59
|
+
*
|
|
60
|
+
* Stable in two ways that matter: a row's first appearance fixes its position,
|
|
61
|
+
* so a fold never reorders a caller's list, and `add` is handed the standing row
|
|
62
|
+
* first — so a non-additive column written by `add` keeps the same winner as the
|
|
63
|
+
* `excluded.*` the upsert would have applied.
|
|
64
|
+
*/
|
|
65
|
+
export declare const foldedBy: <Row>(rows: readonly Row[], key: (row: Row) => string, add: (standing: Row, next: Row) => Row) => readonly Row[];
|
|
66
|
+
/** The two numbers a page-view count carries, which is one. */
|
|
67
|
+
export declare const addPageViewCounts: (standing: RevisionViews, next: RevisionViews) => RevisionViews;
|
|
68
|
+
/**
|
|
69
|
+
* Every counter on a tally, added.
|
|
70
|
+
*
|
|
71
|
+
* `type` is the one column that is not a number, and the later row wins it —
|
|
72
|
+
* which is what `SET type = excluded.type` does and what the memory store's
|
|
73
|
+
* spread does, so the fold does not become a third answer.
|
|
74
|
+
*/
|
|
75
|
+
export declare const addTallies: (standing: ReaderTally, next: ReaderTally) => ReaderTally;
|
|
76
|
+
export declare const addFunnelAnswers: (standing: FunnelAnswer, next: FunnelAnswer) => FunnelAnswer;
|
|
77
|
+
/** Page views that began in one hour, added. */
|
|
78
|
+
export declare const addArrivalCounts: (standing: ArrivalHourCount, next: ArrivalHourCount) => ArrivalHourCount;
|
|
79
|
+
/**
|
|
80
|
+
* What readers did to one part in one hour, added.
|
|
81
|
+
*
|
|
82
|
+
* `type` is the one column that is not a number and the later row wins it,
|
|
83
|
+
* which is what `SET type = excluded.type` does — so the fold in front of the
|
|
84
|
+
* driver does not become a third answer.
|
|
85
|
+
*/
|
|
86
|
+
export declare const addActedCounts: (standing: ActedHourCount, next: ActedHourCount) => ActedHourCount;
|
|
87
|
+
/**
|
|
88
|
+
* One pair's hour, added.
|
|
89
|
+
*
|
|
90
|
+
* Both numbers are distinct counts of page views, which they may be here for
|
|
91
|
+
* the one reason `funnel-hours.ts` gives at length: a view is filed under a
|
|
92
|
+
* single hour, so two rows naming one pair-hour are two folds' worth of
|
|
93
|
+
* disjoint cohorts and adding them is exact rather than generous.
|
|
94
|
+
*/
|
|
95
|
+
export declare const addFunnelHourCounts: (standing: FunnelHourCount, next: FunnelHourCount) => FunnelHourCount;
|
|
96
|
+
export declare const addRegionCounts: (standing: ReaderRegionCount, next: ReaderRegionCount) => ReaderRegionCount;
|
|
97
|
+
//# sourceMappingURL=counters.d.ts.map
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What identifies a counter row, and the addition that folds two of them.
|
|
3
|
+
*
|
|
4
|
+
* Internal to the stores and deliberately not re-exported from
|
|
5
|
+
* `@jam-overture/loom/signals`: it exists so that the two implementations
|
|
6
|
+
* cannot drift on either half, not because a deployment has a question it
|
|
7
|
+
* answers.
|
|
8
|
+
*
|
|
9
|
+
* ## Why a fold in front of the driver
|
|
10
|
+
*
|
|
11
|
+
* `ON CONFLICT … DO UPDATE` **refuses to affect one row twice in a single
|
|
12
|
+
* command** — Postgres raises rather than applying the second value. The memory
|
|
13
|
+
* store writes through a `Map` and so adds a duplicate key without noticing. So
|
|
14
|
+
* two counts of the same row inside one call behaved differently in the two
|
|
15
|
+
* implementations: the memory store added them and Postgres refused the whole
|
|
16
|
+
* write. That is a disagreement between implementations rather than a limit of
|
|
17
|
+
* either, and what it would have cost depended entirely on which counter it
|
|
18
|
+
* reached — an `apply` that fails is loud and forgets nothing, a bucket at the
|
|
19
|
+
* door that silently did not move is reported in a delivery's outcome and
|
|
20
|
+
* nowhere else.
|
|
21
|
+
*
|
|
22
|
+
* The contract suite found it on the page views, which is the one counter a
|
|
23
|
+
* caller composes by hand rather than reads off a rollup's map. Every other
|
|
24
|
+
* producer in the repository keys its output by map first and so cannot emit a
|
|
25
|
+
* duplicate — which is a property of today's callers and not of the interface
|
|
26
|
+
* they are writing to. So the addition happens once, in front of the driver,
|
|
27
|
+
* for all four counters.
|
|
28
|
+
*
|
|
29
|
+
* **The keys are here rather than beside each store** because the guarantee is
|
|
30
|
+
* that the two stores agree about what one row is. Two spellings of a key that
|
|
31
|
+
* are the same today are the shape this subsystem has already been bitten by.
|
|
32
|
+
*/
|
|
33
|
+
/** A revision, which is the two columns every counter here shares. */
|
|
34
|
+
const revisionKey = (row) => `${row.treeId} ${row.revision}`;
|
|
35
|
+
export const pageViewKey = (count) => revisionKey(count);
|
|
36
|
+
export const tallyKey = (tally) => `${revisionKey(tally)} ${tally.nodeId}`;
|
|
37
|
+
const endOf = (end) => `${end.nodeId}:${end.kind}`;
|
|
38
|
+
export const funnelKey = (answer) => `${revisionKey(answer)} ${endOf(answer.pair.from)} ${endOf(answer.pair.to)}`;
|
|
39
|
+
export const regionKey = (count) => `${revisionKey(count)} ${count.region}`;
|
|
40
|
+
/**
|
|
41
|
+
* A revision and an hour.
|
|
42
|
+
*
|
|
43
|
+
* The fourth counter the door writes and the second it composes by hand: one
|
|
44
|
+
* delivery's openings all carry the same hour, so two of these can only collide
|
|
45
|
+
* where a delivery opened page views of one revision twice over — which
|
|
46
|
+
* `openingsOf` has already folded. The key is here anyway, with the other
|
|
47
|
+
* three, because *today's callers cannot emit a duplicate* is a property of
|
|
48
|
+
* today's callers (see the note above).
|
|
49
|
+
*/
|
|
50
|
+
export const arrivalKey = (count) => `${revisionKey(count)} ${count.hour}`;
|
|
51
|
+
/**
|
|
52
|
+
* A revision, a part and an hour, which is the fifth counter and the second
|
|
53
|
+
* with a clock in its key (`acted.ts`).
|
|
54
|
+
*
|
|
55
|
+
* The hour is last for the reason it is last in the table's primary key: a
|
|
56
|
+
* reading of one part over a range is a prefix of this, and a reading of one
|
|
57
|
+
* hour across a page is the index beside it.
|
|
58
|
+
*/
|
|
59
|
+
export const actedKey = (count) => `${revisionKey(count)} ${count.nodeId} ${count.hour}`;
|
|
60
|
+
/**
|
|
61
|
+
* A revision, a pair's two ends and an hour, which is the sixth counter and the
|
|
62
|
+
* third with a clock in its key (`funnel-hours.ts`).
|
|
63
|
+
*
|
|
64
|
+
* The ends are spelled by `endOf` above, so the hourly row and the total row
|
|
65
|
+
* agree about what makes two funnels the same question — the identity 0158
|
|
66
|
+
* makes permanent if the two places disagree about it.
|
|
67
|
+
*/
|
|
68
|
+
export const funnelHourKey = (count) => `${revisionKey(count)} ${endOf(count.pair.from)} ${endOf(count.pair.to)} ${count.hour}`;
|
|
69
|
+
/**
|
|
70
|
+
* The same counter, in one audience (0284).
|
|
71
|
+
*
|
|
72
|
+
* The four keys above identify a counter *within* one audience, which is all a
|
|
73
|
+
* fold in front of the driver needs: `apply` and `count` are handed one
|
|
74
|
+
* audience's rows per call, so two entries sharing a key in one call are the
|
|
75
|
+
* same row however many audiences the window held.
|
|
76
|
+
*
|
|
77
|
+
* A store that keeps its rows across calls needs more than that, and only the
|
|
78
|
+
* memory one does — Postgres has the audience in the primary key, so the
|
|
79
|
+
* database is already holding two audiences apart. This is the memory store's
|
|
80
|
+
* half of that same identity, and it is **here rather than beside it** for the
|
|
81
|
+
* reason the rest of this file is: two spellings of a key that agree today are
|
|
82
|
+
* the shape this subsystem has already been bitten by.
|
|
83
|
+
*/
|
|
84
|
+
export const inAudience = (audience, key) => `${audience} ${key}`;
|
|
85
|
+
/**
|
|
86
|
+
* Rows that name the same counter, added together, in the order they arrived.
|
|
87
|
+
*
|
|
88
|
+
* Stable in two ways that matter: a row's first appearance fixes its position,
|
|
89
|
+
* so a fold never reorders a caller's list, and `add` is handed the standing row
|
|
90
|
+
* first — so a non-additive column written by `add` keeps the same winner as the
|
|
91
|
+
* `excluded.*` the upsert would have applied.
|
|
92
|
+
*/
|
|
93
|
+
export const foldedBy = (rows, key, add) => {
|
|
94
|
+
const by = new Map();
|
|
95
|
+
for (const row of rows) {
|
|
96
|
+
const at = key(row);
|
|
97
|
+
const standing = by.get(at);
|
|
98
|
+
by.set(at, standing === undefined ? row : add(standing, row));
|
|
99
|
+
}
|
|
100
|
+
return [...by.values()];
|
|
101
|
+
};
|
|
102
|
+
/** The two numbers a page-view count carries, which is one. */
|
|
103
|
+
export const addPageViewCounts = (standing, next) => ({
|
|
104
|
+
...next,
|
|
105
|
+
views: standing.views + next.views,
|
|
106
|
+
});
|
|
107
|
+
/**
|
|
108
|
+
* Every counter on a tally, added.
|
|
109
|
+
*
|
|
110
|
+
* `type` is the one column that is not a number, and the later row wins it —
|
|
111
|
+
* which is what `SET type = excluded.type` does and what the memory store's
|
|
112
|
+
* spread does, so the fold does not become a third answer.
|
|
113
|
+
*/
|
|
114
|
+
export const addTallies = (standing, next) => ({
|
|
115
|
+
...next,
|
|
116
|
+
views: standing.views + next.views,
|
|
117
|
+
reached: standing.reached + next.reached,
|
|
118
|
+
engaged: standing.engaged + next.engaged,
|
|
119
|
+
dwellMs: standing.dwellMs + next.dwellMs,
|
|
120
|
+
activations: standing.activations + next.activations,
|
|
121
|
+
opens: standing.opens + next.opens,
|
|
122
|
+
closes: standing.closes + next.closes,
|
|
123
|
+
completions: standing.completions + next.completions,
|
|
124
|
+
});
|
|
125
|
+
export const addFunnelAnswers = (standing, next) => ({
|
|
126
|
+
...next,
|
|
127
|
+
reached: standing.reached + next.reached,
|
|
128
|
+
converted: standing.converted + next.converted,
|
|
129
|
+
});
|
|
130
|
+
/** Page views that began in one hour, added. */
|
|
131
|
+
export const addArrivalCounts = (standing, next) => ({ ...next, views: standing.views + next.views });
|
|
132
|
+
/**
|
|
133
|
+
* What readers did to one part in one hour, added.
|
|
134
|
+
*
|
|
135
|
+
* `type` is the one column that is not a number and the later row wins it,
|
|
136
|
+
* which is what `SET type = excluded.type` does — so the fold in front of the
|
|
137
|
+
* driver does not become a third answer.
|
|
138
|
+
*/
|
|
139
|
+
export const addActedCounts = (standing, next) => ({
|
|
140
|
+
...next,
|
|
141
|
+
activations: standing.activations + next.activations,
|
|
142
|
+
opens: standing.opens + next.opens,
|
|
143
|
+
closes: standing.closes + next.closes,
|
|
144
|
+
completions: standing.completions + next.completions,
|
|
145
|
+
});
|
|
146
|
+
/**
|
|
147
|
+
* One pair's hour, added.
|
|
148
|
+
*
|
|
149
|
+
* Both numbers are distinct counts of page views, which they may be here for
|
|
150
|
+
* the one reason `funnel-hours.ts` gives at length: a view is filed under a
|
|
151
|
+
* single hour, so two rows naming one pair-hour are two folds' worth of
|
|
152
|
+
* disjoint cohorts and adding them is exact rather than generous.
|
|
153
|
+
*/
|
|
154
|
+
export const addFunnelHourCounts = (standing, next) => ({
|
|
155
|
+
...next,
|
|
156
|
+
reached: standing.reached + next.reached,
|
|
157
|
+
converted: standing.converted + next.converted,
|
|
158
|
+
});
|
|
159
|
+
export const addRegionCounts = (standing, next) => ({ ...next, views: standing.views + next.views });
|
|
160
|
+
//# sourceMappingURL=counters.js.map
|
|
@@ -25,16 +25,35 @@ import type { ReaderSignalBatch } from "./signal.js";
|
|
|
25
25
|
* Where a delivery goes when the host has no opinion.
|
|
26
26
|
*
|
|
27
27
|
* A path rather than a URL, and relative, so it is same-origin by construction.
|
|
28
|
-
*
|
|
29
|
-
*
|
|
30
|
-
*
|
|
31
|
-
*
|
|
28
|
+
* A host whose pages are served from somewhere other than the deployment that
|
|
29
|
+
* counts them names that deployment's full address instead, and
|
|
30
|
+
* {@link BATCH_CONTENT_TYPE} is why that works without the deployment serving
|
|
31
|
+
* CORS.
|
|
32
32
|
*
|
|
33
33
|
* It is a default and not a constant the receiver shares. The endpoint's
|
|
34
34
|
* address is a deployment's choice — a host may serve it anywhere, and this is
|
|
35
35
|
* what the host who does not care gets.
|
|
36
36
|
*/
|
|
37
37
|
export declare const DEFAULT_READER_SIGNAL_PATH = "/api/reader-signals";
|
|
38
|
+
/**
|
|
39
|
+
* What a batch is labelled as on the wire: **plain text, which happens to be
|
|
40
|
+
* JSON**.
|
|
41
|
+
*
|
|
42
|
+
* The label is the whole of what decides whether a delivery can leave a page
|
|
43
|
+
* for another origin. A browser sends a cross-origin `POST` without asking
|
|
44
|
+
* first only when its body is one of three CORS-safelisted types, and
|
|
45
|
+
* `text/plain` is the one of them a JSON document fits. Labelled
|
|
46
|
+
* `application/json` it is not safelisted: a `fetch` has to be preflighted by
|
|
47
|
+
* an `OPTIONS` request the deployment must answer, and a beacon, which cannot
|
|
48
|
+
* preflight at all, is refused by the browser before it is sent. The beacon
|
|
49
|
+
* carries the last batch of every page view, so a label that cost it would
|
|
50
|
+
* cost the batch that matters most, on every customer's site.
|
|
51
|
+
*
|
|
52
|
+
* Nothing receiving a batch reads the label. The door parses the body it is
|
|
53
|
+
* given and refuses what does not parse, so a batch is exactly as checked under
|
|
54
|
+
* this label as under the other one, and same-origin delivery is unchanged.
|
|
55
|
+
*/
|
|
56
|
+
export declare const BATCH_CONTENT_TYPE = "text/plain;charset=UTF-8";
|
|
38
57
|
/** `navigator.sendBeacon`, narrowed to what this uses. `false` means it would not take it. */
|
|
39
58
|
export type SendBeacon = (url: string, body: Blob) => boolean;
|
|
40
59
|
/** The fallback. Called only when a beacon was unavailable or refused the batch. */
|
package/dist/signals/deliver.js
CHANGED
|
@@ -24,16 +24,35 @@
|
|
|
24
24
|
* Where a delivery goes when the host has no opinion.
|
|
25
25
|
*
|
|
26
26
|
* A path rather than a URL, and relative, so it is same-origin by construction.
|
|
27
|
-
*
|
|
28
|
-
*
|
|
29
|
-
*
|
|
30
|
-
*
|
|
27
|
+
* A host whose pages are served from somewhere other than the deployment that
|
|
28
|
+
* counts them names that deployment's full address instead, and
|
|
29
|
+
* {@link BATCH_CONTENT_TYPE} is why that works without the deployment serving
|
|
30
|
+
* CORS.
|
|
31
31
|
*
|
|
32
32
|
* It is a default and not a constant the receiver shares. The endpoint's
|
|
33
33
|
* address is a deployment's choice — a host may serve it anywhere, and this is
|
|
34
34
|
* what the host who does not care gets.
|
|
35
35
|
*/
|
|
36
36
|
export const DEFAULT_READER_SIGNAL_PATH = "/api/reader-signals";
|
|
37
|
+
/**
|
|
38
|
+
* What a batch is labelled as on the wire: **plain text, which happens to be
|
|
39
|
+
* JSON**.
|
|
40
|
+
*
|
|
41
|
+
* The label is the whole of what decides whether a delivery can leave a page
|
|
42
|
+
* for another origin. A browser sends a cross-origin `POST` without asking
|
|
43
|
+
* first only when its body is one of three CORS-safelisted types, and
|
|
44
|
+
* `text/plain` is the one of them a JSON document fits. Labelled
|
|
45
|
+
* `application/json` it is not safelisted: a `fetch` has to be preflighted by
|
|
46
|
+
* an `OPTIONS` request the deployment must answer, and a beacon, which cannot
|
|
47
|
+
* preflight at all, is refused by the browser before it is sent. The beacon
|
|
48
|
+
* carries the last batch of every page view, so a label that cost it would
|
|
49
|
+
* cost the batch that matters most, on every customer's site.
|
|
50
|
+
*
|
|
51
|
+
* Nothing receiving a batch reads the label. The door parses the body it is
|
|
52
|
+
* given and refuses what does not parse, so a batch is exactly as checked under
|
|
53
|
+
* this label as under the other one, and same-origin delivery is unchanged.
|
|
54
|
+
*/
|
|
55
|
+
export const BATCH_CONTENT_TYPE = "text/plain;charset=UTF-8";
|
|
37
56
|
const browserBeacon = () => {
|
|
38
57
|
const sender = globalThis.navigator;
|
|
39
58
|
return typeof sender?.sendBeacon === "function" ? (url, body) => sender.sendBeacon(url, body) : null;
|
|
@@ -42,13 +61,22 @@ const browserBeacon = () => {
|
|
|
42
61
|
* `keepalive` is what makes this survive the page it was sent from. Rejections
|
|
43
62
|
* are swallowed here rather than left to the broadcaster's containment, so that
|
|
44
63
|
* a host calling this directly gets the same promise the broadcaster does.
|
|
64
|
+
*
|
|
65
|
+
* **`no-cors`, because nothing here reads the answer.** Across origins a
|
|
66
|
+
* `cors` request still arrives — its label is safelisted, so nothing is
|
|
67
|
+
* preflighted — but a deployment that sends no CORS headers makes the browser
|
|
68
|
+
* reject the response, and every customer's console would carry an error per
|
|
69
|
+
* batch for a reply this function was going to ignore. `no-cors` asks for an
|
|
70
|
+
* opaque response, which is what ignoring one already was. It permits only
|
|
71
|
+
* safelisted headers, and {@link BATCH_CONTENT_TYPE} is the only one sent.
|
|
45
72
|
*/
|
|
46
73
|
const fetchPost = (url, body) => {
|
|
47
74
|
void globalThis
|
|
48
75
|
.fetch(url, {
|
|
49
76
|
method: "POST",
|
|
77
|
+
mode: "no-cors",
|
|
50
78
|
keepalive: true,
|
|
51
|
-
headers: { "content-type":
|
|
79
|
+
headers: { "content-type": BATCH_CONTENT_TYPE },
|
|
52
80
|
body,
|
|
53
81
|
})
|
|
54
82
|
.catch(() => undefined);
|
|
@@ -73,7 +101,7 @@ export const deliverReaderSignals = (options = {}) => {
|
|
|
73
101
|
const body = JSON.stringify(batch);
|
|
74
102
|
try {
|
|
75
103
|
const beacon = options.beacon === undefined ? browserBeacon() : options.beacon;
|
|
76
|
-
if (beacon !== null && beacon(url, new Blob([body], { type:
|
|
104
|
+
if (beacon !== null && beacon(url, new Blob([body], { type: BATCH_CONTENT_TYPE })))
|
|
77
105
|
return;
|
|
78
106
|
post(url, body);
|
|
79
107
|
}
|