@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
|
@@ -1,46 +1,101 @@
|
|
|
1
|
+
import { isRecord } from "../../core/values.js";
|
|
1
2
|
import { clientIpFromHeaders } from "./clientIp.js";
|
|
3
|
+
import { DEFAULT_BROWSER_AMOUNTS, completionAmounts } from "../../goals/match.js";
|
|
4
|
+
import { MAX_SINCE_MS } from "../../goals/constants.js";
|
|
5
|
+
import { boundedValue, dedupeKeyFor, isRefund, reconcileMoney, sanitizeOrderId } from "./revenue.js";
|
|
6
|
+
import { extractUtm } from "./utm.js";
|
|
7
|
+
import { clickIdOf } from "./source.js";
|
|
8
|
+
import { isSiteReferral, referrerHost, storedReferrer } from "./referrer.js";
|
|
2
9
|
import { classifyDevice } from "./device.js";
|
|
3
|
-
import {
|
|
10
|
+
import { sanitizeItems } from "../../goals/items.js";
|
|
11
|
+
import { boundItemRef } from "../../items/ref.js";
|
|
12
|
+
import { resolveGeo } from "../geo/resolveGeo.js";
|
|
4
13
|
import { classifyBrowser, classifyOs } from "./browser.js";
|
|
14
|
+
import { verifiedItemRef } from "./itemSignature.js";
|
|
5
15
|
import { primaryLanguage } from "./language.js";
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import { extractUtm } from "./utm.js";
|
|
9
|
-
import { dailyVisitorHash, deriveSessionId } from "./visitorHash.js";
|
|
16
|
+
import { boundedSinceMs, isNavigation } from "./validate.js";
|
|
17
|
+
import { dailyVisitorId } from "./visitorHash.js";
|
|
10
18
|
//#region src/native/ingest/normalizeEvent.ts
|
|
11
19
|
const MAX_PROPS = 20;
|
|
12
20
|
const MAX_KEY_LENGTH = 64;
|
|
13
21
|
const MAX_VALUE_LENGTH = 256;
|
|
14
22
|
const MAX_NAME_LENGTH = 128;
|
|
15
23
|
const MAX_PATH_LENGTH = 512;
|
|
16
|
-
/** Longest legal DNS name. */
|
|
17
|
-
const MAX_HOSTNAME_LENGTH = 253;
|
|
18
|
-
/** 24 hours. A longer duration is a broken clock, not a session. */
|
|
19
|
-
const MAX_DURATION_MS = 864e5;
|
|
20
24
|
const CURRENCY = /^[A-Z]{3}$/;
|
|
21
25
|
/**
|
|
22
|
-
*
|
|
23
|
-
*
|
|
24
|
-
|
|
25
|
-
|
|
26
|
+
* When an event happened: its arrival less its `ageMs`, and an engagement's `sinceMs` too, so it is
|
|
27
|
+
* filed at its pageview's start. Each is believed from 0 to a day, and together reach back a day.
|
|
28
|
+
*/
|
|
29
|
+
const eventTime = (raw, receivedAt) => {
|
|
30
|
+
const waited = boundedSinceMs(raw.ageMs) ?? 0;
|
|
31
|
+
const since = raw.type === "engagement" ? boundedSinceMs(raw.sinceMs) ?? 0 : 0;
|
|
32
|
+
const back = Math.min(MAX_SINCE_MS, waited + since);
|
|
33
|
+
return back === 0 ? receivedAt : new Date(receivedAt.getTime() - back);
|
|
34
|
+
};
|
|
35
|
+
/**
|
|
36
|
+
* Whether an event comes with a visitor of its own: an address, or a user agent other than the
|
|
37
|
+
* one server tracking stamps when it has none. A beacon always does; server code may not.
|
|
26
38
|
*/
|
|
27
|
-
const
|
|
39
|
+
const identifiesVisitor = (ip, ua) => ip !== "" || ua !== "" && ua !== "analytics-server";
|
|
40
|
+
/**
|
|
41
|
+
* Optional wire fields are sanitized rather than rejected, so one malformed attribute never costs
|
|
42
|
+
* a pageview.
|
|
43
|
+
*/
|
|
44
|
+
const nonNegative = (value) => {
|
|
45
|
+
const bounded = boundedValue(value);
|
|
46
|
+
return bounded !== void 0 && bounded >= 0 ? bounded : void 0;
|
|
47
|
+
};
|
|
48
|
+
/** A refund is the one negative amount ingest keeps, and only on a server `refund` call. */
|
|
49
|
+
const signed = (value) => boundedValue(value);
|
|
28
50
|
const currencyCode = (value) => typeof value === "string" && CURRENCY.test(value) ? value : void 0;
|
|
29
51
|
/**
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
|
|
52
|
+
* The event's amount as far as it is believed: as sent under `trust` and `fixed` (where a goal's
|
|
53
|
+
* fixed value still wins for its own completion), nothing under `none`.
|
|
54
|
+
*/
|
|
55
|
+
const sentAmount = (args) => args.believed === "none" ? {} : {
|
|
56
|
+
...args.value === void 0 ? {} : { value: args.value },
|
|
57
|
+
...args.currency === void 0 ? {} : { currency: args.currency }
|
|
58
|
+
};
|
|
59
|
+
/**
|
|
60
|
+
* Each completion reconciled on its own (a fixed value in its goal's currency, else the event's),
|
|
61
|
+
* one conversion per distinct amount however many goals share it.
|
|
62
|
+
*/
|
|
63
|
+
const countCompletions = async (amounts, args) => {
|
|
64
|
+
const counted = [];
|
|
65
|
+
for (const { goal, source, amount } of amounts) {
|
|
66
|
+
if (source === "none") {
|
|
67
|
+
counted.push({ completion: {
|
|
68
|
+
slug: goal.slug,
|
|
69
|
+
value: 0
|
|
70
|
+
} });
|
|
71
|
+
continue;
|
|
72
|
+
}
|
|
73
|
+
const currency = source === "fixed" ? currencyCode(goal.currency) : args.eventCurrency;
|
|
74
|
+
const money = await args.reconcile(amount, currency);
|
|
75
|
+
counted.push({
|
|
76
|
+
completion: {
|
|
77
|
+
slug: goal.slug,
|
|
78
|
+
value: money.value ?? 0,
|
|
79
|
+
...money.originalValue === void 0 ? {} : { sent: money.originalValue }
|
|
80
|
+
},
|
|
81
|
+
money
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
return counted;
|
|
85
|
+
};
|
|
86
|
+
/**
|
|
87
|
+
* Infinity would poison every average for good, and a string would throw out of the write and take
|
|
88
|
+
* the buffered batch with it.
|
|
33
89
|
*/
|
|
34
90
|
const duration = (value) => {
|
|
35
91
|
const n = nonNegative(value);
|
|
36
|
-
return n === void 0 || n >
|
|
92
|
+
return n === void 0 || n > 18e5 ? void 0 : n;
|
|
37
93
|
};
|
|
38
|
-
/** The event name is a
|
|
94
|
+
/** The event name is a value the `event` dimension groups by, so it is length-capped. */
|
|
39
95
|
const eventName = (value) => typeof value === "string" ? value.slice(0, MAX_NAME_LENGTH) : void 0;
|
|
40
96
|
/**
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
-
* trusted. An empty value stays absent: '' would be a bucket of its own.
|
|
97
|
+
* Capped, not trusted: the resolver reads headers a client can set. An empty value stays absent,
|
|
98
|
+
* since '' would be a value of its own.
|
|
44
99
|
*/
|
|
45
100
|
const geoValue = (value) => value ? value.slice(0, 128) : void 0;
|
|
46
101
|
/** Capped before it is parsed, so a hostile query cannot make ingest do unbounded work. */
|
|
@@ -49,13 +104,16 @@ const depth = (value) => {
|
|
|
49
104
|
const n = nonNegative(value);
|
|
50
105
|
return n === void 0 ? void 0 : Math.round(Math.min(n, 100));
|
|
51
106
|
};
|
|
52
|
-
/**
|
|
53
|
-
|
|
54
|
-
|
|
107
|
+
/**
|
|
108
|
+
* Flat JSON scalars only, first 20 short-keyed entries. An order's event drops an `orderId` prop:
|
|
109
|
+
* an order is kept as its digest alone.
|
|
110
|
+
*/
|
|
111
|
+
const sanitizeProps = (raw, order) => {
|
|
112
|
+
if (!isRecord(raw) || Array.isArray(raw)) return;
|
|
55
113
|
const out = {};
|
|
56
114
|
let kept = 0;
|
|
57
115
|
for (const [key, value] of Object.entries(raw)) {
|
|
58
|
-
if (kept >= MAX_PROPS || key.length > MAX_KEY_LENGTH) continue;
|
|
116
|
+
if (kept >= MAX_PROPS || key.length > MAX_KEY_LENGTH || order && key === "orderId") continue;
|
|
59
117
|
if (typeof value === "string") out[key] = value.slice(0, MAX_VALUE_LENGTH);
|
|
60
118
|
else if (typeof value === "boolean" || typeof value === "number" && Number.isFinite(value)) out[key] = value;
|
|
61
119
|
else continue;
|
|
@@ -63,38 +121,140 @@ const sanitizeProps = (raw) => {
|
|
|
63
121
|
}
|
|
64
122
|
return kept > 0 ? out : void 0;
|
|
65
123
|
};
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
124
|
+
/**
|
|
125
|
+
* An engagement adds only time, scroll and items seen; time and scroll count from a pageview or an
|
|
126
|
+
* engagement alone, and only an event or a goal belongs to an item.
|
|
127
|
+
*/
|
|
128
|
+
const fieldsOfType = (raw) => {
|
|
129
|
+
if (raw.type === "engagement") {
|
|
130
|
+
const { type, path, hostname, referrer, query, durationMs, scrollDepth, impressions } = raw;
|
|
131
|
+
return {
|
|
132
|
+
type,
|
|
133
|
+
path,
|
|
134
|
+
hostname,
|
|
135
|
+
referrer,
|
|
136
|
+
query,
|
|
137
|
+
durationMs,
|
|
138
|
+
scrollDepth,
|
|
139
|
+
impressions
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
if (raw.type === "pageview") {
|
|
143
|
+
const { item: _item, impressions: _impressions, ...pageview } = raw;
|
|
144
|
+
return pageview;
|
|
145
|
+
}
|
|
146
|
+
const { durationMs: _durationMs, scrollDepth: _scrollDepth, impressions: _impressions, ...hit } = raw;
|
|
147
|
+
return hit;
|
|
148
|
+
};
|
|
149
|
+
/** An anonymous event keeps no time, scroll or items seen: engagement is a visitor's alone. */
|
|
150
|
+
const fieldsOfMode = (raw, mode) => {
|
|
151
|
+
if (mode !== "a") return raw;
|
|
152
|
+
const { durationMs: _durationMs, scrollDepth: _scrollDepth, impressions: _seen, ...kept } = raw;
|
|
153
|
+
return kept;
|
|
154
|
+
};
|
|
155
|
+
/**
|
|
156
|
+
* The ref an item value is kept under: signed by this server (or trusted, or unsigned where
|
|
157
|
+
* signatures are optional), of a bound collection, with an id that collection could hold.
|
|
158
|
+
*/
|
|
159
|
+
const keptItemRef = (value, options, origin) => {
|
|
160
|
+
const ref = verifiedItemRef(value, options.signature, origin === "server");
|
|
161
|
+
return ref === void 0 ? void 0 : boundItemRef(ref, options.collections, options.idTypes);
|
|
162
|
+
};
|
|
163
|
+
/**
|
|
164
|
+
* The refs of the items an engagement saw, each kept, once each, and no more than one beacon
|
|
165
|
+
* carries. Anything else in the list is dropped rather than failing the engagement.
|
|
166
|
+
*/
|
|
167
|
+
const seenItems = (value, options, origin) => {
|
|
168
|
+
if (!options || !Array.isArray(value)) return [];
|
|
169
|
+
const refs = /* @__PURE__ */ new Set();
|
|
170
|
+
for (const entry of value) {
|
|
171
|
+
if (refs.size >= 50) break;
|
|
172
|
+
const ref = keptItemRef(entry, options, origin);
|
|
173
|
+
if (ref !== void 0) refs.add(ref);
|
|
174
|
+
}
|
|
175
|
+
return [...refs];
|
|
176
|
+
};
|
|
177
|
+
/** One event sanitized, attributed and goal-matched, alike for a beacon and for server code. */
|
|
178
|
+
async function normalizeEvent({ raw: input, hostname: rawHostname, headers, geoResolver, warnGeo, salt, now, scope, goals, origin = "wire", browserAmounts = DEFAULT_BROWSER_AMOUNTS, reportingCurrency, convertCurrency, warnUnconverted, trustedProxyHops, trustedPlatform, items: itemOptions, siblings, orderKey, mode = "f" }) {
|
|
179
|
+
const anonymous = mode === "a";
|
|
180
|
+
const raw = fieldsOfMode(fieldsOfType(input), mode);
|
|
181
|
+
const item = itemOptions ? keptItemRef(raw.item, itemOptions, origin) : void 0;
|
|
182
|
+
const impressions = seenItems(raw.impressions, itemOptions, origin);
|
|
183
|
+
const trust = {
|
|
184
|
+
trustedProxyHops,
|
|
185
|
+
trustedPlatform
|
|
186
|
+
};
|
|
187
|
+
const geo = await resolveGeo(geoResolver, headers, {
|
|
188
|
+
trust,
|
|
189
|
+
warn: warnGeo
|
|
190
|
+
});
|
|
191
|
+
const ip = anonymous ? "" : clientIpFromHeaders(headers, trust) ?? "";
|
|
69
192
|
const ua = headers.get("user-agent") ?? "";
|
|
70
193
|
const path = raw.path.slice(0, MAX_PATH_LENGTH);
|
|
71
|
-
const hostname =
|
|
72
|
-
const
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
194
|
+
const hostname = rawHostname.slice(0, 253);
|
|
195
|
+
const items = sanitizeItems(raw.items);
|
|
196
|
+
const sanitized = sanitizeProps(raw.props, raw.orderId !== void 0);
|
|
197
|
+
const props = items === void 0 ? sanitized : {
|
|
198
|
+
...sanitized,
|
|
199
|
+
items
|
|
200
|
+
};
|
|
201
|
+
const name = eventName(raw.name);
|
|
202
|
+
const isRevenue = origin === "server" && raw.revenue === true;
|
|
203
|
+
const refund = isRefund(isRevenue, raw.value);
|
|
204
|
+
const believed = origin === "server" ? "trust" : browserAmounts;
|
|
205
|
+
const candidates = origin === "wire" ? goals?.filter((goal) => goal.browser !== false) : goals;
|
|
206
|
+
const matching = Boolean(candidates?.length) && raw.type !== "engagement";
|
|
207
|
+
const eventCurrency = currencyCode(raw.currency);
|
|
208
|
+
const sent = sentAmount({
|
|
209
|
+
value: isRevenue ? signed(raw.value) : nonNegative(raw.value),
|
|
210
|
+
currency: eventCurrency,
|
|
211
|
+
believed
|
|
77
212
|
});
|
|
78
|
-
const
|
|
79
|
-
const
|
|
80
|
-
|
|
213
|
+
const reconciled = /* @__PURE__ */ new Map();
|
|
214
|
+
const reconcile = (value, currency) => {
|
|
215
|
+
const key = JSON.stringify([value ?? null, currency ?? null]);
|
|
216
|
+
const known = reconciled.get(key);
|
|
217
|
+
if (known) return known;
|
|
218
|
+
const money = reconcileMoney({
|
|
219
|
+
...value === void 0 ? {} : { value },
|
|
220
|
+
...currency === void 0 ? {} : { currency },
|
|
221
|
+
reportingCurrency,
|
|
222
|
+
convertCurrency,
|
|
223
|
+
at: now,
|
|
224
|
+
warn: warnUnconverted
|
|
225
|
+
});
|
|
226
|
+
reconciled.set(key, money);
|
|
227
|
+
return money;
|
|
228
|
+
};
|
|
229
|
+
const counted = matching && candidates ? await countCompletions(completionAmounts({
|
|
230
|
+
type: raw.type,
|
|
231
|
+
name,
|
|
232
|
+
path,
|
|
233
|
+
props,
|
|
234
|
+
value: sent.value
|
|
235
|
+
}, candidates, {
|
|
236
|
+
allowNegativeValue: isRevenue,
|
|
237
|
+
props: believed !== "none",
|
|
238
|
+
fixedFirst: believed !== "trust"
|
|
239
|
+
}), {
|
|
240
|
+
eventCurrency,
|
|
241
|
+
reconcile
|
|
242
|
+
}) : [];
|
|
243
|
+
const completions = counted.map((each) => each.completion);
|
|
244
|
+
const money = counted.find((each) => each.money !== void 0)?.money ?? await reconcile(sent.value, sent.currency);
|
|
245
|
+
const order = sanitizeOrderId(raw.orderId);
|
|
246
|
+
const refundId = refund ? sanitizeOrderId(raw.refundId) : void 0;
|
|
81
247
|
const scrollDepth = depth(raw.scrollDepth);
|
|
82
248
|
const durationMs = duration(raw.durationMs);
|
|
83
|
-
const name = eventName(raw.name);
|
|
84
249
|
const device = classifyDevice(ua);
|
|
85
250
|
const browser = classifyBrowser(ua);
|
|
86
251
|
const os = classifyOs(ua);
|
|
87
252
|
const language = primaryLanguage(headers.get("accept-language"));
|
|
88
|
-
const refHost = referrerHost(raw.referrer, hostname);
|
|
253
|
+
const refHost = referrerHost(raw.referrer, hostname, siblings);
|
|
254
|
+
const siteReferrer = !isSiteReferral(raw.referrer, hostname) && isSiteReferral(raw.referrer, hostname, siblings);
|
|
89
255
|
const query = queryString(raw.query);
|
|
90
256
|
const utm = extractUtm(query);
|
|
91
|
-
const
|
|
92
|
-
type: raw.type,
|
|
93
|
-
name,
|
|
94
|
-
path,
|
|
95
|
-
props,
|
|
96
|
-
value
|
|
97
|
-
}, goals) : [];
|
|
257
|
+
const clickId = clickIdOf(query);
|
|
98
258
|
return {
|
|
99
259
|
timestamp: now,
|
|
100
260
|
type: raw.type,
|
|
@@ -103,32 +263,51 @@ async function normalizeEvent({ raw, headers, geoResolver, salt, now, scope, tim
|
|
|
103
263
|
hostname,
|
|
104
264
|
referrer: storedReferrer(raw.referrer),
|
|
105
265
|
...refHost ? { referrerHost: refHost } : {},
|
|
266
|
+
...siteReferrer ? { siteReferrer: true } : {},
|
|
106
267
|
...device ? { device } : {},
|
|
107
268
|
...browser ? { browser } : {},
|
|
108
269
|
...os ? { os } : {},
|
|
109
|
-
source: deriveSource({
|
|
110
|
-
referrerHost: refHost,
|
|
111
|
-
utmMedium: utm.utmMedium,
|
|
112
|
-
query
|
|
113
|
-
}),
|
|
114
270
|
...utm,
|
|
115
271
|
country: geoValue(geo.country),
|
|
116
|
-
|
|
117
|
-
|
|
272
|
+
...anonymous ? {} : {
|
|
273
|
+
region: geoValue(geo.region),
|
|
274
|
+
city: geoValue(geo.city)
|
|
275
|
+
},
|
|
118
276
|
...language ? { language } : {},
|
|
119
|
-
visitorHash,
|
|
120
|
-
sessionId: deriveSessionId(visitorHash, hourBucket),
|
|
121
277
|
props,
|
|
122
278
|
...durationMs !== void 0 ? { durationMs } : {},
|
|
123
|
-
...value !== void 0 ? { value } : {},
|
|
124
|
-
...
|
|
279
|
+
...money.value !== void 0 ? { value: money.value } : {},
|
|
280
|
+
...money.currency !== void 0 ? { currency: money.currency } : {},
|
|
281
|
+
...money.originalValue !== void 0 ? { originalValue: money.originalValue } : {},
|
|
282
|
+
...money.originalCurrency !== void 0 ? { originalCurrency: money.originalCurrency } : {},
|
|
283
|
+
...order ? { dedupeKey: dedupeKeyFor({
|
|
284
|
+
origin,
|
|
285
|
+
...scope ? { tenant: scope } : {},
|
|
286
|
+
goal: name ?? raw.type,
|
|
287
|
+
orderId: order,
|
|
288
|
+
refund,
|
|
289
|
+
...refundId === void 0 ? {} : { refundId },
|
|
290
|
+
...orderKey ? { key: orderKey } : {}
|
|
291
|
+
}) } : {},
|
|
292
|
+
...refund ? { refund: true } : {},
|
|
125
293
|
...scrollDepth !== void 0 ? { scrollDepth } : {},
|
|
126
294
|
...completions.length > 0 ? { goals: completions } : {},
|
|
127
295
|
...scope !== void 0 ? { scope } : {},
|
|
128
|
-
...
|
|
296
|
+
...item !== void 0 ? { item } : {},
|
|
297
|
+
...impressions.length > 0 ? { impressions } : {},
|
|
298
|
+
visitorId: !anonymous && identifiesVisitor(ip, ua) ? dailyVisitorId({
|
|
299
|
+
ip,
|
|
300
|
+
ua,
|
|
301
|
+
site: hostname,
|
|
302
|
+
salt
|
|
303
|
+
}) : "",
|
|
304
|
+
...clickId ? { clickId } : {},
|
|
305
|
+
...input.type === "pageview" && isNavigation(input.nav) ? { navigation: true } : {},
|
|
306
|
+
...origin === "server" ? { server: true } : {},
|
|
307
|
+
mode
|
|
129
308
|
};
|
|
130
309
|
}
|
|
131
310
|
//#endregion
|
|
132
|
-
export { normalizeEvent };
|
|
311
|
+
export { eventTime, normalizeEvent };
|
|
133
312
|
|
|
134
313
|
//# sourceMappingURL=normalizeEvent.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"normalizeEvent.js","names":[],"sources":["../../../src/native/ingest/normalizeEvent.ts"],"sourcesContent":["import { type GoalCompletion, matchGoals } from '../../goals/match'\nimport type { Goal } from '../../goals/types'\nimport { MAX_GEO_LENGTH, MAX_QUERY_LENGTH, MAX_REFERRER_LENGTH } from '../../query/limits'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { type BrowserName, classifyBrowser, classifyOs, type OsName } from './browser'\nimport { clientIpFromHeaders } from './clientIp'\nimport { classifyDevice, type DeviceType } from './device'\nimport { primaryLanguage } from './language'\nimport { referrerHost, storedReferrer } from './referrer'\nimport { deriveSource } from './source'\nimport { extractUtm } from './utm'\nimport { dailyVisitorHash, deriveSessionId } from './visitorHash'\n\n/** The wire caps, re-exported beside the sanitizers that apply them. */\nexport { MAX_GEO_LENGTH, MAX_QUERY_LENGTH, MAX_REFERRER_LENGTH }\n\nexport type EventType = 'pageview' | 'event' | 'goal'\n\nexport interface RawEventInput {\n\ttype: EventType\n\t/** Event name, or the goal slug on a `goal`. Absent on pageviews. */\n\tname?: string\n\tpath: string\n\thostname: string\n\treferrer?: string\n\t/**\n\t * The page's query string, without its leading `?`. Read for its utm keys and then\n\t * discarded: it is never stored, so a session token or an email address that happens to\n\t * be in the URL never lands in the events collection.\n\t */\n\tquery?: string\n\tdurationMs?: number\n\tprops?: Record<string, unknown>\n\t/** Revenue for a goal completion, in `currency`. */\n\tvalue?: number\n\tcurrency?: string\n\t/** Max scroll depth reached on a pageview, 0-100. */\n\tscrollDepth?: number\n}\n\nexport interface StoredEvent {\n\ttimestamp: Date\n\ttype: EventType\n\tname?: string\n\tpath: string\n\thostname: string\n\t/** Origin and path only: the query string and fragment are stripped before storage. */\n\treferrer?: string\n\t/**\n\t * The referrer's bare host, derived at ingest because a `where` cannot derive it at read\n\t * time: it is what the `referrer` dimension buckets and filters on.\n\t */\n\treferrerHost?: string\n\tdevice?: DeviceType\n\tbrowser?: BrowserName\n\tos?: OsName\n\t/**\n\t * The hit's traffic channel (`TrafficChannel`). Typed as a string because rows written\n\t * before the channel classifier hold a referrer host here instead, and they are never\n\t * rewritten.\n\t */\n\tsource?: string\n\t/** The five campaign keys extracted from the wire `query`; absent when it carried none. */\n\tutmSource?: string\n\tutmMedium?: string\n\tutmCampaign?: string\n\tutmContent?: string\n\tutmTerm?: string\n\tcountry?: string\n\tregion?: string\n\tcity?: string\n\t/** Primary `Accept-Language` tag, lowercased (`de-de`). */\n\tlanguage?: string\n\tvisitorHash: string\n\tsessionId: string\n\tdurationMs?: number\n\tprops?: Record<string, unknown>\n\tvalue?: number\n\t/** ISO 4217 code `value` is denominated in. Stored as sent; revenue is never converted. */\n\tcurrency?: string\n\tscrollDepth?: number\n\t/**\n\t * Goals this event completed, resolved against the install's goals at ingest so a later\n\t * goal edit never rewrites history and a raw-event read can re-derive the same numbers\n\t * the rollups hold.\n\t */\n\tgoals?: GoalCompletion[]\n\t/** Set only in scoped installs; '' is the null scope. */\n\tscope?: string\n\t/**\n\t * Reporting timezone the rollup day bucket is computed in. In-memory only: stripped\n\t * before the event row is persisted (day bucketing happens at rollup time). Absent\n\t * means UTC.\n\t */\n\ttimezone?: string\n}\n\nexport interface NormalizeArgs {\n\traw: RawEventInput\n\theaders: Headers\n\tgeoResolver: GeoResolver\n\tsalt: string\n\tnow: Date\n\tscope?: string\n\ttimezone?: string\n\t/** Goals to match this event against; omitted means no goal matching. */\n\tgoals?: Goal[]\n}\n\nconst MAX_PROPS = 20\nconst MAX_KEY_LENGTH = 64\nconst MAX_VALUE_LENGTH = 256\nconst MAX_NAME_LENGTH = 128\nconst MAX_PATH_LENGTH = 512\n/** Longest legal DNS name. */\nconst MAX_HOSTNAME_LENGTH = 253\n/** 24 hours. A longer duration is a broken clock, not a session. */\nconst MAX_DURATION_MS = 86_400_000\nconst CURRENCY = /^[A-Z]{3}$/\n\n/**\n * Optional wire fields are sanitized rather than rejected: a bad `value`, `currency`,\n * `scrollDepth`, `durationMs`, or prop is dropped and the event is still ingested, so one malformed\n * attribute never costs a pageview. Only the required fields (checked in the endpoint)\n * can fail an event.\n */\nconst nonNegative = (value: unknown): number | undefined =>\n\ttypeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined\n\nconst currencyCode = (value: unknown): string | undefined =>\n\ttypeof value === 'string' && CURRENCY.test(value) ? value : undefined\n\n/**\n * Infinity would poison a rollup bucket's average for good, and a string would throw out of\n * the write and take the whole buffered batch with it, so a duration outside the ceiling is\n * dropped like any other malformed attribute.\n */\nconst duration = (value: unknown): number | undefined => {\n\tconst n = nonNegative(value)\n\treturn n === undefined || n > MAX_DURATION_MS ? undefined : n\n}\n\n/** The event name is a rollup bucket key (the `event` dimension), so it is length-capped. */\nconst eventName = (value: unknown): string | undefined =>\n\ttypeof value === 'string' ? value.slice(0, MAX_NAME_LENGTH) : undefined\n\n/**\n * A geo value as stored. The resolver reads request headers a client can set, and each value\n * becomes a rollup dimvalue and part of a seen-ledger key, so it is capped here rather than\n * trusted. An empty value stays absent: '' would be a bucket of its own.\n */\nconst geoValue = (value: string | undefined): string | undefined =>\n\tvalue ? value.slice(0, MAX_GEO_LENGTH) : undefined\n\n/** Capped before it is parsed, so a hostile query cannot make ingest do unbounded work. */\nconst queryString = (value: unknown): string | undefined =>\n\ttypeof value === 'string' ? value.slice(0, MAX_QUERY_LENGTH) : undefined\n\nconst depth = (value: unknown): number | undefined => {\n\tconst n = nonNegative(value)\n\treturn n === undefined ? undefined : Math.round(Math.min(n, 100))\n}\n\n/** Flat JSON scalars only: the first 20 short-keyed string/number/boolean entries. */\nconst sanitizeProps = (raw: unknown): Record<string, unknown> | undefined => {\n\tif (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {\n\t\treturn undefined\n\t}\n\tconst out: Record<string, unknown> = {}\n\tlet kept = 0\n\tfor (const [key, value] of Object.entries(raw)) {\n\t\tif (kept >= MAX_PROPS || key.length > MAX_KEY_LENGTH) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof value === 'string') {\n\t\t\tout[key] = value.slice(0, MAX_VALUE_LENGTH)\n\t\t} else if (\n\t\t\ttypeof value === 'boolean' ||\n\t\t\t(typeof value === 'number' && Number.isFinite(value))\n\t\t) {\n\t\t\tout[key] = value\n\t\t} else {\n\t\t\tcontinue\n\t\t}\n\t\tkept++\n\t}\n\treturn kept > 0 ? out : undefined\n}\n\nexport async function normalizeEvent({\n\traw,\n\theaders,\n\tgeoResolver,\n\tsalt,\n\tnow,\n\tscope,\n\ttimezone,\n\tgoals,\n}: NormalizeArgs): Promise<StoredEvent> {\n\tconst geo = await geoResolver(headers)\n\tconst ip = clientIpFromHeaders(headers) ?? ''\n\tconst ua = headers.get('user-agent') ?? ''\n\t// Everything that becomes a rollup dimvalue or a seen-ledger key is capped before anything\n\t// derives from it: an uncapped value exceeds Mongo's index key limit, and on Postgres a\n\t// btree key over 2704 bytes fails the write outright. That covers path and hostname here,\n\t// the geo values below (a client can set the headers a resolver reads), and the event name,\n\t// query and referrer in their own sanitizers.\n\tconst path = raw.path.slice(0, MAX_PATH_LENGTH)\n\tconst hostname = raw.hostname.slice(0, MAX_HOSTNAME_LENGTH)\n\tconst visitorHash = dailyVisitorHash({ ip, ua, site: hostname, salt })\n\tconst hourBucket = now.toISOString().slice(0, 13)\n\tconst props = sanitizeProps(raw.props)\n\tconst value = nonNegative(raw.value)\n\tconst scrollDepth = depth(raw.scrollDepth)\n\tconst durationMs = duration(raw.durationMs)\n\tconst name = eventName(raw.name)\n\tconst device = classifyDevice(ua)\n\tconst browser = classifyBrowser(ua)\n\tconst os = classifyOs(ua)\n\tconst language = primaryLanguage(headers.get('accept-language'))\n\tconst refHost = referrerHost(raw.referrer, hostname)\n\tconst query = queryString(raw.query)\n\tconst utm = extractUtm(query)\n\t// Match on the sanitized fields so a rejected value never reaches a goal's revenue.\n\tconst completions = goals?.length\n\t\t? matchGoals({ type: raw.type, name, path, props, value }, goals)\n\t\t: []\n\treturn {\n\t\ttimestamp: now,\n\t\ttype: raw.type,\n\t\tname,\n\t\tpath,\n\t\thostname,\n\t\treferrer: storedReferrer(raw.referrer),\n\t\t...(refHost ? { referrerHost: refHost } : {}),\n\t\t...(device ? { device } : {}),\n\t\t...(browser ? { browser } : {}),\n\t\t...(os ? { os } : {}),\n\t\tsource: deriveSource({ referrerHost: refHost, utmMedium: utm.utmMedium, query }),\n\t\t...utm,\n\t\tcountry: geoValue(geo.country),\n\t\tregion: geoValue(geo.region),\n\t\tcity: geoValue(geo.city),\n\t\t...(language ? { language } : {}),\n\t\tvisitorHash,\n\t\tsessionId: deriveSessionId(visitorHash, hourBucket),\n\t\tprops,\n\t\t...(durationMs !== undefined ? { durationMs } : {}),\n\t\t...(value !== undefined ? { value } : {}),\n\t\t...(currencyCode(raw.currency) !== undefined ? { currency: raw.currency } : {}),\n\t\t...(scrollDepth !== undefined ? { scrollDepth } : {}),\n\t\t...(completions.length > 0 ? { goals: completions } : {}),\n\t\t...(scope !== undefined ? { scope } : {}),\n\t\t...(timezone !== undefined ? { timezone } : {}),\n\t}\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"normalizeEvent.js","names":[],"sources":["../../../src/native/ingest/normalizeEvent.ts"],"sourcesContent":["import { isRecord } from '../../core/values'\nimport { MAX_ENGAGEMENT_MS, MAX_ITEMS_PER_BEACON, MAX_SINCE_MS } from '../../goals/constants'\nimport type { CurrencyConverter } from '../../goals/currency'\nimport { sanitizeItems } from '../../goals/items'\nimport {\n\ttype BrowserAmounts,\n\ttype CompletionAmount,\n\tcompletionAmounts,\n\tDEFAULT_BROWSER_AMOUNTS,\n\ttype GoalCompletion,\n} from '../../goals/match'\nimport type { Goal } from '../../goals/types'\nimport type { ItemIdType } from '../../items/idType'\nimport { boundItemRef } from '../../items/ref'\nimport type { TrustedPlatform } from '../../net/platform'\nimport { MAX_GEO_LENGTH, MAX_QUERY_LENGTH } from '../../query/limits'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { resolveGeo } from '../geo/resolveGeo'\nimport type { HitMode, HitType } from '../store/types'\nimport { type BrowserName, classifyBrowser, classifyOs, type OsName } from './browser'\nimport { clientIpFromHeaders } from './clientIp'\nimport { classifyDevice, type DeviceType, SERVER_USER_AGENT } from './device'\nimport { type ItemSignatureCheck, verifiedItemRef } from './itemSignature'\nimport { primaryLanguage } from './language'\nimport { isSiteReferral, referrerHost, storedReferrer } from './referrer'\nimport { MAX_HOSTNAME_LENGTH } from './requestHost'\nimport {\n\tboundedValue,\n\tdedupeKeyFor,\n\ttype IngestOrigin,\n\tisRefund,\n\ttype Money,\n\treconcileMoney,\n\tsanitizeOrderId,\n} from './revenue'\nimport { clickIdOf } from './source'\nimport { extractUtm } from './utm'\nimport { boundedSinceMs, isNavigation } from './validate'\nimport { dailyVisitorId } from './visitorHash'\n\n/**\n * One event as the tracker or `trackServerEvent` sends it, before the ingest normalizes it.\n * @beta\n */\nexport interface RawEventInput {\n\t/** An `engagement` gets a row of its own so a filtered read finds it, never counted as a hit. */\n\ttype: HitType\n\t/** Event name, or the goal slug on a `goal`. Absent on a pageview and an engagement. */\n\tname?: string\n\tpath: string\n\t/**\n\t * The hostname the client claims. Ignored by the HTTP ingest, which attributes an event to\n\t * the request that carried it; `trackServerEvent` supplies its own and it is used as sent.\n\t */\n\thostname?: string\n\treferrer?: string\n\t/**\n\t * Query string without its leading `?`. Read for campaign keys and never stored, so a session\n\t * token or email address in the URL never lands in a hit.\n\t */\n\tquery?: string\n\t/**\n\t * Engaged time an engagement adds. Kept on a pageview too, which is what a tracker cached\n\t * from before engagement existed still sends; dropped on every other type.\n\t */\n\tdurationMs?: number\n\t/**\n\t * On an engagement only: ms since its pageview was sent, by the page's own clock so the device's\n\t * date never matters. Read by {@link eventTime}, never stored.\n\t */\n\tsinceMs?: number\n\t/**\n\t * How long the event waited in the page before it was sent, by the page's own clock: a pending\n\t * gate or a prerender held it. Read by {@link eventTime}, never stored.\n\t */\n\tageMs?: number\n\t/** `1` on a pageview a single-page app made in place, without loading a document. */\n\tnav?: number\n\tprops?: Record<string, unknown>\n\t/** Revenue for a goal completion, in `currency`. */\n\tvalue?: number\n\tcurrency?: string\n\t/**\n\t * The lines of a sale. Sanitized and stored under `props.items`, so a read of the event\n\t * carries the order without a second collection.\n\t */\n\titems?: unknown\n\t/**\n\t * Marks a server `purchase` or `refund`, the one path a negative `value` is allowed on. The wire\n\t * refuses it: a forged refund subtracts from revenue it never added to.\n\t */\n\trevenue?: boolean\n\t/**\n\t * The order this amount belongs to. The order's hit is keyed by a digest of it, so a retried\n\t * payment webhook counts once however often it arrives; the id itself is stored nowhere.\n\t */\n\torderId?: string\n\t/**\n\t * On a server refund, the refund's own id as the payment provider names it: it joins the order\n\t * id in the refund's key, so each partial refund counts once however often it is retried.\n\t */\n\trefundId?: string\n\t/**\n\t * On a pageview, its scroll depth, 0 when the tracker measures it afterwards; on an\n\t * engagement, how much deeper the page was scrolled since the previous one. 0-100.\n\t */\n\tscrollDepth?: number\n\t/**\n\t * Item ref (`<collection>:<id>`), server-signed when a page sends it (`offers:12@<signature>`).\n\t * Dropped, keeping the event, unless verified and of a collection bound as an item.\n\t */\n\titem?: string\n\t/**\n\t * On an engagement only: item values seen since the previous one, each checked like `item` and\n\t * capped at one beacon's worth.\n\t */\n\timpressions?: unknown\n\t/**\n\t * How the page measured this beacon; absent is `f`, which a tracker from before modes sends.\n\t * Ingest stores no more than the mode allows, whatever else the beacon carries.\n\t */\n\tm?: HitMode\n}\n\n/**\n * An event once ingest has sanitized, attributed and matched it: what `toHit` shapes into the row\n * that is stored. Nothing here is written as it stands.\n */\nexport interface NormalizedEvent {\n\t/** When it arrived, or for an engagement its pageview's start; see {@link eventTime}. */\n\ttimestamp: Date\n\ttype: HitType\n\tname?: string\n\tpath: string\n\thostname: string\n\t/**\n\t * Origin and path only, the query string and fragment stripped: whether a pageview opens a\n\t * visit is decided by it. Never stored.\n\t */\n\treferrer?: string\n\t/** The referrer's bare host, which a landing stores as `ref`; absent for the site's own. */\n\treferrerHost?: string\n\t/**\n\t * The referrer is another hostname its scope records hits under: a link inside the site, which\n\t * opens no visit, whatever hostname it led to.\n\t */\n\tsiteReferrer?: boolean\n\tdevice?: DeviceType\n\tbrowser?: BrowserName\n\tos?: OsName\n\t/** The five campaign keys extracted from the wire `query`; absent when it carried none. */\n\tutmSource?: string\n\tutmMedium?: string\n\tutmCampaign?: string\n\tutmContent?: string\n\tutmTerm?: string\n\tcountry?: string\n\tregion?: string\n\tcity?: string\n\t/** Primary `Accept-Language` tag, lowercased (`de-de`). */\n\tlanguage?: string\n\tdurationMs?: number\n\tprops?: Record<string, unknown>\n\tvalue?: number\n\t/**\n\t * ISO 4217 code of `value`: as sent without `revenue.currency`, else always the reporting\n\t * currency, with the `original` fields holding what arrived.\n\t */\n\tcurrency?: string\n\t/** The amount as sent, present only when it is not what `value` holds. */\n\toriginalValue?: number\n\toriginalCurrency?: string\n\t/**\n\t * The order hit's primary key derives from it, so the database refuses a second row for one order\n\t * even when two retries race.\n\t */\n\tdedupeKey?: string\n\t/** A server refund: its completions count their negative amount in revenue and no conversion. */\n\trefund?: true\n\tscrollDepth?: number\n\t/**\n\t * Goals this event completed, resolved against the install's goals at ingest so a later\n\t * goal edit never rewrites history.\n\t */\n\tgoals?: GoalCompletion[]\n\t/** Set only in scoped installs; '' is the null scope. */\n\tscope?: string\n\t/** The content item this event or goal belongs to, as its ref. */\n\titem?: string\n\t/** Items seen on screen since the previous engagement, on an engagement only. */\n\timpressions?: string[]\n\t/**\n\t * The day's visitor id: 16 characters of a keyed hash of the address, the agent and the site,\n\t * or `''` for a server event with neither an address nor a user agent of its own.\n\t */\n\tvisitorId: string\n\t/** The ad click id the query carried, by name (`gclid`, `fbclid`). */\n\tclickId?: string\n\t/** A pageview a single-page app made in place (`nav: 1`). */\n\tnavigation?: boolean\n\t/** Recorded by server code rather than sent by a browser. */\n\tserver?: boolean\n\t/** Absent is `f`. */\n\tmode?: HitMode\n}\n\ninterface NormalizeArgs {\n\traw: RawEventInput\n\t/** Already resolved and capped: what the event is attributed to, not what it claimed. */\n\thostname: string\n\theaders: Headers\n\tgeoResolver: GeoResolver\n\t/** Where a throwing resolver is reported; the event is stored without a location either way. */\n\twarnGeo?: (message: string) => void\n\t/** The salt of the visitor's day, which the visitor id is hashed with. */\n\tsalt: string\n\tnow: Date\n\tscope?: string\n\tgoals?: Goal[]\n\t/**\n\t * Revenue semantics belong to `'server'` alone, so the default is the unprivileged origin and\n\t * only `trackServerEvent` passes the other.\n\t */\n\torigin?: IngestOrigin\n\t/**\n\t * `revenue.browserAmounts`: how far an amount a browser sent is believed. Read for\n\t * `origin: 'wire'` alone; absent, `DEFAULT_BROWSER_AMOUNTS`.\n\t */\n\tbrowserAmounts?: BrowserAmounts\n\t/** The install's reporting currency; undefined stores and sums amounts exactly as sent. */\n\treportingCurrency?: string\n\tconvertCurrency?: CurrencyConverter\n\t/** Called at most once per process when an amount could not be converted. */\n\twarnUnconverted?: () => void\n\t/** Trusted proxies in front of the app, for the client address the hash and geo read. */\n\ttrustedProxyHops?: number\n\t/** The platform whose edge headers carry the client address and location, when trusted. */\n\ttrustedPlatform?: TrustedPlatform\n\t/** The collections bound as items, whose refs alone are kept. Absent keeps no item at all. */\n\titems?: ItemIngestOptions\n\t/**\n\t * The other hostnames the event's scope records hits under, bare: a referrer on one of them is\n\t * the site's own page, never a referral.\n\t */\n\tsiblings?: ReadonlySet<string>\n\t/** `orderDigestKey` of the instance's secret, which an order's key is digested with. */\n\torderKey?: Buffer\n\t/**\n\t * What the event may store: `a` hashes no visitor and keeps country alone, no time, scroll or\n\t * items seen. Absent is `f`, as for a beacon without `m`.\n\t */\n\tmode?: HitMode\n}\n\nexport interface ItemIngestOptions {\n\tcollections: ReadonlySet<string>\n\t/**\n\t * Each bound collection's id type, known once the database adapter is (at init). A ref whose\n\t * id cannot be one of its collection's ids is dropped like an unbound one.\n\t */\n\tidTypes?: ReadonlyMap<string, ItemIdType>\n\t/**\n\t * How a ref's signature is checked, known once the instance's secret is. Absent, nothing a page\n\t * sends can be verified, so only server code's own items are kept.\n\t */\n\tsignature?: ItemSignatureCheck\n}\n\nconst MAX_PROPS = 20\nconst MAX_KEY_LENGTH = 64\nconst MAX_VALUE_LENGTH = 256\nconst MAX_NAME_LENGTH = 128\nconst MAX_PATH_LENGTH = 512\nconst CURRENCY = /^[A-Z]{3}$/\n\n/**\n * When an event happened: its arrival less its `ageMs`, and an engagement's `sinceMs` too, so it is\n * filed at its pageview's start. Each is believed from 0 to a day, and together reach back a day.\n */\nexport const eventTime = (\n\traw: Pick<RawEventInput, 'type' | 'sinceMs' | 'ageMs'>,\n\treceivedAt: Date\n): Date => {\n\tconst waited = boundedSinceMs(raw.ageMs) ?? 0\n\tconst since = raw.type === 'engagement' ? (boundedSinceMs(raw.sinceMs) ?? 0) : 0\n\tconst back = Math.min(MAX_SINCE_MS, waited + since)\n\treturn back === 0 ? receivedAt : new Date(receivedAt.getTime() - back)\n}\n\n/**\n * Whether an event comes with a visitor of its own: an address, or a user agent other than the\n * one server tracking stamps when it has none. A beacon always does; server code may not.\n */\nconst identifiesVisitor = (ip: string, ua: string): boolean =>\n\tip !== '' || (ua !== '' && ua !== SERVER_USER_AGENT)\n\n/**\n * Optional wire fields are sanitized rather than rejected, so one malformed attribute never costs\n * a pageview.\n */\nconst nonNegative = (value: unknown): number | undefined => {\n\tconst bounded = boundedValue(value)\n\treturn bounded !== undefined && bounded >= 0 ? bounded : undefined\n}\n\n/** A refund is the one negative amount ingest keeps, and only on a server `refund` call. */\nconst signed = (value: unknown): number | undefined => boundedValue(value)\n\nconst currencyCode = (value: unknown): string | undefined =>\n\ttypeof value === 'string' && CURRENCY.test(value) ? value : undefined\n\n/**\n * The event's amount as far as it is believed: as sent under `trust` and `fixed` (where a goal's\n * fixed value still wins for its own completion), nothing under `none`.\n */\nexport const sentAmount = (args: {\n\tvalue: number | undefined\n\tcurrency: string | undefined\n\tbelieved: BrowserAmounts\n}): { value?: number; currency?: string } =>\n\targs.believed === 'none'\n\t\t? {}\n\t\t: {\n\t\t\t\t...(args.value === undefined ? {} : { value: args.value }),\n\t\t\t\t...(args.currency === undefined ? {} : { currency: args.currency }),\n\t\t\t}\n\n/** One completion as counted, and the money its amount came to, absent for one worth nothing. */\ninterface CountedCompletion {\n\tcompletion: GoalCompletion\n\tmoney?: Money\n}\n\n/**\n * Each completion reconciled on its own (a fixed value in its goal's currency, else the event's),\n * one conversion per distinct amount however many goals share it.\n */\nconst countCompletions = async (\n\tamounts: readonly CompletionAmount[],\n\targs: {\n\t\teventCurrency: string | undefined\n\t\treconcile: (value: number, currency: string | undefined) => Promise<Money>\n\t}\n): Promise<CountedCompletion[]> => {\n\tconst counted: CountedCompletion[] = []\n\tfor (const { goal, source, amount } of amounts) {\n\t\tif (source === 'none') {\n\t\t\tcounted.push({ completion: { slug: goal.slug, value: 0 } })\n\t\t\tcontinue\n\t\t}\n\t\tconst currency = source === 'fixed' ? currencyCode(goal.currency) : args.eventCurrency\n\t\tconst money = await args.reconcile(amount, currency)\n\t\tcounted.push({\n\t\t\tcompletion: {\n\t\t\t\tslug: goal.slug,\n\t\t\t\tvalue: money.value ?? 0,\n\t\t\t\t...(money.originalValue === undefined ? {} : { sent: money.originalValue }),\n\t\t\t},\n\t\t\tmoney,\n\t\t})\n\t}\n\treturn counted\n}\n\n/**\n * Infinity would poison every average for good, and a string would throw out of the write and take\n * the buffered batch with it.\n */\nconst duration = (value: unknown): number | undefined => {\n\tconst n = nonNegative(value)\n\treturn n === undefined || n > MAX_ENGAGEMENT_MS ? undefined : n\n}\n\n/** The event name is a value the `event` dimension groups by, so it is length-capped. */\nconst eventName = (value: unknown): string | undefined =>\n\ttypeof value === 'string' ? value.slice(0, MAX_NAME_LENGTH) : undefined\n\n/**\n * Capped, not trusted: the resolver reads headers a client can set. An empty value stays absent,\n * since '' would be a value of its own.\n */\nconst geoValue = (value: string | undefined): string | undefined =>\n\tvalue ? value.slice(0, MAX_GEO_LENGTH) : undefined\n\n/** Capped before it is parsed, so a hostile query cannot make ingest do unbounded work. */\nconst queryString = (value: unknown): string | undefined =>\n\ttypeof value === 'string' ? value.slice(0, MAX_QUERY_LENGTH) : undefined\n\nconst depth = (value: unknown): number | undefined => {\n\tconst n = nonNegative(value)\n\treturn n === undefined ? undefined : Math.round(Math.min(n, 100))\n}\n\n/**\n * Flat JSON scalars only, first 20 short-keyed entries. An order's event drops an `orderId` prop:\n * an order is kept as its digest alone.\n */\nconst sanitizeProps = (raw: unknown, order: boolean): Record<string, unknown> | undefined => {\n\tif (!isRecord(raw) || Array.isArray(raw)) {\n\t\treturn undefined\n\t}\n\tconst out: Record<string, unknown> = {}\n\tlet kept = 0\n\tfor (const [key, value] of Object.entries(raw)) {\n\t\tif (kept >= MAX_PROPS || key.length > MAX_KEY_LENGTH || (order && key === 'orderId')) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof value === 'string') {\n\t\t\tout[key] = value.slice(0, MAX_VALUE_LENGTH)\n\t\t} else if (\n\t\t\ttypeof value === 'boolean' ||\n\t\t\t(typeof value === 'number' && Number.isFinite(value))\n\t\t) {\n\t\t\tout[key] = value\n\t\t} else {\n\t\t\tcontinue\n\t\t}\n\t\tkept++\n\t}\n\treturn kept > 0 ? out : undefined\n}\n\n/**\n * An engagement adds only time, scroll and items seen; time and scroll count from a pageview or an\n * engagement alone, and only an event or a goal belongs to an item.\n */\nconst fieldsOfType = (raw: RawEventInput): RawEventInput => {\n\tif (raw.type === 'engagement') {\n\t\tconst { type, path, hostname, referrer, query, durationMs, scrollDepth, impressions } = raw\n\t\treturn { type, path, hostname, referrer, query, durationMs, scrollDepth, impressions }\n\t}\n\tif (raw.type === 'pageview') {\n\t\tconst { item: _item, impressions: _impressions, ...pageview } = raw\n\t\treturn pageview\n\t}\n\tconst {\n\t\tdurationMs: _durationMs,\n\t\tscrollDepth: _scrollDepth,\n\t\timpressions: _impressions,\n\t\t...hit\n\t} = raw\n\treturn hit\n}\n\n/** An anonymous event keeps no time, scroll or items seen: engagement is a visitor's alone. */\nconst fieldsOfMode = (raw: RawEventInput, mode: HitMode): RawEventInput => {\n\tif (mode !== 'a') {\n\t\treturn raw\n\t}\n\tconst { durationMs: _durationMs, scrollDepth: _scrollDepth, impressions: _seen, ...kept } = raw\n\treturn kept\n}\n\n/**\n * The ref an item value is kept under: signed by this server (or trusted, or unsigned where\n * signatures are optional), of a bound collection, with an id that collection could hold.\n */\nconst keptItemRef = (\n\tvalue: unknown,\n\toptions: ItemIngestOptions,\n\torigin: IngestOrigin\n): string | undefined => {\n\tconst ref = verifiedItemRef(value, options.signature, origin === 'server')\n\treturn ref === undefined ? undefined : boundItemRef(ref, options.collections, options.idTypes)\n}\n\n/**\n * The refs of the items an engagement saw, each kept, once each, and no more than one beacon\n * carries. Anything else in the list is dropped rather than failing the engagement.\n */\nconst seenItems = (\n\tvalue: unknown,\n\toptions: ItemIngestOptions | undefined,\n\torigin: IngestOrigin\n): string[] => {\n\tif (!options || !Array.isArray(value)) {\n\t\treturn []\n\t}\n\tconst refs = new Set<string>()\n\tfor (const entry of value) {\n\t\tif (refs.size >= MAX_ITEMS_PER_BEACON) {\n\t\t\tbreak\n\t\t}\n\t\tconst ref = keptItemRef(entry, options, origin)\n\t\tif (ref !== undefined) {\n\t\t\trefs.add(ref)\n\t\t}\n\t}\n\treturn [...refs]\n}\n\n/** One event sanitized, attributed and goal-matched, alike for a beacon and for server code. */\nexport async function normalizeEvent({\n\traw: input,\n\thostname: rawHostname,\n\theaders,\n\tgeoResolver,\n\twarnGeo,\n\tsalt,\n\tnow,\n\tscope,\n\tgoals,\n\torigin = 'wire',\n\tbrowserAmounts = DEFAULT_BROWSER_AMOUNTS,\n\treportingCurrency,\n\tconvertCurrency,\n\twarnUnconverted,\n\ttrustedProxyHops,\n\ttrustedPlatform,\n\titems: itemOptions,\n\tsiblings,\n\torderKey,\n\tmode = 'f',\n}: NormalizeArgs): Promise<NormalizedEvent> {\n\tconst anonymous = mode === 'a'\n\tconst raw = fieldsOfMode(fieldsOfType(input), mode)\n\tconst item = itemOptions ? keptItemRef(raw.item, itemOptions, origin) : undefined\n\tconst impressions = seenItems(raw.impressions, itemOptions, origin)\n\tconst trust = { trustedProxyHops, trustedPlatform }\n\tconst geo = await resolveGeo(geoResolver, headers, { trust, warn: warnGeo })\n\t// An anonymous event's address is read for its country alone, never hashed.\n\tconst ip = anonymous ? '' : (clientIpFromHeaders(headers, trust) ?? '')\n\tconst ua = headers.get('user-agent') ?? ''\n\t// Every value a daily total is keyed by is capped first: Mongo's index key limit and Postgres'\n\t// 2704-byte btree key both fail the write. Geo, name, query and referrer cap below.\n\tconst path = raw.path.slice(0, MAX_PATH_LENGTH)\n\tconst hostname = rawHostname.slice(0, MAX_HOSTNAME_LENGTH)\n\tconst items = sanitizeItems(raw.items)\n\tconst sanitized = sanitizeProps(raw.props, raw.orderId !== undefined)\n\t// The lines ride under props rather than in a column of their own: they are read back with\n\t// the event, never grouped or filtered on, and `sanitizeProps` keeps scalars only.\n\tconst props = items === undefined ? sanitized : { ...sanitized, items }\n\tconst name = eventName(raw.name)\n\tconst isRevenue = origin === 'server' && raw.revenue === true\n\tconst refund = isRefund(isRevenue, raw.value)\n\tconst believed: BrowserAmounts = origin === 'server' ? 'trust' : browserAmounts\n\t// A server-only goal (`browser: false`) is one a browser cannot complete, whatever it sends.\n\tconst candidates = origin === 'wire' ? goals?.filter((goal) => goal.browser !== false) : goals\n\tconst matching = Boolean(candidates?.length) && raw.type !== 'engagement'\n\tconst eventCurrency = currencyCode(raw.currency)\n\tconst sent = sentAmount({\n\t\tvalue: isRevenue ? signed(raw.value) : nonNegative(raw.value),\n\t\tcurrency: eventCurrency,\n\t\tbelieved,\n\t})\n\tconst reconciled = new Map<string, Promise<Money>>()\n\tconst reconcile = (value: number | undefined, currency: string | undefined): Promise<Money> => {\n\t\tconst key = JSON.stringify([value ?? null, currency ?? null])\n\t\tconst known = reconciled.get(key)\n\t\tif (known) {\n\t\t\treturn known\n\t\t}\n\t\tconst money = reconcileMoney({\n\t\t\t...(value === undefined ? {} : { value }),\n\t\t\t...(currency === undefined ? {} : { currency }),\n\t\t\treportingCurrency,\n\t\t\tconvertCurrency,\n\t\t\tat: now,\n\t\t\twarn: warnUnconverted,\n\t\t})\n\t\treconciled.set(key, money)\n\t\treturn money\n\t}\n\t// Match on the sanitized fields, each completion's amount reconciled on its own, so a rejected\n\t// value never reaches a goal's revenue and a converted one is what revenue sums.\n\tconst counted =\n\t\tmatching && candidates\n\t\t\t? await countCompletions(\n\t\t\t\t\tcompletionAmounts({ type: raw.type, name, path, props, value: sent.value }, candidates, {\n\t\t\t\t\t\tallowNegativeValue: isRevenue,\n\t\t\t\t\t\tprops: believed !== 'none',\n\t\t\t\t\t\tfixedFirst: believed !== 'trust',\n\t\t\t\t\t}),\n\t\t\t\t\t{ eventCurrency, reconcile }\n\t\t\t\t)\n\t\t\t: []\n\tconst completions = counted.map((each) => each.completion)\n\t// The row carries the money of its first completion worth something, else the event's own.\n\tconst money =\n\t\tcounted.find((each) => each.money !== undefined)?.money ??\n\t\t(await reconcile(sent.value, sent.currency))\n\tconst order = sanitizeOrderId(raw.orderId)\n\tconst refundId = refund ? sanitizeOrderId(raw.refundId) : undefined\n\tconst scrollDepth = depth(raw.scrollDepth)\n\tconst durationMs = duration(raw.durationMs)\n\tconst device = classifyDevice(ua)\n\tconst browser = classifyBrowser(ua)\n\tconst os = classifyOs(ua)\n\tconst language = primaryLanguage(headers.get('accept-language'))\n\tconst refHost = referrerHost(raw.referrer, hostname, siblings)\n\tconst siteReferrer =\n\t\t!isSiteReferral(raw.referrer, hostname) && isSiteReferral(raw.referrer, hostname, siblings)\n\tconst query = queryString(raw.query)\n\tconst utm = extractUtm(query)\n\tconst clickId = clickIdOf(query)\n\treturn {\n\t\ttimestamp: now,\n\t\ttype: raw.type,\n\t\tname,\n\t\tpath,\n\t\thostname,\n\t\treferrer: storedReferrer(raw.referrer),\n\t\t...(refHost ? { referrerHost: refHost } : {}),\n\t\t...(siteReferrer ? { siteReferrer: true } : {}),\n\t\t...(device ? { device } : {}),\n\t\t...(browser ? { browser } : {}),\n\t\t...(os ? { os } : {}),\n\t\t...utm,\n\t\tcountry: geoValue(geo.country),\n\t\t...(anonymous ? {} : { region: geoValue(geo.region), city: geoValue(geo.city) }),\n\t\t...(language ? { language } : {}),\n\t\tprops,\n\t\t...(durationMs !== undefined ? { durationMs } : {}),\n\t\t...(money.value !== undefined ? { value: money.value } : {}),\n\t\t...(money.currency !== undefined ? { currency: money.currency } : {}),\n\t\t...(money.originalValue !== undefined ? { originalValue: money.originalValue } : {}),\n\t\t...(money.originalCurrency !== undefined ? { originalCurrency: money.originalCurrency } : {}),\n\t\t...(order\n\t\t\t? {\n\t\t\t\t\tdedupeKey: dedupeKeyFor({\n\t\t\t\t\t\torigin,\n\t\t\t\t\t\t...(scope ? { tenant: scope } : {}),\n\t\t\t\t\t\tgoal: name ?? raw.type,\n\t\t\t\t\t\torderId: order,\n\t\t\t\t\t\trefund,\n\t\t\t\t\t\t...(refundId === undefined ? {} : { refundId }),\n\t\t\t\t\t\t...(orderKey ? { key: orderKey } : {}),\n\t\t\t\t\t}),\n\t\t\t\t}\n\t\t\t: {}),\n\t\t...(refund ? { refund: true } : {}),\n\t\t...(scrollDepth !== undefined ? { scrollDepth } : {}),\n\t\t...(completions.length > 0 ? { goals: completions } : {}),\n\t\t...(scope !== undefined ? { scope } : {}),\n\t\t...(item !== undefined ? { item } : {}),\n\t\t...(impressions.length > 0 ? { impressions } : {}),\n\t\tvisitorId:\n\t\t\t!anonymous && identifiesVisitor(ip, ua)\n\t\t\t\t? dailyVisitorId({ ip, ua, site: hostname, salt })\n\t\t\t\t: '',\n\t\t...(clickId ? { clickId } : {}),\n\t\t...(input.type === 'pageview' && isNavigation(input.nav) ? { navigation: true } : {}),\n\t\t...(origin === 'server' ? { server: true } : {}),\n\t\tmode,\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { Payload } from "payload";
|
|
2
|
+
|
|
3
|
+
//#region src/native/ingest/orderSignature.d.ts
|
|
4
|
+
/**
|
|
5
|
+
* `orderId` for the browser `purchase` (`<orderId>@<signature>`), bound to the tenant `scope`.
|
|
6
|
+
* Call it where the success page renders; the browser never sees the key.
|
|
7
|
+
*/
|
|
8
|
+
declare const signOrderId: (payload: Payload, orderId: string, opts?: {
|
|
9
|
+
scope?: string | null;
|
|
10
|
+
}) => string | undefined;
|
|
11
|
+
//#endregion
|
|
12
|
+
export { signOrderId };
|
|
13
|
+
//# sourceMappingURL=orderSignature.d.ts.map
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { labelledKey, sameSignature, shortSignature } from "./signature.js";
|
|
2
|
+
import { sanitizeOrderId } from "./revenue.js";
|
|
3
|
+
import { isSignatureShaped } from "../../items/ref.js";
|
|
4
|
+
//#region src/native/ingest/orderSignature.ts
|
|
5
|
+
/** The key order ids are signed with, derived from the instance's secret. */
|
|
6
|
+
const orderRefKey = labelledKey("analytics:order-ref:v1");
|
|
7
|
+
/** The signature of one order id in one scope. */
|
|
8
|
+
const signatureOf = (key, scope, orderId) => shortSignature(key, JSON.stringify([scope, orderId]));
|
|
9
|
+
/** A value split at its last separator when what follows it has a signature's shape. */
|
|
10
|
+
const splitSigned = (value) => {
|
|
11
|
+
const at = value.lastIndexOf("@");
|
|
12
|
+
const signature = at > 0 ? value.slice(at + 1) : "";
|
|
13
|
+
return isSignatureShaped(signature) ? {
|
|
14
|
+
orderId: value.slice(0, at),
|
|
15
|
+
signature
|
|
16
|
+
} : void 0;
|
|
17
|
+
};
|
|
18
|
+
const signedWith = (key, scope, signed) => sameSignature(signatureOf(key, scope, signed.orderId), signed.signature);
|
|
19
|
+
const sanitizedOrderId = (value) => {
|
|
20
|
+
const orderId = sanitizeOrderId(value);
|
|
21
|
+
return orderId === void 0 ? { ok: false } : {
|
|
22
|
+
ok: true,
|
|
23
|
+
orderId
|
|
24
|
+
};
|
|
25
|
+
};
|
|
26
|
+
/**
|
|
27
|
+
* Id unwrapped from a reference signed for the event's scope, else the raw value while signatures
|
|
28
|
+
* are optional. Refuses a malformed id and, when signatures are required, an unsigned one.
|
|
29
|
+
*/
|
|
30
|
+
const wireOrderId = (value, scope, check) => {
|
|
31
|
+
if (value === void 0) return { ok: true };
|
|
32
|
+
const signed = typeof value === "string" ? splitSigned(value) : void 0;
|
|
33
|
+
if (signed && check?.key && signedWith(check.key, scope, signed)) return sanitizedOrderId(signed.orderId);
|
|
34
|
+
if (check?.mode === "required") return { ok: false };
|
|
35
|
+
return sanitizedOrderId(value);
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
* `orderId` for the browser `purchase` (`<orderId>@<signature>`), bound to the tenant `scope`.
|
|
39
|
+
* Call it where the success page renders; the browser never sees the key.
|
|
40
|
+
*/
|
|
41
|
+
const signOrderId = (payload, orderId, opts = {}) => {
|
|
42
|
+
const id = sanitizeOrderId(orderId);
|
|
43
|
+
const secret = payload.secret;
|
|
44
|
+
if (id === void 0 || typeof secret !== "string" || secret === "") return;
|
|
45
|
+
return `${id}@${signatureOf(orderRefKey(secret), opts.scope ?? "", id)}`;
|
|
46
|
+
};
|
|
47
|
+
//#endregion
|
|
48
|
+
export { orderRefKey, signOrderId, wireOrderId };
|
|
49
|
+
|
|
50
|
+
//# sourceMappingURL=orderSignature.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"orderSignature.js","names":[],"sources":["../../../src/native/ingest/orderSignature.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { ITEM_SIGNATURE_SEPARATOR } from '../../goals/constants'\nimport type { OrderSignatureMode } from '../../goals/match'\nimport { isSignatureShaped } from '../../items/ref'\nimport { sanitizeOrderId } from './revenue'\nimport { labelledKey, sameSignature, shortSignature } from './signature'\n\n/** What ingest checks a page's order id against; without a key no signature is ever valid. */\nexport interface OrderSignatureCheck {\n\tmode: OrderSignatureMode\n\tkey?: Buffer\n}\n\n/** The key order ids are signed with, derived from the instance's secret. */\nexport const orderRefKey = labelledKey('analytics:order-ref:v1')\n\n/** The signature of one order id in one scope. */\nconst signatureOf = (key: Buffer, scope: string, orderId: string): string =>\n\tshortSignature(key, JSON.stringify([scope, orderId]))\n\ninterface SignedOrderId {\n\torderId: string\n\tsignature: string\n}\n\n/** A value split at its last separator when what follows it has a signature's shape. */\nconst splitSigned = (value: string): SignedOrderId | undefined => {\n\tconst at = value.lastIndexOf(ITEM_SIGNATURE_SEPARATOR)\n\tconst signature = at > 0 ? value.slice(at + 1) : ''\n\treturn isSignatureShaped(signature) ? { orderId: value.slice(0, at), signature } : undefined\n}\n\nconst signedWith = (key: Buffer, scope: string, signed: SignedOrderId): boolean =>\n\tsameSignature(signatureOf(key, scope, signed.orderId), signed.signature)\n\n/** A page's order id as ingest keeps it, or a refusal: ingest drops the sale and answers 202. */\ntype WireOrderId = { ok: true; orderId?: string } | { ok: false }\n\nconst sanitizedOrderId = (value: unknown): WireOrderId => {\n\tconst orderId = sanitizeOrderId(value)\n\treturn orderId === undefined ? { ok: false } : { ok: true, orderId }\n}\n\n/**\n * Id unwrapped from a reference signed for the event's scope, else the raw value while signatures\n * are optional. Refuses a malformed id and, when signatures are required, an unsigned one.\n */\nexport const wireOrderId = (\n\tvalue: unknown,\n\tscope: string,\n\tcheck: OrderSignatureCheck | undefined\n): WireOrderId => {\n\tif (value === undefined) {\n\t\treturn { ok: true }\n\t}\n\tconst signed = typeof value === 'string' ? splitSigned(value) : undefined\n\tif (signed && check?.key && signedWith(check.key, scope, signed)) {\n\t\treturn sanitizedOrderId(signed.orderId)\n\t}\n\tif (check?.mode === 'required') {\n\t\treturn { ok: false }\n\t}\n\treturn sanitizedOrderId(value)\n}\n\n/**\n * `orderId` for the browser `purchase` (`<orderId>@<signature>`), bound to the tenant `scope`.\n * Call it where the success page renders; the browser never sees the key.\n */\nexport const signOrderId = (\n\tpayload: Payload,\n\torderId: string,\n\topts: { scope?: string | null } = {}\n): string | undefined => {\n\tconst id = sanitizeOrderId(orderId)\n\tconst secret: unknown = payload.secret\n\tif (id === undefined || typeof secret !== 'string' || secret === '') {\n\t\treturn undefined\n\t}\n\tconst signature = signatureOf(orderRefKey(secret), opts.scope ?? '', id)\n\treturn `${id}${ITEM_SIGNATURE_SEPARATOR}${signature}`\n}\n"],"mappings":";;;;;AAcA,MAAa,cAAc,YAAY,wBAAwB;;AAG/D,MAAM,eAAe,KAAa,OAAe,YAChD,eAAe,KAAK,KAAK,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;;AAQrD,MAAM,eAAe,UAA6C;CACjE,MAAM,KAAK,MAAM,YAAA,GAAoC;CACrD,MAAM,YAAY,KAAK,IAAI,MAAM,MAAM,KAAK,CAAC,IAAI;CACjD,OAAO,kBAAkB,SAAS,IAAI;EAAE,SAAS,MAAM,MAAM,GAAG,EAAE;EAAG;CAAU,IAAI,KAAA;AACpF;AAEA,MAAM,cAAc,KAAa,OAAe,WAC/C,cAAc,YAAY,KAAK,OAAO,OAAO,OAAO,GAAG,OAAO,SAAS;AAKxE,MAAM,oBAAoB,UAAgC;CACzD,MAAM,UAAU,gBAAgB,KAAK;CACrC,OAAO,YAAY,KAAA,IAAY,EAAE,IAAI,MAAM,IAAI;EAAE,IAAI;EAAM;CAAQ;AACpE;;;;;AAMA,MAAa,eACZ,OACA,OACA,UACiB;CACjB,IAAI,UAAU,KAAA,GACb,OAAO,EAAE,IAAI,KAAK;CAEnB,MAAM,SAAS,OAAO,UAAU,WAAW,YAAY,KAAK,IAAI,KAAA;CAChE,IAAI,UAAU,OAAO,OAAO,WAAW,MAAM,KAAK,OAAO,MAAM,GAC9D,OAAO,iBAAiB,OAAO,OAAO;CAEvC,IAAI,OAAO,SAAS,YACnB,OAAO,EAAE,IAAI,MAAM;CAEpB,OAAO,iBAAiB,KAAK;AAC9B;;;;;AAMA,MAAa,eACZ,SACA,SACA,OAAkC,CAAC,MACX;CACxB,MAAM,KAAK,gBAAgB,OAAO;CAClC,MAAM,SAAkB,QAAQ;CAChC,IAAI,OAAO,KAAA,KAAa,OAAO,WAAW,YAAY,WAAW,IAChE;CAGD,OAAO,GAAG,MADQ,YAAY,YAAY,MAAM,GAAG,KAAK,SAAS,IAAI,EACnB;AACnD"}
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
//#region src/native/ingest/referrer.ts
|
|
2
|
-
/** A
|
|
2
|
+
/** A host lowercased and without `www.`, the form every referrer comparison uses. */
|
|
3
3
|
const bareHost = (host) => host.toLowerCase().replace(/^www\./, "");
|
|
4
|
+
const parsedHost = (raw) => {
|
|
5
|
+
if (typeof raw !== "string" || !raw) return;
|
|
6
|
+
try {
|
|
7
|
+
return bareHost(new URL(raw).hostname) || void 0;
|
|
8
|
+
} catch {
|
|
9
|
+
return;
|
|
10
|
+
}
|
|
11
|
+
};
|
|
4
12
|
/**
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
* so the query string routinely carries a reset token, a session id or an email address that
|
|
8
|
-
* has no business in an analytics row. Origin and path are kept verbatim, case included,
|
|
9
|
-
* because they are what makes a referrer readable. The fragment goes first: a `?` after a
|
|
10
|
-
* `#` belongs to the fragment, not to a query.
|
|
11
|
-
*
|
|
12
|
-
* An unparseable referrer is stripped on the same terms rather than trusted, and a value that
|
|
13
|
-
* is not a string at all is dropped: the wire field is public and unvalidated, so a body
|
|
14
|
-
* carrying `"referrer": {}` must cost the event its referrer, not the request its response.
|
|
13
|
+
* Referrer cut at the first `#` or `?`, then capped: a same-origin referrer's query can carry a
|
|
14
|
+
* reset token or an email address. A non-string is dropped, since the wire field is unvalidated.
|
|
15
15
|
*/
|
|
16
16
|
const storedReferrer = (raw) => {
|
|
17
17
|
if (typeof raw !== "string") return;
|
|
@@ -19,30 +19,28 @@ const storedReferrer = (raw) => {
|
|
|
19
19
|
return stripped ? stripped.slice(0, 512) : void 0;
|
|
20
20
|
};
|
|
21
21
|
/**
|
|
22
|
-
*
|
|
23
|
-
*
|
|
24
|
-
* a missing, non-string, hostless or unparseable referrer, so the event contributes no
|
|
25
|
-
* referrer bucket.
|
|
26
|
-
*
|
|
27
|
-
* A self-referral reports nothing either: internal navigation is the bulk of any site's
|
|
28
|
-
* traffic, and counting it would put the site's own domain at the top of its referrers
|
|
29
|
-
* breakdown forever. `selfHostname` is the event's own hostname, compared on the same terms
|
|
30
|
-
* (case-insensitively, `www.` stripped). The `source` dimension reads the same absence as its
|
|
31
|
-
* `direct` channel.
|
|
22
|
+
* Whether a referrer is a page of the event's own site: its own hostname, or another one its
|
|
23
|
+
* scope records hits under (`siblings`, bare hosts), compared the way {@link referrerHost} does.
|
|
32
24
|
*/
|
|
33
|
-
const
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
25
|
+
const isSiteReferral = (raw, selfHostname, siblings) => {
|
|
26
|
+
const bare = parsedHost(raw);
|
|
27
|
+
return bare !== void 0 && (bare === bareHost(selfHostname) || (siblings?.has(bare) ?? false));
|
|
28
|
+
};
|
|
29
|
+
/**
|
|
30
|
+
* Bare host the `referrer` dimension groups by; undefined when unparseable or for the site itself
|
|
31
|
+
* (`selfHostname` and `siblings`), which `source` then reads as direct.
|
|
32
|
+
*/
|
|
33
|
+
const referrerHost = (raw, selfHostname, siblings) => {
|
|
34
|
+
const bare = parsedHost(raw);
|
|
35
|
+
if (!bare || isSiteReferral(raw, selfHostname, siblings)) return;
|
|
43
36
|
return bare.slice(0, 253);
|
|
44
37
|
};
|
|
38
|
+
/** A link inside the hit's own site moves a visit along rather than opening one. */
|
|
39
|
+
const isSelfReferral = (raw, selfHostname) => {
|
|
40
|
+
const bare = parsedHost(raw);
|
|
41
|
+
return bare !== void 0 && bare === bareHost(selfHostname);
|
|
42
|
+
};
|
|
45
43
|
//#endregion
|
|
46
|
-
export { referrerHost, storedReferrer };
|
|
44
|
+
export { bareHost, isSelfReferral, isSiteReferral, referrerHost, storedReferrer };
|
|
47
45
|
|
|
48
46
|
//# sourceMappingURL=referrer.js.map
|