@10x-media/analytics 1.0.0-beta.8 → 4.0.0-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +780 -0
- package/LICENSE +21 -21
- package/README.md +35 -36
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +19 -0
- package/dist/adapters/ga4/disableKey.js.map +1 -0
- package/dist/adapters/ga4/eventName.d.ts +9 -0
- package/dist/adapters/ga4/eventName.js +13 -0
- package/dist/adapters/ga4/eventName.js.map +1 -0
- package/dist/adapters/ga4/ga4.d.ts +29 -0
- package/dist/adapters/ga4/ga4.js +324 -112
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +14 -0
- package/dist/adapters/ga4/measurementId.js.map +1 -0
- package/dist/adapters/goalRead.js +112 -0
- package/dist/adapters/goalRead.js.map +1 -0
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +30 -3
- package/dist/adapters/plausible/plausible.js +198 -110
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +33 -9
- package/dist/adapters/posthog/posthog.js +307 -127
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/posthog/projectCheck.js +56 -0
- package/dist/adapters/posthog/projectCheck.js.map +1 -0
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +21 -3
- package/dist/adapters/umami/umami.js +334 -95
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +28 -25
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +49 -92
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +131 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/capture/withoutConsent.js +91 -0
- package/dist/capture/withoutConsent.js.map +1 -0
- package/dist/charts/BarList.d.ts +27 -13
- package/dist/charts/BarList.js +38 -77
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +17 -1
- package/dist/charts/bars.js +12 -11
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +198 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +51 -29
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +101 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +59 -26
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +347 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +105 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +340 -49
- package/dist/core/contract.js +7 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +535 -151
- package/dist/core/options.js +158 -214
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +114 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +349 -36
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +50 -14
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceLabel.d.ts +10 -0
- package/dist/core/sourceLabel.js +63 -0
- package/dist/core/sourceLabel.js.map +1 -0
- package/dist/core/sourceOptions.js +107 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/sourcePolicy.d.ts +55 -0
- package/dist/core/sourcePolicy.js +51 -0
- package/dist/core/sourcePolicy.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +15 -0
- package/dist/exports/adapters/ga4.d.ts +17 -1
- package/dist/exports/adapters/ga4.js +2 -1
- package/dist/exports/adapters/native.d.ts +29 -2
- package/dist/exports/adapters/native.js +5 -1
- package/dist/exports/adapters/plausible.d.ts +16 -1
- package/dist/exports/adapters/posthog.d.ts +16 -1
- package/dist/exports/adapters/umami.d.ts +16 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +45 -11
- package/dist/exports/client.js +23 -6
- package/dist/exports/geo.d.ts +4 -2
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/react.d.ts +5 -3
- package/dist/exports/react.js +1 -2
- package/dist/exports/routes.d.ts +19 -0
- package/dist/exports/routes.js +3 -0
- package/dist/exports/rsc.d.ts +33 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +18 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +6 -17
- package/dist/exports/tracker.js +3 -11
- package/dist/exports/types.d.ts +46 -14
- package/dist/exports/types.js +7 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +19 -7
- package/dist/fields/AnalyticsPanelField.js +123 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +17 -6
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +222 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
- package/dist/fields/config/FilterDimensionSelectField.js +49 -0
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
- package/dist/fields/config/FilterOperatorSelectField.js +59 -0
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +19 -31
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.d.ts +3 -0
- package/dist/fields/config/fetchSources.js +17 -23
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/sourcesState.js +19 -3
- package/dist/fields/config/sourcesState.js.map +1 -1
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
- package/dist/fields/config/useAnalyticsSources.js +23 -24
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
- package/dist/fields/config/useFilterCapabilities.js +60 -0
- package/dist/fields/config/useFilterCapabilities.js.map +1 -0
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +30 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +67 -38
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +79 -26
- package/dist/fields/readForDocument.js +451 -105
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +179 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +143 -124
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -22
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +40 -38
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +155 -47
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -25
- package/dist/goals/trackGoalAction.js +71 -66
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +69 -11
- package/dist/index.js +262 -192
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +79 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.js +27 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +103 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +31 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1627 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +199 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +110 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +5 -2
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +27 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +10 -0
- package/dist/native/ingest/bots.js +66 -0
- package/dist/native/ingest/bots.js.map +1 -0
- package/dist/native/ingest/browser.js +45 -0
- package/dist/native/ingest/browser.js.map +1 -0
- package/dist/native/ingest/clientIp.js +34 -8
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +185 -32
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +13 -0
- package/dist/native/ingest/language.js.map +1 -0
- package/dist/native/ingest/normalizeEvent.d.ts +73 -5
- package/dist/native/ingest/normalizeEvent.js +257 -51
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +46 -0
- package/dist/native/ingest/referrer.js.map +1 -0
- package/dist/native/ingest/requestHost.js +44 -0
- package/dist/native/ingest/requestHost.js.map +1 -0
- package/dist/native/ingest/resolveHostname.d.ts +20 -0
- package/dist/native/ingest/resolveHostname.js +51 -0
- package/dist/native/ingest/resolveHostname.js.map +1 -0
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +85 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +188 -68
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +10 -0
- package/dist/native/ingest/source.js +245 -16
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +33 -0
- package/dist/native/ingest/utm.js.map +1 -0
- package/dist/native/ingest/validate.js +25 -13
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +128 -9
- package/dist/native/nativeAdapter.js +395 -281
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +119 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +65 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +438 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +705 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +101 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +387 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +349 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +49 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +668 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +15 -0
- package/dist/native/store/types.js +10 -0
- package/dist/native/store/types.js.map +1 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +57 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +346 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +106 -53
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +24 -0
- package/dist/plugin/errors.js +86 -0
- package/dist/plugin/errors.js.map +1 -0
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.d.ts +1 -0
- package/dist/plugin/goalHint.js +35 -0
- package/dist/plugin/goalHint.js.map +1 -0
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +161 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +88 -52
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.d.ts +11 -0
- package/dist/plugin/readContextForRequest.js +79 -32
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +67 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +91 -21
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +138 -0
- package/dist/plugin/refreshEndpoint.js.map +1 -0
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +235 -29
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +61 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +23 -0
- package/dist/plugin/scopeChange.js.map +1 -0
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +50 -16
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +24 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/ProvidersListNotice.d.ts +11 -0
- package/dist/providers/ProvidersListNotice.js +36 -0
- package/dist/providers/ProvidersListNotice.js.map +1 -0
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +63 -0
- package/dist/providers/collection.js +372 -143
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +84 -0
- package/dist/providers/factory.js +86 -25
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +105 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +329 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +26 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/scopeUnique.js +41 -0
- package/dist/providers/scopeUnique.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +6 -13
- package/dist/query/fetchQuery.d.ts +36 -23
- package/dist/query/fetchQuery.js +96 -89
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +8 -2
- package/dist/query/parse.js +155 -108
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +27 -4
- package/dist/query/response.js +18 -0
- package/dist/query/response.js.map +1 -0
- package/dist/react/AnalyticsProvider.d.ts +42 -20
- package/dist/react/AnalyticsProvider.js +24 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -8
- package/dist/react/useAnalytics.js +31 -13
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/routes/captureRoute.d.ts +28 -0
- package/dist/routes/captureRoute.js +67 -0
- package/dist/routes/captureRoute.js.map +1 -0
- package/dist/routes/ingestRoute.d.ts +17 -0
- package/dist/routes/ingestRoute.js +17 -0
- package/dist/routes/ingestRoute.js.map +1 -0
- package/dist/site/AnalyticsScripts.d.ts +35 -0
- package/dist/site/AnalyticsScripts.js +44 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +43 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +71 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -71
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.d.ts +1 -0
- package/dist/surfacing/epoch.js +116 -0
- package/dist/surfacing/epoch.js.map +1 -0
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +119 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +30 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +222 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -11
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +174 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +5 -10
- package/dist/tracker/createTracker.js +437 -82
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +8 -0
- package/dist/tracker/exclusion.js +82 -0
- package/dist/tracker/exclusion.js.map +1 -0
- package/dist/tracker/gate.d.ts +8 -0
- package/dist/tracker/gate.js +244 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +23 -15
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +129 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +60 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +106 -0
- package/dist/tracker/sinks/ga4.js.map +1 -0
- package/dist/tracker/sinks/native.js +21 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +36 -18
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +145 -9
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +18 -10
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +54 -22
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +99 -44
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +266 -56
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +256 -55
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +253 -56
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +261 -57
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +265 -61
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +256 -56
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +240 -14
- package/dist/translations/keys.js +245 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +258 -58
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +16 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +270 -66
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +261 -55
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +261 -55
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +256 -56
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +110 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1667 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/ChoiceMenu.js +48 -0
- package/dist/ui/components/ChoiceMenu.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +25 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/components/SourcesNoticeBanner.js +20 -0
- package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +12 -8
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +9 -10
- package/dist/view/AnalyticsView.js +47 -19
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -174
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +155 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/consentShare.js +15 -0
- package/dist/view/consentShare.js.map +1 -0
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +92 -20
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +120 -3
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +13 -11
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +221 -118
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +120 -32
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +130 -25
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -59
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +42 -36
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -56
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +182 -116
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +179 -73
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +97 -53
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +50 -79
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +52 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +65 -8
- package/dist/view/viewProps.js +123 -36
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +85 -83
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +134 -100
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +27 -3
- package/dist/widgets/RealtimeCounter.js +90 -62
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +18 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaultLayout.d.ts +26 -0
- package/dist/widgets/defaultLayout.js +51 -0
- package/dist/widgets/defaultLayout.js.map +1 -0
- package/dist/widgets/defaults.d.ts +4 -3
- package/dist/widgets/defaults.js +76 -24
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +26 -0
- package/dist/widgets/filterCaption.js.map +1 -0
- package/dist/widgets/filterField.d.ts +15 -0
- package/dist/widgets/filterField.js +86 -0
- package/dist/widgets/filterField.js.map +1 -0
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +79 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +24 -0
- package/dist/widgets/prepareWidgetRead.js +110 -0
- package/dist/widgets/prepareWidgetRead.js.map +1 -0
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +32 -13
- package/dist/widgets/readForWidget.js +52 -63
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
- package/dist/widgets/readForWidgetBreakdown.js +71 -58
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +21 -17
- package/dist/widgets/readForWidgetGoals.js +72 -52
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
- package/dist/widgets/readForWidgetRealtime.js +69 -41
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +29 -24
- package/dist/widgets/readForWidgetSeries.js +66 -114
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +48 -0
- package/dist/widgets/readMeta.js +66 -0
- package/dist/widgets/readMeta.js.map +1 -0
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +56 -16
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +207 -124
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +16 -0
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +36 -26
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +61 -42
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/exports/next.d.ts +0 -3
- package/dist/exports/next.js +0 -3
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -121
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -14
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -161
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -29
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/applyDistinctDeltas.js +0 -9
- package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
- package/dist/native/rollups/bumpRollup.js +0 -73
- package/dist/native/rollups/bumpRollup.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -90
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertIfNew.js +0 -53
- package/dist/native/rollups/insertIfNew.js.map +0 -1
- package/dist/next/captureRewrites.d.ts +0 -41
- package/dist/next/captureRewrites.js +0 -56
- package/dist/next/captureRewrites.js.map +0 -1
- package/dist/next/posthogProxyRewrites.d.ts +0 -41
- package/dist/next/posthogProxyRewrites.js +0 -45
- package/dist/next/posthogProxyRewrites.js.map +0 -1
- package/dist/plugin/paths.js +0 -27
- package/dist/plugin/paths.js.map +0 -1
- package/dist/query/errors.js +0 -10
- package/dist/query/errors.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -14
- package/dist/tracker/sinks/posthog.d.ts +0 -14
- package/dist/tracker/sinks/umami.d.ts +0 -13
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -74
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -43
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -0,0 +1,347 @@
|
|
|
1
|
+
import { isOneOf, kindOf } from "./values.js";
|
|
2
|
+
import { siteAddress } from "./siteAddress.js";
|
|
3
|
+
import { isTrustedPlatform } from "../net/platform.js";
|
|
4
|
+
import { DEFAULT_PROXY_MAX_BODY_BYTES, DEFAULT_PROXY_TIMEOUT_MS } from "../capture/relay.js";
|
|
5
|
+
import { resolveAllowedOrigins } from "../capture/requestTrust.js";
|
|
6
|
+
import { CAPTURE_SLOTS, isCaptureSlot } from "../capture/slots.js";
|
|
7
|
+
import { DEFAULT_AUTO_CAPTURE, DEFAULT_ITEM_CAPTURE, NO_ITEM_CAPTURE } from "../tracker/config.js";
|
|
8
|
+
import { DEFAULT_TRACKER_SKIP } from "../tracker/skip.js";
|
|
9
|
+
import { DEFAULT_EXCLUSION_PARAM } from "../tracker/exclusion.js";
|
|
10
|
+
import { CONSENT_PHASES, WITHOUT_CONSENT_LEVELS, slotWithoutConsent } from "../capture/withoutConsent.js";
|
|
11
|
+
import { keysOf, optionalBoolean, optionsObject, positiveWhole } from "./optionChecks.js";
|
|
12
|
+
import { assertNamesAdapter } from "./sourceOptions.js";
|
|
13
|
+
//#region src/core/captureOptions.ts
|
|
14
|
+
const CAPTURE_KEYS = keysOf({
|
|
15
|
+
gate: true,
|
|
16
|
+
withoutConsent: true,
|
|
17
|
+
allowedOrigins: true,
|
|
18
|
+
exclusion: true,
|
|
19
|
+
slots: true,
|
|
20
|
+
paths: true,
|
|
21
|
+
autoCapture: true,
|
|
22
|
+
skip: true,
|
|
23
|
+
proxy: true
|
|
24
|
+
});
|
|
25
|
+
const SLOT_KEYS = keysOf({
|
|
26
|
+
global: true,
|
|
27
|
+
tenant: true
|
|
28
|
+
});
|
|
29
|
+
const PROXY_KEYS = keysOf({
|
|
30
|
+
timeoutMs: true,
|
|
31
|
+
maxBodyBytes: true
|
|
32
|
+
});
|
|
33
|
+
const AUTO_CAPTURE_FLAGS = [
|
|
34
|
+
"scrollDepth",
|
|
35
|
+
"outboundLinks",
|
|
36
|
+
"fileDownloads",
|
|
37
|
+
"goalAttribute",
|
|
38
|
+
"query"
|
|
39
|
+
];
|
|
40
|
+
const AUTO_CAPTURE_KEYS = keysOf({
|
|
41
|
+
scrollDepth: true,
|
|
42
|
+
outboundLinks: true,
|
|
43
|
+
fileDownloads: true,
|
|
44
|
+
goalAttribute: true,
|
|
45
|
+
query: true,
|
|
46
|
+
items: true
|
|
47
|
+
});
|
|
48
|
+
const ITEM_CAPTURE_KEYS = keysOf({
|
|
49
|
+
impressions: true,
|
|
50
|
+
clicks: true,
|
|
51
|
+
pages: true
|
|
52
|
+
});
|
|
53
|
+
const EXCLUSION_KEYS = keysOf({
|
|
54
|
+
param: true,
|
|
55
|
+
sites: true
|
|
56
|
+
});
|
|
57
|
+
/** Unreserved URL characters, so the copied link needs no escaping. */
|
|
58
|
+
const EXCLUSION_PARAM_PATTERN = /^[A-Za-z0-9._~-]{1,64}$/;
|
|
59
|
+
const GATE_REQUIRED = "analytics: capture.gate is required: 'all' holds every slot until your consent manager calls setGate, 'off' captures without a gate, or list the slots that wait. The plugin does not decide which tracking needs consent.";
|
|
60
|
+
/**
|
|
61
|
+
* The capture slots that can fill on this config, as far as config time can see; a scoped install's
|
|
62
|
+
* tenant slot counts whenever runtime providers could bring a capture adapter.
|
|
63
|
+
*/
|
|
64
|
+
const fillableSlots = (options, scoped) => {
|
|
65
|
+
const slots = options.capture?.slots;
|
|
66
|
+
const adapters = options.adapters;
|
|
67
|
+
const fillable = [];
|
|
68
|
+
if (slots?.global !== false) {
|
|
69
|
+
const id = slots?.global ?? options.platformAdapter ?? (adapters.length === 1 ? adapters[0]?.id : void 0);
|
|
70
|
+
if (adapters.some((adapter) => adapter.id === id && adapter.capture !== void 0)) fillable.push("global");
|
|
71
|
+
}
|
|
72
|
+
const providers = Boolean(options.providers?.collection) || options.providers?.resolve !== void 0;
|
|
73
|
+
if (scoped && slots?.tenant !== false && (providers || adapters.some((adapter) => adapter.capture !== void 0))) fillable.push("tenant");
|
|
74
|
+
return fillable;
|
|
75
|
+
};
|
|
76
|
+
/**
|
|
77
|
+
* A function's answer gates its slot unless it is exactly `false`, so a gate that forgets to
|
|
78
|
+
* return holds the slot rather than capturing without consent.
|
|
79
|
+
*/
|
|
80
|
+
const resolveGate = (option, required) => {
|
|
81
|
+
if (option === void 0) {
|
|
82
|
+
if (required) throw new Error(GATE_REQUIRED);
|
|
83
|
+
return () => true;
|
|
84
|
+
}
|
|
85
|
+
if (option === "all") return () => true;
|
|
86
|
+
if (option === "off") return () => false;
|
|
87
|
+
if (Array.isArray(option)) {
|
|
88
|
+
for (const slot of option) if (typeof slot !== "string" || !isCaptureSlot(slot)) throw new Error(`analytics: capture.gate lists ${kindOf(slot)}, which is not a capture slot ('global' or 'tenant')`);
|
|
89
|
+
const gated = new Set(option);
|
|
90
|
+
return ({ slot }) => gated.has(slot);
|
|
91
|
+
}
|
|
92
|
+
if (typeof option === "function") return (args) => option(args) !== false;
|
|
93
|
+
throw new Error(`analytics: capture.gate must be 'all', 'off', a list of slots or a function, got ${kindOf(option)}`);
|
|
94
|
+
};
|
|
95
|
+
const isLevel = (value) => isOneOf(WITHOUT_CONSENT_LEVELS, value);
|
|
96
|
+
const resolveWithoutConsent = (option) => {
|
|
97
|
+
if (option === void 0 || typeof option === "function") return option;
|
|
98
|
+
if (isLevel(option)) return {
|
|
99
|
+
pending: option,
|
|
100
|
+
refused: option
|
|
101
|
+
};
|
|
102
|
+
const phases = optionsObject(option, {
|
|
103
|
+
path: "capture.withoutConsent",
|
|
104
|
+
known: CONSENT_PHASES,
|
|
105
|
+
example: "'cookieless', 'off', an object such as { refused: 'off' } or a function"
|
|
106
|
+
});
|
|
107
|
+
const level = (phase) => {
|
|
108
|
+
const value = phases[phase];
|
|
109
|
+
if (value === void 0) return "cookieless";
|
|
110
|
+
if (!isLevel(value)) throw new Error(`analytics: capture.withoutConsent.${phase} must be 'cookieless' or 'off', got ${kindOf(value)}`);
|
|
111
|
+
return value;
|
|
112
|
+
};
|
|
113
|
+
return {
|
|
114
|
+
pending: level("pending"),
|
|
115
|
+
refused: level("refused")
|
|
116
|
+
};
|
|
117
|
+
};
|
|
118
|
+
/** Slots the gate may hold, judged without calling host code: a function may hold either. */
|
|
119
|
+
const heldAtBoot = (gate) => new Set(gate === "off" ? [] : Array.isArray(gate) ? gate : CAPTURE_SLOTS);
|
|
120
|
+
/**
|
|
121
|
+
* Whether a source following `capture.withoutConsent` may count without consent: unless the option
|
|
122
|
+
* is `'off'` in both phases, since a function may answer `'cookieless'`.
|
|
123
|
+
*/
|
|
124
|
+
const followingCountsWithoutConsent = (option) => typeof option === "function" || CONSENT_PHASES.some((phase) => (option?.[phase] ?? "cookieless") !== "off");
|
|
125
|
+
/** Whether a config adapter may fill `slot`, as far as the boot can tell without a request. */
|
|
126
|
+
const fillsAtBoot = (fill, slot, adapterId) => {
|
|
127
|
+
const configured = fill.capture.slots[slot];
|
|
128
|
+
if (configured === false) return false;
|
|
129
|
+
if (slot === "tenant") return fill.scoped && (configured === void 0 || configured === adapterId);
|
|
130
|
+
const only = fill.adapters.length === 1 ? fill.adapters[0]?.id : void 0;
|
|
131
|
+
return (configured || fill.platformAdapter || only) === adapterId;
|
|
132
|
+
};
|
|
133
|
+
/**
|
|
134
|
+
* Whether a config adapter may count without consent in a slot the gate holds, judged at boot
|
|
135
|
+
* without calling a host function: a `capture.withoutConsent` function may answer `'cookieless'`.
|
|
136
|
+
*/
|
|
137
|
+
const adapterCountsWithoutConsent = (fill, adapter) => {
|
|
138
|
+
const capture = adapter.capture;
|
|
139
|
+
if (!capture) return false;
|
|
140
|
+
const option = fill.capture.withoutConsent;
|
|
141
|
+
const answered = typeof option === "function" ? () => "cookieless" : option;
|
|
142
|
+
return CAPTURE_SLOTS.some((slot) => fill.capture.heldSlots.has(slot) && fillsAtBoot(fill, slot, adapter.id) && slotWithoutConsent({
|
|
143
|
+
slot,
|
|
144
|
+
adapterId: adapter.id,
|
|
145
|
+
kind: capture.client.kind,
|
|
146
|
+
capture,
|
|
147
|
+
option: answered
|
|
148
|
+
}) !== void 0);
|
|
149
|
+
};
|
|
150
|
+
/**
|
|
151
|
+
* Whether a held tenant slot may fall to a runtime provider document's adapter: with providers on,
|
|
152
|
+
* unless the slot names a config adapter.
|
|
153
|
+
*/
|
|
154
|
+
const documentsFillHeldTenant = (fill, providersOn) => {
|
|
155
|
+
const configured = fill.capture.slots.tenant;
|
|
156
|
+
return providersOn && fill.scoped && configured !== false && fill.capture.heldSlots.has("tenant") && !fill.adapters.some((adapter) => adapter.id === configured);
|
|
157
|
+
};
|
|
158
|
+
const resolveItemCapture = (option) => option === false ? { ...NO_ITEM_CAPTURE } : {
|
|
159
|
+
impressions: option?.impressions ?? DEFAULT_ITEM_CAPTURE.impressions,
|
|
160
|
+
clicks: option?.clicks ?? DEFAULT_ITEM_CAPTURE.clicks,
|
|
161
|
+
pages: option?.pages ?? DEFAULT_ITEM_CAPTURE.pages
|
|
162
|
+
};
|
|
163
|
+
const resolveAutoCapture = (option) => ({
|
|
164
|
+
scrollDepth: option?.scrollDepth ?? DEFAULT_AUTO_CAPTURE.scrollDepth,
|
|
165
|
+
outboundLinks: option?.outboundLinks ?? DEFAULT_AUTO_CAPTURE.outboundLinks,
|
|
166
|
+
fileDownloads: option?.fileDownloads ?? DEFAULT_AUTO_CAPTURE.fileDownloads,
|
|
167
|
+
goalAttribute: option?.goalAttribute ?? DEFAULT_AUTO_CAPTURE.goalAttribute,
|
|
168
|
+
query: option?.query ?? DEFAULT_AUTO_CAPTURE.query,
|
|
169
|
+
items: resolveItemCapture(option?.items)
|
|
170
|
+
});
|
|
171
|
+
/**
|
|
172
|
+
* The auto-capture the tracker is handed: item capture off while no collection is bound as items,
|
|
173
|
+
* since ingest would drop every ref it sent, so no page runs an observer for them.
|
|
174
|
+
*/
|
|
175
|
+
const trackerAutoCapture = (autoCapture, itemsBound) => itemsBound ? autoCapture : {
|
|
176
|
+
...autoCapture,
|
|
177
|
+
items: NO_ITEM_CAPTURE
|
|
178
|
+
};
|
|
179
|
+
/** A list checked once at boot; a function's answer is checked per request, by the endpoint. */
|
|
180
|
+
const resolveExclusionSites = (option) => {
|
|
181
|
+
if (option === void 0) return;
|
|
182
|
+
if (typeof option === "function") return option;
|
|
183
|
+
const invalid = Array.isArray(option) ? option.find((site) => siteAddress(site) === null) : option;
|
|
184
|
+
if (!Array.isArray(option) || invalid !== void 0) throw new Error(`analytics: capture.exclusion.sites must be a function or a list of http(s) addresses such as 'https://shop.example.com', got ${kindOf(invalid)}`);
|
|
185
|
+
const sites = option.flatMap((site) => {
|
|
186
|
+
const address = siteAddress(site);
|
|
187
|
+
return address === null ? [] : [address];
|
|
188
|
+
});
|
|
189
|
+
return () => sites;
|
|
190
|
+
};
|
|
191
|
+
const resolveExclusion = (option) => {
|
|
192
|
+
if (option === void 0 || option === false) return false;
|
|
193
|
+
if (option === true) return { param: DEFAULT_EXCLUSION_PARAM };
|
|
194
|
+
optionsObject(option, {
|
|
195
|
+
path: "capture.exclusion",
|
|
196
|
+
known: EXCLUSION_KEYS,
|
|
197
|
+
example: "true, false or an object such as { param: 'staff' }"
|
|
198
|
+
});
|
|
199
|
+
const param = option.param ?? "analytics_exclude";
|
|
200
|
+
if (typeof param !== "string" || !EXCLUSION_PARAM_PATTERN.test(param)) throw new Error(`analytics: capture.exclusion.param must be 1 to 64 letters, digits, ".", "_", "~" or "-", got ${kindOf(param)}`);
|
|
201
|
+
const sites = resolveExclusionSites(option.sites);
|
|
202
|
+
return sites ? {
|
|
203
|
+
param,
|
|
204
|
+
sites
|
|
205
|
+
} : { param };
|
|
206
|
+
};
|
|
207
|
+
const resolveSkip = (option) => {
|
|
208
|
+
if (option === void 0) return { ...DEFAULT_TRACKER_SKIP };
|
|
209
|
+
const shaped = optionsObject(option, {
|
|
210
|
+
path: "capture.skip",
|
|
211
|
+
known: Object.keys(DEFAULT_TRACKER_SKIP),
|
|
212
|
+
example: "an object such as { automation: false }"
|
|
213
|
+
});
|
|
214
|
+
const flag = (key) => optionalBoolean(shaped[key], `capture.skip.${key}`) ?? DEFAULT_TRACKER_SKIP[key];
|
|
215
|
+
return {
|
|
216
|
+
automation: flag("automation"),
|
|
217
|
+
previews: flag("previews")
|
|
218
|
+
};
|
|
219
|
+
};
|
|
220
|
+
/** Each of `capture.slots` or `capture.paths`, checked by `valid` and refused with `expected`. */
|
|
221
|
+
const assertPerSlot = (value, at) => {
|
|
222
|
+
if (value === void 0) return;
|
|
223
|
+
const perSlot = optionsObject(value, {
|
|
224
|
+
path: at.path,
|
|
225
|
+
known: SLOT_KEYS,
|
|
226
|
+
example: at.example
|
|
227
|
+
});
|
|
228
|
+
for (const [slot, entry] of Object.entries(perSlot)) if (entry !== void 0 && !at.valid(entry)) throw new Error(`analytics: ${at.path}.${slot} must be ${at.expected}, got ${kindOf(entry)}`);
|
|
229
|
+
};
|
|
230
|
+
/** `capture` and the objects inside it whose values are read as they are. */
|
|
231
|
+
const assertCaptureShape = (option) => {
|
|
232
|
+
if (option === void 0) return;
|
|
233
|
+
optionsObject(option, {
|
|
234
|
+
path: "capture",
|
|
235
|
+
known: CAPTURE_KEYS,
|
|
236
|
+
example: "an object such as { gate: 'off' }"
|
|
237
|
+
});
|
|
238
|
+
assertPerSlot(option.slots, {
|
|
239
|
+
path: "capture.slots",
|
|
240
|
+
example: "an object such as { global: 'native' }",
|
|
241
|
+
expected: "an adapter id or false",
|
|
242
|
+
valid: (entry) => entry === false || typeof entry === "string"
|
|
243
|
+
});
|
|
244
|
+
assertPerSlot(option.paths, {
|
|
245
|
+
path: "capture.paths",
|
|
246
|
+
example: "an object such as { global: '/stats' }",
|
|
247
|
+
expected: "a path starting with \"/\", such as \"/stats\"",
|
|
248
|
+
valid: (entry) => typeof entry === "string" && entry.startsWith("/")
|
|
249
|
+
});
|
|
250
|
+
if (option.proxy !== void 0) optionsObject(option.proxy, {
|
|
251
|
+
path: "capture.proxy",
|
|
252
|
+
known: PROXY_KEYS,
|
|
253
|
+
example: "an object such as { timeoutMs: 10000 }"
|
|
254
|
+
});
|
|
255
|
+
if (option.autoCapture === void 0) return;
|
|
256
|
+
const auto = optionsObject(option.autoCapture, {
|
|
257
|
+
path: "capture.autoCapture",
|
|
258
|
+
known: AUTO_CAPTURE_KEYS,
|
|
259
|
+
example: "an object such as { scrollDepth: true }"
|
|
260
|
+
});
|
|
261
|
+
for (const flag of AUTO_CAPTURE_FLAGS) optionalBoolean(auto[flag], `capture.autoCapture.${flag}`);
|
|
262
|
+
if (auto.items !== void 0 && auto.items !== false) {
|
|
263
|
+
const items = optionsObject(auto.items, {
|
|
264
|
+
path: "capture.autoCapture.items",
|
|
265
|
+
known: ITEM_CAPTURE_KEYS,
|
|
266
|
+
example: "false, or an object such as { clicks: false }"
|
|
267
|
+
});
|
|
268
|
+
for (const flag of ITEM_CAPTURE_KEYS) optionalBoolean(items[flag], `capture.autoCapture.items.${flag}`);
|
|
269
|
+
}
|
|
270
|
+
};
|
|
271
|
+
/**
|
|
272
|
+
* `capture` checked and filled. A global slot's adapter id is checked against `adapters` here; a
|
|
273
|
+
* tenant one may name a runtime provider instance, which only exists once a scope resolves.
|
|
274
|
+
*/
|
|
275
|
+
const resolveCapture = (options, scoped) => {
|
|
276
|
+
const option = options.capture;
|
|
277
|
+
assertCaptureShape(option);
|
|
278
|
+
const globalSlot = option?.slots?.global;
|
|
279
|
+
if (typeof globalSlot === "string") assertNamesAdapter(globalSlot, "capture.slots.global", options.adapters ?? []);
|
|
280
|
+
const gate = resolveGate(option?.gate, fillableSlots(options, scoped).length > 0);
|
|
281
|
+
const withoutConsent = resolveWithoutConsent(option?.withoutConsent);
|
|
282
|
+
const fill = {
|
|
283
|
+
adapters: options.adapters ?? [],
|
|
284
|
+
...options.platformAdapter ? { platformAdapter: options.platformAdapter } : {},
|
|
285
|
+
scoped,
|
|
286
|
+
capture: {
|
|
287
|
+
slots: {
|
|
288
|
+
global: globalSlot,
|
|
289
|
+
tenant: option?.slots?.tenant
|
|
290
|
+
},
|
|
291
|
+
heldSlots: heldAtBoot(option?.gate),
|
|
292
|
+
...withoutConsent === void 0 ? {} : { withoutConsent }
|
|
293
|
+
}
|
|
294
|
+
};
|
|
295
|
+
const providersOn = Boolean(options.providers?.collection) || options.providers?.resolve !== void 0;
|
|
296
|
+
return {
|
|
297
|
+
...fill.capture,
|
|
298
|
+
paths: {
|
|
299
|
+
global: option?.paths?.global,
|
|
300
|
+
tenant: option?.paths?.tenant
|
|
301
|
+
},
|
|
302
|
+
gate,
|
|
303
|
+
installCountsWithoutConsent: fill.adapters.some((adapter) => adapterCountsWithoutConsent(fill, adapter)) || documentsFillHeldTenant(fill, providersOn) && followingCountsWithoutConsent(withoutConsent),
|
|
304
|
+
autoCapture: resolveAutoCapture(option?.autoCapture),
|
|
305
|
+
proxy: {
|
|
306
|
+
timeoutMs: positiveWhole(option?.proxy?.timeoutMs, "capture.proxy.timeoutMs", DEFAULT_PROXY_TIMEOUT_MS),
|
|
307
|
+
maxBodyBytes: positiveWhole(option?.proxy?.maxBodyBytes, "capture.proxy.maxBodyBytes", DEFAULT_PROXY_MAX_BODY_BYTES)
|
|
308
|
+
},
|
|
309
|
+
allowedOrigins: resolveAllowedOrigins(option?.allowedOrigins),
|
|
310
|
+
exclusion: resolveExclusion(option?.exclusion),
|
|
311
|
+
skip: resolveSkip(option?.skip)
|
|
312
|
+
};
|
|
313
|
+
};
|
|
314
|
+
/** Where the client address and location come from: a proxy count, a platform, or neither. */
|
|
315
|
+
const resolveTrust = (options) => {
|
|
316
|
+
const hops = options.trustedProxyHops;
|
|
317
|
+
if (hops !== void 0 && (!Number.isInteger(hops) || hops < 0)) throw new Error(`analytics: trustedProxyHops must be a non-negative integer, got ${String(hops)}`);
|
|
318
|
+
const platform = options.trustedPlatform;
|
|
319
|
+
if (platform !== void 0 && !isTrustedPlatform(platform)) throw new Error(`analytics: trustedPlatform must be 'vercel' or 'cloudflare', got ${kindOf(platform)}`);
|
|
320
|
+
if (hops !== void 0 && platform !== void 0) throw new Error("analytics: trustedProxyHops and trustedPlatform cannot both be set. trustedPlatform reads the visitor address from the platform header, trustedProxyHops from x-forwarded-for: keep the one that describes what sits in front of the app.");
|
|
321
|
+
return {
|
|
322
|
+
...hops === void 0 ? {} : { trustedProxyHops: hops },
|
|
323
|
+
...platform === void 0 ? {} : { trustedPlatform: platform }
|
|
324
|
+
};
|
|
325
|
+
};
|
|
326
|
+
/**
|
|
327
|
+
* The production boot notice for an install reading visitor addresses and countries from headers
|
|
328
|
+
* nothing vouches for, or null.
|
|
329
|
+
*/
|
|
330
|
+
const untrustedAddressNotice = (resolved, production) => {
|
|
331
|
+
if (!production || resolved.trustedProxyHops !== void 0 || resolved.trustedPlatform !== void 0) return null;
|
|
332
|
+
return resolved.providers.collection.enabled || resolved.providers.resolve !== void 0 || resolved.adapters.some((adapter) => adapter.ingest !== void 0 || (adapter.capture?.proxy.routes.length ?? 0) > 0) ? "analytics: visitor IP addresses and countries can be spoofed on this install. Neither trustedProxyHops nor trustedPlatform is set, so the plugin reads them from request headers a visitor can write. Set trustedPlatform to 'vercel' or 'cloudflare' when the app runs behind one, or trustedProxyHops to the number of proxies in front of it." : null;
|
|
333
|
+
};
|
|
334
|
+
/**
|
|
335
|
+
* The boot line for an install leaving `capture.withoutConsent` unset while a held slot may count
|
|
336
|
+
* without consent, naming the default in effect; null otherwise.
|
|
337
|
+
*/
|
|
338
|
+
const withoutConsentUnsetNotice = (resolved) => resolved.capture.withoutConsent === void 0 && resolved.capture.installCountsWithoutConsent ? "analytics: capture.withoutConsent is unset, so held slots measure cookielessly before consent and after a refusal. Set it to 'off' to send nothing without consent." : null;
|
|
339
|
+
/**
|
|
340
|
+
* The production boot warning for a held slot counting without consent while nothing says where
|
|
341
|
+
* the client address comes from, or null: cookieless counting tells visitors apart by its hash.
|
|
342
|
+
*/
|
|
343
|
+
const cookielessTrustNotice = (resolved, production) => production && resolved.capture.installCountsWithoutConsent && resolved.trustedProxyHops === void 0 && resolved.trustedPlatform === void 0 ? "analytics: a held capture slot counts visitors cookielessly, telling them apart by a hash of the client IP address, yet neither trustedProxyHops nor trustedPlatform is set. Behind a proxy, a missing or wrong hop count hashes the proxy's address instead and collapses every visitor into one. Set trustedPlatform to 'vercel' or 'cloudflare', or trustedProxyHops to the number of proxies in front of the app." : null;
|
|
344
|
+
//#endregion
|
|
345
|
+
export { adapterCountsWithoutConsent, cookielessTrustNotice, documentsFillHeldTenant, fillableSlots, followingCountsWithoutConsent, resolveCapture, resolveTrust, trackerAutoCapture, untrustedAddressNotice, withoutConsentUnsetNotice };
|
|
346
|
+
|
|
347
|
+
//# sourceMappingURL=captureOptions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"captureOptions.js","names":[],"sources":["../../src/core/captureOptions.ts"],"sourcesContent":["import { DEFAULT_PROXY_MAX_BODY_BYTES, DEFAULT_PROXY_TIMEOUT_MS } from '../capture/proxyEndpoint'\nimport { resolveAllowedOrigins } from '../capture/requestTrust'\nimport { CAPTURE_SLOTS, isCaptureSlot } from '../capture/slots'\nimport {\n\tCONSENT_PHASES,\n\tslotWithoutConsent,\n\tWITHOUT_CONSENT_LEVELS,\n} from '../capture/withoutConsent'\nimport { isTrustedPlatform } from '../net/platform'\nimport type { CaptureSlot, ConsentPhase, TrackerSkip, WithoutConsentLevel } from '../tracker/config'\nimport {\n\tDEFAULT_AUTO_CAPTURE,\n\tDEFAULT_ITEM_CAPTURE,\n\tNO_ITEM_CAPTURE,\n\ttype ResolvedAutoCapture,\n\ttype ResolvedItemCapture,\n} from '../tracker/config'\nimport { DEFAULT_EXCLUSION_PARAM } from '../tracker/exclusion'\nimport { DEFAULT_TRACKER_SKIP } from '../tracker/skip'\nimport type { AnalyticsAdapter } from './contract'\nimport { keysOf, optionalBoolean, optionsObject, positiveWhole } from './optionChecks'\nimport type {\n\tAnalyticsCaptureOptions,\n\tAnalyticsExclusionOptions,\n\tAnalyticsPluginOptions,\n\tAutoCaptureOptions,\n\tCaptureGatePolicy,\n\tExclusionSitesResolver,\n\tItemCaptureOptions,\n\tResolvedCapture,\n\tResolvedOptions,\n\tResolvedWithoutConsent,\n} from './options'\nimport { siteAddress } from './siteAddress'\nimport { assertNamesAdapter } from './sourceOptions'\nimport { isOneOf, kindOf } from './values'\n\nconst CAPTURE_KEYS = keysOf<AnalyticsCaptureOptions>({\n\tgate: true,\n\twithoutConsent: true,\n\tallowedOrigins: true,\n\texclusion: true,\n\tslots: true,\n\tpaths: true,\n\tautoCapture: true,\n\tskip: true,\n\tproxy: true,\n})\nconst SLOT_KEYS = keysOf<NonNullable<AnalyticsCaptureOptions['slots']>>({\n\tglobal: true,\n\ttenant: true,\n})\nconst PROXY_KEYS = keysOf<NonNullable<AnalyticsCaptureOptions['proxy']>>({\n\ttimeoutMs: true,\n\tmaxBodyBytes: true,\n})\nconst AUTO_CAPTURE_FLAGS = [\n\t'scrollDepth',\n\t'outboundLinks',\n\t'fileDownloads',\n\t'goalAttribute',\n\t'query',\n] as const\nconst AUTO_CAPTURE_KEYS = keysOf<AutoCaptureOptions>({\n\tscrollDepth: true,\n\toutboundLinks: true,\n\tfileDownloads: true,\n\tgoalAttribute: true,\n\tquery: true,\n\titems: true,\n})\nconst ITEM_CAPTURE_KEYS = keysOf<ItemCaptureOptions>({\n\timpressions: true,\n\tclicks: true,\n\tpages: true,\n})\nconst EXCLUSION_KEYS = keysOf<AnalyticsExclusionOptions>({ param: true, sites: true })\n\n/** Unreserved URL characters, so the copied link needs no escaping. */\nconst EXCLUSION_PARAM_PATTERN = /^[A-Za-z0-9._~-]{1,64}$/\n\nconst GATE_REQUIRED =\n\t\"analytics: capture.gate is required: 'all' holds every slot until your consent manager calls setGate, 'off' captures without a gate, or list the slots that wait. The plugin does not decide which tracking needs consent.\"\n\n/**\n * The capture slots that can fill on this config, as far as config time can see; a scoped install's\n * tenant slot counts whenever runtime providers could bring a capture adapter.\n */\nexport const fillableSlots = (options: AnalyticsPluginOptions, scoped: boolean): CaptureSlot[] => {\n\tconst slots = options.capture?.slots\n\tconst adapters = options.adapters\n\tconst fillable: CaptureSlot[] = []\n\tif (slots?.global !== false) {\n\t\tconst id =\n\t\t\tslots?.global ??\n\t\t\toptions.platformAdapter ??\n\t\t\t(adapters.length === 1 ? adapters[0]?.id : undefined)\n\t\tif (adapters.some((adapter) => adapter.id === id && adapter.capture !== undefined)) {\n\t\t\tfillable.push('global')\n\t\t}\n\t}\n\tconst providers =\n\t\tBoolean(options.providers?.collection) || options.providers?.resolve !== undefined\n\tif (\n\t\tscoped &&\n\t\tslots?.tenant !== false &&\n\t\t(providers || adapters.some((adapter) => adapter.capture !== undefined))\n\t) {\n\t\tfillable.push('tenant')\n\t}\n\treturn fillable\n}\n\n/**\n * A function's answer gates its slot unless it is exactly `false`, so a gate that forgets to\n * return holds the slot rather than capturing without consent.\n */\nconst resolveGate = (\n\toption: AnalyticsCaptureOptions['gate'],\n\trequired: boolean\n): CaptureGatePolicy => {\n\tif (option === undefined) {\n\t\tif (required) {\n\t\t\tthrow new Error(GATE_REQUIRED)\n\t\t}\n\t\treturn () => true\n\t}\n\tif (option === 'all') {\n\t\treturn () => true\n\t}\n\tif (option === 'off') {\n\t\treturn () => false\n\t}\n\tif (Array.isArray(option)) {\n\t\tfor (const slot of option) {\n\t\t\tif (typeof slot !== 'string' || !isCaptureSlot(slot)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`analytics: capture.gate lists ${kindOf(slot)}, which is not a capture slot ('global' or 'tenant')`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\tconst gated = new Set<CaptureSlot>(option)\n\t\treturn ({ slot }) => gated.has(slot)\n\t}\n\tif (typeof option === 'function') {\n\t\treturn (args) => option(args) !== false\n\t}\n\tthrow new Error(\n\t\t`analytics: capture.gate must be 'all', 'off', a list of slots or a function, got ${kindOf(option)}`\n\t)\n}\n\nconst isLevel = (value: unknown): value is WithoutConsentLevel =>\n\tisOneOf(WITHOUT_CONSENT_LEVELS, value)\n\nconst resolveWithoutConsent = (\n\toption: AnalyticsCaptureOptions['withoutConsent']\n): ResolvedWithoutConsent | undefined => {\n\tif (option === undefined || typeof option === 'function') {\n\t\treturn option\n\t}\n\tif (isLevel(option)) {\n\t\treturn { pending: option, refused: option }\n\t}\n\tconst phases = optionsObject(option, {\n\t\tpath: 'capture.withoutConsent',\n\t\tknown: CONSENT_PHASES,\n\t\texample: \"'cookieless', 'off', an object such as { refused: 'off' } or a function\",\n\t})\n\tconst level = (phase: ConsentPhase): WithoutConsentLevel => {\n\t\tconst value = phases[phase]\n\t\tif (value === undefined) {\n\t\t\treturn 'cookieless'\n\t\t}\n\t\tif (!isLevel(value)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: capture.withoutConsent.${phase} must be 'cookieless' or 'off', got ${kindOf(value)}`\n\t\t\t)\n\t\t}\n\t\treturn value\n\t}\n\treturn { pending: level('pending'), refused: level('refused') }\n}\n\n/** Slots the gate may hold, judged without calling host code: a function may hold either. */\nconst heldAtBoot = (gate: AnalyticsCaptureOptions['gate']): ReadonlySet<CaptureSlot> =>\n\tnew Set(gate === 'off' ? [] : Array.isArray(gate) ? gate : CAPTURE_SLOTS)\n\n/**\n * Whether a source following `capture.withoutConsent` may count without consent: unless the option\n * is `'off'` in both phases, since a function may answer `'cookieless'`.\n */\nexport const followingCountsWithoutConsent = (\n\toption: ResolvedWithoutConsent | undefined\n): boolean =>\n\ttypeof option === 'function' ||\n\tCONSENT_PHASES.some((phase) => (option?.[phase] ?? 'cookieless') !== 'off')\n\n/** What the boot knows about which config adapter fills which slot; a resolved install is one. */\nexport interface BootFill {\n\tadapters: readonly AnalyticsAdapter[]\n\tplatformAdapter?: string\n\tscoped: boolean\n\tcapture: Pick<ResolvedCapture, 'slots' | 'heldSlots' | 'withoutConsent'>\n}\n\n/** Whether a config adapter may fill `slot`, as far as the boot can tell without a request. */\nconst fillsAtBoot = (fill: BootFill, slot: CaptureSlot, adapterId: string): boolean => {\n\tconst configured = fill.capture.slots[slot]\n\tif (configured === false) {\n\t\treturn false\n\t}\n\tif (slot === 'tenant') {\n\t\treturn fill.scoped && (configured === undefined || configured === adapterId)\n\t}\n\tconst only = fill.adapters.length === 1 ? fill.adapters[0]?.id : undefined\n\treturn (configured || fill.platformAdapter || only) === adapterId\n}\n\n/**\n * Whether a config adapter may count without consent in a slot the gate holds, judged at boot\n * without calling a host function: a `capture.withoutConsent` function may answer `'cookieless'`.\n */\nexport const adapterCountsWithoutConsent = (fill: BootFill, adapter: AnalyticsAdapter): boolean => {\n\tconst capture = adapter.capture\n\tif (!capture) {\n\t\treturn false\n\t}\n\tconst option = fill.capture.withoutConsent\n\tconst answered = typeof option === 'function' ? () => 'cookieless' as const : option\n\treturn CAPTURE_SLOTS.some(\n\t\t(slot) =>\n\t\t\tfill.capture.heldSlots.has(slot) &&\n\t\t\tfillsAtBoot(fill, slot, adapter.id) &&\n\t\t\tslotWithoutConsent({\n\t\t\t\tslot,\n\t\t\t\tadapterId: adapter.id,\n\t\t\t\tkind: capture.client.kind,\n\t\t\t\tcapture,\n\t\t\t\toption: answered,\n\t\t\t}) !== undefined\n\t)\n}\n\n/**\n * Whether a held tenant slot may fall to a runtime provider document's adapter: with providers on,\n * unless the slot names a config adapter.\n */\nexport const documentsFillHeldTenant = (\n\tfill: Pick<BootFill, 'adapters' | 'scoped' | 'capture'>,\n\tprovidersOn: boolean\n): boolean => {\n\tconst configured = fill.capture.slots.tenant\n\treturn (\n\t\tprovidersOn &&\n\t\tfill.scoped &&\n\t\tconfigured !== false &&\n\t\tfill.capture.heldSlots.has('tenant') &&\n\t\t!fill.adapters.some((adapter) => adapter.id === configured)\n\t)\n}\n\nconst resolveItemCapture = (option: AutoCaptureOptions['items']): ResolvedItemCapture =>\n\toption === false\n\t\t? { ...NO_ITEM_CAPTURE }\n\t\t: {\n\t\t\t\timpressions: option?.impressions ?? DEFAULT_ITEM_CAPTURE.impressions,\n\t\t\t\tclicks: option?.clicks ?? DEFAULT_ITEM_CAPTURE.clicks,\n\t\t\t\tpages: option?.pages ?? DEFAULT_ITEM_CAPTURE.pages,\n\t\t\t}\n\nconst resolveAutoCapture = (option: AutoCaptureOptions | undefined): ResolvedAutoCapture => ({\n\tscrollDepth: option?.scrollDepth ?? DEFAULT_AUTO_CAPTURE.scrollDepth,\n\toutboundLinks: option?.outboundLinks ?? DEFAULT_AUTO_CAPTURE.outboundLinks,\n\tfileDownloads: option?.fileDownloads ?? DEFAULT_AUTO_CAPTURE.fileDownloads,\n\tgoalAttribute: option?.goalAttribute ?? DEFAULT_AUTO_CAPTURE.goalAttribute,\n\tquery: option?.query ?? DEFAULT_AUTO_CAPTURE.query,\n\titems: resolveItemCapture(option?.items),\n})\n\n/**\n * The auto-capture the tracker is handed: item capture off while no collection is bound as items,\n * since ingest would drop every ref it sent, so no page runs an observer for them.\n */\nexport const trackerAutoCapture = (\n\tautoCapture: ResolvedAutoCapture,\n\titemsBound: boolean\n): ResolvedAutoCapture => (itemsBound ? autoCapture : { ...autoCapture, items: NO_ITEM_CAPTURE })\n\n/** A list checked once at boot; a function's answer is checked per request, by the endpoint. */\nconst resolveExclusionSites = (\n\toption: AnalyticsExclusionOptions['sites']\n): ExclusionSitesResolver | undefined => {\n\tif (option === undefined) {\n\t\treturn undefined\n\t}\n\tif (typeof option === 'function') {\n\t\treturn option\n\t}\n\tconst invalid: unknown = Array.isArray(option)\n\t\t? option.find((site) => siteAddress(site) === null)\n\t\t: option\n\tif (!Array.isArray(option) || invalid !== undefined) {\n\t\tthrow new Error(\n\t\t\t`analytics: capture.exclusion.sites must be a function or a list of http(s) addresses such as 'https://shop.example.com', got ${kindOf(invalid)}`\n\t\t)\n\t}\n\tconst sites = option.flatMap((site) => {\n\t\tconst address = siteAddress(site)\n\t\treturn address === null ? [] : [address]\n\t})\n\treturn () => sites\n}\n\nconst resolveExclusion = (\n\toption: AnalyticsCaptureOptions['exclusion']\n): ResolvedCapture['exclusion'] => {\n\tif (option === undefined || option === false) {\n\t\treturn false\n\t}\n\tif (option === true) {\n\t\treturn { param: DEFAULT_EXCLUSION_PARAM }\n\t}\n\toptionsObject(option, {\n\t\tpath: 'capture.exclusion',\n\t\tknown: EXCLUSION_KEYS,\n\t\texample: \"true, false or an object such as { param: 'staff' }\",\n\t})\n\tconst param = option.param ?? DEFAULT_EXCLUSION_PARAM\n\tif (typeof param !== 'string' || !EXCLUSION_PARAM_PATTERN.test(param)) {\n\t\tthrow new Error(\n\t\t\t`analytics: capture.exclusion.param must be 1 to 64 letters, digits, \".\", \"_\", \"~\" or \"-\", got ${kindOf(param)}`\n\t\t)\n\t}\n\tconst sites = resolveExclusionSites(option.sites)\n\treturn sites ? { param, sites } : { param }\n}\n\nconst resolveSkip = (option: AnalyticsCaptureOptions['skip']): TrackerSkip => {\n\tif (option === undefined) {\n\t\treturn { ...DEFAULT_TRACKER_SKIP }\n\t}\n\tconst shaped = optionsObject(option, {\n\t\tpath: 'capture.skip',\n\t\tknown: Object.keys(DEFAULT_TRACKER_SKIP),\n\t\texample: 'an object such as { automation: false }',\n\t})\n\tconst flag = (key: keyof TrackerSkip): boolean =>\n\t\toptionalBoolean(shaped[key], `capture.skip.${key}`) ?? DEFAULT_TRACKER_SKIP[key]\n\treturn { automation: flag('automation'), previews: flag('previews') }\n}\n\n/** Each of `capture.slots` or `capture.paths`, checked by `valid` and refused with `expected`. */\nconst assertPerSlot = (\n\tvalue: unknown,\n\tat: { path: string; example: string; expected: string; valid: (entry: unknown) => boolean }\n): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tconst perSlot = optionsObject(value, { path: at.path, known: SLOT_KEYS, example: at.example })\n\tfor (const [slot, entry] of Object.entries(perSlot)) {\n\t\tif (entry !== undefined && !at.valid(entry)) {\n\t\t\tthrow new Error(`analytics: ${at.path}.${slot} must be ${at.expected}, got ${kindOf(entry)}`)\n\t\t}\n\t}\n}\n\n/** `capture` and the objects inside it whose values are read as they are. */\nconst assertCaptureShape = (option: AnalyticsCaptureOptions | undefined): void => {\n\tif (option === undefined) {\n\t\treturn\n\t}\n\toptionsObject(option, {\n\t\tpath: 'capture',\n\t\tknown: CAPTURE_KEYS,\n\t\texample: \"an object such as { gate: 'off' }\",\n\t})\n\tassertPerSlot(option.slots, {\n\t\tpath: 'capture.slots',\n\t\texample: \"an object such as { global: 'native' }\",\n\t\texpected: 'an adapter id or false',\n\t\tvalid: (entry) => entry === false || typeof entry === 'string',\n\t})\n\tassertPerSlot(option.paths, {\n\t\tpath: 'capture.paths',\n\t\texample: \"an object such as { global: '/stats' }\",\n\t\texpected: 'a path starting with \"/\", such as \"/stats\"',\n\t\tvalid: (entry) => typeof entry === 'string' && entry.startsWith('/'),\n\t})\n\tif (option.proxy !== undefined) {\n\t\toptionsObject(option.proxy, {\n\t\t\tpath: 'capture.proxy',\n\t\t\tknown: PROXY_KEYS,\n\t\t\texample: 'an object such as { timeoutMs: 10000 }',\n\t\t})\n\t}\n\tif (option.autoCapture === undefined) {\n\t\treturn\n\t}\n\tconst auto = optionsObject(option.autoCapture, {\n\t\tpath: 'capture.autoCapture',\n\t\tknown: AUTO_CAPTURE_KEYS,\n\t\texample: 'an object such as { scrollDepth: true }',\n\t})\n\tfor (const flag of AUTO_CAPTURE_FLAGS) {\n\t\toptionalBoolean(auto[flag], `capture.autoCapture.${flag}`)\n\t}\n\tif (auto.items !== undefined && auto.items !== false) {\n\t\tconst items = optionsObject(auto.items, {\n\t\t\tpath: 'capture.autoCapture.items',\n\t\t\tknown: ITEM_CAPTURE_KEYS,\n\t\t\texample: 'false, or an object such as { clicks: false }',\n\t\t})\n\t\tfor (const flag of ITEM_CAPTURE_KEYS) {\n\t\t\toptionalBoolean(items[flag], `capture.autoCapture.items.${flag}`)\n\t\t}\n\t}\n}\n\n/**\n * `capture` checked and filled. A global slot's adapter id is checked against `adapters` here; a\n * tenant one may name a runtime provider instance, which only exists once a scope resolves.\n */\nexport const resolveCapture = (\n\toptions: AnalyticsPluginOptions,\n\tscoped: boolean\n): ResolvedCapture => {\n\tconst option = options.capture\n\tassertCaptureShape(option)\n\tconst globalSlot = option?.slots?.global\n\tif (typeof globalSlot === 'string') {\n\t\tassertNamesAdapter(globalSlot, 'capture.slots.global', options.adapters ?? [])\n\t}\n\tconst gate = resolveGate(option?.gate, fillableSlots(options, scoped).length > 0)\n\tconst withoutConsent = resolveWithoutConsent(option?.withoutConsent)\n\tconst fill: BootFill = {\n\t\tadapters: options.adapters ?? [],\n\t\t...(options.platformAdapter ? { platformAdapter: options.platformAdapter } : {}),\n\t\tscoped,\n\t\tcapture: {\n\t\t\tslots: { global: globalSlot, tenant: option?.slots?.tenant },\n\t\t\theldSlots: heldAtBoot(option?.gate),\n\t\t\t...(withoutConsent === undefined ? {} : { withoutConsent }),\n\t\t},\n\t}\n\tconst providersOn =\n\t\tBoolean(options.providers?.collection) || options.providers?.resolve !== undefined\n\treturn {\n\t\t...fill.capture,\n\t\tpaths: { global: option?.paths?.global, tenant: option?.paths?.tenant },\n\t\tgate,\n\t\tinstallCountsWithoutConsent:\n\t\t\tfill.adapters.some((adapter) => adapterCountsWithoutConsent(fill, adapter)) ||\n\t\t\t(documentsFillHeldTenant(fill, providersOn) && followingCountsWithoutConsent(withoutConsent)),\n\t\tautoCapture: resolveAutoCapture(option?.autoCapture),\n\t\tproxy: {\n\t\t\ttimeoutMs: positiveWhole(\n\t\t\t\toption?.proxy?.timeoutMs,\n\t\t\t\t'capture.proxy.timeoutMs',\n\t\t\t\tDEFAULT_PROXY_TIMEOUT_MS\n\t\t\t),\n\t\t\tmaxBodyBytes: positiveWhole(\n\t\t\t\toption?.proxy?.maxBodyBytes,\n\t\t\t\t'capture.proxy.maxBodyBytes',\n\t\t\t\tDEFAULT_PROXY_MAX_BODY_BYTES\n\t\t\t),\n\t\t},\n\t\tallowedOrigins: resolveAllowedOrigins(option?.allowedOrigins),\n\t\texclusion: resolveExclusion(option?.exclusion),\n\t\tskip: resolveSkip(option?.skip),\n\t}\n}\n\n/** Where the client address and location come from: a proxy count, a platform, or neither. */\nexport const resolveTrust = (\n\toptions: AnalyticsPluginOptions\n): Pick<ResolvedOptions, 'trustedProxyHops' | 'trustedPlatform'> => {\n\tconst hops = options.trustedProxyHops\n\tif (hops !== undefined && (!Number.isInteger(hops) || hops < 0)) {\n\t\tthrow new Error(\n\t\t\t`analytics: trustedProxyHops must be a non-negative integer, got ${String(hops)}`\n\t\t)\n\t}\n\tconst platform: unknown = options.trustedPlatform\n\tif (platform !== undefined && !isTrustedPlatform(platform)) {\n\t\tthrow new Error(\n\t\t\t`analytics: trustedPlatform must be 'vercel' or 'cloudflare', got ${kindOf(platform)}`\n\t\t)\n\t}\n\tif (hops !== undefined && platform !== undefined) {\n\t\tthrow new Error(\n\t\t\t'analytics: trustedProxyHops and trustedPlatform cannot both be set. trustedPlatform reads the visitor address from the platform header, trustedProxyHops from x-forwarded-for: keep the one that describes what sits in front of the app.'\n\t\t)\n\t}\n\treturn {\n\t\t...(hops === undefined ? {} : { trustedProxyHops: hops }),\n\t\t...(platform === undefined ? {} : { trustedPlatform: platform }),\n\t}\n}\n\n/**\n * The production boot notice for an install reading visitor addresses and countries from headers\n * nothing vouches for, or null.\n */\nexport const untrustedAddressNotice = (\n\tresolved: Pick<\n\t\tResolvedOptions,\n\t\t'trustedProxyHops' | 'trustedPlatform' | 'adapters' | 'providers'\n\t>,\n\tproduction: boolean\n): string | null => {\n\tif (\n\t\t!production ||\n\t\tresolved.trustedProxyHops !== undefined ||\n\t\tresolved.trustedPlatform !== undefined\n\t) {\n\t\treturn null\n\t}\n\tconst reads =\n\t\tresolved.providers.collection.enabled ||\n\t\tresolved.providers.resolve !== undefined ||\n\t\tresolved.adapters.some(\n\t\t\t(adapter) => adapter.ingest !== undefined || (adapter.capture?.proxy.routes.length ?? 0) > 0\n\t\t)\n\treturn reads\n\t\t? \"analytics: visitor IP addresses and countries can be spoofed on this install. Neither trustedProxyHops nor trustedPlatform is set, so the plugin reads them from request headers a visitor can write. Set trustedPlatform to 'vercel' or 'cloudflare' when the app runs behind one, or trustedProxyHops to the number of proxies in front of it.\"\n\t\t: null\n}\n\n/**\n * The boot line for an install leaving `capture.withoutConsent` unset while a held slot may count\n * without consent, naming the default in effect; null otherwise.\n */\nexport const withoutConsentUnsetNotice = (\n\tresolved: Pick<ResolvedOptions, 'capture'>\n): string | null =>\n\tresolved.capture.withoutConsent === undefined && resolved.capture.installCountsWithoutConsent\n\t\t? \"analytics: capture.withoutConsent is unset, so held slots measure cookielessly before consent and after a refusal. Set it to 'off' to send nothing without consent.\"\n\t\t: null\n\n/**\n * The production boot warning for a held slot counting without consent while nothing says where\n * the client address comes from, or null: cookieless counting tells visitors apart by its hash.\n */\nexport const cookielessTrustNotice = (\n\tresolved: Pick<ResolvedOptions, 'trustedProxyHops' | 'trustedPlatform' | 'capture'>,\n\tproduction: boolean\n): string | null =>\n\tproduction &&\n\tresolved.capture.installCountsWithoutConsent &&\n\tresolved.trustedProxyHops === undefined &&\n\tresolved.trustedPlatform === undefined\n\t\t? \"analytics: a held capture slot counts visitors cookielessly, telling them apart by a hash of the client IP address, yet neither trustedProxyHops nor trustedPlatform is set. Behind a proxy, a missing or wrong hop count hashes the proxy's address instead and collapses every visitor into one. Set trustedPlatform to 'vercel' or 'cloudflare', or trustedProxyHops to the number of proxies in front of the app.\"\n\t\t: null\n"],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { getCurrentDate } from "payload";
|
|
2
|
+
//#region src/core/clock.ts
|
|
3
|
+
/**
|
|
4
|
+
* What time it is for every server-side read: Payload's own clock, so a test that sets it moves
|
|
5
|
+
* every day cut, lease and cache stamp at once. Durations run on `monotonicMs`.
|
|
6
|
+
*/
|
|
7
|
+
const currentDate = () => getCurrentDate();
|
|
8
|
+
/** {@link currentDate} in epoch milliseconds. */
|
|
9
|
+
const currentTime = () => getCurrentDate().getTime();
|
|
10
|
+
//#endregion
|
|
11
|
+
export { currentDate, currentTime };
|
|
12
|
+
|
|
13
|
+
//# sourceMappingURL=clock.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"clock.js","names":[],"sources":["../../src/core/clock.ts"],"sourcesContent":["import { getCurrentDate } from 'payload'\n\n/**\n * What time it is for every server-side read: Payload's own clock, so a test that sets it moves\n * every day cut, lease and cache stamp at once. Durations run on `monotonicMs`.\n */\nexport const currentDate = (): Date => getCurrentDate()\n\n/** {@link currentDate} in epoch milliseconds. */\nexport const currentTime = (): number => getCurrentDate().getTime()\n"],"mappings":";;;;;;AAMA,MAAa,oBAA0B,eAAe;;AAGtD,MAAa,oBAA4B,eAAe,EAAE,QAAQ"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { CollectionConfig } from "payload";
|
|
2
|
+
|
|
3
|
+
//#region src/core/collectionOption.d.ts
|
|
4
|
+
/** Reshapes one of the plugin's generated collections; handed the finished config, it returns one. */
|
|
5
|
+
type CollectionOverrides = (collection: CollectionConfig) => CollectionConfig;
|
|
6
|
+
/** A plugin collection's name and shape, as each option naming one takes them. */
|
|
7
|
+
type AnalyticsCollectionOptions = {
|
|
8
|
+
/** The slug every part of the plugin reads the collection under. */slug?: string;
|
|
9
|
+
/**
|
|
10
|
+
* Reshapes the generated collection last. It may not rename it (`slug` does that) nor take away
|
|
11
|
+
* what the plugin reads and writes: the boot checks both, naming the collection and the field.
|
|
12
|
+
*/
|
|
13
|
+
overrides?: CollectionOverrides;
|
|
14
|
+
};
|
|
15
|
+
//#endregion
|
|
16
|
+
export { AnalyticsCollectionOptions, CollectionOverrides };
|
|
17
|
+
//# sourceMappingURL=collectionOption.d.ts.map
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { kindOf } from "./values.js";
|
|
2
|
+
import { flatFieldName, keysOf, optionsObject } from "./optionChecks.js";
|
|
3
|
+
//#region src/core/collectionOption.ts
|
|
4
|
+
/** Only that it is a function can be checked at run time; the option's type promises the rest. */
|
|
5
|
+
const isOverrides = (value) => typeof value === "function";
|
|
6
|
+
/** `overrides` checked at boot: a function or nothing, since no object is ever merged in. */
|
|
7
|
+
const overridesOf = (value, path) => {
|
|
8
|
+
if (value === void 0) return;
|
|
9
|
+
if (!isOverrides(value)) throw new Error(`analytics: ${path} must be a function, (collection) => collection, got ${kindOf(value)}`);
|
|
10
|
+
return value;
|
|
11
|
+
};
|
|
12
|
+
/** A collection slug option checked at boot, trimmed, or the default when unset. */
|
|
13
|
+
const slugOf = (value, path, fallback) => {
|
|
14
|
+
if (value === void 0) return fallback;
|
|
15
|
+
if (typeof value !== "string" || value.trim() === "") throw new Error(`analytics: ${path} must be a non-empty collection slug, got ${kindOf(value)}`);
|
|
16
|
+
return value.trim();
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* One `{ slug, overrides }` option checked at boot. `path` names it in every refusal, and `extra`
|
|
20
|
+
* lists the other keys the option takes beside those two.
|
|
21
|
+
*/
|
|
22
|
+
const resolveCollectionOption = (value, where) => {
|
|
23
|
+
const { path, fallback, extra = [] } = where;
|
|
24
|
+
if (value === void 0) return { slug: fallback };
|
|
25
|
+
const shaped = optionsObject(value, {
|
|
26
|
+
path,
|
|
27
|
+
known: [
|
|
28
|
+
"slug",
|
|
29
|
+
"overrides",
|
|
30
|
+
...extra
|
|
31
|
+
],
|
|
32
|
+
example: `an object such as { slug: '${fallback}' }`
|
|
33
|
+
});
|
|
34
|
+
const overrides = overridesOf(shaped.overrides, `${path}.overrides`);
|
|
35
|
+
return {
|
|
36
|
+
slug: slugOf(shaped.slug, `${path}.slug`, fallback),
|
|
37
|
+
...overrides ? { overrides } : {}
|
|
38
|
+
};
|
|
39
|
+
};
|
|
40
|
+
/** The field a scoped plugin collection stamps each document's scope into, by default. */
|
|
41
|
+
const DEFAULT_SCOPE_FIELD = "scope";
|
|
42
|
+
const COLLECTION_ACCESS_KEYS = keysOf({
|
|
43
|
+
admin: true,
|
|
44
|
+
create: true,
|
|
45
|
+
delete: true,
|
|
46
|
+
read: true,
|
|
47
|
+
readVersions: true,
|
|
48
|
+
unlock: true,
|
|
49
|
+
update: true,
|
|
50
|
+
validate: true
|
|
51
|
+
});
|
|
52
|
+
/** `access` on one of the plugin's collections: a Payload access function per operation. */
|
|
53
|
+
const assertCollectionAccess = (value, path) => {
|
|
54
|
+
if (value === void 0) return;
|
|
55
|
+
const access = optionsObject(value, {
|
|
56
|
+
path,
|
|
57
|
+
known: COLLECTION_ACCESS_KEYS,
|
|
58
|
+
example: "an object such as { read }"
|
|
59
|
+
});
|
|
60
|
+
for (const [operation, fn] of Object.entries(access)) if (fn !== void 0 && typeof fn !== "function") throw new Error(`analytics: ${path}.${operation} must be an access function, got ${kindOf(fn)}`);
|
|
61
|
+
};
|
|
62
|
+
/** A collection's `fields` overrides: one function per field it may replace. */
|
|
63
|
+
const assertFieldOverrides = (value, path, known) => {
|
|
64
|
+
if (value === void 0) return;
|
|
65
|
+
const fields = optionsObject(value, {
|
|
66
|
+
path,
|
|
67
|
+
known,
|
|
68
|
+
example: "an object such as { name: ({ defaultField }) => defaultField }"
|
|
69
|
+
});
|
|
70
|
+
for (const [name, override] of Object.entries(fields)) if (override !== void 0 && typeof override !== "function") throw new Error(`analytics: ${path}.${name} must be a function receiving { defaultField }, got ${kindOf(override)}`);
|
|
71
|
+
};
|
|
72
|
+
/**
|
|
73
|
+
* A scoped collection option: off when unset or false, on under its defaults for `true`, and an
|
|
74
|
+
* object checked for its keys, `fields`, `access`, `overrides`, slug and scope field.
|
|
75
|
+
*/
|
|
76
|
+
const resolveScopedCollection = (option, at) => {
|
|
77
|
+
if (option === void 0 || typeof option === "boolean") return {
|
|
78
|
+
enabled: option === true,
|
|
79
|
+
slug: at.fallback,
|
|
80
|
+
scopeField: DEFAULT_SCOPE_FIELD
|
|
81
|
+
};
|
|
82
|
+
const shaped = optionsObject(option, {
|
|
83
|
+
path: at.path,
|
|
84
|
+
known: at.known,
|
|
85
|
+
example: `true, or an object such as { slug: '${at.exampleSlug}' }`
|
|
86
|
+
});
|
|
87
|
+
assertFieldOverrides(shaped.fields, `${at.path}.fields`, at.fieldKeys);
|
|
88
|
+
assertCollectionAccess(shaped.access, `${at.path}.access`);
|
|
89
|
+
const overrides = overridesOf(option.overrides, `${at.path}.overrides`);
|
|
90
|
+
return {
|
|
91
|
+
enabled: true,
|
|
92
|
+
slug: slugOf(option.slug, `${at.path}.slug`, at.fallback),
|
|
93
|
+
scopeField: flatFieldName(option.scopeField ?? DEFAULT_SCOPE_FIELD, {
|
|
94
|
+
path: `${at.path}.scopeField`,
|
|
95
|
+
reason: "the scope stamp writes it as a flat key"
|
|
96
|
+
}),
|
|
97
|
+
...option.fields ? { fields: option.fields } : {},
|
|
98
|
+
...overrides ? { overrides } : {},
|
|
99
|
+
...option.access ? { access: option.access } : {}
|
|
100
|
+
};
|
|
101
|
+
};
|
|
102
|
+
//#endregion
|
|
103
|
+
export { resolveCollectionOption, resolveScopedCollection };
|
|
104
|
+
|
|
105
|
+
//# sourceMappingURL=collectionOption.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collectionOption.js","names":[],"sources":["../../src/core/collectionOption.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\nimport { flatFieldName, keysOf, optionsObject } from './optionChecks'\nimport { kindOf } from './values'\n\n/** Reshapes one of the plugin's generated collections; handed the finished config, it returns one. */\nexport type CollectionOverrides = (collection: CollectionConfig) => CollectionConfig\n\n/** A plugin collection's name and shape, as each option naming one takes them. */\nexport type AnalyticsCollectionOptions = {\n\t/** The slug every part of the plugin reads the collection under. */\n\tslug?: string\n\t/**\n\t * Reshapes the generated collection last. It may not rename it (`slug` does that) nor take away\n\t * what the plugin reads and writes: the boot checks both, naming the collection and the field.\n\t */\n\toverrides?: CollectionOverrides\n}\n\nexport interface ResolvedCollectionOption {\n\tslug: string\n\toverrides?: CollectionOverrides\n}\n\n/** Only that it is a function can be checked at run time; the option's type promises the rest. */\nconst isOverrides = (value: unknown): value is CollectionOverrides => typeof value === 'function'\n\n/** `overrides` checked at boot: a function or nothing, since no object is ever merged in. */\nexport const overridesOf = (value: unknown, path: string): CollectionOverrides | undefined => {\n\tif (value === undefined) {\n\t\treturn undefined\n\t}\n\tif (!isOverrides(value)) {\n\t\tthrow new Error(\n\t\t\t`analytics: ${path} must be a function, (collection) => collection, got ${kindOf(value)}`\n\t\t)\n\t}\n\treturn value\n}\n\n/** A collection slug option checked at boot, trimmed, or the default when unset. */\nexport const slugOf = (value: unknown, path: string, fallback: string): string => {\n\tif (value === undefined) {\n\t\treturn fallback\n\t}\n\tif (typeof value !== 'string' || value.trim() === '') {\n\t\tthrow new Error(`analytics: ${path} must be a non-empty collection slug, got ${kindOf(value)}`)\n\t}\n\treturn value.trim()\n}\n\n/**\n * One `{ slug, overrides }` option checked at boot. `path` names it in every refusal, and `extra`\n * lists the other keys the option takes beside those two.\n */\nexport const resolveCollectionOption = (\n\tvalue: unknown,\n\twhere: { path: string; fallback: string; extra?: readonly string[] }\n): ResolvedCollectionOption => {\n\tconst { path, fallback, extra = [] } = where\n\tif (value === undefined) {\n\t\treturn { slug: fallback }\n\t}\n\tconst shaped = optionsObject(value, {\n\t\tpath,\n\t\tknown: ['slug', 'overrides', ...extra],\n\t\texample: `an object such as { slug: '${fallback}' }`,\n\t})\n\tconst overrides = overridesOf(shaped.overrides, `${path}.overrides`)\n\treturn {\n\t\tslug: slugOf(shaped.slug, `${path}.slug`, fallback),\n\t\t...(overrides ? { overrides } : {}),\n\t}\n}\n\n/** The field a scoped plugin collection stamps each document's scope into, by default. */\nconst DEFAULT_SCOPE_FIELD = 'scope'\n\ntype CollectionAccess = Partial<CollectionConfig['access']>\n\nconst COLLECTION_ACCESS_KEYS = keysOf<NonNullable<CollectionConfig['access']>>({\n\tadmin: true,\n\tcreate: true,\n\tdelete: true,\n\tread: true,\n\treadVersions: true,\n\tunlock: true,\n\tupdate: true,\n\tvalidate: true,\n})\n\n/** `access` on one of the plugin's collections: a Payload access function per operation. */\nconst assertCollectionAccess = (value: unknown, path: string): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tconst access = optionsObject(value, {\n\t\tpath,\n\t\tknown: COLLECTION_ACCESS_KEYS,\n\t\texample: 'an object such as { read }',\n\t})\n\tfor (const [operation, fn] of Object.entries(access)) {\n\t\tif (fn !== undefined && typeof fn !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${path}.${operation} must be an access function, got ${kindOf(fn)}`\n\t\t\t)\n\t\t}\n\t}\n}\n\n/** A collection's `fields` overrides: one function per field it may replace. */\nconst assertFieldOverrides = (value: unknown, path: string, known: readonly string[]): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tconst fields = optionsObject(value, {\n\t\tpath,\n\t\tknown,\n\t\texample: 'an object such as { name: ({ defaultField }) => defaultField }',\n\t})\n\tfor (const [name, override] of Object.entries(fields)) {\n\t\tif (override !== undefined && typeof override !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${path}.${name} must be a function receiving { defaultField }, got ${kindOf(override)}`\n\t\t\t)\n\t\t}\n\t}\n}\n\n/** What an opt-in collection whose documents belong to a scope takes (goals, providers). */\ninterface ScopedCollectionOptions<TFields> {\n\tslug?: string\n\tscopeField?: string\n\tfields?: TFields\n\toverrides?: CollectionOverrides\n\taccess?: CollectionAccess\n}\n\n/** A scoped collection option resolved: on or off, its slug and scope field filled. */\nexport interface ResolvedScopedCollection<TFields> {\n\tenabled: boolean\n\tslug: string\n\tscopeField: string\n\tfields?: TFields\n\toverrides?: CollectionOverrides\n\taccess?: CollectionAccess\n}\n\n/** Where a scoped collection option sits, and what it takes. */\ninterface ScopedCollectionAt {\n\tpath: string\n\tfallback: string\n\t/** Every key the option takes. */\n\tknown: readonly string[]\n\t/** The fields its `fields` may replace. */\n\tfieldKeys: readonly string[]\n\t/** The custom slug a refusal shows as an example. */\n\texampleSlug: string\n}\n\n/**\n * A scoped collection option: off when unset or false, on under its defaults for `true`, and an\n * object checked for its keys, `fields`, `access`, `overrides`, slug and scope field.\n */\nexport const resolveScopedCollection = <TFields>(\n\toption: boolean | ScopedCollectionOptions<TFields> | undefined,\n\tat: ScopedCollectionAt\n): ResolvedScopedCollection<TFields> => {\n\tif (option === undefined || typeof option === 'boolean') {\n\t\treturn { enabled: option === true, slug: at.fallback, scopeField: DEFAULT_SCOPE_FIELD }\n\t}\n\tconst shaped = optionsObject(option, {\n\t\tpath: at.path,\n\t\tknown: at.known,\n\t\texample: `true, or an object such as { slug: '${at.exampleSlug}' }`,\n\t})\n\tassertFieldOverrides(shaped.fields, `${at.path}.fields`, at.fieldKeys)\n\tassertCollectionAccess(shaped.access, `${at.path}.access`)\n\tconst overrides = overridesOf(option.overrides, `${at.path}.overrides`)\n\treturn {\n\t\tenabled: true,\n\t\tslug: slugOf(option.slug, `${at.path}.slug`, at.fallback),\n\t\tscopeField: flatFieldName(option.scopeField ?? DEFAULT_SCOPE_FIELD, {\n\t\t\tpath: `${at.path}.scopeField`,\n\t\t\treason: 'the scope stamp writes it as a flat key',\n\t\t}),\n\t\t...(option.fields ? { fields: option.fields } : {}),\n\t\t...(overrides ? { overrides } : {}),\n\t\t...(option.access ? { access: option.access } : {}),\n\t}\n}\n"],"mappings":";;;;AAwBA,MAAM,eAAe,UAAiD,OAAO,UAAU;;AAGvF,MAAa,eAAe,OAAgB,SAAkD;CAC7F,IAAI,UAAU,KAAA,GACb;CAED,IAAI,CAAC,YAAY,KAAK,GACrB,MAAM,IAAI,MACT,cAAc,KAAK,uDAAuD,OAAO,KAAK,GACvF;CAED,OAAO;AACR;;AAGA,MAAa,UAAU,OAAgB,MAAc,aAA6B;CACjF,IAAI,UAAU,KAAA,GACb,OAAO;CAER,IAAI,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,IACjD,MAAM,IAAI,MAAM,cAAc,KAAK,4CAA4C,OAAO,KAAK,GAAG;CAE/F,OAAO,MAAM,KAAK;AACnB;;;;;AAMA,MAAa,2BACZ,OACA,UAC8B;CAC9B,MAAM,EAAE,MAAM,UAAU,QAAQ,CAAC,MAAM;CACvC,IAAI,UAAU,KAAA,GACb,OAAO,EAAE,MAAM,SAAS;CAEzB,MAAM,SAAS,cAAc,OAAO;EACnC;EACA,OAAO;GAAC;GAAQ;GAAa,GAAG;EAAK;EACrC,SAAS,8BAA8B,SAAS;CACjD,CAAC;CACD,MAAM,YAAY,YAAY,OAAO,WAAW,GAAG,KAAK,WAAW;CACnE,OAAO;EACN,MAAM,OAAO,OAAO,MAAM,GAAG,KAAK,QAAQ,QAAQ;EAClD,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;CAClC;AACD;;AAGA,MAAM,sBAAsB;AAI5B,MAAM,yBAAyB,OAAgD;CAC9E,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,MAAM;CACN,cAAc;CACd,QAAQ;CACR,QAAQ;CACR,UAAU;AACX,CAAC;;AAGD,MAAM,0BAA0B,OAAgB,SAAuB;CACtE,IAAI,UAAU,KAAA,GACb;CAED,MAAM,SAAS,cAAc,OAAO;EACnC;EACA,OAAO;EACP,SAAS;CACV,CAAC;CACD,KAAK,MAAM,CAAC,WAAW,OAAO,OAAO,QAAQ,MAAM,GAClD,IAAI,OAAO,KAAA,KAAa,OAAO,OAAO,YACrC,MAAM,IAAI,MACT,cAAc,KAAK,GAAG,UAAU,mCAAmC,OAAO,EAAE,GAC7E;AAGH;;AAGA,MAAM,wBAAwB,OAAgB,MAAc,UAAmC;CAC9F,IAAI,UAAU,KAAA,GACb;CAED,MAAM,SAAS,cAAc,OAAO;EACnC;EACA;EACA,SAAS;CACV,CAAC;CACD,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,MAAM,GACnD,IAAI,aAAa,KAAA,KAAa,OAAO,aAAa,YACjD,MAAM,IAAI,MACT,cAAc,KAAK,GAAG,KAAK,sDAAsD,OAAO,QAAQ,GACjG;AAGH;;;;;AAqCA,MAAa,2BACZ,QACA,OACuC;CACvC,IAAI,WAAW,KAAA,KAAa,OAAO,WAAW,WAC7C,OAAO;EAAE,SAAS,WAAW;EAAM,MAAM,GAAG;EAAU,YAAY;CAAoB;CAEvF,MAAM,SAAS,cAAc,QAAQ;EACpC,MAAM,GAAG;EACT,OAAO,GAAG;EACV,SAAS,uCAAuC,GAAG,YAAY;CAChE,CAAC;CACD,qBAAqB,OAAO,QAAQ,GAAG,GAAG,KAAK,UAAU,GAAG,SAAS;CACrE,uBAAuB,OAAO,QAAQ,GAAG,GAAG,KAAK,QAAQ;CACzD,MAAM,YAAY,YAAY,OAAO,WAAW,GAAG,GAAG,KAAK,WAAW;CACtE,OAAO;EACN,SAAS;EACT,MAAM,OAAO,OAAO,MAAM,GAAG,GAAG,KAAK,QAAQ,GAAG,QAAQ;EACxD,YAAY,cAAc,OAAO,cAAc,qBAAqB;GACnE,MAAM,GAAG,GAAG,KAAK;GACjB,QAAQ;EACT,CAAC;EACD,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;EACjD,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;EACjC,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;CAClD;AACD"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
//#region src/core/collectionSlug.ts
|
|
2
|
+
/** Whether the instance registered a collection under `slug`. */
|
|
3
|
+
const isCollectionSlug = (payload, slug) => Object.hasOwn(payload.collections, slug);
|
|
4
|
+
//#endregion
|
|
5
|
+
export { isCollectionSlug };
|
|
6
|
+
|
|
7
|
+
//# sourceMappingURL=collectionSlug.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collectionSlug.js","names":[],"sources":["../../src/core/collectionSlug.ts"],"sourcesContent":["import type { CollectionSlug, Payload } from 'payload'\n\n/** Whether the instance registered a collection under `slug`. */\nexport const isCollectionSlug = (payload: Payload, slug: string): slug is CollectionSlug =>\n\tObject.hasOwn(payload.collections, slug)\n"],"mappings":";;AAGA,MAAa,oBAAoB,SAAkB,SAClD,OAAO,OAAO,QAAQ,aAAa,IAAI"}
|