@10x-media/analytics 1.0.0-beta.10 → 1.0.0-beta.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +470 -0
- package/LICENSE +21 -21
- package/README.md +30 -37
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +7 -9
- package/dist/adapters/ga4/disableKey.js.map +1 -1
- package/dist/adapters/ga4/eventName.d.ts +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +11 -0
- package/dist/adapters/ga4/ga4.js +206 -123
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +2 -3
- package/dist/adapters/ga4/measurementId.js.map +1 -1
- package/dist/adapters/goalRead.js +15 -29
- package/dist/adapters/goalRead.js.map +1 -1
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +13 -13
- package/dist/adapters/plausible/plausible.js +137 -122
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +20 -9
- package/dist/adapters/posthog/posthog.js +179 -113
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +7 -9
- package/dist/adapters/umami/umami.js +184 -172
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +16 -29
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +48 -95
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +100 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/charts/BarList.d.ts +27 -14
- package/dist/charts/BarList.js +38 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +15 -1
- package/dist/charts/bars.js +12 -12
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +193 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +48 -37
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +26 -25
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +258 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +104 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +285 -59
- package/dist/core/contract.js +6 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +473 -157
- package/dist/core/options.js +154 -219
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +112 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +182 -72
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +38 -20
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceOptions.js +94 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +14 -0
- package/dist/exports/adapters/ga4.d.ts +15 -1
- package/dist/exports/adapters/native.d.ts +26 -2
- package/dist/exports/adapters/native.js +4 -1
- package/dist/exports/adapters/plausible.d.ts +15 -1
- package/dist/exports/adapters/posthog.d.ts +15 -1
- package/dist/exports/adapters/umami.d.ts +15 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +41 -13
- package/dist/exports/client.js +21 -9
- package/dist/exports/geo.d.ts +3 -1
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/next.d.ts +18 -1
- package/dist/exports/next.js +3 -1
- package/dist/exports/react.d.ts +3 -2
- package/dist/exports/react.js +1 -2
- package/dist/exports/rsc.d.ts +31 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +17 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +5 -20
- package/dist/exports/tracker.js +3 -14
- package/dist/exports/types.d.ts +40 -14
- package/dist/exports/types.js +5 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +20 -8
- package/dist/fields/AnalyticsPanelField.js +121 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +18 -7
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +217 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
- package/dist/fields/config/FilterDimensionSelectField.js +26 -54
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
- package/dist/fields/config/FilterOperatorSelectField.js +37 -53
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +18 -30
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.js +14 -26
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +31 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +66 -37
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +78 -26
- package/dist/fields/readForDocument.js +446 -116
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +162 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +141 -100
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -26
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +39 -40
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +154 -46
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -27
- package/dist/goals/trackGoalAction.js +38 -52
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +63 -11
- package/dist/index.js +257 -247
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +81 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.d.ts +1 -0
- package/dist/maintenance/taskSchedule.js +62 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +102 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +29 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1623 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +198 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +108 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +4 -1
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +20 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +2 -3
- package/dist/native/ingest/bots.js +8 -13
- package/dist/native/ingest/bots.js.map +1 -1
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +30 -9
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +119 -34
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +60 -7
- package/dist/native/ingest/normalizeEvent.js +226 -61
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +10 -23
- package/dist/native/ingest/requestHost.js.map +1 -1
- package/dist/native/ingest/resolveHostname.d.ts +4 -13
- package/dist/native/ingest/resolveHostname.js +5 -6
- package/dist/native/ingest/resolveHostname.js.map +1 -1
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +82 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +181 -72
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +2 -3
- package/dist/native/ingest/source.js +35 -54
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +20 -10
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +101 -33
- package/dist/native/nativeAdapter.js +375 -317
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +116 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +63 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +430 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +695 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +95 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +384 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +345 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +48 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +656 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +9 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +68 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +4 -24
- package/dist/next/captureRewrites.js +6 -50
- package/dist/next/captureRewrites.js.map +1 -1
- package/dist/next/captureRoute.d.ts +28 -0
- package/dist/next/captureRoute.js +67 -0
- package/dist/next/captureRoute.js.map +1 -0
- package/dist/next/ingestRoute.d.ts +17 -0
- package/dist/next/ingestRoute.js +17 -0
- package/dist/next/ingestRoute.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +3 -25
- package/dist/next/posthogProxyRewrites.js +5 -37
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +336 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +76 -53
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +5 -12
- package/dist/plugin/errors.js +23 -16
- package/dist/plugin/errors.js.map +1 -1
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/jobsAccess.js +91 -0
- package/dist/plugin/jobsAccess.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +155 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +69 -44
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +52 -17
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +64 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +77 -25
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +69 -44
- package/dist/plugin/refreshEndpoint.js.map +1 -1
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +226 -30
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +63 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +6 -5
- package/dist/plugin/scopeChange.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +46 -12
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +22 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +53 -0
- package/dist/providers/collection.js +274 -150
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +76 -0
- package/dist/providers/factory.js +76 -23
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +101 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +318 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +23 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +1 -5
- package/dist/query/fetchQuery.d.ts +25 -32
- package/dist/query/fetchQuery.js +91 -91
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +6 -0
- package/dist/query/parse.js +153 -106
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +26 -17
- package/dist/react/AnalyticsProvider.js +23 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -11
- package/dist/react/useAnalytics.js +22 -24
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/site/AnalyticsScripts.d.ts +34 -0
- package/dist/site/AnalyticsScripts.js +30 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +40 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +69 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -72
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.js +70 -26
- package/dist/surfacing/epoch.js.map +1 -1
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +113 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +28 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +226 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +144 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +4 -10
- package/dist/tracker/createTracker.js +386 -115
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +2 -22
- package/dist/tracker/exclusion.js +53 -21
- package/dist/tracker/exclusion.js.map +1 -1
- package/dist/tracker/gate.js +194 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +21 -14
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +118 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +38 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +64 -20
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +7 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +27 -22
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +26 -22
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +14 -12
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +30 -27
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +86 -63
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +226 -71
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +215 -69
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +209 -67
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +217 -68
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +221 -72
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +212 -67
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +185 -14
- package/dist/translations/keys.js +190 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +214 -69
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +226 -77
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +217 -66
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +217 -66
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +212 -67
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +112 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1528 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +26 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +11 -6
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +8 -10
- package/dist/view/AnalyticsView.js +47 -18
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -229
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +150 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +66 -31
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +95 -10
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +10 -9
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +196 -134
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +118 -30
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +124 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +29 -33
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +123 -82
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +47 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +64 -7
- package/dist/view/viewProps.js +121 -35
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +80 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +129 -123
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +24 -4
- package/dist/widgets/RealtimeCounter.js +91 -77
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +12 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaults.d.ts +4 -7
- package/dist/widgets/defaults.js +4 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +73 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +5 -1
- package/dist/widgets/prepareWidgetRead.js +59 -27
- package/dist/widgets/prepareWidgetRead.js.map +1 -1
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +27 -18
- package/dist/widgets/readForWidget.js +31 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
- package/dist/widgets/readForWidgetBreakdown.js +46 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +17 -23
- package/dist/widgets/readForWidgetGoals.js +50 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
- package/dist/widgets/readForWidgetRealtime.js +51 -27
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +26 -31
- package/dist/widgets/readForWidgetSeries.js +43 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +44 -0
- package/dist/widgets/readMeta.js +47 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +53 -25
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +204 -126
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +4 -3
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +31 -24
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +44 -22
- package/dist/adapters/ga4/disableKey.d.ts +0 -9
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -165
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -39
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -175
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -69
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -106
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/plugin/paths.js +0 -29
- package/dist/plugin/paths.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -29
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -20
- package/dist/tracker/sinks/posthog.d.ts +0 -18
- package/dist/tracker/sinks/umami.d.ts +0 -18
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -76
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -1,42 +1,38 @@
|
|
|
1
1
|
"use client";
|
|
2
|
-
import { acquireTracker } from "../tracker/registry.js";
|
|
2
|
+
import { acquireTracker, setWindowGate } from "../tracker/registry.js";
|
|
3
3
|
import { createContext, useCallback, useEffect, useMemo, useRef } from "react";
|
|
4
4
|
import { jsx } from "react/jsx-runtime";
|
|
5
5
|
//#region src/react/AnalyticsProvider.tsx
|
|
6
6
|
const AnalyticsContext = createContext(null);
|
|
7
7
|
/**
|
|
8
|
-
* Shares the window's tracker with the tree through `useAnalytics
|
|
9
|
-
*
|
|
10
|
-
* pageviews and auto-capture can render `<AnalyticsScripts />` (which boots
|
|
11
|
-
* `<TrackerBoot />`) and skip the provider. Rendering both is fine: the tracker is leased
|
|
12
|
-
* from a per-window registry, so there is still only one.
|
|
13
|
-
*
|
|
14
|
-
* The lease is taken lazily in the browser rather than during render, so server rendering
|
|
15
|
-
* stays inert and React's double-invoked render cannot leak a second tracker.
|
|
16
|
-
*
|
|
17
|
-
* Whichever component boots the tracker first owns its options, so a `nonce` or
|
|
18
|
-
* `loadScript` passed to a provider that mounts after `<TrackerBoot />` is ignored: give
|
|
19
|
-
* them to whatever boots first, or render only one of the two.
|
|
8
|
+
* Shares the window's one tracker with the tree through `useAnalytics`, leased after mount. The
|
|
9
|
+
* first component to boot it owns its options: after `<AnalyticsScripts />`, this one's are ignored.
|
|
20
10
|
*/
|
|
21
|
-
const AnalyticsProvider = ({ config, children, nonce, loadScript }) => {
|
|
11
|
+
const AnalyticsProvider = ({ config, children, nonce, loadScript, gate, snippets }) => {
|
|
22
12
|
const boot = useRef({
|
|
23
13
|
config,
|
|
24
14
|
nonce,
|
|
25
|
-
loadScript
|
|
15
|
+
loadScript,
|
|
16
|
+
gate,
|
|
17
|
+
snippets
|
|
26
18
|
});
|
|
27
19
|
boot.current = {
|
|
28
20
|
config,
|
|
29
21
|
nonce,
|
|
30
|
-
loadScript
|
|
22
|
+
loadScript,
|
|
23
|
+
gate,
|
|
24
|
+
snippets
|
|
31
25
|
};
|
|
32
26
|
const lease = useRef(null);
|
|
33
27
|
const unmounted = useRef(false);
|
|
34
28
|
const ensure = useCallback(() => {
|
|
35
29
|
if (!lease.current && !unmounted.current && typeof window !== "undefined") {
|
|
36
|
-
const
|
|
37
|
-
lease.current = acquireTracker(current, {
|
|
38
|
-
nonce:
|
|
39
|
-
loadScript:
|
|
30
|
+
const current = boot.current;
|
|
31
|
+
lease.current = acquireTracker(current.config, {
|
|
32
|
+
nonce: current.nonce,
|
|
33
|
+
loadScript: current.loadScript,
|
|
34
|
+
gate: current.gate,
|
|
35
|
+
snippets: current.snippets
|
|
40
36
|
});
|
|
41
37
|
}
|
|
42
38
|
return lease.current?.tracker ?? null;
|
|
@@ -51,9 +47,14 @@ const AnalyticsProvider = ({ config, children, nonce, loadScript }) => {
|
|
|
51
47
|
};
|
|
52
48
|
}, [ensure]);
|
|
53
49
|
const api = useMemo(() => ({
|
|
54
|
-
track: (name, props) => ensure()?.track(name, props),
|
|
50
|
+
track: (name, props, opts) => ensure()?.track(name, props, opts),
|
|
55
51
|
trackGoal: (slug, opts) => ensure()?.trackGoal(slug, opts),
|
|
56
|
-
|
|
52
|
+
purchase: (input) => ensure()?.purchase(input),
|
|
53
|
+
refund: (input) => ensure()?.refund(input),
|
|
54
|
+
setGate: (state) => {
|
|
55
|
+
setWindowGate(state);
|
|
56
|
+
ensure();
|
|
57
|
+
},
|
|
57
58
|
setExcluded: (next) => ensure()?.exclude(next)
|
|
58
59
|
}), [ensure]);
|
|
59
60
|
return /* @__PURE__ */ jsx(AnalyticsContext.Provider, {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"AnalyticsProvider.js","names":[],"sources":["../../src/react/AnalyticsProvider.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tcreateContext,\n\ttype ReactElement,\n\ttype ReactNode,\n\tuseCallback,\n\tuseEffect,\n\tuseMemo,\n\tuseRef,\n} from 'react'\nimport type { TrackerConfig } from '../
|
|
1
|
+
{"version":3,"file":"AnalyticsProvider.js","names":[],"sources":["../../src/react/AnalyticsProvider.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tcreateContext,\n\ttype ReactElement,\n\ttype ReactNode,\n\tuseCallback,\n\tuseEffect,\n\tuseMemo,\n\tuseRef,\n} from 'react'\nimport type { CaptureSlot, TrackerConfig } from '../tracker/config'\nimport { acquireTracker, setWindowGate, type TrackerLease } from '../tracker/registry'\nimport type { GateState, GateStatus, LoadScript, Tracker } from '../tracker/types'\n\n/** What a component can ask the tracker to do. Stable for the life of the provider. */\nexport interface AnalyticsCommands {\n\ttrack: Tracker['track']\n\ttrackGoal: Tracker['trackGoal']\n\t/** Records a sale, with the amount that actually moved rather than the goal's own. */\n\tpurchase: Tracker['purchase']\n\t/** A no-op in the browser, with a development warning: refunds are server-side. */\n\trefund: Tracker['refund']\n\t/**\n\t * Opens or closes capture slots for the host's consent manager. Safe before the tracker has\n\t * booted: the answer is kept for the window and applied at boot.\n\t */\n\tsetGate: (state: GateState) => void\n\t/** Takes this browser out of capture, or puts it back. */\n\tsetExcluded: Tracker['exclude']\n}\n\n/** The tracker surface a component gets from `useAnalytics`. */\nexport interface AnalyticsApi extends AnalyticsCommands {\n\t/** True while this browser is excluded from capture. Flipping it re-renders the caller. */\n\texcluded: boolean\n\t/** Each capture slot's gate. A change re-renders the caller. */\n\tgate: Readonly<Record<CaptureSlot, GateStatus>>\n}\n\nexport const AnalyticsContext = createContext<AnalyticsCommands | null>(null)\n\nexport interface AnalyticsProviderProps {\n\t/** Resolved server-side by `getTrackerConfig`, or fetched from the tracker endpoint. */\n\tconfig: TrackerConfig\n\tchildren?: ReactNode\n\t/** CSP nonce applied to the vendor scripts the tracker injects. */\n\tnonce?: string\n\t/**\n\t * Replaces script injection, for a framework script loader. A function cannot cross from a\n\t * server component, so pass it from a client component of your own.\n\t */\n\tloadScript?: LoadScript\n\t/** The answer the host already has at boot, as `<AnalyticsScripts gate>` takes it. */\n\tgate?: GateState\n\t/** `false` injects no vendor script at all, for a consent manager that loads them itself. */\n\tsnippets?: boolean\n}\n\n/**\n * Shares the window's one tracker with the tree through `useAnalytics`, leased after mount. The\n * first component to boot it owns its options: after `<AnalyticsScripts />`, this one's are ignored.\n */\nexport const AnalyticsProvider = ({\n\tconfig,\n\tchildren,\n\tnonce,\n\tloadScript,\n\tgate,\n\tsnippets,\n}: AnalyticsProviderProps): ReactElement => {\n\tconst boot = useRef({ config, nonce, loadScript, gate, snippets })\n\tboot.current = { config, nonce, loadScript, gate, snippets }\n\tconst lease = useRef<TrackerLease | null>(null)\n\tconst unmounted = useRef(false)\n\n\tconst ensure = useCallback((): Tracker | null => {\n\t\tif (!lease.current && !unmounted.current && typeof window !== 'undefined') {\n\t\t\tconst current = boot.current\n\t\t\tlease.current = acquireTracker(current.config, {\n\t\t\t\tnonce: current.nonce,\n\t\t\t\tloadScript: current.loadScript,\n\t\t\t\tgate: current.gate,\n\t\t\t\tsnippets: current.snippets,\n\t\t\t})\n\t\t}\n\t\treturn lease.current?.tracker ?? null\n\t}, [])\n\n\tuseEffect(() => {\n\t\tunmounted.current = false\n\t\tensure()\n\t\treturn () => {\n\t\t\t// A stale `track` call held past unmount must not resurrect the tracker.\n\t\t\tunmounted.current = true\n\t\t\tlease.current?.release()\n\t\t\tlease.current = null\n\t\t}\n\t}, [ensure])\n\n\tconst api = useMemo<AnalyticsCommands>(\n\t\t() => ({\n\t\t\ttrack: (name, props, opts) => ensure()?.track(name, props, opts),\n\t\t\ttrackGoal: (slug, opts) => ensure()?.trackGoal(slug, opts),\n\t\t\tpurchase: (input) => ensure()?.purchase(input),\n\t\t\trefund: (input) => ensure()?.refund(input),\n\t\t\t// Recorded before the boot, which a child's effect can trigger ahead of the provider's own:\n\t\t\t// a tracker booted first would load and send under the previous answer.\n\t\t\tsetGate: (state) => {\n\t\t\t\tsetWindowGate(state)\n\t\t\t\tensure()\n\t\t\t},\n\t\t\tsetExcluded: (next) => ensure()?.exclude(next),\n\t\t}),\n\t\t[ensure]\n\t)\n\n\treturn <AnalyticsContext.Provider value={api}>{children}</AnalyticsContext.Provider>\n}\n"],"mappings":";;;;;AAwCA,MAAa,mBAAmB,cAAwC,IAAI;;;;;AAuB5E,MAAa,qBAAqB,EACjC,QACA,UACA,OACA,YACA,MACA,eAC2C;CAC3C,MAAM,OAAO,OAAO;EAAE;EAAQ;EAAO;EAAY;EAAM;CAAS,CAAC;CACjE,KAAK,UAAU;EAAE;EAAQ;EAAO;EAAY;EAAM;CAAS;CAC3D,MAAM,QAAQ,OAA4B,IAAI;CAC9C,MAAM,YAAY,OAAO,KAAK;CAE9B,MAAM,SAAS,kBAAkC;EAChD,IAAI,CAAC,MAAM,WAAW,CAAC,UAAU,WAAW,OAAO,WAAW,aAAa;GAC1E,MAAM,UAAU,KAAK;GACrB,MAAM,UAAU,eAAe,QAAQ,QAAQ;IAC9C,OAAO,QAAQ;IACf,YAAY,QAAQ;IACpB,MAAM,QAAQ;IACd,UAAU,QAAQ;GACnB,CAAC;EACF;EACA,OAAO,MAAM,SAAS,WAAW;CAClC,GAAG,CAAC,CAAC;CAEL,gBAAgB;EACf,UAAU,UAAU;EACpB,OAAO;EACP,aAAa;GAEZ,UAAU,UAAU;GACpB,MAAM,SAAS,QAAQ;GACvB,MAAM,UAAU;EACjB;CACD,GAAG,CAAC,MAAM,CAAC;CAEX,MAAM,MAAM,eACJ;EACN,QAAQ,MAAM,OAAO,SAAS,OAAO,GAAG,MAAM,MAAM,OAAO,IAAI;EAC/D,YAAY,MAAM,SAAS,OAAO,GAAG,UAAU,MAAM,IAAI;EACzD,WAAW,UAAU,OAAO,GAAG,SAAS,KAAK;EAC7C,SAAS,UAAU,OAAO,GAAG,OAAO,KAAK;EAGzC,UAAU,UAAU;GACnB,cAAc,KAAK;GACnB,OAAO;EACR;EACA,cAAc,SAAS,OAAO,GAAG,QAAQ,IAAI;CAC9C,IACA,CAAC,MAAM,CACR;CAEA,OAAO,oBAAC,iBAAiB,UAAlB;EAA2B,OAAO;EAAM;CAAoC,CAAA;AACpF"}
|
|
@@ -3,23 +3,29 @@ import { acquireTracker } from "../tracker/registry.js";
|
|
|
3
3
|
import { useEffect, useRef } from "react";
|
|
4
4
|
//#region src/react/TrackerBoot.tsx
|
|
5
5
|
/**
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* pageviews and auto-capture with no provider and no client state. Wrap the tree in
|
|
9
|
-
* `<AnalyticsProvider>` as well when components need to call `track` themselves: both take
|
|
10
|
-
* a lease on the window's one tracker, so neither double-counts.
|
|
6
|
+
* Internal: what `<AnalyticsScripts />` renders to boot the tracker with server-passable props. It
|
|
7
|
+
* leases the window's one tracker, so it and `<AnalyticsProvider>` never double-count.
|
|
11
8
|
*/
|
|
12
|
-
const TrackerBoot = ({ config, nonce }) => {
|
|
9
|
+
const TrackerBoot = ({ config, nonce, gate, snippets }) => {
|
|
13
10
|
const boot = useRef({
|
|
14
11
|
config,
|
|
15
|
-
nonce
|
|
12
|
+
nonce,
|
|
13
|
+
gate,
|
|
14
|
+
snippets
|
|
16
15
|
});
|
|
17
16
|
boot.current = {
|
|
18
17
|
config,
|
|
19
|
-
nonce
|
|
18
|
+
nonce,
|
|
19
|
+
gate,
|
|
20
|
+
snippets
|
|
20
21
|
};
|
|
21
22
|
useEffect(() => {
|
|
22
|
-
const
|
|
23
|
+
const current = boot.current;
|
|
24
|
+
const lease = acquireTracker(current.config, {
|
|
25
|
+
nonce: current.nonce,
|
|
26
|
+
gate: current.gate,
|
|
27
|
+
snippets: current.snippets
|
|
28
|
+
});
|
|
23
29
|
return () => lease.release();
|
|
24
30
|
}, []);
|
|
25
31
|
return null;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"TrackerBoot.js","names":[],"sources":["../../src/react/TrackerBoot.tsx"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef } from 'react'\nimport type { TrackerConfig } from '../
|
|
1
|
+
{"version":3,"file":"TrackerBoot.js","names":[],"sources":["../../src/react/TrackerBoot.tsx"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef } from 'react'\nimport type { TrackerConfig } from '../tracker/config'\nimport { acquireTracker } from '../tracker/registry'\nimport type { GateState } from '../tracker/types'\n\nexport interface TrackerBootProps {\n\tconfig: TrackerConfig\n\t/** CSP nonce for any script the tracker injects. */\n\tnonce?: string\n\t/** The answer the server rendered the page with, applied at boot. */\n\tgate?: GateState\n\t/** `false` injects no vendor script at all. */\n\tsnippets?: boolean\n}\n\n/**\n * Internal: what `<AnalyticsScripts />` renders to boot the tracker with server-passable props. It\n * leases the window's one tracker, so it and `<AnalyticsProvider>` never double-count.\n */\nexport const TrackerBoot = ({ config, nonce, gate, snippets }: TrackerBootProps): null => {\n\tconst boot = useRef({ config, nonce, gate, snippets })\n\tboot.current = { config, nonce, gate, snippets }\n\n\tuseEffect(() => {\n\t\tconst current = boot.current\n\t\tconst lease = acquireTracker(current.config, {\n\t\t\tnonce: current.nonce,\n\t\t\tgate: current.gate,\n\t\t\tsnippets: current.snippets,\n\t\t})\n\t\treturn () => lease.release()\n\t}, [])\n\n\treturn null\n}\n"],"mappings":";;;;;;;;AAqBA,MAAa,eAAe,EAAE,QAAQ,OAAO,MAAM,eAAuC;CACzF,MAAM,OAAO,OAAO;EAAE;EAAQ;EAAO;EAAM;CAAS,CAAC;CACrD,KAAK,UAAU;EAAE;EAAQ;EAAO;EAAM;CAAS;CAE/C,gBAAgB;EACf,MAAM,UAAU,KAAK;EACrB,MAAM,QAAQ,eAAe,QAAQ,QAAQ;GAC5C,OAAO,QAAQ;GACf,MAAM,QAAQ;GACd,UAAU,QAAQ;EACnB,CAAC;EACD,aAAa,MAAM,QAAQ;CAC5B,GAAG,CAAC,CAAC;CAEL,OAAO;AACR"}
|
|
@@ -2,17 +2,8 @@ import { AnalyticsApi } from "./AnalyticsProvider.js";
|
|
|
2
2
|
|
|
3
3
|
//#region src/react/useAnalytics.d.ts
|
|
4
4
|
/**
|
|
5
|
-
* The window's tracker
|
|
6
|
-
*
|
|
7
|
-
* client component to send its own events.
|
|
8
|
-
*
|
|
9
|
-
* The tracker is resolved per call, not per render: `<TrackerBoot />`'s effect may not have
|
|
10
|
-
* run when a sibling renders, and an eagerly resolved null would never recover. A call that
|
|
11
|
-
* finds neither a provider nor a booted tracker throws, because a silently dead `track` is
|
|
12
|
-
* worse than a build-time mistake.
|
|
13
|
-
*
|
|
14
|
-
* `excluded` is read from the tracker rather than held in state, so every component sees the
|
|
15
|
-
* same flag however it was flipped.
|
|
5
|
+
* The window's tracker, from `<AnalyticsProvider>` or else whatever `<AnalyticsScripts />` booted.
|
|
6
|
+
* A call with neither throws, except `setGate`, which is kept until a tracker boots.
|
|
16
7
|
*/
|
|
17
8
|
declare const useAnalytics: () => AnalyticsApi;
|
|
18
9
|
//#endregion
|
|
@@ -1,32 +1,23 @@
|
|
|
1
1
|
"use client";
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
2
|
+
import { subscribeExclusion } from "../tracker/exclusion.js";
|
|
3
|
+
import { ALL_PENDING } from "../tracker/gate.js";
|
|
4
|
+
import { liveTracker, setWindowGate, subscribeWindowGate, windowGateSnapshot } from "../tracker/registry.js";
|
|
4
5
|
import { AnalyticsContext } from "./AnalyticsProvider.js";
|
|
5
6
|
import { useContext, useMemo, useSyncExternalStore } from "react";
|
|
6
7
|
//#region src/react/useAnalytics.tsx
|
|
7
8
|
const NO_TRACKER = "analytics: useAnalytics found no tracker. Render <AnalyticsScripts /> (or <AnalyticsProvider>) above this component.";
|
|
8
|
-
/** The live tracker's flag,
|
|
9
|
-
const exclusionSnapshot = () =>
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
};
|
|
13
|
-
const serverSnapshot = () => false;
|
|
9
|
+
/** The live tracker's flag, never storage: false until a tracker has read it, once a slot opened. */
|
|
10
|
+
const exclusionSnapshot = () => liveTracker()?.excluded ?? false;
|
|
11
|
+
const serverExclusionSnapshot = () => false;
|
|
12
|
+
const serverGateSnapshot = () => ALL_PENDING;
|
|
14
13
|
/**
|
|
15
|
-
* The window's tracker
|
|
16
|
-
*
|
|
17
|
-
* client component to send its own events.
|
|
18
|
-
*
|
|
19
|
-
* The tracker is resolved per call, not per render: `<TrackerBoot />`'s effect may not have
|
|
20
|
-
* run when a sibling renders, and an eagerly resolved null would never recover. A call that
|
|
21
|
-
* finds neither a provider nor a booted tracker throws, because a silently dead `track` is
|
|
22
|
-
* worse than a build-time mistake.
|
|
23
|
-
*
|
|
24
|
-
* `excluded` is read from the tracker rather than held in state, so every component sees the
|
|
25
|
-
* same flag however it was flipped.
|
|
14
|
+
* The window's tracker, from `<AnalyticsProvider>` or else whatever `<AnalyticsScripts />` booted.
|
|
15
|
+
* A call with neither throws, except `setGate`, which is kept until a tracker boots.
|
|
26
16
|
*/
|
|
27
17
|
const useAnalytics = () => {
|
|
28
18
|
const provided = useContext(AnalyticsContext);
|
|
29
|
-
const excluded = useSyncExternalStore(subscribeExclusion, exclusionSnapshot,
|
|
19
|
+
const excluded = useSyncExternalStore(subscribeExclusion, exclusionSnapshot, serverExclusionSnapshot);
|
|
20
|
+
const gate = useSyncExternalStore(subscribeWindowGate, windowGateSnapshot, serverGateSnapshot);
|
|
30
21
|
const commands = useMemo(() => {
|
|
31
22
|
if (provided) return provided;
|
|
32
23
|
const tracker = () => {
|
|
@@ -35,16 +26,23 @@ const useAnalytics = () => {
|
|
|
35
26
|
return live;
|
|
36
27
|
};
|
|
37
28
|
return {
|
|
38
|
-
track: (name, props) => tracker().track(name, props),
|
|
29
|
+
track: (name, props, opts) => tracker().track(name, props, opts),
|
|
39
30
|
trackGoal: (slug, opts) => tracker().trackGoal(slug, opts),
|
|
40
|
-
|
|
31
|
+
purchase: (input) => tracker().purchase(input),
|
|
32
|
+
refund: (input) => tracker().refund(input),
|
|
33
|
+
setGate: (state) => setWindowGate(state),
|
|
41
34
|
setExcluded: (next) => tracker().exclude(next)
|
|
42
35
|
};
|
|
43
36
|
}, [provided]);
|
|
44
37
|
return useMemo(() => ({
|
|
45
38
|
...commands,
|
|
46
|
-
excluded
|
|
47
|
-
|
|
39
|
+
excluded,
|
|
40
|
+
gate
|
|
41
|
+
}), [
|
|
42
|
+
commands,
|
|
43
|
+
excluded,
|
|
44
|
+
gate
|
|
45
|
+
]);
|
|
48
46
|
};
|
|
49
47
|
//#endregion
|
|
50
48
|
export { useAnalytics };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"useAnalytics.js","names":[],"sources":["../../src/react/useAnalytics.tsx"],"sourcesContent":["'use client'\n\nimport { useContext, useMemo, useSyncExternalStore } from 'react'\nimport {
|
|
1
|
+
{"version":3,"file":"useAnalytics.js","names":[],"sources":["../../src/react/useAnalytics.tsx"],"sourcesContent":["'use client'\n\nimport { useContext, useMemo, useSyncExternalStore } from 'react'\nimport { subscribeExclusion } from '../tracker/exclusion'\nimport { ALL_PENDING, type GateSnapshot } from '../tracker/gate'\nimport {\n\tliveTracker,\n\tsetWindowGate,\n\tsubscribeWindowGate,\n\twindowGateSnapshot,\n} from '../tracker/registry'\nimport type { Tracker } from '../tracker/types'\nimport { type AnalyticsApi, type AnalyticsCommands, AnalyticsContext } from './AnalyticsProvider'\n\nconst NO_TRACKER =\n\t'analytics: useAnalytics found no tracker. Render <AnalyticsScripts /> (or <AnalyticsProvider>) above this component.'\n\n/** The live tracker's flag, never storage: false until a tracker has read it, once a slot opened. */\nconst exclusionSnapshot = (): boolean => liveTracker()?.excluded ?? false\n\nconst serverExclusionSnapshot = (): boolean => false\n\nconst serverGateSnapshot = (): GateSnapshot => ALL_PENDING\n\n/**\n * The window's tracker, from `<AnalyticsProvider>` or else whatever `<AnalyticsScripts />` booted.\n * A call with neither throws, except `setGate`, which is kept until a tracker boots.\n */\nexport const useAnalytics = (): AnalyticsApi => {\n\tconst provided = useContext(AnalyticsContext)\n\tconst excluded = useSyncExternalStore(\n\t\tsubscribeExclusion,\n\t\texclusionSnapshot,\n\t\tserverExclusionSnapshot\n\t)\n\tconst gate = useSyncExternalStore(subscribeWindowGate, windowGateSnapshot, serverGateSnapshot)\n\tconst commands = useMemo<AnalyticsCommands>(() => {\n\t\tif (provided) {\n\t\t\treturn provided\n\t\t}\n\t\t// Per call, not per render: the boot effect may not have run yet when a sibling renders.\n\t\tconst tracker = (): Tracker => {\n\t\t\tconst live = liveTracker()\n\t\t\tif (!live) {\n\t\t\t\tthrow new Error(NO_TRACKER)\n\t\t\t}\n\t\t\treturn live\n\t\t}\n\t\treturn {\n\t\t\ttrack: (name, props, opts) => tracker().track(name, props, opts),\n\t\t\ttrackGoal: (slug, opts) => tracker().trackGoal(slug, opts),\n\t\t\tpurchase: (input) => tracker().purchase(input),\n\t\t\trefund: (input) => tracker().refund(input),\n\t\t\tsetGate: (state) => setWindowGate(state),\n\t\t\tsetExcluded: (next) => tracker().exclude(next),\n\t\t}\n\t}, [provided])\n\n\treturn useMemo<AnalyticsApi>(() => ({ ...commands, excluded, gate }), [commands, excluded, gate])\n}\n"],"mappings":";;;;;;;AAcA,MAAM,aACL;;AAGD,MAAM,0BAAmC,YAAY,GAAG,YAAY;AAEpE,MAAM,gCAAyC;AAE/C,MAAM,2BAAyC;;;;;AAM/C,MAAa,qBAAmC;CAC/C,MAAM,WAAW,WAAW,gBAAgB;CAC5C,MAAM,WAAW,qBAChB,oBACA,mBACA,uBACD;CACA,MAAM,OAAO,qBAAqB,qBAAqB,oBAAoB,kBAAkB;CAC7F,MAAM,WAAW,cAAiC;EACjD,IAAI,UACH,OAAO;EAGR,MAAM,gBAAyB;GAC9B,MAAM,OAAO,YAAY;GACzB,IAAI,CAAC,MACJ,MAAM,IAAI,MAAM,UAAU;GAE3B,OAAO;EACR;EACA,OAAO;GACN,QAAQ,MAAM,OAAO,SAAS,QAAQ,EAAE,MAAM,MAAM,OAAO,IAAI;GAC/D,YAAY,MAAM,SAAS,QAAQ,EAAE,UAAU,MAAM,IAAI;GACzD,WAAW,UAAU,QAAQ,EAAE,SAAS,KAAK;GAC7C,SAAS,UAAU,QAAQ,EAAE,OAAO,KAAK;GACzC,UAAU,UAAU,cAAc,KAAK;GACvC,cAAc,SAAS,QAAQ,EAAE,QAAQ,IAAI;EAC9C;CACD,GAAG,CAAC,QAAQ,CAAC;CAEb,OAAO,eAA6B;EAAE,GAAG;EAAU;EAAU;CAAK,IAAI;EAAC;EAAU;EAAU;CAAI,CAAC;AACjG"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { TrackerConfig } from "../tracker/config.js";
|
|
2
|
+
import { GateState } from "../tracker/types.js";
|
|
3
|
+
import { ReactElement } from "react";
|
|
4
|
+
|
|
5
|
+
//#region src/site/AnalyticsScripts.d.ts
|
|
6
|
+
interface AnalyticsScriptsProps {
|
|
7
|
+
/** Resolved server-side, by `getTrackerConfig` or the tracker endpoint. */
|
|
8
|
+
config: TrackerConfig;
|
|
9
|
+
/**
|
|
10
|
+
* The visitor's decision when the server knows it: opened slots render and boot open, closed ones
|
|
11
|
+
* render nothing. Omitted, every held slot waits for `setGate` in the browser.
|
|
12
|
+
*/
|
|
13
|
+
gate?: GateState;
|
|
14
|
+
/**
|
|
15
|
+
* `false` renders no vendor snippet and has the tracker inject none either, for a consent
|
|
16
|
+
* manager that loads the vendor SDKs itself. Default true.
|
|
17
|
+
*/
|
|
18
|
+
snippets?: boolean;
|
|
19
|
+
/** CSP nonce, applied to every script this renders and the tracker injects. */
|
|
20
|
+
nonce?: string;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Renders each boot-open slot's snippet, then boots the tracker; a held slot's snippet is injected
|
|
24
|
+
* once `setGate` opens it. A draft page renders none while `capture.skip.previews` is on.
|
|
25
|
+
*/
|
|
26
|
+
declare const AnalyticsScripts: ({
|
|
27
|
+
config,
|
|
28
|
+
gate,
|
|
29
|
+
snippets,
|
|
30
|
+
nonce
|
|
31
|
+
}: AnalyticsScriptsProps) => ReactElement;
|
|
32
|
+
//#endregion
|
|
33
|
+
export { AnalyticsScripts, AnalyticsScriptsProps };
|
|
34
|
+
//# sourceMappingURL=AnalyticsScripts.d.ts.map
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { skipsDraft } from "../tracker/skip.js";
|
|
2
|
+
import { openAtBoot } from "../tracker/gate.js";
|
|
3
|
+
import { TrackerBoot } from "../react/TrackerBoot.js";
|
|
4
|
+
import { Fragment, jsx, jsxs } from "react/jsx-runtime";
|
|
5
|
+
//#region src/site/AnalyticsScripts.tsx
|
|
6
|
+
/**
|
|
7
|
+
* Renders each boot-open slot's snippet, then boots the tracker; a held slot's snippet is injected
|
|
8
|
+
* once `setGate` opens it. A draft page renders none while `capture.skip.previews` is on.
|
|
9
|
+
*/
|
|
10
|
+
const AnalyticsScripts = ({ config, gate, snippets = true, nonce }) => {
|
|
11
|
+
const rendersSnippets = snippets && !skipsDraft(config);
|
|
12
|
+
return /* @__PURE__ */ jsxs(Fragment, { children: [config.slots.flatMap((slot) => rendersSnippets && openAtBoot(slot, gate) ? slot.snippet.scripts.map((script, index) => /* @__PURE__ */ jsx("script", {
|
|
13
|
+
...script.attrs,
|
|
14
|
+
async: script.async,
|
|
15
|
+
defer: script.defer,
|
|
16
|
+
dangerouslySetInnerHTML: script.inline ? { __html: script.inline } : void 0,
|
|
17
|
+
nonce,
|
|
18
|
+
src: script.inline ? void 0 : script.src,
|
|
19
|
+
type: script.type
|
|
20
|
+
}, `${slot.slot}-${index}`)) : []), /* @__PURE__ */ jsx(TrackerBoot, {
|
|
21
|
+
config,
|
|
22
|
+
gate,
|
|
23
|
+
nonce,
|
|
24
|
+
snippets
|
|
25
|
+
})] });
|
|
26
|
+
};
|
|
27
|
+
//#endregion
|
|
28
|
+
export { AnalyticsScripts };
|
|
29
|
+
|
|
30
|
+
//# sourceMappingURL=AnalyticsScripts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AnalyticsScripts.js","names":[],"sources":["../../src/site/AnalyticsScripts.tsx"],"sourcesContent":["import type { ReactElement } from 'react'\nimport { TrackerBoot } from '../react/TrackerBoot'\nimport type { TrackerConfig } from '../tracker/config'\nimport { openAtBoot } from '../tracker/gate'\nimport { skipsDraft } from '../tracker/skip'\nimport type { GateState } from '../tracker/types'\n\nexport interface AnalyticsScriptsProps {\n\t/** Resolved server-side, by `getTrackerConfig` or the tracker endpoint. */\n\tconfig: TrackerConfig\n\t/**\n\t * The visitor's decision when the server knows it: opened slots render and boot open, closed ones\n\t * render nothing. Omitted, every held slot waits for `setGate` in the browser.\n\t */\n\tgate?: GateState\n\t/**\n\t * `false` renders no vendor snippet and has the tracker inject none either, for a consent\n\t * manager that loads the vendor SDKs itself. Default true.\n\t */\n\tsnippets?: boolean\n\t/** CSP nonce, applied to every script this renders and the tracker injects. */\n\tnonce?: string\n}\n\n/**\n * Renders each boot-open slot's snippet, then boots the tracker; a held slot's snippet is injected\n * once `setGate` opens it. A draft page renders none while `capture.skip.previews` is on.\n */\nexport const AnalyticsScripts = ({\n\tconfig,\n\tgate,\n\tsnippets = true,\n\tnonce,\n}: AnalyticsScriptsProps): ReactElement => {\n\tconst rendersSnippets = snippets && !skipsDraft(config)\n\treturn (\n\t\t<>\n\t\t\t{config.slots.flatMap((slot) =>\n\t\t\t\trendersSnippets && openAtBoot(slot, gate)\n\t\t\t\t\t? slot.snippet.scripts.map((script, index) => (\n\t\t\t\t\t\t\t<script\n\t\t\t\t\t\t\t\t// biome-ignore lint/suspicious/noArrayIndexKey: a snippet's scripts are a fixed list, never reordered\n\t\t\t\t\t\t\t\tkey={`${slot.slot}-${index}`}\n\t\t\t\t\t\t\t\t{...script.attrs}\n\t\t\t\t\t\t\t\tasync={script.async}\n\t\t\t\t\t\t\t\tdefer={script.defer}\n\t\t\t\t\t\t\t\t// biome-ignore lint/security/noDangerouslySetInnerHtml: adapter-authored vendor init\n\t\t\t\t\t\t\t\tdangerouslySetInnerHTML={script.inline ? { __html: script.inline } : undefined}\n\t\t\t\t\t\t\t\tnonce={nonce}\n\t\t\t\t\t\t\t\tsrc={script.inline ? undefined : script.src}\n\t\t\t\t\t\t\t\ttype={script.type}\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t))\n\t\t\t\t\t: []\n\t\t\t)}\n\t\t\t<TrackerBoot config={config} gate={gate} nonce={nonce} snippets={snippets} />\n\t\t</>\n\t)\n}\n"],"mappings":";;;;;;;;;AA4BA,MAAa,oBAAoB,EAChC,QACA,MACA,WAAW,MACX,YAC0C;CAC1C,MAAM,kBAAkB,YAAY,CAAC,WAAW,MAAM;CACtD,OACC,qBAAA,UAAA,EAAA,UAAA,CACE,OAAO,MAAM,SAAS,SACtB,mBAAmB,WAAW,MAAM,IAAI,IACrC,KAAK,QAAQ,QAAQ,KAAK,QAAQ,UAClC,oBAAC,UAAD;EAGC,GAAI,OAAO;EACX,OAAO,OAAO;EACd,OAAO,OAAO;EAEd,yBAAyB,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,KAAA;EAC9D;EACP,KAAK,OAAO,SAAS,KAAA,IAAY,OAAO;EACxC,MAAM,OAAO;CACb,GATK,GAAG,KAAK,KAAK,GAAG,OASrB,CACD,IACA,CAAC,CACL,GACA,oBAAC,aAAD;EAAqB;EAAc;EAAa;EAAiB;CAAW,CAAA,CAC3E,EAAA,CAAA;AAEJ"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { TrackerConfig } from "../tracker/config.js";
|
|
2
|
+
import { Payload, PayloadRequest } from "payload";
|
|
3
|
+
|
|
4
|
+
//#region src/site/getTrackerConfig.d.ts
|
|
5
|
+
/**
|
|
6
|
+
* Server-side twin of the tracker endpoint: pass the request's `headers()` so the host's resolver
|
|
7
|
+
* sees the visitor's request. Pass `draft: (await draftMode()).isEnabled`, else the cookie decides.
|
|
8
|
+
*/
|
|
9
|
+
declare const getTrackerConfig: (payload: Payload, args?: {
|
|
10
|
+
headers?: Headers;
|
|
11
|
+
draft?: boolean;
|
|
12
|
+
}) => Promise<TrackerConfig>;
|
|
13
|
+
//#endregion
|
|
14
|
+
export { getTrackerConfig };
|
|
15
|
+
//# sourceMappingURL=getTrackerConfig.d.ts.map
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { isRecord } from "../core/values.js";
|
|
2
|
+
import { ANALYTICS_CONFIG_KEY, analyticsRoutes } from "../plugin/routes.js";
|
|
3
|
+
import { apiPath } from "../plugin/apiPath.js";
|
|
4
|
+
import { DEFAULT_AUTO_CAPTURE } from "../tracker/config.js";
|
|
5
|
+
import { createLocalReq } from "payload";
|
|
6
|
+
/**
|
|
7
|
+
* Whether the request carries Next's draft mode cookie. Unverified, so a stale or forged cookie reads
|
|
8
|
+
* as draft; `(await draftMode()).isEnabled` checks it against the preview id.
|
|
9
|
+
*/
|
|
10
|
+
const draftModeCookie = (headers) => (headers.get("cookie") ?? "").split(";").some((pair) => {
|
|
11
|
+
const [name, ...value] = pair.trim().split("=");
|
|
12
|
+
return name === "__prerender_bypass" && value.join("=") !== "";
|
|
13
|
+
});
|
|
14
|
+
const isTrackerConfigSource = (value) => isRecord(value) && typeof value.trackerConfig === "function";
|
|
15
|
+
/** The config for an install with no runtime: no slots, but still a usable ingest path. */
|
|
16
|
+
const emptyTrackerConfig = (req) => ({
|
|
17
|
+
slots: [],
|
|
18
|
+
autoCapture: DEFAULT_AUTO_CAPTURE,
|
|
19
|
+
goals: [],
|
|
20
|
+
ingestPath: apiPath(req.payload?.config ?? {}, analyticsRoutes(req.payload?.config).ingest)
|
|
21
|
+
});
|
|
22
|
+
/**
|
|
23
|
+
* Server-side twin of the tracker endpoint: pass the request's `headers()` so the host's resolver
|
|
24
|
+
* sees the visitor's request. Pass `draft: (await draftMode()).isEnabled`, else the cookie decides.
|
|
25
|
+
*/
|
|
26
|
+
const getTrackerConfig = async (payload, args) => {
|
|
27
|
+
const headers = args?.headers ?? new Headers();
|
|
28
|
+
const host = headers.get("host");
|
|
29
|
+
const req = await createLocalReq({ req: {
|
|
30
|
+
headers,
|
|
31
|
+
...host ? { host } : {}
|
|
32
|
+
} }, payload);
|
|
33
|
+
const draft = args?.draft ?? draftModeCookie(headers);
|
|
34
|
+
const source = payload.config.custom?.[ANALYTICS_CONFIG_KEY];
|
|
35
|
+
return isTrackerConfigSource(source) ? source.trackerConfig(payload, req, draft) : emptyTrackerConfig(req);
|
|
36
|
+
};
|
|
37
|
+
//#endregion
|
|
38
|
+
export { draftModeCookie, emptyTrackerConfig, getTrackerConfig };
|
|
39
|
+
|
|
40
|
+
//# sourceMappingURL=getTrackerConfig.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"getTrackerConfig.js","names":[],"sources":["../../src/site/getTrackerConfig.ts"],"sourcesContent":["import { createLocalReq, type Payload, type PayloadRequest } from 'payload'\nimport { isRecord } from '../core/values'\nimport { apiPath } from '../plugin/apiPath'\nimport { ANALYTICS_CONFIG_KEY, analyticsRoutes } from '../plugin/routes'\nimport { DEFAULT_AUTO_CAPTURE, type TrackerConfig } from '../tracker/config'\n\n/**\n * The cookie Next's `draftMode().enable()` sets and `disable()` clears, which is how Payload's\n * preview route turns draft mode on (`__prerender_bypass` in `next/dist/server/api-utils`).\n */\nexport const NEXT_DRAFT_COOKIE = '__prerender_bypass'\n\n/**\n * Whether the request carries Next's draft mode cookie. Unverified, so a stale or forged cookie reads\n * as draft; `(await draftMode()).isEnabled` checks it against the preview id.\n */\nexport const draftModeCookie = (headers: Headers): boolean =>\n\t(headers.get('cookie') ?? '').split(';').some((pair) => {\n\t\tconst [name, ...value] = pair.trim().split('=')\n\t\treturn name === NEXT_DRAFT_COOKIE && value.join('=') !== ''\n\t})\n\n/**\n * What the plugin's `config.custom` entry answers a site render with, so a site page reaches the\n * runtime without loading the engine, the adapters or the admin.\n */\nexport interface TrackerConfigSource {\n\ttrackerConfig: (payload: Payload, req: PayloadRequest, draft: boolean) => Promise<TrackerConfig>\n}\n\nconst isTrackerConfigSource = (value: unknown): value is TrackerConfigSource =>\n\tisRecord(value) && typeof value.trackerConfig === 'function'\n\n/** The config for an install with no runtime: no slots, but still a usable ingest path. */\nexport const emptyTrackerConfig = (req: PayloadRequest): TrackerConfig => ({\n\tslots: [],\n\tautoCapture: DEFAULT_AUTO_CAPTURE,\n\tgoals: [],\n\tingestPath: apiPath(req.payload?.config ?? {}, analyticsRoutes(req.payload?.config).ingest),\n})\n\n/**\n * Server-side twin of the tracker endpoint: pass the request's `headers()` so the host's resolver\n * sees the visitor's request. Pass `draft: (await draftMode()).isEnabled`, else the cookie decides.\n */\nexport const getTrackerConfig = async (\n\tpayload: Payload,\n\targs?: { headers?: Headers; draft?: boolean }\n): Promise<TrackerConfig> => {\n\tconst headers = args?.headers ?? new Headers()\n\t// Payload derives `req.host` from the URL, and hostname scoping needs the header's.\n\tconst host = headers.get('host')\n\t// A fresh literal per call: `createLocalReq` mutates the request it is given.\n\tconst req = await createLocalReq({ req: { headers, ...(host ? { host } : {}) } }, payload)\n\tconst draft = args?.draft ?? draftModeCookie(headers)\n\tconst source = payload.config.custom?.[ANALYTICS_CONFIG_KEY]\n\treturn isTrackerConfigSource(source)\n\t\t? source.trackerConfig(payload, req, draft)\n\t\t: emptyTrackerConfig(req)\n}\n"],"mappings":";;;;;;;;;AAgBA,MAAa,mBAAmB,aAC9B,QAAQ,IAAI,QAAQ,KAAK,IAAI,MAAM,GAAG,EAAE,MAAM,SAAS;CACvD,MAAM,CAAC,MAAM,GAAG,SAAS,KAAK,KAAK,EAAE,MAAM,GAAG;CAC9C,OAAO,SAAA,wBAA8B,MAAM,KAAK,GAAG,MAAM;AAC1D,CAAC;AAUF,MAAM,yBAAyB,UAC9B,SAAS,KAAK,KAAK,OAAO,MAAM,kBAAkB;;AAGnD,MAAa,sBAAsB,SAAwC;CAC1E,OAAO,CAAC;CACR,aAAa;CACb,OAAO,CAAC;CACR,YAAY,QAAQ,IAAI,SAAS,UAAU,CAAC,GAAG,gBAAgB,IAAI,SAAS,MAAM,EAAE,MAAM;AAC3F;;;;;AAMA,MAAa,mBAAmB,OAC/B,SACA,SAC4B;CAC5B,MAAM,UAAU,MAAM,WAAW,IAAI,QAAQ;CAE7C,MAAM,OAAO,QAAQ,IAAI,MAAM;CAE/B,MAAM,MAAM,MAAM,eAAe,EAAE,KAAK;EAAE;EAAS,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;CAAG,EAAE,GAAG,OAAO;CACzF,MAAM,QAAQ,MAAM,SAAS,gBAAgB,OAAO;CACpD,MAAM,SAAS,QAAQ,OAAO,SAAS;CACvC,OAAO,sBAAsB,MAAM,IAChC,OAAO,cAAc,SAAS,KAAK,KAAK,IACxC,mBAAmB,GAAG;AAC1B"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { AnalyticsQuery, AnalyticsResult } from "../core/contract.js";
|
|
2
|
+
import { Payload } from "payload";
|
|
3
|
+
|
|
4
|
+
//#region src/surfacing/afterRead.d.ts
|
|
5
|
+
/**
|
|
6
|
+
* Where an answered read came from: this instance's memory, a fresh entry of the cache store, an
|
|
7
|
+
* expired entry served while it refreshes (`meta.stale`), or the source itself just now.
|
|
8
|
+
*/
|
|
9
|
+
type ReadOrigin = 'memory' | 'store' | 'stale' | 'source';
|
|
10
|
+
interface AfterReadArgs {
|
|
11
|
+
/** The id of the source that answered. */
|
|
12
|
+
adapterId: string;
|
|
13
|
+
/**
|
|
14
|
+
* The query as the engine read it: clamped to the source's lookback, with the scope, timezone and
|
|
15
|
+
* goal slugs the surface resolved. Weeks and months are as asked, not the days they were read as.
|
|
16
|
+
*/
|
|
17
|
+
query: AnalyticsQuery;
|
|
18
|
+
/**
|
|
19
|
+
* The answer, already shaped (ranked, cut to `limit`) and cached. Other readers share this very
|
|
20
|
+
* object, so the hook never changes it: it returns a new one to answer differently.
|
|
21
|
+
*/
|
|
22
|
+
result: AnalyticsResult;
|
|
23
|
+
from: ReadOrigin;
|
|
24
|
+
/** Milliseconds from the start of the read to its answer, every wait included. */
|
|
25
|
+
durationMs: number;
|
|
26
|
+
payload: Payload;
|
|
27
|
+
}
|
|
28
|
+
/** What `hooks.afterRead` answers with: a new result for this one read, or nothing to keep it. */
|
|
29
|
+
type AfterReadAnswer = AnalyticsResult | undefined | void;
|
|
30
|
+
/**
|
|
31
|
+
* `hooks.afterRead`: runs for every read answered to a reader, once cached; its return answers that
|
|
32
|
+
* one read uncached. Awaited, so a slow hook slows every read; a throw is logged and ignored.
|
|
33
|
+
*/
|
|
34
|
+
type AfterReadHook = (args: AfterReadArgs) => AfterReadAnswer | Promise<AfterReadAnswer>;
|
|
35
|
+
//#endregion
|
|
36
|
+
export { AfterReadAnswer, AfterReadArgs, AfterReadHook, ReadOrigin };
|
|
37
|
+
//# sourceMappingURL=afterRead.d.ts.map
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Makes `key` the most recent entry and evicts the least recent past {@link SCOPE_STATE_CAPACITY}
|
|
3
|
+
* (those `keep` holds on to last), so a scope-keyed map never grows with the names asked for.
|
|
4
|
+
*/
|
|
5
|
+
const remember = (map, [key, value], keep) => {
|
|
6
|
+
map.delete(key);
|
|
7
|
+
map.set(key, value);
|
|
8
|
+
if (map.size <= 2e3) return;
|
|
9
|
+
for (const [oldest, held] of map) {
|
|
10
|
+
if (map.size <= 2e3) return;
|
|
11
|
+
if (oldest !== key && !keep?.(held)) map.delete(oldest);
|
|
12
|
+
}
|
|
13
|
+
for (const oldest of map.keys()) {
|
|
14
|
+
if (map.size <= 2e3) return;
|
|
15
|
+
if (oldest !== key) map.delete(oldest);
|
|
16
|
+
}
|
|
17
|
+
};
|
|
18
|
+
/** The entry under `key`, made the most recent one. */
|
|
19
|
+
const recall = (map, key) => {
|
|
20
|
+
const found = map.get(key);
|
|
21
|
+
if (found !== void 0) {
|
|
22
|
+
map.delete(key);
|
|
23
|
+
map.set(key, found);
|
|
24
|
+
}
|
|
25
|
+
return found;
|
|
26
|
+
};
|
|
27
|
+
/** The entry under `key` as {@link recall} finds it, else one `make` builds, remembered. */
|
|
28
|
+
const recallOr = (map, [key, make], keep) => {
|
|
29
|
+
const known = recall(map, key);
|
|
30
|
+
if (known !== void 0) return known;
|
|
31
|
+
const made = make();
|
|
32
|
+
remember(map, [key, made], keep);
|
|
33
|
+
return made;
|
|
34
|
+
};
|
|
35
|
+
//#endregion
|
|
36
|
+
export { recall, recallOr, remember };
|
|
37
|
+
|
|
38
|
+
//# sourceMappingURL=bounded.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bounded.js","names":[],"sources":["../../src/surfacing/bounded.ts"],"sourcesContent":["/** Scopes one instance keeps per-scope state for (lanes, breakers, epochs, registries) at most. */\nexport const SCOPE_STATE_CAPACITY = 2_000\n\n/**\n * Makes `key` the most recent entry and evicts the least recent past {@link SCOPE_STATE_CAPACITY}\n * (those `keep` holds on to last), so a scope-keyed map never grows with the names asked for.\n */\nexport const remember = <K, V>(\n\tmap: Map<K, V>,\n\t[key, value]: readonly [K, V],\n\tkeep?: (value: V) => boolean\n): void => {\n\tmap.delete(key)\n\tmap.set(key, value)\n\tif (map.size <= SCOPE_STATE_CAPACITY) {\n\t\treturn\n\t}\n\tfor (const [oldest, held] of map) {\n\t\tif (map.size <= SCOPE_STATE_CAPACITY) {\n\t\t\treturn\n\t\t}\n\t\tif (oldest !== key && !keep?.(held)) {\n\t\t\tmap.delete(oldest)\n\t\t}\n\t}\n\tfor (const oldest of map.keys()) {\n\t\tif (map.size <= SCOPE_STATE_CAPACITY) {\n\t\t\treturn\n\t\t}\n\t\tif (oldest !== key) {\n\t\t\tmap.delete(oldest)\n\t\t}\n\t}\n}\n\n/** The entry under `key`, made the most recent one. */\nexport const recall = <K, V>(map: Map<K, V>, key: K): V | undefined => {\n\tconst found = map.get(key)\n\tif (found !== undefined) {\n\t\tmap.delete(key)\n\t\tmap.set(key, found)\n\t}\n\treturn found\n}\n\n/** The entry under `key` as {@link recall} finds it, else one `make` builds, remembered. */\nexport const recallOr = <K, V>(\n\tmap: Map<K, V>,\n\t[key, make]: readonly [K, () => V],\n\tkeep?: (value: V) => boolean\n): V => {\n\tconst known = recall(map, key)\n\tif (known !== undefined) {\n\t\treturn known\n\t}\n\tconst made = make()\n\tremember(map, [key, made], keep)\n\treturn made\n}\n"],"mappings":";;;;AAOA,MAAa,YACZ,KACA,CAAC,KAAK,QACN,SACU;CACV,IAAI,OAAO,GAAG;CACd,IAAI,IAAI,KAAK,KAAK;CAClB,IAAI,IAAI,QAAA,KACP;CAED,KAAK,MAAM,CAAC,QAAQ,SAAS,KAAK;EACjC,IAAI,IAAI,QAAA,KACP;EAED,IAAI,WAAW,OAAO,CAAC,OAAO,IAAI,GACjC,IAAI,OAAO,MAAM;CAEnB;CACA,KAAK,MAAM,UAAU,IAAI,KAAK,GAAG;EAChC,IAAI,IAAI,QAAA,KACP;EAED,IAAI,WAAW,KACd,IAAI,OAAO,MAAM;CAEnB;AACD;;AAGA,MAAa,UAAgB,KAAgB,QAA0B;CACtE,MAAM,QAAQ,IAAI,IAAI,GAAG;CACzB,IAAI,UAAU,KAAA,GAAW;EACxB,IAAI,OAAO,GAAG;EACd,IAAI,IAAI,KAAK,KAAK;CACnB;CACA,OAAO;AACR;;AAGA,MAAa,YACZ,KACA,CAAC,KAAK,OACN,SACO;CACP,MAAM,QAAQ,OAAO,KAAK,GAAG;CAC7B,IAAI,UAAU,KAAA,GACb,OAAO;CAER,MAAM,OAAO,KAAK;CAClB,SAAS,KAAK,CAAC,KAAK,IAAI,GAAG,IAAI;CAC/B,OAAO;AACR"}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
//#region src/surfacing/breaker.ts
|
|
2
|
+
/** Consecutive `unavailable` failures that open the breaker. */
|
|
3
|
+
const BREAKER_THRESHOLD = 5;
|
|
4
|
+
/** The longest a breaker stays open between probes. */
|
|
5
|
+
const BREAKER_MAX_MS = 6e5;
|
|
6
|
+
/** How long a run is told to wait while another run is the half-open probe. */
|
|
7
|
+
const PROBE_WAIT_MS = 1e3;
|
|
8
|
+
/** What a failure does: an outage counts, a setup failure opens the breaker, a refusal answers. */
|
|
9
|
+
const effectOf = (failure) => {
|
|
10
|
+
if (failure.kind === "source_misconfigured") return "open";
|
|
11
|
+
if (failure.kind === "unavailable" && !failure.refused) return "count";
|
|
12
|
+
return "answer";
|
|
13
|
+
};
|
|
14
|
+
/**
|
|
15
|
+
* Opens after `threshold` consecutive `unavailable` failures or one `source_misconfigured`, for
|
|
16
|
+
* `baseMs` doubling per failed probe up to `maxMs`; `invalid_param` still answered, so it succeeds.
|
|
17
|
+
*/
|
|
18
|
+
const createBreaker = (options) => {
|
|
19
|
+
const threshold = options.threshold ?? BREAKER_THRESHOLD;
|
|
20
|
+
const baseMs = options.baseMs ?? 3e4;
|
|
21
|
+
const maxMs = options.maxMs ?? 6e5;
|
|
22
|
+
const probeExpiresMs = options.probeExpiresMs ?? 6e4;
|
|
23
|
+
let state = "closed";
|
|
24
|
+
let consecutive = 0;
|
|
25
|
+
let periodMs = baseMs;
|
|
26
|
+
let openUntil = 0;
|
|
27
|
+
let probing = false;
|
|
28
|
+
let probedAt = 0;
|
|
29
|
+
let lastFailure;
|
|
30
|
+
const open = (at) => {
|
|
31
|
+
state = "open";
|
|
32
|
+
openUntil = at + periodMs;
|
|
33
|
+
probing = false;
|
|
34
|
+
};
|
|
35
|
+
const decide = (claim) => {
|
|
36
|
+
if (state === "closed") return {
|
|
37
|
+
ok: true,
|
|
38
|
+
probe: false
|
|
39
|
+
};
|
|
40
|
+
const at = options.now();
|
|
41
|
+
if (state === "open" && at < openUntil) return {
|
|
42
|
+
ok: false,
|
|
43
|
+
retryAfterMs: openUntil - at
|
|
44
|
+
};
|
|
45
|
+
if (probing && at - probedAt < probeExpiresMs) return {
|
|
46
|
+
ok: false,
|
|
47
|
+
retryAfterMs: Math.min(PROBE_WAIT_MS, probeExpiresMs - (at - probedAt))
|
|
48
|
+
};
|
|
49
|
+
if (claim) {
|
|
50
|
+
state = "half-open";
|
|
51
|
+
probing = true;
|
|
52
|
+
probedAt = at;
|
|
53
|
+
}
|
|
54
|
+
return {
|
|
55
|
+
ok: true,
|
|
56
|
+
probe: true
|
|
57
|
+
};
|
|
58
|
+
};
|
|
59
|
+
return {
|
|
60
|
+
peek: () => decide(false),
|
|
61
|
+
admit: () => decide(true),
|
|
62
|
+
release() {
|
|
63
|
+
if (probing) {
|
|
64
|
+
probing = false;
|
|
65
|
+
state = "open";
|
|
66
|
+
}
|
|
67
|
+
},
|
|
68
|
+
record(outcome, probe) {
|
|
69
|
+
const effect = outcome === "success" ? "answer" : effectOf(outcome);
|
|
70
|
+
if (outcome === "success" || effect === "answer") {
|
|
71
|
+
consecutive = 0;
|
|
72
|
+
lastFailure = void 0;
|
|
73
|
+
if (probe || state !== "closed") {
|
|
74
|
+
state = "closed";
|
|
75
|
+
periodMs = baseMs;
|
|
76
|
+
probing = false;
|
|
77
|
+
}
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
lastFailure = outcome;
|
|
81
|
+
const at = options.now();
|
|
82
|
+
if (probe) {
|
|
83
|
+
periodMs = Math.min(periodMs * 2, maxMs);
|
|
84
|
+
open(at);
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
if (state !== "closed") return;
|
|
88
|
+
consecutive++;
|
|
89
|
+
if (effect === "open" || consecutive >= threshold) {
|
|
90
|
+
consecutive = 0;
|
|
91
|
+
open(at);
|
|
92
|
+
}
|
|
93
|
+
},
|
|
94
|
+
snapshot() {
|
|
95
|
+
const at = options.now();
|
|
96
|
+
return {
|
|
97
|
+
state,
|
|
98
|
+
...state === "open" && at < openUntil ? { retryAfterMs: openUntil - at } : {},
|
|
99
|
+
...lastFailure ? { lastFailure } : {}
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
};
|
|
103
|
+
};
|
|
104
|
+
//#endregion
|
|
105
|
+
export { BREAKER_MAX_MS, createBreaker };
|
|
106
|
+
|
|
107
|
+
//# sourceMappingURL=breaker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"breaker.js","names":[],"sources":["../../src/surfacing/breaker.ts"],"sourcesContent":["import type { ReadFailure } from './classifyError'\n\n/** Consecutive `unavailable` failures that open the breaker. */\nconst BREAKER_THRESHOLD = 5\n\n/** How long a breaker first stays open; each failed probe doubles it. */\nexport const BREAKER_BASE_MS = 30_000\n\n/** The longest a breaker stays open between probes. */\nexport const BREAKER_MAX_MS = 600_000\n\n/** How long a run is told to wait while another run is the half-open probe. */\nconst PROBE_WAIT_MS = 1_000\n\n/**\n * How long a probe may go unanswered before another run may probe: a request that never settles\n * would otherwise keep the breaker half-open, refusing every run, for good.\n */\nexport const PROBE_EXPIRES_MS = 60_000\n\nexport type BreakerState = 'closed' | 'open' | 'half-open'\n\nexport interface BreakerSnapshot {\n\tstate: BreakerState\n\t/** Until the next probe may go, while the breaker refuses. */\n\tretryAfterMs?: number\n\t/** The failure that last counted, cleared by a success. */\n\tlastFailure?: ReadFailure\n}\n\nexport type Admission = { ok: true; probe: boolean } | { ok: false; retryAfterMs: number }\n\n/**\n * One source's circuit breaker: `peek` claims nothing (should a run queue at all); `admit`, asked\n * once a run holds its slots, may make it the half-open probe. Admitted runs must `record`.\n */\nexport interface Breaker {\n\tpeek(): Admission\n\tadmit(): Admission\n\t/** A run's outcome: `success`, or what its failure means; only an admitted run reports. */\n\trecord(outcome: 'success' | ReadFailure, probe: boolean): void\n\t/** Gives back a probe `admit` claimed for a run that stopped before its request went out. */\n\trelease(): void\n\tsnapshot(): BreakerSnapshot\n}\n\nexport interface BreakerOptions {\n\tnow: () => number\n\tthreshold?: number\n\tbaseMs?: number\n\tmaxMs?: number\n\t/** How long a probe may go unanswered before the next run may probe; {@link PROBE_EXPIRES_MS}. */\n\tprobeExpiresMs?: number\n}\n\n/** What a failure does: an outage counts, a setup failure opens the breaker, a refusal answers. */\nconst effectOf = (failure: ReadFailure): 'count' | 'open' | 'answer' => {\n\tif (failure.kind === 'source_misconfigured') return 'open'\n\tif (failure.kind === 'unavailable' && !failure.refused) return 'count'\n\treturn 'answer'\n}\n\n/**\n * Opens after `threshold` consecutive `unavailable` failures or one `source_misconfigured`, for\n * `baseMs` doubling per failed probe up to `maxMs`; `invalid_param` still answered, so it succeeds.\n */\nexport const createBreaker = (options: BreakerOptions): Breaker => {\n\tconst threshold = options.threshold ?? BREAKER_THRESHOLD\n\tconst baseMs = options.baseMs ?? BREAKER_BASE_MS\n\tconst maxMs = options.maxMs ?? BREAKER_MAX_MS\n\tconst probeExpiresMs = options.probeExpiresMs ?? PROBE_EXPIRES_MS\n\tlet state: BreakerState = 'closed'\n\tlet consecutive = 0\n\tlet periodMs = baseMs\n\tlet openUntil = 0\n\tlet probing = false\n\tlet probedAt = 0\n\tlet lastFailure: ReadFailure | undefined\n\n\tconst open = (at: number): void => {\n\t\tstate = 'open'\n\t\topenUntil = at + periodMs\n\t\tprobing = false\n\t}\n\n\tconst decide = (claim: boolean): Admission => {\n\t\tif (state === 'closed') {\n\t\t\treturn { ok: true, probe: false }\n\t\t}\n\t\tconst at = options.now()\n\t\tif (state === 'open' && at < openUntil) {\n\t\t\treturn { ok: false, retryAfterMs: openUntil - at }\n\t\t}\n\t\tif (probing && at - probedAt < probeExpiresMs) {\n\t\t\treturn { ok: false, retryAfterMs: Math.min(PROBE_WAIT_MS, probeExpiresMs - (at - probedAt)) }\n\t\t}\n\t\tif (claim) {\n\t\t\tstate = 'half-open'\n\t\t\tprobing = true\n\t\t\tprobedAt = at\n\t\t}\n\t\treturn { ok: true, probe: true }\n\t}\n\n\treturn {\n\t\tpeek: () => decide(false),\n\t\tadmit: () => decide(true),\n\t\trelease() {\n\t\t\tif (probing) {\n\t\t\t\tprobing = false\n\t\t\t\tstate = 'open'\n\t\t\t}\n\t\t},\n\t\trecord(outcome, probe) {\n\t\t\tconst effect = outcome === 'success' ? 'answer' : effectOf(outcome)\n\t\t\tif (outcome === 'success' || effect === 'answer') {\n\t\t\t\tconsecutive = 0\n\t\t\t\tlastFailure = undefined\n\t\t\t\tif (probe || state !== 'closed') {\n\t\t\t\t\tstate = 'closed'\n\t\t\t\t\tperiodMs = baseMs\n\t\t\t\t\tprobing = false\n\t\t\t\t}\n\t\t\t\treturn\n\t\t\t}\n\t\t\tlastFailure = outcome\n\t\t\tconst at = options.now()\n\t\t\tif (probe) {\n\t\t\t\tperiodMs = Math.min(periodMs * 2, maxMs)\n\t\t\t\topen(at)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (state !== 'closed') {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconsecutive++\n\t\t\tif (effect === 'open' || consecutive >= threshold) {\n\t\t\t\tconsecutive = 0\n\t\t\t\topen(at)\n\t\t\t}\n\t\t},\n\t\tsnapshot() {\n\t\t\tconst at = options.now()\n\t\t\tconst waiting = state === 'open' && at < openUntil\n\t\t\treturn {\n\t\t\t\tstate,\n\t\t\t\t...(waiting ? { retryAfterMs: openUntil - at } : {}),\n\t\t\t\t...(lastFailure ? { lastFailure } : {}),\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";;AAGA,MAAM,oBAAoB;;AAM1B,MAAa,iBAAiB;;AAG9B,MAAM,gBAAgB;;AA4CtB,MAAM,YAAY,YAAsD;CACvE,IAAI,QAAQ,SAAS,wBAAwB,OAAO;CACpD,IAAI,QAAQ,SAAS,iBAAiB,CAAC,QAAQ,SAAS,OAAO;CAC/D,OAAO;AACR;;;;;AAMA,MAAa,iBAAiB,YAAqC;CAClE,MAAM,YAAY,QAAQ,aAAa;CACvC,MAAM,SAAS,QAAQ,UAAA;CACvB,MAAM,QAAQ,QAAQ,SAAA;CACtB,MAAM,iBAAiB,QAAQ,kBAAA;CAC/B,IAAI,QAAsB;CAC1B,IAAI,cAAc;CAClB,IAAI,WAAW;CACf,IAAI,YAAY;CAChB,IAAI,UAAU;CACd,IAAI,WAAW;CACf,IAAI;CAEJ,MAAM,QAAQ,OAAqB;EAClC,QAAQ;EACR,YAAY,KAAK;EACjB,UAAU;CACX;CAEA,MAAM,UAAU,UAA8B;EAC7C,IAAI,UAAU,UACb,OAAO;GAAE,IAAI;GAAM,OAAO;EAAM;EAEjC,MAAM,KAAK,QAAQ,IAAI;EACvB,IAAI,UAAU,UAAU,KAAK,WAC5B,OAAO;GAAE,IAAI;GAAO,cAAc,YAAY;EAAG;EAElD,IAAI,WAAW,KAAK,WAAW,gBAC9B,OAAO;GAAE,IAAI;GAAO,cAAc,KAAK,IAAI,eAAe,kBAAkB,KAAK,SAAS;EAAE;EAE7F,IAAI,OAAO;GACV,QAAQ;GACR,UAAU;GACV,WAAW;EACZ;EACA,OAAO;GAAE,IAAI;GAAM,OAAO;EAAK;CAChC;CAEA,OAAO;EACN,YAAY,OAAO,KAAK;EACxB,aAAa,OAAO,IAAI;EACxB,UAAU;GACT,IAAI,SAAS;IACZ,UAAU;IACV,QAAQ;GACT;EACD;EACA,OAAO,SAAS,OAAO;GACtB,MAAM,SAAS,YAAY,YAAY,WAAW,SAAS,OAAO;GAClE,IAAI,YAAY,aAAa,WAAW,UAAU;IACjD,cAAc;IACd,cAAc,KAAA;IACd,IAAI,SAAS,UAAU,UAAU;KAChC,QAAQ;KACR,WAAW;KACX,UAAU;IACX;IACA;GACD;GACA,cAAc;GACd,MAAM,KAAK,QAAQ,IAAI;GACvB,IAAI,OAAO;IACV,WAAW,KAAK,IAAI,WAAW,GAAG,KAAK;IACvC,KAAK,EAAE;IACP;GACD;GACA,IAAI,UAAU,UACb;GAED;GACA,IAAI,WAAW,UAAU,eAAe,WAAW;IAClD,cAAc;IACd,KAAK,EAAE;GACR;EACD;EACA,WAAW;GACV,MAAM,KAAK,QAAQ,IAAI;GAEvB,OAAO;IACN;IACA,GAHe,UAAU,UAAU,KAAK,YAG1B,EAAE,cAAc,YAAY,GAAG,IAAI,CAAC;IAClD,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;GACtC;EACD;CACD;AACD"}
|