@10x-media/analytics 1.0.0-beta.11 → 1.0.0-beta.12
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/CHANGELOG.md +463 -0
- package/README.md +30 -37
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +7 -9
- package/dist/adapters/ga4/disableKey.js.map +1 -1
- package/dist/adapters/ga4/eventName.d.ts +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +11 -0
- package/dist/adapters/ga4/ga4.js +206 -123
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +2 -3
- package/dist/adapters/ga4/measurementId.js.map +1 -1
- package/dist/adapters/goalRead.js +15 -29
- package/dist/adapters/goalRead.js.map +1 -1
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +13 -13
- package/dist/adapters/plausible/plausible.js +137 -122
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +20 -9
- package/dist/adapters/posthog/posthog.js +179 -113
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +7 -9
- package/dist/adapters/umami/umami.js +184 -172
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +16 -29
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +48 -95
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +100 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/charts/BarList.d.ts +27 -14
- package/dist/charts/BarList.js +38 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +15 -1
- package/dist/charts/bars.js +12 -12
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +193 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +48 -37
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +26 -25
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +258 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +104 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +285 -59
- package/dist/core/contract.js +6 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +473 -157
- package/dist/core/options.js +154 -219
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +112 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +182 -72
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +38 -20
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceOptions.js +94 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +14 -0
- package/dist/exports/adapters/ga4.d.ts +15 -1
- package/dist/exports/adapters/native.d.ts +26 -2
- package/dist/exports/adapters/native.js +4 -1
- package/dist/exports/adapters/plausible.d.ts +15 -1
- package/dist/exports/adapters/posthog.d.ts +15 -1
- package/dist/exports/adapters/umami.d.ts +15 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +41 -13
- package/dist/exports/client.js +21 -9
- package/dist/exports/geo.d.ts +3 -1
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/next.d.ts +18 -1
- package/dist/exports/next.js +3 -1
- package/dist/exports/react.d.ts +3 -2
- package/dist/exports/react.js +1 -2
- package/dist/exports/rsc.d.ts +31 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +17 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +5 -20
- package/dist/exports/tracker.js +3 -14
- package/dist/exports/types.d.ts +40 -14
- package/dist/exports/types.js +5 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +20 -8
- package/dist/fields/AnalyticsPanelField.js +121 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +18 -7
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +217 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
- package/dist/fields/config/FilterDimensionSelectField.js +26 -54
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
- package/dist/fields/config/FilterOperatorSelectField.js +37 -53
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +18 -30
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.js +14 -26
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +31 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +66 -37
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +78 -26
- package/dist/fields/readForDocument.js +446 -116
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +162 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +141 -100
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -26
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +39 -40
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +154 -46
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -27
- package/dist/goals/trackGoalAction.js +38 -52
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +63 -11
- package/dist/index.js +257 -247
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +81 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.d.ts +1 -0
- package/dist/maintenance/taskSchedule.js +62 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +102 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +29 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1623 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +198 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +108 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +4 -1
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +20 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +2 -3
- package/dist/native/ingest/bots.js +8 -13
- package/dist/native/ingest/bots.js.map +1 -1
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +30 -9
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +119 -34
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +60 -7
- package/dist/native/ingest/normalizeEvent.js +226 -61
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +10 -23
- package/dist/native/ingest/requestHost.js.map +1 -1
- package/dist/native/ingest/resolveHostname.d.ts +4 -13
- package/dist/native/ingest/resolveHostname.js +5 -6
- package/dist/native/ingest/resolveHostname.js.map +1 -1
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +82 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +181 -72
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +2 -3
- package/dist/native/ingest/source.js +35 -54
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +20 -10
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +101 -33
- package/dist/native/nativeAdapter.js +375 -317
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +116 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +63 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +430 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +695 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +95 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +384 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +345 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +48 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +656 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +9 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +68 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +4 -24
- package/dist/next/captureRewrites.js +6 -50
- package/dist/next/captureRewrites.js.map +1 -1
- package/dist/next/captureRoute.d.ts +28 -0
- package/dist/next/captureRoute.js +67 -0
- package/dist/next/captureRoute.js.map +1 -0
- package/dist/next/ingestRoute.d.ts +17 -0
- package/dist/next/ingestRoute.js +17 -0
- package/dist/next/ingestRoute.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +3 -25
- package/dist/next/posthogProxyRewrites.js +5 -37
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +336 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +76 -53
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +5 -12
- package/dist/plugin/errors.js +23 -16
- package/dist/plugin/errors.js.map +1 -1
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/jobsAccess.js +91 -0
- package/dist/plugin/jobsAccess.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +155 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +69 -44
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +52 -17
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +64 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +77 -25
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +69 -44
- package/dist/plugin/refreshEndpoint.js.map +1 -1
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +226 -30
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +63 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +6 -5
- package/dist/plugin/scopeChange.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +46 -12
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +22 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +53 -0
- package/dist/providers/collection.js +274 -150
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +76 -0
- package/dist/providers/factory.js +76 -23
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +101 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +318 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +23 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +1 -5
- package/dist/query/fetchQuery.d.ts +25 -32
- package/dist/query/fetchQuery.js +91 -91
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +6 -0
- package/dist/query/parse.js +153 -106
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +26 -17
- package/dist/react/AnalyticsProvider.js +23 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -11
- package/dist/react/useAnalytics.js +22 -24
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/site/AnalyticsScripts.d.ts +34 -0
- package/dist/site/AnalyticsScripts.js +30 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +40 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +69 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -72
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.js +70 -26
- package/dist/surfacing/epoch.js.map +1 -1
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +113 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +28 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +226 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +144 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +4 -10
- package/dist/tracker/createTracker.js +386 -115
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +2 -22
- package/dist/tracker/exclusion.js +53 -21
- package/dist/tracker/exclusion.js.map +1 -1
- package/dist/tracker/gate.js +194 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +21 -14
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +118 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +38 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +64 -20
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +7 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +27 -22
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +26 -22
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +14 -12
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +30 -27
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +86 -63
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +226 -71
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +215 -69
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +209 -67
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +217 -68
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +221 -72
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +212 -67
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +185 -14
- package/dist/translations/keys.js +190 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +214 -69
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +226 -77
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +217 -66
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +217 -66
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +212 -67
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +112 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1528 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +26 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +11 -6
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +8 -10
- package/dist/view/AnalyticsView.js +47 -18
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -229
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +150 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +66 -31
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +95 -10
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +10 -9
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +196 -134
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +118 -30
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +124 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +29 -33
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +123 -82
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +47 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +64 -7
- package/dist/view/viewProps.js +121 -35
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +80 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +129 -123
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +24 -4
- package/dist/widgets/RealtimeCounter.js +91 -77
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +12 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaults.d.ts +4 -7
- package/dist/widgets/defaults.js +4 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +73 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +5 -1
- package/dist/widgets/prepareWidgetRead.js +59 -27
- package/dist/widgets/prepareWidgetRead.js.map +1 -1
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +27 -18
- package/dist/widgets/readForWidget.js +31 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
- package/dist/widgets/readForWidgetBreakdown.js +46 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +17 -23
- package/dist/widgets/readForWidgetGoals.js +50 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
- package/dist/widgets/readForWidgetRealtime.js +51 -27
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +26 -31
- package/dist/widgets/readForWidgetSeries.js +43 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +44 -0
- package/dist/widgets/readMeta.js +47 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +53 -25
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +204 -126
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +4 -3
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +31 -24
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +44 -22
- package/dist/adapters/ga4/disableKey.d.ts +0 -9
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -165
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -39
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -175
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -69
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -106
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/plugin/paths.js +0 -29
- package/dist/plugin/paths.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -29
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -20
- package/dist/tracker/sinks/posthog.d.ts +0 -18
- package/dist/tracker/sinks/umami.d.ts +0 -18
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -76
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lanes.js","names":[],"sources":["../../src/surfacing/lanes.ts"],"sourcesContent":["import type { AnalyticsAdapter } from '../core/contract'\nimport { monotonicMs } from '../core/monotonic'\nimport { recallOr } from './bounded'\nimport { BREAKER_MAX_MS, type Breaker, type BreakerOptions, createBreaker } from './breaker'\nimport {\n\tclassifyError,\n\tisLaneRefused,\n\tLaneRefusedError,\n\ttype ReadFailure,\n\ttype ReadFailureKind,\n} from './classifyError'\nimport { createTokenSource, mostUrgent, type Priority } from './rateLimiter'\n\nexport type { Priority } from './rateLimiter'\n\n/** Upstream requests in flight across every vendor source of one instance, by default. */\nexport const DEFAULT_GLOBAL_CONCURRENCY = 16\n\n/** Upstream requests in flight per vendor source that declares no `rateLimit.maxConcurrent`. */\nexport const DEFAULT_SOURCE_CONCURRENCY = 4\n\n/** Reads in flight on a local source (native), which stays outside the global cap. */\nconst DEFAULT_LOCAL_CONCURRENCY = 8\n\n/** The fewest and most native reads in flight when the lane is sized from a Postgres pool. */\nconst MIN_POOLED_CONCURRENCY = 1\nexport const MAX_POOLED_CONCURRENCY = 8\n\n/**\n * Native lane size on a host Postgres pool of `poolMax`: a third, capped at the engine's long-work\n * share, so reads queue in the lane (deadline and priority aware), not unseen for a connection.\n */\nexport const pooledConcurrency = (poolMax: number): number =>\n\tMath.min(MAX_POOLED_CONCURRENCY, Math.max(MIN_POOLED_CONCURRENCY, Math.floor(poolMax / 3)))\n\n/** The slots one scope may hold at once in a lane every scope shares: half, rounded up. */\nconst scopeShareOf = (capacity: number): number => Math.max(1, Math.ceil(capacity / 2))\n\n/** Retries of an upstream request that failed as `unavailable`, with backoff between them. */\nconst MAX_RETRIES = 2\n\n/** The first backoff, 0.5 s; the second is 1.25 s (see {@link runUpstream}). */\nexport const RETRY_BASE_MS = 500\n\n/**\n * How long a request may stay out after its signal aborted before its slots are given back: one\n * that honours the signal settles at once, and GA4's own gRPC deadline ends with the read.\n */\nexport const ABANDON_AFTER_MS = 5_000\n\nexport interface LaneRunOptions {\n\tsignal: AbortSignal\n\tpriority: Priority\n\t/** Epoch milliseconds the caller gives up at: a wait that would outlast it is refused at once. */\n\tdeadline?: number\n}\n\nexport interface LaneHealth {\n\t/** The lane refuses new requests right now: its breaker is open. */\n\topen: boolean\n\t/** Until the lane takes requests again, when open or the vendor asked it to wait. */\n\tretryAfterMs?: number\n\t/** What the failure that last counted against the lane meant, cleared by a success. */\n\tlastFailure?: ReadFailureKind\n\t/** That failure was a refused host. */\n\thostRefused?: true\n\t/**\n\t * Requests whose slots were given back while they were still out, having ignored their abort\n\t * signal for {@link ABANDON_AFTER_MS}; absent while there are none.\n\t */\n\tabandoned?: number\n}\n\n/**\n * One adapter's requests for one scope. A `run` takes a rate token, a lane slot and a global slot\n * in that order; the pause, tokens and slots are the adapter's, the breaker each scope's own.\n */\nexport interface Lane {\n\trun<T>(fn: (signal: AbortSignal) => Promise<T>, options: LaneRunOptions): Promise<T>\n\thealth(): LaneHealth\n}\n\nexport interface Lanes {\n\t/**\n\t * The lane of one adapter instance for `scope`, made on first use; for an adapter built anew on\n\t * every read, the lane of its id within `scope`.\n\t */\n\tfor(adapter: AnalyticsAdapter, scope?: string | null): Lane\n}\n\nexport interface LanesOptions {\n\t/** Slots shared by every vendor source; default {@link DEFAULT_GLOBAL_CONCURRENCY}. */\n\tglobal?: number\n\t/** Slots of a source without `maxConcurrent`; default {@link DEFAULT_SOURCE_CONCURRENCY}. */\n\tperSource?: number\n\t/** Which sources are local (native), which get their own lane outside the global cap. */\n\tlocal?: { is: (adapter: AnalyticsAdapter) => boolean; capacity?: number }\n\t/** Clock for waits and deadlines; the timers' monotonic one (`monotonicMs`) by default. */\n\tnow?: () => number\n\t/**\n\t * Adapters built anew per read (`providers.resolve`): keyed by scope and id rather than object,\n\t * so each keeps one lane, and two tenants' sources of one id never share a breaker.\n\t */\n\trebuilt?: (adapter: AnalyticsAdapter) => boolean\n\t/**\n\t * Which adapters serve every scope through one lane (the config adapters of a scoped install):\n\t * one scope holds at most {@link scopeShareOf} of their slots, so another always gets one.\n\t */\n\tshared?: (adapter: AnalyticsAdapter) => boolean\n\tbreaker?: Omit<BreakerOptions, 'now'>\n\t/** How long a request may ignore its abort before its slots return; {@link ABANDON_AFTER_MS}. */\n\tabandonAfterMs?: number\n\t/** Told the first time a lane gives back the slots of a request that ignored its abort signal. */\n\tonAbandon?: (adapter: AnalyticsAdapter) => void\n}\n\ntype Release = () => void\n\n/** The install-wide scope (null) is keyed `''`; it never counts against a scope's share. */\nconst UNSCOPED = ''\n\nconst scopeKeyOf = (scope: string | null | undefined): string =>\n\tscope === null || scope === undefined ? UNSCOPED : `s:${scope}`\n\ninterface Slots {\n\tacquire(priority: Priority, signal: AbortSignal, scope?: string): Promise<Release>\n}\n\ninterface SlotWaiter {\n\tpriority: Priority\n\tscope: string\n\tgrant: () => void\n}\n\n/**\n * A counting semaphore serving the most urgent waiter first, never more than `backgroundCap` slots\n * to background work, and, given a `scopeCap`, never more than that many to one scope.\n */\nconst createSlots = (capacity: number, backgroundCap: number, scopeCap?: number): Slots => {\n\tlet active = 0\n\tlet background = 0\n\tconst waiters: SlotWaiter[] = []\n\tconst heldBy = new Map<string, number>()\n\n\tconst withinShare = (waiter: SlotWaiter): boolean =>\n\t\tscopeCap === undefined ||\n\t\twaiter.scope === UNSCOPED ||\n\t\t(heldBy.get(waiter.scope) ?? 0) < scopeCap\n\n\tconst pick = (): SlotWaiter | undefined =>\n\t\tmostUrgent(\n\t\t\twaiters.filter(\n\t\t\t\t(waiter) =>\n\t\t\t\t\twithinShare(waiter) && (waiter.priority !== 'background' || background < backgroundCap)\n\t\t\t)\n\t\t)\n\n\tconst hold = (scope: string, by: number): void => {\n\t\tconst next = (heldBy.get(scope) ?? 0) + by\n\t\tif (next > 0) {\n\t\t\theldBy.set(scope, next)\n\t\t} else {\n\t\t\theldBy.delete(scope)\n\t\t}\n\t}\n\n\tconst pump = (): void => {\n\t\twhile (active < capacity) {\n\t\t\tconst chosen = pick()\n\t\t\tif (!chosen) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\twaiters.splice(waiters.indexOf(chosen), 1)\n\t\t\tactive++\n\t\t\thold(chosen.scope, 1)\n\t\t\tif (chosen.priority === 'background') {\n\t\t\t\tbackground++\n\t\t\t}\n\t\t\tchosen.grant()\n\t\t}\n\t}\n\n\treturn {\n\t\tacquire(priority, signal, scope = UNSCOPED) {\n\t\t\tif (signal.aborted) {\n\t\t\t\treturn Promise.reject(signal.reason)\n\t\t\t}\n\t\t\treturn new Promise<Release>((resolve, reject) => {\n\t\t\t\tlet released = false\n\t\t\t\tconst release = (): void => {\n\t\t\t\t\tif (released) {\n\t\t\t\t\t\treturn\n\t\t\t\t\t}\n\t\t\t\t\treleased = true\n\t\t\t\t\tactive--\n\t\t\t\t\thold(scope, -1)\n\t\t\t\t\tif (priority === 'background') {\n\t\t\t\t\t\tbackground--\n\t\t\t\t\t}\n\t\t\t\t\tpump()\n\t\t\t\t}\n\t\t\t\tconst onAbort = (): void => {\n\t\t\t\t\tconst index = waiters.indexOf(waiter)\n\t\t\t\t\tif (index !== -1) {\n\t\t\t\t\t\twaiters.splice(index, 1)\n\t\t\t\t\t}\n\t\t\t\t\treject(signal.reason)\n\t\t\t\t}\n\t\t\t\tconst waiter: SlotWaiter = {\n\t\t\t\t\tpriority,\n\t\t\t\t\tscope,\n\t\t\t\t\tgrant: () => {\n\t\t\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\t\t\tresolve(release)\n\t\t\t\t\t},\n\t\t\t\t}\n\t\t\t\twaiters.push(waiter)\n\t\t\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t\t\t\tpump()\n\t\t\t})\n\t\t},\n\t}\n}\n\n/** Resolves after `ms`, or rejects with the signal's reason once it aborts. */\nconst sleep = (ms: number, signal: AbortSignal): Promise<void> => {\n\tif (signal.aborted) {\n\t\treturn Promise.reject(signal.reason)\n\t}\n\treturn new Promise<void>((resolve, reject) => {\n\t\tconst onAbort = (): void => {\n\t\t\tclearTimeout(timer)\n\t\t\treject(signal.reason)\n\t\t}\n\t\tconst timer = setTimeout(() => {\n\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\tresolve()\n\t\t}, ms)\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t})\n}\n\n/**\n * Settles with `work`, or rejects with the signal's reason first: the slot stays held until `work`\n * settles, or until {@link ABANDON_AFTER_MS} after the abort for work that never does.\n */\nconst untilAborted = <T>(work: Promise<T>, signal: AbortSignal): Promise<T> => {\n\tif (signal.aborted) {\n\t\treturn Promise.reject(signal.reason)\n\t}\n\tlet onAbort: (() => void) | undefined\n\tconst aborted = new Promise<never>((_resolve, reject) => {\n\t\tonAbort = () => reject(signal.reason)\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t})\n\treturn Promise.race([work, aborted]).finally(() => {\n\t\tif (onAbort) {\n\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t}\n\t})\n}\n\nconst noRelease: Release = () => {}\n\ninterface LaneSetup {\n\tadapter: AnalyticsAdapter\n\tcapacity: number\n\tglobal: Slots | undefined\n\tnow: () => number\n\t/** Every scope reads through this lane: each holds at most its share of the slots. */\n\tshared: boolean\n\tbreaker?: Omit<BreakerOptions, 'now'>\n\tabandonAfterMs: number\n\tonAbandon?: (adapter: AnalyticsAdapter) => void\n}\n\n/** What a request that ignored its abort counts as against the breaker. */\nconst ABANDONED: ReadFailure = { kind: 'unavailable', timeout: true }\n\n/** A breaker with nothing to remember: closed, no failure counted since its last answer. */\nconst isClean = (breaker: Breaker): boolean => {\n\tconst snapshot = breaker.snapshot()\n\treturn snapshot.state === 'closed' && snapshot.lastFailure === undefined\n}\n\n/** One adapter's pause, tokens and slots, and one breaker per scope reading through them. */\nconst createLaneCore = (setup: LaneSetup): ((scope: string | null | undefined) => Lane) => {\n\tconst { now } = setup\n\tconst tokens = createTokenSource(setup.adapter.capabilities.rateLimit, now)\n\tconst slots = createSlots(\n\t\tsetup.capacity,\n\t\tMath.max(1, Math.floor(setup.capacity / 2)),\n\t\tsetup.shared ? scopeShareOf(setup.capacity) : undefined\n\t)\n\tconst breakers = new Map<string, Breaker>()\n\tconst views = new Map<string, Lane>()\n\tlet pausedUntil = 0\n\tlet abandoned = 0\n\n\tconst breakerOf = (key: string): Breaker =>\n\t\trecallOr(\n\t\t\tbreakers,\n\t\t\t[key, () => createBreaker({ now, ...setup.breaker })],\n\t\t\t(breaker) => !isClean(breaker)\n\t\t)\n\n\tconst waitOutPause = async (options: LaneRunOptions): Promise<void> => {\n\t\tfor (;;) {\n\t\t\tconst pausedFor = pausedUntil - now()\n\t\t\tif (pausedFor <= 0) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (options.deadline !== undefined && pausedUntil > options.deadline) {\n\t\t\t\tthrow new LaneRefusedError('paused', pausedFor)\n\t\t\t}\n\t\t\tawait sleep(pausedFor, options.signal)\n\t\t}\n\t}\n\n\tconst viewOf = (key: string): Lane => ({\n\t\tasync run(fn, options) {\n\t\t\tconst { signal, priority } = options\n\t\t\tif (signal.aborted) {\n\t\t\t\tthrow signal.reason\n\t\t\t}\n\t\t\tconst breaker = breakerOf(key)\n\t\t\tconst refusedOpen = (retryAfterMs: number): LaneRefusedError =>\n\t\t\t\tnew LaneRefusedError('open', retryAfterMs, breaker.snapshot().lastFailure)\n\t\t\tconst peek = breaker.peek()\n\t\t\tif (!peek.ok) {\n\t\t\t\tthrow refusedOpen(peek.retryAfterMs)\n\t\t\t}\n\t\t\t// A breaker due its probe lets one run through: it is claimed before the run spends a rate\n\t\t\t// token or waits for a slot, so the runs it turns away spend nothing.\n\t\t\tconst claimed = peek.probe ? breaker.admit() : undefined\n\t\t\tif (claimed && !claimed.ok) {\n\t\t\t\tthrow refusedOpen(claimed.retryAfterMs)\n\t\t\t}\n\t\t\tlet releaseLane = noRelease\n\t\t\tlet releaseGlobal = noRelease\n\t\t\tconst releaseSlots = (): void => {\n\t\t\t\treleaseGlobal()\n\t\t\t\treleaseLane()\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait waitOutPause(options)\n\t\t\t\tawait tokens.take({ signal, priority })\n\t\t\t\treleaseLane = await slots.acquire(priority, signal, key)\n\t\t\t\treleaseGlobal = setup.global ? await setup.global.acquire(priority, signal) : noRelease\n\t\t\t} catch (err) {\n\t\t\t\treleaseSlots()\n\t\t\t\tif (claimed?.probe) {\n\t\t\t\t\tbreaker.release()\n\t\t\t\t}\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\tconst admission = claimed ?? breaker.admit()\n\t\t\tif (!admission.ok) {\n\t\t\t\treleaseSlots()\n\t\t\t\tthrow refusedOpen(admission.retryAfterMs)\n\t\t\t}\n\t\t\tlet counted = false\n\t\t\tconst record = (outcome: 'success' | ReadFailure): void => {\n\t\t\t\tif (!counted) {\n\t\t\t\t\tcounted = true\n\t\t\t\t\tbreaker.record(outcome, admission.probe)\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst settled = (async () => fn(signal))().then(\n\t\t\t\t(value) => {\n\t\t\t\t\trecord('success')\n\t\t\t\t\treturn value\n\t\t\t\t},\n\t\t\t\t(err: unknown) => {\n\t\t\t\t\tconst failure = classifyError(err)\n\t\t\t\t\trecord(failure)\n\t\t\t\t\tif (failure.kind === 'unavailable' && failure.retryAfterMs !== undefined) {\n\t\t\t\t\t\tpausedUntil = Math.max(\n\t\t\t\t\t\t\tpausedUntil,\n\t\t\t\t\t\t\tnow() + Math.min(failure.retryAfterMs, BREAKER_MAX_MS)\n\t\t\t\t\t\t)\n\t\t\t\t\t}\n\t\t\t\t\tthrow err\n\t\t\t\t}\n\t\t\t)\n\t\t\tlet abandonTimer: ReturnType<typeof setTimeout> | undefined\n\t\t\t// Past the grace a request that ignores its abort gives its slots back, counted as a timeout.\n\t\t\tconst abandon = (): void => {\n\t\t\t\tabandonTimer = setTimeout(() => {\n\t\t\t\t\treleaseSlots()\n\t\t\t\t\trecord(ABANDONED)\n\t\t\t\t\tabandoned++\n\t\t\t\t\tif (abandoned === 1) {\n\t\t\t\t\t\tsetup.onAbandon?.(setup.adapter)\n\t\t\t\t\t}\n\t\t\t\t}, setup.abandonAfterMs)\n\t\t\t\tabandonTimer.unref?.()\n\t\t\t}\n\t\t\tif (signal.aborted) {\n\t\t\t\tabandon()\n\t\t\t} else {\n\t\t\t\tsignal.addEventListener('abort', abandon, { once: true })\n\t\t\t}\n\t\t\tconst done = settled.finally(() => {\n\t\t\t\tsignal.removeEventListener('abort', abandon)\n\t\t\t\tclearTimeout(abandonTimer)\n\t\t\t\treleaseSlots()\n\t\t\t})\n\t\t\t// The caller may stop waiting at the abort; the request still settles, and is not unhandled.\n\t\t\tdone.catch(() => {})\n\t\t\treturn untilAborted(done, signal)\n\t\t},\n\t\thealth() {\n\t\t\tconst breaker = breakers.get(key)\n\t\t\tconst snapshot = breaker?.snapshot()\n\t\t\tconst peek = breaker?.peek() ?? { ok: true as const, probe: false }\n\t\t\tconst pausedFor = pausedUntil - now()\n\t\t\tconst retryAfterMs = Math.max(peek.ok ? 0 : peek.retryAfterMs, pausedFor > 0 ? pausedFor : 0)\n\t\t\tconst last = snapshot?.lastFailure\n\t\t\treturn {\n\t\t\t\topen: !peek.ok,\n\t\t\t\t...(retryAfterMs > 0 ? { retryAfterMs } : {}),\n\t\t\t\t...(last ? { lastFailure: last.kind } : {}),\n\t\t\t\t...(last?.hostRefused ? { hostRefused: true as const } : {}),\n\t\t\t\t...(abandoned > 0 ? { abandoned } : {}),\n\t\t\t}\n\t\t},\n\t})\n\n\treturn (scope) => {\n\t\tconst key = scopeKeyOf(scope)\n\t\treturn recallOr(views, [key, () => viewOf(key)])\n\t}\n}\n\n/**\n * One lane per adapter object, so a re-saved provider starts fresh. Vendor lanes share the global\n * slots; local (native) lanes do not, so a slow vendor never queues the plugin's own reads.\n */\nexport const createLanes = (options: LanesOptions = {}): Lanes => {\n\tconst now = options.now ?? monotonicMs\n\tconst globalCapacity = options.global ?? DEFAULT_GLOBAL_CONCURRENCY\n\tconst global = createSlots(globalCapacity, globalCapacity)\n\tconst cores = new WeakMap<AnalyticsAdapter, (scope: string | null | undefined) => Lane>()\n\tconst lanesById = new Map<string, Lane>()\n\n\tconst coreFor = (adapter: AnalyticsAdapter): ((scope: string | null | undefined) => Lane) => {\n\t\tconst local = options.local?.is(adapter) === true\n\t\tconst declared = adapter.capabilities.rateLimit?.maxConcurrent\n\t\tconst fallback = local\n\t\t\t? (options.local?.capacity ?? DEFAULT_LOCAL_CONCURRENCY)\n\t\t\t: (options.perSource ?? DEFAULT_SOURCE_CONCURRENCY)\n\t\treturn createLaneCore({\n\t\t\tadapter,\n\t\t\tcapacity: declared !== undefined && declared > 0 ? declared : fallback,\n\t\t\tglobal: local ? undefined : global,\n\t\t\tnow,\n\t\t\tshared: options.shared?.(adapter) === true,\n\t\t\t...(options.breaker ? { breaker: options.breaker } : {}),\n\t\t\tabandonAfterMs: options.abandonAfterMs ?? ABANDON_AFTER_MS,\n\t\t\t...(options.onAbandon ? { onAbandon: options.onAbandon } : {}),\n\t\t})\n\t}\n\n\treturn {\n\t\tfor(adapter, scope) {\n\t\t\tif (options.rebuilt?.(adapter) === true) {\n\t\t\t\tconst id = JSON.stringify([scope ?? null, adapter.id])\n\t\t\t\treturn recallOr(lanesById, [id, () => coreFor(adapter)(scope)])\n\t\t\t}\n\t\t\tconst core = cores.get(adapter) ?? coreFor(adapter)\n\t\t\tcores.set(adapter, core)\n\t\t\treturn core(scope)\n\t\t},\n\t}\n}\n\n/**\n * One upstream request, retried up to {@link MAX_RETRIES} times on a transient `unavailable` but\n * never after a timeout or spent quota, nor past the deadline; a lane refusal ends it at once.\n */\nexport const runUpstream = async <T>(\n\tlane: Lane,\n\tfn: (signal: AbortSignal) => Promise<T>,\n\toptions: LaneRunOptions & { now: () => number; baseDelayMs?: number }\n): Promise<T> => {\n\tconst base = options.baseDelayMs ?? RETRY_BASE_MS\n\tfor (let attempt = 0; ; attempt++) {\n\t\ttry {\n\t\t\treturn await lane.run(fn, options)\n\t\t} catch (err) {\n\t\t\tif (isLaneRefused(err) || options.signal.aborted) {\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\tconst failure = classifyError(err)\n\t\t\tif (\n\t\t\t\tfailure.kind !== 'unavailable' ||\n\t\t\t\tfailure.timeout ||\n\t\t\t\tfailure.quota ||\n\t\t\t\tattempt >= MAX_RETRIES\n\t\t\t) {\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\t// Fixed rather than random, so the schedule is testable: 0.5 s, then 1.25 s.\n\t\t\tconst delay = base * 2 ** attempt + base * 0.5 * attempt\n\t\t\tif (options.deadline !== undefined && options.now() + delay >= options.deadline) {\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait sleep(delay, options.signal)\n\t\t\t} catch {\n\t\t\t\tthrow err\n\t\t\t}\n\t\t}\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { currentTime } from "../core/clock.js";
|
|
2
|
+
/** How long an aggregate read is answered from memory before the store is asked again. */
|
|
3
|
+
const AGGREGATE_MEMO_MS = 15e3;
|
|
4
|
+
const createMemo = (options = {}) => {
|
|
5
|
+
const capacity = options.capacity ?? 500;
|
|
6
|
+
const now = options.now ?? currentTime;
|
|
7
|
+
const entries = /* @__PURE__ */ new Map();
|
|
8
|
+
return {
|
|
9
|
+
get(key) {
|
|
10
|
+
const entry = entries.get(key);
|
|
11
|
+
if (!entry) return;
|
|
12
|
+
entries.delete(key);
|
|
13
|
+
if (entry.expiresAt <= now()) return;
|
|
14
|
+
entries.set(key, entry);
|
|
15
|
+
return entry.value;
|
|
16
|
+
},
|
|
17
|
+
set(key, value, ttlMs) {
|
|
18
|
+
entries.delete(key);
|
|
19
|
+
if (!(ttlMs > 0)) return;
|
|
20
|
+
entries.set(key, {
|
|
21
|
+
value,
|
|
22
|
+
expiresAt: now() + ttlMs
|
|
23
|
+
});
|
|
24
|
+
for (const oldest of entries.keys()) {
|
|
25
|
+
if (entries.size <= capacity) break;
|
|
26
|
+
entries.delete(oldest);
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
delete(key) {
|
|
30
|
+
entries.delete(key);
|
|
31
|
+
},
|
|
32
|
+
get size() {
|
|
33
|
+
return entries.size;
|
|
34
|
+
}
|
|
35
|
+
};
|
|
36
|
+
};
|
|
37
|
+
//#endregion
|
|
38
|
+
export { AGGREGATE_MEMO_MS, createMemo };
|
|
39
|
+
|
|
40
|
+
//# sourceMappingURL=memo.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memo.js","names":[],"sources":["../../src/surfacing/memo.ts"],"sourcesContent":["import { currentTime } from '../core/clock'\n\n/** The most entries one instance keeps in memory. */\nexport const MEMO_CAPACITY = 500\n\n/** How long an aggregate read is answered from memory before the store is asked again. */\nexport const AGGREGATE_MEMO_MS = 15_000\n\n/**\n * In-process LRU cache in front of the store, one per Payload instance, each entry with its own\n * TTL. Values are shared between callers, so none may change one.\n */\nexport interface Memo<V> {\n\tget(key: string): V | undefined\n\t/** Keeps `value` for `ttlMs`; nothing is kept for a time of zero or less. */\n\tset(key: string, value: V, ttlMs: number): void\n\tdelete(key: string): void\n\treadonly size: number\n}\n\nexport const createMemo = <V>(options: { capacity?: number; now?: () => number } = {}): Memo<V> => {\n\tconst capacity = options.capacity ?? MEMO_CAPACITY\n\tconst now = options.now ?? currentTime\n\t// A Map iterates in insertion order, so re-inserting on use keeps the least recent first.\n\tconst entries = new Map<string, { value: V; expiresAt: number }>()\n\treturn {\n\t\tget(key) {\n\t\t\tconst entry = entries.get(key)\n\t\t\tif (!entry) {\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t\tentries.delete(key)\n\t\t\tif (entry.expiresAt <= now()) {\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t\tentries.set(key, entry)\n\t\t\treturn entry.value\n\t\t},\n\t\tset(key, value, ttlMs) {\n\t\t\tentries.delete(key)\n\t\t\tif (!(ttlMs > 0)) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tentries.set(key, { value, expiresAt: now() + ttlMs })\n\t\t\tfor (const oldest of entries.keys()) {\n\t\t\t\tif (entries.size <= capacity) {\n\t\t\t\t\tbreak\n\t\t\t\t}\n\t\t\t\tentries.delete(oldest)\n\t\t\t}\n\t\t},\n\t\tdelete(key) {\n\t\t\tentries.delete(key)\n\t\t},\n\t\tget size() {\n\t\t\treturn entries.size\n\t\t},\n\t}\n}\n"],"mappings":";;AAMA,MAAa,oBAAoB;AAcjC,MAAa,cAAiB,UAAqD,CAAC,MAAe;CAClG,MAAM,WAAW,QAAQ,YAAA;CACzB,MAAM,MAAM,QAAQ,OAAO;CAE3B,MAAM,0BAAU,IAAI,IAA6C;CACjE,OAAO;EACN,IAAI,KAAK;GACR,MAAM,QAAQ,QAAQ,IAAI,GAAG;GAC7B,IAAI,CAAC,OACJ;GAED,QAAQ,OAAO,GAAG;GAClB,IAAI,MAAM,aAAa,IAAI,GAC1B;GAED,QAAQ,IAAI,KAAK,KAAK;GACtB,OAAO,MAAM;EACd;EACA,IAAI,KAAK,OAAO,OAAO;GACtB,QAAQ,OAAO,GAAG;GAClB,IAAI,EAAE,QAAQ,IACb;GAED,QAAQ,IAAI,KAAK;IAAE;IAAO,WAAW,IAAI,IAAI;GAAM,CAAC;GACpD,KAAK,MAAM,UAAU,QAAQ,KAAK,GAAG;IACpC,IAAI,QAAQ,QAAQ,UACnB;IAED,QAAQ,OAAO,MAAM;GACtB;EACD;EACA,OAAO,KAAK;GACX,QAAQ,OAAO,GAAG;EACnB;EACA,IAAI,OAAO;GACV,OAAO,QAAQ;EAChB;CACD;AACD"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { };
|
|
@@ -1,6 +1,13 @@
|
|
|
1
|
+
import { HOUR_MS, MINUTE_MS } from "../timeframe/tz.js";
|
|
2
|
+
import { monotonicMs } from "../core/monotonic.js";
|
|
1
3
|
//#region src/surfacing/rateLimiter.ts
|
|
2
|
-
const
|
|
3
|
-
|
|
4
|
+
const RANK = {
|
|
5
|
+
interactive: 0,
|
|
6
|
+
normal: 1,
|
|
7
|
+
background: 2
|
|
8
|
+
};
|
|
9
|
+
/** The first of `waiting` with the most urgent priority. */
|
|
10
|
+
const mostUrgent = (waiting) => waiting.reduce((best, each) => best === void 0 || RANK[each.priority] < RANK[best.priority] ? each : best, void 0);
|
|
4
11
|
const createBucket = (capacity, windowMs) => {
|
|
5
12
|
const intervalMs = windowMs / capacity;
|
|
6
13
|
let tokens = capacity;
|
|
@@ -19,8 +26,7 @@ const createBucket = (capacity, windowMs) => {
|
|
|
19
26
|
return {
|
|
20
27
|
waitMs(now) {
|
|
21
28
|
sync(now);
|
|
22
|
-
|
|
23
|
-
return Math.ceil((1 - tokens) * intervalMs);
|
|
29
|
+
return tokens >= 1 ? 0 : Math.ceil((1 - tokens) * intervalMs);
|
|
24
30
|
},
|
|
25
31
|
take(now) {
|
|
26
32
|
sync(now);
|
|
@@ -28,103 +34,72 @@ const createBucket = (capacity, windowMs) => {
|
|
|
28
34
|
}
|
|
29
35
|
};
|
|
30
36
|
};
|
|
31
|
-
const
|
|
32
|
-
|
|
33
|
-
return new Promise((resolve, reject) => {
|
|
34
|
-
const timer = setTimeout(() => {
|
|
35
|
-
signal?.removeEventListener("abort", onAbort);
|
|
36
|
-
resolve();
|
|
37
|
-
}, ms);
|
|
38
|
-
const onAbort = () => {
|
|
39
|
-
clearTimeout(timer);
|
|
40
|
-
reject(signal?.reason);
|
|
41
|
-
};
|
|
42
|
-
signal?.addEventListener("abort", onAbort, { once: true });
|
|
43
|
-
});
|
|
44
|
-
};
|
|
45
|
-
/**
|
|
46
|
-
* Waits until every bucket holds a token, then deducts one from each. Bucket checks and
|
|
47
|
-
* deductions happen synchronously (no await between them) so a zero-wait pass can never
|
|
48
|
-
* race; a non-zero wait rechecks after sleeping since a concurrent taker may have spent
|
|
49
|
-
* the token first.
|
|
50
|
-
*/
|
|
51
|
-
const acquireTokens = async (buckets, clock, signal) => {
|
|
52
|
-
for (;;) {
|
|
37
|
+
const UNLIMITED = {
|
|
38
|
+
take: async ({ signal }) => {
|
|
53
39
|
if (signal?.aborted) throw signal.reason;
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
if (maxWait === 0) {
|
|
57
|
-
for (const bucket of buckets) bucket.take(now);
|
|
58
|
-
return;
|
|
59
|
-
}
|
|
60
|
-
await sleep(maxWait, signal);
|
|
61
|
-
}
|
|
62
|
-
};
|
|
63
|
-
const createSemaphore = (capacity) => {
|
|
64
|
-
let active = 0;
|
|
65
|
-
const waiters = [];
|
|
66
|
-
const release = () => {
|
|
67
|
-
active--;
|
|
68
|
-
waiters.shift()?.();
|
|
69
|
-
};
|
|
70
|
-
return { acquire(signal) {
|
|
71
|
-
if (signal?.aborted) return Promise.reject(signal.reason);
|
|
72
|
-
if (active < capacity) {
|
|
73
|
-
active++;
|
|
74
|
-
return Promise.resolve(release);
|
|
75
|
-
}
|
|
76
|
-
return new Promise((resolve, reject) => {
|
|
77
|
-
const onAbort = () => {
|
|
78
|
-
const idx = waiters.indexOf(grant);
|
|
79
|
-
if (idx !== -1) waiters.splice(idx, 1);
|
|
80
|
-
reject(signal?.reason);
|
|
81
|
-
};
|
|
82
|
-
const grant = () => {
|
|
83
|
-
signal?.removeEventListener("abort", onAbort);
|
|
84
|
-
active++;
|
|
85
|
-
resolve(release);
|
|
86
|
-
};
|
|
87
|
-
waiters.push(grant);
|
|
88
|
-
signal?.addEventListener("abort", onAbort, { once: true });
|
|
89
|
-
});
|
|
90
|
-
} };
|
|
40
|
+
},
|
|
41
|
+
waiting: 0
|
|
91
42
|
};
|
|
92
|
-
const noopRelease = () => {};
|
|
93
43
|
/**
|
|
94
|
-
*
|
|
95
|
-
*
|
|
96
|
-
* their own continuously refilling token bucket and a take needs a token from every
|
|
97
|
-
* configured bucket; maxConcurrent is a plain semaphore released by the returned function.
|
|
98
|
-
* Token deductions are never released; they represent quota already spent.
|
|
44
|
+
* The token source a descriptor declares: one refilling bucket per named window, a take needing a
|
|
45
|
+
* token from each. `maxConcurrent` is not a token; the lane turns it into its slot count.
|
|
99
46
|
*/
|
|
100
|
-
const
|
|
101
|
-
if (!descriptor) return { take: async () => noopRelease };
|
|
47
|
+
const createTokenSource = (descriptor, now = monotonicMs) => {
|
|
102
48
|
const buckets = [];
|
|
103
|
-
if (descriptor
|
|
104
|
-
if (descriptor
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
49
|
+
if (descriptor?.requestsPerMinute) buckets.push(createBucket(descriptor.requestsPerMinute, MINUTE_MS));
|
|
50
|
+
if (descriptor?.requestsPerHour) buckets.push(createBucket(descriptor.requestsPerHour, HOUR_MS));
|
|
51
|
+
if (buckets.length === 0) return UNLIMITED;
|
|
52
|
+
const takers = [];
|
|
53
|
+
let timer;
|
|
54
|
+
const next = () => mostUrgent(takers);
|
|
55
|
+
const pump = () => {
|
|
56
|
+
clearTimeout(timer);
|
|
57
|
+
timer = void 0;
|
|
58
|
+
for (;;) {
|
|
59
|
+
const taker = next();
|
|
60
|
+
if (!taker) return;
|
|
61
|
+
const at = now();
|
|
62
|
+
const waitMs = buckets.reduce((max, bucket) => Math.max(max, bucket.waitMs(at)), 0);
|
|
63
|
+
if (waitMs > 0) {
|
|
64
|
+
timer = setTimeout(pump, waitMs);
|
|
65
|
+
timer.unref?.();
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
for (const bucket of buckets) bucket.take(at);
|
|
69
|
+
takers.splice(takers.indexOf(taker), 1);
|
|
70
|
+
taker.grant();
|
|
115
71
|
}
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
72
|
+
};
|
|
73
|
+
return {
|
|
74
|
+
take({ signal, priority }) {
|
|
75
|
+
if (signal?.aborted) return Promise.reject(signal.reason);
|
|
76
|
+
return new Promise((resolve, reject) => {
|
|
77
|
+
const onAbort = () => {
|
|
78
|
+
const index = takers.indexOf(taker);
|
|
79
|
+
if (index !== -1) {
|
|
80
|
+
takers.splice(index, 1);
|
|
81
|
+
pump();
|
|
82
|
+
}
|
|
83
|
+
reject(signal?.reason);
|
|
84
|
+
};
|
|
85
|
+
const taker = {
|
|
86
|
+
priority,
|
|
87
|
+
grant: () => {
|
|
88
|
+
signal?.removeEventListener("abort", onAbort);
|
|
89
|
+
resolve();
|
|
90
|
+
}
|
|
91
|
+
};
|
|
92
|
+
takers.push(taker);
|
|
93
|
+
signal?.addEventListener("abort", onAbort, { once: true });
|
|
94
|
+
pump();
|
|
95
|
+
});
|
|
96
|
+
},
|
|
97
|
+
get waiting() {
|
|
98
|
+
return takers.length;
|
|
99
|
+
}
|
|
100
|
+
};
|
|
126
101
|
};
|
|
127
102
|
//#endregion
|
|
128
|
-
export {
|
|
103
|
+
export { createTokenSource, mostUrgent };
|
|
129
104
|
|
|
130
105
|
//# sourceMappingURL=rateLimiter.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rateLimiter.js","names":[],"sources":["../../src/surfacing/rateLimiter.ts"],"sourcesContent":["import type {
|
|
1
|
+
{"version":3,"file":"rateLimiter.js","names":[],"sources":["../../src/surfacing/rateLimiter.ts"],"sourcesContent":["import type { RateLimitDescriptor } from '../core/contract'\nimport { monotonicMs } from '../core/monotonic'\nimport { HOUR_MS, MINUTE_MS } from '../timeframe/tz'\n\n/**\n * Who is asking, the first served first: a reader of an open panel or view, any other reader (a\n * sidebar stat, host code), or work nobody waits on (refreshes, jobs).\n */\nexport type Priority = 'interactive' | 'normal' | 'background'\n\nconst RANK: Readonly<Record<Priority, number>> = { interactive: 0, normal: 1, background: 2 }\n\n/** The first of `waiting` with the most urgent priority. */\nexport const mostUrgent = <T extends { priority: Priority }>(\n\twaiting: readonly T[]\n): T | undefined =>\n\twaiting.reduce<T | undefined>(\n\t\t(best, each) => (best === undefined || RANK[each.priority] < RANK[best.priority] ? each : best),\n\t\tundefined\n\t)\n\n/**\n * The quota of one source: one token per upstream request, from every bucket its\n * `rateLimit` declares. Tokens are spent, never given back.\n */\nexport interface TokenSource {\n\t/**\n\t * Resolves once a token is spent for one upstream request, the most urgent taker first, each\n\t * priority in arrival order. Rejects with the signal's reason when it aborts first.\n\t */\n\ttake(options: { signal?: AbortSignal; priority: Priority }): Promise<void>\n\t/** Takers still waiting, for tests and health. */\n\treadonly waiting: number\n}\n\ninterface TokenBucket {\n\twaitMs(now: number): number\n\ttake(now: number): void\n}\n\nconst createBucket = (capacity: number, windowMs: number): TokenBucket => {\n\t// ms per token, rather than tokens per ms: every descriptor in this codebase divides its window\n\t// evenly, so this stays exact where a capacity/windowMs rate would drift.\n\tconst intervalMs = windowMs / capacity\n\tlet tokens = capacity\n\tlet last: number | undefined\n\n\tconst sync = (now: number): void => {\n\t\tif (last === undefined) {\n\t\t\tlast = now\n\t\t\treturn\n\t\t}\n\t\tconst elapsed = now - last\n\t\tif (elapsed > 0) {\n\t\t\ttokens = Math.min(capacity, tokens + elapsed / intervalMs)\n\t\t\tlast = now\n\t\t}\n\t}\n\n\treturn {\n\t\twaitMs(now) {\n\t\t\tsync(now)\n\t\t\treturn tokens >= 1 ? 0 : Math.ceil((1 - tokens) * intervalMs)\n\t\t},\n\t\ttake(now) {\n\t\t\tsync(now)\n\t\t\ttokens -= 1\n\t\t},\n\t}\n}\n\ninterface Taker {\n\tpriority: Priority\n\tgrant: () => void\n}\n\nconst UNLIMITED: TokenSource = {\n\ttake: async ({ signal }) => {\n\t\tif (signal?.aborted) {\n\t\t\tthrow signal.reason\n\t\t}\n\t},\n\twaiting: 0,\n}\n\n/**\n * The token source a descriptor declares: one refilling bucket per named window, a take needing a\n * token from each. `maxConcurrent` is not a token; the lane turns it into its slot count.\n */\nexport const createTokenSource = (\n\tdescriptor: RateLimitDescriptor | null,\n\tnow: () => number = monotonicMs\n): TokenSource => {\n\tconst buckets: TokenBucket[] = []\n\tif (descriptor?.requestsPerMinute) {\n\t\tbuckets.push(createBucket(descriptor.requestsPerMinute, MINUTE_MS))\n\t}\n\tif (descriptor?.requestsPerHour) {\n\t\tbuckets.push(createBucket(descriptor.requestsPerHour, HOUR_MS))\n\t}\n\tif (buckets.length === 0) {\n\t\treturn UNLIMITED\n\t}\n\tconst takers: Taker[] = []\n\tlet timer: ReturnType<typeof setTimeout> | undefined\n\n\tconst next = (): Taker | undefined => mostUrgent(takers)\n\n\t// Bucket checks and deductions happen with no await between them, so two takers can never spend\n\t// one token; a taker that has to wait is granted by the single timer below, in priority order.\n\tconst pump = (): void => {\n\t\tclearTimeout(timer)\n\t\ttimer = undefined\n\t\tfor (;;) {\n\t\t\tconst taker = next()\n\t\t\tif (!taker) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst at = now()\n\t\t\tconst waitMs = buckets.reduce((max, bucket) => Math.max(max, bucket.waitMs(at)), 0)\n\t\t\tif (waitMs > 0) {\n\t\t\t\ttimer = setTimeout(pump, waitMs)\n\t\t\t\ttimer.unref?.()\n\t\t\t\treturn\n\t\t\t}\n\t\t\tfor (const bucket of buckets) {\n\t\t\t\tbucket.take(at)\n\t\t\t}\n\t\t\ttakers.splice(takers.indexOf(taker), 1)\n\t\t\ttaker.grant()\n\t\t}\n\t}\n\n\treturn {\n\t\ttake({ signal, priority }) {\n\t\t\tif (signal?.aborted) {\n\t\t\t\treturn Promise.reject(signal.reason)\n\t\t\t}\n\t\t\treturn new Promise<void>((resolve, reject) => {\n\t\t\t\tconst onAbort = (): void => {\n\t\t\t\t\tconst index = takers.indexOf(taker)\n\t\t\t\t\tif (index !== -1) {\n\t\t\t\t\t\ttakers.splice(index, 1)\n\t\t\t\t\t\tpump()\n\t\t\t\t\t}\n\t\t\t\t\treject(signal?.reason)\n\t\t\t\t}\n\t\t\t\tconst taker: Taker = {\n\t\t\t\t\tpriority,\n\t\t\t\t\tgrant: () => {\n\t\t\t\t\t\tsignal?.removeEventListener('abort', onAbort)\n\t\t\t\t\t\tresolve()\n\t\t\t\t\t},\n\t\t\t\t}\n\t\t\t\ttakers.push(taker)\n\t\t\t\tsignal?.addEventListener('abort', onAbort, { once: true })\n\t\t\t\tpump()\n\t\t\t})\n\t\t},\n\t\tget waiting() {\n\t\t\treturn takers.length\n\t\t},\n\t}\n}\n"],"mappings":";;;AAUA,MAAM,OAA2C;CAAE,aAAa;CAAG,QAAQ;CAAG,YAAY;AAAE;;AAG5F,MAAa,cACZ,YAEA,QAAQ,QACN,MAAM,SAAU,SAAS,KAAA,KAAa,KAAK,KAAK,YAAY,KAAK,KAAK,YAAY,OAAO,MAC1F,KAAA,CACD;AAqBD,MAAM,gBAAgB,UAAkB,aAAkC;CAGzE,MAAM,aAAa,WAAW;CAC9B,IAAI,SAAS;CACb,IAAI;CAEJ,MAAM,QAAQ,QAAsB;EACnC,IAAI,SAAS,KAAA,GAAW;GACvB,OAAO;GACP;EACD;EACA,MAAM,UAAU,MAAM;EACtB,IAAI,UAAU,GAAG;GAChB,SAAS,KAAK,IAAI,UAAU,SAAS,UAAU,UAAU;GACzD,OAAO;EACR;CACD;CAEA,OAAO;EACN,OAAO,KAAK;GACX,KAAK,GAAG;GACR,OAAO,UAAU,IAAI,IAAI,KAAK,MAAM,IAAI,UAAU,UAAU;EAC7D;EACA,KAAK,KAAK;GACT,KAAK,GAAG;GACR,UAAU;EACX;CACD;AACD;AAOA,MAAM,YAAyB;CAC9B,MAAM,OAAO,EAAE,aAAa;EAC3B,IAAI,QAAQ,SACX,MAAM,OAAO;CAEf;CACA,SAAS;AACV;;;;;AAMA,MAAa,qBACZ,YACA,MAAoB,gBACH;CACjB,MAAM,UAAyB,CAAC;CAChC,IAAI,YAAY,mBACf,QAAQ,KAAK,aAAa,WAAW,mBAAmB,SAAS,CAAC;CAEnE,IAAI,YAAY,iBACf,QAAQ,KAAK,aAAa,WAAW,iBAAiB,OAAO,CAAC;CAE/D,IAAI,QAAQ,WAAW,GACtB,OAAO;CAER,MAAM,SAAkB,CAAC;CACzB,IAAI;CAEJ,MAAM,aAAgC,WAAW,MAAM;CAIvD,MAAM,aAAmB;EACxB,aAAa,KAAK;EAClB,QAAQ,KAAA;EACR,SAAS;GACR,MAAM,QAAQ,KAAK;GACnB,IAAI,CAAC,OACJ;GAED,MAAM,KAAK,IAAI;GACf,MAAM,SAAS,QAAQ,QAAQ,KAAK,WAAW,KAAK,IAAI,KAAK,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC;GAClF,IAAI,SAAS,GAAG;IACf,QAAQ,WAAW,MAAM,MAAM;IAC/B,MAAM,QAAQ;IACd;GACD;GACA,KAAK,MAAM,UAAU,SACpB,OAAO,KAAK,EAAE;GAEf,OAAO,OAAO,OAAO,QAAQ,KAAK,GAAG,CAAC;GACtC,MAAM,MAAM;EACb;CACD;CAEA,OAAO;EACN,KAAK,EAAE,QAAQ,YAAY;GAC1B,IAAI,QAAQ,SACX,OAAO,QAAQ,OAAO,OAAO,MAAM;GAEpC,OAAO,IAAI,SAAe,SAAS,WAAW;IAC7C,MAAM,gBAAsB;KAC3B,MAAM,QAAQ,OAAO,QAAQ,KAAK;KAClC,IAAI,UAAU,IAAI;MACjB,OAAO,OAAO,OAAO,CAAC;MACtB,KAAK;KACN;KACA,OAAO,QAAQ,MAAM;IACtB;IACA,MAAM,QAAe;KACpB;KACA,aAAa;MACZ,QAAQ,oBAAoB,SAAS,OAAO;MAC5C,QAAQ;KACT;IACD;IACA,OAAO,KAAK,KAAK;IACjB,QAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;IACzD,KAAK;GACN,CAAC;EACF;EACA,IAAI,UAAU;GACb,OAAO,OAAO;EACf;CACD;AACD"}
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
import { supportsGranularity } from "../core/granularity.js";
|
|
2
|
+
import "../timeframe/tz.js";
|
|
3
|
+
import { calendarDayOf, parseCalendarDay } from "../timeframe/calendar.js";
|
|
4
|
+
import { bucketInstant, bucketStartOf } from "../native/engine/buckets.js";
|
|
5
|
+
import { isAverageMetric } from "../core/metricValues.js";
|
|
6
|
+
//#region src/surfacing/rebucket.ts
|
|
7
|
+
/**
|
|
8
|
+
* The count an average is taken over, for a row that does not say (`AnalyticsRow.samples`):
|
|
9
|
+
* time and scroll per pageview, a bounce rate and a visit's length per visit.
|
|
10
|
+
*/
|
|
11
|
+
const WEIGHTS = {
|
|
12
|
+
avgDuration: ["pageviews"],
|
|
13
|
+
scrollDepth: ["pageviews"],
|
|
14
|
+
bounceRate: ["visits", "sessions"],
|
|
15
|
+
visitDuration: ["visits", "sessions"]
|
|
16
|
+
};
|
|
17
|
+
/**
|
|
18
|
+
* The plan for `q`, or undefined when it needs none: a series of weeks or months from a source
|
|
19
|
+
* that does not answer those itself but serves days.
|
|
20
|
+
*/
|
|
21
|
+
const rebucketPlan = (q, caps) => {
|
|
22
|
+
const unit = q.granularity;
|
|
23
|
+
if (unit !== "week" && unit !== "month" || caps.calendarBuckets === true) return;
|
|
24
|
+
if (!supportsGranularity(caps, "day")) return;
|
|
25
|
+
const asked = new Set(q.metrics);
|
|
26
|
+
const weights = /* @__PURE__ */ new Set();
|
|
27
|
+
for (const metric of q.metrics) {
|
|
28
|
+
const candidates = WEIGHTS[metric] ?? [];
|
|
29
|
+
if (candidates.some((candidate) => asked.has(candidate))) continue;
|
|
30
|
+
const weight = candidates.find((candidate) => caps.metrics.has(candidate));
|
|
31
|
+
if (weight !== void 0) weights.add(weight);
|
|
32
|
+
}
|
|
33
|
+
return {
|
|
34
|
+
unit,
|
|
35
|
+
weights: [...weights]
|
|
36
|
+
};
|
|
37
|
+
};
|
|
38
|
+
/** The read the adapter is given for a plan: days, with the weights beside the asked metrics. */
|
|
39
|
+
const dayRead = (q, plan) => ({
|
|
40
|
+
...q,
|
|
41
|
+
granularity: "day",
|
|
42
|
+
metrics: [...q.metrics, ...plan.weights]
|
|
43
|
+
});
|
|
44
|
+
/**
|
|
45
|
+
* The local date a day row names: a vendor's UTC midnight labels that date, any other instant
|
|
46
|
+
* starts a day in the read's zone; a zone whose days start at UTC midnight is UTC, so both agree.
|
|
47
|
+
*/
|
|
48
|
+
const dayOfTimestamp = (timestamp, tz) => {
|
|
49
|
+
const bare = parseCalendarDay(timestamp);
|
|
50
|
+
if (bare !== null) return bare;
|
|
51
|
+
const at = new Date(timestamp);
|
|
52
|
+
if (Number.isNaN(at.getTime())) return null;
|
|
53
|
+
return at.getTime() % 864e5 === 0 ? calendarDayOf(at, "UTC") : calendarDayOf(at, tz);
|
|
54
|
+
};
|
|
55
|
+
const nonNegative = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
|
|
56
|
+
/** What one row's reading of an average counts for: its own samples, else its matching count. */
|
|
57
|
+
const weightOf = (row, metric) => {
|
|
58
|
+
const own = nonNegative(row.samples?.[metric]);
|
|
59
|
+
if (own !== void 0) return own;
|
|
60
|
+
for (const candidate of WEIGHTS[metric] ?? []) {
|
|
61
|
+
const count = nonNegative(row.metrics[candidate]);
|
|
62
|
+
if (count !== void 0) return count;
|
|
63
|
+
}
|
|
64
|
+
};
|
|
65
|
+
/**
|
|
66
|
+
* One average over several rows: weighted when every reading has a weight, so a week is the
|
|
67
|
+
* mean of its visits rather than of its days; a plain mean otherwise, and `null` with no reading.
|
|
68
|
+
*/
|
|
69
|
+
const foldAverage = (rows, metric) => {
|
|
70
|
+
const readings = [];
|
|
71
|
+
for (const row of rows) {
|
|
72
|
+
const value = row.metrics[metric];
|
|
73
|
+
if (typeof value === "number" && Number.isFinite(value)) readings.push({
|
|
74
|
+
value,
|
|
75
|
+
weight: weightOf(row, metric)
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
if (readings.length === 0) return { value: null };
|
|
79
|
+
if (readings.some((reading) => reading.weight === void 0)) {
|
|
80
|
+
const sum = readings.reduce((total, reading) => total + reading.value, 0);
|
|
81
|
+
return { value: Math.round(sum / readings.length) };
|
|
82
|
+
}
|
|
83
|
+
let weights = 0;
|
|
84
|
+
let sum = 0;
|
|
85
|
+
for (const { value, weight = 0 } of readings) {
|
|
86
|
+
weights += weight;
|
|
87
|
+
sum += value * weight;
|
|
88
|
+
}
|
|
89
|
+
return weights > 0 ? {
|
|
90
|
+
value: Math.round(sum / weights),
|
|
91
|
+
samples: weights
|
|
92
|
+
} : {
|
|
93
|
+
value: null,
|
|
94
|
+
samples: 0
|
|
95
|
+
};
|
|
96
|
+
};
|
|
97
|
+
const foldCount = (rows, metric) => rows.reduce((sum, row) => {
|
|
98
|
+
const value = row.metrics[metric];
|
|
99
|
+
return typeof value === "number" && Number.isFinite(value) ? sum + value : sum;
|
|
100
|
+
}, 0);
|
|
101
|
+
/** `metrics` narrowed to the ones the read asked for, which drops the weights a plan added. */
|
|
102
|
+
const askedOnly = (metrics, asked) => {
|
|
103
|
+
const out = {};
|
|
104
|
+
for (const metric of asked) {
|
|
105
|
+
const value = metrics[metric];
|
|
106
|
+
if (value !== void 0) out[metric] = value;
|
|
107
|
+
}
|
|
108
|
+
return out;
|
|
109
|
+
};
|
|
110
|
+
const compareText = (a, b) => a < b ? -1 : a > b ? 1 : 0;
|
|
111
|
+
const dimensionKey = (dimensions) => JSON.stringify(Object.entries(dimensions ?? {}).filter(([, value]) => value !== void 0).sort(([a], [b]) => compareText(a, b)));
|
|
112
|
+
const foldBucket = (bucket, tz, asked) => {
|
|
113
|
+
const metrics = {};
|
|
114
|
+
const samples = {};
|
|
115
|
+
for (const metric of asked) {
|
|
116
|
+
if (!bucket.rows.some((row) => row.metrics[metric] !== void 0)) continue;
|
|
117
|
+
if (!isAverageMetric(metric)) {
|
|
118
|
+
metrics[metric] = foldCount(bucket.rows, metric);
|
|
119
|
+
continue;
|
|
120
|
+
}
|
|
121
|
+
const folded = foldAverage(bucket.rows, metric);
|
|
122
|
+
metrics[metric] = folded.value;
|
|
123
|
+
if (folded.samples !== void 0) samples[metric] = folded.samples;
|
|
124
|
+
}
|
|
125
|
+
return {
|
|
126
|
+
...bucket.dimensions === void 0 ? {} : { dimensions: bucket.dimensions },
|
|
127
|
+
timestamp: bucketInstant(bucket.start, tz).toISOString(),
|
|
128
|
+
metrics,
|
|
129
|
+
...Object.keys(samples).length > 0 ? { samples } : {}
|
|
130
|
+
};
|
|
131
|
+
};
|
|
132
|
+
/**
|
|
133
|
+
* A day series folded into the asked weeks or months in the reporting zone: counts add, averages
|
|
134
|
+
* are weighted, visitors add per day (so a multi-day bucket marks the read `sumOfDaily`).
|
|
135
|
+
*/
|
|
136
|
+
const foldResult = (result, q, plan) => {
|
|
137
|
+
const tz = q.timezone ?? "UTC";
|
|
138
|
+
const passthrough = [];
|
|
139
|
+
const buckets = /* @__PURE__ */ new Map();
|
|
140
|
+
for (const row of result.rows) {
|
|
141
|
+
if (row.timestamp === void 0) {
|
|
142
|
+
passthrough.push(plan.weights.length === 0 ? row : {
|
|
143
|
+
...row,
|
|
144
|
+
metrics: askedOnly(row.metrics, q.metrics)
|
|
145
|
+
});
|
|
146
|
+
continue;
|
|
147
|
+
}
|
|
148
|
+
const day = dayOfTimestamp(row.timestamp, tz);
|
|
149
|
+
if (day === null) continue;
|
|
150
|
+
const start = bucketStartOf(day, plan.unit);
|
|
151
|
+
const key = `${dimensionKey(row.dimensions)}|${start}`;
|
|
152
|
+
const bucket = buckets.get(key) ?? {
|
|
153
|
+
key,
|
|
154
|
+
dimensions: row.dimensions,
|
|
155
|
+
start,
|
|
156
|
+
rows: [],
|
|
157
|
+
visitorDays: /* @__PURE__ */ new Set()
|
|
158
|
+
};
|
|
159
|
+
bucket.rows.push(row);
|
|
160
|
+
if (typeof row.metrics.visitors === "number") bucket.visitorDays.add(day);
|
|
161
|
+
buckets.set(key, bucket);
|
|
162
|
+
}
|
|
163
|
+
const ordered = [...buckets.values()].sort((a, b) => compareText(a.key, b.key));
|
|
164
|
+
const meta = q.metrics.includes("visitors") && ordered.some((bucket) => bucket.visitorDays.size > 1) ? {
|
|
165
|
+
...result.meta,
|
|
166
|
+
visitorsAre: "sumOfDaily"
|
|
167
|
+
} : result.meta;
|
|
168
|
+
return {
|
|
169
|
+
...result,
|
|
170
|
+
rows: [...passthrough, ...ordered.map((bucket) => foldBucket(bucket, tz, q.metrics))],
|
|
171
|
+
...result.totals === void 0 || plan.weights.length === 0 ? {} : { totals: askedOnly(result.totals, q.metrics) },
|
|
172
|
+
meta
|
|
173
|
+
};
|
|
174
|
+
};
|
|
175
|
+
//#endregion
|
|
176
|
+
export { dayOfTimestamp, dayRead, foldResult, rebucketPlan };
|
|
177
|
+
|
|
178
|
+
//# sourceMappingURL=rebucket.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rebucket.js","names":[],"sources":["../../src/surfacing/rebucket.ts"],"sourcesContent":["import type {\n\tAnalyticsCapabilities,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tAnalyticsRow,\n\tMetricKey,\n\tMetricValue,\n\tMetricValues,\n} from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { isAverageMetric } from '../core/metricValues'\nimport { bucketInstant, bucketStartOf, type CalendarUnit } from '../native/engine/buckets'\nimport { type CalendarDay, calendarDayOf, parseCalendarDay } from '../timeframe/calendar'\nimport { DAY_MS, DEFAULT_TIMEZONE } from '../timeframe/tz'\n\n/**\n * The count an average is taken over, for a row that does not say (`AnalyticsRow.samples`):\n * time and scroll per pageview, a bounce rate and a visit's length per visit.\n */\nconst WEIGHTS: Partial<Record<MetricKey, readonly MetricKey[]>> = {\n\tavgDuration: ['pageviews'],\n\tscrollDepth: ['pageviews'],\n\tbounceRate: ['visits', 'sessions'],\n\tvisitDuration: ['visits', 'sessions'],\n}\n\n/** How the engine reads a week or month series from a source that buckets no coarser than days. */\nexport interface RebucketPlan {\n\tunit: CalendarUnit\n\t/** Counts the read adds only to weigh its averages, and strips from the answer again. */\n\tweights: MetricKey[]\n}\n\n/**\n * The plan for `q`, or undefined when it needs none: a series of weeks or months from a source\n * that does not answer those itself but serves days.\n */\nexport const rebucketPlan = (\n\tq: AnalyticsQuery,\n\tcaps: AnalyticsCapabilities\n): RebucketPlan | undefined => {\n\tconst unit = q.granularity\n\tif ((unit !== 'week' && unit !== 'month') || caps.calendarBuckets === true) {\n\t\treturn undefined\n\t}\n\tif (!supportsGranularity(caps, 'day')) {\n\t\treturn undefined\n\t}\n\tconst asked = new Set(q.metrics)\n\tconst weights = new Set<MetricKey>()\n\tfor (const metric of q.metrics) {\n\t\tconst candidates = WEIGHTS[metric] ?? []\n\t\tif (candidates.some((candidate) => asked.has(candidate))) {\n\t\t\tcontinue\n\t\t}\n\t\tconst weight = candidates.find((candidate) => caps.metrics.has(candidate))\n\t\tif (weight !== undefined) {\n\t\t\tweights.add(weight)\n\t\t}\n\t}\n\treturn { unit, weights: [...weights] }\n}\n\n/** The read the adapter is given for a plan: days, with the weights beside the asked metrics. */\nexport const dayRead = (q: AnalyticsQuery, plan: RebucketPlan): AnalyticsQuery => ({\n\t...q,\n\tgranularity: 'day',\n\tmetrics: [...q.metrics, ...plan.weights],\n})\n\n/**\n * The local date a day row names: a vendor's UTC midnight labels that date, any other instant\n * starts a day in the read's zone; a zone whose days start at UTC midnight is UTC, so both agree.\n */\nexport const dayOfTimestamp = (timestamp: string, tz: string): CalendarDay | null => {\n\tconst bare = parseCalendarDay(timestamp)\n\tif (bare !== null) {\n\t\treturn bare\n\t}\n\tconst at = new Date(timestamp)\n\tif (Number.isNaN(at.getTime())) {\n\t\treturn null\n\t}\n\treturn at.getTime() % DAY_MS === 0 ? calendarDayOf(at, 'UTC') : calendarDayOf(at, tz)\n}\n\nconst nonNegative = (value: unknown): number | undefined =>\n\ttypeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined\n\n/** What one row's reading of an average counts for: its own samples, else its matching count. */\nconst weightOf = (row: AnalyticsRow, metric: MetricKey): number | undefined => {\n\tconst own = nonNegative(row.samples?.[metric])\n\tif (own !== undefined) {\n\t\treturn own\n\t}\n\tfor (const candidate of WEIGHTS[metric] ?? []) {\n\t\tconst count = nonNegative(row.metrics[candidate])\n\t\tif (count !== undefined) {\n\t\t\treturn count\n\t\t}\n\t}\n\treturn undefined\n}\n\ninterface Folded {\n\tvalue: MetricValue\n\tsamples?: number\n}\n\n/**\n * One average over several rows: weighted when every reading has a weight, so a week is the\n * mean of its visits rather than of its days; a plain mean otherwise, and `null` with no reading.\n */\nconst foldAverage = (rows: readonly AnalyticsRow[], metric: MetricKey): Folded => {\n\tconst readings: Array<{ value: number; weight: number | undefined }> = []\n\tfor (const row of rows) {\n\t\tconst value = row.metrics[metric]\n\t\tif (typeof value === 'number' && Number.isFinite(value)) {\n\t\t\treadings.push({ value, weight: weightOf(row, metric) })\n\t\t}\n\t}\n\tif (readings.length === 0) {\n\t\treturn { value: null }\n\t}\n\tif (readings.some((reading) => reading.weight === undefined)) {\n\t\tconst sum = readings.reduce((total, reading) => total + reading.value, 0)\n\t\treturn { value: Math.round(sum / readings.length) }\n\t}\n\tlet weights = 0\n\tlet sum = 0\n\tfor (const { value, weight = 0 } of readings) {\n\t\tweights += weight\n\t\tsum += value * weight\n\t}\n\treturn weights > 0\n\t\t? { value: Math.round(sum / weights), samples: weights }\n\t\t: { value: null, samples: 0 }\n}\n\nconst foldCount = (rows: readonly AnalyticsRow[], metric: MetricKey): number =>\n\trows.reduce((sum, row) => {\n\t\tconst value = row.metrics[metric]\n\t\treturn typeof value === 'number' && Number.isFinite(value) ? sum + value : sum\n\t}, 0)\n\n/** `metrics` narrowed to the ones the read asked for, which drops the weights a plan added. */\nconst askedOnly = (metrics: MetricValues, asked: readonly MetricKey[]): MetricValues => {\n\tconst out: MetricValues = {}\n\tfor (const metric of asked) {\n\t\tconst value = metrics[metric]\n\t\tif (value !== undefined) {\n\t\t\tout[metric] = value\n\t\t}\n\t}\n\treturn out\n}\n\nconst compareText = (a: string, b: string): number => (a < b ? -1 : a > b ? 1 : 0)\n\nconst dimensionKey = (dimensions: AnalyticsRow['dimensions']): string =>\n\tJSON.stringify(\n\t\tObject.entries(dimensions ?? {})\n\t\t\t.filter(([, value]) => value !== undefined)\n\t\t\t.sort(([a], [b]) => compareText(a, b))\n\t)\n\ninterface Bucket {\n\tkey: string\n\tdimensions: AnalyticsRow['dimensions']\n\tstart: CalendarDay\n\trows: AnalyticsRow[]\n\t/** The days whose rows counted visitors. */\n\tvisitorDays: Set<CalendarDay>\n}\n\nconst foldBucket = (bucket: Bucket, tz: string, asked: readonly MetricKey[]): AnalyticsRow => {\n\tconst metrics: MetricValues = {}\n\tconst samples: Partial<Record<MetricKey, number>> = {}\n\tfor (const metric of asked) {\n\t\tif (!bucket.rows.some((row) => row.metrics[metric] !== undefined)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (!isAverageMetric(metric)) {\n\t\t\tmetrics[metric] = foldCount(bucket.rows, metric)\n\t\t\tcontinue\n\t\t}\n\t\tconst folded = foldAverage(bucket.rows, metric)\n\t\tmetrics[metric] = folded.value\n\t\tif (folded.samples !== undefined) {\n\t\t\tsamples[metric] = folded.samples\n\t\t}\n\t}\n\treturn {\n\t\t...(bucket.dimensions === undefined ? {} : { dimensions: bucket.dimensions }),\n\t\ttimestamp: bucketInstant(bucket.start, tz).toISOString(),\n\t\tmetrics,\n\t\t...(Object.keys(samples).length > 0 ? { samples } : {}),\n\t}\n}\n\n/**\n * A day series folded into the asked weeks or months in the reporting zone: counts add, averages\n * are weighted, visitors add per day (so a multi-day bucket marks the read `sumOfDaily`).\n */\nexport const foldResult = (\n\tresult: AnalyticsResult,\n\tq: AnalyticsQuery,\n\tplan: RebucketPlan\n): AnalyticsResult => {\n\tconst tz = q.timezone ?? DEFAULT_TIMEZONE\n\tconst passthrough: AnalyticsRow[] = []\n\tconst buckets = new Map<string, Bucket>()\n\tfor (const row of result.rows) {\n\t\tif (row.timestamp === undefined) {\n\t\t\tpassthrough.push(\n\t\t\t\tplan.weights.length === 0 ? row : { ...row, metrics: askedOnly(row.metrics, q.metrics) }\n\t\t\t)\n\t\t\tcontinue\n\t\t}\n\t\tconst day = dayOfTimestamp(row.timestamp, tz)\n\t\tif (day === null) {\n\t\t\tcontinue\n\t\t}\n\t\tconst start = bucketStartOf(day, plan.unit)\n\t\tconst key = `${dimensionKey(row.dimensions)}|${start}`\n\t\tconst bucket = buckets.get(key) ?? {\n\t\t\tkey,\n\t\t\tdimensions: row.dimensions,\n\t\t\tstart,\n\t\t\trows: [],\n\t\t\tvisitorDays: new Set<CalendarDay>(),\n\t\t}\n\t\tbucket.rows.push(row)\n\t\tif (typeof row.metrics.visitors === 'number') {\n\t\t\tbucket.visitorDays.add(day)\n\t\t}\n\t\tbuckets.set(key, bucket)\n\t}\n\tconst ordered = [...buckets.values()].sort((a, b) => compareText(a.key, b.key))\n\tconst summed =\n\t\tq.metrics.includes('visitors') && ordered.some((bucket) => bucket.visitorDays.size > 1)\n\tconst meta: AnalyticsResult['meta'] = summed\n\t\t? { ...result.meta, visitorsAre: 'sumOfDaily' }\n\t\t: result.meta\n\treturn {\n\t\t...result,\n\t\trows: [...passthrough, ...ordered.map((bucket) => foldBucket(bucket, tz, q.metrics))],\n\t\t...(result.totals === undefined || plan.weights.length === 0\n\t\t\t? {}\n\t\t\t: { totals: askedOnly(result.totals, q.metrics) }),\n\t\tmeta,\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { addDaysInTz, startOfDayInTz } from "../timeframe/tz.js";
|
|
2
|
+
import { resolveTimeframe } from "../timeframe/presets.js";
|
|
3
|
+
import { previousWindow } from "../timeframe/comparison.js";
|
|
4
|
+
//#region src/surfacing/recipe.ts
|
|
5
|
+
/** Every window a recipe can name, in the order a read is matched against them. */
|
|
6
|
+
const RECIPE_WINDOWS = [
|
|
7
|
+
"live",
|
|
8
|
+
"days",
|
|
9
|
+
"previous"
|
|
10
|
+
];
|
|
11
|
+
const isRecipeWindow = (value) => RECIPE_WINDOWS.some((window) => window === value);
|
|
12
|
+
/**
|
|
13
|
+
* The window a recipe names at `now` in `tz` (see `RecipeWindow`); null where the preset has no
|
|
14
|
+
* previous window (a range longer than a year).
|
|
15
|
+
*/
|
|
16
|
+
const recipeWindow = (recipe, now, tz) => {
|
|
17
|
+
const live = resolveTimeframe(recipe.timeframe, now, tz);
|
|
18
|
+
if (recipe.window === "live") return live;
|
|
19
|
+
if (recipe.window === "previous") return previousWindow(live, tz);
|
|
20
|
+
return {
|
|
21
|
+
start: startOfDayInTz(live.start, tz),
|
|
22
|
+
end: /* @__PURE__ */ new Date(addDaysInTz(live.end, 1, tz).getTime() - 1)
|
|
23
|
+
};
|
|
24
|
+
};
|
|
25
|
+
//#endregion
|
|
26
|
+
export { RECIPE_WINDOWS, isRecipeWindow, recipeWindow };
|
|
27
|
+
|
|
28
|
+
//# sourceMappingURL=recipe.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"recipe.js","names":[],"sources":["../../src/surfacing/recipe.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport { previousWindow } from '../timeframe/comparison'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport { addDaysInTz, startOfDayInTz } from '../timeframe/tz'\nimport type { RecipeWindow } from './cacheStore'\n\n/** Every window a recipe can name, in the order a read is matched against them. */\nexport const RECIPE_WINDOWS: readonly RecipeWindow[] = ['live', 'days', 'previous']\n\nexport const isRecipeWindow = (value: unknown): value is RecipeWindow =>\n\tRECIPE_WINDOWS.some((window) => window === value)\n\n/**\n * The window a recipe names at `now` in `tz` (see `RecipeWindow`); null where the preset has no\n * previous window (a range longer than a year).\n */\nexport const recipeWindow = (\n\trecipe: { timeframe: TimeframePreset; window: RecipeWindow },\n\tnow: Date,\n\ttz: string\n): DateRange | null => {\n\tconst live = resolveTimeframe(recipe.timeframe, now, tz)\n\tif (recipe.window === 'live') {\n\t\treturn live\n\t}\n\tif (recipe.window === 'previous') {\n\t\treturn previousWindow(live, tz)\n\t}\n\treturn {\n\t\tstart: startOfDayInTz(live.start, tz),\n\t\tend: new Date(addDaysInTz(live.end, 1, tz).getTime() - 1),\n\t}\n}\n"],"mappings":";;;;;AAOA,MAAa,iBAA0C;CAAC;CAAQ;CAAQ;AAAU;AAElF,MAAa,kBAAkB,UAC9B,eAAe,MAAM,WAAW,WAAW,KAAK;;;;;AAMjD,MAAa,gBACZ,QACA,KACA,OACsB;CACtB,MAAM,OAAO,iBAAiB,OAAO,WAAW,KAAK,EAAE;CACvD,IAAI,OAAO,WAAW,QACrB,OAAO;CAER,IAAI,OAAO,WAAW,YACrB,OAAO,eAAe,MAAM,EAAE;CAE/B,OAAO;EACN,OAAO,eAAe,KAAK,OAAO,EAAE;EACpC,qBAAK,IAAI,KAAK,YAAY,KAAK,KAAK,GAAG,EAAE,EAAE,QAAQ,IAAI,CAAC;CACzD;AACD"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { sortRowsByMetric } from "../core/metricValues.js";
|
|
2
|
+
//#region src/surfacing/shape.ts
|
|
3
|
+
/** A breakdown's rows: grouped by a dimension, with no timestamp, so their order is a ranking. */
|
|
4
|
+
const isRanking = (query, rows) => (query.dimensions?.length ?? 0) > 0 && rows.every((row) => row.timestamp === void 0);
|
|
5
|
+
/**
|
|
6
|
+
* A breakdown ranked by `order` (no value last, ties in source order, first metric descending
|
|
7
|
+
* when only `limit` is set) and cut to `limit`; an `order` on an unasked metric keeps source order.
|
|
8
|
+
*/
|
|
9
|
+
const shapeResult = (result, query) => {
|
|
10
|
+
const limit = query.limit !== void 0 && Number.isInteger(query.limit) && query.limit > 0 ? query.limit : void 0;
|
|
11
|
+
if (!isRanking(query, result.rows) || limit === void 0 && query.order === void 0) return result;
|
|
12
|
+
const metric = query.order?.metric ?? query.metrics[0];
|
|
13
|
+
const ranked = metric === void 0 ? result.rows : sortRowsByMetric(result.rows, metric, query.order?.direction ?? "desc");
|
|
14
|
+
return {
|
|
15
|
+
...result,
|
|
16
|
+
rows: limit === void 0 ? ranked : ranked.slice(0, limit)
|
|
17
|
+
};
|
|
18
|
+
};
|
|
19
|
+
//#endregion
|
|
20
|
+
export { shapeResult };
|
|
21
|
+
|
|
22
|
+
//# sourceMappingURL=shape.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shape.js","names":[],"sources":["../../src/surfacing/shape.ts"],"sourcesContent":["import type { AnalyticsQuery, AnalyticsResult, AnalyticsRow } from '../core/contract'\nimport { sortRowsByMetric } from '../core/metricValues'\n\n/** A breakdown's rows: grouped by a dimension, with no timestamp, so their order is a ranking. */\nconst isRanking = (query: AnalyticsQuery, rows: readonly AnalyticsRow[]): boolean =>\n\t(query.dimensions?.length ?? 0) > 0 && rows.every((row) => row.timestamp === undefined)\n\n/**\n * A breakdown ranked by `order` (no value last, ties in source order, first metric descending\n * when only `limit` is set) and cut to `limit`; an `order` on an unasked metric keeps source order.\n */\nexport const shapeResult = (result: AnalyticsResult, query: AnalyticsQuery): AnalyticsResult => {\n\tconst limit =\n\t\tquery.limit !== undefined && Number.isInteger(query.limit) && query.limit > 0\n\t\t\t? query.limit\n\t\t\t: undefined\n\tif (!isRanking(query, result.rows) || (limit === undefined && query.order === undefined)) {\n\t\treturn result\n\t}\n\tconst metric = query.order?.metric ?? query.metrics[0]\n\tconst ranked =\n\t\tmetric === undefined\n\t\t\t? result.rows\n\t\t\t: sortRowsByMetric(result.rows, metric, query.order?.direction ?? 'desc')\n\treturn { ...result, rows: limit === undefined ? ranked : ranked.slice(0, limit) }\n}\n"],"mappings":";;;AAIA,MAAM,aAAa,OAAuB,UACxC,MAAM,YAAY,UAAU,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,cAAc,KAAA,CAAS;;;;;AAMvF,MAAa,eAAe,QAAyB,UAA2C;CAC/F,MAAM,QACL,MAAM,UAAU,KAAA,KAAa,OAAO,UAAU,MAAM,KAAK,KAAK,MAAM,QAAQ,IACzE,MAAM,QACN,KAAA;CACJ,IAAI,CAAC,UAAU,OAAO,OAAO,IAAI,KAAM,UAAU,KAAA,KAAa,MAAM,UAAU,KAAA,GAC7E,OAAO;CAER,MAAM,SAAS,MAAM,OAAO,UAAU,MAAM,QAAQ;CACpD,MAAM,SACL,WAAW,KAAA,IACR,OAAO,OACP,iBAAiB,OAAO,MAAM,QAAQ,MAAM,OAAO,aAAa,MAAM;CAC1E,OAAO;EAAE,GAAG;EAAQ,MAAM,UAAU,KAAA,IAAY,SAAS,OAAO,MAAM,GAAG,KAAK;CAAE;AACjF"}
|