@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,8 +1,19 @@
|
|
|
1
|
+
import { isRecord } from "../core/values.js";
|
|
2
|
+
import { HostRefusedError } from "../core/sourceErrors.js";
|
|
3
|
+
import { checkDocumentHost } from "./hosts.js";
|
|
1
4
|
import { ga4 } from "../adapters/ga4/ga4.js";
|
|
2
5
|
import { plausible } from "../adapters/plausible/plausible.js";
|
|
3
6
|
import { posthog } from "../adapters/posthog/posthog.js";
|
|
4
7
|
import { umami } from "../adapters/umami/umami.js";
|
|
5
8
|
//#region src/providers/factory.ts
|
|
9
|
+
const PROVIDER_IDS = [
|
|
10
|
+
"native",
|
|
11
|
+
"plausible",
|
|
12
|
+
"umami",
|
|
13
|
+
"ga4",
|
|
14
|
+
"posthog"
|
|
15
|
+
];
|
|
16
|
+
/** A stored blank reads as unset. */
|
|
6
17
|
const orUndefined = (value) => value || void 0;
|
|
7
18
|
/** An unset or unrecognized stored region falls back to host-derived detection. */
|
|
8
19
|
const posthogRegion = (value) => value === "us" || value === "eu" ? value : void 0;
|
|
@@ -12,36 +23,72 @@ const posthogRegion = (value) => value === "us" || value === "eu" ? value : void
|
|
|
12
23
|
*/
|
|
13
24
|
const normalizePrivateKey = (key) => key.replace(/\\n/g, "\n");
|
|
14
25
|
const shortId = (id) => String(id).slice(-6);
|
|
15
|
-
/**
|
|
26
|
+
/** The registry id of a provider document's adapter, which grants and stand-ins must match. */
|
|
27
|
+
const documentAdapterId = (provider, id) => `${String(provider)}:${String(id)}`;
|
|
28
|
+
/** A lent `native` adapter under the document's name, so a source reads as its tenant named it. */
|
|
29
|
+
const withDocumentLabel = (adapter, doc) => doc.name ? {
|
|
30
|
+
...adapter,
|
|
31
|
+
label: doc.name
|
|
32
|
+
} : adapter;
|
|
33
|
+
/** Per-document ids keep two projects of one provider type apart in a registry. */
|
|
16
34
|
const withInstanceIdentity = (adapter, doc) => {
|
|
17
35
|
if (doc.id === void 0 || doc.id === null || doc.id === "") return adapter;
|
|
18
36
|
return {
|
|
19
37
|
...adapter,
|
|
20
|
-
id:
|
|
38
|
+
id: documentAdapterId(doc.provider, doc.id),
|
|
21
39
|
label: doc.name || `${adapter.label} ${shortId(doc.id)}`
|
|
22
40
|
};
|
|
23
41
|
};
|
|
24
|
-
|
|
42
|
+
/**
|
|
43
|
+
* Keeps `shape`'s identity and capabilities so the source still lists, but every read throws
|
|
44
|
+
* `error()` and it declares no capture, so its proxy mount answers 404.
|
|
45
|
+
*/
|
|
46
|
+
const failingAdapter = (shape, error) => {
|
|
47
|
+
const fail = async () => {
|
|
48
|
+
throw error();
|
|
49
|
+
};
|
|
50
|
+
return {
|
|
51
|
+
id: shape.id,
|
|
52
|
+
label: shape.label,
|
|
53
|
+
capabilities: shape.capabilities,
|
|
54
|
+
isConfigured: () => true,
|
|
55
|
+
query: fail,
|
|
56
|
+
...shape.realtime ? { realtime: fail } : {}
|
|
57
|
+
};
|
|
58
|
+
};
|
|
59
|
+
/**
|
|
60
|
+
* Builds a hosted vendor's adapter on the address its host check allowed, none being the vendor's
|
|
61
|
+
* cloud; a refused host builds one whose reads fail with a `HostRefusedError`.
|
|
62
|
+
*/
|
|
63
|
+
const onDocumentHost = (verdict, build) => {
|
|
64
|
+
if (verdict.ok) return build(verdict.address ?? void 0);
|
|
65
|
+
const { host, reason } = verdict;
|
|
66
|
+
return failingAdapter(build(void 0), () => new HostRefusedError(host, reason));
|
|
67
|
+
};
|
|
68
|
+
const buildBaseAdapter = (doc, ctx) => {
|
|
25
69
|
switch (doc.provider) {
|
|
70
|
+
case "native": return ctx.native ?? null;
|
|
26
71
|
case "plausible": {
|
|
27
72
|
const cfg = doc.plausible ?? {};
|
|
28
|
-
return plausible({
|
|
73
|
+
return onDocumentHost(checkDocumentHost("plausible", cfg.host, ctx.hosts), (host) => plausible({
|
|
29
74
|
siteId: cfg.siteId ?? "",
|
|
30
75
|
apiKey: cfg.apiKey ?? "",
|
|
31
|
-
host
|
|
76
|
+
host,
|
|
32
77
|
domain: orUndefined(cfg.domain),
|
|
33
78
|
scriptId: orUndefined(cfg.scriptId),
|
|
34
|
-
revenueCurrency: orUndefined(cfg.revenueCurrency)
|
|
35
|
-
|
|
79
|
+
revenueCurrency: orUndefined(cfg.revenueCurrency),
|
|
80
|
+
fetch: ctx.fetch
|
|
81
|
+
}));
|
|
36
82
|
}
|
|
37
83
|
case "umami": {
|
|
38
84
|
const cfg = doc.umami ?? {};
|
|
39
|
-
return umami({
|
|
85
|
+
return onDocumentHost(checkDocumentHost("umami", cfg.host, ctx.hosts), (host) => umami({
|
|
40
86
|
websiteId: cfg.websiteId ?? "",
|
|
41
87
|
apiKey: orUndefined(cfg.apiKey),
|
|
42
88
|
token: orUndefined(cfg.token),
|
|
43
|
-
host
|
|
44
|
-
|
|
89
|
+
host,
|
|
90
|
+
fetch: ctx.fetch
|
|
91
|
+
}));
|
|
45
92
|
}
|
|
46
93
|
case "ga4": {
|
|
47
94
|
const cfg = doc.ga4 ?? {};
|
|
@@ -52,33 +99,39 @@ const buildBaseAdapter = (doc) => {
|
|
|
52
99
|
private_key: normalizePrivateKey(cfg.privateKey ?? "")
|
|
53
100
|
},
|
|
54
101
|
projectId: orUndefined(cfg.projectId),
|
|
55
|
-
measurementId: orUndefined(cfg.measurementId)
|
|
102
|
+
measurementId: orUndefined(cfg.measurementId),
|
|
103
|
+
currency: orUndefined(cfg.currency),
|
|
104
|
+
...ctx.sdks?.ga4 ? { sdk: ctx.sdks.ga4 } : {}
|
|
56
105
|
});
|
|
57
106
|
}
|
|
58
107
|
case "posthog": {
|
|
59
108
|
const cfg = doc.posthog ?? {};
|
|
60
|
-
return posthog({
|
|
109
|
+
return onDocumentHost(checkDocumentHost("posthog", cfg.host, ctx.hosts), (host) => posthog({
|
|
61
110
|
projectId: cfg.projectId ?? "",
|
|
62
111
|
apiKey: cfg.apiKey ?? "",
|
|
63
|
-
host
|
|
112
|
+
host,
|
|
64
113
|
projectToken: orUndefined(cfg.projectToken),
|
|
65
|
-
region: posthogRegion(cfg.region)
|
|
66
|
-
|
|
114
|
+
region: posthogRegion(cfg.region),
|
|
115
|
+
scopeProperty: orUndefined(cfg.scopeProperty?.trim()),
|
|
116
|
+
fetch: ctx.fetch
|
|
117
|
+
}));
|
|
67
118
|
}
|
|
68
119
|
default: return null;
|
|
69
120
|
}
|
|
70
121
|
};
|
|
122
|
+
/** Checked at runtime: a JavaScript caller can leave the guards out, which would go out unguarded. */
|
|
123
|
+
const isGuarded = (ctx) => isRecord(ctx) && typeof ctx.fetch === "function" && isRecord(ctx.hosts) && Array.isArray(ctx.hosts.allow);
|
|
71
124
|
/**
|
|
72
|
-
*
|
|
73
|
-
*
|
|
74
|
-
* empty strings so the adapter reports `isConfigured() === false` instead of the
|
|
75
|
-
* factory throwing; an unknown provider value returns null and is skipped.
|
|
125
|
+
* Builds a provider document's adapter: missing credentials read as `isConfigured() === false`, an
|
|
126
|
+
* unknown provider as null, and a `native` document lends the config adapter under its label.
|
|
76
127
|
*/
|
|
77
|
-
const adapterFromProviderDoc = (doc) => {
|
|
78
|
-
|
|
79
|
-
|
|
128
|
+
const adapterFromProviderDoc = (doc, ctx) => {
|
|
129
|
+
if (!isGuarded(ctx)) throw new Error("analytics: adapterFromProviderDoc needs { fetch, hosts }: pass the ones providers.resolve receives");
|
|
130
|
+
const base = buildBaseAdapter(doc, ctx);
|
|
131
|
+
if (!base) return null;
|
|
132
|
+
return doc.provider === "native" ? withDocumentLabel(base, doc) : withInstanceIdentity(base, doc);
|
|
80
133
|
};
|
|
81
134
|
//#endregion
|
|
82
|
-
export { adapterFromProviderDoc };
|
|
135
|
+
export { PROVIDER_IDS, adapterFromProviderDoc, documentAdapterId, failingAdapter };
|
|
83
136
|
|
|
84
137
|
//# sourceMappingURL=factory.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"factory.js","names":[],"sources":["../../src/providers/factory.ts"],"sourcesContent":["import { ga4 } from '../adapters/ga4/ga4'\nimport { plausible } from '../adapters/plausible/plausible'\nimport { posthog } from '../adapters/posthog/posthog'\nimport { umami } from '../adapters/umami/umami'\nimport type { AnalyticsAdapter } from '../core/contract'\n\nexport const PROVIDER_IDS = ['plausible', 'umami', 'ga4', 'posthog'] as const\nexport type ProviderId = (typeof PROVIDER_IDS)[number]\n\n/** The provider-settings document shape the adapter factory reads (depth 0, secrets revealed). */\nexport type ProviderDoc = {\n\tid?: number | string\n\tname?: string | null\n\tprovider?: string | null\n\tenabled?: boolean | null\n\tscope?: string | null\n\tplausible?: {\n\t\tsiteId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tdomain?: string | null\n\t\tscriptId?: string | null\n\t\trevenueCurrency?: string | null\n\t} | null\n\tumami?: {\n\t\twebsiteId?: string | null\n\t\tapiKey?: string | null\n\t\ttoken?: string | null\n\t\thost?: string | null\n\t} | null\n\tga4?: {\n\t\tpropertyId?: string | null\n\t\tclientEmail?: string | null\n\t\tprivateKey?: string | null\n\t\tprojectId?: string | null\n\t\tmeasurementId?: string | null\n\t} | null\n\tposthog?: {\n\t\tprojectId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tprojectToken?: string | null\n\t\tregion?: string | null\n\t} | null\n}\n\nconst orUndefined = (value: string | null | undefined): string | undefined => value || undefined\n\n/** An unset or unrecognized stored region falls back to host-derived detection. */\nconst posthogRegion = (value: string | null | undefined): 'us' | 'eu' | undefined =>\n\tvalue === 'us' || value === 'eu' ? value : undefined\n\n/**\n * Keys pasted from a service-account JSON often carry escaped newlines; the gRPC\n * client needs real ones.\n */\nexport const normalizePrivateKey = (key: string): string => key.replace(/\\\\n/g, '\\n')\n\nconst shortId = (id: number | string): string => String(id).slice(-6)\n\n/** Runtime adapters carry a per-document instance id so two projects of one provider type never collide in a registry; config adapters keep their plain ids. */\nconst withInstanceIdentity = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter => {\n\tif (doc.id === undefined || doc.id === null || doc.id === '') {\n\t\treturn adapter\n\t}\n\treturn {\n\t\t...adapter,\n\t\tid: `${doc.provider}:${doc.id}`,\n\t\tlabel: doc.name || `${adapter.label} ${shortId(doc.id)}`,\n\t}\n}\n\nconst buildBaseAdapter = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tswitch (doc.provider) {\n\t\tcase 'plausible': {\n\t\t\tconst cfg = doc.plausible ?? {}\n\t\t\treturn plausible({\n\t\t\t\tsiteId: cfg.siteId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tdomain: orUndefined(cfg.domain),\n\t\t\t\tscriptId: orUndefined(cfg.scriptId),\n\t\t\t\trevenueCurrency: orUndefined(cfg.revenueCurrency),\n\t\t\t})\n\t\t}\n\t\tcase 'umami': {\n\t\t\tconst cfg = doc.umami ?? {}\n\t\t\treturn umami({\n\t\t\t\twebsiteId: cfg.websiteId ?? '',\n\t\t\t\tapiKey: orUndefined(cfg.apiKey),\n\t\t\t\ttoken: orUndefined(cfg.token),\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t})\n\t\t}\n\t\tcase 'ga4': {\n\t\t\tconst cfg = doc.ga4 ?? {}\n\t\t\treturn ga4({\n\t\t\t\tpropertyId: cfg.propertyId ?? '',\n\t\t\t\tcredentials: {\n\t\t\t\t\tclient_email: cfg.clientEmail ?? '',\n\t\t\t\t\tprivate_key: normalizePrivateKey(cfg.privateKey ?? ''),\n\t\t\t\t},\n\t\t\t\tprojectId: orUndefined(cfg.projectId),\n\t\t\t\tmeasurementId: orUndefined(cfg.measurementId),\n\t\t\t})\n\t\t}\n\t\tcase 'posthog': {\n\t\t\tconst cfg = doc.posthog ?? {}\n\t\t\treturn posthog({\n\t\t\t\tprojectId: cfg.projectId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tprojectToken: orUndefined(cfg.projectToken),\n\t\t\t\tregion: posthogRegion(cfg.region),\n\t\t\t})\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * Build an adapter instance from a provider-settings document using the same\n * constructors as config-time adapters. Missing credentials are passed through as\n * empty strings so the adapter reports `isConfigured() === false` instead of the\n * factory throwing; an unknown provider value returns null and is skipped.\n */\nexport const adapterFromProviderDoc = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tconst base = buildBaseAdapter(doc)\n\treturn base ? withInstanceIdentity(base, doc) : null\n}\n"],"mappings":";;;;;AA8CA,MAAM,eAAe,UAAyD,SAAS,KAAA;;AAGvF,MAAM,iBAAiB,UACtB,UAAU,QAAQ,UAAU,OAAO,QAAQ,KAAA;;;;;AAM5C,MAAa,uBAAuB,QAAwB,IAAI,QAAQ,QAAQ,IAAI;AAEpF,MAAM,WAAW,OAAgC,OAAO,EAAE,EAAE,MAAM,EAAE;;AAGpE,MAAM,wBAAwB,SAA2B,QAAuC;CAC/F,IAAI,IAAI,OAAO,KAAA,KAAa,IAAI,OAAO,QAAQ,IAAI,OAAO,IACzD,OAAO;CAER,OAAO;EACN,GAAG;EACH,IAAI,GAAG,IAAI,SAAS,GAAG,IAAI;EAC3B,OAAO,IAAI,QAAQ,GAAG,QAAQ,MAAM,GAAG,QAAQ,IAAI,EAAE;CACtD;AACD;AAEA,MAAM,oBAAoB,QAA8C;CACvE,QAAQ,IAAI,UAAZ;EACC,KAAK,aAAa;GACjB,MAAM,MAAM,IAAI,aAAa,CAAC;GAC9B,OAAO,UAAU;IAChB,QAAQ,IAAI,UAAU;IACtB,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;IAC1B,QAAQ,YAAY,IAAI,MAAM;IAC9B,UAAU,YAAY,IAAI,QAAQ;IAClC,iBAAiB,YAAY,IAAI,eAAe;GACjD,CAAC;EACF;EACA,KAAK,SAAS;GACb,MAAM,MAAM,IAAI,SAAS,CAAC;GAC1B,OAAO,MAAM;IACZ,WAAW,IAAI,aAAa;IAC5B,QAAQ,YAAY,IAAI,MAAM;IAC9B,OAAO,YAAY,IAAI,KAAK;IAC5B,MAAM,YAAY,IAAI,IAAI;GAC3B,CAAC;EACF;EACA,KAAK,OAAO;GACX,MAAM,MAAM,IAAI,OAAO,CAAC;GACxB,OAAO,IAAI;IACV,YAAY,IAAI,cAAc;IAC9B,aAAa;KACZ,cAAc,IAAI,eAAe;KACjC,aAAa,oBAAoB,IAAI,cAAc,EAAE;IACtD;IACA,WAAW,YAAY,IAAI,SAAS;IACpC,eAAe,YAAY,IAAI,aAAa;GAC7C,CAAC;EACF;EACA,KAAK,WAAW;GACf,MAAM,MAAM,IAAI,WAAW,CAAC;GAC5B,OAAO,QAAQ;IACd,WAAW,IAAI,aAAa;IAC5B,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;IAC1B,cAAc,YAAY,IAAI,YAAY;IAC1C,QAAQ,cAAc,IAAI,MAAM;GACjC,CAAC;EACF;EACA,SACC,OAAO;CACT;AACD;;;;;;;AAQA,MAAa,0BAA0B,QAA8C;CACpF,MAAM,OAAO,iBAAiB,GAAG;CACjC,OAAO,OAAO,qBAAqB,MAAM,GAAG,IAAI;AACjD"}
|
|
1
|
+
{"version":3,"file":"factory.js","names":[],"sources":["../../src/providers/factory.ts"],"sourcesContent":["import { ga4 } from '../adapters/ga4/ga4'\nimport { plausible } from '../adapters/plausible/plausible'\nimport { posthog } from '../adapters/posthog/posthog'\nimport { umami } from '../adapters/umami/umami'\nimport type { AnalyticsAdapter, AnalyticsResult } from '../core/contract'\nimport type { FetchLike } from '../core/fetch'\nimport type { AnalyticsSdks } from '../core/sdks'\nimport { HostRefusedError } from '../core/sourceErrors'\nimport { isRecord } from '../core/values'\nimport { checkDocumentHost, type DocumentHost, type ProviderHostPolicy } from './hosts'\n\nexport const PROVIDER_IDS = ['native', 'plausible', 'umami', 'ga4', 'posthog'] as const\nexport type ProviderId = (typeof PROVIDER_IDS)[number]\n\n/** The provider-settings document shape the adapter factory reads (depth 0, secrets revealed). */\nexport type ProviderDoc = {\n\tid?: number | string\n\tname?: string | null\n\tprovider?: string | null\n\tenabled?: boolean | null\n\tscope?: string | null\n\tplausible?: {\n\t\tsiteId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tdomain?: string | null\n\t\tscriptId?: string | null\n\t\trevenueCurrency?: string | null\n\t} | null\n\tumami?: {\n\t\twebsiteId?: string | null\n\t\tapiKey?: string | null\n\t\ttoken?: string | null\n\t\thost?: string | null\n\t} | null\n\tga4?: {\n\t\tpropertyId?: string | null\n\t\tclientEmail?: string | null\n\t\tprivateKey?: string | null\n\t\tprojectId?: string | null\n\t\tmeasurementId?: string | null\n\t\tcurrency?: string | null\n\t} | null\n\tposthog?: {\n\t\tprojectId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tprojectToken?: string | null\n\t\tregion?: string | null\n\t\tscopeProperty?: string | null\n\t} | null\n}\n\n/** A stored blank reads as unset. */\nconst orUndefined = (value: string | null | undefined): string | undefined => value || undefined\n\n/** An unset or unrecognized stored region falls back to host-derived detection. */\nconst posthogRegion = (value: string | null | undefined): 'us' | 'eu' | undefined =>\n\tvalue === 'us' || value === 'eu' ? value : undefined\n\n/**\n * Keys pasted from a service-account JSON often carry escaped newlines; the gRPC\n * client needs real ones.\n */\nexport const normalizePrivateKey = (key: string): string => key.replace(/\\\\n/g, '\\n')\n\nconst shortId = (id: number | string): string => String(id).slice(-6)\n\n/** The registry id of a provider document's adapter, which grants and stand-ins must match. */\nexport const documentAdapterId = (provider: unknown, id: unknown): string =>\n\t`${String(provider)}:${String(id)}`\n\n/** A lent `native` adapter under the document's name, so a source reads as its tenant named it. */\nconst withDocumentLabel = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter =>\n\tdoc.name ? { ...adapter, label: doc.name } : adapter\n\n/** Per-document ids keep two projects of one provider type apart in a registry. */\nconst withInstanceIdentity = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter => {\n\tif (doc.id === undefined || doc.id === null || doc.id === '') {\n\t\treturn adapter\n\t}\n\treturn {\n\t\t...adapter,\n\t\tid: documentAdapterId(doc.provider, doc.id),\n\t\tlabel: doc.name || `${adapter.label} ${shortId(doc.id)}`,\n\t}\n}\n\n/**\n * Keeps `shape`'s identity and capabilities so the source still lists, but every read throws\n * `error()` and it declares no capture, so its proxy mount answers 404.\n */\nexport const failingAdapter = (\n\tshape: Pick<AnalyticsAdapter, 'id' | 'label' | 'capabilities' | 'realtime'>,\n\terror: () => Error\n): AnalyticsAdapter => {\n\tconst fail = async (): Promise<AnalyticsResult> => {\n\t\tthrow error()\n\t}\n\treturn {\n\t\tid: shape.id,\n\t\tlabel: shape.label,\n\t\tcapabilities: shape.capabilities,\n\t\tisConfigured: () => true,\n\t\tquery: fail,\n\t\t...(shape.realtime ? { realtime: fail } : {}),\n\t}\n}\n\n/**\n * Builds a hosted vendor's adapter on the address its host check allowed, none being the vendor's\n * cloud; a refused host builds one whose reads fail with a `HostRefusedError`.\n */\nconst onDocumentHost = (\n\tverdict: DocumentHost,\n\tbuild: (host: string | undefined) => AnalyticsAdapter\n): AnalyticsAdapter => {\n\tif (verdict.ok) {\n\t\treturn build(verdict.address ?? undefined)\n\t}\n\tconst { host, reason } = verdict\n\treturn failingAdapter(build(undefined), () => new HostRefusedError(host, reason))\n}\n\nconst buildBaseAdapter = (\n\tdoc: ProviderDoc,\n\tctx: ProviderFactoryContext\n): AnalyticsAdapter | null => {\n\tswitch (doc.provider) {\n\t\tcase 'native':\n\t\t\treturn ctx.native ?? null\n\t\tcase 'plausible': {\n\t\t\tconst cfg = doc.plausible ?? {}\n\t\t\treturn onDocumentHost(checkDocumentHost('plausible', cfg.host, ctx.hosts), (host) =>\n\t\t\t\tplausible({\n\t\t\t\t\tsiteId: cfg.siteId ?? '',\n\t\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\t\thost,\n\t\t\t\t\tdomain: orUndefined(cfg.domain),\n\t\t\t\t\tscriptId: orUndefined(cfg.scriptId),\n\t\t\t\t\trevenueCurrency: orUndefined(cfg.revenueCurrency),\n\t\t\t\t\tfetch: ctx.fetch,\n\t\t\t\t})\n\t\t\t)\n\t\t}\n\t\tcase 'umami': {\n\t\t\tconst cfg = doc.umami ?? {}\n\t\t\treturn onDocumentHost(checkDocumentHost('umami', cfg.host, ctx.hosts), (host) =>\n\t\t\t\tumami({\n\t\t\t\t\twebsiteId: cfg.websiteId ?? '',\n\t\t\t\t\tapiKey: orUndefined(cfg.apiKey),\n\t\t\t\t\ttoken: orUndefined(cfg.token),\n\t\t\t\t\thost,\n\t\t\t\t\tfetch: ctx.fetch,\n\t\t\t\t})\n\t\t\t)\n\t\t}\n\t\tcase 'ga4': {\n\t\t\tconst cfg = doc.ga4 ?? {}\n\t\t\treturn ga4({\n\t\t\t\tpropertyId: cfg.propertyId ?? '',\n\t\t\t\tcredentials: {\n\t\t\t\t\tclient_email: cfg.clientEmail ?? '',\n\t\t\t\t\tprivate_key: normalizePrivateKey(cfg.privateKey ?? ''),\n\t\t\t\t},\n\t\t\t\tprojectId: orUndefined(cfg.projectId),\n\t\t\t\tmeasurementId: orUndefined(cfg.measurementId),\n\t\t\t\tcurrency: orUndefined(cfg.currency),\n\t\t\t\t...(ctx.sdks?.ga4 ? { sdk: ctx.sdks.ga4 } : {}),\n\t\t\t})\n\t\t}\n\t\tcase 'posthog': {\n\t\t\tconst cfg = doc.posthog ?? {}\n\t\t\treturn onDocumentHost(checkDocumentHost('posthog', cfg.host, ctx.hosts), (host) =>\n\t\t\t\tposthog({\n\t\t\t\t\tprojectId: cfg.projectId ?? '',\n\t\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\t\thost,\n\t\t\t\t\tprojectToken: orUndefined(cfg.projectToken),\n\t\t\t\t\tregion: posthogRegion(cfg.region),\n\t\t\t\t\tscopeProperty: orUndefined(cfg.scopeProperty?.trim()),\n\t\t\t\t\tfetch: ctx.fetch,\n\t\t\t\t})\n\t\t\t)\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * What the factory needs to build a document's adapter: `fetch` and `hosts` keep a stored key on a\n * host the install allows.\n *\n * @beta\n */\nexport interface ProviderFactoryContext {\n\t/** The guarded fetch `providers.resolve` receives, or one from `createGuardedFetch`. */\n\tfetch: FetchLike\n\t/**\n\t * The policy `providers.resolve` receives, or one from `resolveHostPolicy`: a host outside it\n\t * builds an adapter that reads as `source_misconfigured` and captures nothing.\n\t */\n\thosts: ProviderHostPolicy\n\t/**\n\t * The install's config native adapter, which a `native` document grants rather than building a\n\t * second one.\n\t */\n\tnative?: AnalyticsAdapter\n\t/** The plugin's `sdks`: a GA4 document's adapter reads through `sdks.ga4`. */\n\tsdks?: AnalyticsSdks\n}\n\n/** Checked at runtime: a JavaScript caller can leave the guards out, which would go out unguarded. */\nconst isGuarded = (ctx: unknown): ctx is ProviderFactoryContext =>\n\tisRecord(ctx) &&\n\ttypeof ctx.fetch === 'function' &&\n\tisRecord(ctx.hosts) &&\n\tArray.isArray(ctx.hosts.allow)\n\n/**\n * Builds a provider document's adapter: missing credentials read as `isConfigured() === false`, an\n * unknown provider as null, and a `native` document lends the config adapter under its label.\n */\nexport const adapterFromProviderDoc = (\n\tdoc: ProviderDoc,\n\tctx: ProviderFactoryContext\n): AnalyticsAdapter | null => {\n\tif (!isGuarded(ctx)) {\n\t\tthrow new Error(\n\t\t\t'analytics: adapterFromProviderDoc needs { fetch, hosts }: pass the ones providers.resolve receives'\n\t\t)\n\t}\n\tconst base = buildBaseAdapter(doc, ctx)\n\tif (!base) {\n\t\treturn null\n\t}\n\treturn doc.provider === 'native' ? withDocumentLabel(base, doc) : withInstanceIdentity(base, doc)\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
//#region src/providers/hosts.d.ts
|
|
2
|
+
/** One `providers.hosts.allow` entry, parsed. */
|
|
3
|
+
type HostPattern = {
|
|
4
|
+
kind: 'exact';
|
|
5
|
+
origin: string;
|
|
6
|
+
} | {
|
|
7
|
+
kind: 'subdomains';
|
|
8
|
+
protocol: string;
|
|
9
|
+
port: string;
|
|
10
|
+
suffix: string;
|
|
11
|
+
};
|
|
12
|
+
/** `providers.hosts`, resolved. */
|
|
13
|
+
interface ProviderHostPolicy {
|
|
14
|
+
allow: readonly HostPattern[];
|
|
15
|
+
allowPrivateNetwork: boolean;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* `providers.hosts` checked at boot.
|
|
19
|
+
*
|
|
20
|
+
* @beta
|
|
21
|
+
*/
|
|
22
|
+
declare const resolveHostPolicy: (option: unknown) => ProviderHostPolicy;
|
|
23
|
+
//#endregion
|
|
24
|
+
export { HostPattern, ProviderHostPolicy, resolveHostPolicy };
|
|
25
|
+
//# sourceMappingURL=hosts.d.ts.map
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { isRecord, onlyKeys } from "../core/values.js";
|
|
2
|
+
import { keys } from "../translations/keys.js";
|
|
3
|
+
import { parseHttpUrl, parseOrigin } from "../net/origin.js";
|
|
4
|
+
import { asTranslate } from "../translations/server.js";
|
|
5
|
+
//#region src/providers/hosts.ts
|
|
6
|
+
/**
|
|
7
|
+
* Each vendor's own cloud, always allowed: its default origin, Umami Cloud's app address, and
|
|
8
|
+
* PostHog's other region and legacy US address.
|
|
9
|
+
*/
|
|
10
|
+
const CLOUD_ORIGINS = {
|
|
11
|
+
plausible: ["https://plausible.io"],
|
|
12
|
+
umami: ["https://api.umami.is", "https://cloud.umami.is"],
|
|
13
|
+
posthog: [
|
|
14
|
+
"https://us.posthog.com",
|
|
15
|
+
"https://eu.posthog.com",
|
|
16
|
+
"https://app.posthog.com"
|
|
17
|
+
]
|
|
18
|
+
};
|
|
19
|
+
const DEFAULT_HOST_POLICY = {
|
|
20
|
+
allow: [],
|
|
21
|
+
allowPrivateNetwork: false
|
|
22
|
+
};
|
|
23
|
+
/**
|
|
24
|
+
* The address `value` names: an origin and an optional base path, with no credentials, query or
|
|
25
|
+
* fragment and its trailing slash dropped. `http` only when the install allows private networks.
|
|
26
|
+
*/
|
|
27
|
+
const parseHostAddress = (value, allowPrivateNetwork) => {
|
|
28
|
+
const url = parseHttpUrl(value, allowPrivateNetwork);
|
|
29
|
+
if (!(url instanceof URL)) return url;
|
|
30
|
+
return {
|
|
31
|
+
origin: url.origin,
|
|
32
|
+
address: `${url.origin}${url.pathname.replace(/\/+$/, "")}`
|
|
33
|
+
};
|
|
34
|
+
};
|
|
35
|
+
const WILDCARD = "*.";
|
|
36
|
+
/**
|
|
37
|
+
* One allow entry: `https://analytics.example.com`, or `https://*.example.com` for every
|
|
38
|
+
* subdomain of example.com (not example.com itself). Throws a boot error naming the entry.
|
|
39
|
+
*/
|
|
40
|
+
const parseHostPattern = (entry, allowPrivateNetwork) => {
|
|
41
|
+
const fail = (reason) => {
|
|
42
|
+
throw new Error(`analytics: providers.hosts.allow entry ${JSON.stringify(entry)} ${reason}`);
|
|
43
|
+
};
|
|
44
|
+
if (typeof entry !== "string" || entry.trim() === "") return fail("must be an origin such as \"https://analytics.example.com\"");
|
|
45
|
+
const trimmed = entry.trim();
|
|
46
|
+
const scheme = trimmed.indexOf("://");
|
|
47
|
+
const wildcard = scheme !== -1 && trimmed.startsWith(WILDCARD, scheme + 3);
|
|
48
|
+
const candidate = wildcard ? `${trimmed.slice(0, scheme + 3)}${trimmed.slice(scheme + 3 + 2)}` : trimmed;
|
|
49
|
+
if (candidate.includes("*")) return fail("may only start its host with \"*.\", as in \"https://*.example.com\"");
|
|
50
|
+
const parsed = parseOrigin(candidate, allowPrivateNetwork);
|
|
51
|
+
if ("problem" in parsed) return fail(parsed.problem === "insecure" ? "uses http, which needs providers.hosts.allowPrivateNetwork" : "must be an origin with no path, query or credentials, such as \"https://analytics.example.com\"");
|
|
52
|
+
if (!wildcard) return {
|
|
53
|
+
kind: "exact",
|
|
54
|
+
origin: parsed.origin
|
|
55
|
+
};
|
|
56
|
+
const url = new URL(parsed.origin);
|
|
57
|
+
if (!url.hostname.includes(".")) return fail("would match every site under one top-level domain; name a domain, as in \"https://*.example.com\"");
|
|
58
|
+
return {
|
|
59
|
+
kind: "subdomains",
|
|
60
|
+
protocol: url.protocol,
|
|
61
|
+
port: url.port,
|
|
62
|
+
suffix: url.hostname
|
|
63
|
+
};
|
|
64
|
+
};
|
|
65
|
+
/**
|
|
66
|
+
* `providers.hosts` checked at boot.
|
|
67
|
+
*
|
|
68
|
+
* @beta
|
|
69
|
+
*/
|
|
70
|
+
const resolveHostPolicy = (option) => {
|
|
71
|
+
if (option === void 0) return DEFAULT_HOST_POLICY;
|
|
72
|
+
if (!isRecord(option) || Array.isArray(option)) throw new Error("analytics: providers.hosts must be an object such as { allow: [\"https://analytics.example.com\"] }");
|
|
73
|
+
onlyKeys(option, ["allow", "allowPrivateNetwork"], "providers.hosts");
|
|
74
|
+
const allowPrivateNetwork = option.allowPrivateNetwork ?? false;
|
|
75
|
+
if (typeof allowPrivateNetwork !== "boolean") throw new Error("analytics: providers.hosts.allowPrivateNetwork must be a boolean");
|
|
76
|
+
const allow = option.allow ?? [];
|
|
77
|
+
if (!Array.isArray(allow)) throw new Error("analytics: providers.hosts.allow must be a list of origins");
|
|
78
|
+
return {
|
|
79
|
+
allow: allow.map((entry) => parseHostPattern(entry, allowPrivateNetwork)),
|
|
80
|
+
allowPrivateNetwork
|
|
81
|
+
};
|
|
82
|
+
};
|
|
83
|
+
const matches = (pattern, url) => pattern.kind === "exact" ? url.origin === pattern.origin : url.protocol === pattern.protocol && url.port === pattern.port && url.hostname.endsWith(`.${pattern.suffix}`);
|
|
84
|
+
/**
|
|
85
|
+
* A document's `host` under the install's policy: blank is the vendor's cloud, anything else needs
|
|
86
|
+
* an origin that is that cloud or in `allow`. The allowlist is about which server, not which path.
|
|
87
|
+
*/
|
|
88
|
+
const checkDocumentHost = (provider, raw, policy) => {
|
|
89
|
+
const value = raw?.trim() ?? "";
|
|
90
|
+
if (value === "") return {
|
|
91
|
+
ok: true,
|
|
92
|
+
address: null
|
|
93
|
+
};
|
|
94
|
+
const parsed = parseHostAddress(value, policy.allowPrivateNetwork);
|
|
95
|
+
if ("problem" in parsed) return {
|
|
96
|
+
ok: false,
|
|
97
|
+
host: value,
|
|
98
|
+
reason: parsed.problem === "insecure" ? "it uses http, which needs providers.hosts.allowPrivateNetwork" : "it is not an address this install accepts"
|
|
99
|
+
};
|
|
100
|
+
if (CLOUD_ORIGINS[provider].includes(parsed.origin)) return {
|
|
101
|
+
ok: true,
|
|
102
|
+
address: parsed.address
|
|
103
|
+
};
|
|
104
|
+
const url = new URL(parsed.origin);
|
|
105
|
+
if (policy.allow.some((pattern) => matches(pattern, url))) return {
|
|
106
|
+
ok: true,
|
|
107
|
+
address: parsed.address
|
|
108
|
+
};
|
|
109
|
+
return {
|
|
110
|
+
ok: false,
|
|
111
|
+
host: parsed.origin,
|
|
112
|
+
reason: "it is not listed in providers.hosts.allow"
|
|
113
|
+
};
|
|
114
|
+
};
|
|
115
|
+
/**
|
|
116
|
+
* The `validate` of every provider `host` field: blank, or the address of the service with an
|
|
117
|
+
* optional base path and nothing else, over https unless the install allows private networks.
|
|
118
|
+
*/
|
|
119
|
+
const validateProviderHost = (allowPrivateNetwork) => (value, { req }) => {
|
|
120
|
+
if (!value || value.trim() === "") return true;
|
|
121
|
+
const parsed = parseHostAddress(value, allowPrivateNetwork);
|
|
122
|
+
if (!("problem" in parsed)) return true;
|
|
123
|
+
return asTranslate(req.t)(parsed.problem === "insecure" ? keys.providerErrorHostInsecure : keys.providerErrorHostFormat);
|
|
124
|
+
};
|
|
125
|
+
//#endregion
|
|
126
|
+
export { checkDocumentHost, resolveHostPolicy, validateProviderHost };
|
|
127
|
+
|
|
128
|
+
//# sourceMappingURL=hosts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hosts.js","names":[],"sources":["../../src/providers/hosts.ts"],"sourcesContent":["import type { TextFieldSingleValidation } from 'payload'\nimport { isRecord, onlyKeys } from '../core/values'\nimport { type OriginProblem, parseHttpUrl, parseOrigin } from '../net/origin'\nimport { keys } from '../translations/keys'\nimport { asTranslate } from '../translations/server'\n\n/** The providers whose document names a host. GA4 always talks to Google. */\nexport type HostedProvider = 'plausible' | 'umami' | 'posthog'\n\n/**\n * Each vendor's own cloud, always allowed: its default origin, Umami Cloud's app address, and\n * PostHog's other region and legacy US address.\n */\nexport const CLOUD_ORIGINS: Readonly<Record<HostedProvider, readonly string[]>> = {\n\tplausible: ['https://plausible.io'],\n\tumami: ['https://api.umami.is', 'https://cloud.umami.is'],\n\tposthog: ['https://us.posthog.com', 'https://eu.posthog.com', 'https://app.posthog.com'],\n}\n\n/** One `providers.hosts.allow` entry, parsed. */\nexport type HostPattern =\n\t| { kind: 'exact'; origin: string }\n\t| { kind: 'subdomains'; protocol: string; port: string; suffix: string }\n\n/** `providers.hosts`, resolved. */\nexport interface ProviderHostPolicy {\n\tallow: readonly HostPattern[]\n\tallowPrivateNetwork: boolean\n}\n\nexport const DEFAULT_HOST_POLICY: ProviderHostPolicy = { allow: [], allowPrivateNetwork: false }\n\n/** A vendor's address, as a document's `host` names it. */\ninterface HostAddress {\n\t/** Scheme, host and port: what the allowlist matches. */\n\torigin: string\n\t/** The origin and the base path a vendor served under a sub-path needs, with no trailing slash. */\n\taddress: string\n}\n\n/**\n * The address `value` names: an origin and an optional base path, with no credentials, query or\n * fragment and its trailing slash dropped. `http` only when the install allows private networks.\n */\nexport const parseHostAddress = (\n\tvalue: string,\n\tallowPrivateNetwork: boolean\n): HostAddress | { problem: OriginProblem } => {\n\tconst url = parseHttpUrl(value, allowPrivateNetwork)\n\tif (!(url instanceof URL)) {\n\t\treturn url\n\t}\n\treturn { origin: url.origin, address: `${url.origin}${url.pathname.replace(/\\/+$/, '')}` }\n}\n\nconst WILDCARD = '*.'\n\n/**\n * One allow entry: `https://analytics.example.com`, or `https://*.example.com` for every\n * subdomain of example.com (not example.com itself). Throws a boot error naming the entry.\n */\nexport const parseHostPattern = (entry: unknown, allowPrivateNetwork: boolean): HostPattern => {\n\tconst fail = (reason: string): never => {\n\t\tthrow new Error(`analytics: providers.hosts.allow entry ${JSON.stringify(entry)} ${reason}`)\n\t}\n\tif (typeof entry !== 'string' || entry.trim() === '') {\n\t\treturn fail('must be an origin such as \"https://analytics.example.com\"')\n\t}\n\tconst trimmed = entry.trim()\n\tconst scheme = trimmed.indexOf('://')\n\tconst wildcard = scheme !== -1 && trimmed.startsWith(WILDCARD, scheme + 3)\n\tconst candidate = wildcard\n\t\t? `${trimmed.slice(0, scheme + 3)}${trimmed.slice(scheme + 3 + WILDCARD.length)}`\n\t\t: trimmed\n\tif (candidate.includes('*')) {\n\t\treturn fail('may only start its host with \"*.\", as in \"https://*.example.com\"')\n\t}\n\tconst parsed = parseOrigin(candidate, allowPrivateNetwork)\n\tif ('problem' in parsed) {\n\t\treturn fail(\n\t\t\tparsed.problem === 'insecure'\n\t\t\t\t? 'uses http, which needs providers.hosts.allowPrivateNetwork'\n\t\t\t\t: 'must be an origin with no path, query or credentials, such as \"https://analytics.example.com\"'\n\t\t)\n\t}\n\tif (!wildcard) {\n\t\treturn { kind: 'exact', origin: parsed.origin }\n\t}\n\tconst url = new URL(parsed.origin)\n\tif (!url.hostname.includes('.')) {\n\t\treturn fail(\n\t\t\t'would match every site under one top-level domain; name a domain, as in \"https://*.example.com\"'\n\t\t)\n\t}\n\treturn { kind: 'subdomains', protocol: url.protocol, port: url.port, suffix: url.hostname }\n}\n\n/**\n * `providers.hosts` checked at boot.\n *\n * @beta\n */\nexport const resolveHostPolicy = (option: unknown): ProviderHostPolicy => {\n\tif (option === undefined) {\n\t\treturn DEFAULT_HOST_POLICY\n\t}\n\tif (!isRecord(option) || Array.isArray(option)) {\n\t\tthrow new Error(\n\t\t\t'analytics: providers.hosts must be an object such as { allow: [\"https://analytics.example.com\"] }'\n\t\t)\n\t}\n\tonlyKeys(option, ['allow', 'allowPrivateNetwork'], 'providers.hosts')\n\tconst allowPrivateNetwork = option.allowPrivateNetwork ?? false\n\tif (typeof allowPrivateNetwork !== 'boolean') {\n\t\tthrow new Error('analytics: providers.hosts.allowPrivateNetwork must be a boolean')\n\t}\n\tconst allow = option.allow ?? []\n\tif (!Array.isArray(allow)) {\n\t\tthrow new Error('analytics: providers.hosts.allow must be a list of origins')\n\t}\n\treturn {\n\t\tallow: allow.map((entry: unknown) => parseHostPattern(entry, allowPrivateNetwork)),\n\t\tallowPrivateNetwork,\n\t}\n}\n\nconst matches = (pattern: HostPattern, url: URL): boolean =>\n\tpattern.kind === 'exact'\n\t\t? url.origin === pattern.origin\n\t\t: url.protocol === pattern.protocol &&\n\t\t\turl.port === pattern.port &&\n\t\t\turl.hostname.endsWith(`.${pattern.suffix}`)\n\n/** Whether a document's host may be reached, and the address it names; null for the vendor's cloud. */\nexport type DocumentHost =\n\t| { ok: true; address: string | null }\n\t| { ok: false; host: string; reason: string }\n\n/**\n * A document's `host` under the install's policy: blank is the vendor's cloud, anything else needs\n * an origin that is that cloud or in `allow`. The allowlist is about which server, not which path.\n */\nexport const checkDocumentHost = (\n\tprovider: HostedProvider,\n\traw: string | null | undefined,\n\tpolicy: ProviderHostPolicy\n): DocumentHost => {\n\tconst value = raw?.trim() ?? ''\n\tif (value === '') {\n\t\treturn { ok: true, address: null }\n\t}\n\tconst parsed = parseHostAddress(value, policy.allowPrivateNetwork)\n\tif ('problem' in parsed) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\thost: value,\n\t\t\treason:\n\t\t\t\tparsed.problem === 'insecure'\n\t\t\t\t\t? 'it uses http, which needs providers.hosts.allowPrivateNetwork'\n\t\t\t\t\t: 'it is not an address this install accepts',\n\t\t}\n\t}\n\tif (CLOUD_ORIGINS[provider].includes(parsed.origin)) {\n\t\treturn { ok: true, address: parsed.address }\n\t}\n\tconst url = new URL(parsed.origin)\n\tif (policy.allow.some((pattern) => matches(pattern, url))) {\n\t\treturn { ok: true, address: parsed.address }\n\t}\n\treturn { ok: false, host: parsed.origin, reason: 'it is not listed in providers.hosts.allow' }\n}\n\n/**\n * The `validate` of every provider `host` field: blank, or the address of the service with an\n * optional base path and nothing else, over https unless the install allows private networks.\n */\nexport const validateProviderHost =\n\t(allowPrivateNetwork: boolean): TextFieldSingleValidation =>\n\t(value, { req }) => {\n\t\tif (!value || value.trim() === '') {\n\t\t\treturn true\n\t\t}\n\t\tconst parsed = parseHostAddress(value, allowPrivateNetwork)\n\t\tif (!('problem' in parsed)) {\n\t\t\treturn true\n\t\t}\n\t\treturn asTranslate(req.t)(\n\t\t\tparsed.problem === 'insecure' ? keys.providerErrorHostInsecure : keys.providerErrorHostFormat\n\t\t)\n\t}\n"],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import { Payload } from "payload";
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import { canonicalJson, isRecord } from "../core/values.js";
|
|
2
|
+
import { currentTime } from "../core/clock.js";
|
|
3
|
+
import { remember } from "../surfacing/bounded.js";
|
|
4
|
+
import { docScope } from "../plugin/scopeChange.js";
|
|
5
|
+
import { isCollectionSlug } from "../core/collectionSlug.js";
|
|
6
|
+
import { DETACHED } from "../db/openTransaction.js";
|
|
7
|
+
import { createHash } from "node:crypto";
|
|
8
|
+
//#region src/providers/probe.ts
|
|
9
|
+
/** How long an instance trusts a probe before asking the database again: the bound on convergence. */
|
|
10
|
+
const PROBE_MEMO_MS = 1e4;
|
|
11
|
+
/** Far above any realistic document count for one scope. */
|
|
12
|
+
const MAX_ROWS = 1e3;
|
|
13
|
+
/** Scopes memoized before the expired ones are dropped. */
|
|
14
|
+
const PRUNE_AT = 1e3;
|
|
15
|
+
/** A stored date as an ISO instant, or empty when there is none. */
|
|
16
|
+
const versionOf = (value) => {
|
|
17
|
+
if (!(value instanceof Date) && typeof value !== "string" && typeof value !== "number") return "";
|
|
18
|
+
const ms = new Date(value).getTime();
|
|
19
|
+
return Number.isNaN(ms) ? "" : new Date(ms).toISOString();
|
|
20
|
+
};
|
|
21
|
+
const byId = (a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
|
|
22
|
+
/** A digest of the rows that ignores their order. */
|
|
23
|
+
const probeEpoch = (rows) => createHash("sha256").update(canonicalJson([...rows].sort(byId))).digest("base64url");
|
|
24
|
+
/** A scope as every read keys it: absent or empty is the install-wide scope, null. */
|
|
25
|
+
const scopeOf = (scope) => scope === void 0 || scope === "" ? null : scope;
|
|
26
|
+
/**
|
|
27
|
+
* Committed state of a collection's documents per scope, read on a detached request: an uncommitted
|
|
28
|
+
* row is never seen, so nothing keyed on an epoch can roll back.
|
|
29
|
+
*/
|
|
30
|
+
const createCollectionProbe = (options) => {
|
|
31
|
+
const { payload, slug, scopeField } = options;
|
|
32
|
+
const memoMs = options.memoMs ?? 1e4;
|
|
33
|
+
const now = options.now ?? currentTime;
|
|
34
|
+
const select = {
|
|
35
|
+
updatedAt: true,
|
|
36
|
+
enabled: true,
|
|
37
|
+
[scopeField]: true,
|
|
38
|
+
...options.provider ? { provider: true } : {}
|
|
39
|
+
};
|
|
40
|
+
const memo = /* @__PURE__ */ new Map();
|
|
41
|
+
const expedited = /* @__PURE__ */ new Map();
|
|
42
|
+
const rowOf = (doc) => ({
|
|
43
|
+
id: String(doc.id),
|
|
44
|
+
updatedAt: versionOf(doc.updatedAt),
|
|
45
|
+
enabled: doc.enabled === true,
|
|
46
|
+
...options.provider ? { provider: typeof doc.provider === "string" ? doc.provider : "" } : {},
|
|
47
|
+
scope: docScope(doc, scopeField)
|
|
48
|
+
});
|
|
49
|
+
const query = async (scope) => {
|
|
50
|
+
if (!isCollectionSlug(payload, slug)) throw new Error(`analytics: no "${slug}" collection is registered`);
|
|
51
|
+
const { docs } = await payload.db.find({
|
|
52
|
+
collection: slug,
|
|
53
|
+
limit: MAX_ROWS,
|
|
54
|
+
pagination: false,
|
|
55
|
+
req: DETACHED,
|
|
56
|
+
select,
|
|
57
|
+
...options.where ? { where: options.where(scope) } : {}
|
|
58
|
+
});
|
|
59
|
+
const rows = docs.filter(isRecord).map(rowOf);
|
|
60
|
+
return {
|
|
61
|
+
rows,
|
|
62
|
+
epoch: probeEpoch(rows)
|
|
63
|
+
};
|
|
64
|
+
};
|
|
65
|
+
const prune = (at) => {
|
|
66
|
+
for (const [key, entry] of memo) if (at - entry.at >= memoMs) memo.delete(key);
|
|
67
|
+
for (const [key, until] of expedited) if (until <= at) expedited.delete(key);
|
|
68
|
+
};
|
|
69
|
+
return {
|
|
70
|
+
read(raw) {
|
|
71
|
+
const scope = scopeOf(raw);
|
|
72
|
+
const key = scope ?? "";
|
|
73
|
+
const at = now();
|
|
74
|
+
if ((expedited.get(key) ?? 0) > at) return query(scope);
|
|
75
|
+
const hit = memo.get(key);
|
|
76
|
+
if (hit && at - hit.at < memoMs) return hit.probe;
|
|
77
|
+
if (memo.size >= PRUNE_AT) prune(at);
|
|
78
|
+
const probe = query(scope);
|
|
79
|
+
remember(memo, [key, {
|
|
80
|
+
at,
|
|
81
|
+
probe
|
|
82
|
+
}]);
|
|
83
|
+
probe.catch(() => {
|
|
84
|
+
if (memo.get(key)?.probe === probe) memo.delete(key);
|
|
85
|
+
});
|
|
86
|
+
return probe;
|
|
87
|
+
},
|
|
88
|
+
expedite(scopes) {
|
|
89
|
+
const until = now() + memoMs;
|
|
90
|
+
for (const raw of scopes) {
|
|
91
|
+
const key = scopeOf(raw) ?? "";
|
|
92
|
+
memo.delete(key);
|
|
93
|
+
remember(expedited, [key, until]);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
};
|
|
97
|
+
};
|
|
98
|
+
//#endregion
|
|
99
|
+
export { PROBE_MEMO_MS, createCollectionProbe, scopeOf, versionOf };
|
|
100
|
+
|
|
101
|
+
//# sourceMappingURL=probe.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"probe.js","names":[],"sources":["../../src/providers/probe.ts"],"sourcesContent":["import { createHash } from 'node:crypto'\nimport type { Payload, SelectType, Where } from 'payload'\nimport { currentTime } from '../core/clock'\nimport { isCollectionSlug } from '../core/collectionSlug'\nimport { canonicalJson, isRecord } from '../core/values'\nimport { DETACHED } from '../db/openTransaction'\nimport { docScope } from '../plugin/scopeChange'\nimport { remember } from '../surfacing/bounded'\n\n/** How long an instance trusts a probe before asking the database again: the bound on convergence. */\nexport const PROBE_MEMO_MS = 10_000\n\n/** Far above any realistic document count for one scope. */\nconst MAX_ROWS = 1_000\n\n/** Scopes memoized before the expired ones are dropped. */\nconst PRUNE_AT = 1_000\n\n/** One document as the probe reads it: what tells a change apart, never a credential. */\nexport interface ProbeRow {\n\tid: string\n\t/** The last save as an ISO instant; empty for a document without one. */\n\tupdatedAt: string\n\tenabled: boolean\n\t/** The provider type, on rows of the providers collection only. */\n\tprovider?: string\n\tscope: string | null\n}\n\nexport interface Probe {\n\t/** In the order the database answers a lookup without a sort, which is the registry's order. */\n\trows: readonly ProbeRow[]\n\t/** Equal for equal committed states, whatever order the rows came in. */\n\tepoch: string\n}\n\n/** A stored date as an ISO instant, or empty when there is none. */\nexport const versionOf = (value: unknown): string => {\n\tif (!(value instanceof Date) && typeof value !== 'string' && typeof value !== 'number') {\n\t\treturn ''\n\t}\n\tconst ms = new Date(value).getTime()\n\treturn Number.isNaN(ms) ? '' : new Date(ms).toISOString()\n}\n\nconst byId = (a: ProbeRow, b: ProbeRow): number => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)\n\n/** A digest of the rows that ignores their order. */\nexport const probeEpoch = (rows: readonly ProbeRow[]): string =>\n\tcreateHash('sha256')\n\t\t.update(canonicalJson([...rows].sort(byId)))\n\t\t.digest('base64url')\n\n/** A scope as every read keys it: absent or empty is the install-wide scope, null. */\nexport const scopeOf = (scope: string | null | undefined): string | null =>\n\tscope === undefined || scope === '' ? null : scope\n\nexport interface CollectionProbe {\n\t/** The scope's rows and epoch as committed, read outside any transaction and memoized per instance. */\n\tread(scope: string | null | undefined): Promise<Probe>\n\t/**\n\t * A save on this instance touched these scopes: they are asked of the database on every read\n\t * for one memo window, so this instance sees the save as soon as it commits. Writes nothing.\n\t */\n\texpedite(scopes: Iterable<string | null>): void\n}\n\ninterface CollectionProbeOptions {\n\tpayload: Payload\n\tslug: string\n\tscopeField: string\n\t/** The clause selecting one scope's documents; absent, every scope reads every document. */\n\twhere?: (scope: string | null) => Where\n\t/** Whether the collection's rows carry a `provider`. */\n\tprovider?: boolean\n\tmemoMs?: number\n\tnow?: () => number\n}\n\ninterface Memoized {\n\tat: number\n\tprobe: Promise<Probe>\n}\n\n/**\n * Committed state of a collection's documents per scope, read on a detached request: an uncommitted\n * row is never seen, so nothing keyed on an epoch can roll back.\n */\nexport const createCollectionProbe = (options: CollectionProbeOptions): CollectionProbe => {\n\tconst { payload, slug, scopeField } = options\n\tconst memoMs = options.memoMs ?? PROBE_MEMO_MS\n\tconst now = options.now ?? currentTime\n\tconst select: SelectType = {\n\t\tupdatedAt: true,\n\t\tenabled: true,\n\t\t[scopeField]: true,\n\t\t...(options.provider ? { provider: true } : {}),\n\t}\n\tconst memo = new Map<string, Memoized>()\n\tconst expedited = new Map<string, number>()\n\n\tconst rowOf = (doc: Record<string, unknown>): ProbeRow => ({\n\t\tid: String(doc.id),\n\t\tupdatedAt: versionOf(doc.updatedAt),\n\t\tenabled: doc.enabled === true,\n\t\t...(options.provider ? { provider: typeof doc.provider === 'string' ? doc.provider : '' } : {}),\n\t\tscope: docScope(doc, scopeField),\n\t})\n\n\tconst query = async (scope: string | null): Promise<Probe> => {\n\t\tif (!isCollectionSlug(payload, slug)) {\n\t\t\tthrow new Error(`analytics: no \"${slug}\" collection is registered`)\n\t\t}\n\t\tconst { docs } = await payload.db.find<Record<string, unknown>>({\n\t\t\tcollection: slug,\n\t\t\tlimit: MAX_ROWS,\n\t\t\tpagination: false,\n\t\t\treq: DETACHED,\n\t\t\tselect,\n\t\t\t...(options.where ? { where: options.where(scope) } : {}),\n\t\t})\n\t\tconst rows = docs.filter(isRecord).map(rowOf)\n\t\treturn { rows, epoch: probeEpoch(rows) }\n\t}\n\n\tconst prune = (at: number): void => {\n\t\tfor (const [key, entry] of memo) {\n\t\t\tif (at - entry.at >= memoMs) {\n\t\t\t\tmemo.delete(key)\n\t\t\t}\n\t\t}\n\t\tfor (const [key, until] of expedited) {\n\t\t\tif (until <= at) {\n\t\t\t\texpedited.delete(key)\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tread(raw) {\n\t\t\tconst scope = scopeOf(raw)\n\t\t\tconst key = scope ?? ''\n\t\t\tconst at = now()\n\t\t\tif ((expedited.get(key) ?? 0) > at) {\n\t\t\t\treturn query(scope)\n\t\t\t}\n\t\t\tconst hit = memo.get(key)\n\t\t\tif (hit && at - hit.at < memoMs) {\n\t\t\t\treturn hit.probe\n\t\t\t}\n\t\t\tif (memo.size >= PRUNE_AT) {\n\t\t\t\tprune(at)\n\t\t\t}\n\t\t\tconst probe = query(scope)\n\t\t\tremember(memo, [key, { at, probe }])\n\t\t\tprobe.catch(() => {\n\t\t\t\tif (memo.get(key)?.probe === probe) {\n\t\t\t\t\tmemo.delete(key)\n\t\t\t\t}\n\t\t\t})\n\t\t\treturn probe\n\t\t},\n\t\texpedite(scopes) {\n\t\t\tconst until = now() + memoMs\n\t\t\tfor (const raw of scopes) {\n\t\t\t\tconst key = scopeOf(raw) ?? ''\n\t\t\t\tmemo.delete(key)\n\t\t\t\tremember(expedited, [key, until])\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { Payload, PayloadRequest } from "payload";
|
|
2
|
+
|
|
3
|
+
//#region src/providers/refresh.d.ts
|
|
4
|
+
interface RefreshProvidersOptions {
|
|
5
|
+
/**
|
|
6
|
+
* The changing save's request, from inside a hook: the token is written once its transaction ends
|
|
7
|
+
* so nobody reads old settings under it; resolves at once, logging failures.
|
|
8
|
+
*/
|
|
9
|
+
req?: PayloadRequest;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Retires one scope's cached reads on every instance (this one at once, others within ten seconds)
|
|
13
|
+
* for a `providers.resolve` install. Rejects when the token could not be stored.
|
|
14
|
+
*/
|
|
15
|
+
declare const refreshProviders: (payload: Payload, scope?: string | null, options?: RefreshProvidersOptions) => Promise<void>;
|
|
16
|
+
//#endregion
|
|
17
|
+
export { RefreshProvidersOptions, refreshProviders };
|
|
18
|
+
//# sourceMappingURL=refresh.d.ts.map
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { configEpochKeyFor, kvEpochBackend } from "../surfacing/epoch.js";
|
|
2
|
+
import { getRuntime } from "../plugin/runtime.js";
|
|
3
|
+
import { afterTransaction, openTransactionOf } from "../db/openTransaction.js";
|
|
4
|
+
import { nativeInstanceOf } from "../native/engine/instance.js";
|
|
5
|
+
//#region src/providers/refresh.ts
|
|
6
|
+
/**
|
|
7
|
+
* Where a `providers.resolve` install keeps each scope's configuration token: `analytics-state`
|
|
8
|
+
* while the native engine runs on the instance, `payload.kv` otherwise.
|
|
9
|
+
*/
|
|
10
|
+
const configTokenBackend = (payload) => {
|
|
11
|
+
const kv = kvEpochBackend(payload, configEpochKeyFor);
|
|
12
|
+
return {
|
|
13
|
+
get: async (scope) => {
|
|
14
|
+
const state = nativeInstanceOf(payload)?.state;
|
|
15
|
+
if (!state) return kv.get(scope);
|
|
16
|
+
return await state.configToken(scope ?? "") ?? "0";
|
|
17
|
+
},
|
|
18
|
+
set: async (scope, token) => {
|
|
19
|
+
const state = nativeInstanceOf(payload)?.state;
|
|
20
|
+
if (!state) {
|
|
21
|
+
await kv.set(scope, token);
|
|
22
|
+
return;
|
|
23
|
+
}
|
|
24
|
+
await state.setConfigToken(scope ?? "", token);
|
|
25
|
+
}
|
|
26
|
+
};
|
|
27
|
+
};
|
|
28
|
+
/**
|
|
29
|
+
* Retires one scope's cached reads on every instance (this one at once, others within ten seconds)
|
|
30
|
+
* for a `providers.resolve` install. Rejects when the token could not be stored.
|
|
31
|
+
*/
|
|
32
|
+
const refreshProviders = async (payload, scope = null, options = {}) => {
|
|
33
|
+
const runtime = getRuntime(payload);
|
|
34
|
+
const refresh = runtime?.refreshProviders;
|
|
35
|
+
if (!runtime || !refresh) return;
|
|
36
|
+
const open = await openTransactionOf(payload, options.req);
|
|
37
|
+
if (!open) {
|
|
38
|
+
await refresh(scope);
|
|
39
|
+
return;
|
|
40
|
+
}
|
|
41
|
+
const deferred = afterTransaction(open, () => refresh(scope)).catch((err) => {
|
|
42
|
+
payload.logger?.warn(`analytics: refreshing the providers of scope "${scope ?? ""}" after its save failed: ${String(err)}`);
|
|
43
|
+
});
|
|
44
|
+
runtime.engine.keep?.(deferred);
|
|
45
|
+
};
|
|
46
|
+
//#endregion
|
|
47
|
+
export { configTokenBackend, refreshProviders };
|
|
48
|
+
|
|
49
|
+
//# sourceMappingURL=refresh.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"refresh.js","names":[],"sources":["../../src/providers/refresh.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport { afterTransaction, openTransactionOf } from '../db/openTransaction'\nimport { nativeInstanceOf } from '../native/engine/instance'\nimport { getRuntime } from '../plugin/runtime'\nimport {\n\tconfigEpochKeyFor,\n\ttype EpochBackend,\n\tINITIAL_EPOCH,\n\tkvEpochBackend,\n} from '../surfacing/epoch'\n\n/**\n * Where a `providers.resolve` install keeps each scope's configuration token: `analytics-state`\n * while the native engine runs on the instance, `payload.kv` otherwise.\n */\nexport const configTokenBackend = (payload: Payload): EpochBackend => {\n\tconst kv = kvEpochBackend(payload, configEpochKeyFor)\n\treturn {\n\t\tget: async (scope) => {\n\t\t\tconst state = nativeInstanceOf(payload)?.state\n\t\t\tif (!state) {\n\t\t\t\treturn kv.get(scope)\n\t\t\t}\n\t\t\treturn (await state.configToken(scope ?? '')) ?? INITIAL_EPOCH\n\t\t},\n\t\tset: async (scope, token) => {\n\t\t\tconst state = nativeInstanceOf(payload)?.state\n\t\t\tif (!state) {\n\t\t\t\tawait kv.set(scope, token)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tawait state.setConfigToken(scope ?? '', token)\n\t\t},\n\t}\n}\n\nexport interface RefreshProvidersOptions {\n\t/**\n\t * The changing save's request, from inside a hook: the token is written once its transaction ends\n\t * so nobody reads old settings under it; resolves at once, logging failures.\n\t */\n\treq?: PayloadRequest\n}\n\n/**\n * Retires one scope's cached reads on every instance (this one at once, others within ten seconds)\n * for a `providers.resolve` install. Rejects when the token could not be stored.\n */\nexport const refreshProviders = async (\n\tpayload: Payload,\n\tscope: string | null = null,\n\toptions: RefreshProvidersOptions = {}\n): Promise<void> => {\n\tconst runtime = getRuntime(payload)\n\tconst refresh = runtime?.refreshProviders\n\tif (!runtime || !refresh) {\n\t\treturn\n\t}\n\tconst open = await openTransactionOf(payload, options.req)\n\tif (!open) {\n\t\tawait refresh(scope)\n\t\treturn\n\t}\n\tconst deferred = afterTransaction(open, () => refresh(scope)).catch((err: unknown) => {\n\t\tpayload.logger?.warn(\n\t\t\t`analytics: refreshing the providers of scope \"${scope ?? ''}\" after its save failed: ${String(err)}`\n\t\t)\n\t})\n\truntime.engine.keep?.(deferred)\n}\n"],"mappings":";;;;;;;;;AAeA,MAAa,sBAAsB,YAAmC;CACrE,MAAM,KAAK,eAAe,SAAS,iBAAiB;CACpD,OAAO;EACN,KAAK,OAAO,UAAU;GACrB,MAAM,QAAQ,iBAAiB,OAAO,GAAG;GACzC,IAAI,CAAC,OACJ,OAAO,GAAG,IAAI,KAAK;GAEpB,OAAQ,MAAM,MAAM,YAAY,SAAS,EAAE,KAAA;EAC5C;EACA,KAAK,OAAO,OAAO,UAAU;GAC5B,MAAM,QAAQ,iBAAiB,OAAO,GAAG;GACzC,IAAI,CAAC,OAAO;IACX,MAAM,GAAG,IAAI,OAAO,KAAK;IACzB;GACD;GACA,MAAM,MAAM,eAAe,SAAS,IAAI,KAAK;EAC9C;CACD;AACD;;;;;AAcA,MAAa,mBAAmB,OAC/B,SACA,QAAuB,MACvB,UAAmC,CAAC,MACjB;CACnB,MAAM,UAAU,WAAW,OAAO;CAClC,MAAM,UAAU,SAAS;CACzB,IAAI,CAAC,WAAW,CAAC,SAChB;CAED,MAAM,OAAO,MAAM,kBAAkB,SAAS,QAAQ,GAAG;CACzD,IAAI,CAAC,MAAM;EACV,MAAM,QAAQ,KAAK;EACnB;CACD;CACA,MAAM,WAAW,iBAAiB,YAAY,QAAQ,KAAK,CAAC,EAAE,OAAO,QAAiB;EACrF,QAAQ,QAAQ,KACf,iDAAiD,SAAS,GAAG,2BAA2B,OAAO,GAAG,GACnG;CACD,CAAC;CACD,QAAQ,OAAO,OAAO,QAAQ;AAC/B"}
|