@10x-media/analytics 1.0.0-beta.11 → 1.0.0-beta.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +463 -0
- package/README.md +30 -37
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +7 -9
- package/dist/adapters/ga4/disableKey.js.map +1 -1
- package/dist/adapters/ga4/eventName.d.ts +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +11 -0
- package/dist/adapters/ga4/ga4.js +206 -123
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +2 -3
- package/dist/adapters/ga4/measurementId.js.map +1 -1
- package/dist/adapters/goalRead.js +15 -29
- package/dist/adapters/goalRead.js.map +1 -1
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +13 -13
- package/dist/adapters/plausible/plausible.js +137 -122
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +20 -9
- package/dist/adapters/posthog/posthog.js +179 -113
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +7 -9
- package/dist/adapters/umami/umami.js +184 -172
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +16 -29
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +48 -95
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +100 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/charts/BarList.d.ts +27 -14
- package/dist/charts/BarList.js +38 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +15 -1
- package/dist/charts/bars.js +12 -12
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +193 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +48 -37
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +26 -25
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +258 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +104 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +285 -59
- package/dist/core/contract.js +6 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +473 -157
- package/dist/core/options.js +154 -219
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +112 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +182 -72
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +38 -20
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceOptions.js +94 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +14 -0
- package/dist/exports/adapters/ga4.d.ts +15 -1
- package/dist/exports/adapters/native.d.ts +26 -2
- package/dist/exports/adapters/native.js +4 -1
- package/dist/exports/adapters/plausible.d.ts +15 -1
- package/dist/exports/adapters/posthog.d.ts +15 -1
- package/dist/exports/adapters/umami.d.ts +15 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +41 -13
- package/dist/exports/client.js +21 -9
- package/dist/exports/geo.d.ts +3 -1
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/next.d.ts +18 -1
- package/dist/exports/next.js +3 -1
- package/dist/exports/react.d.ts +3 -2
- package/dist/exports/react.js +1 -2
- package/dist/exports/rsc.d.ts +31 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +17 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +5 -20
- package/dist/exports/tracker.js +3 -14
- package/dist/exports/types.d.ts +40 -14
- package/dist/exports/types.js +5 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +20 -8
- package/dist/fields/AnalyticsPanelField.js +121 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +18 -7
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +217 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
- package/dist/fields/config/FilterDimensionSelectField.js +26 -54
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
- package/dist/fields/config/FilterOperatorSelectField.js +37 -53
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +18 -30
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.js +14 -26
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +31 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +66 -37
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +78 -26
- package/dist/fields/readForDocument.js +446 -116
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +162 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +141 -100
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -26
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +39 -40
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +154 -46
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -27
- package/dist/goals/trackGoalAction.js +38 -52
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +63 -11
- package/dist/index.js +257 -247
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +81 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.d.ts +1 -0
- package/dist/maintenance/taskSchedule.js +62 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +102 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +29 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1623 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +198 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +108 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +4 -1
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +20 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +2 -3
- package/dist/native/ingest/bots.js +8 -13
- package/dist/native/ingest/bots.js.map +1 -1
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +30 -9
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +119 -34
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +60 -7
- package/dist/native/ingest/normalizeEvent.js +226 -61
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +10 -23
- package/dist/native/ingest/requestHost.js.map +1 -1
- package/dist/native/ingest/resolveHostname.d.ts +4 -13
- package/dist/native/ingest/resolveHostname.js +5 -6
- package/dist/native/ingest/resolveHostname.js.map +1 -1
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +82 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +181 -72
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +2 -3
- package/dist/native/ingest/source.js +35 -54
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +20 -10
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +101 -33
- package/dist/native/nativeAdapter.js +375 -317
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +116 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +63 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +430 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +695 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +95 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +384 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +345 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +48 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +656 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +9 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +68 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +4 -24
- package/dist/next/captureRewrites.js +6 -50
- package/dist/next/captureRewrites.js.map +1 -1
- package/dist/next/captureRoute.d.ts +28 -0
- package/dist/next/captureRoute.js +67 -0
- package/dist/next/captureRoute.js.map +1 -0
- package/dist/next/ingestRoute.d.ts +17 -0
- package/dist/next/ingestRoute.js +17 -0
- package/dist/next/ingestRoute.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +3 -25
- package/dist/next/posthogProxyRewrites.js +5 -37
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +336 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +76 -53
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +5 -12
- package/dist/plugin/errors.js +23 -16
- package/dist/plugin/errors.js.map +1 -1
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/jobsAccess.js +91 -0
- package/dist/plugin/jobsAccess.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +155 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +69 -44
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +52 -17
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +64 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +77 -25
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +69 -44
- package/dist/plugin/refreshEndpoint.js.map +1 -1
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +226 -30
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +63 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +6 -5
- package/dist/plugin/scopeChange.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +46 -12
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +22 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +53 -0
- package/dist/providers/collection.js +274 -150
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +76 -0
- package/dist/providers/factory.js +76 -23
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +101 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +318 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +23 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +1 -5
- package/dist/query/fetchQuery.d.ts +25 -32
- package/dist/query/fetchQuery.js +91 -91
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +6 -0
- package/dist/query/parse.js +153 -106
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +26 -17
- package/dist/react/AnalyticsProvider.js +23 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -11
- package/dist/react/useAnalytics.js +22 -24
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/site/AnalyticsScripts.d.ts +34 -0
- package/dist/site/AnalyticsScripts.js +30 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +40 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +69 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -72
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.js +70 -26
- package/dist/surfacing/epoch.js.map +1 -1
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +113 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +28 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +226 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +144 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +4 -10
- package/dist/tracker/createTracker.js +386 -115
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +2 -22
- package/dist/tracker/exclusion.js +53 -21
- package/dist/tracker/exclusion.js.map +1 -1
- package/dist/tracker/gate.js +194 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +21 -14
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +118 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +38 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +64 -20
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +7 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +27 -22
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +26 -22
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +14 -12
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +30 -27
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +86 -63
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +226 -71
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +215 -69
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +209 -67
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +217 -68
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +221 -72
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +212 -67
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +185 -14
- package/dist/translations/keys.js +190 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +214 -69
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +226 -77
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +217 -66
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +217 -66
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +212 -67
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +112 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1528 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +26 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +11 -6
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +8 -10
- package/dist/view/AnalyticsView.js +47 -18
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -229
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +150 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +66 -31
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +95 -10
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +10 -9
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +196 -134
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +118 -30
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +124 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +29 -33
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +123 -82
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +47 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +64 -7
- package/dist/view/viewProps.js +121 -35
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +80 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +129 -123
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +24 -4
- package/dist/widgets/RealtimeCounter.js +91 -77
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +12 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaults.d.ts +4 -7
- package/dist/widgets/defaults.js +4 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +73 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +5 -1
- package/dist/widgets/prepareWidgetRead.js +59 -27
- package/dist/widgets/prepareWidgetRead.js.map +1 -1
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +27 -18
- package/dist/widgets/readForWidget.js +31 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
- package/dist/widgets/readForWidgetBreakdown.js +46 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +17 -23
- package/dist/widgets/readForWidgetGoals.js +50 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
- package/dist/widgets/readForWidgetRealtime.js +51 -27
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +26 -31
- package/dist/widgets/readForWidgetSeries.js +43 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +44 -0
- package/dist/widgets/readMeta.js +47 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +53 -25
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +204 -126
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +4 -3
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +31 -24
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +44 -22
- package/dist/adapters/ga4/disableKey.d.ts +0 -9
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -165
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -39
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -175
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -69
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -106
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/plugin/paths.js +0 -29
- package/dist/plugin/paths.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -29
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -20
- package/dist/tracker/sinks/posthog.d.ts +0 -18
- package/dist/tracker/sinks/umami.d.ts +0 -18
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -76
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scopedRead.js","names":[],"sources":["../../src/core/scopedRead.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport {\n\ttype AnalyticsRuntime,\n\ttype PlatformReadGate,\n\tplatformReadGate,\n\tresolveRegistryFor,\n\tresolveScopeFor,\n} from '../plugin/runtime'\nimport { type AnalyticsAdapter, PLATFORM_SCOPE } from './contract'\n\nexport type ReadContext =\n\t| {\n\t\t\tok: true\n\t\t\tadapter: AnalyticsAdapter\n\t\t\tscope: string | null\n\t\t\t/** The scope to stamp on the adapter query; undefined for install-wide reads. */\n\t\t\tqueryScope?: string\n\t }\n\t| { ok: false }\n\nexport interface ResolveReadContextArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tadapterId?: string\n\t/** Explicit scope override; undefined resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n}\n\nexport interface QueryScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The read's resolved scope; `'*'` is the explicit cross-scope marker. */\n\tscope: string | null\n\tadapter: AnalyticsAdapter\n\t/** Shared `platformRead` decision; one is created per call when omitted. */\n\tplatformRead?: PlatformReadGate\n}\n\n/**\n * A scope a request may act on, or why it may not. `named` is a scope the caller asked for\n * and `platformRead` denies; `unresolved` is a request whose own scope is cross-scope, or\n * ambiguous on a scoped install, behind the same gate; `failed` is a `scopeResolver` that\n * threw, which callers that can serve something degraded tell apart from a refusal.\n */\nexport type RequestedScope =\n\t| { ok: true; scope: string | null }\n\t| { ok: false; reason: 'named' | 'unresolved' | 'failed' }\n\nexport interface RequestedScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The `scope` the request carried, untrimmed; null or undefined when it carried none. */\n\traw?: string | null\n\t/** Shared `platformRead` decision; one is created per call when omitted. */\n\tplatformRead?: PlatformReadGate\n}\n\n/**\n * The scope one request may act on, decided in one place for every endpoint that takes a\n * `scope` from a caller, so a read gate and a state-changing gate cannot drift apart.\n *\n * The raw value is trimmed and a blank one counts as absent, exactly as `readParam` reads a\n * query string. Naming a scope, the platform wildcard included, is the cross-scope decision\n * and requires `platformRead`. Absent means the request's own resolved scope, which is\n * itself cross-scope when the resolver answers the wildcard or, on a scoped install, null:\n * null usually means \"no tenant selected\" rather than \"everything\", so it fails closed\n * behind the same gate. A resolver that throws answers no scope either, separately, so a\n * caller with a degraded answer to give can tell it from a refusal. Per-adapter narrowing\n * is a later decision, in `resolveQueryScope`.\n */\nexport const resolveRequestedScope = async (args: RequestedScopeArgs): Promise<RequestedScope> => {\n\tconst { runtime, req } = args\n\tconst allowed = args.platformRead ?? platformReadGate(runtime, req)\n\tconst named = typeof args.raw === 'string' ? args.raw.trim() : ''\n\tif (named !== '') {\n\t\treturn (await allowed()) ? { ok: true, scope: named } : { ok: false, reason: 'named' }\n\t}\n\tlet scope: string | null\n\ttry {\n\t\tscope = await resolveScopeFor(runtime, req)\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: scope resolution failed: ${String(err)}`)\n\t\treturn { ok: false, reason: 'failed' }\n\t}\n\tconst crossScope = scope === PLATFORM_SCOPE || (runtime.scoped === true && scope === null)\n\tif (crossScope && !(await allowed())) {\n\t\treturn { ok: false, reason: 'unresolved' }\n\t}\n\treturn { ok: true, scope }\n}\n\n/**\n * The scope to stamp on one adapter query, or a refusal. Cross-scope reads fail closed\n * behind `platformRead`: the `'*'` marker, and any scoped read through a shared config\n * adapter that cannot narrow the query to one scope (whether or not it is the designated\n * platform adapter), which would otherwise answer with every scope's data. A tenant's own\n * runtime adapters are never gated. Every read path decides this here, so the widgets and\n * the query endpoint cannot drift apart on what counts as cross-scope.\n */\nexport const resolveQueryScope = async (\n\targs: QueryScopeArgs\n): Promise<{ ok: true; queryScope?: string } | { ok: false }> => {\n\tconst { runtime, req, scope, adapter } = args\n\tconst allowed = args.platformRead ?? platformReadGate(runtime, req)\n\tif (scope === PLATFORM_SCOPE) {\n\t\treturn (await allowed()) ? { ok: true } : { ok: false }\n\t}\n\tif (scope === null) {\n\t\treturn { ok: true }\n\t}\n\tif (runtime.configAdapterIds.has(adapter.id) && !adapter.capabilities.scopedQueries) {\n\t\treturn (await allowed()) ? { ok: true } : { ok: false }\n\t}\n\treturn { ok: true, queryScope: scope }\n}\n\n/**\n * Resolve one read's scope and adapter: explicit scope wins over the request's\n * resolved scope, the registry is resolved per scope, then the adapter is picked\n * by id (or the registry default). A request's own scope goes through\n * `resolveRequestedScope`, the same decision every endpoint that takes a scope\n * reads with, so the widgets cannot drift from them on what a scope may be.\n * Cross-scope reads fail closed behind `platformRead`: an explicit `'*'` scope\n * always, any scoped read through a shared config adapter that cannot narrow the\n * query to one scope (whether or not it is the designated platform adapter), and,\n * on a scoped install, a request that resolves no scope at all. That last case is\n * ambiguous rather than intentionally install-wide (a tenant's scopeResolver\n * returning null usually means \"no tenant selected\", not \"read everything\"), so it\n * fails closed the same way. An explicit `scope: null` override bypasses that gate:\n * it is the trusted server-side caller's path (cron passes, tests), never a\n * request's own resolution. A tenant's own runtime adapters are never gated.\n * Any resolution failure (unknown adapter id, a throwing scopeResolver or\n * provider lookup) degrades to `{ ok: false }` so read paths render their\n * unavailable state instead of throwing.\n */\nexport const resolveReadContext = async (args: ResolveReadContextArgs): Promise<ReadContext> => {\n\tconst { runtime, req, adapterId } = args\n\tconst allowed = platformReadGate(runtime, req)\n\ttry {\n\t\tlet scope: string | null\n\t\tif (args.scope !== undefined) {\n\t\t\tscope = args.scope\n\t\t} else {\n\t\t\tconst requested = await resolveRequestedScope({ runtime, req, platformRead: allowed })\n\t\t\tif (!requested.ok) {\n\t\t\t\treturn { ok: false }\n\t\t\t}\n\t\t\tscope = requested.scope\n\t\t}\n\t\tconst registryScope = scope === PLATFORM_SCOPE ? null : scope\n\t\tconst registry = await resolveRegistryFor(runtime, {\n\t\t\tpayload: req.payload,\n\t\t\treq,\n\t\t\tscope: registryScope,\n\t\t})\n\t\tconst adapter = adapterId ? registry.get(adapterId) : registry.default()\n\t\tconst decision = await resolveQueryScope({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tscope,\n\t\t\tadapter,\n\t\t\tplatformRead: allowed,\n\t\t})\n\t\tif (!decision.ok) {\n\t\t\treturn { ok: false }\n\t\t}\n\t\treturn { ok: true, adapter, scope: registryScope, queryScope: decision.queryScope }\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: read context resolution failed: ${String(err)}`)\n\t\treturn { ok: false }\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAsEA,MAAa,wBAAwB,OAAO,SAAsD;CACjG,MAAM,EAAE,SAAS,QAAQ;CACzB,MAAM,UAAU,KAAK,gBAAgB,iBAAiB,SAAS,GAAG;CAClE,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW,KAAK,IAAI,KAAK,IAAI;CAC/D,IAAI,UAAU,IACb,OAAQ,MAAM,QAAQ,IAAK;EAAE,IAAI;EAAM,OAAO;CAAM,IAAI;EAAE,IAAI;EAAO,QAAQ;CAAQ;CAEtF,IAAI;CACJ,IAAI;EACH,QAAQ,MAAM,gBAAgB,SAAS,GAAG;CAC3C,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,uCAAuC,OAAO,GAAG,GAAG;EAC7E,OAAO;GAAE,IAAI;GAAO,QAAQ;EAAS;CACtC;CAEA,KADmB,UAAA,OAA6B,QAAQ,WAAW,QAAQ,UAAU,SACnE,CAAE,MAAM,QAAQ,GACjC,OAAO;EAAE,IAAI;EAAO,QAAQ;CAAa;CAE1C,OAAO;EAAE,IAAI;EAAM;CAAM;AAC1B;;;;;;;;;AAUA,MAAa,oBAAoB,OAChC,SACgE;CAChE,MAAM,EAAE,SAAS,KAAK,OAAO,YAAY;CACzC,MAAM,UAAU,KAAK,gBAAgB,iBAAiB,SAAS,GAAG;CAClE,IAAI,UAAA,KACH,OAAQ,MAAM,QAAQ,IAAK,EAAE,IAAI,KAAK,IAAI,EAAE,IAAI,MAAM;CAEvD,IAAI,UAAU,MACb,OAAO,EAAE,IAAI,KAAK;CAEnB,IAAI,QAAQ,iBAAiB,IAAI,QAAQ,EAAE,KAAK,CAAC,QAAQ,aAAa,eACrE,OAAQ,MAAM,QAAQ,IAAK,EAAE,IAAI,KAAK,IAAI,EAAE,IAAI,MAAM;CAEvD,OAAO;EAAE,IAAI;EAAM,YAAY;CAAM;AACtC;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,qBAAqB,OAAO,SAAuD;CAC/F,MAAM,EAAE,SAAS,KAAK,cAAc;CACpC,MAAM,UAAU,iBAAiB,SAAS,GAAG;CAC7C,IAAI;EACH,IAAI;EACJ,IAAI,KAAK,UAAU,KAAA,GAClB,QAAQ,KAAK;OACP;GACN,MAAM,YAAY,MAAM,sBAAsB;IAAE;IAAS;IAAK,cAAc;GAAQ,CAAC;GACrF,IAAI,CAAC,UAAU,IACd,OAAO,EAAE,IAAI,MAAM;GAEpB,QAAQ,UAAU;EACnB;EACA,MAAM,gBAAgB,UAAA,MAA2B,OAAO;EACxD,MAAM,WAAW,MAAM,mBAAmB,SAAS;GAClD,SAAS,IAAI;GACb;GACA,OAAO;EACR,CAAC;EACD,MAAM,UAAU,YAAY,SAAS,IAAI,SAAS,IAAI,SAAS,QAAQ;EACvE,MAAM,WAAW,MAAM,kBAAkB;GACxC;GACA;GACA;GACA;GACA,cAAc;EACf,CAAC;EACD,IAAI,CAAC,SAAS,IACb,OAAO,EAAE,IAAI,MAAM;EAEpB,OAAO;GAAE,IAAI;GAAM;GAAS,OAAO;GAAe,YAAY,SAAS;EAAW;CACnF,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,8CAA8C,OAAO,GAAG,GAAG;EACpF,OAAO,EAAE,IAAI,MAAM;CACpB;AACD"}
|
|
1
|
+
{"version":3,"file":"scopedRead.js","names":[],"sources":["../../src/core/scopedRead.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { isScopeMember } from '../access/membership'\nimport {\n\ttype GatedScope,\n\tisGatedScope,\n\tmintGatedScope,\n\ttype ReadPrincipal,\n\tSYSTEM,\n} from '../access/principal'\nimport { readGate } from '../access/readGate'\nimport { readableProviderDocIds } from '../plugin/readableProviders'\nimport {\n\ttype AnalyticsRuntime,\n\tresolvableScope,\n\tresolveRegistryFor,\n\tresolveScopeFor,\n\ttype ScopeGates,\n\tscopeGates,\n} from '../plugin/runtime'\nimport { MAX_SCOPE_LENGTH } from '../query/limits'\nimport { type AnalyticsAdapter, PLATFORM_SCOPE } from './contract'\nimport { type AdapterRegistry, filterRegistry, type ScopeRegistry } from './registry'\n\nexport type ReadContext =\n\t| {\n\t\t\tok: true\n\t\t\tadapter: AnalyticsAdapter\n\t\t\tscope: string | null\n\t\t\t/** The scope to stamp on the adapter query; undefined for install-wide reads. */\n\t\t\tqueryScope?: string\n\t\t\t/**\n\t\t\t * The read's principal and scope, for the reads it makes on its behalf: handing this on\n\t\t\t * keeps every one of them on exactly this scope without deciding it again.\n\t\t\t */\n\t\t\tpin: ReadPrincipal\n\t }\n\t| {\n\t\t\tok: false\n\t\t\t/**\n\t\t\t * Why the read was refused: `no-sources` (nothing this reader may read), `no-access`,\n\t\t\t * `not-member`, or `no-scope` (no single scope resolved, no cross-scope read).\n\t\t\t */\n\t\t\treason?: 'no-sources' | 'no-access' | 'not-member' | 'no-scope'\n\t }\n\ntype ResolveReadContextArgs = {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tadapterId?: string\n\t/**\n\t * Without an `adapterId`, the source to read through is the scope's default when this accepts\n\t * it, else the first visible source it accepts, else the default all the same.\n\t */\n\tprefer?: (adapter: AnalyticsAdapter) => boolean\n} & ReadPrincipal\n\ninterface QueryScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The read's resolved scope; `'*'` is the explicit cross-scope marker. */\n\tscope: string | null\n\tadapter: AnalyticsAdapter\n\t/** Shared cross-scope decisions; one set is created per call when omitted. */\n\tgates?: ScopeGates\n}\n\n/**\n * A scope a request may act on, or why not: `named` and `unresolved` are denied cross-scope gates,\n * `failed` a throwing `scope.resolve`, `not-member` a scope its user does not belong to.\n */\nexport type RequestedScope =\n\t| {\n\t\t\tok: true\n\t\t\tscope: string | null\n\t\t\t/** The same scope as a token the reads below accept without deciding it again. */\n\t\t\tgated: GatedScope\n\t }\n\t| { ok: false; reason: 'named' | 'unresolved' | 'failed' | 'not-member' }\n\ninterface RequestedScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The `scope` the request carried, untrimmed; null or undefined when it carried none. */\n\traw?: string | null\n\t/** Shared cross-scope decisions; one set is created per call when omitted. */\n\tgates?: ScopeGates\n}\n\nconst cleared = (scope: string | null): RequestedScope => ({\n\tok: true,\n\tscope,\n\tgated: mintGatedScope(scope),\n})\n\n/**\n * The scope one request may act on, for every endpoint taking a caller's `scope`, and the only\n * place a {@link GatedScope} is minted. A scoped install's null, no tenant selected, fails closed.\n */\nexport const resolveRequestedScope = async (args: RequestedScopeArgs): Promise<RequestedScope> => {\n\tconst { runtime, req } = args\n\tconst gates = args.gates ?? scopeGates(runtime, req)\n\tconst named = typeof args.raw === 'string' ? args.raw.trim() : ''\n\tif (named !== '') {\n\t\t// The wildcard is never the request's own scope in this sense: it names every scope,\n\t\t// whatever the resolver answered, and stays behind the aggregate gate.\n\t\tif (named === PLATFORM_SCOPE) {\n\t\t\treturn (await gates.aggregate()) ? cleared(named) : { ok: false, reason: 'named' }\n\t\t}\n\t\t// An install without tenants has no scope to name, and no tenant id runs this long.\n\t\tif (runtime.scoped !== true || named.length > MAX_SCOPE_LENGTH) {\n\t\t\treturn { ok: false, reason: 'named' }\n\t\t}\n\t\tif (await gates.named()) {\n\t\t\treturn cleared(named)\n\t\t}\n\t\t// Only after the gate has said no, so a platform reader still costs one resolution.\n\t\tconst own = await resolveScopeFor(runtime, req).catch(() => null)\n\t\tif (own === null || own === PLATFORM_SCOPE || own !== named) {\n\t\t\treturn { ok: false, reason: 'named' }\n\t\t}\n\t\treturn (await isScopeMember(runtime.member, req, own))\n\t\t\t? cleared(own)\n\t\t\t: { ok: false, reason: 'not-member' }\n\t}\n\tlet scope: string | null\n\ttry {\n\t\tscope = await resolveScopeFor(runtime, req)\n\t} catch {\n\t\treturn { ok: false, reason: 'failed' }\n\t}\n\tif (scope === PLATFORM_SCOPE || scope === null) {\n\t\tconst crossScope = scope === PLATFORM_SCOPE || runtime.scoped === true\n\t\treturn crossScope && !(await gates.aggregate())\n\t\t\t? { ok: false, reason: 'unresolved' }\n\t\t\t: cleared(scope)\n\t}\n\tif ((await isScopeMember(runtime.member, req, scope)) || (await gates.named())) {\n\t\treturn cleared(scope)\n\t}\n\treturn { ok: false, reason: 'not-member' }\n}\n\n/**\n * True for a shared config adapter that cannot narrow its query, read under a tenant scope: it\n * would answer with every scope's data, so reading or listing it takes `unscopedSource`.\n */\nexport const needsUnscopedSourceAccess = (\n\truntime: AnalyticsRuntime,\n\tadapter: AnalyticsAdapter,\n\tscope: string | null\n): boolean =>\n\tscope !== null &&\n\tscope !== PLATFORM_SCOPE &&\n\truntime.configAdapterIds.has(adapter.id) &&\n\t!adapter.capabilities.scopedQueries\n\n/**\n * {@link SYSTEM} reads any scope, but never a tenant through a shared adapter that cannot narrow\n * to it: a job would store that adapter's install-wide numbers as the tenant's own.\n */\nconst SYSTEM_GATES: ScopeGates = {\n\tnamed: () => Promise.resolve(true),\n\taggregate: () => Promise.resolve(true),\n\tunscopedSource: () => Promise.resolve(false),\n}\n\n/**\n * The adapters a request may read through in one tenant scope, or null for none: the scope's own\n * sources follow the providers' read access (`sourceAccess`), a config adapter `unscopedSource`.\n */\nexport const visibleRegistryFor = async (args: {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tresolved: ScopeRegistry\n\tscope: string | null\n\tgates?: ScopeGates\n\tprincipal?: typeof SYSTEM\n}): Promise<AdapterRegistry | null> => {\n\tconst { runtime, req, resolved, scope } = args\n\tconst { registry, grants } = resolved\n\tif (runtime.scoped !== true || scope === null || scope === PLATFORM_SCOPE) {\n\t\treturn registry\n\t}\n\tif (args.principal === SYSTEM) {\n\t\treturn filterRegistry(\n\t\t\tregistry,\n\t\t\t(adapter) => grants.has(adapter.id) || !needsUnscopedSourceAccess(runtime, adapter, scope)\n\t\t)\n\t}\n\tconst gates = args.gates ?? scopeGates(runtime, req)\n\tconst readable = await readableProviderDocIds(runtime, req, scope)\n\tconst keep = new Set<string>()\n\tfor (const adapter of registry.all()) {\n\t\tconst docId = grants.get(adapter.id)\n\t\tif (docId !== undefined) {\n\t\t\tif (readable === null || readable.has(docId)) {\n\t\t\t\tkeep.add(adapter.id)\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\tif (!runtime.providersCollection && adapter.capabilities.scopedQueries) {\n\t\t\tkeep.add(adapter.id)\n\t\t\tcontinue\n\t\t}\n\t\tif (await gates.unscopedSource()) {\n\t\t\tkeep.add(adapter.id)\n\t\t}\n\t}\n\treturn filterRegistry(registry, (adapter) => keep.has(adapter.id))\n}\n\n/**\n * The sources a job reads one scope through as {@link SYSTEM}, or null when the scope holds\n * none: exactly what `resolveReadContext` lets a system read choose from.\n */\nexport const systemRegistryFor = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope: string | null\n): Promise<AdapterRegistry | null> => {\n\tconst resolved = await resolveRegistryFor(runtime, {\n\t\tpayload: req.payload,\n\t\treq,\n\t\tscope: resolvableScope(scope),\n\t})\n\treturn visibleRegistryFor({ runtime, req, resolved, scope, principal: SYSTEM })\n}\n\n/**\n * The scope to stamp on one adapter query, or a refusal. Every read path decides it here, so\n * widgets and the query endpoint cannot drift on what counts as cross-scope.\n */\nexport const resolveQueryScope = async (\n\targs: QueryScopeArgs\n): Promise<{ ok: true; queryScope?: string } | { ok: false }> => {\n\tconst { runtime, req, scope, adapter } = args\n\tconst gates = args.gates ?? scopeGates(runtime, req)\n\tif (scope === PLATFORM_SCOPE) {\n\t\treturn (await gates.aggregate()) ? { ok: true } : { ok: false }\n\t}\n\tif (scope === null) {\n\t\treturn { ok: true }\n\t}\n\tif (needsUnscopedSourceAccess(runtime, adapter, scope)) {\n\t\treturn (await gates.unscopedSource()) ? { ok: true } : { ok: false }\n\t}\n\treturn { ok: true, queryScope: scope }\n}\n\ntype PrincipalScope =\n\t| { ok: true; scope: string | null; pin: ReadPrincipal }\n\t| Extract<ReadContext, { ok: false }>\n\n/**\n * The read's scope: the system's own, one already cleared, or the one the request asks for. Checked\n * at runtime, since a JavaScript caller or a cast can pass anything; anything else is refused.\n */\nconst principalScope = async (\n\targs: ResolveReadContextArgs,\n\tgates: ScopeGates\n): Promise<PrincipalScope> => {\n\tconst { scope } = args\n\tif (args.principal === SYSTEM) {\n\t\treturn typeof scope === 'string' || scope === null\n\t\t\t? { ok: true, scope, pin: { principal: SYSTEM, scope } }\n\t\t\t: { ok: false }\n\t}\n\tif (isGatedScope(scope)) {\n\t\treturn { ok: true, scope: scope.value, pin: { scope } }\n\t}\n\tif (scope !== undefined && scope !== null && typeof scope !== 'string') {\n\t\treturn { ok: false }\n\t}\n\tconst requested = await resolveRequestedScope({\n\t\truntime: args.runtime,\n\t\treq: args.req,\n\t\tgates,\n\t\traw: scope,\n\t})\n\tif (!requested.ok) {\n\t\tswitch (requested.reason) {\n\t\t\tcase 'not-member':\n\t\t\t\treturn { ok: false, reason: 'not-member' }\n\t\t\tcase 'named':\n\t\t\t\treturn { ok: false, reason: 'no-access' }\n\t\t\tcase 'unresolved':\n\t\t\t\treturn { ok: false, reason: 'no-scope' }\n\t\t\tcase 'failed':\n\t\t\t\treturn { ok: false }\n\t\t}\n\t}\n\treturn { ok: true, scope: requested.scope, pin: { scope: requested.gated } }\n}\n\n/**\n * One read's scope and adapter, behind `access.read` and `resolveRequestedScope` unless the\n * principal is {@link SYSTEM}. Any failure answers `{ ok: false }`, so a surface never throws.\n */\nexport const resolveReadContext = async (args: ResolveReadContextArgs): Promise<ReadContext> => {\n\tconst { runtime, req, adapterId } = args\n\tconst system = args.principal === SYSTEM\n\tconst gates = system ? SYSTEM_GATES : scopeGates(runtime, req)\n\ttry {\n\t\tif (!system && !(await readGate(runtime, req))) {\n\t\t\treturn { ok: false, reason: 'no-access' }\n\t\t}\n\t\tconst decided = await principalScope(args, gates)\n\t\tif (!decided.ok) {\n\t\t\treturn decided\n\t\t}\n\t\tconst { scope, pin } = decided\n\t\tconst registryScope = resolvableScope(scope)\n\t\tconst resolved = await resolveRegistryFor(runtime, {\n\t\t\tpayload: req.payload,\n\t\t\treq,\n\t\t\tscope: registryScope,\n\t\t})\n\t\t// The default is picked out of what this reader may actually read, so a scope whose\n\t\t// leading source is the platform's own shared one still serves a tenant admin.\n\t\tconst registry = await visibleRegistryFor({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tresolved,\n\t\t\tscope,\n\t\t\tgates,\n\t\t\t...(system ? { principal: SYSTEM } : {}),\n\t\t})\n\t\tif (!registry) {\n\t\t\treturn { ok: false, reason: 'no-sources' }\n\t\t}\n\t\tconst fallback = registry.default()\n\t\tconst preferred =\n\t\t\targs.prefer && !args.prefer(fallback) ? registry.all().find(args.prefer) : undefined\n\t\tconst adapter = adapterId ? registry.get(adapterId) : (preferred ?? fallback)\n\t\tconst decision = await resolveQueryScope({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tscope,\n\t\t\tadapter,\n\t\t\tgates,\n\t\t})\n\t\tif (!decision.ok) {\n\t\t\treturn { ok: false }\n\t\t}\n\t\treturn { ok: true, adapter, scope: registryScope, queryScope: decision.queryScope, pin }\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: read context resolution failed: ${String(err)}`)\n\t\treturn { ok: false }\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
//#region src/core/sdks.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* What the GA4 adapter hands the Data API client it builds. A type alias rather than an
|
|
4
|
+
* interface: the SDK's `ClientOptions` carries an index signature, which an interface never meets.
|
|
5
|
+
*/
|
|
6
|
+
type Ga4ClientOptions = {
|
|
7
|
+
credentials: {
|
|
8
|
+
client_email: string;
|
|
9
|
+
private_key: string;
|
|
10
|
+
};
|
|
11
|
+
projectId?: string;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* One row of a GA4 report, as far as the adapter reads it.
|
|
15
|
+
*
|
|
16
|
+
* @beta
|
|
17
|
+
*/
|
|
18
|
+
interface Ga4ReportRow {
|
|
19
|
+
dimensionValues?: Array<{
|
|
20
|
+
value?: string | null;
|
|
21
|
+
}> | null;
|
|
22
|
+
metricValues?: Array<{
|
|
23
|
+
value?: string | null;
|
|
24
|
+
}> | null;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* A GA4 report as far as the adapter reads it, written out so no SDK type is needed.
|
|
28
|
+
*
|
|
29
|
+
* @beta
|
|
30
|
+
*/
|
|
31
|
+
interface Ga4ReportResponse {
|
|
32
|
+
rows?: Ga4ReportRow[] | null;
|
|
33
|
+
totals?: Ga4ReportRow[] | null;
|
|
34
|
+
metadata?: {
|
|
35
|
+
samplingMetadatas?: unknown[] | null;
|
|
36
|
+
currencyCode?: string | null;
|
|
37
|
+
} | null;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* The Data API client the GA4 adapter calls: the SDK's `BetaAnalyticsDataClient` is one.
|
|
41
|
+
*
|
|
42
|
+
* @beta
|
|
43
|
+
*/
|
|
44
|
+
interface Ga4Client {
|
|
45
|
+
runReport(request: object, options?: {
|
|
46
|
+
timeout?: number;
|
|
47
|
+
retry?: null;
|
|
48
|
+
}): Promise<[Ga4ReportResponse, ...unknown[]]>;
|
|
49
|
+
close?(): Promise<void>;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* The part of `@google-analytics/data` the GA4 adapter uses: pass the package's own class,
|
|
53
|
+
* `{ BetaAnalyticsDataClient }`. Written structurally, so an install without the package compiles.
|
|
54
|
+
*/
|
|
55
|
+
interface Ga4Sdk {
|
|
56
|
+
BetaAnalyticsDataClient: new (options: Ga4ClientOptions) => Ga4Client;
|
|
57
|
+
}
|
|
58
|
+
/** An open MaxMind database: what it answers for one address is read field by field. */
|
|
59
|
+
interface MaxmindReader {
|
|
60
|
+
get(address: string): unknown;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* The part of `maxmind` the geo resolver uses: pass the package's own `{ open }`. Written
|
|
64
|
+
* structurally, so an install without the package compiles.
|
|
65
|
+
*/
|
|
66
|
+
interface MaxmindSdk {
|
|
67
|
+
open(database: string): Promise<MaxmindReader>;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Optional packages handed to the plugin rather than loaded by it: a runtime-loaded package escapes
|
|
71
|
+
* a standalone or serverless build's file tracing.
|
|
72
|
+
*/
|
|
73
|
+
interface AnalyticsSdks {
|
|
74
|
+
/** `{ BetaAnalyticsDataClient }` from `@google-analytics/data`, for every GA4 source. */
|
|
75
|
+
ga4?: Ga4Sdk;
|
|
76
|
+
/** `{ open }` from `maxmind`, for the native engine's MaxMind geo lookups. */
|
|
77
|
+
maxmind?: MaxmindSdk;
|
|
78
|
+
}
|
|
79
|
+
//#endregion
|
|
80
|
+
export { AnalyticsSdks, Ga4Client, Ga4ClientOptions, Ga4ReportResponse, Ga4ReportRow, Ga4Sdk, MaxmindReader, MaxmindSdk };
|
|
81
|
+
//# sourceMappingURL=sdks.d.ts.map
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { hasMethods, isRecord, onlyKeys } from "./values.js";
|
|
2
|
+
//#region src/core/sdks.ts
|
|
3
|
+
/** `{ BetaAnalyticsDataClient }` as `sdks.ga4` and `ga4({ sdk })` take it. */
|
|
4
|
+
const isGa4Sdk = (value) => hasMethods(value, ["BetaAnalyticsDataClient"]);
|
|
5
|
+
/** `{ open }` as `sdks.maxmind` and `maxmindResolver({ sdk })` take it. */
|
|
6
|
+
const isMaxmindSdk = (value) => hasMethods(value, ["open"]);
|
|
7
|
+
/** `sdks`, checked at boot: a wrong shape would otherwise fail the first read instead. */
|
|
8
|
+
const resolveSdks = (option) => {
|
|
9
|
+
if (option === void 0) return {};
|
|
10
|
+
if (!isRecord(option) || Array.isArray(option)) throw new Error("analytics: sdks must be an object such as { ga4: { BetaAnalyticsDataClient } }");
|
|
11
|
+
onlyKeys(option, ["ga4", "maxmind"], "sdks");
|
|
12
|
+
const { ga4, maxmind } = option;
|
|
13
|
+
if (ga4 !== void 0 && !isGa4Sdk(ga4)) throw new Error("analytics: sdks.ga4 must be { BetaAnalyticsDataClient }, imported from '@google-analytics/data'");
|
|
14
|
+
if (maxmind !== void 0 && !isMaxmindSdk(maxmind)) throw new Error("analytics: sdks.maxmind must be { open }, imported from 'maxmind'");
|
|
15
|
+
return {
|
|
16
|
+
...ga4 === void 0 ? {} : { ga4 },
|
|
17
|
+
...maxmind === void 0 ? {} : { maxmind }
|
|
18
|
+
};
|
|
19
|
+
};
|
|
20
|
+
//#endregion
|
|
21
|
+
export { isGa4Sdk, isMaxmindSdk, resolveSdks };
|
|
22
|
+
|
|
23
|
+
//# sourceMappingURL=sdks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sdks.js","names":[],"sources":["../../src/core/sdks.ts"],"sourcesContent":["import { hasMethods, isRecord, onlyKeys } from './values'\n\n/**\n * What the GA4 adapter hands the Data API client it builds. A type alias rather than an\n * interface: the SDK's `ClientOptions` carries an index signature, which an interface never meets.\n */\nexport type Ga4ClientOptions = {\n\tcredentials: { client_email: string; private_key: string }\n\tprojectId?: string\n}\n\n/**\n * One row of a GA4 report, as far as the adapter reads it.\n *\n * @beta\n */\nexport interface Ga4ReportRow {\n\tdimensionValues?: Array<{ value?: string | null }> | null\n\tmetricValues?: Array<{ value?: string | null }> | null\n}\n\n/**\n * A GA4 report as far as the adapter reads it, written out so no SDK type is needed.\n *\n * @beta\n */\nexport interface Ga4ReportResponse {\n\trows?: Ga4ReportRow[] | null\n\ttotals?: Ga4ReportRow[] | null\n\tmetadata?: {\n\t\tsamplingMetadatas?: unknown[] | null\n\t\tcurrencyCode?: string | null\n\t} | null\n}\n\n/**\n * The Data API client the GA4 adapter calls: the SDK's `BetaAnalyticsDataClient` is one.\n *\n * @beta\n */\nexport interface Ga4Client {\n\trunReport(\n\t\trequest: object,\n\t\toptions?: { timeout?: number; retry?: null }\n\t): Promise<[Ga4ReportResponse, ...unknown[]]>\n\tclose?(): Promise<void>\n}\n\n/**\n * The part of `@google-analytics/data` the GA4 adapter uses: pass the package's own class,\n * `{ BetaAnalyticsDataClient }`. Written structurally, so an install without the package compiles.\n */\nexport interface Ga4Sdk {\n\tBetaAnalyticsDataClient: new (options: Ga4ClientOptions) => Ga4Client\n}\n\n/** An open MaxMind database: what it answers for one address is read field by field. */\nexport interface MaxmindReader {\n\tget(address: string): unknown\n}\n\n/**\n * The part of `maxmind` the geo resolver uses: pass the package's own `{ open }`. Written\n * structurally, so an install without the package compiles.\n */\nexport interface MaxmindSdk {\n\topen(database: string): Promise<MaxmindReader>\n}\n\n/**\n * Optional packages handed to the plugin rather than loaded by it: a runtime-loaded package escapes\n * a standalone or serverless build's file tracing.\n */\nexport interface AnalyticsSdks {\n\t/** `{ BetaAnalyticsDataClient }` from `@google-analytics/data`, for every GA4 source. */\n\tga4?: Ga4Sdk\n\t/** `{ open }` from `maxmind`, for the native engine's MaxMind geo lookups. */\n\tmaxmind?: MaxmindSdk\n}\n\n/** `{ BetaAnalyticsDataClient }` as `sdks.ga4` and `ga4({ sdk })` take it. */\nexport const isGa4Sdk = (value: unknown): value is Ga4Sdk =>\n\thasMethods(value, ['BetaAnalyticsDataClient'])\n\n/** `{ open }` as `sdks.maxmind` and `maxmindResolver({ sdk })` take it. */\nexport const isMaxmindSdk = (value: unknown): value is MaxmindSdk => hasMethods(value, ['open'])\n\n/** `sdks`, checked at boot: a wrong shape would otherwise fail the first read instead. */\nexport const resolveSdks = (option: unknown): AnalyticsSdks => {\n\tif (option === undefined) {\n\t\treturn {}\n\t}\n\tif (!isRecord(option) || Array.isArray(option)) {\n\t\tthrow new Error(\n\t\t\t'analytics: sdks must be an object such as { ga4: { BetaAnalyticsDataClient } }'\n\t\t)\n\t}\n\tonlyKeys(option, ['ga4', 'maxmind'], 'sdks')\n\tconst { ga4, maxmind } = option\n\tif (ga4 !== undefined && !isGa4Sdk(ga4)) {\n\t\tthrow new Error(\n\t\t\t\"analytics: sdks.ga4 must be { BetaAnalyticsDataClient }, imported from '@google-analytics/data'\"\n\t\t)\n\t}\n\tif (maxmind !== undefined && !isMaxmindSdk(maxmind)) {\n\t\tthrow new Error(\"analytics: sdks.maxmind must be { open }, imported from 'maxmind'\")\n\t}\n\treturn { ...(ga4 === undefined ? {} : { ga4 }), ...(maxmind === undefined ? {} : { maxmind }) }\n}\n"],"mappings":";;;AAiFA,MAAa,YAAY,UACxB,WAAW,OAAO,CAAC,yBAAyB,CAAC;;AAG9C,MAAa,gBAAgB,UAAwC,WAAW,OAAO,CAAC,MAAM,CAAC;;AAG/F,MAAa,eAAe,WAAmC;CAC9D,IAAI,WAAW,KAAA,GACd,OAAO,CAAC;CAET,IAAI,CAAC,SAAS,MAAM,KAAK,MAAM,QAAQ,MAAM,GAC5C,MAAM,IAAI,MACT,gFACD;CAED,SAAS,QAAQ,CAAC,OAAO,SAAS,GAAG,MAAM;CAC3C,MAAM,EAAE,KAAK,YAAY;CACzB,IAAI,QAAQ,KAAA,KAAa,CAAC,SAAS,GAAG,GACrC,MAAM,IAAI,MACT,iGACD;CAED,IAAI,YAAY,KAAA,KAAa,CAAC,aAAa,OAAO,GACjD,MAAM,IAAI,MAAM,mEAAmE;CAEpF,OAAO;EAAE,GAAI,QAAQ,KAAA,IAAY,CAAC,IAAI,EAAE,IAAI;EAAI,GAAI,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ;CAAG;AAC/F"}
|
|
@@ -1,24 +1,22 @@
|
|
|
1
|
+
import { HitType } from "../native/store/types.js";
|
|
1
2
|
import { RawEventInput } from "../native/ingest/normalizeEvent.js";
|
|
2
|
-
import { PayloadRequest } from "payload";
|
|
3
|
+
import { Payload, PayloadRequest } from "payload";
|
|
3
4
|
|
|
4
5
|
//#region src/core/serverEvent.d.ts
|
|
5
6
|
/**
|
|
6
|
-
* One event recorded from server code.
|
|
7
|
-
*
|
|
8
|
-
* knows that a browser request would otherwise have said for itself.
|
|
7
|
+
* One event recorded from server code. Browser fields mean what they mean on the wire and pass the
|
|
8
|
+
* same sanitizers; the rest stand in for what a request would carry.
|
|
9
9
|
*/
|
|
10
|
-
type ServerEventInput = Pick<RawEventInput, '
|
|
10
|
+
type ServerEventInput = Pick<RawEventInput, 'name' | 'path' | 'referrer' | 'query' | 'props' | 'value' | 'currency' | 'items' | 'revenue' | 'orderId' | 'refundId' | 'item'> & {
|
|
11
|
+
/** Time on a page is measured in the browser, so a server event is never an engagement. */type: Exclude<HitType, 'engagement'>;
|
|
11
12
|
/**
|
|
12
13
|
* The site the event belongs to. Required, and stored as given: there is no request behind
|
|
13
14
|
* a server event to attribute it to, so the caller owns the value.
|
|
14
15
|
*/
|
|
15
16
|
hostname: string;
|
|
16
17
|
/**
|
|
17
|
-
* Attribution inputs
|
|
18
|
-
*
|
|
19
|
-
* reports no device, browser, OS or language: those are read off the request's headers,
|
|
20
|
-
* and inventing them would put a fabricated visitor in every breakdown. No IP is ever
|
|
21
|
-
* fabricated either.
|
|
18
|
+
* Attribution inputs overlaid on `opts.req`'s headers, ignored under `identity: 'none'`. Without
|
|
19
|
+
* either the event has no visitor, device, browser, OS or language; none is fabricated.
|
|
22
20
|
*/
|
|
23
21
|
ip?: string;
|
|
24
22
|
userAgent?: string;
|
|
@@ -26,25 +24,45 @@ type ServerEventInput = Pick<RawEventInput, 'type' | 'name' | 'path' | 'referrer
|
|
|
26
24
|
* Analytics boundary to stamp; null is install-wide. Unset resolves from `opts.req`.
|
|
27
25
|
* Ignored on an unscoped install, and never validated against the scopes that exist.
|
|
28
26
|
*/
|
|
29
|
-
scope?: string | null;
|
|
30
|
-
|
|
27
|
+
scope?: string | null;
|
|
28
|
+
/**
|
|
29
|
+
* The IANA timezone whose local day picks the salt the visitor is hashed with, for a call that
|
|
30
|
+
* has no request to resolve the scope's own from. The day the event is counted on is its scope's.
|
|
31
|
+
*/
|
|
32
|
+
timezone?: string;
|
|
33
|
+
/**
|
|
34
|
+
* Event time, default now. A time past native's `retention.rawDays` or more than five minutes
|
|
35
|
+
* ahead of the server clock is refused with an `AnalyticsTrackError`.
|
|
36
|
+
*/
|
|
31
37
|
now?: Date;
|
|
32
38
|
};
|
|
39
|
+
/**
|
|
40
|
+
* Whose event a server call records. `'request'` attributes it to the visitor behind `req` (or
|
|
41
|
+
* `ip` and `userAgent`); `'none'` to no visitor, reading no address, agent, language or location.
|
|
42
|
+
*/
|
|
43
|
+
type ServerTrackIdentity = 'request' | 'none';
|
|
33
44
|
interface ServerTrackOptions {
|
|
34
45
|
/** The request the event belongs to: attribution, scope and timezone all come from it. */
|
|
35
46
|
req?: PayloadRequest;
|
|
36
47
|
/**
|
|
37
|
-
*
|
|
38
|
-
*
|
|
48
|
+
* `'none'` records the event as no visitor's while `req` still supplies scope, timezone and
|
|
49
|
+
* goals. Default `'none'` while `capture.gate` holds the native slot, else `'request'`.
|
|
50
|
+
*/
|
|
51
|
+
identity?: ServerTrackIdentity;
|
|
52
|
+
/**
|
|
53
|
+
* Wait for the write to land rather than resolving once queued. On SQLite, a call inside a
|
|
54
|
+
* transaction `req` holds open still resolves at once and stores on commit.
|
|
39
55
|
*/
|
|
40
56
|
flush?: boolean;
|
|
41
57
|
}
|
|
42
|
-
type ServerTrack = (event: ServerEventInput, opts?: ServerTrackOptions) => Promise<void>;
|
|
43
58
|
/**
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
|
|
47
|
-
|
|
59
|
+
* An adapter's server-side ingestion. It is handed the Payload instance to write through, so it
|
|
60
|
+
* works on any instance that runs the plugin, a jobs worker booted without `onInit` included.
|
|
61
|
+
*/
|
|
62
|
+
type ServerTrack = (payload: Payload, event: ServerEventInput, opts?: ServerTrackOptions) => Promise<void>;
|
|
63
|
+
/**
|
|
64
|
+
* Applies an adapter's hostname policy to a request, null when it refuses the host, so server code
|
|
65
|
+
* standing in for a browser event never trusts a forgeable `Host`.
|
|
48
66
|
*/
|
|
49
67
|
type IngestHostnameResolver = (args: {
|
|
50
68
|
req: PayloadRequest; /** What the caller believes the host is, never trusted on its own. */
|
|
@@ -56,5 +74,5 @@ declare class AnalyticsTrackError extends Error {
|
|
|
56
74
|
constructor(message: string);
|
|
57
75
|
}
|
|
58
76
|
//#endregion
|
|
59
|
-
export { AnalyticsTrackError, IngestHostnameResolver, ServerEventInput, ServerTrack, ServerTrackOptions };
|
|
77
|
+
export { AnalyticsTrackError, IngestHostnameResolver, ServerEventInput, ServerTrack, ServerTrackIdentity, ServerTrackOptions };
|
|
60
78
|
//# sourceMappingURL=serverEvent.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"serverEvent.js","names":[],"sources":["../../src/core/serverEvent.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { RawEventInput } from '../native/ingest/normalizeEvent'\n\n/**\n * One event recorded from server code.
|
|
1
|
+
{"version":3,"file":"serverEvent.js","names":[],"sources":["../../src/core/serverEvent.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { RawEventInput } from '../native/ingest/normalizeEvent'\nimport type { HitType } from '../native/store/types'\n\n/**\n * One event recorded from server code. Browser fields mean what they mean on the wire and pass the\n * same sanitizers; the rest stand in for what a request would carry.\n */\nexport type ServerEventInput = Pick<\n\tRawEventInput,\n\t| 'name'\n\t| 'path'\n\t| 'referrer'\n\t| 'query'\n\t| 'props'\n\t| 'value'\n\t| 'currency'\n\t| 'items'\n\t| 'revenue'\n\t| 'orderId'\n\t| 'refundId'\n\t| 'item'\n> & {\n\t/** Time on a page is measured in the browser, so a server event is never an engagement. */\n\ttype: Exclude<HitType, 'engagement'>\n\t/**\n\t * The site the event belongs to. Required, and stored as given: there is no request behind\n\t * a server event to attribute it to, so the caller owns the value.\n\t */\n\thostname: string\n\t/**\n\t * Attribution inputs overlaid on `opts.req`'s headers, ignored under `identity: 'none'`. Without\n\t * either the event has no visitor, device, browser, OS or language; none is fabricated.\n\t */\n\tip?: string\n\tuserAgent?: string\n\t/**\n\t * Analytics boundary to stamp; null is install-wide. Unset resolves from `opts.req`.\n\t * Ignored on an unscoped install, and never validated against the scopes that exist.\n\t */\n\tscope?: string | null\n\t/**\n\t * The IANA timezone whose local day picks the salt the visitor is hashed with, for a call that\n\t * has no request to resolve the scope's own from. The day the event is counted on is its scope's.\n\t */\n\ttimezone?: string\n\t/**\n\t * Event time, default now. A time past native's `retention.rawDays` or more than five minutes\n\t * ahead of the server clock is refused with an `AnalyticsTrackError`.\n\t */\n\tnow?: Date\n}\n\n/**\n * Whose event a server call records. `'request'` attributes it to the visitor behind `req` (or\n * `ip` and `userAgent`); `'none'` to no visitor, reading no address, agent, language or location.\n */\nexport type ServerTrackIdentity = 'request' | 'none'\n\nexport interface ServerTrackOptions {\n\t/** The request the event belongs to: attribution, scope and timezone all come from it. */\n\treq?: PayloadRequest\n\t/**\n\t * `'none'` records the event as no visitor's while `req` still supplies scope, timezone and\n\t * goals. Default `'none'` while `capture.gate` holds the native slot, else `'request'`.\n\t */\n\tidentity?: ServerTrackIdentity\n\t/**\n\t * Wait for the write to land rather than resolving once queued. On SQLite, a call inside a\n\t * transaction `req` holds open still resolves at once and stores on commit.\n\t */\n\tflush?: boolean\n}\n\n/**\n * An adapter's server-side ingestion. It is handed the Payload instance to write through, so it\n * works on any instance that runs the plugin, a jobs worker booted without `onInit` included.\n */\nexport type ServerTrack = (\n\tpayload: Payload,\n\tevent: ServerEventInput,\n\topts?: ServerTrackOptions\n) => Promise<void>\n\n/**\n * Applies an adapter's hostname policy to a request, null when it refuses the host, so server code\n * standing in for a browser event never trusts a forgeable `Host`.\n */\nexport type IngestHostnameResolver = (args: {\n\treq: PayloadRequest\n\t/** What the caller believes the host is, never trusted on its own. */\n\tclaimed?: string\n\tscope?: string | null\n}) => Promise<string | null>\n\n/** Thrown instead of dropping the event: a server caller can handle a rejected promise. */\nexport class AnalyticsTrackError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message)\n\t\tthis.name = 'AnalyticsTrackError'\n\t}\n}\n"],"mappings":";;AAgGA,IAAa,sBAAb,cAAyC,MAAM;CAC9C,YAAY,SAAiB;EAC5B,MAAM,OAAO;EACb,KAAK,OAAO;CACb;AACD"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
//#region src/core/siteAddress.ts
|
|
2
|
+
/**
|
|
3
|
+
* One configured site address as the exclusion endpoint answers it: an `http(s)` origin with its
|
|
4
|
+
* path and nothing after, or null for anything else.
|
|
5
|
+
*/
|
|
6
|
+
const siteAddress = (candidate) => {
|
|
7
|
+
if (typeof candidate !== "string") return null;
|
|
8
|
+
let url;
|
|
9
|
+
try {
|
|
10
|
+
url = new URL(candidate);
|
|
11
|
+
} catch {
|
|
12
|
+
return null;
|
|
13
|
+
}
|
|
14
|
+
if (url.protocol !== "https:" && url.protocol !== "http:") return null;
|
|
15
|
+
return `${url.origin}${url.pathname}`;
|
|
16
|
+
};
|
|
17
|
+
//#endregion
|
|
18
|
+
export { siteAddress };
|
|
19
|
+
|
|
20
|
+
//# sourceMappingURL=siteAddress.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"siteAddress.js","names":[],"sources":["../../src/core/siteAddress.ts"],"sourcesContent":["/**\n * One configured site address as the exclusion endpoint answers it: an `http(s)` origin with its\n * path and nothing after, or null for anything else.\n */\nexport const siteAddress = (candidate: unknown): string | null => {\n\tif (typeof candidate !== 'string') {\n\t\treturn null\n\t}\n\tlet url: URL\n\ttry {\n\t\turl = new URL(candidate)\n\t} catch {\n\t\treturn null\n\t}\n\tif (url.protocol !== 'https:' && url.protocol !== 'http:') {\n\t\treturn null\n\t}\n\treturn `${url.origin}${url.pathname}`\n}\n"],"mappings":";;;;;AAIA,MAAa,eAAe,cAAsC;CACjE,IAAI,OAAO,cAAc,UACxB,OAAO;CAER,IAAI;CACJ,IAAI;EACH,MAAM,IAAI,IAAI,SAAS;CACxB,QAAQ;EACP,OAAO;CACR;CACA,IAAI,IAAI,aAAa,YAAY,IAAI,aAAa,SACjD,OAAO;CAER,OAAO,GAAG,IAAI,SAAS,IAAI;AAC5B"}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { isDimensionKey, isFilterOperator } from "./guards.js";
|
|
2
|
+
//#region src/core/sourceErrors.ts
|
|
3
|
+
/** `Symbol.for`, so an error thrown in one of the package's bundles is recognized in another. */
|
|
4
|
+
const MISCONFIGURED = Symbol.for("@10x-media/analytics/sourceMisconfigured");
|
|
5
|
+
const HOST_REFUSED = Symbol.for("@10x-media/analytics/hostRefused");
|
|
6
|
+
const UNSUPPORTED_FILTER = Symbol.for("@10x-media/analytics/unsupportedFilter");
|
|
7
|
+
const INVALID_QUERY = Symbol.for("@10x-media/analytics/invalidQuery");
|
|
8
|
+
/**
|
|
9
|
+
* A source that cannot work as it is set up. Retrying cannot help, only changing its settings
|
|
10
|
+
* can, so reads answer `source_misconfigured` rather than `unavailable` and are never retried.
|
|
11
|
+
*/
|
|
12
|
+
var SourceMisconfiguredError = class extends Error {
|
|
13
|
+
[MISCONFIGURED] = true;
|
|
14
|
+
constructor(message, options) {
|
|
15
|
+
super(message, options);
|
|
16
|
+
this.name = "SourceMisconfiguredError";
|
|
17
|
+
}
|
|
18
|
+
};
|
|
19
|
+
/** A host a provider document may not reach: unlisted, private, or not https. */
|
|
20
|
+
var HostRefusedError = class extends SourceMisconfiguredError {
|
|
21
|
+
[HOST_REFUSED] = true;
|
|
22
|
+
host;
|
|
23
|
+
constructor(host, reason) {
|
|
24
|
+
super(`analytics: ${host} is refused: ${reason}`);
|
|
25
|
+
this.name = "HostRefusedError";
|
|
26
|
+
this.host = host;
|
|
27
|
+
}
|
|
28
|
+
};
|
|
29
|
+
/** How deep a cause chain is searched; a cyclic or runaway chain ends here. */
|
|
30
|
+
const MAX_CAUSE_DEPTH = 5;
|
|
31
|
+
/** The first error in `err`'s cause chain carrying `brand`, or undefined. */
|
|
32
|
+
const brandedCause = (err, brand) => {
|
|
33
|
+
let current = err;
|
|
34
|
+
for (let depth = 0; depth < MAX_CAUSE_DEPTH; depth++) {
|
|
35
|
+
if (typeof current !== "object" || current === null) return;
|
|
36
|
+
if (Reflect.get(current, brand) === true) return current;
|
|
37
|
+
current = Reflect.get(current, "cause");
|
|
38
|
+
}
|
|
39
|
+
};
|
|
40
|
+
/** True for a {@link SourceMisconfiguredError} anywhere in an error's cause chain. */
|
|
41
|
+
const isSourceMisconfigured = (err) => brandedCause(err, MISCONFIGURED) !== void 0;
|
|
42
|
+
/** True for a {@link HostRefusedError} anywhere in an error's cause chain. */
|
|
43
|
+
const isHostRefused = (err) => brandedCause(err, HOST_REFUSED) !== void 0;
|
|
44
|
+
/**
|
|
45
|
+
* A read carrying a filter its source does not apply. The source would answer without it, and
|
|
46
|
+
* its numbers would read as filtered when they are not, so the read is refused before it is made.
|
|
47
|
+
*/
|
|
48
|
+
var UnsupportedFilterError = class extends Error {
|
|
49
|
+
[UNSUPPORTED_FILTER] = true;
|
|
50
|
+
filter;
|
|
51
|
+
constructor(source, filter) {
|
|
52
|
+
super(`analytics: source "${source}" cannot filter ${filter.dimension} with ${filter.operator}`);
|
|
53
|
+
this.name = "UnsupportedFilterError";
|
|
54
|
+
this.filter = {
|
|
55
|
+
dimension: filter.dimension,
|
|
56
|
+
operator: filter.operator
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
};
|
|
60
|
+
const isFilterPair = (value) => typeof value === "object" && value !== null && isDimensionKey(Reflect.get(value, "dimension")) && isFilterOperator(Reflect.get(value, "operator"));
|
|
61
|
+
/**
|
|
62
|
+
* The filter an {@link UnsupportedFilterError} anywhere in an error's cause chain refused, or
|
|
63
|
+
* undefined for any other error.
|
|
64
|
+
*/
|
|
65
|
+
const refusedFilter = (err) => {
|
|
66
|
+
const refusal = brandedCause(err, UNSUPPORTED_FILTER);
|
|
67
|
+
const filter = refusal === void 0 ? void 0 : Reflect.get(refusal, "filter");
|
|
68
|
+
return isFilterPair(filter) ? filter : void 0;
|
|
69
|
+
};
|
|
70
|
+
/**
|
|
71
|
+
* A read its source refuses as asked: a combination it never counts (goal completions broken
|
|
72
|
+
* down by item, say), which no retry or setting changes. Endpoints answer it `invalid_param`.
|
|
73
|
+
*/
|
|
74
|
+
var InvalidQueryError = class extends Error {
|
|
75
|
+
[INVALID_QUERY] = true;
|
|
76
|
+
/** The query parameter at fault. */
|
|
77
|
+
param;
|
|
78
|
+
constructor(message, param, options) {
|
|
79
|
+
super(message, options);
|
|
80
|
+
this.name = "InvalidQueryError";
|
|
81
|
+
this.param = param;
|
|
82
|
+
}
|
|
83
|
+
};
|
|
84
|
+
/** An error and each cause beneath it, so a log line keeps the driver error a wrapper carries. */
|
|
85
|
+
const describeWithCauses = (err) => {
|
|
86
|
+
const parts = [];
|
|
87
|
+
let current = err;
|
|
88
|
+
for (let depth = 0; depth < MAX_CAUSE_DEPTH && current != null; depth++) {
|
|
89
|
+
const message = current instanceof Error ? current.message : String(current);
|
|
90
|
+
if (!parts.some((part) => message !== "" && part.includes(message))) parts.push(String(current));
|
|
91
|
+
current = typeof current === "object" ? Reflect.get(current, "cause") : void 0;
|
|
92
|
+
}
|
|
93
|
+
return parts.join(", caused by ");
|
|
94
|
+
};
|
|
95
|
+
/** The refusal an {@link InvalidQueryError} anywhere in an error's cause chain carries. */
|
|
96
|
+
const invalidQuery = (err) => {
|
|
97
|
+
const refusal = brandedCause(err, INVALID_QUERY);
|
|
98
|
+
if (refusal === void 0) return;
|
|
99
|
+
const message = Reflect.get(refusal, "message");
|
|
100
|
+
const param = Reflect.get(refusal, "param");
|
|
101
|
+
return typeof message === "string" && typeof param === "string" ? {
|
|
102
|
+
message,
|
|
103
|
+
param
|
|
104
|
+
} : void 0;
|
|
105
|
+
};
|
|
106
|
+
//#endregion
|
|
107
|
+
export { HostRefusedError, InvalidQueryError, SourceMisconfiguredError, UnsupportedFilterError, describeWithCauses, invalidQuery, isHostRefused, isSourceMisconfigured, refusedFilter };
|
|
108
|
+
|
|
109
|
+
//# sourceMappingURL=sourceErrors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sourceErrors.js","names":[],"sources":["../../src/core/sourceErrors.ts"],"sourcesContent":["import type { FilterPair } from './capabilities'\nimport { isDimensionKey, isFilterOperator } from './guards'\n\n/** `Symbol.for`, so an error thrown in one of the package's bundles is recognized in another. */\nconst MISCONFIGURED: unique symbol = Symbol.for('@10x-media/analytics/sourceMisconfigured')\n\nconst HOST_REFUSED: unique symbol = Symbol.for('@10x-media/analytics/hostRefused')\n\nconst UNSUPPORTED_FILTER: unique symbol = Symbol.for('@10x-media/analytics/unsupportedFilter')\n\nconst INVALID_QUERY: unique symbol = Symbol.for('@10x-media/analytics/invalidQuery')\n\n/**\n * A source that cannot work as it is set up. Retrying cannot help, only changing its settings\n * can, so reads answer `source_misconfigured` rather than `unavailable` and are never retried.\n */\nexport class SourceMisconfiguredError extends Error {\n\treadonly [MISCONFIGURED] = true\n\n\tconstructor(message: string, options?: ErrorOptions) {\n\t\tsuper(message, options)\n\t\tthis.name = 'SourceMisconfiguredError'\n\t}\n}\n\n/** A host a provider document may not reach: unlisted, private, or not https. */\nexport class HostRefusedError extends SourceMisconfiguredError {\n\treadonly [HOST_REFUSED] = true\n\treadonly host: string\n\n\tconstructor(host: string, reason: string) {\n\t\tsuper(`analytics: ${host} is refused: ${reason}`)\n\t\tthis.name = 'HostRefusedError'\n\t\tthis.host = host\n\t}\n}\n\n/** How deep a cause chain is searched; a cyclic or runaway chain ends here. */\nconst MAX_CAUSE_DEPTH = 5\n\n/** The first error in `err`'s cause chain carrying `brand`, or undefined. */\nconst brandedCause = (err: unknown, brand: symbol): object | undefined => {\n\tlet current: unknown = err\n\tfor (let depth = 0; depth < MAX_CAUSE_DEPTH; depth++) {\n\t\tif (typeof current !== 'object' || current === null) {\n\t\t\treturn undefined\n\t\t}\n\t\tif (Reflect.get(current, brand) === true) {\n\t\t\treturn current\n\t\t}\n\t\tcurrent = Reflect.get(current, 'cause')\n\t}\n\treturn undefined\n}\n\n/** True for a {@link SourceMisconfiguredError} anywhere in an error's cause chain. */\nexport const isSourceMisconfigured = (err: unknown): boolean =>\n\tbrandedCause(err, MISCONFIGURED) !== undefined\n\n/** True for a {@link HostRefusedError} anywhere in an error's cause chain. */\nexport const isHostRefused = (err: unknown): boolean =>\n\tbrandedCause(err, HOST_REFUSED) !== undefined\n\n/**\n * A read carrying a filter its source does not apply. The source would answer without it, and\n * its numbers would read as filtered when they are not, so the read is refused before it is made.\n */\nexport class UnsupportedFilterError extends Error {\n\treadonly [UNSUPPORTED_FILTER] = true\n\treadonly filter: FilterPair\n\n\tconstructor(source: string, filter: FilterPair) {\n\t\tsuper(`analytics: source \"${source}\" cannot filter ${filter.dimension} with ${filter.operator}`)\n\t\tthis.name = 'UnsupportedFilterError'\n\t\tthis.filter = { dimension: filter.dimension, operator: filter.operator }\n\t}\n}\n\nconst isFilterPair = (value: unknown): value is FilterPair =>\n\ttypeof value === 'object' &&\n\tvalue !== null &&\n\tisDimensionKey(Reflect.get(value, 'dimension')) &&\n\tisFilterOperator(Reflect.get(value, 'operator'))\n\n/**\n * The filter an {@link UnsupportedFilterError} anywhere in an error's cause chain refused, or\n * undefined for any other error.\n */\nexport const refusedFilter = (err: unknown): FilterPair | undefined => {\n\tconst refusal = brandedCause(err, UNSUPPORTED_FILTER)\n\tconst filter: unknown = refusal === undefined ? undefined : Reflect.get(refusal, 'filter')\n\treturn isFilterPair(filter) ? filter : undefined\n}\n\n/**\n * A read its source refuses as asked: a combination it never counts (goal completions broken\n * down by item, say), which no retry or setting changes. Endpoints answer it `invalid_param`.\n */\nexport class InvalidQueryError extends Error {\n\treadonly [INVALID_QUERY] = true\n\t/** The query parameter at fault. */\n\treadonly param: string\n\n\tconstructor(message: string, param: string, options?: ErrorOptions) {\n\t\tsuper(message, options)\n\t\tthis.name = 'InvalidQueryError'\n\t\tthis.param = param\n\t}\n}\n\n/** An error and each cause beneath it, so a log line keeps the driver error a wrapper carries. */\nexport const describeWithCauses = (err: unknown): string => {\n\tconst parts: string[] = []\n\tlet current: unknown = err\n\tfor (let depth = 0; depth < MAX_CAUSE_DEPTH && current != null; depth++) {\n\t\tconst message = current instanceof Error ? current.message : String(current)\n\t\t// A wrapper that already quotes its cause's message (`ReadFailedError`) is not repeated.\n\t\tif (!parts.some((part) => message !== '' && part.includes(message))) {\n\t\t\tparts.push(String(current))\n\t\t}\n\t\tcurrent = typeof current === 'object' ? Reflect.get(current, 'cause') : undefined\n\t}\n\treturn parts.join(', caused by ')\n}\n\n/** The refusal an {@link InvalidQueryError} anywhere in an error's cause chain carries. */\nexport const invalidQuery = (err: unknown): { message: string; param: string } | undefined => {\n\tconst refusal = brandedCause(err, INVALID_QUERY)\n\tif (refusal === undefined) {\n\t\treturn undefined\n\t}\n\tconst message: unknown = Reflect.get(refusal, 'message')\n\tconst param: unknown = Reflect.get(refusal, 'param')\n\treturn typeof message === 'string' && typeof param === 'string' ? { message, param } : undefined\n}\n"],"mappings":";;;AAIA,MAAM,gBAA+B,OAAO,IAAI,0CAA0C;AAE1F,MAAM,eAA8B,OAAO,IAAI,kCAAkC;AAEjF,MAAM,qBAAoC,OAAO,IAAI,wCAAwC;AAE7F,MAAM,gBAA+B,OAAO,IAAI,mCAAmC;;;;;AAMnF,IAAa,2BAAb,cAA8C,MAAM;CACnD,CAAU,iBAAiB;CAE3B,YAAY,SAAiB,SAAwB;EACpD,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,mBAAb,cAAsC,yBAAyB;CAC9D,CAAU,gBAAgB;CAC1B;CAEA,YAAY,MAAc,QAAgB;EACzC,MAAM,cAAc,KAAK,eAAe,QAAQ;EAChD,KAAK,OAAO;EACZ,KAAK,OAAO;CACb;AACD;;AAGA,MAAM,kBAAkB;;AAGxB,MAAM,gBAAgB,KAAc,UAAsC;CACzE,IAAI,UAAmB;CACvB,KAAK,IAAI,QAAQ,GAAG,QAAQ,iBAAiB,SAAS;EACrD,IAAI,OAAO,YAAY,YAAY,YAAY,MAC9C;EAED,IAAI,QAAQ,IAAI,SAAS,KAAK,MAAM,MACnC,OAAO;EAER,UAAU,QAAQ,IAAI,SAAS,OAAO;CACvC;AAED;;AAGA,MAAa,yBAAyB,QACrC,aAAa,KAAK,aAAa,MAAM,KAAA;;AAGtC,MAAa,iBAAiB,QAC7B,aAAa,KAAK,YAAY,MAAM,KAAA;;;;;AAMrC,IAAa,yBAAb,cAA4C,MAAM;CACjD,CAAU,sBAAsB;CAChC;CAEA,YAAY,QAAgB,QAAoB;EAC/C,MAAM,sBAAsB,OAAO,kBAAkB,OAAO,UAAU,QAAQ,OAAO,UAAU;EAC/F,KAAK,OAAO;EACZ,KAAK,SAAS;GAAE,WAAW,OAAO;GAAW,UAAU,OAAO;EAAS;CACxE;AACD;AAEA,MAAM,gBAAgB,UACrB,OAAO,UAAU,YACjB,UAAU,QACV,eAAe,QAAQ,IAAI,OAAO,WAAW,CAAC,KAC9C,iBAAiB,QAAQ,IAAI,OAAO,UAAU,CAAC;;;;;AAMhD,MAAa,iBAAiB,QAAyC;CACtE,MAAM,UAAU,aAAa,KAAK,kBAAkB;CACpD,MAAM,SAAkB,YAAY,KAAA,IAAY,KAAA,IAAY,QAAQ,IAAI,SAAS,QAAQ;CACzF,OAAO,aAAa,MAAM,IAAI,SAAS,KAAA;AACxC;;;;;AAMA,IAAa,oBAAb,cAAuC,MAAM;CAC5C,CAAU,iBAAiB;;CAE3B;CAEA,YAAY,SAAiB,OAAe,SAAwB;EACnE,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;EACZ,KAAK,QAAQ;CACd;AACD;;AAGA,MAAa,sBAAsB,QAAyB;CAC3D,MAAM,QAAkB,CAAC;CACzB,IAAI,UAAmB;CACvB,KAAK,IAAI,QAAQ,GAAG,QAAQ,mBAAmB,WAAW,MAAM,SAAS;EACxE,MAAM,UAAU,mBAAmB,QAAQ,QAAQ,UAAU,OAAO,OAAO;EAE3E,IAAI,CAAC,MAAM,MAAM,SAAS,YAAY,MAAM,KAAK,SAAS,OAAO,CAAC,GACjE,MAAM,KAAK,OAAO,OAAO,CAAC;EAE3B,UAAU,OAAO,YAAY,WAAW,QAAQ,IAAI,SAAS,OAAO,IAAI,KAAA;CACzE;CACA,OAAO,MAAM,KAAK,cAAc;AACjC;;AAGA,MAAa,gBAAgB,QAAiE;CAC7F,MAAM,UAAU,aAAa,KAAK,aAAa;CAC/C,IAAI,YAAY,KAAA,GACf;CAED,MAAM,UAAmB,QAAQ,IAAI,SAAS,SAAS;CACvD,MAAM,QAAiB,QAAQ,IAAI,SAAS,OAAO;CACnD,OAAO,OAAO,YAAY,YAAY,OAAO,UAAU,WAAW;EAAE;EAAS;CAAM,IAAI,KAAA;AACxF"}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import { isRecord, kindOf, listOf } from "./values.js";
|
|
2
|
+
import { keysOf, optionalFunction, optionalList, optionsObject } from "./optionChecks.js";
|
|
3
|
+
import { resolveScopedCollection } from "./collectionOption.js";
|
|
4
|
+
import { resolveHostPolicy } from "../providers/hosts.js";
|
|
5
|
+
import { PROVIDERS_SLUG, connectionFieldAccess } from "../providers/collection.js";
|
|
6
|
+
//#region src/core/sourceOptions.ts
|
|
7
|
+
const PROVIDERS_KEYS = keysOf({
|
|
8
|
+
collection: true,
|
|
9
|
+
resolve: true,
|
|
10
|
+
hosts: true
|
|
11
|
+
});
|
|
12
|
+
const PROVIDERS_COLLECTION_KEYS = keysOf({
|
|
13
|
+
slug: true,
|
|
14
|
+
scopeField: true,
|
|
15
|
+
fields: true,
|
|
16
|
+
overrides: true,
|
|
17
|
+
access: true,
|
|
18
|
+
encryption: true,
|
|
19
|
+
connectionAccess: true,
|
|
20
|
+
sourceAccess: true
|
|
21
|
+
});
|
|
22
|
+
const PROVIDER_FIELD_KEYS = keysOf({
|
|
23
|
+
name: true,
|
|
24
|
+
provider: true,
|
|
25
|
+
enabled: true
|
|
26
|
+
});
|
|
27
|
+
const ENCRYPTION_KEYS = keysOf({ keys: true });
|
|
28
|
+
const isAdapterShaped = (value) => isRecord(value) && typeof value.id === "string" && value.id !== "" && typeof value.isConfigured === "function" && typeof value.query === "function" && isRecord(value.capabilities);
|
|
29
|
+
/** `adapters`: a list of adapters with an id each, no two sharing one. */
|
|
30
|
+
const assertAdapters = (value) => {
|
|
31
|
+
const ids = /* @__PURE__ */ new Set();
|
|
32
|
+
for (const [index, adapter] of optionalList(value, "adapters", "[native()]").entries()) {
|
|
33
|
+
if (!isAdapterShaped(adapter)) throw new Error(`analytics: adapters[${index}] must be an adapter such as native() or plausible({ siteId, apiKey }), got ${kindOf(adapter)}`);
|
|
34
|
+
if (ids.has(adapter.id)) throw new Error(`analytics: adapters lists two adapters with the id "${adapter.id}"; every source is read by its id, so give each its own`);
|
|
35
|
+
ids.add(adapter.id);
|
|
36
|
+
}
|
|
37
|
+
};
|
|
38
|
+
/** An option naming one of `adapters` by its id. */
|
|
39
|
+
const assertNamesAdapter = (value, path, adapters) => {
|
|
40
|
+
if (value === void 0) return;
|
|
41
|
+
if (typeof value !== "string") throw new Error(`analytics: ${path} must be the id of an adapter in adapters, got ${kindOf(value)}`);
|
|
42
|
+
if (!adapters.some((adapter) => adapter.id === value)) throw new Error(`analytics: ${path} "${value}" names no adapter in adapters, whose ids are ${listOf(adapters.map((adapter) => `"${adapter.id}"`))}`);
|
|
43
|
+
};
|
|
44
|
+
/** `providers.collection.encryption`: a dedicated key ring, or nothing. */
|
|
45
|
+
const assertEncryption = (value) => {
|
|
46
|
+
if (value === void 0) return;
|
|
47
|
+
const { keys } = optionsObject(value, {
|
|
48
|
+
path: "providers.collection.encryption",
|
|
49
|
+
known: ENCRYPTION_KEYS,
|
|
50
|
+
example: "an object such as { keys }"
|
|
51
|
+
});
|
|
52
|
+
if (keys !== void 0 && (!isRecord(keys) || typeof keys.active !== "string" || !isRecord(keys.keys))) throw new Error(`analytics: providers.collection.encryption.keys must be a key set such as { active: 'k1', keys: { k1: process.env.PROVIDER_KEY } }, got ${kindOf(keys)}`);
|
|
53
|
+
};
|
|
54
|
+
/** `providers.collection` turned on, with what only that collection takes. */
|
|
55
|
+
const resolveProvidersCollection = (option) => {
|
|
56
|
+
const collection = resolveScopedCollection(option, {
|
|
57
|
+
path: "providers.collection",
|
|
58
|
+
fallback: PROVIDERS_SLUG,
|
|
59
|
+
known: PROVIDERS_COLLECTION_KEYS,
|
|
60
|
+
fieldKeys: PROVIDER_FIELD_KEYS,
|
|
61
|
+
exampleSlug: "providers"
|
|
62
|
+
});
|
|
63
|
+
if (option === void 0 || typeof option === "boolean") return collection;
|
|
64
|
+
assertEncryption(option.encryption);
|
|
65
|
+
const connectionAccess = connectionFieldAccess("providers.collection.connectionAccess", option.connectionAccess);
|
|
66
|
+
const sourceAccess = optionalFunction(option.sourceAccess, "providers.collection.sourceAccess");
|
|
67
|
+
return {
|
|
68
|
+
...collection,
|
|
69
|
+
...option.encryption ? { encryption: option.encryption } : {},
|
|
70
|
+
...connectionAccess ? { connectionAccess } : {},
|
|
71
|
+
...sourceAccess ? { sourceAccess } : {}
|
|
72
|
+
};
|
|
73
|
+
};
|
|
74
|
+
/** `providers`: the collection or `resolve` (never both), and the hosts either may reach. */
|
|
75
|
+
const resolveProviders = (option) => {
|
|
76
|
+
if (option !== void 0) optionsObject(option, {
|
|
77
|
+
path: "providers",
|
|
78
|
+
known: PROVIDERS_KEYS,
|
|
79
|
+
example: "an object such as { collection: true }"
|
|
80
|
+
});
|
|
81
|
+
const resolve = optionalFunction(option?.resolve, "providers.resolve");
|
|
82
|
+
const collection = resolveProvidersCollection(option?.collection);
|
|
83
|
+
if (resolve && collection.enabled) throw new Error("analytics: providers.resolve and providers.collection cannot both be set. resolve replaces the collection lookup, so the adapters it returns would be filtered by provider document ids no reader holds, and the collection's sourceAccess and connectionAccess would do nothing. Keep one of them.");
|
|
84
|
+
if (option?.hosts !== void 0 && !collection.enabled && !resolve) throw new Error("analytics: providers.hosts only applies to provider documents, so it needs providers.collection or providers.resolve. Set one of them, or remove it.");
|
|
85
|
+
return {
|
|
86
|
+
collection,
|
|
87
|
+
...resolve ? { resolve } : {},
|
|
88
|
+
hosts: resolveHostPolicy(option?.hosts)
|
|
89
|
+
};
|
|
90
|
+
};
|
|
91
|
+
//#endregion
|
|
92
|
+
export { assertAdapters, assertNamesAdapter, resolveProviders };
|
|
93
|
+
|
|
94
|
+
//# sourceMappingURL=sourceOptions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sourceOptions.js","names":[],"sources":["../../src/core/sourceOptions.ts"],"sourcesContent":["import {\n\tconnectionFieldAccess,\n\tPROVIDERS_SLUG,\n\ttype ProviderCollectionFieldOverrides,\n} from '../providers/collection'\nimport { resolveHostPolicy } from '../providers/hosts'\nimport { resolveScopedCollection } from './collectionOption'\nimport { keysOf, optionalFunction, optionalList, optionsObject } from './optionChecks'\nimport type { ProvidersCollectionOptions, ProvidersOptions, ResolvedOptions } from './options'\nimport { isRecord, kindOf, listOf } from './values'\n\nconst PROVIDERS_KEYS = keysOf<ProvidersOptions>({ collection: true, resolve: true, hosts: true })\nconst PROVIDERS_COLLECTION_KEYS = keysOf<ProvidersCollectionOptions>({\n\tslug: true,\n\tscopeField: true,\n\tfields: true,\n\toverrides: true,\n\taccess: true,\n\tencryption: true,\n\tconnectionAccess: true,\n\tsourceAccess: true,\n})\nconst PROVIDER_FIELD_KEYS = keysOf<ProviderCollectionFieldOverrides>({\n\tname: true,\n\tprovider: true,\n\tenabled: true,\n})\nconst ENCRYPTION_KEYS = keysOf<NonNullable<ProvidersCollectionOptions['encryption']>>({\n\tkeys: true,\n})\n\nconst isAdapterShaped = (value: unknown): value is { id: string } =>\n\tisRecord(value) &&\n\ttypeof value.id === 'string' &&\n\tvalue.id !== '' &&\n\ttypeof value.isConfigured === 'function' &&\n\ttypeof value.query === 'function' &&\n\tisRecord(value.capabilities)\n\n/** `adapters`: a list of adapters with an id each, no two sharing one. */\nexport const assertAdapters = (value: unknown): void => {\n\tconst ids = new Set<string>()\n\tfor (const [index, adapter] of optionalList(value, 'adapters', '[native()]').entries()) {\n\t\tif (!isAdapterShaped(adapter)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: adapters[${index}] must be an adapter such as native() or plausible({ siteId, apiKey }), got ${kindOf(adapter)}`\n\t\t\t)\n\t\t}\n\t\tif (ids.has(adapter.id)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: adapters lists two adapters with the id \"${adapter.id}\"; every source is read by its id, so give each its own`\n\t\t\t)\n\t\t}\n\t\tids.add(adapter.id)\n\t}\n}\n\n/** An option naming one of `adapters` by its id. */\nexport const assertNamesAdapter = (\n\tvalue: unknown,\n\tpath: string,\n\tadapters: readonly { id: string }[]\n): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tif (typeof value !== 'string') {\n\t\tthrow new Error(\n\t\t\t`analytics: ${path} must be the id of an adapter in adapters, got ${kindOf(value)}`\n\t\t)\n\t}\n\tif (!adapters.some((adapter) => adapter.id === value)) {\n\t\tthrow new Error(\n\t\t\t`analytics: ${path} \"${value}\" names no adapter in adapters, whose ids are ${listOf(adapters.map((adapter) => `\"${adapter.id}\"`))}`\n\t\t)\n\t}\n}\n\n/** `providers.collection.encryption`: a dedicated key ring, or nothing. */\nconst assertEncryption = (value: unknown): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tconst { keys } = optionsObject(value, {\n\t\tpath: 'providers.collection.encryption',\n\t\tknown: ENCRYPTION_KEYS,\n\t\texample: 'an object such as { keys }',\n\t})\n\tif (\n\t\tkeys !== undefined &&\n\t\t(!isRecord(keys) || typeof keys.active !== 'string' || !isRecord(keys.keys))\n\t) {\n\t\tthrow new Error(\n\t\t\t`analytics: providers.collection.encryption.keys must be a key set such as { active: 'k1', keys: { k1: process.env.PROVIDER_KEY } }, got ${kindOf(keys)}`\n\t\t)\n\t}\n}\n\n/** `providers.collection` turned on, with what only that collection takes. */\nconst resolveProvidersCollection = (\n\toption: ProvidersOptions['collection']\n): ResolvedOptions['providers']['collection'] => {\n\tconst collection = resolveScopedCollection(option, {\n\t\tpath: 'providers.collection',\n\t\tfallback: PROVIDERS_SLUG,\n\t\tknown: PROVIDERS_COLLECTION_KEYS,\n\t\tfieldKeys: PROVIDER_FIELD_KEYS,\n\t\texampleSlug: 'providers',\n\t})\n\tif (option === undefined || typeof option === 'boolean') {\n\t\treturn collection\n\t}\n\tassertEncryption(option.encryption)\n\tconst connectionAccess = connectionFieldAccess(\n\t\t'providers.collection.connectionAccess',\n\t\toption.connectionAccess\n\t)\n\tconst sourceAccess = optionalFunction(option.sourceAccess, 'providers.collection.sourceAccess')\n\treturn {\n\t\t...collection,\n\t\t...(option.encryption ? { encryption: option.encryption } : {}),\n\t\t...(connectionAccess ? { connectionAccess } : {}),\n\t\t...(sourceAccess ? { sourceAccess } : {}),\n\t}\n}\n\n/** `providers`: the collection or `resolve` (never both), and the hosts either may reach. */\nexport const resolveProviders = (\n\toption: ProvidersOptions | undefined\n): ResolvedOptions['providers'] => {\n\tif (option !== undefined) {\n\t\toptionsObject(option, {\n\t\t\tpath: 'providers',\n\t\t\tknown: PROVIDERS_KEYS,\n\t\t\texample: 'an object such as { collection: true }',\n\t\t})\n\t}\n\tconst resolve = optionalFunction(option?.resolve, 'providers.resolve')\n\tconst collection = resolveProvidersCollection(option?.collection)\n\tif (resolve && collection.enabled) {\n\t\tthrow new Error(\n\t\t\t\"analytics: providers.resolve and providers.collection cannot both be set. resolve replaces the collection lookup, so the adapters it returns would be filtered by provider document ids no reader holds, and the collection's sourceAccess and connectionAccess would do nothing. Keep one of them.\"\n\t\t)\n\t}\n\tif (option?.hosts !== undefined && !collection.enabled && !resolve) {\n\t\tthrow new Error(\n\t\t\t'analytics: providers.hosts only applies to provider documents, so it needs providers.collection or providers.resolve. Set one of them, or remove it.'\n\t\t)\n\t}\n\treturn {\n\t\tcollection,\n\t\t...(resolve ? { resolve } : {}),\n\t\thosts: resolveHostPolicy(option?.hosts),\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
//#region src/core/throttle.ts
|
|
2
|
+
/**
|
|
3
|
+
* `say` limited to once per `intervalMs` on the `now` clock, so a failure repeating on every read
|
|
4
|
+
* logs one line per interval rather than one per read.
|
|
5
|
+
*/
|
|
6
|
+
const throttled = (say, clock) => {
|
|
7
|
+
let saidAt;
|
|
8
|
+
return (message) => {
|
|
9
|
+
const at = clock.now();
|
|
10
|
+
if (saidAt !== void 0 && at - saidAt < clock.intervalMs) return;
|
|
11
|
+
saidAt = at;
|
|
12
|
+
say(message);
|
|
13
|
+
};
|
|
14
|
+
};
|
|
15
|
+
//#endregion
|
|
16
|
+
export { throttled };
|
|
17
|
+
|
|
18
|
+
//# sourceMappingURL=throttle.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"throttle.js","names":[],"sources":["../../src/core/throttle.ts"],"sourcesContent":["/**\n * `say` limited to once per `intervalMs` on the `now` clock, so a failure repeating on every read\n * logs one line per interval rather than one per read.\n */\nexport const throttled = (\n\tsay: (message: string) => void,\n\tclock: { now: () => number; intervalMs: number }\n): ((message: string) => void) => {\n\tlet saidAt: number | undefined\n\treturn (message) => {\n\t\tconst at = clock.now()\n\t\tif (saidAt !== undefined && at - saidAt < clock.intervalMs) {\n\t\t\treturn\n\t\t}\n\t\tsaidAt = at\n\t\tsay(message)\n\t}\n}\n"],"mappings":";;;;;AAIA,MAAa,aACZ,KACA,UACiC;CACjC,IAAI;CACJ,QAAQ,YAAY;EACnB,MAAM,KAAK,MAAM,IAAI;EACrB,IAAI,WAAW,KAAA,KAAa,KAAK,SAAS,MAAM,YAC/C;EAED,SAAS;EACT,IAAI,OAAO;CACZ;AACD"}
|