@10x-media/analytics 1.0.0-beta.9 → 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 +710 -0
- 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 +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +24 -0
- package/dist/adapters/ga4/ga4.js +226 -122
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +2 -3
- package/dist/adapters/ga4/measurementId.js.map +1 -1
- package/dist/adapters/goalRead.js +15 -29
- package/dist/adapters/goalRead.js.map +1 -1
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +25 -13
- package/dist/adapters/plausible/plausible.js +144 -124
- 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 +279 -121
- 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 +19 -9
- package/dist/adapters/umami/umami.js +196 -166
- 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 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +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 +48 -36
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +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 +321 -60
- 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 +530 -152
- package/dist/core/options.js +158 -216
- 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 -16
- 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 +16 -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 +43 -12
- package/dist/exports/client.js +22 -8
- 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 +32 -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 -18
- package/dist/exports/tracker.js +3 -12
- package/dist/exports/types.d.ts +45 -14
- package/dist/exports/types.js +6 -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 +2 -2
- package/dist/fields/config/FilterDimensionSelectField.js +26 -54
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
- package/dist/fields/config/FilterOperatorSelectField.js +37 -53
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +18 -30
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.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/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +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 +450 -116
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +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 +68 -12
- package/dist/index.js +261 -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 +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- 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 +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +70 -8
- package/dist/native/ingest/normalizeEvent.js +239 -60
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +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 -69
- 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 +5 -2
- package/dist/native/ingest/source.js +163 -59
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +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 +396 -288
- 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 +105 -71
- 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.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/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 +80 -51
- 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 +79 -34
- 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 -23
- 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 +369 -150
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +84 -0
- package/dist/providers/factory.js +84 -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 +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- 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 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +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 +434 -91
- 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 +97 -17
- package/dist/tracker/sinks/ga4.js.map +1 -1
- 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 -49
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +255 -74
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +243 -71
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +238 -70
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +246 -71
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +250 -75
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +241 -70
- 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 +214 -17
- package/dist/translations/keys.js +219 -17
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +243 -72
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +255 -80
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +246 -69
- 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 +246 -69
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +241 -70
- 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 -185
- 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 +67 -32
- 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 +113 -16
- 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 +195 -132
- 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 +127 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +42 -36
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +181 -122
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +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 +144 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +81 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +130 -123
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +24 -4
- package/dist/widgets/RealtimeCounter.js +90 -71
- 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 -7
- package/dist/widgets/defaults.js +12 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +79 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +19 -2
- package/dist/widgets/prepareWidgetRead.js +63 -27
- package/dist/widgets/prepareWidgetRead.js.map +1 -1
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +28 -19
- package/dist/widgets/readForWidget.js +33 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
- package/dist/widgets/readForWidgetBreakdown.js +48 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +18 -24
- package/dist/widgets/readForWidgetGoals.js +52 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
- package/dist/widgets/readForWidgetRealtime.js +54 -27
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +27 -32
- package/dist/widgets/readForWidgetSeries.js +45 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +48 -0
- package/dist/widgets/readMeta.js +52 -4
- package/dist/widgets/readMeta.js.map +1 -1
- 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 -127
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +4 -3
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +31 -24
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +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 -157
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -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 -174
- 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/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -105
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/next/captureRewrites.d.ts +0 -42
- package/dist/next/captureRewrites.js +0 -57
- 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/plugin/responses.js +0 -17
- package/dist/plugin/responses.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/ga4.d.ts +0 -21
- 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 -57
- package/dist/widgets/comparison.js.map +0 -1
package/dist/widgets/range.js
CHANGED
|
@@ -1,13 +1,11 @@
|
|
|
1
1
|
import { zonedCalendarDay } from "../timeframe/tz.js";
|
|
2
|
+
import { dateTimeFormat } from "../translations/intl.js";
|
|
2
3
|
import { DATE_ONLY, parseDayOrInstant } from "../query/dates.js";
|
|
3
4
|
//#region src/widgets/range.ts
|
|
4
5
|
const NOON_MS = 12 * 36e5;
|
|
5
6
|
/**
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* UTC depending on the browser's offset; a 12-hour shift recovers the picked day for every
|
|
9
|
-
* offset in (-12, +12]. Zones at +12:45 and beyond (Chatham in DST, Kiritimati) recover the
|
|
10
|
-
* day before, and the uninhabited UTC-12 the day after.
|
|
7
|
+
* Calendar day a stored bound names. The `dayOnly` picker stores the browser's local midnight,
|
|
8
|
+
* so a 12-hour shift recovers the picked day for every offset in (-12, +12].
|
|
11
9
|
*/
|
|
12
10
|
const pickedDay = (raw) => {
|
|
13
11
|
if (DATE_ONLY.test(raw)) return raw;
|
|
@@ -16,11 +14,8 @@ const pickedDay = (raw) => {
|
|
|
16
14
|
return zonedCalendarDay(new Date(instant.getTime() + NOON_MS), "UTC");
|
|
17
15
|
};
|
|
18
16
|
/**
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
* real day (a corrupt or hand-set widgetData would otherwise reach the cache key and throw
|
|
22
|
-
* on `toISOString`). The two picked days are read inclusively in `timezone`, the reporting
|
|
23
|
-
* timezone the read resolves in: `from` at the first instant of its day, `to` at the last.
|
|
17
|
+
* A widget's custom range, inclusive in `timezone`; undefined on a preset, when incomplete, or
|
|
18
|
+
* when a bound names no real day (corrupt widgetData would otherwise throw in the cache key).
|
|
24
19
|
*/
|
|
25
20
|
const resolveCustomRange = (timeframe, range, timezone) => {
|
|
26
21
|
if (timeframe !== "custom" || !range?.from || !range?.to) return;
|
|
@@ -41,19 +36,29 @@ const resolveCustomRange = (timeframe, range, timezone) => {
|
|
|
41
36
|
end
|
|
42
37
|
};
|
|
43
38
|
};
|
|
44
|
-
const formatDay = (d, locale, timeZone) => d.toLocaleDateString(locale, {
|
|
45
|
-
month: "short",
|
|
46
|
-
day: "numeric",
|
|
47
|
-
year: "numeric",
|
|
48
|
-
timeZone
|
|
49
|
-
});
|
|
50
39
|
/**
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
* than the days the server's own zone would spell them as.
|
|
40
|
+
* Whether a custom range sets both bounds yet one names no real day or a day before 1970: the
|
|
41
|
+
* widget says the read is invalid rather than reading the last 30 days in its place.
|
|
54
42
|
*/
|
|
55
|
-
const
|
|
43
|
+
const isUnreadableCustomRange = (timeframe, range) => timeframe === "custom" && Boolean(range?.from && range?.to) && resolveCustomRange(timeframe, range, "UTC") === void 0;
|
|
44
|
+
/**
|
|
45
|
+
* Caption for a range as the language writes a span of days ("Jun 1 to 23, 2026"), in the
|
|
46
|
+
* reporting timezone so it names the days that were read, not the server zone's.
|
|
47
|
+
*/
|
|
48
|
+
const formatRangeCaption = (range, locale, timezone) => {
|
|
49
|
+
const format = dateTimeFormat(locale, {
|
|
50
|
+
month: "short",
|
|
51
|
+
day: "numeric",
|
|
52
|
+
year: "numeric",
|
|
53
|
+
timeZone: timezone
|
|
54
|
+
});
|
|
55
|
+
try {
|
|
56
|
+
return format.formatRange(range.start, range.end).replace(/[\u2009\u202f]/g, " ");
|
|
57
|
+
} catch {
|
|
58
|
+
return `${format.format(range.start)} - ${format.format(range.end)}`;
|
|
59
|
+
}
|
|
60
|
+
};
|
|
56
61
|
//#endregion
|
|
57
|
-
export { formatRangeCaption, resolveCustomRange };
|
|
62
|
+
export { formatRangeCaption, isUnreadableCustomRange, pickedDay, resolveCustomRange };
|
|
58
63
|
|
|
59
64
|
//# sourceMappingURL=range.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"range.js","names":[],"sources":["../../src/widgets/range.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport { DATE_ONLY, parseDayOrInstant } from '../query/dates'\nimport { zonedCalendarDay } from '../timeframe/tz'\nimport type { WidgetRange } from './types'\n\nconst NOON_MS = 12 * 3_600_000\n\n/**\n *
|
|
1
|
+
{"version":3,"file":"range.js","names":[],"sources":["../../src/widgets/range.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport { DATE_ONLY, parseDayOrInstant } from '../query/dates'\nimport { zonedCalendarDay } from '../timeframe/tz'\nimport { dateTimeFormat } from '../translations/intl'\nimport type { WidgetRange } from './types'\n\nconst NOON_MS = 12 * 3_600_000\n\n/**\n * Calendar day a stored bound names. The `dayOnly` picker stores the browser's local midnight,\n * so a 12-hour shift recovers the picked day for every offset in (-12, +12].\n */\nexport const pickedDay = (raw: string): string | null => {\n\tif (DATE_ONLY.test(raw)) {\n\t\treturn raw\n\t}\n\tconst instant = new Date(raw)\n\tif (Number.isNaN(instant.getTime())) {\n\t\treturn null\n\t}\n\treturn zonedCalendarDay(new Date(instant.getTime() + NOON_MS), 'UTC')\n}\n\n/**\n * A widget's custom range, inclusive in `timezone`; undefined on a preset, when incomplete, or\n * when a bound names no real day (corrupt widgetData would otherwise throw in the cache key).\n */\nexport const resolveCustomRange = (\n\ttimeframe: string | undefined,\n\trange: WidgetRange | undefined,\n\ttimezone: string\n): DateRange | undefined => {\n\tif (timeframe !== 'custom' || !range?.from || !range?.to) {\n\t\treturn undefined\n\t}\n\tconst fromDay = pickedDay(range.from)\n\tconst toDay = pickedDay(range.to)\n\tif (!fromDay || !toDay) {\n\t\treturn undefined\n\t}\n\tconst start = parseDayOrInstant(fromDay, { timezone, edge: 'start' })\n\tconst end = parseDayOrInstant(toDay, { timezone, edge: 'end' })\n\tif (!start || !end) {\n\t\treturn undefined\n\t}\n\treturn { start, end }\n}\n\n/**\n * Whether a custom range sets both bounds yet one names no real day or a day before 1970: the\n * widget says the read is invalid rather than reading the last 30 days in its place.\n */\nexport const isUnreadableCustomRange = (\n\ttimeframe: string | undefined,\n\trange: WidgetRange | undefined\n): boolean =>\n\ttimeframe === 'custom' &&\n\tBoolean(range?.from && range?.to) &&\n\tresolveCustomRange(timeframe, range, 'UTC') === undefined\n\n/**\n * Caption for a range as the language writes a span of days (\"Jun 1 to 23, 2026\"), in the\n * reporting timezone so it names the days that were read, not the server zone's.\n */\nexport const formatRangeCaption = (range: DateRange, locale: string, timezone: string): string => {\n\tconst format = dateTimeFormat(locale, {\n\t\tmonth: 'short',\n\t\tday: 'numeric',\n\t\tyear: 'numeric',\n\t\ttimeZone: timezone,\n\t})\n\ttry {\n\t\t// Node's ICU writes thin spaces around the span's dash where browsers write plain ones, and\n\t\t// the toolbar renders on both sides of a hydration.\n\t\treturn format.formatRange(range.start, range.end).replace(/[\\u2009\\u202f]/g, ' ')\n\t} catch {\n\t\treturn `${format.format(range.start)} - ${format.format(range.end)}`\n\t}\n}\n"],"mappings":";;;;AAMA,MAAM,UAAU,KAAK;;;;;AAMrB,MAAa,aAAa,QAA+B;CACxD,IAAI,UAAU,KAAK,GAAG,GACrB,OAAO;CAER,MAAM,UAAU,IAAI,KAAK,GAAG;CAC5B,IAAI,OAAO,MAAM,QAAQ,QAAQ,CAAC,GACjC,OAAO;CAER,OAAO,iBAAiB,IAAI,KAAK,QAAQ,QAAQ,IAAI,OAAO,GAAG,KAAK;AACrE;;;;;AAMA,MAAa,sBACZ,WACA,OACA,aAC2B;CAC3B,IAAI,cAAc,YAAY,CAAC,OAAO,QAAQ,CAAC,OAAO,IACrD;CAED,MAAM,UAAU,UAAU,MAAM,IAAI;CACpC,MAAM,QAAQ,UAAU,MAAM,EAAE;CAChC,IAAI,CAAC,WAAW,CAAC,OAChB;CAED,MAAM,QAAQ,kBAAkB,SAAS;EAAE;EAAU,MAAM;CAAQ,CAAC;CACpE,MAAM,MAAM,kBAAkB,OAAO;EAAE;EAAU,MAAM;CAAM,CAAC;CAC9D,IAAI,CAAC,SAAS,CAAC,KACd;CAED,OAAO;EAAE;EAAO;CAAI;AACrB;;;;;AAMA,MAAa,2BACZ,WACA,UAEA,cAAc,YACd,QAAQ,OAAO,QAAQ,OAAO,EAAE,KAChC,mBAAmB,WAAW,OAAO,KAAK,MAAM,KAAA;;;;;AAMjD,MAAa,sBAAsB,OAAkB,QAAgB,aAA6B;CACjG,MAAM,SAAS,eAAe,QAAQ;EACrC,OAAO;EACP,KAAK;EACL,MAAM;EACN,UAAU;CACX,CAAC;CACD,IAAI;EAGH,OAAO,OAAO,YAAY,MAAM,OAAO,MAAM,GAAG,EAAE,QAAQ,mBAAmB,GAAG;CACjF,QAAQ;EACP,OAAO,GAAG,OAAO,OAAO,MAAM,KAAK,EAAE,KAAK,OAAO,OAAO,MAAM,GAAG;CAClE;AACD"}
|
|
@@ -1,41 +1,46 @@
|
|
|
1
|
-
import { AnalyticsFilter, DateRange, MetricKey } from "../core/contract.js";
|
|
1
|
+
import { AnalyticsFilter, DateRange, MetricKey, MetricValues } 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";
|
|
4
6
|
import { PayloadRequest } from "payload";
|
|
5
7
|
|
|
6
8
|
//#region src/widgets/readForWidget.d.ts
|
|
7
|
-
interface WidgetReadResult {
|
|
9
|
+
interface WidgetReadResult extends Partial<ReadNotices>, SubstitutedSource {
|
|
8
10
|
status: WidgetReadStatus;
|
|
11
|
+
/** How long until a `busy` read can succeed, when the source or the plugin knows. */
|
|
12
|
+
retryAfterMs?: number;
|
|
9
13
|
adapterId: string;
|
|
14
|
+
/** The reporting timezone the read resolved in, which names its days. */
|
|
15
|
+
timezone?: string;
|
|
16
|
+
/**
|
|
17
|
+
* Scope a link to this read must name, set only when the viewer would not resolve it alone:
|
|
18
|
+
* a needless `scope` refuses every reader without `access.crossScope`.
|
|
19
|
+
*/
|
|
20
|
+
scope?: string;
|
|
10
21
|
dateRange: DateRange;
|
|
11
|
-
|
|
22
|
+
/** An average with nothing to average over reads `null`; render it as no data, not zero. */
|
|
23
|
+
metrics: MetricValues;
|
|
12
24
|
/** The source that answered, absent on a read that never reached one. */
|
|
13
25
|
provider?: string;
|
|
14
|
-
|
|
15
|
-
/** True when the engine served a stale cache entry after a failed provider read. */
|
|
16
|
-
stale?: boolean;
|
|
17
|
-
/** True when the source answered without one of the filters the read carried. */
|
|
18
|
-
filtersUnapplied?: boolean;
|
|
19
|
-
/** True when the read hit the source's event scan cap, so the numbers are a floor. */
|
|
20
|
-
sampled?: boolean;
|
|
21
|
-
/** True when the source could not read the scope's goals, so a conversions total means nothing. */
|
|
22
|
-
goalsUnresolved?: boolean;
|
|
23
|
-
/** The read asked about goals and the scope has none configured. */
|
|
26
|
+
/** The read asked about goals and the scope declared none of its own. */
|
|
24
27
|
noGoals?: boolean;
|
|
25
28
|
/** Previous-window totals, present only when the adapter supports comparison. */
|
|
26
|
-
previousMetrics?:
|
|
29
|
+
previousMetrics?: MetricValues;
|
|
27
30
|
/** The previous comparable window, present only when comparison ran. */
|
|
28
31
|
comparisonRange?: DateRange;
|
|
29
32
|
}
|
|
30
|
-
|
|
33
|
+
/**
|
|
34
|
+
* Without `scope` the read is the request's own, behind `access.read`. A `scope` must be one
|
|
35
|
+
* already cleared for this request, or a job's own with `principal: SYSTEM`.
|
|
36
|
+
*/
|
|
37
|
+
type ReadForWidgetArgs = ReadPrincipal & StoredSourceRead & {
|
|
31
38
|
req: PayloadRequest;
|
|
32
39
|
metrics: MetricKey[];
|
|
33
40
|
timeframe: TimeframePreset;
|
|
34
41
|
adapterId?: string;
|
|
35
42
|
now: Date;
|
|
36
43
|
range?: DateRange;
|
|
37
|
-
/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
|
|
38
|
-
scope?: string | null;
|
|
39
44
|
/**
|
|
40
45
|
* Reporting timezone the caller already resolved, reused rather than resolved again so
|
|
41
46
|
* a caller-supplied `range` is read in the very timezone it was interpreted in.
|
|
@@ -47,7 +52,11 @@ interface ReadForWidgetArgs {
|
|
|
47
52
|
* to on; a caller that never renders a delta passes false to save the second read.
|
|
48
53
|
*/
|
|
49
54
|
comparison?: boolean;
|
|
50
|
-
}
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Totals of `metrics` over a widget's window, beside the previous window's where the install and
|
|
58
|
+
* the source compare. A source that fails answers with a status rather than a throw.
|
|
59
|
+
*/
|
|
51
60
|
declare const readForWidget: (args: ReadForWidgetArgs) => Promise<WidgetReadResult>;
|
|
52
61
|
//#endregion
|
|
53
62
|
export { ReadForWidgetArgs, WidgetReadResult, readForWidget };
|
|
@@ -1,17 +1,22 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import { prepareWidgetRead } from "./prepareWidgetRead.js";
|
|
1
|
+
import { readPrincipalOf } from "../access/principal.js";
|
|
2
|
+
import { readFailureOf } from "../surfacing/classifyError.js";
|
|
3
|
+
import { comparisonWindow, engineRead, pinnedScope, prepareWidgetRead, substitutionOf } from "./prepareWidgetRead.js";
|
|
4
4
|
import { readMeta } from "./readMeta.js";
|
|
5
|
+
import { hasNoDeclaredGoals } from "../goals/latent.js";
|
|
5
6
|
//#region src/widgets/readForWidget.ts
|
|
7
|
+
/**
|
|
8
|
+
* Totals of `metrics` over a widget's window, beside the previous window's where the install and
|
|
9
|
+
* the source compare. A source that fails answers with a status rather than a throw.
|
|
10
|
+
*/
|
|
6
11
|
const readForWidget = async (args) => {
|
|
7
12
|
const { req, metrics, timeframe, adapterId, now, range, filters } = args;
|
|
8
|
-
const emptyMetrics = {};
|
|
9
13
|
const prepared = await prepareWidgetRead({
|
|
10
14
|
req,
|
|
11
15
|
now,
|
|
12
16
|
timeframe,
|
|
13
17
|
adapterId,
|
|
14
|
-
|
|
18
|
+
...readPrincipalOf(args),
|
|
19
|
+
...args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {},
|
|
15
20
|
timezone: args.timezone,
|
|
16
21
|
range,
|
|
17
22
|
filters,
|
|
@@ -22,18 +27,10 @@ const readForWidget = async (args) => {
|
|
|
22
27
|
status: prepared.status,
|
|
23
28
|
adapterId: prepared.adapterId,
|
|
24
29
|
dateRange: prepared.dateRange,
|
|
25
|
-
metrics:
|
|
30
|
+
metrics: {}
|
|
26
31
|
};
|
|
27
|
-
const {
|
|
28
|
-
const
|
|
29
|
-
dateRange,
|
|
30
|
-
metrics: emptyMetrics
|
|
31
|
-
};
|
|
32
|
-
const previousRange = args.comparison !== false && runtime.comparison && comparisonOf(adapter.capabilities) ? previousWindow(dateRange, tz) : null;
|
|
33
|
-
const comparisonRange = previousRange && withinLookback(previousRange, adapter.capabilities.maxLookbackDays, {
|
|
34
|
-
tz,
|
|
35
|
-
now
|
|
36
|
-
}) ? previousRange : void 0;
|
|
32
|
+
const { adapter, tz, dateRange } = prepared;
|
|
33
|
+
const comparisonRange = args.comparison === false ? void 0 : comparisonWindow(prepared, now);
|
|
37
34
|
const readBase = {
|
|
38
35
|
metrics,
|
|
39
36
|
filters,
|
|
@@ -41,33 +38,40 @@ const readForWidget = async (args) => {
|
|
|
41
38
|
scope: prepared.queryScope,
|
|
42
39
|
...prepared.goalSlugs === void 0 ? {} : { goalSlugs: prepared.goalSlugs }
|
|
43
40
|
};
|
|
41
|
+
const read = engineRead(prepared, timeframe);
|
|
42
|
+
const main = read({
|
|
43
|
+
...readBase,
|
|
44
|
+
dateRange
|
|
45
|
+
});
|
|
46
|
+
const comparing = comparisonRange ? read({
|
|
47
|
+
...readBase,
|
|
48
|
+
dateRange: comparisonRange
|
|
49
|
+
}).catch(() => void 0) : void 0;
|
|
44
50
|
let result;
|
|
45
|
-
let previous;
|
|
46
51
|
try {
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
dateRange
|
|
50
|
-
}), comparisonRange ? runtime.engine.read(adapter, {
|
|
51
|
-
...readBase,
|
|
52
|
-
dateRange: comparisonRange
|
|
53
|
-
}) : void 0]);
|
|
54
|
-
} catch {
|
|
52
|
+
result = await main;
|
|
53
|
+
} catch (err) {
|
|
55
54
|
return {
|
|
56
|
-
|
|
55
|
+
...readFailureOf(err),
|
|
57
56
|
adapterId: adapter.id,
|
|
58
|
-
|
|
57
|
+
dateRange,
|
|
58
|
+
metrics: {}
|
|
59
59
|
};
|
|
60
60
|
}
|
|
61
|
+
const previous = await comparing;
|
|
61
62
|
const previousMetrics = previous ? previous.totals ?? {} : void 0;
|
|
62
63
|
return {
|
|
63
64
|
status: "ok",
|
|
64
65
|
adapterId: adapter.id,
|
|
66
|
+
...substitutionOf(prepared),
|
|
67
|
+
...pinnedScope(args, prepared.queryScope),
|
|
65
68
|
dateRange,
|
|
69
|
+
timezone: tz,
|
|
66
70
|
metrics: result.totals ?? {},
|
|
67
71
|
...readMeta(result),
|
|
68
|
-
noGoals: Array.isArray(prepared.goalSlugs) && prepared.goalSlugs.
|
|
72
|
+
noGoals: Array.isArray(prepared.goalSlugs) && hasNoDeclaredGoals(prepared.goalSlugs, prepared.builtinGoalSlugs),
|
|
69
73
|
previousMetrics,
|
|
70
|
-
comparisonRange
|
|
74
|
+
comparisonRange: previous ? comparisonRange : void 0
|
|
71
75
|
};
|
|
72
76
|
};
|
|
73
77
|
//#endregion
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"readForWidget.js","names":[],"sources":["../../src/widgets/readForWidget.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport {
|
|
1
|
+
{"version":3,"file":"readForWidget.js","names":[],"sources":["../../src/widgets/readForWidget.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type ReadPrincipal, readPrincipalOf } from '../access/principal'\nimport type {\n\tAnalyticsFilter,\n\tAnalyticsResult,\n\tDateRange,\n\tMetricKey,\n\tMetricValues,\n} from '../core/contract'\nimport { hasNoDeclaredGoals } from '../goals/latent'\nimport { readFailureOf } from '../surfacing/classifyError'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport {\n\tcomparisonWindow,\n\tengineRead,\n\tpinnedScope,\n\tprepareWidgetRead,\n\ttype StoredSourceRead,\n\ttype SubstitutedSource,\n\tsubstitutionOf,\n\ttype WidgetReadStatus,\n} from './prepareWidgetRead'\nimport { type ReadNotices, readMeta } from './readMeta'\n\nexport type { WidgetReadStatus } from './prepareWidgetRead'\n\nexport interface WidgetReadResult 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/** The reporting timezone the read resolved in, which names its days. */\n\ttimezone?: 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\t/** An average with nothing to average over reads `null`; render it as no data, not zero. */\n\tmetrics: MetricValues\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\t/** The read asked about goals and the scope declared none of its own. */\n\tnoGoals?: boolean\n\t/** Previous-window totals, present only when the adapter supports comparison. */\n\tpreviousMetrics?: MetricValues\n\t/** The previous comparable window, present only when comparison ran. */\n\tcomparisonRange?: DateRange\n}\n\n/**\n * Without `scope` the read is the request's own, behind `access.read`. A `scope` must be one\n * already cleared for this request, or a job's own with `principal: SYSTEM`.\n */\nexport type ReadForWidgetArgs = ReadPrincipal &\n\tStoredSourceRead & {\n\t\treq: PayloadRequest\n\t\tmetrics: MetricKey[]\n\t\ttimeframe: TimeframePreset\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\tfilters?: AnalyticsFilter[]\n\t\t/**\n\t\t * Read the previous window too, where the install and the source both allow it. Defaults\n\t\t * to on; a caller that never renders a delta passes false to save the second read.\n\t\t */\n\t\tcomparison?: boolean\n\t}\n\n/**\n * Totals of `metrics` over a widget's window, beside the previous window's where the install and\n * the source compare. A source that fails answers with a status rather than a throw.\n */\nexport const readForWidget = async (args: ReadForWidgetArgs): Promise<WidgetReadResult> => {\n\tconst { req, metrics, timeframe, adapterId, now, range, filters } = args\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,\n\t\tfilters,\n\t\trequires: { metrics },\n\t\tgoalRead: () => ({ metrics }),\n\t})\n\tif (!prepared.ok) {\n\t\treturn {\n\t\t\tstatus: prepared.status,\n\t\t\tadapterId: prepared.adapterId,\n\t\t\tdateRange: prepared.dateRange,\n\t\t\tmetrics: {},\n\t\t}\n\t}\n\tconst { adapter, tz, dateRange } = prepared\n\tconst comparisonRange = args.comparison === false ? undefined : comparisonWindow(prepared, now)\n\tconst readBase = {\n\t\tmetrics,\n\t\tfilters,\n\t\ttimezone: tz,\n\t\tscope: prepared.queryScope,\n\t\t...(prepared.goalSlugs === undefined ? {} : { goalSlugs: prepared.goalSlugs }),\n\t}\n\tconst read = engineRead(prepared, timeframe)\n\t// The number first: a comparison that fails drops the delta, never the number itself.\n\tconst main = read({ ...readBase, dateRange })\n\tconst comparing = comparisonRange\n\t\t? read({ ...readBase, dateRange: comparisonRange }).catch(() => undefined)\n\t\t: undefined\n\tlet result: AnalyticsResult\n\ttry {\n\t\tresult = await main\n\t} catch (err) {\n\t\treturn { ...readFailureOf(err), adapterId: adapter.id, dateRange, metrics: {} }\n\t}\n\tconst previous = await comparing\n\tconst previousMetrics = previous ? (previous.totals ?? {}) : undefined\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\t...substitutionOf(prepared),\n\t\t...pinnedScope(args, prepared.queryScope),\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\tmetrics: result.totals ?? {},\n\t\t...readMeta(result),\n\t\tnoGoals:\n\t\t\tArray.isArray(prepared.goalSlugs) &&\n\t\t\thasNoDeclaredGoals(prepared.goalSlugs, prepared.builtinGoalSlugs),\n\t\tpreviousMetrics,\n\t\tcomparisonRange: previous ? comparisonRange : undefined,\n\t}\n}\n"],"mappings":";;;;;;;;;;AAgFA,MAAa,gBAAgB,OAAO,SAAuD;CAC1F,MAAM,EAAE,KAAK,SAAS,WAAW,WAAW,KAAK,OAAO,YAAY;CACpE,MAAM,WAAW,MAAM,kBAAkB;EACxC;EACA;EACA;EACA;EACA,GAAG,gBAAgB,IAAI;EACvB,GAAI,KAAK,yBAAyB,EAAE,wBAAwB,KAAK,IAAI,CAAC;EACtE,UAAU,KAAK;EACf;EACA;EACA,UAAU,EAAE,QAAQ;EACpB,iBAAiB,EAAE,QAAQ;CAC5B,CAAC;CACD,IAAI,CAAC,SAAS,IACb,OAAO;EACN,QAAQ,SAAS;EACjB,WAAW,SAAS;EACpB,WAAW,SAAS;EACpB,SAAS,CAAC;CACX;CAED,MAAM,EAAE,SAAS,IAAI,cAAc;CACnC,MAAM,kBAAkB,KAAK,eAAe,QAAQ,KAAA,IAAY,iBAAiB,UAAU,GAAG;CAC9F,MAAM,WAAW;EAChB;EACA;EACA,UAAU;EACV,OAAO,SAAS;EAChB,GAAI,SAAS,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW,SAAS,UAAU;CAC7E;CACA,MAAM,OAAO,WAAW,UAAU,SAAS;CAE3C,MAAM,OAAO,KAAK;EAAE,GAAG;EAAU;CAAU,CAAC;CAC5C,MAAM,YAAY,kBACf,KAAK;EAAE,GAAG;EAAU,WAAW;CAAgB,CAAC,EAAE,YAAY,KAAA,CAAS,IACvE,KAAA;CACH,IAAI;CACJ,IAAI;EACH,SAAS,MAAM;CAChB,SAAS,KAAK;EACb,OAAO;GAAE,GAAG,cAAc,GAAG;GAAG,WAAW,QAAQ;GAAI;GAAW,SAAS,CAAC;EAAE;CAC/E;CACA,MAAM,WAAW,MAAM;CACvB,MAAM,kBAAkB,WAAY,SAAS,UAAU,CAAC,IAAK,KAAA;CAC7D,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB,GAAG,eAAe,QAAQ;EAC1B,GAAG,YAAY,MAAM,SAAS,UAAU;EACxC;EACA,UAAU;EACV,SAAS,OAAO,UAAU,CAAC;EAC3B,GAAG,SAAS,MAAM;EAClB,SACC,MAAM,QAAQ,SAAS,SAAS,KAChC,mBAAmB,SAAS,WAAW,SAAS,gBAAgB;EACjE;EACA,iBAAiB,WAAW,kBAAkB,KAAA;CAC/C;AACD"}
|
|
@@ -1,35 +1,50 @@
|
|
|
1
|
-
import { AnalyticsFilter, DateRange, DimensionKey, MetricKey } from "../core/contract.js";
|
|
1
|
+
import { AnalyticsFilter, DateRange, DimensionKey, MetricKey, MetricValue, MetricValues } 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";
|
|
4
6
|
import { PayloadRequest } from "payload";
|
|
5
7
|
|
|
6
8
|
//#region src/widgets/readForWidgetBreakdown.d.ts
|
|
7
9
|
interface BreakdownRow {
|
|
10
|
+
/**
|
|
11
|
+
* What the reader sees, in the admin language as every built-in surface labels the row:
|
|
12
|
+
* a goal's name, a country's, an item's title, `Not set` for a row with no value.
|
|
13
|
+
*/
|
|
8
14
|
label: string;
|
|
9
|
-
value:
|
|
15
|
+
/** The stored value, `''` for a row with no value: what a filter or a link to the view keeps. */
|
|
16
|
+
dimensionValue: string;
|
|
17
|
+
/** `null` when the row has no reading for an average, which is no data rather than zero. */
|
|
18
|
+
value: MetricValue;
|
|
10
19
|
/** Every metric the read asked for, present only when `extraMetrics` asked for more. */
|
|
11
|
-
metrics?:
|
|
20
|
+
metrics?: MetricValues;
|
|
12
21
|
}
|
|
13
|
-
interface WidgetBreakdownResult {
|
|
22
|
+
interface WidgetBreakdownResult extends Partial<ReadNotices>, SubstitutedSource {
|
|
14
23
|
status: WidgetReadStatus;
|
|
24
|
+
/** How long until a `busy` read can succeed, when the source or the plugin knows. */
|
|
25
|
+
retryAfterMs?: number;
|
|
15
26
|
adapterId: string;
|
|
27
|
+
/** The reporting timezone the read resolved in, which names its days. */
|
|
28
|
+
timezone?: string;
|
|
29
|
+
/**
|
|
30
|
+
* Scope a link to this read must name, set only when the viewer would not resolve it alone:
|
|
31
|
+
* a needless `scope` refuses every reader without `access.crossScope`.
|
|
32
|
+
*/
|
|
33
|
+
scope?: string;
|
|
16
34
|
dateRange: DateRange;
|
|
17
35
|
rows: BreakdownRow[];
|
|
18
36
|
/** The source that answered, absent on a read that never reached one. */
|
|
19
37
|
provider?: string;
|
|
20
|
-
|
|
21
|
-
/** True when the engine served a stale cache entry after a failed provider read. */
|
|
22
|
-
stale?: boolean;
|
|
23
|
-
/** True when the source answered without one of the filters the read carried. */
|
|
24
|
-
filtersUnapplied?: boolean;
|
|
25
|
-
/** True when the read hit the source's event scan cap, so the numbers are a floor. */
|
|
26
|
-
sampled?: boolean;
|
|
27
|
-
/** True when the source could not read the scope's goals; the rows say nothing about them. */
|
|
28
|
-
goalsUnresolved?: boolean;
|
|
29
|
-
/** True when the read asked about goals and the scope configures none: an empty table. */
|
|
38
|
+
/** True when the read asked about goals and the scope declared none: an empty table. */
|
|
30
39
|
noGoals?: boolean;
|
|
40
|
+
/** The scope's goals behind a `goal` read's slugs, so its rows read as names. */
|
|
41
|
+
goals?: Array<{
|
|
42
|
+
slug: string;
|
|
43
|
+
name: string;
|
|
44
|
+
}>;
|
|
31
45
|
}
|
|
32
|
-
|
|
46
|
+
/** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */
|
|
47
|
+
type ReadForWidgetBreakdownArgs = ReadPrincipal & StoredSourceRead & {
|
|
33
48
|
req: PayloadRequest;
|
|
34
49
|
metric: MetricKey;
|
|
35
50
|
dimension: DimensionKey;
|
|
@@ -38,8 +53,6 @@ interface ReadForWidgetBreakdownArgs {
|
|
|
38
53
|
adapterId?: string;
|
|
39
54
|
now: Date;
|
|
40
55
|
range?: DateRange;
|
|
41
|
-
/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
|
|
42
|
-
scope?: string | null;
|
|
43
56
|
/**
|
|
44
57
|
* Reporting timezone the caller already resolved, reused rather than resolved again so
|
|
45
58
|
* a caller-supplied `range` is read in the very timezone it was interpreted in.
|
|
@@ -47,22 +60,20 @@ interface ReadForWidgetBreakdownArgs {
|
|
|
47
60
|
timezone?: string;
|
|
48
61
|
filters?: AnalyticsFilter[];
|
|
49
62
|
/**
|
|
50
|
-
* Further metrics
|
|
51
|
-
*
|
|
52
|
-
* `metrics`; ranking and status still follow `metric` alone.
|
|
63
|
+
* Further metrics read beside the ranked one, narrowed to what the source serves so an
|
|
64
|
+
* unsupported one never fails the read. Ranking and status follow `metric` alone.
|
|
53
65
|
*/
|
|
54
66
|
extraMetrics?: MetricKey[];
|
|
55
67
|
/**
|
|
56
|
-
*
|
|
57
|
-
*
|
|
58
|
-
* resolved them (the goals table) does not resolve them twice.
|
|
68
|
+
* Scope's goal slugs for a `goal` or `conversions` read, or `'unresolved'` if the caller's
|
|
69
|
+
* resolver failed. Resolved here when omitted.
|
|
59
70
|
*/
|
|
60
|
-
goalSlugs?: string[] | 'unresolved';
|
|
61
|
-
|
|
71
|
+
goalSlugs?: string[] | 'unresolved'; /** The latent built-in slugs behind that hint; resolved here when omitted. */
|
|
72
|
+
builtinGoalSlugs?: string[];
|
|
73
|
+
};
|
|
62
74
|
/**
|
|
63
|
-
*
|
|
64
|
-
*
|
|
65
|
-
* `{ label, value }` pair the bar list renders. The adapter owns sorting and limiting.
|
|
75
|
+
* Ranked breakdown of one metric by one dimension: `readForWidget` gated on the dimension too,
|
|
76
|
+
* each row labelled as built-in widgets label it. The adapter owns sorting and limiting.
|
|
66
77
|
*/
|
|
67
78
|
declare const readForWidgetBreakdown: (args: ReadForWidgetBreakdownArgs) => Promise<WidgetBreakdownResult>;
|
|
68
79
|
//#endregion
|
|
@@ -1,21 +1,29 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { readPrincipalOf } from "../access/principal.js";
|
|
2
|
+
import { metricReaches } from "../core/capabilities.js";
|
|
3
|
+
import { readFailureOf } from "../surfacing/classifyError.js";
|
|
4
|
+
import { asTranslate } from "../translations/server.js";
|
|
5
|
+
import { emptyReading } from "../core/metricValues.js";
|
|
6
|
+
import { intlLocale } from "../translations/intl.js";
|
|
7
|
+
import { engineRead, pinnedScope, prepareWidgetRead, substitutionOf } from "./prepareWidgetRead.js";
|
|
2
8
|
import { readMeta } from "./readMeta.js";
|
|
9
|
+
import { resolveItemLabels } from "../plugin/itemLabels.js";
|
|
10
|
+
import { hasNoDeclaredGoals, isLatentGoalRow } from "../goals/latent.js";
|
|
11
|
+
import { valueLabel } from "../view/labels.js";
|
|
3
12
|
//#region src/widgets/readForWidgetBreakdown.ts
|
|
4
13
|
/**
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
* `{ label, value }` pair the bar list renders. The adapter owns sorting and limiting.
|
|
14
|
+
* Ranked breakdown of one metric by one dimension: `readForWidget` gated on the dimension too,
|
|
15
|
+
* each row labelled as built-in widgets label it. The adapter owns sorting and limiting.
|
|
8
16
|
*/
|
|
9
17
|
const readForWidgetBreakdown = async (args) => {
|
|
10
18
|
const { req, metric, dimension, timeframe, limit, adapterId, now, range, filters } = args;
|
|
11
|
-
const
|
|
12
|
-
const metricsFor = (adapter) => [metric, ...(args.extraMetrics ?? []).filter((m) => m !== metric && adapter.capabilities.metrics.has(m))];
|
|
19
|
+
const metricsFor = (adapter) => [metric, ...(args.extraMetrics ?? []).filter((m) => m !== metric && adapter.capabilities.metrics.has(m) && metricReaches(adapter.capabilities, m, { dimensions: [dimension] }))];
|
|
13
20
|
const prepared = await prepareWidgetRead({
|
|
14
21
|
req,
|
|
15
22
|
now,
|
|
16
23
|
timeframe,
|
|
17
24
|
adapterId,
|
|
18
|
-
|
|
25
|
+
...readPrincipalOf(args),
|
|
26
|
+
...args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {},
|
|
19
27
|
timezone: args.timezone,
|
|
20
28
|
range,
|
|
21
29
|
filters,
|
|
@@ -27,23 +35,21 @@ const readForWidgetBreakdown = async (args) => {
|
|
|
27
35
|
metrics: metricsFor(adapter),
|
|
28
36
|
dimensions: [dimension]
|
|
29
37
|
}),
|
|
30
|
-
goalSlugs: args.goalSlugs
|
|
38
|
+
goalSlugs: args.goalSlugs,
|
|
39
|
+
...args.builtinGoalSlugs === void 0 ? {} : { builtinGoalSlugs: args.builtinGoalSlugs }
|
|
31
40
|
});
|
|
32
41
|
if (!prepared.ok) return {
|
|
33
42
|
status: prepared.status,
|
|
34
43
|
adapterId: prepared.adapterId,
|
|
35
44
|
dateRange: prepared.dateRange,
|
|
36
|
-
rows:
|
|
37
|
-
};
|
|
38
|
-
const { runtime, adapter, tz, dateRange, goalSlugs } = prepared;
|
|
39
|
-
const base = {
|
|
40
|
-
dateRange,
|
|
41
|
-
rows: emptyRows
|
|
45
|
+
rows: []
|
|
42
46
|
};
|
|
47
|
+
const { adapter, tz, dateRange, goalSlugs, builtinGoalSlugs, goalNames } = prepared;
|
|
43
48
|
const metrics = metricsFor(adapter);
|
|
49
|
+
const read = engineRead(prepared, timeframe);
|
|
44
50
|
let result;
|
|
45
51
|
try {
|
|
46
|
-
result = await
|
|
52
|
+
result = await read({
|
|
47
53
|
metrics,
|
|
48
54
|
dimensions: [dimension],
|
|
49
55
|
dateRange,
|
|
@@ -57,25 +63,45 @@ const readForWidgetBreakdown = async (args) => {
|
|
|
57
63
|
scope: prepared.queryScope,
|
|
58
64
|
...goalSlugs === void 0 ? {} : { goalSlugs }
|
|
59
65
|
});
|
|
60
|
-
} catch {
|
|
66
|
+
} catch (err) {
|
|
61
67
|
return {
|
|
62
|
-
|
|
68
|
+
...readFailureOf(err),
|
|
63
69
|
adapterId: adapter.id,
|
|
64
|
-
|
|
70
|
+
dateRange,
|
|
71
|
+
rows: []
|
|
65
72
|
};
|
|
66
73
|
}
|
|
67
|
-
const
|
|
68
|
-
|
|
69
|
-
value: row.metrics[metric] ??
|
|
74
|
+
const kept = result.rows.map((row) => ({
|
|
75
|
+
dimensionValue: row.dimensions?.[dimension] ?? "",
|
|
76
|
+
value: row.metrics[metric] ?? emptyReading(metric),
|
|
70
77
|
...metrics.length > 1 ? { metrics: row.metrics } : {}
|
|
78
|
+
})).filter((row) => dimension !== "goal" || !isLatentGoalRow(row.dimensionValue, metric === "conversions" ? row.value : row.metrics?.conversions, builtinGoalSlugs));
|
|
79
|
+
const itemLabels = dimension === "item" ? await resolveItemLabels(req, kept.map((row) => row.dimensionValue)).catch(() => void 0) : void 0;
|
|
80
|
+
const translate = req.i18n?.t;
|
|
81
|
+
const locale = intlLocale(req.i18n?.language);
|
|
82
|
+
const rows = kept.map((row) => ({
|
|
83
|
+
label: translate === void 0 ? row.dimensionValue : valueLabel({
|
|
84
|
+
dimension,
|
|
85
|
+
value: row.dimensionValue,
|
|
86
|
+
provider: result.meta.provider,
|
|
87
|
+
t: asTranslate(translate),
|
|
88
|
+
locale,
|
|
89
|
+
goals: goalNames,
|
|
90
|
+
...itemLabels ? { itemLabels } : {}
|
|
91
|
+
}),
|
|
92
|
+
...row
|
|
71
93
|
}));
|
|
72
94
|
return {
|
|
73
95
|
status: "ok",
|
|
74
96
|
adapterId: adapter.id,
|
|
97
|
+
...substitutionOf(prepared),
|
|
98
|
+
...pinnedScope(args, prepared.queryScope),
|
|
75
99
|
dateRange,
|
|
100
|
+
timezone: tz,
|
|
76
101
|
rows,
|
|
77
102
|
...readMeta(result),
|
|
78
|
-
noGoals: Array.isArray(goalSlugs) && goalSlugs
|
|
103
|
+
noGoals: Array.isArray(goalSlugs) && hasNoDeclaredGoals(goalSlugs, builtinGoalSlugs),
|
|
104
|
+
...dimension === "goal" && goalNames.length > 0 ? { goals: goalNames } : {}
|
|
79
105
|
};
|
|
80
106
|
};
|
|
81
107
|
//#endregion
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"readForWidgetBreakdown.js","names":[],"sources":["../../src/widgets/readForWidgetBreakdown.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type {\n\tAnalyticsAdapter,\n\tAnalyticsFilter,\n\tAnalyticsResult,\n\tDateRange,\n\tDimensionKey,\n\tMetricKey,\n} from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { prepareWidgetRead, type WidgetReadStatus } from './prepareWidgetRead'\nimport { readMeta } from './readMeta'\n\nexport interface BreakdownRow {\n\tlabel: string\n\tvalue: number\n\t/** Every metric the read asked for, present only when `extraMetrics` asked for more. */\n\tmetrics?: Partial<Record<MetricKey, number>>\n}\n\nexport interface WidgetBreakdownResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\trows: BreakdownRow[]\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\tclamped?: boolean\n\t/** True when the engine served a stale cache entry after a failed provider read. */\n\tstale?: boolean\n\t/** True when the source answered without one of the filters the read carried. */\n\tfiltersUnapplied?: boolean\n\t/** True when the read hit the source's event scan cap, so the numbers are a floor. */\n\tsampled?: boolean\n\t/** True when the source could not read the scope's goals; the rows say nothing about them. */\n\tgoalsUnresolved?: boolean\n\t/** True when the read asked about goals and the scope configures none: an empty table. */\n\tnoGoals?: boolean\n}\n\nexport interface ReadForWidgetBreakdownArgs {\n\treq: PayloadRequest\n\tmetric: MetricKey\n\tdimension: DimensionKey\n\ttimeframe: TimeframePreset\n\tlimit: number\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\tfilters?: AnalyticsFilter[]\n\t/**\n\t * Further metrics to read alongside the ranked one, narrowed to what the source serves\n\t * so an unsupported one never turns the whole read unavailable. They reach each row's\n\t * `metrics`; ranking and status still follow `metric` alone.\n\t */\n\textraMetrics?: MetricKey[]\n\t/**\n\t * The scope's goal slugs, for a `goal` or `conversions` read, or `'unresolved'` when the\n\t * caller's own resolver failed. Resolved here when omitted, so a caller that already\n\t * resolved them (the goals table) does not resolve them twice.\n\t */\n\tgoalSlugs?: string[] | 'unresolved'\n}\n\n/**\n * Site-wide ranked breakdown of one metric by one dimension, read through the engine.\n * Mirrors `readForWidget` but gates on the dimension too and maps each result row to a\n * `{ label, value }` pair the bar list renders. The adapter owns sorting and limiting.\n */\nexport const readForWidgetBreakdown = async (\n\targs: ReadForWidgetBreakdownArgs\n): Promise<WidgetBreakdownResult> => {\n\tconst { req, metric, dimension, timeframe, limit, adapterId, now, range, filters } = args\n\tconst emptyRows = [] as BreakdownRow[]\n\n\tconst metricsFor = (adapter: AnalyticsAdapter): MetricKey[] => [\n\t\tmetric,\n\t\t...(args.extraMetrics ?? []).filter((m) => m !== metric && adapter.capabilities.metrics.has(m)),\n\t]\n\tconst prepared = await prepareWidgetRead({\n\t\treq,\n\t\tnow,\n\t\ttimeframe,\n\t\tadapterId,\n\t\tscope: args.scope,\n\t\ttimezone: args.timezone,\n\t\trange,\n\t\tfilters,\n\t\trequires: { metrics: [metric], dimensions: [dimension] },\n\t\tgoalRead: (adapter) => ({ metrics: metricsFor(adapter), dimensions: [dimension] }),\n\t\tgoalSlugs: args.goalSlugs,\n\t})\n\tif (!prepared.ok) {\n\t\treturn {\n\t\t\tstatus: prepared.status,\n\t\t\tadapterId: prepared.adapterId,\n\t\t\tdateRange: prepared.dateRange,\n\t\t\trows: emptyRows,\n\t\t}\n\t}\n\tconst { runtime, adapter, tz, dateRange, goalSlugs } = prepared\n\tconst base = { dateRange, rows: emptyRows }\n\tconst metrics = metricsFor(adapter)\n\tlet result: AnalyticsResult\n\ttry {\n\t\tresult = await runtime.engine.read(adapter, {\n\t\t\tmetrics,\n\t\t\tdimensions: [dimension],\n\t\t\tdateRange,\n\t\t\tlimit,\n\t\t\torder: { metric, direction: 'desc' },\n\t\t\tfilters,\n\t\t\ttimezone: tz,\n\t\t\tscope: prepared.queryScope,\n\t\t\t...(goalSlugs === undefined ? {} : { goalSlugs }),\n\t\t})\n\t} catch {\n\t\t// No cache entry (fresh or stale) survived the failed read; degrade like an\n\t\t// unsupported capability instead of throwing through the widget render tree.\n\t\treturn { status: 'unavailable', adapterId: adapter.id, ...base }\n\t}\n\tconst rows = result.rows.map((row) => ({\n\t\tlabel: row.dimensions?.[dimension] ?? '(none)',\n\t\tvalue: row.metrics[metric] ?? 0,\n\t\t...(metrics.length > 1 ? { metrics: row.metrics } : {}),\n\t}))\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\trows,\n\t\t...readMeta(result),\n\t\t// The hint is set only for a read about goals, so an empty one is a scope that\n\t\t// configured none rather than a read that never asked.\n\t\tnoGoals: Array.isArray(goalSlugs) && goalSlugs.length === 0,\n\t}\n}\n"],"mappings":";;;;;;;;AA4EA,MAAa,yBAAyB,OACrC,SACoC;CACpC,MAAM,EAAE,KAAK,QAAQ,WAAW,WAAW,OAAO,WAAW,KAAK,OAAO,YAAY;CACrF,MAAM,YAAY,CAAC;CAEnB,MAAM,cAAc,YAA2C,CAC9D,QACA,IAAI,KAAK,gBAAgB,CAAC,GAAG,QAAQ,MAAM,MAAM,UAAU,QAAQ,aAAa,QAAQ,IAAI,CAAC,CAAC,CAC/F;CACA,MAAM,WAAW,MAAM,kBAAkB;EACxC;EACA;EACA;EACA;EACA,OAAO,KAAK;EACZ,UAAU,KAAK;EACf;EACA;EACA,UAAU;GAAE,SAAS,CAAC,MAAM;GAAG,YAAY,CAAC,SAAS;EAAE;EACvD,WAAW,aAAa;GAAE,SAAS,WAAW,OAAO;GAAG,YAAY,CAAC,SAAS;EAAE;EAChF,WAAW,KAAK;CACjB,CAAC;CACD,IAAI,CAAC,SAAS,IACb,OAAO;EACN,QAAQ,SAAS;EACjB,WAAW,SAAS;EACpB,WAAW,SAAS;EACpB,MAAM;CACP;CAED,MAAM,EAAE,SAAS,SAAS,IAAI,WAAW,cAAc;CACvD,MAAM,OAAO;EAAE;EAAW,MAAM;CAAU;CAC1C,MAAM,UAAU,WAAW,OAAO;CAClC,IAAI;CACJ,IAAI;EACH,SAAS,MAAM,QAAQ,OAAO,KAAK,SAAS;GAC3C;GACA,YAAY,CAAC,SAAS;GACtB;GACA;GACA,OAAO;IAAE;IAAQ,WAAW;GAAO;GACnC;GACA,UAAU;GACV,OAAO,SAAS;GAChB,GAAI,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU;EAChD,CAAC;CACF,QAAQ;EAGP,OAAO;GAAE,QAAQ;GAAe,WAAW,QAAQ;GAAI,GAAG;EAAK;CAChE;CACA,MAAM,OAAO,OAAO,KAAK,KAAK,SAAS;EACtC,OAAO,IAAI,aAAa,cAAc;EACtC,OAAO,IAAI,QAAQ,WAAW;EAC9B,GAAI,QAAQ,SAAS,IAAI,EAAE,SAAS,IAAI,QAAQ,IAAI,CAAC;CACtD,EAAE;CACF,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB;EACA;EACA,GAAG,SAAS,MAAM;EAGlB,SAAS,MAAM,QAAQ,SAAS,KAAK,UAAU,WAAW;CAC3D;AACD"}
|
|
1
|
+
{"version":3,"file":"readForWidgetBreakdown.js","names":[],"sources":["../../src/widgets/readForWidgetBreakdown.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type ReadPrincipal, readPrincipalOf } from '../access/principal'\nimport { metricReaches } from '../core/capabilities'\nimport type {\n\tAnalyticsAdapter,\n\tAnalyticsFilter,\n\tAnalyticsResult,\n\tDateRange,\n\tDimensionKey,\n\tMetricKey,\n\tMetricValue,\n\tMetricValues,\n} from '../core/contract'\nimport { emptyReading } from '../core/metricValues'\nimport { hasNoDeclaredGoals, isLatentGoalRow } from '../goals/latent'\nimport { resolveItemLabels } from '../plugin/itemLabels'\nimport { readFailureOf } from '../surfacing/classifyError'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { intlLocale } from '../translations/intl'\nimport { asTranslate } from '../translations/server'\nimport { valueLabel } from '../view/labels'\nimport {\n\tengineRead,\n\tpinnedScope,\n\tprepareWidgetRead,\n\ttype StoredSourceRead,\n\ttype SubstitutedSource,\n\tsubstitutionOf,\n\ttype WidgetReadStatus,\n} from './prepareWidgetRead'\nimport { type ReadNotices, readMeta } from './readMeta'\n\nexport interface BreakdownRow {\n\t/**\n\t * What the reader sees, in the admin language as every built-in surface labels the row:\n\t * a goal's name, a country's, an item's title, `Not set` for a row with no value.\n\t */\n\tlabel: string\n\t/** The stored value, `''` for a row with no value: what a filter or a link to the view keeps. */\n\tdimensionValue: string\n\t/** `null` when the row has no reading for an average, which is no data rather than zero. */\n\tvalue: MetricValue\n\t/** Every metric the read asked for, present only when `extraMetrics` asked for more. */\n\tmetrics?: MetricValues\n}\n\nexport interface WidgetBreakdownResult 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/** The reporting timezone the read resolved in, which names its days. */\n\ttimezone?: 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\trows: BreakdownRow[]\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\t/** True when the read asked about goals and the scope declared none: an empty table. */\n\tnoGoals?: boolean\n\t/** The scope's goals behind a `goal` read's slugs, so its rows read as names. */\n\tgoals?: Array<{ slug: string; name: string }>\n}\n\n/** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */\nexport type ReadForWidgetBreakdownArgs = ReadPrincipal &\n\tStoredSourceRead & {\n\t\treq: PayloadRequest\n\t\tmetric: MetricKey\n\t\tdimension: DimensionKey\n\t\ttimeframe: TimeframePreset\n\t\tlimit: number\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\tfilters?: AnalyticsFilter[]\n\t\t/**\n\t\t * Further metrics read beside the ranked one, narrowed to what the source serves so an\n\t\t * unsupported one never fails the read. Ranking and status follow `metric` alone.\n\t\t */\n\t\textraMetrics?: MetricKey[]\n\t\t/**\n\t\t * Scope's goal slugs for a `goal` or `conversions` read, or `'unresolved'` if the caller's\n\t\t * resolver failed. Resolved here when omitted.\n\t\t */\n\t\tgoalSlugs?: string[] | 'unresolved'\n\t\t/** The latent built-in slugs behind that hint; resolved here when omitted. */\n\t\tbuiltinGoalSlugs?: string[]\n\t}\n\n/**\n * Ranked breakdown of one metric by one dimension: `readForWidget` gated on the dimension too,\n * each row labelled as built-in widgets label it. The adapter owns sorting and limiting.\n */\nexport const readForWidgetBreakdown = async (\n\targs: ReadForWidgetBreakdownArgs\n): Promise<WidgetBreakdownResult> => {\n\tconst { req, metric, dimension, timeframe, limit, adapterId, now, range, filters } = args\n\tconst metricsFor = (adapter: AnalyticsAdapter): MetricKey[] => [\n\t\tmetric,\n\t\t...(args.extraMetrics ?? []).filter(\n\t\t\t(m) =>\n\t\t\t\tm !== metric &&\n\t\t\t\tadapter.capabilities.metrics.has(m) &&\n\t\t\t\tmetricReaches(adapter.capabilities, m, { dimensions: [dimension] })\n\t\t),\n\t]\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,\n\t\tfilters,\n\t\trequires: { metrics: [metric], dimensions: [dimension] },\n\t\tgoalRead: (adapter) => ({ metrics: metricsFor(adapter), dimensions: [dimension] }),\n\t\tgoalSlugs: args.goalSlugs,\n\t\t...(args.builtinGoalSlugs === undefined ? {} : { builtinGoalSlugs: args.builtinGoalSlugs }),\n\t})\n\tif (!prepared.ok) {\n\t\treturn {\n\t\t\tstatus: prepared.status,\n\t\t\tadapterId: prepared.adapterId,\n\t\t\tdateRange: prepared.dateRange,\n\t\t\trows: [],\n\t\t}\n\t}\n\tconst { adapter, tz, dateRange, goalSlugs, builtinGoalSlugs, goalNames } = prepared\n\tconst metrics = metricsFor(adapter)\n\tconst read = engineRead(prepared, timeframe)\n\tlet result: AnalyticsResult\n\ttry {\n\t\tresult = await read({\n\t\t\tmetrics,\n\t\t\tdimensions: [dimension],\n\t\t\tdateRange,\n\t\t\tlimit,\n\t\t\torder: { metric, direction: 'desc' },\n\t\t\tfilters,\n\t\t\ttimezone: tz,\n\t\t\tscope: prepared.queryScope,\n\t\t\t...(goalSlugs === undefined ? {} : { goalSlugs }),\n\t\t})\n\t} catch (err) {\n\t\t// A failed read is a status, never a throw through the render tree.\n\t\treturn { ...readFailureOf(err), adapterId: adapter.id, dateRange, rows: [] }\n\t}\n\tconst kept = result.rows\n\t\t.map((row) => ({\n\t\t\tdimensionValue: row.dimensions?.[dimension] ?? '',\n\t\t\tvalue: row.metrics[metric] ?? emptyReading(metric),\n\t\t\t...(metrics.length > 1 ? { metrics: row.metrics } : {}),\n\t\t}))\n\t\t// A built-in goal is latent: it earns a row once someone has converted on it, and until\n\t\t// then a site that sells nothing would read a \"Purchase\" row at zero in every report.\n\t\t.filter(\n\t\t\t(row) =>\n\t\t\t\tdimension !== 'goal' ||\n\t\t\t\t!isLatentGoalRow(\n\t\t\t\t\trow.dimensionValue,\n\t\t\t\t\tmetric === 'conversions' ? row.value : row.metrics?.conversions,\n\t\t\t\t\tbuiltinGoalSlugs\n\t\t\t\t)\n\t\t)\n\tconst itemLabels =\n\t\tdimension === 'item'\n\t\t\t? await resolveItemLabels(\n\t\t\t\t\treq,\n\t\t\t\t\tkept.map((row) => row.dimensionValue)\n\t\t\t\t).catch((): undefined => undefined)\n\t\t\t: undefined\n\t// A request built without Payload's i18n (a bare Local API caller) has no words to label with.\n\tconst translate = req.i18n?.t\n\tconst locale = intlLocale(req.i18n?.language)\n\tconst rows: BreakdownRow[] = kept.map((row) => ({\n\t\tlabel:\n\t\t\ttranslate === undefined\n\t\t\t\t? row.dimensionValue\n\t\t\t\t: valueLabel({\n\t\t\t\t\t\tdimension,\n\t\t\t\t\t\tvalue: row.dimensionValue,\n\t\t\t\t\t\tprovider: result.meta.provider,\n\t\t\t\t\t\tt: asTranslate(translate),\n\t\t\t\t\t\tlocale,\n\t\t\t\t\t\tgoals: goalNames,\n\t\t\t\t\t\t...(itemLabels ? { itemLabels } : {}),\n\t\t\t\t\t}),\n\t\t...row,\n\t}))\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\t...substitutionOf(prepared),\n\t\t...pinnedScope(args, prepared.queryScope),\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\trows,\n\t\t...readMeta(result),\n\t\t// The hint is set only for a read about goals, so one carrying nothing the install\n\t\t// declared is a scope that configured none rather than a read that never asked.\n\t\tnoGoals: Array.isArray(goalSlugs) && hasNoDeclaredGoals(goalSlugs, builtinGoalSlugs),\n\t\t...(dimension === 'goal' && goalNames.length > 0 ? { goals: goalNames } : {}),\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuGA,MAAa,yBAAyB,OACrC,SACoC;CACpC,MAAM,EAAE,KAAK,QAAQ,WAAW,WAAW,OAAO,WAAW,KAAK,OAAO,YAAY;CACrF,MAAM,cAAc,YAA2C,CAC9D,QACA,IAAI,KAAK,gBAAgB,CAAC,GAAG,QAC3B,MACA,MAAM,UACN,QAAQ,aAAa,QAAQ,IAAI,CAAC,KAClC,cAAc,QAAQ,cAAc,GAAG,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CACpE,CACD;CACA,MAAM,WAAW,MAAM,kBAAkB;EACxC;EACA;EACA;EACA;EACA,GAAG,gBAAgB,IAAI;EACvB,GAAI,KAAK,yBAAyB,EAAE,wBAAwB,KAAK,IAAI,CAAC;EACtE,UAAU,KAAK;EACf;EACA;EACA,UAAU;GAAE,SAAS,CAAC,MAAM;GAAG,YAAY,CAAC,SAAS;EAAE;EACvD,WAAW,aAAa;GAAE,SAAS,WAAW,OAAO;GAAG,YAAY,CAAC,SAAS;EAAE;EAChF,WAAW,KAAK;EAChB,GAAI,KAAK,qBAAqB,KAAA,IAAY,CAAC,IAAI,EAAE,kBAAkB,KAAK,iBAAiB;CAC1F,CAAC;CACD,IAAI,CAAC,SAAS,IACb,OAAO;EACN,QAAQ,SAAS;EACjB,WAAW,SAAS;EACpB,WAAW,SAAS;EACpB,MAAM,CAAC;CACR;CAED,MAAM,EAAE,SAAS,IAAI,WAAW,WAAW,kBAAkB,cAAc;CAC3E,MAAM,UAAU,WAAW,OAAO;CAClC,MAAM,OAAO,WAAW,UAAU,SAAS;CAC3C,IAAI;CACJ,IAAI;EACH,SAAS,MAAM,KAAK;GACnB;GACA,YAAY,CAAC,SAAS;GACtB;GACA;GACA,OAAO;IAAE;IAAQ,WAAW;GAAO;GACnC;GACA,UAAU;GACV,OAAO,SAAS;GAChB,GAAI,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU;EAChD,CAAC;CACF,SAAS,KAAK;EAEb,OAAO;GAAE,GAAG,cAAc,GAAG;GAAG,WAAW,QAAQ;GAAI;GAAW,MAAM,CAAC;EAAE;CAC5E;CACA,MAAM,OAAO,OAAO,KAClB,KAAK,SAAS;EACd,gBAAgB,IAAI,aAAa,cAAc;EAC/C,OAAO,IAAI,QAAQ,WAAW,aAAa,MAAM;EACjD,GAAI,QAAQ,SAAS,IAAI,EAAE,SAAS,IAAI,QAAQ,IAAI,CAAC;CACtD,EAAE,EAGD,QACC,QACA,cAAc,UACd,CAAC,gBACA,IAAI,gBACJ,WAAW,gBAAgB,IAAI,QAAQ,IAAI,SAAS,aACpD,gBACD,CACF;CACD,MAAM,aACL,cAAc,SACX,MAAM,kBACN,KACA,KAAK,KAAK,QAAQ,IAAI,cAAc,CACrC,EAAE,YAAuB,KAAA,CAAS,IACjC,KAAA;CAEJ,MAAM,YAAY,IAAI,MAAM;CAC5B,MAAM,SAAS,WAAW,IAAI,MAAM,QAAQ;CAC5C,MAAM,OAAuB,KAAK,KAAK,SAAS;EAC/C,OACC,cAAc,KAAA,IACX,IAAI,iBACJ,WAAW;GACX;GACA,OAAO,IAAI;GACX,UAAU,OAAO,KAAK;GACtB,GAAG,YAAY,SAAS;GACxB;GACA,OAAO;GACP,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;EACpC,CAAC;EACJ,GAAG;CACJ,EAAE;CACF,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB,GAAG,eAAe,QAAQ;EAC1B,GAAG,YAAY,MAAM,SAAS,UAAU;EACxC;EACA,UAAU;EACV;EACA,GAAG,SAAS,MAAM;EAGlB,SAAS,MAAM,QAAQ,SAAS,KAAK,mBAAmB,WAAW,gBAAgB;EACnF,GAAI,cAAc,UAAU,UAAU,SAAS,IAAI,EAAE,OAAO,UAAU,IAAI,CAAC;CAC5E;AACD"}
|