@10x-media/analytics 1.0.0-beta.11 → 1.0.0-beta.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +463 -0
- package/README.md +30 -37
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +7 -9
- package/dist/adapters/ga4/disableKey.js.map +1 -1
- package/dist/adapters/ga4/eventName.d.ts +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +11 -0
- package/dist/adapters/ga4/ga4.js +206 -123
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +2 -3
- package/dist/adapters/ga4/measurementId.js.map +1 -1
- package/dist/adapters/goalRead.js +15 -29
- package/dist/adapters/goalRead.js.map +1 -1
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +13 -13
- package/dist/adapters/plausible/plausible.js +137 -122
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +20 -9
- package/dist/adapters/posthog/posthog.js +179 -113
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +7 -9
- package/dist/adapters/umami/umami.js +184 -172
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +16 -29
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +48 -95
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +100 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/charts/BarList.d.ts +27 -14
- package/dist/charts/BarList.js +38 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +15 -1
- package/dist/charts/bars.js +12 -12
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +193 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +48 -37
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +26 -25
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +258 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +104 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +285 -59
- package/dist/core/contract.js +6 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +473 -157
- package/dist/core/options.js +154 -219
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +112 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +182 -72
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +38 -20
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceOptions.js +94 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +14 -0
- package/dist/exports/adapters/ga4.d.ts +15 -1
- package/dist/exports/adapters/native.d.ts +26 -2
- package/dist/exports/adapters/native.js +4 -1
- package/dist/exports/adapters/plausible.d.ts +15 -1
- package/dist/exports/adapters/posthog.d.ts +15 -1
- package/dist/exports/adapters/umami.d.ts +15 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +41 -13
- package/dist/exports/client.js +21 -9
- package/dist/exports/geo.d.ts +3 -1
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/next.d.ts +18 -1
- package/dist/exports/next.js +3 -1
- package/dist/exports/react.d.ts +3 -2
- package/dist/exports/react.js +1 -2
- package/dist/exports/rsc.d.ts +31 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +17 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +5 -20
- package/dist/exports/tracker.js +3 -14
- package/dist/exports/types.d.ts +40 -14
- package/dist/exports/types.js +5 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +20 -8
- package/dist/fields/AnalyticsPanelField.js +121 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +18 -7
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +217 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
- package/dist/fields/config/FilterDimensionSelectField.js +26 -54
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
- package/dist/fields/config/FilterOperatorSelectField.js +37 -53
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +18 -30
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.js +14 -26
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +31 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +66 -37
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +78 -26
- package/dist/fields/readForDocument.js +446 -116
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +162 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +141 -100
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -26
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +39 -40
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +154 -46
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -27
- package/dist/goals/trackGoalAction.js +38 -52
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +63 -11
- package/dist/index.js +257 -247
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +81 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.d.ts +1 -0
- package/dist/maintenance/taskSchedule.js +62 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +102 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +29 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1623 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +198 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +108 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +4 -1
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +20 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +2 -3
- package/dist/native/ingest/bots.js +8 -13
- package/dist/native/ingest/bots.js.map +1 -1
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +30 -9
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +119 -34
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +60 -7
- package/dist/native/ingest/normalizeEvent.js +226 -61
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +10 -23
- package/dist/native/ingest/requestHost.js.map +1 -1
- package/dist/native/ingest/resolveHostname.d.ts +4 -13
- package/dist/native/ingest/resolveHostname.js +5 -6
- package/dist/native/ingest/resolveHostname.js.map +1 -1
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +82 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +181 -72
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +2 -3
- package/dist/native/ingest/source.js +35 -54
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +20 -10
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +101 -33
- package/dist/native/nativeAdapter.js +375 -317
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +116 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +63 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +430 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +695 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +95 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +384 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +345 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +48 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +656 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +9 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +68 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +4 -24
- package/dist/next/captureRewrites.js +6 -50
- package/dist/next/captureRewrites.js.map +1 -1
- package/dist/next/captureRoute.d.ts +28 -0
- package/dist/next/captureRoute.js +67 -0
- package/dist/next/captureRoute.js.map +1 -0
- package/dist/next/ingestRoute.d.ts +17 -0
- package/dist/next/ingestRoute.js +17 -0
- package/dist/next/ingestRoute.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +3 -25
- package/dist/next/posthogProxyRewrites.js +5 -37
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +336 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +76 -53
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +5 -12
- package/dist/plugin/errors.js +23 -16
- package/dist/plugin/errors.js.map +1 -1
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/jobsAccess.js +91 -0
- package/dist/plugin/jobsAccess.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +155 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +69 -44
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +52 -17
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +64 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +77 -25
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +69 -44
- package/dist/plugin/refreshEndpoint.js.map +1 -1
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +226 -30
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +63 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +6 -5
- package/dist/plugin/scopeChange.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +46 -12
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +22 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +53 -0
- package/dist/providers/collection.js +274 -150
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +76 -0
- package/dist/providers/factory.js +76 -23
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +101 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +318 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +23 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +1 -5
- package/dist/query/fetchQuery.d.ts +25 -32
- package/dist/query/fetchQuery.js +91 -91
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +6 -0
- package/dist/query/parse.js +153 -106
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +26 -17
- package/dist/react/AnalyticsProvider.js +23 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -11
- package/dist/react/useAnalytics.js +22 -24
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/site/AnalyticsScripts.d.ts +34 -0
- package/dist/site/AnalyticsScripts.js +30 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +40 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +69 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -72
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.js +70 -26
- package/dist/surfacing/epoch.js.map +1 -1
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +113 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +28 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +226 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +144 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +4 -10
- package/dist/tracker/createTracker.js +386 -115
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +2 -22
- package/dist/tracker/exclusion.js +53 -21
- package/dist/tracker/exclusion.js.map +1 -1
- package/dist/tracker/gate.js +194 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +21 -14
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +118 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +38 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +64 -20
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +7 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +27 -22
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +26 -22
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +14 -12
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +30 -27
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +86 -63
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +226 -71
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +215 -69
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +209 -67
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +217 -68
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +221 -72
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +212 -67
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +185 -14
- package/dist/translations/keys.js +190 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +214 -69
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +226 -77
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +217 -66
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +217 -66
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +212 -67
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +112 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1528 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +26 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +11 -6
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +8 -10
- package/dist/view/AnalyticsView.js +47 -18
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -229
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +150 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +66 -31
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +95 -10
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +10 -9
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +196 -134
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +118 -30
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +124 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +29 -33
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +123 -82
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +47 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +64 -7
- package/dist/view/viewProps.js +121 -35
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +80 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +129 -123
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +24 -4
- package/dist/widgets/RealtimeCounter.js +91 -77
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +12 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaults.d.ts +4 -7
- package/dist/widgets/defaults.js +4 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +73 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +5 -1
- package/dist/widgets/prepareWidgetRead.js +59 -27
- package/dist/widgets/prepareWidgetRead.js.map +1 -1
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +27 -18
- package/dist/widgets/readForWidget.js +31 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
- package/dist/widgets/readForWidgetBreakdown.js +46 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +17 -23
- package/dist/widgets/readForWidgetGoals.js +50 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
- package/dist/widgets/readForWidgetRealtime.js +51 -27
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +26 -31
- package/dist/widgets/readForWidgetSeries.js +43 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +44 -0
- package/dist/widgets/readMeta.js +47 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +53 -25
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +204 -126
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +4 -3
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +31 -24
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +44 -22
- package/dist/adapters/ga4/disableKey.d.ts +0 -9
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -165
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -39
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -175
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -69
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -106
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/plugin/paths.js +0 -29
- package/dist/plugin/paths.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -29
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -20
- package/dist/tracker/sinks/posthog.d.ts +0 -18
- package/dist/tracker/sinks/umami.d.ts +0 -18
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -76
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -1,107 +1,216 @@
|
|
|
1
|
+
import { captureRequest } from "../../capture/captureRequest.js";
|
|
2
|
+
import { kindOf } from "../../core/values.js";
|
|
3
|
+
import { currentDate } from "../../core/clock.js";
|
|
1
4
|
import { getRuntime } from "../../plugin/runtime.js";
|
|
5
|
+
import { overlayClientIp } from "./clientIp.js";
|
|
6
|
+
import { warnUntrustedForwarding } from "../../capture/requestTrust.js";
|
|
7
|
+
import { gateHoldsAdapter } from "../../capture/slots.js";
|
|
8
|
+
import { openTransactionOf } from "../../db/openTransaction.js";
|
|
2
9
|
import { AnalyticsTrackError } from "../../core/serverEvent.js";
|
|
10
|
+
import { dedupeKeyFor, isRefund, orderDigestKey, sanitizeOrderId, warnUnconvertedOnce, warnUnmatchedRevenueGoal } from "./revenue.js";
|
|
11
|
+
import { orderHitId, wireTwinOf } from "../store/ids.js";
|
|
12
|
+
import { SERVER_CLOCK_SKEW_MS } from "../engine/engine.js";
|
|
13
|
+
import { saltForHit } from "../engine/salt.js";
|
|
14
|
+
import { referrerHost } from "./referrer.js";
|
|
15
|
+
import { toHit } from "../engine/toHit.js";
|
|
3
16
|
import { SERVER_USER_AGENT } from "./device.js";
|
|
4
|
-
import { flushBatch } from "./flushBatch.js";
|
|
5
|
-
import { normalizeEvent } from "./normalizeEvent.js";
|
|
6
|
-
import { dailySalt } from "./salt.js";
|
|
7
17
|
import { rawEventError } from "./validate.js";
|
|
18
|
+
import { normalizeEvent } from "./normalizeEvent.js";
|
|
8
19
|
import { createLocalReq } from "payload";
|
|
9
20
|
//#region src/native/ingest/serverTrack.ts
|
|
21
|
+
/** A warning each instance logs once, so a busy webhook says it once. */
|
|
22
|
+
const warningOncePer = (message) => {
|
|
23
|
+
const warned = /* @__PURE__ */ new WeakSet();
|
|
24
|
+
return (payload) => {
|
|
25
|
+
if (warned.has(payload)) return;
|
|
26
|
+
warned.add(payload);
|
|
27
|
+
payload.logger?.warn(message);
|
|
28
|
+
};
|
|
29
|
+
};
|
|
30
|
+
const warnUnresolvedZone = warningOncePer("analytics: trackServerEvent hashes visitors by the UTC day for a scope whose reportingTimezone has never resolved: the resolver throws or answers something that is not an IANA timezone. Check that resolver, or pass event.timezone. Logged once.");
|
|
31
|
+
/** Ids of a sale's browser and server records, which a refund of it looks up. */
|
|
32
|
+
const saleRecordsOf = (sale) => {
|
|
33
|
+
const parts = {
|
|
34
|
+
...sale.scope ? { tenant: sale.scope } : {},
|
|
35
|
+
goal: sale.goal,
|
|
36
|
+
orderId: sale.orderId,
|
|
37
|
+
...sale.key ? { key: sale.key } : {}
|
|
38
|
+
};
|
|
39
|
+
return {
|
|
40
|
+
wire: orderHitId(dedupeKeyFor({
|
|
41
|
+
origin: "wire",
|
|
42
|
+
...parts
|
|
43
|
+
})),
|
|
44
|
+
server: orderHitId(dedupeKeyFor({
|
|
45
|
+
origin: "server",
|
|
46
|
+
...parts
|
|
47
|
+
}))
|
|
48
|
+
};
|
|
49
|
+
};
|
|
50
|
+
const isIdentity = (value) => value === "request" || value === "none";
|
|
51
|
+
/**
|
|
52
|
+
* The identity of a call that names none: no visitor's while `capture.gate` holds a slot the
|
|
53
|
+
* native beacon may fill, since the server cannot know the visitor's answer; else the request's.
|
|
54
|
+
*/
|
|
55
|
+
const defaultIdentity = (payload) => {
|
|
56
|
+
const runtime = getRuntime(payload);
|
|
57
|
+
const adapter = ingestAdapter(payload);
|
|
58
|
+
if (!runtime || !adapter) return "request";
|
|
59
|
+
const kind = adapter.capture?.client.kind ?? "native";
|
|
60
|
+
return gateHoldsAdapter(runtime, adapter.id, kind) ? "none" : "request";
|
|
61
|
+
};
|
|
62
|
+
/** An explicit `ip` or `userAgent` that the gated default set aside. */
|
|
63
|
+
const warnIgnoredVisitor = warningOncePer("analytics: trackServerEvent was given an ip or a userAgent but no identity, and capture.gate holds the native slot, so the event is recorded as no visitor's. Pass identity: 'request' where you know the visitor's answer allows it. Logged once.");
|
|
64
|
+
/**
|
|
65
|
+
* A scoped sale with neither `scope` nor `req` is filed under no tenant. Warned, never thrown: a
|
|
66
|
+
* platform may record its own sales under the null scope on purpose.
|
|
67
|
+
*/
|
|
68
|
+
const warnUnscopedSale = warningOncePer("analytics: purchase or refund was called on a scoped install with neither scope nor req, so the sale is filed under the null scope: no tenant reports it, and the browser's record of the order never meets it. Pass scope (the tenant) or req. Logged once.");
|
|
10
69
|
/**
|
|
11
|
-
* The originating request's
|
|
12
|
-
*
|
|
13
|
-
* visitor hashes to the same person. Explicit `ip` / `userAgent` overlay them.
|
|
14
|
-
*
|
|
15
|
-
* With no request and no user agent the synthetic server agent stands in, which hashes every
|
|
16
|
-
* such event in a day to one visitor per site and reports no device at all.
|
|
70
|
+
* The originating request's headers, so a server event attributes like its browser twin; `ip` and
|
|
71
|
+
* `userAgent` override them. With neither, or `identity: 'none'`, the server agent stands in.
|
|
17
72
|
*/
|
|
18
|
-
const attributionHeaders = (event,
|
|
19
|
-
const
|
|
20
|
-
if (
|
|
73
|
+
const attributionHeaders = (event, trust, behind) => {
|
|
74
|
+
const { identity, req } = behind;
|
|
75
|
+
if (identity === "none") return new Headers({ "user-agent": SERVER_USER_AGENT });
|
|
76
|
+
const own = new Headers(req?.headers);
|
|
77
|
+
const headers = event.ip ? overlayClientIp(own, event.ip, trust) : own;
|
|
21
78
|
if (event.userAgent) headers.set("user-agent", event.userAgent);
|
|
22
79
|
if (!headers.get("user-agent")) headers.set("user-agent", SERVER_USER_AGENT);
|
|
23
80
|
return headers;
|
|
24
81
|
};
|
|
82
|
+
/**
|
|
83
|
+
* The caller's scope, else the request's resolved without the signed-in user or cookies, so an
|
|
84
|
+
* editor's sale is filed under the site it happened on.
|
|
85
|
+
*/
|
|
25
86
|
const resolveScope = async (event, opts, resolvers) => {
|
|
26
87
|
if (!resolvers.scope) return;
|
|
27
88
|
if (event.scope !== void 0) return event.scope ?? "";
|
|
28
89
|
if (!opts?.req) return "";
|
|
29
|
-
return await resolvers.scope(opts.req) ?? "";
|
|
90
|
+
return await resolvers.scope(captureRequest(opts.req)) ?? "";
|
|
30
91
|
};
|
|
31
92
|
/**
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
* scope resolution differ, since there may be no request behind the event at all.
|
|
93
|
+
* `adapter.ingest.track`: the endpoint's write path, outside any caller transaction. On SQLite a
|
|
94
|
+
* call inside an open transaction resolves at once and stores its hit when that transaction ends.
|
|
35
95
|
*/
|
|
36
|
-
const makeServerTrack = (deps) => async (event, opts) => {
|
|
37
|
-
const
|
|
38
|
-
|
|
39
|
-
|
|
96
|
+
const makeServerTrack = (deps) => async (payload, event, opts) => {
|
|
97
|
+
const invalid = rawEventError(event, {
|
|
98
|
+
allowRevenue: true,
|
|
99
|
+
requireHostname: true
|
|
100
|
+
});
|
|
40
101
|
if (invalid) throw new AnalyticsTrackError(`analytics: trackServerEvent needs a valid "${invalid}"`);
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
102
|
+
if (event.orderId !== void 0 && sanitizeOrderId(event.orderId) === void 0) throw new AnalyticsTrackError(`analytics: trackServerEvent needs a valid "orderId": a string of 1 to 255 characters without control characters, so a retried order counts once`);
|
|
103
|
+
if (isRefund(event.revenue === true, event.value) && sanitizeOrderId(event.orderId) !== void 0 && sanitizeOrderId(event.refundId) === void 0) throw new AnalyticsTrackError("analytics: trackServerEvent needs a valid \"refundId\" on a refund of an order: the refund's own id, so each partial refund counts once");
|
|
104
|
+
if (opts?.identity !== void 0 && !isIdentity(opts.identity)) throw new AnalyticsTrackError(`analytics: trackServerEvent's identity must be 'request' or 'none', got ${kindOf(opts.identity)}`);
|
|
105
|
+
if (event.now !== void 0 && !(event.now instanceof Date && Number.isFinite(event.now.getTime()))) throw new AnalyticsTrackError("analytics: trackServerEvent needs a valid \"now\"");
|
|
106
|
+
const identity = opts?.identity ?? defaultIdentity(payload);
|
|
107
|
+
if (opts?.identity === void 0 && identity === "none" && (event.ip || event.userAgent)) warnIgnoredVisitor(payload);
|
|
108
|
+
const receivedAt = currentDate();
|
|
109
|
+
const now = event.now ?? receivedAt;
|
|
110
|
+
if (now.getTime() > receivedAt.getTime() + 3e5) throw new AnalyticsTrackError(`analytics: trackServerEvent's "now" (${now.toISOString()}) is more than ${SERVER_CLOCK_SKEW_MS / 6e4} minutes ahead of the server's clock`);
|
|
111
|
+
const target = deps.target(payload);
|
|
112
|
+
if (event.revenue === true && event.scope === void 0 && !opts?.req && deps.getResolvers().scope) warnUnscopedSale(payload);
|
|
113
|
+
const record = async () => {
|
|
114
|
+
const resolvers = deps.getResolvers();
|
|
115
|
+
const scope = await resolveScope(event, opts, resolvers);
|
|
116
|
+
const placed = await target.engine?.serverHitDay(scope ?? "", now);
|
|
117
|
+
let local;
|
|
118
|
+
const requestFor = async () => {
|
|
119
|
+
if (opts?.req) return captureRequest(opts.req);
|
|
120
|
+
local ??= await createLocalReq({}, payload);
|
|
121
|
+
return local;
|
|
122
|
+
};
|
|
123
|
+
const salt = await saltForHit(target.salts, {
|
|
124
|
+
scope: scope ?? "",
|
|
125
|
+
at: now,
|
|
126
|
+
zone: async () => event.timezone ?? (resolvers.timezone ? resolvers.timezone(await requestFor(), scope ?? null) : "UTC")
|
|
127
|
+
}, () => warnUnresolvedZone(payload));
|
|
128
|
+
const goals = resolvers.goals ? await resolvers.goals(await requestFor(), scope ?? null) : void 0;
|
|
129
|
+
const reportingCurrency = resolvers.currency ? await resolvers.currency(await requestFor(), scope ?? null) : void 0;
|
|
130
|
+
const attribution = deps.getAttribution();
|
|
131
|
+
const orderKey = orderDigestKey(payload.secret);
|
|
132
|
+
const trust = {
|
|
133
|
+
trustedProxyHops: attribution.trustedProxyHops,
|
|
134
|
+
trustedPlatform: attribution.trustedPlatform
|
|
135
|
+
};
|
|
136
|
+
if (opts?.req && !event.ip && identity !== "none") warnUntrustedForwarding(payload, opts.req.headers, trust);
|
|
137
|
+
const siblings = target.siteHosts && event.type === "pageview" && referrerHost(event.referrer, event.hostname) !== void 0 ? await target.siteHosts.of(scope ?? "") : void 0;
|
|
138
|
+
const normalized = await normalizeEvent({
|
|
139
|
+
raw: {
|
|
140
|
+
type: event.type,
|
|
141
|
+
name: event.name,
|
|
142
|
+
path: event.path,
|
|
143
|
+
referrer: event.referrer,
|
|
144
|
+
query: event.query,
|
|
145
|
+
props: event.props,
|
|
146
|
+
value: event.value,
|
|
147
|
+
currency: event.currency,
|
|
148
|
+
items: event.items,
|
|
149
|
+
revenue: event.revenue,
|
|
150
|
+
orderId: event.orderId,
|
|
151
|
+
refundId: event.refundId,
|
|
152
|
+
item: event.item
|
|
153
|
+
},
|
|
154
|
+
hostname: event.hostname,
|
|
155
|
+
headers: attributionHeaders(event, trust, {
|
|
156
|
+
identity,
|
|
157
|
+
req: opts?.req
|
|
158
|
+
}),
|
|
159
|
+
geoResolver: deps.geoResolver,
|
|
160
|
+
warnGeo: (message) => payload.logger?.warn(message),
|
|
161
|
+
salt,
|
|
162
|
+
now,
|
|
163
|
+
scope,
|
|
164
|
+
goals,
|
|
165
|
+
origin: "server",
|
|
166
|
+
reportingCurrency,
|
|
167
|
+
convertCurrency: resolvers.convertCurrency,
|
|
168
|
+
warnUnconverted: () => warnUnconvertedOnce(payload.logger),
|
|
169
|
+
...trust,
|
|
170
|
+
...target.items ? { items: target.items } : {},
|
|
171
|
+
...siblings ? { siblings } : {},
|
|
172
|
+
orderKey
|
|
173
|
+
});
|
|
174
|
+
if (event.revenue === true && normalized.goals === void 0) warnUnmatchedRevenueGoal(payload.logger, event.name ?? event.type);
|
|
175
|
+
const late = placed?.closed === true;
|
|
176
|
+
const counted = toHit(normalized, { receivedAt });
|
|
177
|
+
const orderId = sanitizeOrderId(event.orderId);
|
|
178
|
+
const hit = normalized.refund && counted.v === "" && orderId !== void 0 && target.engine ? {
|
|
179
|
+
...counted,
|
|
180
|
+
...await target.engine.saleAttribution(scope ?? "", saleRecordsOf({
|
|
181
|
+
scope,
|
|
182
|
+
goal: normalized.name ?? normalized.type,
|
|
183
|
+
orderId,
|
|
184
|
+
key: orderKey
|
|
185
|
+
}))
|
|
186
|
+
} : counted;
|
|
187
|
+
const stored = await target.writer.write(hit, { ...opts?.flush || late ? { flush: true } : {} });
|
|
188
|
+
target.siteHosts?.saw(scope ?? "", normalized.hostname);
|
|
189
|
+
const fresh = stored === void 0 || stored.written > 0;
|
|
190
|
+
if (placed && late && fresh) await target.engine?.reopen(placed);
|
|
191
|
+
if (wireTwinOf(hit.id) !== void 0 && !normalized.refund && fresh) await target.engine?.orderStored(scope ?? "", hit.id);
|
|
48
192
|
};
|
|
49
|
-
const
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
const stored = await normalizeEvent({
|
|
53
|
-
raw: {
|
|
54
|
-
type: event.type,
|
|
55
|
-
name: event.name,
|
|
56
|
-
path: event.path,
|
|
57
|
-
referrer: event.referrer,
|
|
58
|
-
query: event.query,
|
|
59
|
-
props: event.props,
|
|
60
|
-
value: event.value,
|
|
61
|
-
currency: event.currency
|
|
62
|
-
},
|
|
63
|
-
hostname: event.hostname,
|
|
64
|
-
headers: attributionHeaders(event, opts?.req),
|
|
65
|
-
geoResolver: deps.geoResolver,
|
|
66
|
-
salt: await dailySalt(payload, now),
|
|
67
|
-
now,
|
|
68
|
-
scope,
|
|
69
|
-
timezone,
|
|
70
|
-
goals,
|
|
71
|
-
trustedProxyHops: deps.getAttribution().trustedProxyHops
|
|
72
|
-
});
|
|
73
|
-
const buffer = deps.getBuffer();
|
|
74
|
-
if (!buffer) {
|
|
75
|
-
await flushBatch(payload, [stored]);
|
|
193
|
+
const open = target.sqlite ? await openTransactionOf(payload, opts?.req) : void 0;
|
|
194
|
+
if (open) {
|
|
195
|
+
target.writer.defer(record, open);
|
|
76
196
|
return;
|
|
77
197
|
}
|
|
78
|
-
|
|
79
|
-
|
|
198
|
+
await record();
|
|
199
|
+
target.nudge?.();
|
|
80
200
|
};
|
|
81
201
|
/**
|
|
82
|
-
*
|
|
83
|
-
*
|
|
84
|
-
* goal action applies) reads it off this same adapter, so an event cannot be judged by one
|
|
85
|
-
* adapter and written by another. The registry here is the static config one, so a per-tenant
|
|
86
|
-
* runtime provider never supplies either seam.
|
|
202
|
+
* First registered adapter with a server ingestion seam. Callers read every other seam off it too,
|
|
203
|
+
* so an event cannot be judged by one adapter and written by another.
|
|
87
204
|
*/
|
|
88
205
|
const ingestAdapter = (payload) => getRuntime(payload)?.registry.all().find((adapter) => adapter.ingest?.track);
|
|
89
206
|
/**
|
|
90
|
-
* Records an
|
|
91
|
-
*
|
|
92
|
-
* Pass `opts.req` whenever there is a request behind the event, so it inherits that request's
|
|
93
|
-
* attribution, scope and reporting timezone.
|
|
94
|
-
*
|
|
95
|
-
* `event.scope` overrides the request's scope; it is ignored on an unscoped install and is
|
|
96
|
-
* never checked against the scopes that exist, so the caller owns what it stamps.
|
|
97
|
-
*
|
|
98
|
-
* Needs the native adapter: a provider slot (Plausible, GA4) has no server ingestion seam
|
|
99
|
-
* here yet, so an install without the native adapter throws rather than dropping the event.
|
|
207
|
+
* Records an event from server code through the native adapter, normalized as a beacon is. Without
|
|
208
|
+
* `opts.identity` it is no visitor's while `capture.gate` holds the native slot.
|
|
100
209
|
*/
|
|
101
210
|
const trackServerEvent = async (payload, event, opts) => {
|
|
102
211
|
const track = ingestAdapter(payload)?.ingest?.track;
|
|
103
212
|
if (!track) throw new AnalyticsTrackError("analytics: trackServerEvent needs the native adapter; provider-slot server tracking is not supported yet");
|
|
104
|
-
await track(event, opts);
|
|
213
|
+
await track(payload, event, opts);
|
|
105
214
|
};
|
|
106
215
|
//#endregion
|
|
107
216
|
export { ingestAdapter, makeServerTrack, trackServerEvent };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"serverTrack.js","names":[],"sources":["../../../src/native/ingest/serverTrack.ts"],"sourcesContent":["import { createLocalReq, type Payload, type PayloadRequest } from 'payload'\nimport type { AnalyticsAdapter } from '../../core/contract'\nimport {\n\tAnalyticsTrackError,\n\ttype ServerEventInput,\n\ttype ServerTrack,\n\ttype ServerTrackOptions,\n} from '../../core/serverEvent'\nimport { getRuntime } from '../../plugin/runtime'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { SERVER_USER_AGENT } from './device'\nimport type { IngestAttribution, IngestResolvers } from './endpoint'\nimport { flushBatch } from './flushBatch'\nimport { normalizeEvent, type StoredEvent } from './normalizeEvent'\nimport { dailySalt } from './salt'\nimport { rawEventError } from './validate'\nimport type { WriteBuffer } from './writeBuffer'\n\nexport interface ServerTrackDeps {\n\t/** Null until the adapter's onInit has run. */\n\tgetPayload: () => Payload | null\n\tgeoResolver: GeoResolver\n\tgetBuffer: () => WriteBuffer<StoredEvent> | null\n\t/** Read late: the register context that carries them arrives after the adapter is built. */\n\tgetResolvers: () => IngestResolvers\n\t/** Read late for the same reason: the plugin option arrives with the register context. */\n\tgetAttribution: () => IngestAttribution\n}\n\n/**\n * The originating request's own headers, so a server event attributes exactly like the\n * browser event it stands in for: the platform's geo headers reach the geo resolver and the\n * visitor hashes to the same person. Explicit `ip` / `userAgent` overlay them.\n *\n * With no request and no user agent the synthetic server agent stands in, which hashes every\n * such event in a day to one visitor per site and reports no device at all.\n */\nconst attributionHeaders = (event: ServerEventInput, req?: PayloadRequest): Headers => {\n\tconst headers = new Headers(req?.headers)\n\tif (event.ip) {\n\t\theaders.set('x-forwarded-for', event.ip)\n\t}\n\tif (event.userAgent) {\n\t\theaders.set('user-agent', event.userAgent)\n\t}\n\tif (!headers.get('user-agent')) {\n\t\theaders.set('user-agent', SERVER_USER_AGENT)\n\t}\n\treturn headers\n}\n\nconst resolveScope = async (\n\tevent: ServerEventInput,\n\topts: ServerTrackOptions | undefined,\n\tresolvers: IngestResolvers\n): Promise<string | undefined> => {\n\t// An unscoped install has no scope resolver and no scope field on its rows, so a scope\n\t// declared by the caller is ignored exactly as the endpoint ignores one on the wire.\n\tif (!resolvers.scope) {\n\t\treturn undefined\n\t}\n\tif (event.scope !== undefined) {\n\t\treturn event.scope ?? ''\n\t}\n\tif (!opts?.req) {\n\t\treturn ''\n\t}\n\treturn (await resolvers.scope(opts.req)) ?? ''\n}\n\n/**\n * The native adapter's server-side ingestion, exposed as `adapter.ingest.track`. Same\n * normalization, goal matching and write path the HTTP endpoint uses; only attribution and\n * scope resolution differ, since there may be no request behind the event at all.\n */\nexport const makeServerTrack =\n\t(deps: ServerTrackDeps): ServerTrack =>\n\tasync (event, opts) => {\n\t\tconst payload = deps.getPayload()\n\t\tif (!payload) {\n\t\t\tthrow new AnalyticsTrackError('analytics: trackServerEvent called before init')\n\t\t}\n\t\t// Trusted server code: it supplies its own hostname, so the resolver the HTTP endpoint\n\t\t// runs is bypassed and the hostname stays required here.\n\t\tconst invalid = rawEventError(event, { requireHostname: true })\n\t\tif (invalid) {\n\t\t\tthrow new AnalyticsTrackError(`analytics: trackServerEvent needs a valid \"${invalid}\"`)\n\t\t}\n\t\tconst resolvers = deps.getResolvers()\n\t\tconst scope = await resolveScope(event, opts, resolvers)\n\t\t// createLocalReq mutates the request it is given, so a caller's own req is passed\n\t\t// through untouched and a fresh one is built only when a resolver needs it.\n\t\tlet local: PayloadRequest | undefined\n\t\tconst requestFor = async (): Promise<PayloadRequest> => {\n\t\t\tif (opts?.req) {\n\t\t\t\treturn opts.req\n\t\t\t}\n\t\t\tlocal ??= await createLocalReq({}, payload)\n\t\t\treturn local\n\t\t}\n\t\tconst timezone =\n\t\t\tevent.timezone ??\n\t\t\t(resolvers.timezone ? await resolvers.timezone(await requestFor(), scope ?? null) : undefined)\n\t\t// Goals resolve under the scope the event is stamped with, so a tenant's server event\n\t\t// can only ever complete that tenant's goals.\n\t\tconst goals = resolvers.goals\n\t\t\t? await resolvers.goals(await requestFor(), scope ?? null)\n\t\t\t: undefined\n\t\tconst now = event.now ?? new Date()\n\t\tconst stored = await normalizeEvent({\n\t\t\traw: {\n\t\t\t\ttype: event.type,\n\t\t\t\tname: event.name,\n\t\t\t\tpath: event.path,\n\t\t\t\treferrer: event.referrer,\n\t\t\t\tquery: event.query,\n\t\t\t\tprops: event.props,\n\t\t\t\tvalue: event.value,\n\t\t\t\tcurrency: event.currency,\n\t\t\t},\n\t\t\thostname: event.hostname,\n\t\t\theaders: attributionHeaders(event, opts?.req),\n\t\t\tgeoResolver: deps.geoResolver,\n\t\t\tsalt: await dailySalt(payload, now),\n\t\t\tnow,\n\t\t\tscope,\n\t\t\ttimezone,\n\t\t\tgoals,\n\t\t\ttrustedProxyHops: deps.getAttribution().trustedProxyHops,\n\t\t})\n\t\tconst buffer = deps.getBuffer()\n\t\tif (!buffer) {\n\t\t\tawait flushBatch(payload, [stored])\n\t\t\treturn\n\t\t}\n\t\tbuffer.add(stored)\n\t\tif (opts?.flush) {\n\t\t\tawait buffer.flush()\n\t\t}\n\t}\n\n/**\n * The adapter {@link trackServerEvent} writes through: the first registered one with a server\n * ingestion seam. Every caller that needs a second seam beside `track` (the hostname policy a\n * goal action applies) reads it off this same adapter, so an event cannot be judged by one\n * adapter and written by another. The registry here is the static config one, so a per-tenant\n * runtime provider never supplies either seam.\n */\nexport const ingestAdapter = (payload: Payload): AnalyticsAdapter | undefined =>\n\tgetRuntime(payload)\n\t\t?.registry.all()\n\t\t.find((adapter) => adapter.ingest?.track)\n\n/**\n * Records an analytics event from server code: a webhook, a job, a server action. The event\n * goes through the same normalization, sanitization and goal matching a browser event does.\n * Pass `opts.req` whenever there is a request behind the event, so it inherits that request's\n * attribution, scope and reporting timezone.\n *\n * `event.scope` overrides the request's scope; it is ignored on an unscoped install and is\n * never checked against the scopes that exist, so the caller owns what it stamps.\n *\n * Needs the native adapter: a provider slot (Plausible, GA4) has no server ingestion seam\n * here yet, so an install without the native adapter throws rather than dropping the event.\n */\nexport const trackServerEvent = async (\n\tpayload: Payload,\n\tevent: ServerEventInput,\n\topts?: ServerTrackOptions\n): Promise<void> => {\n\tconst track = ingestAdapter(payload)?.ingest?.track\n\tif (!track) {\n\t\tthrow new AnalyticsTrackError(\n\t\t\t'analytics: trackServerEvent needs the native adapter; provider-slot server tracking is not supported yet'\n\t\t)\n\t}\n\tawait track(event, opts)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAqCA,MAAM,sBAAsB,OAAyB,QAAkC;CACtF,MAAM,UAAU,IAAI,QAAQ,KAAK,OAAO;CACxC,IAAI,MAAM,IACT,QAAQ,IAAI,mBAAmB,MAAM,EAAE;CAExC,IAAI,MAAM,WACT,QAAQ,IAAI,cAAc,MAAM,SAAS;CAE1C,IAAI,CAAC,QAAQ,IAAI,YAAY,GAC5B,QAAQ,IAAI,cAAc,iBAAiB;CAE5C,OAAO;AACR;AAEA,MAAM,eAAe,OACpB,OACA,MACA,cACiC;CAGjC,IAAI,CAAC,UAAU,OACd;CAED,IAAI,MAAM,UAAU,KAAA,GACnB,OAAO,MAAM,SAAS;CAEvB,IAAI,CAAC,MAAM,KACV,OAAO;CAER,OAAQ,MAAM,UAAU,MAAM,KAAK,GAAG,KAAM;AAC7C;;;;;;AAOA,MAAa,mBACX,SACD,OAAO,OAAO,SAAS;CACtB,MAAM,UAAU,KAAK,WAAW;CAChC,IAAI,CAAC,SACJ,MAAM,IAAI,oBAAoB,gDAAgD;CAI/E,MAAM,UAAU,cAAc,OAAO,EAAE,iBAAiB,KAAK,CAAC;CAC9D,IAAI,SACH,MAAM,IAAI,oBAAoB,8CAA8C,QAAQ,EAAE;CAEvF,MAAM,YAAY,KAAK,aAAa;CACpC,MAAM,QAAQ,MAAM,aAAa,OAAO,MAAM,SAAS;CAGvD,IAAI;CACJ,MAAM,aAAa,YAAqC;EACvD,IAAI,MAAM,KACT,OAAO,KAAK;EAEb,UAAU,MAAM,eAAe,CAAC,GAAG,OAAO;EAC1C,OAAO;CACR;CACA,MAAM,WACL,MAAM,aACL,UAAU,WAAW,MAAM,UAAU,SAAS,MAAM,WAAW,GAAG,SAAS,IAAI,IAAI,KAAA;CAGrF,MAAM,QAAQ,UAAU,QACrB,MAAM,UAAU,MAAM,MAAM,WAAW,GAAG,SAAS,IAAI,IACvD,KAAA;CACH,MAAM,MAAM,MAAM,uBAAO,IAAI,KAAK;CAClC,MAAM,SAAS,MAAM,eAAe;EACnC,KAAK;GACJ,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,OAAO,MAAM;GACb,OAAO,MAAM;GACb,OAAO,MAAM;GACb,UAAU,MAAM;EACjB;EACA,UAAU,MAAM;EAChB,SAAS,mBAAmB,OAAO,MAAM,GAAG;EAC5C,aAAa,KAAK;EAClB,MAAM,MAAM,UAAU,SAAS,GAAG;EAClC;EACA;EACA;EACA;EACA,kBAAkB,KAAK,eAAe,EAAE;CACzC,CAAC;CACD,MAAM,SAAS,KAAK,UAAU;CAC9B,IAAI,CAAC,QAAQ;EACZ,MAAM,WAAW,SAAS,CAAC,MAAM,CAAC;EAClC;CACD;CACA,OAAO,IAAI,MAAM;CACjB,IAAI,MAAM,OACT,MAAM,OAAO,MAAM;AAErB;;;;;;;;AASD,MAAa,iBAAiB,YAC7B,WAAW,OAAO,GACf,SAAS,IAAI,EACd,MAAM,YAAY,QAAQ,QAAQ,KAAK;;;;;;;;;;;;;AAc1C,MAAa,mBAAmB,OAC/B,SACA,OACA,SACmB;CACnB,MAAM,QAAQ,cAAc,OAAO,GAAG,QAAQ;CAC9C,IAAI,CAAC,OACJ,MAAM,IAAI,oBACT,0GACD;CAED,MAAM,MAAM,OAAO,IAAI;AACxB"}
|
|
1
|
+
{"version":3,"file":"serverTrack.js","names":[],"sources":["../../../src/native/ingest/serverTrack.ts"],"sourcesContent":["import { createLocalReq, type Payload, type PayloadRequest } from 'payload'\nimport { captureRequest } from '../../capture/captureRequest'\nimport { warnUntrustedForwarding } from '../../capture/requestTrust'\nimport { gateHoldsAdapter } from '../../capture/slots'\nimport { currentDate } from '../../core/clock'\nimport type { AnalyticsAdapter } from '../../core/contract'\nimport {\n\tAnalyticsTrackError,\n\ttype ServerEventInput,\n\ttype ServerTrack,\n\ttype ServerTrackIdentity,\n\ttype ServerTrackOptions,\n} from '../../core/serverEvent'\nimport { kindOf } from '../../core/values'\nimport { openTransactionOf } from '../../db/openTransaction'\nimport { getRuntime } from '../../plugin/runtime'\nimport { DEFAULT_TIMEZONE } from '../../timeframe/tz'\nimport { type NativeEngine, SERVER_CLOCK_SKEW_MS } from '../engine/engine'\nimport { type DailySalts, saltForHit } from '../engine/salt'\nimport type { SiteHosts } from '../engine/siteHosts'\nimport { toHit } from '../engine/toHit'\nimport type { HitWriter } from '../engine/writeBuffer'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { orderHitId, wireTwinOf } from '../store/ids'\nimport { type ClientIpOptions, overlayClientIp } from './clientIp'\nimport { SERVER_USER_AGENT } from './device'\nimport type { IngestAttribution, IngestResolvers } from './endpoint'\nimport { type ItemIngestOptions, normalizeEvent } from './normalizeEvent'\nimport { referrerHost } from './referrer'\nimport {\n\tdedupeKeyFor,\n\tisRefund,\n\tMAX_ORDER_ID_LENGTH,\n\torderDigestKey,\n\tsanitizeOrderId,\n\twarnUnconvertedOnce,\n\twarnUnmatchedRevenueGoal,\n} from './revenue'\nimport { rawEventError } from './validate'\n\n/** A warning each instance logs once, so a busy webhook says it once. */\nconst warningOncePer = (message: string): ((payload: Payload) => void) => {\n\tconst warned = new WeakSet<Payload>()\n\treturn (payload) => {\n\t\tif (warned.has(payload)) {\n\t\t\treturn\n\t\t}\n\t\twarned.add(payload)\n\t\tpayload.logger?.warn(message)\n\t}\n}\n\nconst warnUnresolvedZone = warningOncePer(\n\t'analytics: trackServerEvent hashes visitors by the UTC day for a scope whose reportingTimezone has never resolved: the resolver throws or answers something that is not an IANA timezone. Check that resolver, or pass event.timezone. Logged once.'\n)\n\n/** Ids of a sale's browser and server records, which a refund of it looks up. */\nconst saleRecordsOf = (sale: {\n\tscope: string | undefined\n\tgoal: string\n\torderId: string\n\tkey: Buffer | undefined\n}): { wire: string; server: string } => {\n\tconst parts = {\n\t\t...(sale.scope ? { tenant: sale.scope } : {}),\n\t\tgoal: sale.goal,\n\t\torderId: sale.orderId,\n\t\t...(sale.key ? { key: sale.key } : {}),\n\t}\n\treturn {\n\t\twire: orderHitId(dedupeKeyFor({ origin: 'wire', ...parts })),\n\t\tserver: orderHitId(dedupeKeyFor({ origin: 'server', ...parts })),\n\t}\n}\n\nconst isIdentity = (value: unknown): value is ServerTrackIdentity =>\n\tvalue === 'request' || value === 'none'\n\n/**\n * The identity of a call that names none: no visitor's while `capture.gate` holds a slot the\n * native beacon may fill, since the server cannot know the visitor's answer; else the request's.\n */\nconst defaultIdentity = (payload: Payload): ServerTrackIdentity => {\n\tconst runtime = getRuntime(payload)\n\tconst adapter = ingestAdapter(payload)\n\tif (!runtime || !adapter) {\n\t\treturn 'request'\n\t}\n\tconst kind = adapter.capture?.client.kind ?? 'native'\n\treturn gateHoldsAdapter(runtime, adapter.id, kind) ? 'none' : 'request'\n}\n\n/** An explicit `ip` or `userAgent` that the gated default set aside. */\nconst warnIgnoredVisitor = warningOncePer(\n\t\"analytics: trackServerEvent was given an ip or a userAgent but no identity, and capture.gate holds the native slot, so the event is recorded as no visitor's. Pass identity: 'request' where you know the visitor's answer allows it. Logged once.\"\n)\n\n/**\n * A scoped sale with neither `scope` nor `req` is filed under no tenant. Warned, never thrown: a\n * platform may record its own sales under the null scope on purpose.\n */\nconst warnUnscopedSale = warningOncePer(\n\t\"analytics: purchase or refund was called on a scoped install with neither scope nor req, so the sale is filed under the null scope: no tenant reports it, and the browser's record of the order never meets it. Pass scope (the tenant) or req. Logged once.\"\n)\n\n/** What one Payload instance stores a server event's hit through. */\nexport interface ServerTrackTarget {\n\tsalts: Pick<DailySalts, 'forHit' | 'forDay'>\n\twriter: Pick<HitWriter, 'write' | 'defer'>\n\titems?: ItemIngestOptions\n\t/** SQLite's single writer: a hit recorded inside an open host transaction waits for it. */\n\tsqlite: boolean\n\t/** Asks for maintenance in the background after a hit; it never waits for it. */\n\tnudge?: () => void\n\t/**\n\t * Refuses hits at or before the raw floor day, recounts a closed day a hit lands on, and says\n\t * where a refund's sale counts so the refund is filed beside it.\n\t */\n\tengine?: Pick<NativeEngine, 'serverHitDay' | 'reopen' | 'orderStored' | 'saleAttribution'>\n\t/** The hostnames each scope records hits under; absent, only the event's own is the site's. */\n\tsiteHosts?: SiteHosts\n}\n\ninterface ServerTrackDeps {\n\tgeoResolver: GeoResolver\n\t/** The salts, writer and items of the instance an event is recorded on. */\n\ttarget: (payload: Payload) => ServerTrackTarget\n\t/** Read late: the register context that carries them arrives after the adapter is built. */\n\tgetResolvers: () => IngestResolvers\n\t/** Read late for the same reason: the plugin option arrives with the register context. */\n\tgetAttribution: () => IngestAttribution\n}\n\n/**\n * The originating request's headers, so a server event attributes like its browser twin; `ip` and\n * `userAgent` override them. With neither, or `identity: 'none'`, the server agent stands in.\n */\nconst attributionHeaders = (\n\tevent: ServerEventInput,\n\ttrust: ClientIpOptions,\n\tbehind: { identity: ServerTrackIdentity; req: PayloadRequest | undefined }\n): Headers => {\n\tconst { identity, req } = behind\n\tif (identity === 'none') {\n\t\treturn new Headers({ 'user-agent': SERVER_USER_AGENT })\n\t}\n\tconst own = new Headers(req?.headers)\n\tconst headers = event.ip ? overlayClientIp(own, event.ip, trust) : own\n\tif (event.userAgent) {\n\t\theaders.set('user-agent', event.userAgent)\n\t}\n\tif (!headers.get('user-agent')) {\n\t\theaders.set('user-agent', SERVER_USER_AGENT)\n\t}\n\treturn headers\n}\n\n/**\n * The caller's scope, else the request's resolved without the signed-in user or cookies, so an\n * editor's sale is filed under the site it happened on.\n */\nconst resolveScope = async (\n\tevent: ServerEventInput,\n\topts: ServerTrackOptions | undefined,\n\tresolvers: IngestResolvers\n): Promise<string | undefined> => {\n\t// An unscoped install has no scope resolver and no scope field on its rows, so a scope\n\t// declared by the caller is ignored exactly as the endpoint ignores one on the wire.\n\tif (!resolvers.scope) {\n\t\treturn undefined\n\t}\n\tif (event.scope !== undefined) {\n\t\treturn event.scope ?? ''\n\t}\n\tif (!opts?.req) {\n\t\treturn ''\n\t}\n\treturn (await resolvers.scope(captureRequest(opts.req))) ?? ''\n}\n\n/**\n * `adapter.ingest.track`: the endpoint's write path, outside any caller transaction. On SQLite a\n * call inside an open transaction resolves at once and stores its hit when that transaction ends.\n */\nexport const makeServerTrack =\n\t(deps: ServerTrackDeps): ServerTrack =>\n\tasync (payload, event, opts) => {\n\t\t// Trusted server code: it supplies its own hostname, so the resolver the HTTP endpoint\n\t\t// runs is bypassed and the hostname stays required here.\n\t\tconst invalid = rawEventError(event, { allowRevenue: true, requireHostname: true })\n\t\tif (invalid) {\n\t\t\tthrow new AnalyticsTrackError(`analytics: trackServerEvent needs a valid \"${invalid}\"`)\n\t\t}\n\t\t// Refused rather than dropped: a sale stored without its key would count again on every retry.\n\t\tif (event.orderId !== undefined && sanitizeOrderId(event.orderId) === undefined) {\n\t\t\tthrow new AnalyticsTrackError(\n\t\t\t\t`analytics: trackServerEvent needs a valid \"orderId\": a string of 1 to ${MAX_ORDER_ID_LENGTH} characters without control characters, so a retried order counts once`\n\t\t\t)\n\t\t}\n\t\tif (\n\t\t\tisRefund(event.revenue === true, event.value) &&\n\t\t\tsanitizeOrderId(event.orderId) !== undefined &&\n\t\t\tsanitizeOrderId(event.refundId) === undefined\n\t\t) {\n\t\t\tthrow new AnalyticsTrackError(\n\t\t\t\t'analytics: trackServerEvent needs a valid \"refundId\" on a refund of an order: the refund\\'s own id, so each partial refund counts once'\n\t\t\t)\n\t\t}\n\t\t// Refused rather than read as the default: a misspelt 'none' must not attribute the visitor.\n\t\tif (opts?.identity !== undefined && !isIdentity(opts.identity)) {\n\t\t\tthrow new AnalyticsTrackError(\n\t\t\t\t`analytics: trackServerEvent's identity must be 'request' or 'none', got ${kindOf(opts.identity)}`\n\t\t\t)\n\t\t}\n\t\tif (\n\t\t\tevent.now !== undefined &&\n\t\t\t!(event.now instanceof Date && Number.isFinite(event.now.getTime()))\n\t\t) {\n\t\t\tthrow new AnalyticsTrackError('analytics: trackServerEvent needs a valid \"now\"')\n\t\t}\n\t\tconst identity = opts?.identity ?? defaultIdentity(payload)\n\t\tif (opts?.identity === undefined && identity === 'none' && (event.ip || event.userAgent)) {\n\t\t\twarnIgnoredVisitor(payload)\n\t\t}\n\t\tconst receivedAt = currentDate()\n\t\tconst now = event.now ?? receivedAt\n\t\tif (now.getTime() > receivedAt.getTime() + SERVER_CLOCK_SKEW_MS) {\n\t\t\tthrow new AnalyticsTrackError(\n\t\t\t\t`analytics: trackServerEvent's \"now\" (${now.toISOString()}) is more than ${SERVER_CLOCK_SKEW_MS / 60_000} minutes ahead of the server's clock`\n\t\t\t)\n\t\t}\n\t\tconst target = deps.target(payload)\n\t\tif (\n\t\t\tevent.revenue === true &&\n\t\t\tevent.scope === undefined &&\n\t\t\t!opts?.req &&\n\t\t\tdeps.getResolvers().scope\n\t\t) {\n\t\t\twarnUnscopedSale(payload)\n\t\t}\n\n\t\tconst record = async (): Promise<void> => {\n\t\t\tconst resolvers = deps.getResolvers()\n\t\t\tconst scope = await resolveScope(event, opts, resolvers)\n\t\t\t// Refused before anything is written: a day whose raw hits may be pruned is never counted.\n\t\t\tconst placed = await target.engine?.serverHitDay(scope ?? '', now)\n\t\t\t// createLocalReq mutates its request, so a caller's req never reaches it: resolvers see it\n\t\t\t// as a capture does, without the user or cookies, and a fresh one is built only on demand.\n\t\t\tlet local: PayloadRequest | undefined\n\t\t\tconst requestFor = async (): Promise<PayloadRequest> => {\n\t\t\t\tif (opts?.req) {\n\t\t\t\t\treturn captureRequest(opts.req)\n\t\t\t\t}\n\t\t\t\tlocal ??= await createLocalReq({}, payload)\n\t\t\t\treturn local\n\t\t\t}\n\t\t\tconst salt = await saltForHit(\n\t\t\t\ttarget.salts,\n\t\t\t\t{\n\t\t\t\t\tscope: scope ?? '',\n\t\t\t\t\tat: now,\n\t\t\t\t\tzone: async () =>\n\t\t\t\t\t\tevent.timezone ??\n\t\t\t\t\t\t(resolvers.timezone\n\t\t\t\t\t\t\t? resolvers.timezone(await requestFor(), scope ?? null)\n\t\t\t\t\t\t\t: DEFAULT_TIMEZONE),\n\t\t\t\t},\n\t\t\t\t() => warnUnresolvedZone(payload)\n\t\t\t)\n\t\t\t// Goals resolve under the scope the event is stamped with, so a tenant's server event\n\t\t\t// can only ever complete that tenant's goals.\n\t\t\tconst goals = resolvers.goals\n\t\t\t\t? await resolvers.goals(await requestFor(), scope ?? null)\n\t\t\t\t: undefined\n\t\t\tconst reportingCurrency = resolvers.currency\n\t\t\t\t? await resolvers.currency(await requestFor(), scope ?? null)\n\t\t\t\t: undefined\n\t\t\tconst attribution = deps.getAttribution()\n\t\t\tconst orderKey = orderDigestKey(payload.secret)\n\t\t\tconst trust: ClientIpOptions = {\n\t\t\t\ttrustedProxyHops: attribution.trustedProxyHops,\n\t\t\t\ttrustedPlatform: attribution.trustedPlatform,\n\t\t\t}\n\t\t\tif (opts?.req && !event.ip && identity !== 'none') {\n\t\t\t\twarnUntrustedForwarding(payload, opts.req.headers, trust)\n\t\t\t}\n\t\t\tconst siblings =\n\t\t\t\ttarget.siteHosts &&\n\t\t\t\tevent.type === 'pageview' &&\n\t\t\t\treferrerHost(event.referrer, event.hostname) !== undefined\n\t\t\t\t\t? await target.siteHosts.of(scope ?? '')\n\t\t\t\t\t: undefined\n\t\t\tconst normalized = await normalizeEvent({\n\t\t\t\traw: {\n\t\t\t\t\ttype: event.type,\n\t\t\t\t\tname: event.name,\n\t\t\t\t\tpath: event.path,\n\t\t\t\t\treferrer: event.referrer,\n\t\t\t\t\tquery: event.query,\n\t\t\t\t\tprops: event.props,\n\t\t\t\t\tvalue: event.value,\n\t\t\t\t\tcurrency: event.currency,\n\t\t\t\t\titems: event.items,\n\t\t\t\t\trevenue: event.revenue,\n\t\t\t\t\torderId: event.orderId,\n\t\t\t\t\trefundId: event.refundId,\n\t\t\t\t\titem: event.item,\n\t\t\t\t},\n\t\t\t\thostname: event.hostname,\n\t\t\t\theaders: attributionHeaders(event, trust, { identity, req: opts?.req }),\n\t\t\t\tgeoResolver: deps.geoResolver,\n\t\t\t\twarnGeo: (message) => payload.logger?.warn(message),\n\t\t\t\tsalt,\n\t\t\t\tnow,\n\t\t\t\tscope,\n\t\t\t\tgoals,\n\t\t\t\torigin: 'server',\n\t\t\t\treportingCurrency,\n\t\t\t\tconvertCurrency: resolvers.convertCurrency,\n\t\t\t\twarnUnconverted: () => warnUnconvertedOnce(payload.logger),\n\t\t\t\t...trust,\n\t\t\t\t...(target.items ? { items: target.items } : {}),\n\t\t\t\t...(siblings ? { siblings } : {}),\n\t\t\t\torderKey,\n\t\t\t})\n\t\t\t// Only the server path can reach this: a public beacon's caller must never be able to\n\t\t\t// write lines into the host's log.\n\t\t\tif (event.revenue === true && normalized.goals === undefined) {\n\t\t\t\twarnUnmatchedRevenueGoal(payload.logger, event.name ?? event.type)\n\t\t\t}\n\t\t\t// An order bypasses the buffer and meets its own primary key: a retry stores nothing. A hit\n\t\t\t// on a closed day is stored before its day is reopened, so the count after it holds it.\n\t\t\tconst late = placed?.closed === true\n\t\t\tconst counted = toHit(normalized, { receivedAt })\n\t\t\tconst orderId = sanitizeOrderId(event.orderId)\n\t\t\t// A refund with no visitor of its own is filed where its sale counts, so every breakdown\n\t\t\t// still sums to the total.\n\t\t\tconst hit =\n\t\t\t\tnormalized.refund && counted.v === '' && orderId !== undefined && target.engine\n\t\t\t\t\t? {\n\t\t\t\t\t\t\t...counted,\n\t\t\t\t\t\t\t...(await target.engine.saleAttribution(\n\t\t\t\t\t\t\t\tscope ?? '',\n\t\t\t\t\t\t\t\tsaleRecordsOf({\n\t\t\t\t\t\t\t\t\tscope,\n\t\t\t\t\t\t\t\t\tgoal: normalized.name ?? normalized.type,\n\t\t\t\t\t\t\t\t\torderId,\n\t\t\t\t\t\t\t\t\tkey: orderKey,\n\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t)),\n\t\t\t\t\t\t}\n\t\t\t\t\t: counted\n\t\t\tconst stored = await target.writer.write(hit, {\n\t\t\t\t...(opts?.flush || late ? { flush: true } : {}),\n\t\t\t})\n\t\t\ttarget.siteHosts?.saw(scope ?? '', normalized.hostname)\n\t\t\t// A retried order stores nothing, so it counts no day again.\n\t\t\tconst fresh = stored === undefined || stored.written > 0\n\t\t\tif (placed && late && fresh) {\n\t\t\t\tawait target.engine?.reopen(placed)\n\t\t\t}\n\t\t\tif (wireTwinOf(hit.id) !== undefined && !normalized.refund && fresh) {\n\t\t\t\tawait target.engine?.orderStored(scope ?? '', hit.id)\n\t\t\t}\n\t\t}\n\n\t\t// The host holds SQLite's one write lock until its transaction ends, and a write that waited\n\t\t// for it here would wait on the very caller it is part of.\n\t\tconst open = target.sqlite ? await openTransactionOf(payload, opts?.req) : undefined\n\t\tif (open) {\n\t\t\ttarget.writer.defer(record, open)\n\t\t\treturn\n\t\t}\n\t\tawait record()\n\t\ttarget.nudge?.()\n\t}\n\n/**\n * First registered adapter with a server ingestion seam. Callers read every other seam off it too,\n * so an event cannot be judged by one adapter and written by another.\n */\nexport const ingestAdapter = (payload: Payload): AnalyticsAdapter | undefined =>\n\tgetRuntime(payload)\n\t\t?.registry.all()\n\t\t.find((adapter) => adapter.ingest?.track)\n\n/**\n * Records an event from server code through the native adapter, normalized as a beacon is. Without\n * `opts.identity` it is no visitor's while `capture.gate` holds the native slot.\n */\nexport const trackServerEvent = async (\n\tpayload: Payload,\n\tevent: ServerEventInput,\n\topts?: ServerTrackOptions\n): Promise<void> => {\n\tconst track = ingestAdapter(payload)?.ingest?.track\n\tif (!track) {\n\t\tthrow new AnalyticsTrackError(\n\t\t\t'analytics: trackServerEvent needs the native adapter; provider-slot server tracking is not supported yet'\n\t\t)\n\t}\n\tawait track(payload, event, opts)\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { createHmac, timingSafeEqual } from "node:crypto";
|
|
2
|
+
//#region src/native/ingest/signature.ts
|
|
3
|
+
/**
|
|
4
|
+
* Derives a secret's key for the one use `label` names, so it can never stand in for any other
|
|
5
|
+
* use of the secret. Each secret's key is derived once.
|
|
6
|
+
*/
|
|
7
|
+
const labelledKey = (label) => {
|
|
8
|
+
const keysBySecret = /* @__PURE__ */ new Map();
|
|
9
|
+
return (secret) => {
|
|
10
|
+
const known = keysBySecret.get(secret);
|
|
11
|
+
if (known) return known;
|
|
12
|
+
const key = createHmac("sha256", secret).update(label).digest();
|
|
13
|
+
keysBySecret.set(secret, key);
|
|
14
|
+
return key;
|
|
15
|
+
};
|
|
16
|
+
};
|
|
17
|
+
/** The signature a page carries for `message`: 72 bits of its HMAC under `key`, base64url. */
|
|
18
|
+
const shortSignature = (key, message) => createHmac("sha256", key).update(message).digest("base64url").slice(0, 12);
|
|
19
|
+
/** Whether `given` is `expected`, compared in constant time. */
|
|
20
|
+
const sameSignature = (expected, given) => {
|
|
21
|
+
const expectedBytes = Buffer.from(expected);
|
|
22
|
+
const givenBytes = Buffer.from(given);
|
|
23
|
+
return expectedBytes.length === givenBytes.length && timingSafeEqual(expectedBytes, givenBytes);
|
|
24
|
+
};
|
|
25
|
+
//#endregion
|
|
26
|
+
export { labelledKey, sameSignature, shortSignature };
|
|
27
|
+
|
|
28
|
+
//# sourceMappingURL=signature.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"signature.js","names":[],"sources":["../../../src/native/ingest/signature.ts"],"sourcesContent":["import { createHmac, timingSafeEqual } from 'node:crypto'\nimport { ITEM_SIGNATURE_LENGTH } from '../../goals/constants'\n\n/**\n * Derives a secret's key for the one use `label` names, so it can never stand in for any other\n * use of the secret. Each secret's key is derived once.\n */\nexport const labelledKey = (label: string): ((secret: string) => Buffer) => {\n\tconst keysBySecret = new Map<string, Buffer>()\n\treturn (secret) => {\n\t\tconst known = keysBySecret.get(secret)\n\t\tif (known) {\n\t\t\treturn known\n\t\t}\n\t\tconst key = createHmac('sha256', secret).update(label).digest()\n\t\tkeysBySecret.set(secret, key)\n\t\treturn key\n\t}\n}\n\n/** The signature a page carries for `message`: 72 bits of its HMAC under `key`, base64url. */\nexport const shortSignature = (key: Buffer, message: string): string =>\n\tcreateHmac('sha256', key).update(message).digest('base64url').slice(0, ITEM_SIGNATURE_LENGTH)\n\n/** Whether `given` is `expected`, compared in constant time. */\nexport const sameSignature = (expected: string, given: string): boolean => {\n\tconst expectedBytes = Buffer.from(expected)\n\tconst givenBytes = Buffer.from(given)\n\treturn expectedBytes.length === givenBytes.length && timingSafeEqual(expectedBytes, givenBytes)\n}\n"],"mappings":";;;;;;AAOA,MAAa,eAAe,UAAgD;CAC3E,MAAM,+BAAe,IAAI,IAAoB;CAC7C,QAAQ,WAAW;EAClB,MAAM,QAAQ,aAAa,IAAI,MAAM;EACrC,IAAI,OACH,OAAO;EAER,MAAM,MAAM,WAAW,UAAU,MAAM,EAAE,OAAO,KAAK,EAAE,OAAO;EAC9D,aAAa,IAAI,QAAQ,GAAG;EAC5B,OAAO;CACR;AACD;;AAGA,MAAa,kBAAkB,KAAa,YAC3C,WAAW,UAAU,GAAG,EAAE,OAAO,OAAO,EAAE,OAAO,WAAW,EAAE,MAAM,GAAA,EAAwB;;AAG7F,MAAa,iBAAiB,UAAkB,UAA2B;CAC1E,MAAM,gBAAgB,OAAO,KAAK,QAAQ;CAC1C,MAAM,aAAa,OAAO,KAAK,KAAK;CACpC,OAAO,cAAc,WAAW,WAAW,UAAU,gBAAgB,eAAe,UAAU;AAC/F"}
|
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
//#region src/native/ingest/source.d.ts
|
|
2
2
|
/**
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
* reports and the one a budget question is actually asked in.
|
|
3
|
+
* Paid is split per platform rather than pooled: that is the split every vendor reports and the
|
|
4
|
+
* one a budget question is asked in.
|
|
6
5
|
*/
|
|
7
6
|
declare const TRAFFIC_CHANNELS: readonly ["direct", "organic-search", "paid-search", "organic-social", "paid-social", "organic-video", "paid-video", "email", "affiliate", "display", "referral", "paid-other"];
|
|
8
7
|
type TrafficChannel = (typeof TRAFFIC_CHANNELS)[number];
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
+
import { MAX_UTM_LENGTH } from "./utm.js";
|
|
1
2
|
//#region src/native/ingest/source.ts
|
|
2
3
|
/**
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
* reports and the one a budget question is actually asked in.
|
|
4
|
+
* Paid is split per platform rather than pooled: that is the split every vendor reports and the
|
|
5
|
+
* one a budget question is asked in.
|
|
6
6
|
*/
|
|
7
7
|
const TRAFFIC_CHANNELS = [
|
|
8
8
|
"direct",
|
|
@@ -29,13 +29,8 @@ const ORGANIC_CHANNELS = {
|
|
|
29
29
|
video: "organic-video"
|
|
30
30
|
};
|
|
31
31
|
/**
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
* an inherited member, which would put a function where a channel belongs.
|
|
35
|
-
*
|
|
36
|
-
* `referral` is deliberately absent. It names the channel the host branch already decides,
|
|
37
|
-
* and pinning it here would turn a hit with no referrer at all into `referral` rather than
|
|
38
|
-
* `direct`.
|
|
32
|
+
* Lookups here are `Map`s or `Set`s: keys come from the query, and an object literal answers
|
|
33
|
+
* inherited members. `referral` is absent so a hit with no referrer stays `direct`.
|
|
39
34
|
*/
|
|
40
35
|
const MEDIUM_CHANNELS = new Map([
|
|
41
36
|
["email", "email"],
|
|
@@ -54,10 +49,8 @@ const MEDIUM_CHANNELS = new Map([
|
|
|
54
49
|
["search", "organic-search"]
|
|
55
50
|
]);
|
|
56
51
|
/**
|
|
57
|
-
*
|
|
58
|
-
*
|
|
59
|
-
* search one, so it names no platform and leaves the referrer to. Any other medium starting
|
|
60
|
-
* `paid` is treated the same way.
|
|
52
|
+
* Paid mediums and the platform each names. `null` ones (`cpc` runs on social and search alike)
|
|
53
|
+
* leave the platform to the referrer, as does any other medium starting `paid`.
|
|
61
54
|
*/
|
|
62
55
|
const PAID_MEDIUMS = new Map([
|
|
63
56
|
["cpc", null],
|
|
@@ -81,15 +74,13 @@ const PAID_CLICK_IDS = new Map([
|
|
|
81
74
|
["ttclid", "social"]
|
|
82
75
|
]);
|
|
83
76
|
/**
|
|
84
|
-
* Facebook appends `fbclid` to every outbound link, organic
|
|
85
|
-
*
|
|
86
|
-
* the in-app browser case it exists to cover.
|
|
77
|
+
* Facebook appends `fbclid` to every outbound link, organic included, so it proves the platform,
|
|
78
|
+
* never the spend. It stands in only for a missing referrer (the in-app browser case).
|
|
87
79
|
*/
|
|
88
80
|
const FACEBOOK_CLICK_ID = "fbclid";
|
|
89
81
|
/**
|
|
90
|
-
* Hosts the lists below would
|
|
91
|
-
*
|
|
92
|
-
* mail client, never that the mail was the newsletter an `email` bucket claims credit for.
|
|
82
|
+
* Hosts the lists below would misfile. Webmail is `referral`, not `email`: a referrer proves a
|
|
83
|
+
* mail client, never that the mail was the newsletter `email` claims credit for.
|
|
93
84
|
*/
|
|
94
85
|
const NON_PLATFORM_HOSTS = new Set([
|
|
95
86
|
"mail.google.com",
|
|
@@ -175,9 +166,8 @@ const NAME_PLATFORMS = new Map([
|
|
|
175
166
|
["vimeo", "video"]
|
|
176
167
|
]);
|
|
177
168
|
/**
|
|
178
|
-
*
|
|
179
|
-
*
|
|
180
|
-
* cares to name itself after a search engine the search channel.
|
|
169
|
+
* Suffixes a brand's country site sits under (`google.co.uk`); without them any two-label tail
|
|
170
|
+
* would match, handing `google.evil.com` the search channel.
|
|
181
171
|
*/
|
|
182
172
|
const SECOND_LEVEL = new Set([
|
|
183
173
|
"co",
|
|
@@ -206,43 +196,38 @@ const hostPlatform = (host) => {
|
|
|
206
196
|
};
|
|
207
197
|
/** A `utm_source` spelled as a domain is matched as one, so `google.com` is not an unknown. */
|
|
208
198
|
const namePlatform = (name) => NAME_PLATFORMS.get(name) ?? (name.includes(".") ? hostPlatform(name) : void 0);
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
199
|
+
/**
|
|
200
|
+
* Name of the query's click id: the first paid network's, else Facebook's. Only the name is kept,
|
|
201
|
+
* so a stored hit can be classified again without its query.
|
|
202
|
+
*/
|
|
203
|
+
const clickIdOf = (query) => {
|
|
204
|
+
if (!query) return;
|
|
212
205
|
let facebook = false;
|
|
213
206
|
for (const [key, value] of new URLSearchParams(query)) {
|
|
214
207
|
if (!value) continue;
|
|
215
208
|
const name = key.toLowerCase();
|
|
216
|
-
if (name
|
|
217
|
-
|
|
218
|
-
continue;
|
|
219
|
-
}
|
|
220
|
-
paid ??= PAID_CLICK_IDS.get(name);
|
|
209
|
+
if (PAID_CLICK_IDS.has(name)) return name;
|
|
210
|
+
facebook ||= name === FACEBOOK_CLICK_ID;
|
|
221
211
|
}
|
|
212
|
+
return facebook ? FACEBOOK_CLICK_ID : void 0;
|
|
213
|
+
};
|
|
214
|
+
const clicksOf = (clickId) => {
|
|
215
|
+
const name = clickId?.toLowerCase();
|
|
222
216
|
return {
|
|
223
|
-
paid,
|
|
224
|
-
facebook
|
|
217
|
+
paid: name === void 0 ? void 0 : PAID_CLICK_IDS.get(name),
|
|
218
|
+
facebook: name === FACEBOOK_CLICK_ID
|
|
225
219
|
};
|
|
226
220
|
};
|
|
227
221
|
const paidChannel = (platform) => platform ? PAID_CHANNELS[platform] : "paid-other";
|
|
228
222
|
/**
|
|
229
|
-
*
|
|
230
|
-
*
|
|
231
|
-
* dimension's job.
|
|
232
|
-
*
|
|
233
|
-
* `utm_medium` wins outright, because a campaign states its own channel and the referrer host
|
|
234
|
-
* is then only the last hop. A paid click id is next, since an ad click carries one whatever
|
|
235
|
-
* host it bounced through, and it names its own network's platform. The platform itself comes
|
|
236
|
-
* from the referrer host, else from `utm_source` matched by name; on the paid path `utm_source`
|
|
237
|
-
* answers too when the host names no platform, because an ad click routinely arrives through the
|
|
238
|
-
* network's own redirect host. Anything left with a host is `referral`, and a hit with no usable
|
|
239
|
-
* host at all is `direct`.
|
|
223
|
+
* `utm_medium` wins (a campaign states its own channel), then a paid click id, then the platform of
|
|
224
|
+
* the referrer host or `utm_source`. A remaining host is `referral`, none at all is `direct`.
|
|
240
225
|
*/
|
|
241
|
-
const classifyChannel = ({ referrerHost, utmSource, utmMedium, query }) => {
|
|
226
|
+
const classifyChannel = ({ referrerHost, utmSource, utmMedium, query, clickId }) => {
|
|
242
227
|
const host = referrerHost?.trim().toLowerCase();
|
|
243
228
|
const name = utmSource?.trim().toLowerCase();
|
|
244
229
|
const medium = utmMedium?.trim().toLowerCase();
|
|
245
|
-
const clicks =
|
|
230
|
+
const clicks = clicksOf(clickId ?? clickIdOf(query));
|
|
246
231
|
const platform = (host ? hostPlatform(host) : name ? namePlatform(name) : void 0) ?? (!host && clicks.facebook ? "social" : void 0);
|
|
247
232
|
if (medium) {
|
|
248
233
|
if (PAID_MEDIUMS.has(medium) || medium.startsWith("paid")) return paidChannel(PAID_MEDIUMS.get(medium) ?? clicks.paid ?? platform ?? (host && name ? namePlatform(name) : void 0));
|
|
@@ -254,17 +239,13 @@ const classifyChannel = ({ referrerHost, utmSource, utmMedium, query }) => {
|
|
|
254
239
|
return host ? "referral" : "direct";
|
|
255
240
|
};
|
|
256
241
|
/**
|
|
257
|
-
*
|
|
258
|
-
*
|
|
259
|
-
* (`sessionSource`), so a report reads the same column whichever source answered it. The tag is
|
|
260
|
-
* lowercased and capped like every other campaign key, so one tag spelled two ways is one row; the
|
|
261
|
-
* host already arrives lowercased, and the `utmSource` dimension keeps the tag as it was written. A
|
|
262
|
-
* campaign tagged `utm_source=direct` therefore shares the `direct` bucket with untagged traffic.
|
|
242
|
+
* `utm_source` (lowercased, capped), else referrer host, else `direct`, as Plausible and GA4 define
|
|
243
|
+
* source. A campaign tagged `utm_source=direct` therefore shares the untagged `direct` bucket.
|
|
263
244
|
*/
|
|
264
245
|
const deriveSource = ({ referrerHost, utmSource }) => {
|
|
265
|
-
return utmSource?.trim().toLowerCase().slice(0,
|
|
246
|
+
return utmSource?.trim().toLowerCase().slice(0, MAX_UTM_LENGTH) || referrerHost || "direct";
|
|
266
247
|
};
|
|
267
248
|
//#endregion
|
|
268
|
-
export { TRAFFIC_CHANNELS, classifyChannel, deriveSource };
|
|
249
|
+
export { TRAFFIC_CHANNELS, classifyChannel, clickIdOf, deriveSource };
|
|
269
250
|
|
|
270
251
|
//# sourceMappingURL=source.js.map
|