@10x-media/analytics 1.0.0-beta.11 → 1.0.0-beta.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +463 -0
- package/README.md +30 -37
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +7 -9
- package/dist/adapters/ga4/disableKey.js.map +1 -1
- package/dist/adapters/ga4/eventName.d.ts +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +11 -0
- package/dist/adapters/ga4/ga4.js +206 -123
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +2 -3
- package/dist/adapters/ga4/measurementId.js.map +1 -1
- package/dist/adapters/goalRead.js +15 -29
- package/dist/adapters/goalRead.js.map +1 -1
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +13 -13
- package/dist/adapters/plausible/plausible.js +137 -122
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +20 -9
- package/dist/adapters/posthog/posthog.js +179 -113
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +7 -9
- package/dist/adapters/umami/umami.js +184 -172
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +16 -29
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +48 -95
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +100 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/charts/BarList.d.ts +27 -14
- package/dist/charts/BarList.js +38 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +15 -1
- package/dist/charts/bars.js +12 -12
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +193 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +48 -37
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +26 -25
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +258 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +104 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +285 -59
- package/dist/core/contract.js +6 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +473 -157
- package/dist/core/options.js +154 -219
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +112 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +182 -72
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +38 -20
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceOptions.js +94 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +14 -0
- package/dist/exports/adapters/ga4.d.ts +15 -1
- package/dist/exports/adapters/native.d.ts +26 -2
- package/dist/exports/adapters/native.js +4 -1
- package/dist/exports/adapters/plausible.d.ts +15 -1
- package/dist/exports/adapters/posthog.d.ts +15 -1
- package/dist/exports/adapters/umami.d.ts +15 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +41 -13
- package/dist/exports/client.js +21 -9
- package/dist/exports/geo.d.ts +3 -1
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/next.d.ts +18 -1
- package/dist/exports/next.js +3 -1
- package/dist/exports/react.d.ts +3 -2
- package/dist/exports/react.js +1 -2
- package/dist/exports/rsc.d.ts +31 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +17 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +5 -20
- package/dist/exports/tracker.js +3 -14
- package/dist/exports/types.d.ts +40 -14
- package/dist/exports/types.js +5 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +20 -8
- package/dist/fields/AnalyticsPanelField.js +121 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +18 -7
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +217 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
- package/dist/fields/config/FilterDimensionSelectField.js +26 -54
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
- package/dist/fields/config/FilterOperatorSelectField.js +37 -53
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +18 -30
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.js +14 -26
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +31 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +66 -37
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +78 -26
- package/dist/fields/readForDocument.js +446 -116
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +162 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +141 -100
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -26
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +39 -40
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +154 -46
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -27
- package/dist/goals/trackGoalAction.js +38 -52
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +63 -11
- package/dist/index.js +257 -247
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +81 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.d.ts +1 -0
- package/dist/maintenance/taskSchedule.js +62 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +102 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +29 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1623 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +198 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +108 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +4 -1
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +20 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +2 -3
- package/dist/native/ingest/bots.js +8 -13
- package/dist/native/ingest/bots.js.map +1 -1
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +30 -9
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +119 -34
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +60 -7
- package/dist/native/ingest/normalizeEvent.js +226 -61
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +10 -23
- package/dist/native/ingest/requestHost.js.map +1 -1
- package/dist/native/ingest/resolveHostname.d.ts +4 -13
- package/dist/native/ingest/resolveHostname.js +5 -6
- package/dist/native/ingest/resolveHostname.js.map +1 -1
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +82 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +181 -72
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +2 -3
- package/dist/native/ingest/source.js +35 -54
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +20 -10
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +101 -33
- package/dist/native/nativeAdapter.js +375 -317
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +116 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +63 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +430 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +695 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +95 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +384 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +345 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +48 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +656 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +9 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +68 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +4 -24
- package/dist/next/captureRewrites.js +6 -50
- package/dist/next/captureRewrites.js.map +1 -1
- package/dist/next/captureRoute.d.ts +28 -0
- package/dist/next/captureRoute.js +67 -0
- package/dist/next/captureRoute.js.map +1 -0
- package/dist/next/ingestRoute.d.ts +17 -0
- package/dist/next/ingestRoute.js +17 -0
- package/dist/next/ingestRoute.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +3 -25
- package/dist/next/posthogProxyRewrites.js +5 -37
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +336 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +76 -53
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +5 -12
- package/dist/plugin/errors.js +23 -16
- package/dist/plugin/errors.js.map +1 -1
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/jobsAccess.js +91 -0
- package/dist/plugin/jobsAccess.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +155 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +69 -44
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +52 -17
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +64 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +77 -25
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +69 -44
- package/dist/plugin/refreshEndpoint.js.map +1 -1
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +226 -30
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +63 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +6 -5
- package/dist/plugin/scopeChange.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +46 -12
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +22 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +53 -0
- package/dist/providers/collection.js +274 -150
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +76 -0
- package/dist/providers/factory.js +76 -23
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +101 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +318 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +23 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +1 -5
- package/dist/query/fetchQuery.d.ts +25 -32
- package/dist/query/fetchQuery.js +91 -91
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +6 -0
- package/dist/query/parse.js +153 -106
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +26 -17
- package/dist/react/AnalyticsProvider.js +23 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -11
- package/dist/react/useAnalytics.js +22 -24
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/site/AnalyticsScripts.d.ts +34 -0
- package/dist/site/AnalyticsScripts.js +30 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +40 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +69 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -72
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.js +70 -26
- package/dist/surfacing/epoch.js.map +1 -1
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +113 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +28 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +226 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +144 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +4 -10
- package/dist/tracker/createTracker.js +386 -115
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +2 -22
- package/dist/tracker/exclusion.js +53 -21
- package/dist/tracker/exclusion.js.map +1 -1
- package/dist/tracker/gate.js +194 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +21 -14
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +118 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +38 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +64 -20
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +7 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +27 -22
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +26 -22
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +14 -12
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +30 -27
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +86 -63
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +226 -71
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +215 -69
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +209 -67
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +217 -68
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +221 -72
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +212 -67
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +185 -14
- package/dist/translations/keys.js +190 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +214 -69
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +226 -77
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +217 -66
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +217 -66
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +212 -67
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +112 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1528 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +26 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +11 -6
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +8 -10
- package/dist/view/AnalyticsView.js +47 -18
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -229
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +150 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +66 -31
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +95 -10
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +10 -9
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +196 -134
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +118 -30
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +124 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +29 -33
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +123 -82
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +47 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +64 -7
- package/dist/view/viewProps.js +121 -35
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +80 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +129 -123
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +24 -4
- package/dist/widgets/RealtimeCounter.js +91 -77
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +12 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaults.d.ts +4 -7
- package/dist/widgets/defaults.js +4 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +73 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +5 -1
- package/dist/widgets/prepareWidgetRead.js +59 -27
- package/dist/widgets/prepareWidgetRead.js.map +1 -1
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +27 -18
- package/dist/widgets/readForWidget.js +31 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
- package/dist/widgets/readForWidgetBreakdown.js +46 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +17 -23
- package/dist/widgets/readForWidgetGoals.js +50 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
- package/dist/widgets/readForWidgetRealtime.js +51 -27
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +26 -31
- package/dist/widgets/readForWidgetSeries.js +43 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +44 -0
- package/dist/widgets/readMeta.js +47 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +53 -25
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +204 -126
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +4 -3
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +31 -24
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +44 -22
- package/dist/adapters/ga4/disableKey.d.ts +0 -9
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -165
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -39
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -175
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -69
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -106
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/plugin/paths.js +0 -29
- package/dist/plugin/paths.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -29
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -20
- package/dist/tracker/sinks/posthog.d.ts +0 -18
- package/dist/tracker/sinks/umami.d.ts +0 -18
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -76
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"writeBuffer.js","names":["startTimer","stopTimer"],"sources":["../../../src/native/engine/writeBuffer.ts"],"sourcesContent":["import { setTimeout as startTimer, clearTimeout as stopTimer } from 'node:timers'\nimport { monotonicMs } from '../../core/monotonic'\nimport { isRecord } from '../../core/values'\nimport { isRowError } from '../../db/errors'\nimport { isOrderHitId } from '../store/ids'\nimport type { AppendResult, EventStore, HitRow } from '../store/types'\n\nexport interface WriteBufferLimits {\n\t/** Hits one write to the store carries at most. */\n\tmaxSize: number\n\t/** How long the first hit of a batch waits for its write. */\n\tmaxAgeMs: number\n\t/** Hits held at once, waiting or being written; past it, a new one waits for a write. */\n\tmaxPending: number\n}\n\nexport const DEFAULT_WRITE_BUFFER: Readonly<WriteBufferLimits> = {\n\tmaxSize: 200,\n\tmaxAgeMs: 1000,\n\tmaxPending: 5000,\n}\n\n/** `native({ buffer })`: off unless set; `true` takes defaults, an object overrides any of them. */\nexport type WriteBufferOption = boolean | Partial<WriteBufferLimits>\n\nconst wholeLimit = (value: unknown, name: keyof WriteBufferLimits): number => {\n\tif (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {\n\t\tthrow new Error(\n\t\t\t`analytics: native buffer.${name} must be a whole number of at least 1, got ${String(value)}`\n\t\t)\n\t}\n\treturn value\n}\n\n/** The limits an option asks for, null for no buffer; limits no buffer could keep fail the boot. */\nexport const resolveWriteBuffer = (\n\toption: WriteBufferOption | undefined\n): WriteBufferLimits | null => {\n\tif (option === undefined || option === false) {\n\t\treturn null\n\t}\n\tif (option !== true && (!isRecord(option) || Array.isArray(option))) {\n\t\tthrow new Error('analytics: native buffer must be true, false or an object of limits')\n\t}\n\tconst given = option === true ? {} : option\n\tconst limits: WriteBufferLimits = {\n\t\tmaxSize: wholeLimit(given.maxSize ?? DEFAULT_WRITE_BUFFER.maxSize, 'maxSize'),\n\t\tmaxAgeMs: wholeLimit(given.maxAgeMs ?? DEFAULT_WRITE_BUFFER.maxAgeMs, 'maxAgeMs'),\n\t\tmaxPending: wholeLimit(given.maxPending ?? DEFAULT_WRITE_BUFFER.maxPending, 'maxPending'),\n\t}\n\tif (limits.maxPending < limits.maxSize) {\n\t\tthrow new Error(\n\t\t\t`analytics: native buffer.maxPending (${limits.maxPending}) must be at least buffer.maxSize (${limits.maxSize})`\n\t\t)\n\t}\n\treturn limits\n}\n\n/** Environment variables a serverless platform sets in every function it runs. */\nconst SERVERLESS_ENV: readonly string[] = ['VERCEL', 'AWS_LAMBDA_FUNCTION_NAME', 'NETLIFY']\n\n/** The variable that gives a serverless platform away, or undefined when none is set. */\nexport const serverlessPlatformOf = (\n\tenv: Readonly<Record<string, string | undefined>>\n): string | undefined => SERVERLESS_ENV.find((name) => (env[name] ?? '') !== '')\n\n/** One line about dropped hits at most this often, whatever the database does. */\nconst DROP_LOG_INTERVAL_MS = 60_000\n\n/** How long a batch the database refused as a whole waits before its one retry. */\nexport const BATCH_RETRY_MS = 500\n\n/** How long a SIGTERM or SIGINT waits for the last write before the signal is handed on. */\nconst SIGNAL_FLUSH_MS = 5_000\n\n/** How often deferred work asks whether it may run. */\nconst DEFER_POLL_MS = 50\n\n/** How long deferred work waits at most before it runs anyway. */\nexport const DEFER_MAX_MS = 600_000\n\n/** Deferred work held at once, waiting or running: past it, more is dropped and logged. */\nexport const MAX_DEFERRED = 10_000\n\n/** The signals that stop a process and that a writer answers by writing what it holds first. */\ntype StopSignal = 'SIGTERM' | 'SIGINT'\n\nconst STOP_SIGNALS: readonly StopSignal[] = ['SIGTERM', 'SIGINT']\n\n/** What the writer needs of a process to write what it holds when the process is told to stop. */\nexport interface ShutdownSignals {\n\treadonly pid: number\n\ton(event: 'beforeExit' | 'exit' | StopSignal, listener: () => void): unknown\n\toff(event: 'beforeExit' | 'exit' | StopSignal, listener: () => void): unknown\n\tlistenerCount(event: StopSignal): number\n\tkill(pid: number, signal: StopSignal): unknown\n}\n\n/** The slice of Payload's logger the writer speaks through. */\ninterface WriterLogger {\n\twarn(message: string): void\n\terror(details: { err: unknown; msg: string }): void\n}\n\nexport interface HitWriterOptions {\n\tstore: Pick<EventStore, 'append'>\n\tbuffer?: WriteBufferOption\n\tlogger?: WriterLogger\n\t/** The process whose shutdown writes the buffer out: Node's own unless a test hands one in. */\n\tsignals?: ShutdownSignals\n\t/** What the serverless check reads: `process.env` unless a test hands one in. */\n\tenv?: Readonly<Record<string, string | undefined>>\n\tnow?: () => number\n\t/** Starts a one-shot timer and answers how to cancel it. */\n\tsetTimer?: (run: () => void, ms: number) => () => void\n}\n\nexport interface HitWriter {\n\t/**\n\t * Stores one hit, buffered unless an order, `flush: true` or a closed writer. A buffered write\n\t * resolves once queued (waiting only at `maxPending`) and answers nothing; a direct one does.\n\t */\n\twrite(hit: HitRow, options?: { flush?: boolean }): Promise<AppendResult | undefined>\n\t/**\n\t * Runs `work` once `blocked` answers false, for a hit recorded inside a host's open SQLite\n\t * transaction. Never rejects; past {@link DEFER_MAX_MS}, or on `close`, it runs anyway.\n\t */\n\tdefer(work: () => Promise<void>, blocked: () => boolean): void\n\t/** Runs the deferred work that may run, then writes everything buffered so far; never rejects. */\n\tflush(): Promise<void>\n\t/** Runs every deferred work, writes what is buffered and takes the process listeners back. */\n\tclose(): Promise<void>\n\t/** Hits held in the buffer: waiting, and in the write under way. Deferred work is not one. */\n\tpending(): number\n}\n\nconst unrefTimer = (run: () => void, ms: number): (() => void) => {\n\t// A pending write must never be what keeps a process, or a test run, alive.\n\tconst handle = startTimer(run, ms).unref()\n\treturn () => stopTimer(handle)\n}\n\n/** Resolves when `work` settles or `ms` has passed, whichever comes first. */\nconst settleWithin = (work: Promise<void>, ms: number): Promise<void> =>\n\tnew Promise((resolve) => {\n\t\tconst cancel = unrefTimer(resolve, ms)\n\t\tvoid work.finally(() => {\n\t\t\tcancel()\n\t\t\tresolve()\n\t\t})\n\t})\n\n/** Reports failures at most once a minute, with how many there were since the last line. */\nconst rateLimitedReport = (\n\tlogger: WriterLogger | undefined,\n\tnow: () => number,\n\tmessage: (count: number) => string\n): ((count: number, error: unknown) => void) => {\n\tlet missed = 0\n\tlet loggedAt: number | null = null\n\treturn (count, error) => {\n\t\tmissed += count\n\t\tconst at = now()\n\t\tif (loggedAt !== null && at - loggedAt < DROP_LOG_INTERVAL_MS) {\n\t\t\treturn\n\t\t}\n\t\tloggedAt = at\n\t\tlogger?.error({ err: error, msg: message(missed) })\n\t\tmissed = 0\n\t}\n}\n\ninterface DeferredWork {\n\twork: () => Promise<void>\n\tblocked: () => boolean\n\tsince: number\n}\n\n/** Work that waits its turn, asked on a timer whether it may run yet; at most `MAX_DEFERRED`. */\nconst createDeferrals = (args: {\n\tnow: () => number\n\tsetTimer: (run: () => void, ms: number) => () => void\n\tfailed: (error: unknown) => void\n\t/** Work refused, `MAX_DEFERRED` waiting or running already. */\n\tdropped: () => void\n}) => {\n\tlet waiting: DeferredWork[] = []\n\tconst running = new Set<Promise<void>>()\n\tlet cancel: (() => void) | null = null\n\n\tconst mayRun = (entry: DeferredWork, force: boolean): boolean => {\n\t\tif (force || args.now() - entry.since >= DEFER_MAX_MS) {\n\t\t\treturn true\n\t\t}\n\t\ttry {\n\t\t\treturn !entry.blocked()\n\t\t} catch {\n\t\t\treturn true\n\t\t}\n\t}\n\n\tconst start = (entry: DeferredWork): void => {\n\t\tconst task = entry.work().catch(args.failed)\n\t\trunning.add(task)\n\t\tvoid task.then(() => running.delete(task))\n\t}\n\n\tconst poll = (force: boolean): void => {\n\t\tcancel?.()\n\t\tcancel = null\n\t\tconst still: DeferredWork[] = []\n\t\tfor (const entry of waiting) {\n\t\t\tif (mayRun(entry, force)) {\n\t\t\t\tstart(entry)\n\t\t\t} else {\n\t\t\t\tstill.push(entry)\n\t\t\t}\n\t\t}\n\t\twaiting = still\n\t\tif (waiting.length > 0) {\n\t\t\tcancel = args.setTimer(() => poll(false), DEFER_POLL_MS)\n\t\t}\n\t}\n\n\treturn {\n\t\tadd(work: () => Promise<void>, blocked: () => boolean): void {\n\t\t\tif (waiting.length + running.size >= MAX_DEFERRED) {\n\t\t\t\targs.dropped()\n\t\t\t\treturn\n\t\t\t}\n\t\t\twaiting.push({ work, blocked, since: args.now() })\n\t\t\tpoll(false)\n\t\t},\n\t\t/** Work not finished yet, waiting or running. */\n\t\theld: (): number => waiting.length + running.size,\n\t\t/** Starts what may run (everything, when forced) and waits for all of it to finish. */\n\t\tasync settle(force: boolean): Promise<void> {\n\t\t\tpoll(force)\n\t\t\twhile (running.size > 0) {\n\t\t\t\tawait Promise.allSettled([...running])\n\t\t\t}\n\t\t},\n\t}\n}\n\n/**\n * Writes what a writer holds before the process goes: on SIGTERM and SIGINT, then hands the signal\n * back; when the event loop runs dry; and on `exit`, where no write can run, warns what is lost.\n */\nconst guardShutdown = (args: {\n\tsignals: ShutdownSignals\n\tlogger: WriterLogger | undefined\n\t/** Hits and deferred work not stored yet. */\n\theld: () => number\n\t/** Runs every deferred work and writes everything held; `stopping` once the process goes. */\n\tsettle: (stopping: boolean) => Promise<void>\n}) => {\n\tconst { signals } = args\n\tlet listening = false\n\tlet settling: Promise<void> | null = null\n\tconst settleOnce = (stopping: boolean): Promise<void> => {\n\t\tsettling ??= args.settle(stopping).finally(() => {\n\t\t\tsettling = null\n\t\t})\n\t\treturn settling\n\t}\n\tconst onBeforeExit = (): void => {\n\t\t// Writing schedules more work, which empties the loop again: only start while work is held.\n\t\tif (args.held() > 0 && settling === null) {\n\t\t\tvoid settleOnce(false)\n\t\t}\n\t}\n\tconst onExit = (): void => {\n\t\tconst lost = args.held()\n\t\tif (lost > 0) {\n\t\t\targs.logger?.warn(\n\t\t\t\t`analytics: the process exited with ${lost} hits not stored yet, and they are lost. Destroy Payload (await payload.destroy()) before calling process.exit() to store them.`\n\t\t\t)\n\t\t}\n\t}\n\t// Each writer lets go only once its own write is done, so with several instances in one process\n\t// the last one out hands the signal back: a listener otherwise keeps Node from stopping.\n\tconst onSignal = (signal: StopSignal) => (): void => {\n\t\tvoid settleWithin(settleOnce(true), SIGNAL_FLUSH_MS).then(() => {\n\t\t\trelease()\n\t\t\tif (signals.listenerCount(signal) === 0) {\n\t\t\t\tsignals.kill(signals.pid, signal)\n\t\t\t}\n\t\t})\n\t}\n\tconst handlers = new Map(STOP_SIGNALS.map((signal) => [signal, onSignal(signal)]))\n\tconst release = (): void => {\n\t\tif (!listening) {\n\t\t\treturn\n\t\t}\n\t\tlistening = false\n\t\tsignals.off('beforeExit', onBeforeExit)\n\t\tsignals.off('exit', onExit)\n\t\tfor (const [signal, handler] of handlers) {\n\t\t\tsignals.off(signal, handler)\n\t\t}\n\t}\n\treturn {\n\t\tlisten(): void {\n\t\t\tif (listening) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tlistening = true\n\t\t\tsignals.on('beforeExit', onBeforeExit)\n\t\t\tsignals.on('exit', onExit)\n\t\t\tfor (const [signal, handler] of handlers) {\n\t\t\t\tsignals.on(signal, handler)\n\t\t\t}\n\t\t},\n\t\trelease,\n\t}\n}\n\nconst DEFERRED_FAILED = (count: number): string =>\n\t`analytics: ${count} server events recorded inside a database transaction could not be stored once it ended. Logged at most once a minute.`\n\nconst DEFERRED_DROPPED = (count: number): string =>\n\t`analytics: ${count} server events recorded inside a database transaction were dropped: ${MAX_DEFERRED} were already waiting for theirs to end. Logged at most once a minute.`\n\nconst BUFFERED_DROPPED = (count: number): string =>\n\t`analytics: ${count} buffered hits could not be written and were dropped. Logged at most once a minute.`\n\n/**\n * Writes hits through an optional buffer bounded by size, age and hits held; a batch refused for\n * its rows goes again hit by hit, one refused for the database's state again whole, once.\n */\nexport const createHitWriter = (options: HitWriterOptions): HitWriter => {\n\tconst { store, logger } = options\n\tconst limits = resolveWriteBuffer(options.buffer)\n\tconst now = options.now ?? monotonicMs\n\tconst setTimer = options.setTimer ?? unrefTimer\n\tconst deferredFailed = rateLimitedReport(logger, now, DEFERRED_FAILED)\n\tconst deferredDropped = rateLimitedReport(logger, now, DEFERRED_DROPPED)\n\tconst deferrals = createDeferrals({\n\t\tnow,\n\t\tsetTimer,\n\t\tfailed: (error) => deferredFailed(1, error),\n\t\tdropped: () => deferredDropped(1, new Error('too many server events waiting')),\n\t})\n\tconst direct = (hit: HitRow): Promise<AppendResult> => store.append([hit])\n\tconst signals = options.signals ?? process\n\tif (limits === null) {\n\t\t// Without a buffer only deferred work can be lost, so the process is listened to once some\n\t\t// is waiting.\n\t\tconst shutdown = guardShutdown({\n\t\t\tsignals,\n\t\t\tlogger,\n\t\t\theld: deferrals.held,\n\t\t\tsettle: () => deferrals.settle(true),\n\t\t})\n\t\treturn {\n\t\t\twrite: direct,\n\t\t\tdefer(work, blocked) {\n\t\t\t\tshutdown.listen()\n\t\t\t\tdeferrals.add(work, blocked)\n\t\t\t},\n\t\t\tflush: () => deferrals.settle(false),\n\t\t\tasync close() {\n\t\t\t\tshutdown.release()\n\t\t\t\tawait deferrals.settle(true)\n\t\t\t},\n\t\t\tpending: () => 0,\n\t\t}\n\t}\n\t// biome-ignore lint/plugin/noProcessEnv: the platform's own markers, read once to warn at boot\n\tconst platform = serverlessPlatformOf(options.env ?? process.env)\n\tif (platform !== undefined) {\n\t\tlogger?.warn(\n\t\t\t`analytics: native buffer is on, and ${platform} is set. On a serverless platform a function can be frozen or stopped between requests, and the hits it still holds in memory are lost: turn the buffer off there.`\n\t\t)\n\t}\n\n\tlet waiting: HitRow[] = []\n\tlet writing = 0\n\tlet flushing: Promise<void> = Promise.resolve()\n\t/** A drain is chained behind the current one and has not started yet. */\n\tlet queued = false\n\tlet cancelTimer: (() => void) | null = null\n\tlet closed = false\n\tconst report = rateLimitedReport(logger, now, BUFFERED_DROPPED)\n\n\t/** Resolves with the store's refusal of `hits`, or null once they are written. */\n\tconst attempt = (hits: HitRow[]): Promise<unknown> =>\n\t\tstore.append(hits).then(\n\t\t\t() => null,\n\t\t\t(error: unknown) => error ?? new Error('analytics: the store refused a write')\n\t\t)\n\n\tconst pause = (ms: number): Promise<void> =>\n\t\tnew Promise((resolve) => {\n\t\t\tsetTimer(resolve, ms)\n\t\t})\n\n\tconst writeBatch = async (batch: HitRow[]): Promise<void> => {\n\t\tlet failure = await attempt(batch)\n\t\tif (failure === null) {\n\t\t\treturn\n\t\t}\n\t\tif (!isRowError(failure)) {\n\t\t\tawait pause(BATCH_RETRY_MS)\n\t\t\tfailure = await attempt(batch)\n\t\t\tif (failure === null) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (!isRowError(failure)) {\n\t\t\t\treport(batch.length, failure)\n\t\t\t\treturn\n\t\t\t}\n\t\t}\n\t\tlet lost = 0\n\t\tfor (const [index, hit] of batch.entries()) {\n\t\t\tconst refused = await attempt([hit])\n\t\t\tif (refused === null) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (!isRowError(refused)) {\n\t\t\t\treport(lost + batch.length - index, refused)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tlost += 1\n\t\t}\n\t\tif (lost > 0) {\n\t\t\treport(lost, failure)\n\t\t}\n\t}\n\n\tconst drain = async (): Promise<void> => {\n\t\tcancelTimer?.()\n\t\tcancelTimer = null\n\t\twhile (waiting.length > 0) {\n\t\t\tconst batch = waiting.slice(0, limits.maxSize)\n\t\t\twaiting = waiting.slice(batch.length)\n\t\t\twriting = batch.length\n\t\t\ttry {\n\t\t\t\tawait writeBatch(batch)\n\t\t\t} finally {\n\t\t\t\twriting = 0\n\t\t\t}\n\t\t}\n\t}\n\n\tconst drainBuffer = (): Promise<void> => {\n\t\tif (!queued) {\n\t\t\tqueued = true\n\t\t\tflushing = flushing\n\t\t\t\t.then(() => {\n\t\t\t\t\tqueued = false\n\t\t\t\t\treturn drain()\n\t\t\t\t})\n\t\t\t\t.catch(() => undefined)\n\t\t}\n\t\treturn flushing\n\t}\n\n\tconst flush = async (): Promise<void> => {\n\t\tawait deferrals.settle(false)\n\t\tawait drainBuffer()\n\t}\n\n\tconst pending = (): number => waiting.length + writing\n\n\tconst shutdown = guardShutdown({\n\t\tsignals,\n\t\tlogger,\n\t\theld: () => pending() + deferrals.held(),\n\t\tsettle: async (stopping) => {\n\t\t\tclosed ||= stopping\n\t\t\tawait deferrals.settle(true)\n\t\t\tawait drainBuffer()\n\t\t},\n\t})\n\tshutdown.listen()\n\n\treturn {\n\t\tasync write(hit, writeOptions) {\n\t\t\tconst bypass = writeOptions?.flush === true || isOrderHitId(hit.id)\n\t\t\twhile (!bypass && !closed && pending() >= limits.maxPending) {\n\t\t\t\tawait drainBuffer()\n\t\t\t}\n\t\t\tif (bypass || closed) {\n\t\t\t\treturn direct(hit)\n\t\t\t}\n\t\t\twaiting.push(hit)\n\t\t\tif (waiting.length >= limits.maxSize) {\n\t\t\t\tvoid drainBuffer()\n\t\t\t} else if (cancelTimer === null) {\n\t\t\t\tcancelTimer = setTimer(() => {\n\t\t\t\t\tcancelTimer = null\n\t\t\t\t\tvoid drainBuffer()\n\t\t\t\t}, limits.maxAgeMs)\n\t\t\t}\n\t\t\treturn undefined\n\t\t},\n\t\tdefer: deferrals.add,\n\t\tflush,\n\t\tasync close() {\n\t\t\tclosed = true\n\t\t\tshutdown.release()\n\t\t\tawait deferrals.settle(true)\n\t\t\tawait drainBuffer()\n\t\t},\n\t\tpending,\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { GeoResolver } from "./geoResolver.js";
|
|
2
2
|
|
|
3
3
|
//#region src/native/geo/composeGeoResolvers.d.ts
|
|
4
|
+
/** Asks each resolver in turn and answers the first location with a country, else an empty one. */
|
|
4
5
|
declare function composeGeoResolvers(...resolvers: GeoResolver[]): GeoResolver;
|
|
5
6
|
//#endregion
|
|
6
7
|
export { composeGeoResolvers };
|
|
@@ -1,12 +1,15 @@
|
|
|
1
|
+
import { loadsMaxmindAtRuntime, needsMaxmindSdk } from "./geoResolver.js";
|
|
1
2
|
//#region src/native/geo/composeGeoResolvers.ts
|
|
3
|
+
/** Asks each resolver in turn and answers the first location with a country, else an empty one. */
|
|
2
4
|
function composeGeoResolvers(...resolvers) {
|
|
3
|
-
|
|
5
|
+
const composed = async (headers, opts) => {
|
|
4
6
|
for (const resolve of resolvers) {
|
|
5
7
|
const geo = await resolve(headers, opts);
|
|
6
8
|
if (geo.country) return geo;
|
|
7
9
|
}
|
|
8
10
|
return {};
|
|
9
11
|
};
|
|
12
|
+
return resolvers.some(needsMaxmindSdk) ? loadsMaxmindAtRuntime(composed) : composed;
|
|
10
13
|
}
|
|
11
14
|
//#endregion
|
|
12
15
|
export { composeGeoResolvers };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"composeGeoResolvers.js","names":[],"sources":["../../../src/native/geo/composeGeoResolvers.ts"],"sourcesContent":["import
|
|
1
|
+
{"version":3,"file":"composeGeoResolvers.js","names":[],"sources":["../../../src/native/geo/composeGeoResolvers.ts"],"sourcesContent":["import {\n\ttype Geo,\n\ttype GeoResolver,\n\ttype GeoResolverOptions,\n\tloadsMaxmindAtRuntime,\n\tneedsMaxmindSdk,\n} from './geoResolver'\n\n/** Asks each resolver in turn and answers the first location with a country, else an empty one. */\nexport function composeGeoResolvers(...resolvers: GeoResolver[]): GeoResolver {\n\tconst composed = async (headers: Headers, opts?: GeoResolverOptions): Promise<Geo> => {\n\t\tfor (const resolve of resolvers) {\n\t\t\tconst geo = await resolve(headers, opts)\n\t\t\tif (geo.country) {\n\t\t\t\treturn geo\n\t\t\t}\n\t\t}\n\t\treturn {}\n\t}\n\treturn resolvers.some(needsMaxmindSdk) ? loadsMaxmindAtRuntime(composed) : composed\n}\n"],"mappings":";;;AASA,SAAgB,oBAAoB,GAAG,WAAuC;CAC7E,MAAM,WAAW,OAAO,SAAkB,SAA4C;EACrF,KAAK,MAAM,WAAW,WAAW;GAChC,MAAM,MAAM,MAAM,QAAQ,SAAS,IAAI;GACvC,IAAI,IAAI,SACP,OAAO;EAET;EACA,OAAO,CAAC;CACT;CACA,OAAO,UAAU,KAAK,eAAe,IAAI,sBAAsB,QAAQ,IAAI;AAC5E"}
|
|
@@ -1,17 +1,35 @@
|
|
|
1
|
+
import { TrustedPlatform } from "../../net/platform.js";
|
|
2
|
+
import { MaxmindSdk } from "../../core/sdks.js";
|
|
3
|
+
|
|
1
4
|
//#region src/native/geo/geoResolver.d.ts
|
|
2
5
|
interface Geo {
|
|
3
6
|
country?: string;
|
|
4
7
|
region?: string;
|
|
5
8
|
city?: string;
|
|
6
9
|
}
|
|
10
|
+
/** The install's request trust, handed to every resolver in a chain. */
|
|
7
11
|
interface GeoResolverOptions {
|
|
8
12
|
trustedProxyHops?: number;
|
|
13
|
+
/**
|
|
14
|
+
* The platform whose location headers may be read. Unset, no platform header is trusted: a
|
|
15
|
+
* visitor can send `cf-ipcountry` or `x-vercel-ip-country` themselves.
|
|
16
|
+
*/
|
|
17
|
+
trustedPlatform?: TrustedPlatform;
|
|
18
|
+
/**
|
|
19
|
+
* The plugin's `sdks.maxmind`, for a resolver that opens a MaxMind database and was handed no
|
|
20
|
+
* reader of its own.
|
|
21
|
+
*/
|
|
22
|
+
maxmind?: MaxmindSdk;
|
|
9
23
|
}
|
|
10
24
|
/**
|
|
11
|
-
* `opts` carries the install's
|
|
12
|
-
*
|
|
25
|
+
* `opts` carries the install's request trust. A resolver reading platform headers must read them
|
|
26
|
+
* only for `trustedPlatform`.
|
|
13
27
|
*/
|
|
14
28
|
type GeoResolver = (headers: Headers, opts?: GeoResolverOptions) => Geo | Promise<Geo>;
|
|
29
|
+
/**
|
|
30
|
+
* The location the install's `trustedPlatform` wrote into the request, and nothing at all
|
|
31
|
+
* without one, whichever platform headers the request carries.
|
|
32
|
+
*/
|
|
15
33
|
declare const platformHeaderResolver: GeoResolver;
|
|
16
34
|
declare const noopResolver: GeoResolver;
|
|
17
35
|
//#endregion
|
|
@@ -1,11 +1,47 @@
|
|
|
1
|
+
import { PLATFORM_HEADERS } from "../../net/platform.js";
|
|
1
2
|
//#region src/native/geo/geoResolver.ts
|
|
2
|
-
const
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
3
|
+
const GEO_FIELDS = [
|
|
4
|
+
"country",
|
|
5
|
+
"region",
|
|
6
|
+
"city"
|
|
7
|
+
];
|
|
8
|
+
/** The location fields of `values` that are non-empty text, any other value left out. */
|
|
9
|
+
const geoOf = (values) => {
|
|
10
|
+
const geo = {};
|
|
11
|
+
for (const field of GEO_FIELDS) {
|
|
12
|
+
const value = values[field];
|
|
13
|
+
if (typeof value === "string" && value !== "") geo[field] = value;
|
|
14
|
+
}
|
|
15
|
+
return geo;
|
|
16
|
+
};
|
|
17
|
+
/**
|
|
18
|
+
* The location the install's `trustedPlatform` wrote into the request, and nothing at all
|
|
19
|
+
* without one, whichever platform headers the request carries.
|
|
20
|
+
*/
|
|
21
|
+
const platformHeaderResolver = (headers, opts) => {
|
|
22
|
+
const platform = opts?.trustedPlatform;
|
|
23
|
+
if (platform === void 0) return {};
|
|
24
|
+
const names = PLATFORM_HEADERS[platform];
|
|
25
|
+
return {
|
|
26
|
+
country: headers.get(names.country) ?? void 0,
|
|
27
|
+
region: headers.get(names.region) ?? void 0,
|
|
28
|
+
city: headers.get(names.city) ?? void 0
|
|
29
|
+
};
|
|
30
|
+
};
|
|
7
31
|
const noopResolver = () => ({});
|
|
32
|
+
/** `Symbol.for`, so the `/geo` entry and the native adapter agree on it from separate bundles. */
|
|
33
|
+
const LOADS_MAXMIND = Symbol.for("@10x-media/analytics/geo-loads-maxmind");
|
|
34
|
+
/**
|
|
35
|
+
* Marks a resolver that loads `maxmind` at runtime unless the plugin hands it `sdks.maxmind`, so
|
|
36
|
+
* the native engine can warn at boot rather than at the first lookup.
|
|
37
|
+
*/
|
|
38
|
+
const loadsMaxmindAtRuntime = (resolver) => {
|
|
39
|
+
Reflect.set(resolver, LOADS_MAXMIND, true);
|
|
40
|
+
return resolver;
|
|
41
|
+
};
|
|
42
|
+
/** Whether a resolver, or one it composes, loads `maxmind` at runtime without `sdks.maxmind`. */
|
|
43
|
+
const needsMaxmindSdk = (resolver) => Reflect.get(resolver, LOADS_MAXMIND) === true;
|
|
8
44
|
//#endregion
|
|
9
|
-
export { noopResolver, platformHeaderResolver };
|
|
45
|
+
export { geoOf, loadsMaxmindAtRuntime, needsMaxmindSdk, noopResolver, platformHeaderResolver };
|
|
10
46
|
|
|
11
47
|
//# sourceMappingURL=geoResolver.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"geoResolver.js","names":[],"sources":["../../../src/native/geo/geoResolver.ts"],"sourcesContent":["
|
|
1
|
+
{"version":3,"file":"geoResolver.js","names":[],"sources":["../../../src/native/geo/geoResolver.ts"],"sourcesContent":["import type { MaxmindSdk } from '../../core/sdks'\nimport { PLATFORM_HEADERS, type TrustedPlatform } from '../../net/platform'\n\nexport interface Geo {\n\tcountry?: string\n\tregion?: string\n\tcity?: string\n}\n\nconst GEO_FIELDS = ['country', 'region', 'city'] as const satisfies ReadonlyArray<keyof Geo>\n\n/** The location fields of `values` that are non-empty text, any other value left out. */\nexport const geoOf = (values: Readonly<Partial<Record<keyof Geo, unknown>>>): Geo => {\n\tconst geo: Geo = {}\n\tfor (const field of GEO_FIELDS) {\n\t\tconst value = values[field]\n\t\tif (typeof value === 'string' && value !== '') {\n\t\t\tgeo[field] = value\n\t\t}\n\t}\n\treturn geo\n}\n\n/** The install's request trust, handed to every resolver in a chain. */\nexport interface GeoResolverOptions {\n\ttrustedProxyHops?: number\n\t/**\n\t * The platform whose location headers may be read. Unset, no platform header is trusted: a\n\t * visitor can send `cf-ipcountry` or `x-vercel-ip-country` themselves.\n\t */\n\ttrustedPlatform?: TrustedPlatform\n\t/**\n\t * The plugin's `sdks.maxmind`, for a resolver that opens a MaxMind database and was handed no\n\t * reader of its own.\n\t */\n\tmaxmind?: MaxmindSdk\n}\n\n/**\n * `opts` carries the install's request trust. A resolver reading platform headers must read them\n * only for `trustedPlatform`.\n */\nexport type GeoResolver = (headers: Headers, opts?: GeoResolverOptions) => Geo | Promise<Geo>\n\n/**\n * The location the install's `trustedPlatform` wrote into the request, and nothing at all\n * without one, whichever platform headers the request carries.\n */\nexport const platformHeaderResolver: GeoResolver = (headers, opts) => {\n\tconst platform = opts?.trustedPlatform\n\tif (platform === undefined) {\n\t\treturn {}\n\t}\n\tconst names = PLATFORM_HEADERS[platform]\n\treturn {\n\t\tcountry: headers.get(names.country) ?? undefined,\n\t\tregion: headers.get(names.region) ?? undefined,\n\t\tcity: headers.get(names.city) ?? undefined,\n\t}\n}\n\nexport const noopResolver: GeoResolver = () => ({})\n\n/** `Symbol.for`, so the `/geo` entry and the native adapter agree on it from separate bundles. */\nconst LOADS_MAXMIND = Symbol.for('@10x-media/analytics/geo-loads-maxmind')\n\n/**\n * Marks a resolver that loads `maxmind` at runtime unless the plugin hands it `sdks.maxmind`, so\n * the native engine can warn at boot rather than at the first lookup.\n */\nexport const loadsMaxmindAtRuntime = (resolver: GeoResolver): GeoResolver => {\n\tReflect.set(resolver, LOADS_MAXMIND, true)\n\treturn resolver\n}\n\n/** Whether a resolver, or one it composes, loads `maxmind` at runtime without `sdks.maxmind`. */\nexport const needsMaxmindSdk = (resolver: GeoResolver): boolean =>\n\tReflect.get(resolver, LOADS_MAXMIND) === true\n"],"mappings":";;AASA,MAAM,aAAa;CAAC;CAAW;CAAU;AAAM;;AAG/C,MAAa,SAAS,WAA+D;CACpF,MAAM,MAAW,CAAC;CAClB,KAAK,MAAM,SAAS,YAAY;EAC/B,MAAM,QAAQ,OAAO;EACrB,IAAI,OAAO,UAAU,YAAY,UAAU,IAC1C,IAAI,SAAS;CAEf;CACA,OAAO;AACR;;;;;AA2BA,MAAa,0BAAuC,SAAS,SAAS;CACrE,MAAM,WAAW,MAAM;CACvB,IAAI,aAAa,KAAA,GAChB,OAAO,CAAC;CAET,MAAM,QAAQ,iBAAiB;CAC/B,OAAO;EACN,SAAS,QAAQ,IAAI,MAAM,OAAO,KAAK,KAAA;EACvC,QAAQ,QAAQ,IAAI,MAAM,MAAM,KAAK,KAAA;EACrC,MAAM,QAAQ,IAAI,MAAM,IAAI,KAAK,KAAA;CAClC;AACD;AAEA,MAAa,sBAAmC,CAAC;;AAGjD,MAAM,gBAAgB,OAAO,IAAI,wCAAwC;;;;;AAMzE,MAAa,yBAAyB,aAAuC;CAC5E,QAAQ,IAAI,UAAU,eAAe,IAAI;CACzC,OAAO;AACR;;AAGA,MAAa,mBAAmB,aAC/B,QAAQ,IAAI,UAAU,aAAa,MAAM"}
|
|
@@ -1,14 +1,18 @@
|
|
|
1
|
+
import { MaxmindSdk } from "../../core/sdks.js";
|
|
1
2
|
import { GeoResolver } from "./geoResolver.js";
|
|
2
3
|
|
|
3
4
|
//#region src/native/geo/maxmindResolver.d.ts
|
|
4
5
|
interface MaxmindOptions {
|
|
5
6
|
dbPath: string;
|
|
7
|
+
/**
|
|
8
|
+
* `{ open }` from `maxmind`. Unset, the plugin's `sdks.maxmind` serves, and without either it is
|
|
9
|
+
* loaded at runtime, which a standalone build does not ship.
|
|
10
|
+
*/
|
|
11
|
+
sdk?: MaxmindSdk;
|
|
6
12
|
}
|
|
7
13
|
/**
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
* lookup error) degrades to empty geo after a single warning, so a missing or
|
|
11
|
-
* unconfigured database never breaks ingestion.
|
|
14
|
+
* MaxMind GeoLite2 resolver, opened on first use. Any failure degrades to empty geo after one
|
|
15
|
+
* warning, so a missing or unconfigured database never breaks ingestion.
|
|
12
16
|
*/
|
|
13
17
|
declare function maxmindResolver(options: MaxmindOptions): GeoResolver;
|
|
14
18
|
//#endregion
|
|
@@ -1,10 +1,11 @@
|
|
|
1
|
+
import { valueAt } from "../../core/values.js";
|
|
1
2
|
import { clientIpFromHeaders } from "../ingest/clientIp.js";
|
|
3
|
+
import { geoOf, loadsMaxmindAtRuntime } from "./geoResolver.js";
|
|
4
|
+
import { loadMaxmind } from "../../plugin/peers.js";
|
|
2
5
|
//#region src/native/geo/maxmindResolver.ts
|
|
3
6
|
/**
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
* lookup error) degrades to empty geo after a single warning, so a missing or
|
|
7
|
-
* unconfigured database never breaks ingestion.
|
|
7
|
+
* MaxMind GeoLite2 resolver, opened on first use. Any failure degrades to empty geo after one
|
|
8
|
+
* warning, so a missing or unconfigured database never breaks ingestion.
|
|
8
9
|
*/
|
|
9
10
|
function maxmindResolver(options) {
|
|
10
11
|
let readerPromise;
|
|
@@ -16,36 +17,39 @@ function maxmindResolver(options) {
|
|
|
16
17
|
}
|
|
17
18
|
return null;
|
|
18
19
|
};
|
|
19
|
-
const getReader = () => {
|
|
20
|
+
const getReader = (pluginSdk) => {
|
|
20
21
|
if (!readerPromise) readerPromise = (async () => {
|
|
21
|
-
const { open } = await
|
|
22
|
+
const { open } = options.sdk ?? pluginSdk ?? await loadMaxmind();
|
|
22
23
|
return open(options.dbPath);
|
|
23
24
|
})();
|
|
24
25
|
return readerPromise;
|
|
25
26
|
};
|
|
26
|
-
|
|
27
|
-
const ip = clientIpFromHeaders(headers, {
|
|
27
|
+
const resolve = async (headers, opts) => {
|
|
28
|
+
const ip = clientIpFromHeaders(headers, {
|
|
29
|
+
trustedProxyHops: opts?.trustedProxyHops,
|
|
30
|
+
trustedPlatform: opts?.trustedPlatform
|
|
31
|
+
});
|
|
28
32
|
if (!ip) return {};
|
|
29
33
|
let reader;
|
|
30
34
|
try {
|
|
31
|
-
reader = await getReader();
|
|
35
|
+
reader = await getReader(opts?.maxmind);
|
|
32
36
|
} catch (err) {
|
|
33
37
|
warn(err);
|
|
34
38
|
return {};
|
|
35
39
|
}
|
|
36
40
|
try {
|
|
37
|
-
const
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
};
|
|
41
|
+
const found = reader.get(ip);
|
|
42
|
+
return geoOf({
|
|
43
|
+
country: valueAt(found, "country.iso_code"),
|
|
44
|
+
region: valueAt(found, "subdivisions.0.iso_code"),
|
|
45
|
+
city: valueAt(found, "city.names.en")
|
|
46
|
+
});
|
|
44
47
|
} catch (err) {
|
|
45
48
|
warn(err);
|
|
46
49
|
return {};
|
|
47
50
|
}
|
|
48
51
|
};
|
|
52
|
+
return options.sdk ? resolve : loadsMaxmindAtRuntime(resolve);
|
|
49
53
|
}
|
|
50
54
|
//#endregion
|
|
51
55
|
export { maxmindResolver };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"maxmindResolver.js","names":[],"sources":["../../../src/native/geo/maxmindResolver.ts"],"sourcesContent":["import type {
|
|
1
|
+
{"version":3,"file":"maxmindResolver.js","names":[],"sources":["../../../src/native/geo/maxmindResolver.ts"],"sourcesContent":["import type { MaxmindReader, MaxmindSdk } from '../../core/sdks'\nimport { valueAt } from '../../core/values'\nimport { loadMaxmind } from '../../plugin/peers'\nimport { clientIpFromHeaders } from '../ingest/clientIp'\nimport {\n\ttype Geo,\n\ttype GeoResolver,\n\ttype GeoResolverOptions,\n\tgeoOf,\n\tloadsMaxmindAtRuntime,\n} from './geoResolver'\n\nexport interface MaxmindOptions {\n\tdbPath: string\n\t/**\n\t * `{ open }` from `maxmind`. Unset, the plugin's `sdks.maxmind` serves, and without either it is\n\t * loaded at runtime, which a standalone build does not ship.\n\t */\n\tsdk?: MaxmindSdk\n}\n\n/**\n * MaxMind GeoLite2 resolver, opened on first use. Any failure degrades to empty geo after one\n * warning, so a missing or unconfigured database never breaks ingestion.\n */\nexport function maxmindResolver(options: MaxmindOptions): GeoResolver {\n\tlet readerPromise: Promise<MaxmindReader> | undefined\n\tlet warned = false\n\n\tconst warn = (detail: unknown): null => {\n\t\tif (!warned) {\n\t\t\twarned = true\n\t\t\tconsole.warn(\n\t\t\t\t`[analytics] MaxMind geo unavailable for \"${options.dbPath}\"; geo will be empty.`,\n\t\t\t\tdetail instanceof Error ? detail.message : detail\n\t\t\t)\n\t\t}\n\t\treturn null\n\t}\n\n\tconst getReader = (pluginSdk: MaxmindSdk | undefined): Promise<MaxmindReader> => {\n\t\tif (!readerPromise) {\n\t\t\treaderPromise = (async () => {\n\t\t\t\tconst { open } = options.sdk ?? pluginSdk ?? (await loadMaxmind())\n\t\t\t\treturn open(options.dbPath)\n\t\t\t})()\n\t\t}\n\t\treturn readerPromise\n\t}\n\n\tconst resolve = async (headers: Headers, opts?: GeoResolverOptions): Promise<Geo> => {\n\t\tconst ip = clientIpFromHeaders(headers, {\n\t\t\ttrustedProxyHops: opts?.trustedProxyHops,\n\t\t\ttrustedPlatform: opts?.trustedPlatform,\n\t\t})\n\t\tif (!ip) {\n\t\t\treturn {}\n\t\t}\n\t\tlet reader: MaxmindReader\n\t\ttry {\n\t\t\treader = await getReader(opts?.maxmind)\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t\ttry {\n\t\t\tconst found = reader.get(ip)\n\t\t\treturn geoOf({\n\t\t\t\tcountry: valueAt(found, 'country.iso_code'),\n\t\t\t\tregion: valueAt(found, 'subdivisions.0.iso_code'),\n\t\t\t\tcity: valueAt(found, 'city.names.en'),\n\t\t\t})\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t}\n\treturn options.sdk ? resolve : loadsMaxmindAtRuntime(resolve)\n}\n"],"mappings":";;;;;;;;;AAyBA,SAAgB,gBAAgB,SAAsC;CACrE,IAAI;CACJ,IAAI,SAAS;CAEb,MAAM,QAAQ,WAA0B;EACvC,IAAI,CAAC,QAAQ;GACZ,SAAS;GACT,QAAQ,KACP,4CAA4C,QAAQ,OAAO,wBAC3D,kBAAkB,QAAQ,OAAO,UAAU,MAC5C;EACD;EACA,OAAO;CACR;CAEA,MAAM,aAAa,cAA8D;EAChF,IAAI,CAAC,eACJ,iBAAiB,YAAY;GAC5B,MAAM,EAAE,SAAS,QAAQ,OAAO,aAAc,MAAM,YAAY;GAChE,OAAO,KAAK,QAAQ,MAAM;EAC3B,GAAG;EAEJ,OAAO;CACR;CAEA,MAAM,UAAU,OAAO,SAAkB,SAA4C;EACpF,MAAM,KAAK,oBAAoB,SAAS;GACvC,kBAAkB,MAAM;GACxB,iBAAiB,MAAM;EACxB,CAAC;EACD,IAAI,CAAC,IACJ,OAAO,CAAC;EAET,IAAI;EACJ,IAAI;GACH,SAAS,MAAM,UAAU,MAAM,OAAO;EACvC,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;EACA,IAAI;GACH,MAAM,QAAQ,OAAO,IAAI,EAAE;GAC3B,OAAO,MAAM;IACZ,SAAS,QAAQ,OAAO,kBAAkB;IAC1C,QAAQ,QAAQ,OAAO,yBAAyB;IAChD,MAAM,QAAQ,OAAO,eAAe;GACrC,CAAC;EACF,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;CACD;CACA,OAAO,QAAQ,MAAM,UAAU,sBAAsB,OAAO;AAC7D"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { isRecord } from "../../core/values.js";
|
|
2
|
+
import { monotonicMs } from "../../core/monotonic.js";
|
|
3
|
+
import { geoOf } from "./geoResolver.js";
|
|
4
|
+
//#region src/native/geo/resolveGeo.ts
|
|
5
|
+
/** How often one resolver that keeps failing is reported, at most. */
|
|
6
|
+
const GEO_WARN_EVERY_MS = 60 * 6e4;
|
|
7
|
+
const warnedAt = /* @__PURE__ */ new WeakMap();
|
|
8
|
+
/**
|
|
9
|
+
* A failing or malformed resolver costs the event its location, never the event. Failures are
|
|
10
|
+
* reported at most once an hour per resolver.
|
|
11
|
+
*/
|
|
12
|
+
const resolveGeo = async (resolver, headers, options) => {
|
|
13
|
+
const { trust, warn } = options;
|
|
14
|
+
let answer;
|
|
15
|
+
try {
|
|
16
|
+
answer = await resolver(headers, trust);
|
|
17
|
+
} catch (err) {
|
|
18
|
+
const at = monotonicMs();
|
|
19
|
+
const last = warnedAt.get(resolver);
|
|
20
|
+
if (last === void 0 || at - last >= GEO_WARN_EVERY_MS) {
|
|
21
|
+
warnedAt.set(resolver, at);
|
|
22
|
+
warn?.(`analytics: the geo resolver threw, so events are stored without a location while it fails: ${String(err)}`);
|
|
23
|
+
}
|
|
24
|
+
return {};
|
|
25
|
+
}
|
|
26
|
+
return isRecord(answer) ? geoOf(answer) : {};
|
|
27
|
+
};
|
|
28
|
+
//#endregion
|
|
29
|
+
export { resolveGeo };
|
|
30
|
+
|
|
31
|
+
//# sourceMappingURL=resolveGeo.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolveGeo.js","names":[],"sources":["../../../src/native/geo/resolveGeo.ts"],"sourcesContent":["import { monotonicMs } from '../../core/monotonic'\nimport { isRecord } from '../../core/values'\nimport { type Geo, type GeoResolver, type GeoResolverOptions, geoOf } from './geoResolver'\n\n/** How often one resolver that keeps failing is reported, at most. */\nconst GEO_WARN_EVERY_MS = 60 * 60_000\n\nconst warnedAt = new WeakMap<GeoResolver, number>()\n\n/**\n * A failing or malformed resolver costs the event its location, never the event. Failures are\n * reported at most once an hour per resolver.\n */\nexport const resolveGeo = async (\n\tresolver: GeoResolver,\n\theaders: Headers,\n\toptions: { trust: GeoResolverOptions; warn?: (message: string) => void }\n): Promise<Geo> => {\n\tconst { trust, warn } = options\n\tlet answer: unknown\n\ttry {\n\t\tanswer = await resolver(headers, trust)\n\t} catch (err) {\n\t\tconst at = monotonicMs()\n\t\tconst last = warnedAt.get(resolver)\n\t\tif (last === undefined || at - last >= GEO_WARN_EVERY_MS) {\n\t\t\twarnedAt.set(resolver, at)\n\t\t\twarn?.(\n\t\t\t\t`analytics: the geo resolver threw, so events are stored without a location while it fails: ${String(err)}`\n\t\t\t)\n\t\t}\n\t\treturn {}\n\t}\n\treturn isRecord(answer) ? geoOf(answer) : {}\n}\n"],"mappings":";;;;;AAKA,MAAM,oBAAoB,KAAK;AAE/B,MAAM,2BAAW,IAAI,QAA6B;;;;;AAMlD,MAAa,aAAa,OACzB,UACA,SACA,YACkB;CAClB,MAAM,EAAE,OAAO,SAAS;CACxB,IAAI;CACJ,IAAI;EACH,SAAS,MAAM,SAAS,SAAS,KAAK;CACvC,SAAS,KAAK;EACb,MAAM,KAAK,YAAY;EACvB,MAAM,OAAO,SAAS,IAAI,QAAQ;EAClC,IAAI,SAAS,KAAA,KAAa,KAAK,QAAQ,mBAAmB;GACzD,SAAS,IAAI,UAAU,EAAE;GACzB,OACC,8FAA8F,OAAO,GAAG,GACzG;EACD;EACA,OAAO,CAAC;CACT;CACA,OAAO,SAAS,MAAM,IAAI,MAAM,MAAM,IAAI,CAAC;AAC5C"}
|
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
//#region src/native/ingest/bots.d.ts
|
|
2
2
|
/**
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
* since that call is trusted host code rather than a request off the internet.
|
|
3
|
+
* An empty agent counts as automated (every real browser sends one); the synthetic server agent
|
|
4
|
+
* never does, since that call is trusted host code.
|
|
6
5
|
*/
|
|
7
6
|
declare const isBot: (ua: string) => boolean;
|
|
8
7
|
type BotFilter = (ua: string) => boolean;
|
|
@@ -1,10 +1,8 @@
|
|
|
1
1
|
import "./device.js";
|
|
2
2
|
//#region src/native/ingest/bots.ts
|
|
3
3
|
/**
|
|
4
|
-
* Lowercase substrings of
|
|
5
|
-
*
|
|
6
|
-
* default agents of HTTP clients. Deliberately small and hand-held rather than a vendor list,
|
|
7
|
-
* so every entry can be justified against real agents and none of them can match a browser.
|
|
4
|
+
* Lowercase user-agent substrings of automated traffic. Hand-picked rather than a vendor list, so
|
|
5
|
+
* every entry is justified against real agents and none can match a browser.
|
|
8
6
|
*/
|
|
9
7
|
const BOT_MARKERS = new Set([
|
|
10
8
|
"bot",
|
|
@@ -38,15 +36,13 @@ const BOT_MARKERS = new Set([
|
|
|
38
36
|
"httpclient"
|
|
39
37
|
]);
|
|
40
38
|
/**
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
-
* otherwise count every Cubot handset as a crawler.
|
|
39
|
+
* Phone tokens stripped before scanning: `bot` must match mid-word (Googlebot) without counting
|
|
40
|
+
* every Cubot handset as a crawler.
|
|
44
41
|
*/
|
|
45
42
|
const NOT_BOT_TOKENS = ["cubot"];
|
|
46
43
|
/**
|
|
47
|
-
*
|
|
48
|
-
*
|
|
49
|
-
* since that call is trusted host code rather than a request off the internet.
|
|
44
|
+
* An empty agent counts as automated (every real browser sends one); the synthetic server agent
|
|
45
|
+
* never does, since that call is trusted host code.
|
|
50
46
|
*/
|
|
51
47
|
const isBot = (ua) => {
|
|
52
48
|
if (ua === "analytics-server") return false;
|
|
@@ -57,9 +53,8 @@ const isBot = (ua) => {
|
|
|
57
53
|
return false;
|
|
58
54
|
};
|
|
59
55
|
/**
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
* predicate silent for the life of the process.
|
|
56
|
+
* `filterBots` option as one predicate. A throwing host filter propagates to the handler, which
|
|
57
|
+
* keeps the event and logs once; swallowing it here would hide a broken predicate.
|
|
63
58
|
*/
|
|
64
59
|
const resolveBotFilter = (option) => {
|
|
65
60
|
if (option === false) return () => false;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bots.js","names":[],"sources":["../../../src/native/ingest/bots.ts"],"sourcesContent":["import { SERVER_USER_AGENT } from './device'\n\n/**\n * Lowercase substrings of
|
|
1
|
+
{"version":3,"file":"bots.js","names":[],"sources":["../../../src/native/ingest/bots.ts"],"sourcesContent":["import { SERVER_USER_AGENT } from './device'\n\n/**\n * Lowercase user-agent substrings of automated traffic. Hand-picked rather than a vendor list, so\n * every entry is justified against real agents and none can match a browser.\n */\nexport const BOT_MARKERS: ReadonlySet<string> = new Set([\n\t'bot',\n\t'crawl',\n\t'spider',\n\t'slurp',\n\t'headless',\n\t'lighthouse',\n\t'pagespeed',\n\t'gtmetrix',\n\t'pingdom',\n\t'statuscake',\n\t'datadog',\n\t'newrelic',\n\t'facebookexternalhit',\n\t'whatsapp',\n\t'embedly',\n\t'phantomjs',\n\t'puppeteer',\n\t'playwright',\n\t'selenium',\n\t'python-requests',\n\t'curl/',\n\t'wget/',\n\t'go-http-client',\n\t'okhttp',\n\t'axios/',\n\t'node-fetch',\n\t'java/',\n\t'libwww',\n\t'httpclient',\n])\n\n/**\n * Phone tokens stripped before scanning: `bot` must match mid-word (Googlebot) without counting\n * every Cubot handset as a crawler.\n */\nconst NOT_BOT_TOKENS: readonly string[] = ['cubot']\n\n/**\n * An empty agent counts as automated (every real browser sends one); the synthetic server agent\n * never does, since that call is trusted host code.\n */\nexport const isBot = (ua: string): boolean => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn false\n\t}\n\tlet agent = ua.trim().toLowerCase()\n\tif (agent === '') {\n\t\treturn true\n\t}\n\tfor (const token of NOT_BOT_TOKENS) {\n\t\tagent = agent.replaceAll(token, '')\n\t}\n\tfor (const marker of BOT_MARKERS) {\n\t\tif (agent.includes(marker)) {\n\t\t\treturn true\n\t\t}\n\t}\n\treturn false\n}\n\nexport type BotFilter = (ua: string) => boolean\n\n/**\n * `filterBots` option as one predicate. A throwing host filter propagates to the handler, which\n * keeps the event and logs once; swallowing it here would hide a broken predicate.\n */\nexport const resolveBotFilter = (option: boolean | BotFilter | undefined): BotFilter => {\n\tif (option === false) {\n\t\treturn () => false\n\t}\n\treturn typeof option === 'function' ? option : isBot\n}\n"],"mappings":";;;;;;AAMA,MAAa,cAAmC,IAAI,IAAI;CACvD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD,CAAC;;;;;AAMD,MAAM,iBAAoC,CAAC,OAAO;;;;;AAMlD,MAAa,SAAS,OAAwB;CAC7C,IAAI,OAAA,oBACH,OAAO;CAER,IAAI,QAAQ,GAAG,KAAK,EAAE,YAAY;CAClC,IAAI,UAAU,IACb,OAAO;CAER,KAAK,MAAM,SAAS,gBACnB,QAAQ,MAAM,WAAW,OAAO,EAAE;CAEnC,KAAK,MAAM,UAAU,aACpB,IAAI,MAAM,SAAS,MAAM,GACxB,OAAO;CAGT,OAAO;AACR;;;;;AAQA,MAAa,oBAAoB,WAAuD;CACvF,IAAI,WAAW,OACd,aAAa;CAEd,OAAO,OAAO,WAAW,aAAa,SAAS;AAChD"}
|
|
@@ -1,9 +1,8 @@
|
|
|
1
1
|
import "./device.js";
|
|
2
2
|
//#region src/native/ingest/browser.ts
|
|
3
3
|
/**
|
|
4
|
-
* Order
|
|
5
|
-
*
|
|
6
|
-
* borrowed the token from.
|
|
4
|
+
* Order matters: Chromium forks still claim Chrome and iOS browsers still claim Safari, so a fork
|
|
5
|
+
* must match before the engine it borrowed the token from.
|
|
7
6
|
*/
|
|
8
7
|
const BROWSERS = [
|
|
9
8
|
[/edg(?:a|ios|e)?\//, "edge"],
|
|
@@ -31,9 +30,8 @@ const lookup = (table, ua, fallback) => {
|
|
|
31
30
|
return table.find(([pattern]) => pattern.test(s))?.[1] ?? fallback;
|
|
32
31
|
};
|
|
33
32
|
/**
|
|
34
|
-
* Coarse browser family
|
|
35
|
-
*
|
|
36
|
-
* server events abstain from the browser breakdown rather than skewing it.
|
|
33
|
+
* Coarse browser family, `other` when unrecognized, undefined for the synthetic server agent so
|
|
34
|
+
* server events abstain from the breakdown rather than skewing it.
|
|
37
35
|
*/
|
|
38
36
|
const classifyBrowser = (ua) => lookup(BROWSERS, ua, "other");
|
|
39
37
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"browser.js","names":[],"sources":["../../../src/native/ingest/browser.ts"],"sourcesContent":["import { SERVER_USER_AGENT } from './device'\n\nexport type BrowserName = 'chrome' | 'safari' | 'firefox' | 'edge' | 'opera' | 'samsung' | 'other'\n\nexport type OsName = 'ios' | 'android' | 'windows' | 'macos' | 'linux' | 'chromeos' | 'other'\n\n/**\n * Order
|
|
1
|
+
{"version":3,"file":"browser.js","names":[],"sources":["../../../src/native/ingest/browser.ts"],"sourcesContent":["import { SERVER_USER_AGENT } from './device'\n\nexport type BrowserName = 'chrome' | 'safari' | 'firefox' | 'edge' | 'opera' | 'samsung' | 'other'\n\nexport type OsName = 'ios' | 'android' | 'windows' | 'macos' | 'linux' | 'chromeos' | 'other'\n\n/**\n * Order matters: Chromium forks still claim Chrome and iOS browsers still claim Safari, so a fork\n * must match before the engine it borrowed the token from.\n */\nconst BROWSERS: ReadonlyArray<[RegExp, BrowserName]> = [\n\t[/edg(?:a|ios|e)?\\//, 'edge'],\n\t[/\\bopr\\/|\\bopt\\/|\\bopera\\b/, 'opera'],\n\t[/samsungbrowser/, 'samsung'],\n\t[/firefox\\/|fxios\\//, 'firefox'],\n\t[/chrome\\/|crios\\/|chromium\\//, 'chrome'],\n\t[/safari\\//, 'safari'],\n]\n\n/**\n * `CrOS` and `Android` both sit inside an `X11`/`Linux` UA, so they are matched ahead of it.\n * `cros` needs its word boundaries: it is also a substring of `Microsoft`.\n */\nconst PLATFORMS: ReadonlyArray<[RegExp, OsName]> = [\n\t[/iphone|ipad|ipod/, 'ios'],\n\t[/android/, 'android'],\n\t[/\\bcros\\b/, 'chromeos'],\n\t[/windows|win64|win32/, 'windows'],\n\t[/macintosh|mac os x/, 'macos'],\n\t[/linux|x11/, 'linux'],\n]\n\nconst lookup = <T>(table: ReadonlyArray<[RegExp, T]>, ua: string, fallback: T): T | undefined => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn undefined\n\t}\n\tconst s = ua.toLowerCase()\n\treturn table.find(([pattern]) => pattern.test(s))?.[1] ?? fallback\n}\n\n/**\n * Coarse browser family, `other` when unrecognized, undefined for the synthetic server agent so\n * server events abstain from the breakdown rather than skewing it.\n */\nexport const classifyBrowser = (ua: string): BrowserName | undefined =>\n\tlookup(BROWSERS, ua, 'other')\n\n/**\n * Operating system from a user-agent's platform tokens, on the same terms as\n * `classifyBrowser`: `other` when nothing matches, undefined for the server agent.\n */\nexport const classifyOs = (ua: string): OsName | undefined => lookup(PLATFORMS, ua, 'other')\n"],"mappings":";;;;;;AAUA,MAAM,WAAiD;CACtD,CAAC,qBAAqB,MAAM;CAC5B,CAAC,6BAA6B,OAAO;CACrC,CAAC,kBAAkB,SAAS;CAC5B,CAAC,qBAAqB,SAAS;CAC/B,CAAC,+BAA+B,QAAQ;CACxC,CAAC,YAAY,QAAQ;AACtB;;;;;AAMA,MAAM,YAA6C;CAClD,CAAC,oBAAoB,KAAK;CAC1B,CAAC,WAAW,SAAS;CACrB,CAAC,YAAY,UAAU;CACvB,CAAC,uBAAuB,SAAS;CACjC,CAAC,sBAAsB,OAAO;CAC9B,CAAC,aAAa,OAAO;AACtB;AAEA,MAAM,UAAa,OAAmC,IAAY,aAA+B;CAChG,IAAI,OAAA,oBACH;CAED,MAAM,IAAI,GAAG,YAAY;CACzB,OAAO,MAAM,MAAM,CAAC,aAAa,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM;AAC3D;;;;;AAMA,MAAa,mBAAmB,OAC/B,OAAO,UAAU,IAAI,OAAO;;;;;AAM7B,MAAa,cAAc,OAAmC,OAAO,WAAW,IAAI,OAAO"}
|
|
@@ -1,20 +1,41 @@
|
|
|
1
|
+
import { PLATFORM_HEADERS } from "../../net/platform.js";
|
|
2
|
+
import { headerEntries } from "./requestHost.js";
|
|
1
3
|
//#region src/native/ingest/clientIp.ts
|
|
4
|
+
const forwardedChain = (headers) => headerEntries(headers, "x-forwarded-for");
|
|
2
5
|
/**
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
* forwarding a fabricated one.
|
|
6
|
-
*
|
|
7
|
-
* With `trustedProxyHops >= 1` the forwarded chain is the only source, counted from the right,
|
|
8
|
-
* and a chain shorter than the count answers null rather than falling back to a header the
|
|
9
|
-
* client could have written.
|
|
6
|
+
* First hop of `x-forwarded-for`, else `x-real-ip`, else null. With trusted hops or a platform set,
|
|
7
|
+
* only that source counts: a short chain or missing header answers null, never a fallback.
|
|
10
8
|
*/
|
|
11
9
|
const clientIpFromHeaders = (headers, opts = {}) => {
|
|
12
|
-
|
|
10
|
+
if (opts.trustedPlatform !== void 0) return headers.get(PLATFORM_HEADERS[opts.trustedPlatform].ip)?.trim() || null;
|
|
11
|
+
const chain = forwardedChain(headers);
|
|
13
12
|
const hops = opts.trustedProxyHops ?? 0;
|
|
14
13
|
if (hops >= 1) return chain[chain.length - hops] ?? null;
|
|
15
14
|
return chain[0] ?? (headers.get("x-real-ip")?.trim() || null);
|
|
16
15
|
};
|
|
16
|
+
/**
|
|
17
|
+
* Whether `headers` came through two or more proxies while the install trusts none of them, so
|
|
18
|
+
* the address read from them is the one the visitor wrote.
|
|
19
|
+
*/
|
|
20
|
+
const forwardedUntrusted = (headers, opts) => opts.trustedPlatform === void 0 && (opts.trustedProxyHops ?? 0) === 0 && forwardedChain(headers).length >= 2;
|
|
21
|
+
/**
|
|
22
|
+
* `headers` as if the request came from `ip`, written where {@link clientIpFromHeaders} reads it.
|
|
23
|
+
* Platform location headers are dropped: they describe the request's own address.
|
|
24
|
+
*/
|
|
25
|
+
const overlayClientIp = (headers, ip, opts) => {
|
|
26
|
+
const out = new Headers(headers);
|
|
27
|
+
for (const platform of Object.values(PLATFORM_HEADERS)) {
|
|
28
|
+
out.delete(platform.ip);
|
|
29
|
+
out.delete(platform.country);
|
|
30
|
+
out.delete(platform.region);
|
|
31
|
+
out.delete(platform.city);
|
|
32
|
+
}
|
|
33
|
+
if (opts.trustedPlatform !== void 0) out.set(PLATFORM_HEADERS[opts.trustedPlatform].ip, ip);
|
|
34
|
+
const hops = Math.max(1, opts.trustedProxyHops ?? 0);
|
|
35
|
+
out.set("x-forwarded-for", Array.from({ length: hops }, () => ip).join(", "));
|
|
36
|
+
return out;
|
|
37
|
+
};
|
|
17
38
|
//#endregion
|
|
18
|
-
export { clientIpFromHeaders };
|
|
39
|
+
export { clientIpFromHeaders, forwardedUntrusted, overlayClientIp };
|
|
19
40
|
|
|
20
41
|
//# sourceMappingURL=clientIp.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"clientIp.js","names":[],"sources":["../../../src/native/ingest/clientIp.ts"],"sourcesContent":["
|
|
1
|
+
{"version":3,"file":"clientIp.js","names":[],"sources":["../../../src/native/ingest/clientIp.ts"],"sourcesContent":["import { PLATFORM_HEADERS, type TrustedPlatform } from '../../net/platform'\nimport { headerEntries } from './requestHost'\n\nexport interface ClientIpOptions {\n\t/**\n\t * Trusted proxies counted from the right of `x-forwarded-for`; unset reads the leftmost entry.\n\t * No default of 1: behind a CDN plus a proxy it would collapse every visitor onto the CDN.\n\t */\n\ttrustedProxyHops?: number\n\t/**\n\t * The platform whose edge header carries the address instead: `x-real-ip` on Vercel,\n\t * `cf-connecting-ip` on Cloudflare. Never set together with `trustedProxyHops`.\n\t */\n\ttrustedPlatform?: TrustedPlatform\n}\n\nconst forwardedChain = (headers: Headers): string[] => headerEntries(headers, 'x-forwarded-for')\n\n/**\n * First hop of `x-forwarded-for`, else `x-real-ip`, else null. With trusted hops or a platform set,\n * only that source counts: a short chain or missing header answers null, never a fallback.\n */\nexport const clientIpFromHeaders = (\n\theaders: Headers,\n\topts: ClientIpOptions = {}\n): string | null => {\n\tif (opts.trustedPlatform !== undefined) {\n\t\treturn headers.get(PLATFORM_HEADERS[opts.trustedPlatform].ip)?.trim() || null\n\t}\n\tconst chain = forwardedChain(headers)\n\tconst hops = opts.trustedProxyHops ?? 0\n\tif (hops >= 1) {\n\t\treturn chain[chain.length - hops] ?? null\n\t}\n\treturn chain[0] ?? (headers.get('x-real-ip')?.trim() || null)\n}\n\n/**\n * Whether `headers` came through two or more proxies while the install trusts none of them, so\n * the address read from them is the one the visitor wrote.\n */\nexport const forwardedUntrusted = (headers: Headers, opts: ClientIpOptions): boolean =>\n\topts.trustedPlatform === undefined &&\n\t(opts.trustedProxyHops ?? 0) === 0 &&\n\tforwardedChain(headers).length >= 2\n\n/**\n * `headers` as if the request came from `ip`, written where {@link clientIpFromHeaders} reads it.\n * Platform location headers are dropped: they describe the request's own address.\n */\nexport const overlayClientIp = (headers: Headers, ip: string, opts: ClientIpOptions): Headers => {\n\tconst out = new Headers(headers)\n\tfor (const platform of Object.values(PLATFORM_HEADERS)) {\n\t\tout.delete(platform.ip)\n\t\tout.delete(platform.country)\n\t\tout.delete(platform.region)\n\t\tout.delete(platform.city)\n\t}\n\tif (opts.trustedPlatform !== undefined) {\n\t\tout.set(PLATFORM_HEADERS[opts.trustedPlatform].ip, ip)\n\t}\n\tconst hops = Math.max(1, opts.trustedProxyHops ?? 0)\n\tout.set('x-forwarded-for', Array.from({ length: hops }, () => ip).join(', '))\n\treturn out\n}\n"],"mappings":";;;AAgBA,MAAM,kBAAkB,YAA+B,cAAc,SAAS,iBAAiB;;;;;AAM/F,MAAa,uBACZ,SACA,OAAwB,CAAC,MACN;CACnB,IAAI,KAAK,oBAAoB,KAAA,GAC5B,OAAO,QAAQ,IAAI,iBAAiB,KAAK,iBAAiB,EAAE,GAAG,KAAK,KAAK;CAE1E,MAAM,QAAQ,eAAe,OAAO;CACpC,MAAM,OAAO,KAAK,oBAAoB;CACtC,IAAI,QAAQ,GACX,OAAO,MAAM,MAAM,SAAS,SAAS;CAEtC,OAAO,MAAM,OAAO,QAAQ,IAAI,WAAW,GAAG,KAAK,KAAK;AACzD;;;;;AAMA,MAAa,sBAAsB,SAAkB,SACpD,KAAK,oBAAoB,KAAA,MACxB,KAAK,oBAAoB,OAAO,KACjC,eAAe,OAAO,EAAE,UAAU;;;;;AAMnC,MAAa,mBAAmB,SAAkB,IAAY,SAAmC;CAChG,MAAM,MAAM,IAAI,QAAQ,OAAO;CAC/B,KAAK,MAAM,YAAY,OAAO,OAAO,gBAAgB,GAAG;EACvD,IAAI,OAAO,SAAS,EAAE;EACtB,IAAI,OAAO,SAAS,OAAO;EAC3B,IAAI,OAAO,SAAS,MAAM;EAC1B,IAAI,OAAO,SAAS,IAAI;CACzB;CACA,IAAI,KAAK,oBAAoB,KAAA,GAC5B,IAAI,IAAI,iBAAiB,KAAK,iBAAiB,IAAI,EAAE;CAEtD,MAAM,OAAO,KAAK,IAAI,GAAG,KAAK,oBAAoB,CAAC;CACnD,IAAI,IAAI,mBAAmB,MAAM,KAAK,EAAE,QAAQ,KAAK,SAAS,EAAE,EAAE,KAAK,IAAI,CAAC;CAC5E,OAAO;AACR"}
|
|
@@ -1,14 +1,12 @@
|
|
|
1
1
|
//#region src/native/ingest/device.ts
|
|
2
2
|
/**
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
* rather than piling into `desktop` and skewing it.
|
|
3
|
+
* User agent stamped on server events with no browser request behind them; they abstain from the
|
|
4
|
+
* device breakdown rather than piling into `desktop`.
|
|
6
5
|
*/
|
|
7
6
|
const SERVER_USER_AGENT = "analytics-server";
|
|
8
7
|
/**
|
|
9
|
-
* Coarse device class
|
|
10
|
-
*
|
|
11
|
-
* token an Android phone carries.
|
|
8
|
+
* Coarse device class, undefined for the server agent. Tablets are checked first because an
|
|
9
|
+
* Android tablet UA lacks the `Mobile` token an Android phone carries.
|
|
12
10
|
*/
|
|
13
11
|
const classifyDevice = (ua) => {
|
|
14
12
|
if (ua === "analytics-server") return;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"device.js","names":[],"sources":["../../../src/native/ingest/device.ts"],"sourcesContent":["export type DeviceType = 'desktop' | 'mobile' | 'tablet'\n\n/**\n *
|
|
1
|
+
{"version":3,"file":"device.js","names":[],"sources":["../../../src/native/ingest/device.ts"],"sourcesContent":["export type DeviceType = 'desktop' | 'mobile' | 'tablet'\n\n/**\n * User agent stamped on server events with no browser request behind them; they abstain from the\n * device breakdown rather than piling into `desktop`.\n */\nexport const SERVER_USER_AGENT = 'analytics-server'\n\n/**\n * Coarse device class, undefined for the server agent. Tablets are checked first because an\n * Android tablet UA lacks the `Mobile` token an Android phone carries.\n */\nexport const classifyDevice = (ua: string): DeviceType | undefined => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn undefined\n\t}\n\tconst s = ua.toLowerCase()\n\tif (/ipad|tablet|playbook|silk|kindle/.test(s) || (/android/.test(s) && !/mobi/.test(s))) {\n\t\treturn 'tablet'\n\t}\n\tif (/mobi|iphone|ipod|android|blackberry|iemobile|opera mini|windows phone/.test(s)) {\n\t\treturn 'mobile'\n\t}\n\treturn 'desktop'\n}\n"],"mappings":";;;;;AAMA,MAAa,oBAAoB;;;;;AAMjC,MAAa,kBAAkB,OAAuC;CACrE,IAAI,OAAA,oBACH;CAED,MAAM,IAAI,GAAG,YAAY;CACzB,IAAI,mCAAmC,KAAK,CAAC,KAAM,UAAU,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,GACrF,OAAO;CAER,IAAI,wEAAwE,KAAK,CAAC,GACjF,OAAO;CAER,OAAO;AACR"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import { PayloadRequest } from "payload";
|
|
1
|
+
import { Payload, PayloadRequest } from "payload";
|