@10x-media/analytics 1.0.0-beta.8 → 4.0.0-alpha.1
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 +780 -0
- package/LICENSE +21 -21
- package/README.md +35 -36
- 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 +19 -0
- package/dist/adapters/ga4/disableKey.js.map +1 -0
- package/dist/adapters/ga4/eventName.d.ts +9 -0
- package/dist/adapters/ga4/eventName.js +13 -0
- package/dist/adapters/ga4/eventName.js.map +1 -0
- package/dist/adapters/ga4/ga4.d.ts +29 -0
- package/dist/adapters/ga4/ga4.js +324 -112
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +14 -0
- package/dist/adapters/ga4/measurementId.js.map +1 -0
- package/dist/adapters/goalRead.js +112 -0
- package/dist/adapters/goalRead.js.map +1 -0
- 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 +30 -3
- package/dist/adapters/plausible/plausible.js +198 -110
- 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 +33 -9
- package/dist/adapters/posthog/posthog.js +307 -127
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/posthog/projectCheck.js +56 -0
- package/dist/adapters/posthog/projectCheck.js.map +1 -0
- 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 +21 -3
- package/dist/adapters/umami/umami.js +334 -95
- 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 +28 -25
- 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 +49 -92
- 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 +131 -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/capture/withoutConsent.js +91 -0
- package/dist/capture/withoutConsent.js.map +1 -0
- package/dist/charts/BarList.d.ts +27 -13
- package/dist/charts/BarList.js +38 -77
- 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 +17 -1
- package/dist/charts/bars.js +12 -11
- 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 +198 -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 +51 -29
- 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 +101 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +59 -26
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +347 -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 +105 -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 +340 -49
- package/dist/core/contract.js +7 -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 +535 -151
- package/dist/core/options.js +158 -214
- 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 +114 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +349 -36
- 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 +50 -14
- 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/sourceLabel.d.ts +10 -0
- package/dist/core/sourceLabel.js +63 -0
- package/dist/core/sourceLabel.js.map +1 -0
- package/dist/core/sourceOptions.js +107 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/sourcePolicy.d.ts +55 -0
- package/dist/core/sourcePolicy.js +51 -0
- package/dist/core/sourcePolicy.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 +15 -0
- package/dist/exports/adapters/ga4.d.ts +17 -1
- package/dist/exports/adapters/ga4.js +2 -1
- package/dist/exports/adapters/native.d.ts +29 -2
- package/dist/exports/adapters/native.js +5 -1
- package/dist/exports/adapters/plausible.d.ts +16 -1
- package/dist/exports/adapters/posthog.d.ts +16 -1
- package/dist/exports/adapters/umami.d.ts +16 -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 +45 -11
- package/dist/exports/client.js +23 -6
- package/dist/exports/geo.d.ts +4 -2
- 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/react.d.ts +5 -3
- package/dist/exports/react.js +1 -2
- package/dist/exports/routes.d.ts +19 -0
- package/dist/exports/routes.js +3 -0
- package/dist/exports/rsc.d.ts +33 -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 +18 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +6 -17
- package/dist/exports/tracker.js +3 -11
- package/dist/exports/types.d.ts +46 -14
- package/dist/exports/types.js +7 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +19 -7
- package/dist/fields/AnalyticsPanelField.js +123 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +17 -6
- 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 +222 -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 +14 -0
- package/dist/fields/config/FilterDimensionSelectField.js +49 -0
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
- package/dist/fields/config/FilterOperatorSelectField.js +59 -0
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
- 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 +19 -31
- 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.d.ts +3 -0
- package/dist/fields/config/fetchSources.js +17 -23
- 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/sourcesState.js +19 -3
- package/dist/fields/config/sourcesState.js.map +1 -1
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
- package/dist/fields/config/useAnalyticsSources.js +23 -24
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
- package/dist/fields/config/useFilterCapabilities.js +60 -0
- package/dist/fields/config/useFilterCapabilities.js.map +1 -0
- 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 +30 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +67 -38
- 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 +79 -26
- package/dist/fields/readForDocument.js +451 -105
- 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 +179 -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 +143 -124
- 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 -22
- 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 +40 -38
- 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 +155 -47
- 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 -25
- package/dist/goals/trackGoalAction.js +71 -66
- 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 +69 -11
- package/dist/index.js +262 -192
- 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 +79 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.js +27 -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 +103 -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 +31 -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 +1627 -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 +199 -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 +110 -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 +5 -2
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +27 -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 +10 -0
- package/dist/native/ingest/bots.js +66 -0
- package/dist/native/ingest/bots.js.map +1 -0
- package/dist/native/ingest/browser.js +45 -0
- package/dist/native/ingest/browser.js.map +1 -0
- package/dist/native/ingest/clientIp.js +34 -8
- 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 +185 -32
- 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 +13 -0
- package/dist/native/ingest/language.js.map +1 -0
- package/dist/native/ingest/normalizeEvent.d.ts +73 -5
- package/dist/native/ingest/normalizeEvent.js +257 -51
- 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 +46 -0
- package/dist/native/ingest/referrer.js.map +1 -0
- package/dist/native/ingest/requestHost.js +44 -0
- package/dist/native/ingest/requestHost.js.map +1 -0
- package/dist/native/ingest/resolveHostname.d.ts +20 -0
- package/dist/native/ingest/resolveHostname.js +51 -0
- package/dist/native/ingest/resolveHostname.js.map +1 -0
- 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 +85 -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 +188 -68
- 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 +10 -0
- package/dist/native/ingest/source.js +245 -16
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +33 -0
- package/dist/native/ingest/utm.js.map +1 -0
- package/dist/native/ingest/validate.js +25 -13
- 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 +128 -9
- package/dist/native/nativeAdapter.js +395 -281
- 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 +119 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +65 -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 +438 -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 +705 -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 +101 -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 +387 -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 +349 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +49 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +668 -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 +15 -0
- package/dist/native/store/types.js +10 -0
- package/dist/native/store/types.js.map +1 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +57 -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/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 +346 -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 +106 -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 +24 -0
- package/dist/plugin/errors.js +86 -0
- package/dist/plugin/errors.js.map +1 -0
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.d.ts +1 -0
- package/dist/plugin/goalHint.js +35 -0
- package/dist/plugin/goalHint.js.map +1 -0
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.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 +161 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +88 -52
- 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.d.ts +11 -0
- package/dist/plugin/readContextForRequest.js +79 -32
- 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 +67 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +91 -21
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +138 -0
- package/dist/plugin/refreshEndpoint.js.map +1 -0
- 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 +235 -29
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +61 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +23 -0
- package/dist/plugin/scopeChange.js.map +1 -0
- 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 +50 -16
- 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 +24 -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/ProvidersListNotice.d.ts +11 -0
- package/dist/providers/ProvidersListNotice.js +36 -0
- package/dist/providers/ProvidersListNotice.js.map +1 -0
- 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 +63 -0
- package/dist/providers/collection.js +372 -143
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +84 -0
- package/dist/providers/factory.js +86 -25
- 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 +105 -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 +329 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +26 -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/scopeUnique.js +41 -0
- package/dist/providers/scopeUnique.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 +6 -13
- package/dist/query/fetchQuery.d.ts +36 -23
- package/dist/query/fetchQuery.js +96 -89
- 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 +8 -2
- package/dist/query/parse.js +155 -108
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +27 -4
- package/dist/query/response.js +18 -0
- package/dist/query/response.js.map +1 -0
- package/dist/react/AnalyticsProvider.d.ts +42 -20
- package/dist/react/AnalyticsProvider.js +24 -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 -8
- package/dist/react/useAnalytics.js +31 -13
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/routes/captureRoute.d.ts +28 -0
- package/dist/routes/captureRoute.js +67 -0
- package/dist/routes/captureRoute.js.map +1 -0
- package/dist/routes/ingestRoute.d.ts +17 -0
- package/dist/routes/ingestRoute.js +17 -0
- package/dist/routes/ingestRoute.js.map +1 -0
- package/dist/site/AnalyticsScripts.d.ts +35 -0
- package/dist/site/AnalyticsScripts.js +44 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +43 -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 +71 -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 -71
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.d.ts +1 -0
- package/dist/surfacing/epoch.js +116 -0
- package/dist/surfacing/epoch.js.map +1 -0
- 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 +119 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +30 -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 +222 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -11
- 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 +174 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +5 -10
- package/dist/tracker/createTracker.js +437 -82
- 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 +8 -0
- package/dist/tracker/exclusion.js +82 -0
- package/dist/tracker/exclusion.js.map +1 -0
- package/dist/tracker/gate.d.ts +8 -0
- package/dist/tracker/gate.js +244 -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 +23 -15
- 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 +129 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +60 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +106 -0
- package/dist/tracker/sinks/ga4.js.map +1 -0
- package/dist/tracker/sinks/native.js +21 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +36 -18
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +145 -9
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +18 -10
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +54 -22
- 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 +99 -44
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +266 -56
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +256 -55
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +253 -56
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +261 -57
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +265 -61
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +256 -56
- 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 +240 -14
- package/dist/translations/keys.js +245 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +258 -58
- 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 +16 -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 +270 -66
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +261 -55
- 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 +261 -55
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +256 -56
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +110 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1667 -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/ChoiceMenu.js +48 -0
- package/dist/ui/components/ChoiceMenu.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 +25 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/components/SourcesNoticeBanner.js +20 -0
- package/dist/ui/components/SourcesNoticeBanner.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 +12 -8
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +9 -10
- package/dist/view/AnalyticsView.js +47 -19
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -174
- 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 +155 -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/consentShare.js +15 -0
- package/dist/view/consentShare.js.map +1 -0
- 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 +92 -20
- 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 +120 -3
- 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 +13 -11
- 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 +221 -118
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +120 -32
- 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 +130 -25
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -59
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +42 -36
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -56
- 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 +182 -116
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +179 -73
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +97 -53
- 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 +50 -79
- 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 +52 -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 +65 -8
- package/dist/view/viewProps.js +123 -36
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +85 -83
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +134 -100
- 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 +27 -3
- package/dist/widgets/RealtimeCounter.js +90 -62
- 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 +18 -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/defaultLayout.d.ts +26 -0
- package/dist/widgets/defaultLayout.js +51 -0
- package/dist/widgets/defaultLayout.js.map +1 -0
- package/dist/widgets/defaults.d.ts +4 -3
- package/dist/widgets/defaults.js +76 -24
- 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 +26 -0
- package/dist/widgets/filterCaption.js.map +1 -0
- package/dist/widgets/filterField.d.ts +15 -0
- package/dist/widgets/filterField.js +86 -0
- package/dist/widgets/filterField.js.map +1 -0
- 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 +79 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +24 -0
- package/dist/widgets/prepareWidgetRead.js +110 -0
- package/dist/widgets/prepareWidgetRead.js.map +1 -0
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +32 -13
- package/dist/widgets/readForWidget.js +52 -63
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
- package/dist/widgets/readForWidgetBreakdown.js +71 -58
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +21 -17
- package/dist/widgets/readForWidgetGoals.js +72 -52
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
- package/dist/widgets/readForWidgetRealtime.js +69 -41
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +29 -24
- package/dist/widgets/readForWidgetSeries.js +66 -114
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +48 -0
- package/dist/widgets/readMeta.js +66 -0
- package/dist/widgets/readMeta.js.map +1 -0
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +56 -16
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +207 -124
- 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 +16 -0
- 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 +36 -26
- 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 +61 -42
- 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/exports/next.d.ts +0 -3
- package/dist/exports/next.js +0 -3
- 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 -121
- 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/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -14
- 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 -161
- 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 -29
- 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/applyDistinctDeltas.js +0 -9
- package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
- package/dist/native/rollups/bumpRollup.js +0 -73
- package/dist/native/rollups/bumpRollup.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -90
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertIfNew.js +0 -53
- package/dist/native/rollups/insertIfNew.js.map +0 -1
- package/dist/next/captureRewrites.d.ts +0 -41
- package/dist/next/captureRewrites.js +0 -56
- package/dist/next/captureRewrites.js.map +0 -1
- package/dist/next/posthogProxyRewrites.d.ts +0 -41
- package/dist/next/posthogProxyRewrites.js +0 -45
- package/dist/next/posthogProxyRewrites.js.map +0 -1
- package/dist/plugin/paths.js +0 -27
- package/dist/plugin/paths.js.map +0 -1
- package/dist/query/errors.js +0 -10
- package/dist/query/errors.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/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -14
- package/dist/tracker/sinks/posthog.d.ts +0 -14
- package/dist/tracker/sinks/umami.d.ts +0 -13
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -74
- 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 -43
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -1,79 +1,90 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
1
|
+
import { readPrincipalOf } from "../access/principal.js";
|
|
2
|
+
import { goalNamesFor, resolveGoalsDetailedFor } from "../plugin/runtime.js";
|
|
3
|
+
import { comparisonWindow, pinnedScope, prepareWidgetRead, substitutionOf } from "./prepareWidgetRead.js";
|
|
4
|
+
import { mergeNotices } from "./readMeta.js";
|
|
5
5
|
import { readForWidget } from "./readForWidget.js";
|
|
6
6
|
import { readForWidgetBreakdown } from "./readForWidgetBreakdown.js";
|
|
7
7
|
import { conversionRate } from "../view/conversionRate.js";
|
|
8
8
|
//#region src/widgets/readForWidgetGoals.ts
|
|
9
9
|
/**
|
|
10
|
-
* How much wider than the table the previous window is read
|
|
11
|
-
* conversions, so a goal in today's top rows may
|
|
12
|
-
* reading only as many rows as the table shows would drop exactly those deltas. Capped at
|
|
13
|
-
* the bound every analytics query is held to.
|
|
10
|
+
* How much wider than the table the previous window is read: each window ranks by its own
|
|
11
|
+
* conversions, so a goal in today's top rows may rank too low there to keep its delta.
|
|
14
12
|
*/
|
|
15
13
|
const PREVIOUS_LIMIT_FACTOR = 4;
|
|
16
14
|
const previousLimit = (limit) => Math.min(limit * PREVIOUS_LIMIT_FACTOR, 500);
|
|
17
15
|
/**
|
|
18
|
-
*
|
|
19
|
-
*
|
|
16
|
+
* The scope's goal slugs and their display names. A throwing resolver must not cost the table:
|
|
17
|
+
* rows fall back to slugs and `'unresolved'` tells the read apart from a scope with no goals.
|
|
20
18
|
*/
|
|
21
19
|
const goalNames = async (runtime, req, scope) => {
|
|
22
20
|
try {
|
|
23
21
|
const resolved = await resolveGoalsDetailedFor(runtime, req, scope);
|
|
24
|
-
|
|
22
|
+
const shown = await goalNamesFor({
|
|
23
|
+
runtime,
|
|
24
|
+
req,
|
|
25
|
+
scope,
|
|
26
|
+
resolved
|
|
27
|
+
});
|
|
28
|
+
return {
|
|
29
|
+
slugs: resolved.map(({ goal }) => goal.slug),
|
|
30
|
+
names: new Map(shown.map((goal) => [goal.slug, goal.name])),
|
|
31
|
+
builtin: resolved.filter((entry) => entry.source === "builtin").map(({ goal }) => goal.slug)
|
|
32
|
+
};
|
|
25
33
|
} catch (err) {
|
|
26
34
|
req.payload.logger?.warn(`analytics: widget goal names failed to resolve: ${String(err)}`);
|
|
27
|
-
return
|
|
35
|
+
return "unresolved";
|
|
28
36
|
}
|
|
29
37
|
};
|
|
30
38
|
/**
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
* conversions in the previous window. Rows come from one `goal` breakdown read and the site
|
|
34
|
-
* total from one totals read, both through the existing widget helpers so capability
|
|
35
|
-
* gating, scoping and caching stay in one place. Revenue and visitors ride along only where
|
|
36
|
-
* the source serves them; the status is the breakdown's, since a table without its rows has
|
|
37
|
-
* nothing to show.
|
|
39
|
+
* Goals table from a `goal` breakdown, a visitors total for the rate and, when comparing, the
|
|
40
|
+
* previous window's breakdown. Status is the breakdown's: a table without rows shows nothing.
|
|
38
41
|
*/
|
|
39
42
|
const readForWidgetGoals = async (args) => {
|
|
40
43
|
const { req, timeframe, limit, compare, adapterId, now } = args;
|
|
41
|
-
const fallback = (status, id) => ({
|
|
44
|
+
const fallback = (status, id, window) => ({
|
|
42
45
|
status,
|
|
43
46
|
adapterId: id,
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
rows: []
|
|
47
|
+
rows: [],
|
|
48
|
+
...window
|
|
47
49
|
});
|
|
48
|
-
const
|
|
49
|
-
if (!runtime) return fallback("unavailable", adapterId ?? "");
|
|
50
|
-
const ctx = await resolveReadContext({
|
|
51
|
-
runtime,
|
|
50
|
+
const prepared = await prepareWidgetRead({
|
|
52
51
|
req,
|
|
52
|
+
now,
|
|
53
|
+
timeframe,
|
|
53
54
|
adapterId,
|
|
54
|
-
|
|
55
|
+
...readPrincipalOf(args),
|
|
56
|
+
...args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {},
|
|
57
|
+
timezone: args.timezone,
|
|
58
|
+
range: args.range
|
|
59
|
+
});
|
|
60
|
+
if (!prepared.ok) return fallback(prepared.status, prepared.adapterId, {
|
|
61
|
+
dateRange: prepared.dateRange,
|
|
62
|
+
timezone: prepared.tz
|
|
55
63
|
});
|
|
56
|
-
|
|
57
|
-
const adapter = ctx.adapter;
|
|
58
|
-
const tz = args.timezone ?? await resolveTimezoneFor(runtime, req, ctx.scope);
|
|
59
|
-
const dateRange = args.range ?? resolveTimeframe(timeframe, now, tz);
|
|
64
|
+
const { runtime, adapter, tz, dateRange } = prepared;
|
|
60
65
|
const shared = {
|
|
61
66
|
req,
|
|
62
67
|
timeframe,
|
|
63
68
|
adapterId: adapter.id,
|
|
64
|
-
|
|
69
|
+
...prepared.pin,
|
|
65
70
|
timezone: tz,
|
|
66
71
|
now
|
|
67
72
|
};
|
|
68
|
-
const comparisonRange = compare
|
|
69
|
-
const
|
|
73
|
+
const comparisonRange = compare ? comparisonWindow(prepared, now) : void 0;
|
|
74
|
+
const resolved = await goalNames(runtime, req, prepared.scope);
|
|
75
|
+
const names = resolved === "unresolved" ? /* @__PURE__ */ new Map() : resolved.names;
|
|
76
|
+
const builtinGoalSlugs = resolved === "unresolved" ? [] : resolved.builtin;
|
|
77
|
+
const goalSlugs = resolved === "unresolved" ? "unresolved" : resolved.slugs;
|
|
78
|
+
const [breakdown, totals, previous] = await Promise.all([
|
|
70
79
|
readForWidgetBreakdown({
|
|
71
80
|
...shared,
|
|
72
81
|
range: dateRange,
|
|
73
82
|
metric: "conversions",
|
|
74
83
|
dimension: "goal",
|
|
75
84
|
limit,
|
|
76
|
-
extraMetrics: ["revenue", "visitors"]
|
|
85
|
+
extraMetrics: ["revenue", "visitors"],
|
|
86
|
+
goalSlugs,
|
|
87
|
+
builtinGoalSlugs
|
|
77
88
|
}),
|
|
78
89
|
adapter.capabilities.metrics.has("visitors") ? readForWidget({
|
|
79
90
|
...shared,
|
|
@@ -86,38 +97,47 @@ const readForWidgetGoals = async (args) => {
|
|
|
86
97
|
range: comparisonRange,
|
|
87
98
|
metric: "conversions",
|
|
88
99
|
dimension: "goal",
|
|
89
|
-
limit: previousLimit(limit)
|
|
90
|
-
|
|
91
|
-
|
|
100
|
+
limit: previousLimit(limit),
|
|
101
|
+
goalSlugs,
|
|
102
|
+
builtinGoalSlugs
|
|
103
|
+
}) : void 0
|
|
92
104
|
]);
|
|
93
105
|
if (breakdown.status !== "ok") return {
|
|
94
|
-
...fallback(breakdown.status, breakdown.adapterId
|
|
95
|
-
|
|
96
|
-
|
|
106
|
+
...fallback(breakdown.status, breakdown.adapterId, {
|
|
107
|
+
dateRange,
|
|
108
|
+
timezone: tz
|
|
109
|
+
}),
|
|
110
|
+
...breakdown.retryAfterMs === void 0 ? {} : { retryAfterMs: breakdown.retryAfterMs }
|
|
97
111
|
};
|
|
98
|
-
const previousBySlug = new Map((previous?.status === "ok" ? previous.rows : []).map((row) => [row.
|
|
99
|
-
const
|
|
112
|
+
const previousBySlug = new Map((previous?.status === "ok" ? previous.rows : []).map((row) => [row.dimensionValue, row.value]));
|
|
113
|
+
const visitorTotal = totals?.status === "ok" ? totals.metrics.visitors : void 0;
|
|
114
|
+
const siteVisitors = typeof visitorTotal === "number" ? visitorTotal : void 0;
|
|
100
115
|
const rows = breakdown.rows.map((row) => {
|
|
101
116
|
const rate = conversionRate(row.metrics?.visitors, siteVisitors);
|
|
102
|
-
const previousConversions = previousBySlug.get(row.
|
|
117
|
+
const previousConversions = previousBySlug.get(row.dimensionValue);
|
|
118
|
+
const revenue = row.metrics?.revenue;
|
|
103
119
|
return {
|
|
104
|
-
slug: row.
|
|
105
|
-
name: names.get(row.
|
|
106
|
-
conversions: row.value,
|
|
107
|
-
...
|
|
120
|
+
slug: row.dimensionValue,
|
|
121
|
+
name: names.get(row.dimensionValue) ?? row.dimensionValue,
|
|
122
|
+
conversions: row.value ?? 0,
|
|
123
|
+
...typeof revenue === "number" ? { revenue } : {},
|
|
108
124
|
...rate !== null ? { rate } : {},
|
|
109
|
-
...previousConversions
|
|
125
|
+
...typeof previousConversions === "number" ? { previousConversions } : {}
|
|
110
126
|
};
|
|
111
127
|
}).sort((a, b) => b.conversions - a.conversions).slice(0, limit);
|
|
112
128
|
return {
|
|
113
129
|
status: "ok",
|
|
114
130
|
adapterId: adapter.id,
|
|
131
|
+
...substitutionOf(prepared),
|
|
132
|
+
...pinnedScope(args, prepared.queryScope),
|
|
115
133
|
dateRange,
|
|
116
134
|
timezone: tz,
|
|
117
135
|
rows,
|
|
118
136
|
...siteVisitors !== void 0 ? { siteVisitors } : {},
|
|
119
|
-
|
|
120
|
-
|
|
137
|
+
...breakdown.provider === void 0 ? {} : { provider: breakdown.provider },
|
|
138
|
+
...mergeNotices(breakdown, totals, previous),
|
|
139
|
+
goalsUnresolved: breakdown.goalsUnresolved === true,
|
|
140
|
+
noGoals: breakdown.noGoals === true
|
|
121
141
|
};
|
|
122
142
|
};
|
|
123
143
|
//#endregion
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"readForWidgetGoals.js","names":[],"sources":["../../src/widgets/readForWidgetGoals.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { DateRange } from '../core/contract'\nimport { resolveReadContext } from '../core/scopedRead'\nimport {\n\ttype AnalyticsRuntime,\n\tgetRuntime,\n\tresolveGoalsDetailedFor,\n\tresolveTimezoneFor,\n} from '../plugin/runtime'\nimport { MAX_QUERY_LIMIT } from '../query/limits'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport { conversionRate } from '../view/conversionRate'\nimport { previousWindow } from './comparison'\nimport { readForWidget, type WidgetReadStatus } from './readForWidget'\nimport { readForWidgetBreakdown } from './readForWidgetBreakdown'\n\nexport interface GoalRow {\n\tslug: string\n\t/** The goal's admin-facing name, or its slug when no configured goal claims it. */\n\tname: string\n\tconversions: number\n\trevenue?: number\n\t/** 0..1 share of the site's visitors, absent when either side of the ratio is missing. */\n\trate?: number\n\tpreviousConversions?: number\n}\n\nexport interface WidgetGoalsResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\ttimezone: string\n\trows: GoalRow[]\n\t/** Range total the rate divides by; absent when the source does not serve visitors. */\n\tsiteVisitors?: number\n\tclamped?: boolean\n\tstale?: boolean\n}\n\nexport interface ReadForWidgetGoalsArgs {\n\treq: PayloadRequest\n\ttimeframe: TimeframePreset\n\tlimit: number\n\t/** Read the previous window too, when the source can compare. */\n\tcompare: boolean\n\tadapterId?: string\n\tnow: Date\n\trange?: DateRange\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n\t/**\n\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t */\n\ttimezone?: string\n}\n\n/**\n * How much wider than the table the previous window is read. Both windows rank by their own\n * conversions, so a goal in today's top rows may sit well below them in the previous window;\n * reading only as many rows as the table shows would drop exactly those deltas. Capped at\n * the bound every analytics query is held to.\n */\nconst PREVIOUS_LIMIT_FACTOR = 4\n\nconst previousLimit = (limit: number): number =>\n\tMath.min(limit * PREVIOUS_LIMIT_FACTOR, MAX_QUERY_LIMIT)\n\n/**\n * Goal names for the read's own scope. A resolver that throws must not cost the widget its\n * table, so the rows fall back to their slugs.\n */\nconst goalNames = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope: string | null\n): Promise<Map<string, string>> => {\n\ttry {\n\t\tconst resolved = await resolveGoalsDetailedFor(runtime, req, scope)\n\t\treturn new Map(resolved.map(({ goal }) => [goal.slug, goal.name]))\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: widget goal names failed to resolve: ${String(err)}`)\n\t\treturn new Map()\n\t}\n}\n\n/**\n * The goals table behind the goals widget: conversions per goal over the window, each with\n * its revenue, its share of the site's visitors, and (when comparing) the same goal's\n * conversions in the previous window. Rows come from one `goal` breakdown read and the site\n * total from one totals read, both through the existing widget helpers so capability\n * gating, scoping and caching stay in one place. Revenue and visitors ride along only where\n * the source serves them; the status is the breakdown's, since a table without its rows has\n * nothing to show.\n */\nexport const readForWidgetGoals = async (\n\targs: ReadForWidgetGoalsArgs\n): Promise<WidgetGoalsResult> => {\n\tconst { req, timeframe, limit, compare, adapterId, now } = args\n\tconst fallback = (status: WidgetReadStatus, id: string): WidgetGoalsResult => ({\n\t\tstatus,\n\t\tadapterId: id,\n\t\tdateRange: args.range ?? resolveTimeframe(timeframe, now, args.timezone),\n\t\ttimezone: args.timezone ?? DEFAULT_TIMEZONE,\n\t\trows: [],\n\t})\n\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn fallback('unavailable', adapterId ?? '')\n\t}\n\tconst ctx = await resolveReadContext({ runtime, req, adapterId, scope: args.scope })\n\tif (!ctx.ok) {\n\t\treturn fallback('unavailable', adapterId ?? '')\n\t}\n\tconst adapter = ctx.adapter\n\tconst tz = args.timezone ?? (await resolveTimezoneFor(runtime, req, ctx.scope))\n\tconst dateRange = args.range ?? resolveTimeframe(timeframe, now, tz)\n\t// The sub-reads resolve their own context; pinning the adapter, scope, timezone and\n\t// window keeps all three answering about exactly the same read.\n\tconst shared = { req, timeframe, adapterId: adapter.id, scope: ctx.scope, timezone: tz, now }\n\tconst comparisonRange =\n\t\tcompare && runtime.comparison && adapter.capabilities.comparison\n\t\t\t? (previousWindow(dateRange, tz) ?? undefined)\n\t\t\t: undefined\n\n\tconst [breakdown, totals, previous, names] = await Promise.all([\n\t\treadForWidgetBreakdown({\n\t\t\t...shared,\n\t\t\trange: dateRange,\n\t\t\tmetric: 'conversions',\n\t\t\tdimension: 'goal',\n\t\t\tlimit,\n\t\t\textraMetrics: ['revenue', 'visitors'],\n\t\t}),\n\t\tadapter.capabilities.metrics.has('visitors')\n\t\t\t? // The site total is a denominator, never a delta: its own previous window would\n\t\t\t\t// be a second read nothing renders.\n\t\t\t\treadForWidget({ ...shared, range: dateRange, metrics: ['visitors'], comparison: false })\n\t\t\t: undefined,\n\t\tcomparisonRange\n\t\t\t? readForWidgetBreakdown({\n\t\t\t\t\t...shared,\n\t\t\t\t\trange: comparisonRange,\n\t\t\t\t\tmetric: 'conversions',\n\t\t\t\t\tdimension: 'goal',\n\t\t\t\t\tlimit: previousLimit(limit),\n\t\t\t\t})\n\t\t\t: undefined,\n\t\tgoalNames(runtime, req, ctx.scope),\n\t])\n\tif (breakdown.status !== 'ok') {\n\t\treturn { ...fallback(breakdown.status, breakdown.adapterId), dateRange, timezone: tz }\n\t}\n\n\tconst previousBySlug = new Map(\n\t\t(previous?.status === 'ok' ? previous.rows : []).map((row) => [row.label, row.value])\n\t)\n\tconst siteVisitors = totals?.status === 'ok' ? totals.metrics.visitors : undefined\n\tconst rows: GoalRow[] = breakdown.rows\n\t\t.map((row) => {\n\t\t\tconst rate = conversionRate(row.metrics?.visitors, siteVisitors)\n\t\t\tconst previousConversions = previousBySlug.get(row.label)\n\t\t\treturn {\n\t\t\t\tslug: row.label,\n\t\t\t\tname: names.get(row.label) ?? row.label,\n\t\t\t\tconversions: row.value,\n\t\t\t\t...(row.metrics?.revenue !== undefined ? { revenue: row.metrics.revenue } : {}),\n\t\t\t\t...(rate !== null ? { rate } : {}),\n\t\t\t\t...(previousConversions !== undefined ? { previousConversions } : {}),\n\t\t\t}\n\t\t})\n\t\t// The adapter ranks and caps already; re-applying both keeps one that does not from\n\t\t// spilling a long, unranked table into a dashboard card.\n\t\t.sort((a, b) => b.conversions - a.conversions)\n\t\t.slice(0, limit)\n\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\trows,\n\t\t...(siteVisitors !== undefined ? { siteVisitors } : {}),\n\t\tclamped: Boolean(breakdown.clamped || totals?.clamped || previous?.clamped),\n\t\tstale: Boolean(breakdown.stale || totals?.stale || previous?.stale),\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAgEA,MAAM,wBAAwB;AAE9B,MAAM,iBAAiB,UACtB,KAAK,IAAI,QAAQ,uBAAA,GAAsC;;;;;AAMxD,MAAM,YAAY,OACjB,SACA,KACA,UACkC;CAClC,IAAI;EACH,MAAM,WAAW,MAAM,wBAAwB,SAAS,KAAK,KAAK;EAClE,OAAO,IAAI,IAAI,SAAS,KAAK,EAAE,WAAW,CAAC,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC;CAClE,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,mDAAmD,OAAO,GAAG,GAAG;EACzF,uBAAO,IAAI,IAAI;CAChB;AACD;;;;;;;;;;AAWA,MAAa,qBAAqB,OACjC,SACgC;CAChC,MAAM,EAAE,KAAK,WAAW,OAAO,SAAS,WAAW,QAAQ;CAC3D,MAAM,YAAY,QAA0B,QAAmC;EAC9E;EACA,WAAW;EACX,WAAW,KAAK,SAAS,iBAAiB,WAAW,KAAK,KAAK,QAAQ;EACvE,UAAU,KAAK,YAAA;EACf,MAAM,CAAC;CACR;CAEA,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,SAAS,eAAe,aAAa,EAAE;CAE/C,MAAM,MAAM,MAAM,mBAAmB;EAAE;EAAS;EAAK;EAAW,OAAO,KAAK;CAAM,CAAC;CACnF,IAAI,CAAC,IAAI,IACR,OAAO,SAAS,eAAe,aAAa,EAAE;CAE/C,MAAM,UAAU,IAAI;CACpB,MAAM,KAAK,KAAK,YAAa,MAAM,mBAAmB,SAAS,KAAK,IAAI,KAAK;CAC7E,MAAM,YAAY,KAAK,SAAS,iBAAiB,WAAW,KAAK,EAAE;CAGnE,MAAM,SAAS;EAAE;EAAK;EAAW,WAAW,QAAQ;EAAI,OAAO,IAAI;EAAO,UAAU;EAAI;CAAI;CAC5F,MAAM,kBACL,WAAW,QAAQ,cAAc,QAAQ,aAAa,aAClD,eAAe,WAAW,EAAE,KAAK,KAAA,IAClC,KAAA;CAEJ,MAAM,CAAC,WAAW,QAAQ,UAAU,SAAS,MAAM,QAAQ,IAAI;EAC9D,uBAAuB;GACtB,GAAG;GACH,OAAO;GACP,QAAQ;GACR,WAAW;GACX;GACA,cAAc,CAAC,WAAW,UAAU;EACrC,CAAC;EACD,QAAQ,aAAa,QAAQ,IAAI,UAAU,IAGzC,cAAc;GAAE,GAAG;GAAQ,OAAO;GAAW,SAAS,CAAC,UAAU;GAAG,YAAY;EAAM,CAAC,IACtF,KAAA;EACH,kBACG,uBAAuB;GACvB,GAAG;GACH,OAAO;GACP,QAAQ;GACR,WAAW;GACX,OAAO,cAAc,KAAK;EAC3B,CAAC,IACA,KAAA;EACH,UAAU,SAAS,KAAK,IAAI,KAAK;CAClC,CAAC;CACD,IAAI,UAAU,WAAW,MACxB,OAAO;EAAE,GAAG,SAAS,UAAU,QAAQ,UAAU,SAAS;EAAG;EAAW,UAAU;CAAG;CAGtF,MAAM,iBAAiB,IAAI,KACzB,UAAU,WAAW,OAAO,SAAS,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC,CACrF;CACA,MAAM,eAAe,QAAQ,WAAW,OAAO,OAAO,QAAQ,WAAW,KAAA;CACzE,MAAM,OAAkB,UAAU,KAChC,KAAK,QAAQ;EACb,MAAM,OAAO,eAAe,IAAI,SAAS,UAAU,YAAY;EAC/D,MAAM,sBAAsB,eAAe,IAAI,IAAI,KAAK;EACxD,OAAO;GACN,MAAM,IAAI;GACV,MAAM,MAAM,IAAI,IAAI,KAAK,KAAK,IAAI;GAClC,aAAa,IAAI;GACjB,GAAI,IAAI,SAAS,YAAY,KAAA,IAAY,EAAE,SAAS,IAAI,QAAQ,QAAQ,IAAI,CAAC;GAC7E,GAAI,SAAS,OAAO,EAAE,KAAK,IAAI,CAAC;GAChC,GAAI,wBAAwB,KAAA,IAAY,EAAE,oBAAoB,IAAI,CAAC;EACpE;CACD,CAAC,EAGA,MAAM,GAAG,MAAM,EAAE,cAAc,EAAE,WAAW,EAC5C,MAAM,GAAG,KAAK;CAEhB,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB;EACA,UAAU;EACV;EACA,GAAI,iBAAiB,KAAA,IAAY,EAAE,aAAa,IAAI,CAAC;EACrD,SAAS,QAAQ,UAAU,WAAW,QAAQ,WAAW,UAAU,OAAO;EAC1E,OAAO,QAAQ,UAAU,SAAS,QAAQ,SAAS,UAAU,KAAK;CACnE;AACD"}
|
|
1
|
+
{"version":3,"file":"readForWidgetGoals.js","names":[],"sources":["../../src/widgets/readForWidgetGoals.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type ReadPrincipal, readPrincipalOf } from '../access/principal'\nimport type { DateRange } from '../core/contract'\nimport { type AnalyticsRuntime, goalNamesFor, resolveGoalsDetailedFor } from '../plugin/runtime'\nimport { MAX_QUERY_LIMIT } from '../query/limits'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { conversionRate } from '../view/conversionRate'\nimport {\n\tcomparisonWindow,\n\tpinnedScope,\n\tprepareWidgetRead,\n\ttype StoredSourceRead,\n\ttype SubstitutedSource,\n\tsubstitutionOf,\n\ttype WidgetReadStatus,\n} from './prepareWidgetRead'\nimport { readForWidget } from './readForWidget'\nimport { readForWidgetBreakdown } from './readForWidgetBreakdown'\nimport { mergeNotices, type ReadNotices } from './readMeta'\n\nexport interface GoalRow {\n\tslug: string\n\t/** The goal's admin-facing name, or its slug when no configured goal claims it. */\n\tname: string\n\tconversions: number\n\trevenue?: number\n\t/** 0..1 share of the site's visitors, absent when either side of the ratio is missing. */\n\trate?: number\n\tpreviousConversions?: number\n}\n\nexport interface WidgetGoalsResult extends Partial<ReadNotices>, SubstitutedSource {\n\tstatus: WidgetReadStatus\n\t/** How long until a `busy` read can succeed, when the source or the plugin knows. */\n\tretryAfterMs?: number\n\tadapterId: string\n\t/**\n\t * Scope a link to this read must name, set only when the viewer would not resolve it alone:\n\t * a needless `scope` refuses every reader without `access.crossScope`.\n\t */\n\tscope?: string\n\tdateRange: DateRange\n\ttimezone: string\n\trows: GoalRow[]\n\t/** Range total the rate divides by; absent when the source does not serve visitors. */\n\tsiteVisitors?: number\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\t/** True when the scope declares no goals of its own: an empty table, not a failure. */\n\tnoGoals?: boolean\n}\n\n/** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */\nexport type ReadForWidgetGoalsArgs = ReadPrincipal &\n\tStoredSourceRead & {\n\t\treq: PayloadRequest\n\t\ttimeframe: TimeframePreset\n\t\tlimit: number\n\t\t/** Read the previous window too, when the source can compare. */\n\t\tcompare: boolean\n\t\tadapterId?: string\n\t\tnow: Date\n\t\trange?: DateRange\n\t\t/**\n\t\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t\t */\n\t\ttimezone?: string\n\t}\n\n/**\n * How much wider than the table the previous window is read: each window ranks by its own\n * conversions, so a goal in today's top rows may rank too low there to keep its delta.\n */\nconst PREVIOUS_LIMIT_FACTOR = 4\n\nconst previousLimit = (limit: number): number =>\n\tMath.min(limit * PREVIOUS_LIMIT_FACTOR, MAX_QUERY_LIMIT)\n\n/**\n * The scope's goal slugs and their display names. A throwing resolver must not cost the table:\n * rows fall back to slugs and `'unresolved'` tells the read apart from a scope with no goals.\n */\nconst goalNames = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope: string | null\n): Promise<{ slugs: string[]; names: Map<string, string>; builtin: string[] } | 'unresolved'> => {\n\ttry {\n\t\tconst resolved = await resolveGoalsDetailedFor(runtime, req, scope)\n\t\tconst shown = await goalNamesFor({ runtime, req, scope, resolved })\n\t\treturn {\n\t\t\tslugs: resolved.map(({ goal }) => goal.slug),\n\t\t\tnames: new Map(shown.map((goal) => [goal.slug, goal.name])),\n\t\t\tbuiltin: resolved.filter((entry) => entry.source === 'builtin').map(({ goal }) => goal.slug),\n\t\t}\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: widget goal names failed to resolve: ${String(err)}`)\n\t\treturn 'unresolved'\n\t}\n}\n\n/**\n * Goals table from a `goal` breakdown, a visitors total for the rate and, when comparing, the\n * previous window's breakdown. Status is the breakdown's: a table without rows shows nothing.\n */\nexport const readForWidgetGoals = async (\n\targs: ReadForWidgetGoalsArgs\n): Promise<WidgetGoalsResult> => {\n\tconst { req, timeframe, limit, compare, adapterId, now } = args\n\tconst fallback = (\n\t\tstatus: WidgetReadStatus,\n\t\tid: string,\n\t\twindow: { dateRange: DateRange; timezone: string }\n\t): WidgetGoalsResult => ({ status, adapterId: id, rows: [], ...window })\n\n\tconst prepared = await prepareWidgetRead({\n\t\treq,\n\t\tnow,\n\t\ttimeframe,\n\t\tadapterId,\n\t\t...readPrincipalOf(args),\n\t\t...(args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {}),\n\t\ttimezone: args.timezone,\n\t\trange: args.range,\n\t})\n\tif (!prepared.ok) {\n\t\treturn fallback(prepared.status, prepared.adapterId, {\n\t\t\tdateRange: prepared.dateRange,\n\t\t\ttimezone: prepared.tz,\n\t\t})\n\t}\n\tconst { runtime, adapter, tz, dateRange } = prepared\n\t// The sub-reads resolve their own context; pinning the adapter, scope, timezone and\n\t// window keeps all three answering about exactly the same read.\n\tconst shared = { req, timeframe, adapterId: adapter.id, ...prepared.pin, timezone: tz, now }\n\tconst comparisonRange = compare ? comparisonWindow(prepared, now) : undefined\n\n\t// The names are resolved first: their slugs are the hint a provider source restricts its\n\t// goal rows to, so both reads below need them before they run.\n\tconst resolved = await goalNames(runtime, req, prepared.scope)\n\tconst names = resolved === 'unresolved' ? new Map<string, string>() : resolved.names\n\tconst builtinGoalSlugs = resolved === 'unresolved' ? [] : resolved.builtin\n\tconst goalSlugs = resolved === 'unresolved' ? 'unresolved' : resolved.slugs\n\tconst [breakdown, totals, previous] = await Promise.all([\n\t\treadForWidgetBreakdown({\n\t\t\t...shared,\n\t\t\trange: dateRange,\n\t\t\tmetric: 'conversions',\n\t\t\tdimension: 'goal',\n\t\t\tlimit,\n\t\t\textraMetrics: ['revenue', 'visitors'],\n\t\t\tgoalSlugs,\n\t\t\tbuiltinGoalSlugs,\n\t\t}),\n\t\tadapter.capabilities.metrics.has('visitors')\n\t\t\t? // The site total is a denominator, never a delta: its own previous window would\n\t\t\t\t// be a second read nothing renders.\n\t\t\t\treadForWidget({ ...shared, range: dateRange, metrics: ['visitors'], comparison: false })\n\t\t\t: undefined,\n\t\tcomparisonRange\n\t\t\t? readForWidgetBreakdown({\n\t\t\t\t\t...shared,\n\t\t\t\t\trange: comparisonRange,\n\t\t\t\t\tmetric: 'conversions',\n\t\t\t\t\tdimension: 'goal',\n\t\t\t\t\tlimit: previousLimit(limit),\n\t\t\t\t\tgoalSlugs,\n\t\t\t\t\tbuiltinGoalSlugs,\n\t\t\t\t})\n\t\t\t: undefined,\n\t])\n\tif (breakdown.status !== 'ok') {\n\t\treturn {\n\t\t\t...fallback(breakdown.status, breakdown.adapterId, { dateRange, timezone: tz }),\n\t\t\t...(breakdown.retryAfterMs === undefined ? {} : { retryAfterMs: breakdown.retryAfterMs }),\n\t\t}\n\t}\n\n\tconst previousBySlug = new Map(\n\t\t(previous?.status === 'ok' ? previous.rows : []).map((row) => [row.dimensionValue, row.value])\n\t)\n\tconst visitorTotal = totals?.status === 'ok' ? totals.metrics.visitors : undefined\n\tconst siteVisitors = typeof visitorTotal === 'number' ? visitorTotal : undefined\n\tconst rows: GoalRow[] = breakdown.rows\n\t\t.map((row) => {\n\t\t\tconst rate = conversionRate(row.metrics?.visitors, siteVisitors)\n\t\t\tconst previousConversions = previousBySlug.get(row.dimensionValue)\n\t\t\tconst revenue = row.metrics?.revenue\n\t\t\treturn {\n\t\t\t\tslug: row.dimensionValue,\n\t\t\t\tname: names.get(row.dimensionValue) ?? row.dimensionValue,\n\t\t\t\tconversions: row.value ?? 0,\n\t\t\t\t...(typeof revenue === 'number' ? { revenue } : {}),\n\t\t\t\t...(rate !== null ? { rate } : {}),\n\t\t\t\t...(typeof previousConversions === 'number' ? { previousConversions } : {}),\n\t\t\t}\n\t\t})\n\t\t// The adapter ranks and caps already; re-applying both keeps one that does not from\n\t\t// spilling a long, unranked table into a dashboard card.\n\t\t.sort((a, b) => b.conversions - a.conversions)\n\t\t.slice(0, limit)\n\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\t...substitutionOf(prepared),\n\t\t// The caller's own scope, not the one this pinned onto its sub-reads: those are always\n\t\t// explicitly scoped, so reading their answer back would name every viewer's own scope.\n\t\t...pinnedScope(args, prepared.queryScope),\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\trows,\n\t\t...(siteVisitors !== undefined ? { siteVisitors } : {}),\n\t\t...(breakdown.provider === undefined ? {} : { provider: breakdown.provider }),\n\t\t...mergeNotices(breakdown, totals, previous),\n\t\tgoalsUnresolved: breakdown.goalsUnresolved === true,\n\t\tnoGoals: breakdown.noGoals === true,\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -1,32 +1,45 @@
|
|
|
1
1
|
import { MetricKey } from "../core/contract.js";
|
|
2
|
+
import { ReadPrincipal } from "../access/principal.js";
|
|
3
|
+
import { ReadNotices } from "./readMeta.js";
|
|
4
|
+
import { StoredSourceRead, SubstitutedSource } from "./prepareWidgetRead.js";
|
|
2
5
|
import { PayloadRequest } from "payload";
|
|
3
6
|
|
|
4
7
|
//#region src/widgets/readForWidgetRealtime.d.ts
|
|
5
|
-
|
|
8
|
+
/**
|
|
9
|
+
* What the live count reports: `unavailable` a source counting no one live, `busy` one that failed
|
|
10
|
+
* to count for now, `misconfigured` and `host-refused` one whose setup refused the read.
|
|
11
|
+
*/
|
|
12
|
+
type WidgetRealtimeStatus = 'ok' | 'not-configured' | 'unavailable' | 'busy' | 'invalid' | 'no-access' | 'no-scope' | 'misconfigured' | 'host-refused';
|
|
6
13
|
interface RealtimePoint {
|
|
7
14
|
date: string;
|
|
8
15
|
value: number;
|
|
9
16
|
}
|
|
10
|
-
interface WidgetRealtimeResult {
|
|
17
|
+
interface WidgetRealtimeResult extends Partial<ReadNotices>, SubstitutedSource {
|
|
11
18
|
status: WidgetRealtimeStatus;
|
|
19
|
+
/** How long until a `busy` read can succeed, when the source or the plugin knows. */
|
|
20
|
+
retryAfterMs?: number;
|
|
12
21
|
adapterId: string;
|
|
22
|
+
/** The window's total for the metric that was asked for, not visitors specifically. */
|
|
13
23
|
activeNow: number;
|
|
14
24
|
series: RealtimePoint[];
|
|
25
|
+
/** The source that answered, absent on a read that never reached one. */
|
|
26
|
+
provider?: string;
|
|
27
|
+
/** The scope the read narrowed to, absent for an install-wide one. */
|
|
28
|
+
scope?: string;
|
|
15
29
|
}
|
|
16
|
-
|
|
30
|
+
/** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */
|
|
31
|
+
type ReadForWidgetRealtimeArgs = ReadPrincipal & StoredSourceRead & {
|
|
17
32
|
req: PayloadRequest;
|
|
18
33
|
metric: MetricKey;
|
|
19
34
|
windowMinutes: number;
|
|
20
35
|
adapterId?: string;
|
|
21
|
-
now: Date;
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
}
|
|
36
|
+
now: Date; /** Count only the visitors on this path; omitted counts the whole site. */
|
|
37
|
+
path?: string; /** False reads the window's total alone, its `series` left empty. Default true. */
|
|
38
|
+
series?: boolean;
|
|
39
|
+
};
|
|
25
40
|
/**
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
* to the realtime TTL: it is deliberately NOT routed through the engine, whose key
|
|
29
|
-
* day-snaps the range (so a "last 30 min" read would collide with a "today" aggregate).
|
|
41
|
+
* Realtime read for the "active now" widget, memoized in-process only (a by-the-minute count is
|
|
42
|
+
* not worth a cache write) and keyed here, since the engine's key day-snaps the range.
|
|
30
43
|
*/
|
|
31
44
|
declare const readForWidgetRealtime: (args: ReadForWidgetRealtimeArgs) => Promise<WidgetRealtimeResult>;
|
|
32
45
|
//#endregion
|
|
@@ -1,7 +1,9 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
1
|
+
import { readPrincipalOf } from "../access/principal.js";
|
|
2
|
+
import { cacheEpochsFor } from "../plugin/runtime.js";
|
|
3
|
+
import { readFailureOf } from "../surfacing/classifyError.js";
|
|
4
|
+
import { buildRealtimeKey } from "../core/cacheKey.js";
|
|
5
|
+
import { prepareWidgetRead, substitutionOf } from "./prepareWidgetRead.js";
|
|
6
|
+
import { readMeta } from "./readMeta.js";
|
|
5
7
|
//#region src/widgets/readForWidgetRealtime.ts
|
|
6
8
|
const empty = (status, adapterId) => ({
|
|
7
9
|
status,
|
|
@@ -9,55 +11,81 @@ const empty = (status, adapterId) => ({
|
|
|
9
11
|
activeNow: 0,
|
|
10
12
|
series: []
|
|
11
13
|
});
|
|
12
|
-
/**
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
* day-snaps the range (so a "last 30 min" read would collide with a "today" aggregate).
|
|
17
|
-
*/
|
|
18
|
-
const readForWidgetRealtime = async (args) => {
|
|
19
|
-
const { req, metric, windowMinutes, adapterId, now } = args;
|
|
20
|
-
const runtime = getRuntime(req.payload);
|
|
21
|
-
if (!runtime) return empty("unavailable", adapterId ?? "");
|
|
22
|
-
const ctx = await resolveReadContext({
|
|
23
|
-
runtime,
|
|
24
|
-
req,
|
|
25
|
-
adapterId,
|
|
26
|
-
scope: args.scope
|
|
27
|
-
});
|
|
28
|
-
if (!ctx.ok) return empty("unavailable", adapterId ?? "");
|
|
29
|
-
const adapter = ctx.adapter;
|
|
30
|
-
if (!adapter.isConfigured()) return empty("not-configured", adapter.id);
|
|
31
|
-
if (!adapter.realtime || !satisfiesCapabilities(adapter.capabilities, { realtime: true })) return empty("unavailable", adapter.id);
|
|
32
|
-
const ttlSeconds = runtime.ttl.realtime ?? adapter.capabilities.recommendedTtl.realtime;
|
|
33
|
-
const bucket = Math.floor(now.getTime() / 1e3 / Math.max(1, ttlSeconds));
|
|
34
|
-
const scopeKey = ctx.queryScope === void 0 ? "" : `:${encodeURIComponent(ctx.queryScope)}`;
|
|
35
|
-
const key = `rt:${adapter.id}:${metric}:${windowMinutes}:${bucket}${scopeKey}`;
|
|
36
|
-
const store = kvCacheStore(req.payload.kv);
|
|
37
|
-
const cached = await store.get(key);
|
|
38
|
-
if (cached) return cached;
|
|
14
|
+
/** The live count both callers share; `failed` answers for a source read that throws. */
|
|
15
|
+
const readRealtime = async (args, failed) => {
|
|
16
|
+
const { req, metric, windowMinutes, adapterId, now, path } = args;
|
|
17
|
+
const series = args.series ?? true;
|
|
39
18
|
const dateRange = {
|
|
40
19
|
start: /* @__PURE__ */ new Date(now.getTime() - windowMinutes * 6e4),
|
|
41
20
|
end: now
|
|
42
21
|
};
|
|
43
|
-
const
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
22
|
+
const prepared = await prepareWidgetRead({
|
|
23
|
+
req,
|
|
24
|
+
now,
|
|
25
|
+
range: dateRange,
|
|
26
|
+
timezone: "UTC",
|
|
27
|
+
adapterId,
|
|
28
|
+
...readPrincipalOf(args),
|
|
29
|
+
...args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {},
|
|
30
|
+
requires: { realtime: true }
|
|
31
|
+
});
|
|
32
|
+
if (!prepared.ok) return empty(prepared.status === "not-configured" || prepared.status === "no-access" || prepared.status === "no-scope" ? prepared.status : "unavailable", prepared.adapterId);
|
|
33
|
+
const { runtime, adapter, queryScope } = prepared;
|
|
34
|
+
const realtime = adapter.realtime;
|
|
35
|
+
if (!realtime) return empty("unavailable", adapter.id);
|
|
36
|
+
const ttlSeconds = runtime.ttl.realtime ?? adapter.capabilities.recommendedTtl.realtime;
|
|
37
|
+
const key = buildRealtimeKey(adapter.id, {
|
|
38
|
+
metric,
|
|
39
|
+
windowMinutes,
|
|
40
|
+
series,
|
|
41
|
+
...queryScope === void 0 ? {} : { scope: queryScope },
|
|
42
|
+
...path === void 0 ? {} : { path }
|
|
43
|
+
}, await cacheEpochsFor(runtime, queryScope));
|
|
44
|
+
let result = runtime.memo?.get(key);
|
|
45
|
+
if (!result) {
|
|
46
|
+
const query = {
|
|
47
|
+
metrics: [metric],
|
|
48
|
+
dateRange,
|
|
49
|
+
scope: queryScope,
|
|
50
|
+
...path === void 0 ? {} : { path },
|
|
51
|
+
...series ? { granularity: "minute" } : {}
|
|
52
|
+
};
|
|
53
|
+
try {
|
|
54
|
+
result = runtime.engine.realtime ? await runtime.engine.realtime(adapter, query) : await realtime.call(adapter, query, { payload: req.payload });
|
|
55
|
+
} catch (err) {
|
|
56
|
+
return failed(err, adapter.id);
|
|
57
|
+
}
|
|
58
|
+
runtime.memo?.set(key, result, ttlSeconds * 1e3);
|
|
59
|
+
}
|
|
60
|
+
return {
|
|
49
61
|
status: "ok",
|
|
50
62
|
adapterId: adapter.id,
|
|
63
|
+
...substitutionOf(prepared),
|
|
51
64
|
activeNow: result.totals?.[metric] ?? 0,
|
|
52
65
|
series: result.rows.map((r) => ({
|
|
53
66
|
date: r.timestamp ?? "",
|
|
54
67
|
value: r.metrics[metric] ?? 0
|
|
55
|
-
}))
|
|
68
|
+
})),
|
|
69
|
+
...queryScope === void 0 ? {} : { scope: queryScope },
|
|
70
|
+
...readMeta(result)
|
|
56
71
|
};
|
|
57
|
-
await store.set(key, out, ttlSeconds);
|
|
58
|
-
return out;
|
|
59
72
|
};
|
|
73
|
+
/**
|
|
74
|
+
* Realtime read for the "active now" widget, memoized in-process only (a by-the-minute count is
|
|
75
|
+
* not worth a cache write) and keyed here, since the engine's key day-snaps the range.
|
|
76
|
+
*/
|
|
77
|
+
const readForWidgetRealtime = (args) => readRealtime(args, (err, adapterId) => {
|
|
78
|
+
const { status, retryAfterMs } = readFailureOf(err);
|
|
79
|
+
return {
|
|
80
|
+
...empty(status, adapterId),
|
|
81
|
+
...retryAfterMs === void 0 ? {} : { retryAfterMs }
|
|
82
|
+
};
|
|
83
|
+
});
|
|
84
|
+
/** The same read for the live endpoint, which answers a failed read with its own error response. */
|
|
85
|
+
const readRealtimeOrThrow = (args) => readRealtime(args, (err) => {
|
|
86
|
+
throw err;
|
|
87
|
+
});
|
|
60
88
|
//#endregion
|
|
61
|
-
export { readForWidgetRealtime };
|
|
89
|
+
export { readForWidgetRealtime, readRealtimeOrThrow };
|
|
62
90
|
|
|
63
91
|
//# sourceMappingURL=readForWidgetRealtime.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"readForWidgetRealtime.js","names":[],"sources":["../../src/widgets/readForWidgetRealtime.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport {
|
|
1
|
+
{"version":3,"file":"readForWidgetRealtime.js","names":[],"sources":["../../src/widgets/readForWidgetRealtime.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type ReadPrincipal, readPrincipalOf } from '../access/principal'\nimport { buildRealtimeKey } from '../core/cacheKey'\nimport type { AnalyticsQuery, AnalyticsResult, MetricKey } from '../core/contract'\nimport { cacheEpochsFor } from '../plugin/runtime'\nimport { readFailureOf } from '../surfacing/classifyError'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport {\n\tprepareWidgetRead,\n\ttype StoredSourceRead,\n\ttype SubstitutedSource,\n\tsubstitutionOf,\n} from './prepareWidgetRead'\nimport { type ReadNotices, readMeta } from './readMeta'\n\n/**\n * What the live count reports: `unavailable` a source counting no one live, `busy` one that failed\n * to count for now, `misconfigured` and `host-refused` one whose setup refused the read.\n */\nexport type WidgetRealtimeStatus =\n\t| 'ok'\n\t| 'not-configured'\n\t| 'unavailable'\n\t| 'busy'\n\t| 'invalid'\n\t| 'no-access'\n\t| 'no-scope'\n\t| 'misconfigured'\n\t| 'host-refused'\n\nexport interface RealtimePoint {\n\tdate: string\n\tvalue: number\n}\n\nexport interface WidgetRealtimeResult extends Partial<ReadNotices>, SubstitutedSource {\n\tstatus: WidgetRealtimeStatus\n\t/** How long until a `busy` read can succeed, when the source or the plugin knows. */\n\tretryAfterMs?: number\n\tadapterId: string\n\t/** The window's total for the metric that was asked for, not visitors specifically. */\n\tactiveNow: number\n\tseries: RealtimePoint[]\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\t/** The scope the read narrowed to, absent for an install-wide one. */\n\tscope?: string\n}\n\n/** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */\nexport type ReadForWidgetRealtimeArgs = ReadPrincipal &\n\tStoredSourceRead & {\n\t\treq: PayloadRequest\n\t\tmetric: MetricKey\n\t\twindowMinutes: number\n\t\tadapterId?: string\n\t\tnow: Date\n\t\t/** Count only the visitors on this path; omitted counts the whole site. */\n\t\tpath?: string\n\t\t/** False reads the window's total alone, its `series` left empty. Default true. */\n\t\tseries?: boolean\n\t}\n\nconst empty = (status: WidgetRealtimeStatus, adapterId: string): WidgetRealtimeResult => ({\n\tstatus,\n\tadapterId,\n\tactiveNow: 0,\n\tseries: [],\n})\n\n/** The live count both callers share; `failed` answers for a source read that throws. */\nconst readRealtime = async (\n\targs: ReadForWidgetRealtimeArgs,\n\tfailed: (err: unknown, adapterId: string) => WidgetRealtimeResult\n): Promise<WidgetRealtimeResult> => {\n\tconst { req, metric, windowMinutes, adapterId, now, path } = args\n\tconst series = args.series ?? true\n\tconst dateRange = { start: new Date(now.getTime() - windowMinutes * 60_000), end: now }\n\t// The window is anchored on `now` and never rendered in a zone, so the poll skips the\n\t// install's timezone resolver rather than paying for it ahead of the cache check.\n\tconst prepared = await prepareWidgetRead({\n\t\treq,\n\t\tnow,\n\t\trange: dateRange,\n\t\ttimezone: DEFAULT_TIMEZONE,\n\t\tadapterId,\n\t\t...readPrincipalOf(args),\n\t\t...(args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {}),\n\t\trequires: { realtime: true },\n\t})\n\tif (!prepared.ok) {\n\t\t// The window carries no filters, so `filter-unsupported` cannot arise here.\n\t\tconst status =\n\t\t\tprepared.status === 'not-configured' ||\n\t\t\tprepared.status === 'no-access' ||\n\t\t\tprepared.status === 'no-scope'\n\t\t\t\t? prepared.status\n\t\t\t\t: 'unavailable'\n\t\treturn empty(status, prepared.adapterId)\n\t}\n\tconst { runtime, adapter, queryScope } = prepared\n\t// The capability says the source counts live visitors; the hook is what reads them.\n\tconst realtime = adapter.realtime\n\tif (!realtime) {\n\t\treturn empty('unavailable', adapter.id)\n\t}\n\n\tconst ttlSeconds = runtime.ttl.realtime ?? adapter.capabilities.recommendedTtl.realtime\n\t// Built outside the engine, so it carries the scope's epochs itself. The path is in it: two\n\t// pages of one site share everything else, so one page's count would otherwise serve the other's.\n\tconst key = buildRealtimeKey(\n\t\tadapter.id,\n\t\t{\n\t\t\tmetric,\n\t\t\twindowMinutes,\n\t\t\tseries,\n\t\t\t...(queryScope === undefined ? {} : { scope: queryScope }),\n\t\t\t...(path === undefined ? {} : { path }),\n\t\t},\n\t\tawait cacheEpochsFor(runtime, queryScope)\n\t)\n\tlet result: AnalyticsResult | undefined = runtime.memo?.get(key)\n\tif (!result) {\n\t\tconst query: AnalyticsQuery = {\n\t\t\tmetrics: [metric],\n\t\t\tdateRange,\n\t\t\tscope: queryScope,\n\t\t\t...(path === undefined ? {} : { path }),\n\t\t\t...(series ? { granularity: 'minute' as const } : {}),\n\t\t}\n\t\t// Through the source's lane like every other read of it, waiting ahead of background work;\n\t\t// the native engine's lane stays its own. A runtime built by hand may have no lanes.\n\t\ttry {\n\t\t\tresult = runtime.engine.realtime\n\t\t\t\t? await runtime.engine.realtime(adapter, query)\n\t\t\t\t: await realtime.call(adapter, query, { payload: req.payload })\n\t\t} catch (err) {\n\t\t\treturn failed(err, adapter.id)\n\t\t}\n\t\truntime.memo?.set(key, result, ttlSeconds * 1000)\n\t}\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\t...substitutionOf(prepared),\n\t\tactiveNow: result.totals?.[metric] ?? 0,\n\t\tseries: result.rows.map((r) => ({ date: r.timestamp ?? '', value: r.metrics[metric] ?? 0 })),\n\t\t...(queryScope === undefined ? {} : { scope: queryScope }),\n\t\t...readMeta(result),\n\t}\n}\n\n/**\n * Realtime read for the \"active now\" widget, memoized in-process only (a by-the-minute count is\n * not worth a cache write) and keyed here, since the engine's key day-snaps the range.\n */\nexport const readForWidgetRealtime = (\n\targs: ReadForWidgetRealtimeArgs\n): Promise<WidgetRealtimeResult> =>\n\treadRealtime(args, (err, adapterId) => {\n\t\tconst { status, retryAfterMs } = readFailureOf(err)\n\t\treturn {\n\t\t\t...empty(status, adapterId),\n\t\t\t...(retryAfterMs === undefined ? {} : { retryAfterMs }),\n\t\t}\n\t})\n\n/** The same read for the live endpoint, which answers a failed read with its own error response. */\nexport const readRealtimeOrThrow = (\n\targs: ReadForWidgetRealtimeArgs\n): Promise<WidgetRealtimeResult> =>\n\treadRealtime(args, (err) => {\n\t\tthrow err\n\t})\n"],"mappings":";;;;;;;AA+DA,MAAM,SAAS,QAA8B,eAA6C;CACzF;CACA;CACA,WAAW;CACX,QAAQ,CAAC;AACV;;AAGA,MAAM,eAAe,OACpB,MACA,WACmC;CACnC,MAAM,EAAE,KAAK,QAAQ,eAAe,WAAW,KAAK,SAAS;CAC7D,MAAM,SAAS,KAAK,UAAU;CAC9B,MAAM,YAAY;EAAE,uBAAO,IAAI,KAAK,IAAI,QAAQ,IAAI,gBAAgB,GAAM;EAAG,KAAK;CAAI;CAGtF,MAAM,WAAW,MAAM,kBAAkB;EACxC;EACA;EACA,OAAO;EACP,UAAA;EACA;EACA,GAAG,gBAAgB,IAAI;EACvB,GAAI,KAAK,yBAAyB,EAAE,wBAAwB,KAAK,IAAI,CAAC;EACtE,UAAU,EAAE,UAAU,KAAK;CAC5B,CAAC;CACD,IAAI,CAAC,SAAS,IAQb,OAAO,MALN,SAAS,WAAW,oBACpB,SAAS,WAAW,eACpB,SAAS,WAAW,aACjB,SAAS,SACT,eACiB,SAAS,SAAS;CAExC,MAAM,EAAE,SAAS,SAAS,eAAe;CAEzC,MAAM,WAAW,QAAQ;CACzB,IAAI,CAAC,UACJ,OAAO,MAAM,eAAe,QAAQ,EAAE;CAGvC,MAAM,aAAa,QAAQ,IAAI,YAAY,QAAQ,aAAa,eAAe;CAG/E,MAAM,MAAM,iBACX,QAAQ,IACR;EACC;EACA;EACA;EACA,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,WAAW;EACxD,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,KAAK;CACtC,GACA,MAAM,eAAe,SAAS,UAAU,CACzC;CACA,IAAI,SAAsC,QAAQ,MAAM,IAAI,GAAG;CAC/D,IAAI,CAAC,QAAQ;EACZ,MAAM,QAAwB;GAC7B,SAAS,CAAC,MAAM;GAChB;GACA,OAAO;GACP,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,KAAK;GACrC,GAAI,SAAS,EAAE,aAAa,SAAkB,IAAI,CAAC;EACpD;EAGA,IAAI;GACH,SAAS,QAAQ,OAAO,WACrB,MAAM,QAAQ,OAAO,SAAS,SAAS,KAAK,IAC5C,MAAM,SAAS,KAAK,SAAS,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC;EAChE,SAAS,KAAK;GACb,OAAO,OAAO,KAAK,QAAQ,EAAE;EAC9B;EACA,QAAQ,MAAM,IAAI,KAAK,QAAQ,aAAa,GAAI;CACjD;CACA,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB,GAAG,eAAe,QAAQ;EAC1B,WAAW,OAAO,SAAS,WAAW;EACtC,QAAQ,OAAO,KAAK,KAAK,OAAO;GAAE,MAAM,EAAE,aAAa;GAAI,OAAO,EAAE,QAAQ,WAAW;EAAE,EAAE;EAC3F,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,WAAW;EACxD,GAAG,SAAS,MAAM;CACnB;AACD;;;;;AAMA,MAAa,yBACZ,SAEA,aAAa,OAAO,KAAK,cAAc;CACtC,MAAM,EAAE,QAAQ,iBAAiB,cAAc,GAAG;CAClD,OAAO;EACN,GAAG,MAAM,QAAQ,SAAS;EAC1B,GAAI,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa;CACtD;AACD,CAAC;;AAGF,MAAa,uBACZ,SAEA,aAAa,OAAO,QAAQ;CAC3B,MAAM;AACP,CAAC"}
|
|
@@ -1,58 +1,63 @@
|
|
|
1
|
-
import { AnalyticsFilter, DateRange, MetricKey } from "../core/contract.js";
|
|
1
|
+
import { AnalyticsFilter, DateRange, MetricKey, MetricValue } from "../core/contract.js";
|
|
2
|
+
import { ReadPrincipal } from "../access/principal.js";
|
|
2
3
|
import { TimeframePreset } from "../timeframe/presets.js";
|
|
3
|
-
import {
|
|
4
|
+
import { ReadNotices } from "./readMeta.js";
|
|
5
|
+
import { StoredSourceRead, SubstitutedSource, WidgetReadStatus } from "./prepareWidgetRead.js";
|
|
6
|
+
import { SeriesGranularity, SeriesPoint } from "../charts/series.js";
|
|
4
7
|
import { PayloadRequest } from "payload";
|
|
5
8
|
|
|
6
9
|
//#region src/widgets/readForWidgetSeries.d.ts
|
|
7
|
-
interface
|
|
8
|
-
date: string;
|
|
9
|
-
value: number;
|
|
10
|
-
}
|
|
11
|
-
interface WidgetSeriesResult {
|
|
10
|
+
interface WidgetSeriesResult extends Partial<ReadNotices>, SubstitutedSource {
|
|
12
11
|
status: WidgetReadStatus;
|
|
12
|
+
/** How long until a `busy` read can succeed, when the source or the plugin knows. */
|
|
13
|
+
retryAfterMs?: number;
|
|
13
14
|
adapterId: string;
|
|
15
|
+
/** The scope the read narrowed to, absent for an install-wide one. */
|
|
16
|
+
scope?: string;
|
|
14
17
|
dateRange: DateRange;
|
|
15
18
|
/** Reporting timezone the read resolved in; the trend axis buckets in it. */
|
|
16
19
|
timezone: string;
|
|
17
20
|
points: SeriesPoint[];
|
|
18
|
-
|
|
19
|
-
|
|
21
|
+
/**
|
|
22
|
+
* The bucket the points actually carry. A window of a day or two is charted by hour, so
|
|
23
|
+
* `day` there says the source serves no hourly rows and the series is a single point.
|
|
24
|
+
*/
|
|
25
|
+
seriesGranularity?: SeriesGranularity;
|
|
26
|
+
/** The window's headline reading; `null` for an average with no samples in it. */
|
|
27
|
+
total: MetricValue;
|
|
28
|
+
/** The source that answered, absent on a read that never reached one. */
|
|
29
|
+
provider?: string;
|
|
20
30
|
/** Previous-window headline total, present only when the adapter supports comparison. */
|
|
21
|
-
previousTotal?:
|
|
31
|
+
previousTotal?: MetricValue;
|
|
22
32
|
/** The previous comparable window, present only when comparison ran. */
|
|
23
33
|
comparisonRange?: DateRange;
|
|
24
34
|
/**
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
* previous window's day i overlays `points[i]`.
|
|
35
|
+
* Previous window's series at the same granularity, when `compare` ran. Zero-filled to the
|
|
36
|
+
* length of `points`, so its bucket i overlays `points[i]`.
|
|
28
37
|
*/
|
|
29
38
|
comparisonPoints?: SeriesPoint[];
|
|
30
39
|
}
|
|
31
|
-
|
|
40
|
+
/** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */
|
|
41
|
+
type ReadForWidgetSeriesArgs = ReadPrincipal & StoredSourceRead & {
|
|
32
42
|
req: PayloadRequest;
|
|
33
43
|
metric: MetricKey;
|
|
34
44
|
timeframe: TimeframePreset;
|
|
35
45
|
adapterId?: string;
|
|
36
46
|
now: Date;
|
|
37
47
|
range?: DateRange;
|
|
38
|
-
/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
|
|
39
|
-
scope?: string | null;
|
|
40
48
|
/**
|
|
41
49
|
* Reporting timezone the caller already resolved, reused rather than resolved again so
|
|
42
50
|
* a caller-supplied `range` is read in the very timezone it was interpreted in.
|
|
43
51
|
*/
|
|
44
52
|
timezone?: string;
|
|
45
|
-
filters?: AnalyticsFilter[];
|
|
46
|
-
/** Also return the previous window's series, for the chart's comparison overlay. */
|
|
53
|
+
filters?: AnalyticsFilter[]; /** Also return the previous window's series, for the chart's comparison overlay. */
|
|
47
54
|
compare?: boolean;
|
|
48
|
-
}
|
|
55
|
+
};
|
|
49
56
|
/**
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
* then return a zero-filled daily series plus the headline total. Mirrors
|
|
53
|
-
* `readForWidget` but yields points instead of a single value.
|
|
57
|
+
* Trend read: a zero-filled series plus headline total. A window of a day or two reads by hour
|
|
58
|
+
* where served (a daily axis there is one point); see {@link seriesGranularityFor}.
|
|
54
59
|
*/
|
|
55
60
|
declare const readForWidgetSeries: (args: ReadForWidgetSeriesArgs) => Promise<WidgetSeriesResult>;
|
|
56
61
|
//#endregion
|
|
57
|
-
export { ReadForWidgetSeriesArgs,
|
|
62
|
+
export { ReadForWidgetSeriesArgs, WidgetSeriesResult, readForWidgetSeries };
|
|
58
63
|
//# sourceMappingURL=readForWidgetSeries.d.ts.map
|