@10x-media/analytics 1.0.0-beta.9 → 4.0.0-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +710 -0
- package/README.md +35 -36
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +19 -0
- package/dist/adapters/ga4/disableKey.js.map +1 -0
- package/dist/adapters/ga4/eventName.d.ts +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 +24 -0
- package/dist/adapters/ga4/ga4.js +226 -122
- 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 +25 -13
- package/dist/adapters/plausible/plausible.js +144 -124
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +33 -9
- package/dist/adapters/posthog/posthog.js +279 -121
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/posthog/projectCheck.js +56 -0
- package/dist/adapters/posthog/projectCheck.js.map +1 -0
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +19 -9
- package/dist/adapters/umami/umami.js +196 -166
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +28 -25
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +49 -92
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +131 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/capture/withoutConsent.js +91 -0
- package/dist/capture/withoutConsent.js.map +1 -0
- package/dist/charts/BarList.d.ts +27 -13
- package/dist/charts/BarList.js +38 -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 +17 -1
- package/dist/charts/bars.js +12 -11
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +198 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +48 -36
- 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 +59 -26
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +347 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +105 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +321 -60
- package/dist/core/contract.js +7 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +530 -152
- package/dist/core/options.js +158 -216
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +114 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +349 -36
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +50 -16
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceLabel.d.ts +10 -0
- package/dist/core/sourceLabel.js +63 -0
- package/dist/core/sourceLabel.js.map +1 -0
- package/dist/core/sourceOptions.js +107 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/sourcePolicy.d.ts +55 -0
- package/dist/core/sourcePolicy.js +51 -0
- package/dist/core/sourcePolicy.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +15 -0
- package/dist/exports/adapters/ga4.d.ts +16 -1
- package/dist/exports/adapters/native.d.ts +29 -2
- package/dist/exports/adapters/native.js +5 -1
- package/dist/exports/adapters/plausible.d.ts +16 -1
- package/dist/exports/adapters/posthog.d.ts +16 -1
- package/dist/exports/adapters/umami.d.ts +16 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +43 -12
- package/dist/exports/client.js +22 -8
- package/dist/exports/geo.d.ts +4 -2
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/react.d.ts +5 -3
- package/dist/exports/react.js +1 -2
- package/dist/exports/routes.d.ts +19 -0
- package/dist/exports/routes.js +3 -0
- package/dist/exports/rsc.d.ts +32 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +18 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +6 -18
- package/dist/exports/tracker.js +3 -12
- package/dist/exports/types.d.ts +45 -14
- package/dist/exports/types.js +6 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +19 -7
- package/dist/fields/AnalyticsPanelField.js +123 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +17 -6
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +222 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +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.d.ts +3 -0
- package/dist/fields/config/fetchSources.js +17 -23
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/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 +30 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +67 -38
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +79 -26
- package/dist/fields/readForDocument.js +450 -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 +179 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +143 -124
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -22
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +40 -38
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +155 -47
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -25
- package/dist/goals/trackGoalAction.js +71 -66
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +68 -12
- package/dist/index.js +261 -192
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +79 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.js +27 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +103 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +31 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1627 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +199 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +110 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +5 -2
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +27 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +10 -0
- package/dist/native/ingest/bots.js +66 -0
- package/dist/native/ingest/bots.js.map +1 -0
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +34 -8
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +185 -32
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +70 -8
- package/dist/native/ingest/normalizeEvent.js +239 -60
- 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 +44 -0
- package/dist/native/ingest/requestHost.js.map +1 -0
- package/dist/native/ingest/resolveHostname.d.ts +20 -0
- package/dist/native/ingest/resolveHostname.js +51 -0
- package/dist/native/ingest/resolveHostname.js.map +1 -0
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +85 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +188 -69
- 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 +5 -2
- package/dist/native/ingest/source.js +163 -59
- 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 +25 -13
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +128 -9
- package/dist/native/nativeAdapter.js +396 -288
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +119 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +65 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +438 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +705 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +101 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +387 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +349 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +49 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +668 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +15 -0
- package/dist/native/store/types.js +10 -0
- package/dist/native/store/types.js.map +1 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +57 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +346 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +105 -71
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +24 -0
- package/dist/plugin/errors.js +86 -0
- package/dist/plugin/errors.js.map +1 -0
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.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/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +161 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +80 -51
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.d.ts +11 -0
- package/dist/plugin/readContextForRequest.js +79 -32
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +67 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +79 -34
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +138 -0
- package/dist/plugin/refreshEndpoint.js.map +1 -0
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +235 -29
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +61 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +23 -0
- package/dist/plugin/scopeChange.js.map +1 -0
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +50 -23
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +24 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/ProvidersListNotice.d.ts +11 -0
- package/dist/providers/ProvidersListNotice.js +36 -0
- package/dist/providers/ProvidersListNotice.js.map +1 -0
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +63 -0
- package/dist/providers/collection.js +369 -150
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +84 -0
- package/dist/providers/factory.js +84 -25
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +105 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +329 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +26 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/scopeUnique.js +41 -0
- package/dist/providers/scopeUnique.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +6 -13
- package/dist/query/fetchQuery.d.ts +36 -23
- package/dist/query/fetchQuery.js +96 -89
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +8 -2
- package/dist/query/parse.js +155 -108
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +42 -20
- package/dist/react/AnalyticsProvider.js +24 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -8
- package/dist/react/useAnalytics.js +31 -13
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/routes/captureRoute.d.ts +28 -0
- package/dist/routes/captureRoute.js +67 -0
- package/dist/routes/captureRoute.js.map +1 -0
- package/dist/routes/ingestRoute.d.ts +17 -0
- package/dist/routes/ingestRoute.js +17 -0
- package/dist/routes/ingestRoute.js.map +1 -0
- package/dist/site/AnalyticsScripts.d.ts +35 -0
- package/dist/site/AnalyticsScripts.js +44 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +43 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +71 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -71
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.d.ts +1 -0
- package/dist/surfacing/epoch.js +116 -0
- package/dist/surfacing/epoch.js.map +1 -0
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +119 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +30 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +222 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -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 +174 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +5 -10
- package/dist/tracker/createTracker.js +434 -91
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +8 -0
- package/dist/tracker/exclusion.js +82 -0
- package/dist/tracker/exclusion.js.map +1 -0
- package/dist/tracker/gate.d.ts +8 -0
- package/dist/tracker/gate.js +244 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +23 -15
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +129 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +60 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +97 -17
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +21 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +36 -18
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +145 -9
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +18 -10
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +54 -22
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +99 -49
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +255 -74
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +243 -71
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +238 -70
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +246 -71
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +250 -75
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +241 -70
- 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 +214 -17
- package/dist/translations/keys.js +219 -17
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +243 -72
- 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 +255 -80
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +246 -69
- 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 +246 -69
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +241 -70
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +110 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1667 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/ChoiceMenu.js +48 -0
- package/dist/ui/components/ChoiceMenu.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +25 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/components/SourcesNoticeBanner.js +20 -0
- package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +12 -8
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +9 -10
- package/dist/view/AnalyticsView.js +47 -19
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -185
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +155 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/consentShare.js +15 -0
- package/dist/view/consentShare.js.map +1 -0
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +67 -32
- 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 +113 -16
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +13 -11
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +195 -132
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +120 -32
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +127 -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 +42 -36
- 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 +181 -122
- 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 +52 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +65 -8
- package/dist/view/viewProps.js +123 -36
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +81 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +130 -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 +90 -71
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +18 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaultLayout.d.ts +26 -0
- package/dist/widgets/defaultLayout.js +51 -0
- package/dist/widgets/defaultLayout.js.map +1 -0
- package/dist/widgets/defaults.d.ts +4 -7
- package/dist/widgets/defaults.js +12 -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 +79 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +19 -2
- package/dist/widgets/prepareWidgetRead.js +63 -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 +28 -19
- package/dist/widgets/readForWidget.js +33 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
- package/dist/widgets/readForWidgetBreakdown.js +48 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +18 -24
- package/dist/widgets/readForWidgetGoals.js +52 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
- package/dist/widgets/readForWidgetRealtime.js +54 -27
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +27 -32
- package/dist/widgets/readForWidgetSeries.js +45 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +48 -0
- package/dist/widgets/readMeta.js +52 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +56 -16
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +207 -127
- 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 +61 -42
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/exports/next.d.ts +0 -3
- package/dist/exports/next.js +0 -3
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -157
- 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 -14
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -174
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -29
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/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 -105
- 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/next/captureRewrites.d.ts +0 -42
- package/dist/next/captureRewrites.js +0 -57
- package/dist/next/captureRewrites.js.map +0 -1
- package/dist/next/posthogProxyRewrites.d.ts +0 -41
- package/dist/next/posthogProxyRewrites.js +0 -45
- package/dist/next/posthogProxyRewrites.js.map +0 -1
- package/dist/plugin/paths.js +0 -27
- package/dist/plugin/paths.js.map +0 -1
- package/dist/plugin/responses.js +0 -17
- package/dist/plugin/responses.js.map +0 -1
- package/dist/query/errors.js +0 -10
- package/dist/query/errors.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -21
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -14
- package/dist/tracker/sinks/posthog.d.ts +0 -14
- package/dist/tracker/sinks/umami.d.ts +0 -13
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -74
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -1,19 +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
|
-
*
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
13
|
+
* The site the event belongs to. Required, and stored as given: there is no request behind
|
|
14
|
+
* a server event to attribute it to, so the caller owns the value.
|
|
15
|
+
*/
|
|
16
|
+
hostname: string;
|
|
17
|
+
/**
|
|
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.
|
|
17
20
|
*/
|
|
18
21
|
ip?: string;
|
|
19
22
|
userAgent?: string;
|
|
@@ -21,24 +24,55 @@ type ServerEventInput = Pick<RawEventInput, 'type' | 'name' | 'path' | 'hostname
|
|
|
21
24
|
* Analytics boundary to stamp; null is install-wide. Unset resolves from `opts.req`.
|
|
22
25
|
* Ignored on an unscoped install, and never validated against the scopes that exist.
|
|
23
26
|
*/
|
|
24
|
-
scope?: string | null;
|
|
25
|
-
|
|
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
|
+
*/
|
|
26
37
|
now?: Date;
|
|
27
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';
|
|
28
44
|
interface ServerTrackOptions {
|
|
29
45
|
/** The request the event belongs to: attribution, scope and timezone all come from it. */
|
|
30
46
|
req?: PayloadRequest;
|
|
31
47
|
/**
|
|
32
|
-
*
|
|
33
|
-
*
|
|
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.
|
|
34
55
|
*/
|
|
35
56
|
flush?: boolean;
|
|
36
57
|
}
|
|
37
|
-
|
|
58
|
+
/**
|
|
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`.
|
|
66
|
+
*/
|
|
67
|
+
type IngestHostnameResolver = (args: {
|
|
68
|
+
req: PayloadRequest; /** What the caller believes the host is, never trusted on its own. */
|
|
69
|
+
claimed?: string;
|
|
70
|
+
scope?: string | null;
|
|
71
|
+
}) => Promise<string | null>;
|
|
38
72
|
/** Thrown instead of dropping the event: a server caller can handle a rejected promise. */
|
|
39
73
|
declare class AnalyticsTrackError extends Error {
|
|
40
74
|
constructor(message: string);
|
|
41
75
|
}
|
|
42
76
|
//#endregion
|
|
43
|
-
export { AnalyticsTrackError, ServerEventInput, ServerTrack, ServerTrackOptions };
|
|
77
|
+
export { AnalyticsTrackError, IngestHostnameResolver, ServerEventInput, ServerTrack, ServerTrackIdentity, ServerTrackOptions };
|
|
44
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,10 @@
|
|
|
1
|
+
import { AdapterLabelArgs } from "./contract.js";
|
|
2
|
+
//#region src/core/sourceLabel.d.ts
|
|
3
|
+
/**
|
|
4
|
+
* A built-in adapter's `label` option: one name, a name per admin language (read like
|
|
5
|
+
* `view.navLabel`), or a function naming the source for each reader.
|
|
6
|
+
*/
|
|
7
|
+
type AdapterLabelOption = string | Record<string, string> | ((args: AdapterLabelArgs) => string | Promise<string>);
|
|
8
|
+
//#endregion
|
|
9
|
+
export { AdapterLabelOption };
|
|
10
|
+
//# sourceMappingURL=sourceLabel.d.ts.map
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { isRecord, kindOf } from "./values.js";
|
|
2
|
+
import { pickLabel } from "../translations/labelMap.js";
|
|
3
|
+
//#region src/core/sourceLabel.ts
|
|
4
|
+
const filled = (value) => typeof value === "string" && value.trim() !== "";
|
|
5
|
+
const isLabelMap = (value) => isRecord(value) && !Array.isArray(value) && Object.values(value).every((text) => typeof text === "string");
|
|
6
|
+
/**
|
|
7
|
+
* The label fields a factory spreads into its adapter: `label` for surfaces with no reader (the
|
|
8
|
+
* string, else the map's `en` or first entry, else `vendor`) and `labelFor` per reader. A blank
|
|
9
|
+
* string counts as unset, as `view.navLabel` reads one.
|
|
10
|
+
*/
|
|
11
|
+
const adapterLabel = (option, vendor, owner) => {
|
|
12
|
+
if (option === void 0) return { label: vendor };
|
|
13
|
+
if (typeof option === "string") return { label: filled(option) ? option : vendor };
|
|
14
|
+
if (typeof option === "function") return {
|
|
15
|
+
label: vendor,
|
|
16
|
+
labelFor: option
|
|
17
|
+
};
|
|
18
|
+
if (isLabelMap(option)) {
|
|
19
|
+
const label = pickLabel(option, "en") ?? Object.values(option).find(filled) ?? vendor;
|
|
20
|
+
return {
|
|
21
|
+
label,
|
|
22
|
+
labelFor: ({ req }) => pickLabel(option, req.i18n?.language, req.i18n?.fallbackLanguage) ?? label
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
throw new Error(`analytics: ${owner} must be a label, a map of labels by language such as { en: 'Traffic' }, or a label function, got ${kindOf(option)}`);
|
|
26
|
+
};
|
|
27
|
+
/**
|
|
28
|
+
* A source's name for one reader. A `labelFor` that throws or names nothing reads as `label`, with
|
|
29
|
+
* a warning, so one host function cannot blank a listing.
|
|
30
|
+
*/
|
|
31
|
+
const sourceLabelFor = async (adapter, args) => {
|
|
32
|
+
if (!adapter.labelFor) return adapter.label;
|
|
33
|
+
try {
|
|
34
|
+
const label = await adapter.labelFor(args);
|
|
35
|
+
if (filled(label)) return label;
|
|
36
|
+
args.req.payload.logger?.warn(`analytics: label of source "${adapter.id}" named ${kindOf(label)}, using "${adapter.label}"`);
|
|
37
|
+
} catch (err) {
|
|
38
|
+
args.req.payload.logger?.warn(`analytics: label of source "${adapter.id}" failed, using "${adapter.label}": ${String(err)}`);
|
|
39
|
+
}
|
|
40
|
+
return adapter.label;
|
|
41
|
+
};
|
|
42
|
+
/** A source as this reader is shown it; `configIds` tells an adapter every scope shares. */
|
|
43
|
+
const sourceRefFor = async (adapter, args) => ({
|
|
44
|
+
id: adapter.id,
|
|
45
|
+
label: await sourceLabelFor(adapter, args),
|
|
46
|
+
kind: args.configIds.has(adapter.id) ? "config" : "runtime",
|
|
47
|
+
...args.docId === void 0 ? {} : { docId: args.docId }
|
|
48
|
+
});
|
|
49
|
+
/**
|
|
50
|
+
* The adapter under one fixed name for every reader, as a provider document names its source:
|
|
51
|
+
* a `labelFor` it carried would otherwise rename it per request.
|
|
52
|
+
*/
|
|
53
|
+
const withFixedLabel = (adapter, label) => {
|
|
54
|
+
const { labelFor: _perReader, ...fixed } = adapter;
|
|
55
|
+
return {
|
|
56
|
+
...fixed,
|
|
57
|
+
label
|
|
58
|
+
};
|
|
59
|
+
};
|
|
60
|
+
//#endregion
|
|
61
|
+
export { adapterLabel, sourceLabelFor, sourceRefFor, withFixedLabel };
|
|
62
|
+
|
|
63
|
+
//# sourceMappingURL=sourceLabel.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sourceLabel.js","names":[],"sources":["../../src/core/sourceLabel.ts"],"sourcesContent":["import { pickLabel } from '../translations/labelMap'\nimport type { AdapterLabelArgs, AnalyticsAdapter } from './contract'\nimport type { SourceRef } from './sourcePolicy'\nimport { isRecord, kindOf } from './values'\n\n/**\n * A built-in adapter's `label` option: one name, a name per admin language (read like\n * `view.navLabel`), or a function naming the source for each reader.\n */\nexport type AdapterLabelOption =\n\t| string\n\t| Record<string, string>\n\t| ((args: AdapterLabelArgs) => string | Promise<string>)\n\ntype LabelFields = Pick<AnalyticsAdapter, 'label' | 'labelFor'>\n\nconst filled = (value: unknown): value is string => typeof value === 'string' && value.trim() !== ''\n\nconst isLabelMap = (value: unknown): value is Record<string, string> =>\n\tisRecord(value) &&\n\t!Array.isArray(value) &&\n\tObject.values(value).every((text) => typeof text === 'string')\n\n/**\n * The label fields a factory spreads into its adapter: `label` for surfaces with no reader (the\n * string, else the map's `en` or first entry, else `vendor`) and `labelFor` per reader. A blank\n * string counts as unset, as `view.navLabel` reads one.\n */\nexport const adapterLabel = (\n\toption: AdapterLabelOption | undefined,\n\tvendor: string,\n\towner: string\n): LabelFields => {\n\tif (option === undefined) {\n\t\treturn { label: vendor }\n\t}\n\tif (typeof option === 'string') {\n\t\treturn { label: filled(option) ? option : vendor }\n\t}\n\tif (typeof option === 'function') {\n\t\treturn { label: vendor, labelFor: option }\n\t}\n\tif (isLabelMap(option)) {\n\t\tconst label = pickLabel(option, 'en') ?? Object.values(option).find(filled) ?? vendor\n\t\treturn {\n\t\t\tlabel,\n\t\t\tlabelFor: ({ req }) =>\n\t\t\t\tpickLabel(option, req.i18n?.language, req.i18n?.fallbackLanguage) ?? label,\n\t\t}\n\t}\n\tthrow new Error(\n\t\t`analytics: ${owner} must be a label, a map of labels by language such as { en: 'Traffic' }, or a label function, got ${kindOf(option)}`\n\t)\n}\n\n/**\n * A source's name for one reader. A `labelFor` that throws or names nothing reads as `label`, with\n * a warning, so one host function cannot blank a listing.\n */\nexport const sourceLabelFor = async (\n\tadapter: Pick<AnalyticsAdapter, 'id' | 'label' | 'labelFor'>,\n\targs: AdapterLabelArgs\n): Promise<string> => {\n\tif (!adapter.labelFor) {\n\t\treturn adapter.label\n\t}\n\ttry {\n\t\tconst label: unknown = await adapter.labelFor(args)\n\t\tif (filled(label)) {\n\t\t\treturn label\n\t\t}\n\t\targs.req.payload.logger?.warn(\n\t\t\t`analytics: label of source \"${adapter.id}\" named ${kindOf(label)}, using \"${adapter.label}\"`\n\t\t)\n\t} catch (err) {\n\t\targs.req.payload.logger?.warn(\n\t\t\t`analytics: label of source \"${adapter.id}\" failed, using \"${adapter.label}\": ${String(err)}`\n\t\t)\n\t}\n\treturn adapter.label\n}\n\n/** A source as this reader is shown it; `configIds` tells an adapter every scope shares. */\nexport const sourceRefFor = async (\n\tadapter: AnalyticsAdapter,\n\targs: AdapterLabelArgs & { configIds: ReadonlySet<string>; docId?: string }\n): Promise<SourceRef> => ({\n\tid: adapter.id,\n\tlabel: await sourceLabelFor(adapter, args),\n\tkind: args.configIds.has(adapter.id) ? 'config' : 'runtime',\n\t...(args.docId === undefined ? {} : { docId: args.docId }),\n})\n\n/**\n * The adapter under one fixed name for every reader, as a provider document names its source:\n * a `labelFor` it carried would otherwise rename it per request.\n */\nexport const withFixedLabel = (adapter: AnalyticsAdapter, label: string): AnalyticsAdapter => {\n\tconst { labelFor: _perReader, ...fixed } = adapter\n\treturn { ...fixed, label }\n}\n"],"mappings":";;;AAgBA,MAAM,UAAU,UAAoC,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM;AAElG,MAAM,cAAc,UACnB,SAAS,KAAK,KACd,CAAC,MAAM,QAAQ,KAAK,KACpB,OAAO,OAAO,KAAK,EAAE,OAAO,SAAS,OAAO,SAAS,QAAQ;;;;;;AAO9D,MAAa,gBACZ,QACA,QACA,UACiB;CACjB,IAAI,WAAW,KAAA,GACd,OAAO,EAAE,OAAO,OAAO;CAExB,IAAI,OAAO,WAAW,UACrB,OAAO,EAAE,OAAO,OAAO,MAAM,IAAI,SAAS,OAAO;CAElD,IAAI,OAAO,WAAW,YACrB,OAAO;EAAE,OAAO;EAAQ,UAAU;CAAO;CAE1C,IAAI,WAAW,MAAM,GAAG;EACvB,MAAM,QAAQ,UAAU,QAAQ,IAAI,KAAK,OAAO,OAAO,MAAM,EAAE,KAAK,MAAM,KAAK;EAC/E,OAAO;GACN;GACA,WAAW,EAAE,UACZ,UAAU,QAAQ,IAAI,MAAM,UAAU,IAAI,MAAM,gBAAgB,KAAK;EACvE;CACD;CACA,MAAM,IAAI,MACT,cAAc,MAAM,oGAAoG,OAAO,MAAM,GACtI;AACD;;;;;AAMA,MAAa,iBAAiB,OAC7B,SACA,SACqB;CACrB,IAAI,CAAC,QAAQ,UACZ,OAAO,QAAQ;CAEhB,IAAI;EACH,MAAM,QAAiB,MAAM,QAAQ,SAAS,IAAI;EAClD,IAAI,OAAO,KAAK,GACf,OAAO;EAER,KAAK,IAAI,QAAQ,QAAQ,KACxB,+BAA+B,QAAQ,GAAG,UAAU,OAAO,KAAK,EAAE,WAAW,QAAQ,MAAM,EAC5F;CACD,SAAS,KAAK;EACb,KAAK,IAAI,QAAQ,QAAQ,KACxB,+BAA+B,QAAQ,GAAG,mBAAmB,QAAQ,MAAM,KAAK,OAAO,GAAG,GAC3F;CACD;CACA,OAAO,QAAQ;AAChB;;AAGA,MAAa,eAAe,OAC3B,SACA,UACyB;CACzB,IAAI,QAAQ;CACZ,OAAO,MAAM,eAAe,SAAS,IAAI;CACzC,MAAM,KAAK,UAAU,IAAI,QAAQ,EAAE,IAAI,WAAW;CAClD,GAAI,KAAK,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM;AACzD;;;;;AAMA,MAAa,kBAAkB,SAA2B,UAAoC;CAC7F,MAAM,EAAE,UAAU,YAAY,GAAG,UAAU;CAC3C,OAAO;EAAE,GAAG;EAAO;CAAM;AAC1B"}
|
|
@@ -0,0 +1,107 @@
|
|
|
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 { PROVIDER_IDS } from "../providers/factory.js";
|
|
6
|
+
import { PROVIDERS_SLUG, connectionFieldAccess, servedProviderTypes } from "../providers/collection.js";
|
|
7
|
+
//#region src/core/sourceOptions.ts
|
|
8
|
+
const PROVIDERS_KEYS = keysOf({
|
|
9
|
+
collection: true,
|
|
10
|
+
resolve: true,
|
|
11
|
+
hosts: true
|
|
12
|
+
});
|
|
13
|
+
const PROVIDERS_COLLECTION_KEYS = keysOf({
|
|
14
|
+
slug: true,
|
|
15
|
+
scopeField: true,
|
|
16
|
+
fields: true,
|
|
17
|
+
overrides: true,
|
|
18
|
+
access: true,
|
|
19
|
+
encryption: true,
|
|
20
|
+
connectionAccess: true,
|
|
21
|
+
defaultAccess: true,
|
|
22
|
+
types: true,
|
|
23
|
+
sourceAccess: true
|
|
24
|
+
});
|
|
25
|
+
const PROVIDER_FIELD_KEYS = keysOf({
|
|
26
|
+
name: true,
|
|
27
|
+
provider: true,
|
|
28
|
+
enabled: true,
|
|
29
|
+
isDefault: true,
|
|
30
|
+
withoutConsent: true
|
|
31
|
+
});
|
|
32
|
+
const ENCRYPTION_KEYS = keysOf({ keys: true });
|
|
33
|
+
const isAdapterShaped = (value) => isRecord(value) && typeof value.id === "string" && value.id !== "" && typeof value.isConfigured === "function" && typeof value.query === "function" && isRecord(value.capabilities);
|
|
34
|
+
/** `adapters`: a list of adapters with an id each, no two sharing one. */
|
|
35
|
+
const assertAdapters = (value) => {
|
|
36
|
+
const ids = /* @__PURE__ */ new Set();
|
|
37
|
+
for (const [index, adapter] of optionalList(value, "adapters", "[native()]").entries()) {
|
|
38
|
+
if (!isAdapterShaped(adapter)) throw new Error(`analytics: adapters[${index}] must be an adapter such as native() or plausible({ siteId, apiKey }), got ${kindOf(adapter)}`);
|
|
39
|
+
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`);
|
|
40
|
+
ids.add(adapter.id);
|
|
41
|
+
}
|
|
42
|
+
};
|
|
43
|
+
/** An option naming one of `adapters` by its id. */
|
|
44
|
+
const assertNamesAdapter = (value, path, adapters) => {
|
|
45
|
+
if (value === void 0) return;
|
|
46
|
+
if (typeof value !== "string") throw new Error(`analytics: ${path} must be the id of an adapter in adapters, got ${kindOf(value)}`);
|
|
47
|
+
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}"`))}`);
|
|
48
|
+
};
|
|
49
|
+
/** `providers.collection.encryption`: a dedicated key ring, or nothing. */
|
|
50
|
+
const assertEncryption = (value) => {
|
|
51
|
+
if (value === void 0) return;
|
|
52
|
+
const { keys } = optionsObject(value, {
|
|
53
|
+
path: "providers.collection.encryption",
|
|
54
|
+
known: ENCRYPTION_KEYS,
|
|
55
|
+
example: "an object such as { keys }"
|
|
56
|
+
});
|
|
57
|
+
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)}`);
|
|
58
|
+
};
|
|
59
|
+
/** A `native` document lends the config native(), so the type is served only beside one. */
|
|
60
|
+
const availableTypes = (adapters) => PROVIDER_IDS.filter((type) => type !== "native" || adapters.some((a) => a.id === "native"));
|
|
61
|
+
/** `providers.collection` turned on, with what only that collection takes. */
|
|
62
|
+
const resolveProvidersCollection = (option, available) => {
|
|
63
|
+
const collection = resolveScopedCollection(option, {
|
|
64
|
+
path: "providers.collection",
|
|
65
|
+
fallback: PROVIDERS_SLUG,
|
|
66
|
+
known: PROVIDERS_COLLECTION_KEYS,
|
|
67
|
+
fieldKeys: PROVIDER_FIELD_KEYS,
|
|
68
|
+
exampleSlug: "providers"
|
|
69
|
+
});
|
|
70
|
+
if (option === void 0 || typeof option === "boolean") return {
|
|
71
|
+
...collection,
|
|
72
|
+
types: available
|
|
73
|
+
};
|
|
74
|
+
assertEncryption(option.encryption);
|
|
75
|
+
const connectionAccess = connectionFieldAccess("providers.collection.connectionAccess", option.connectionAccess);
|
|
76
|
+
const defaultAccess = connectionFieldAccess("providers.collection.defaultAccess", option.defaultAccess);
|
|
77
|
+
const sourceAccess = optionalFunction(option.sourceAccess, "providers.collection.sourceAccess");
|
|
78
|
+
return {
|
|
79
|
+
...collection,
|
|
80
|
+
types: servedProviderTypes("providers.collection.types", option.types, available),
|
|
81
|
+
...option.encryption ? { encryption: option.encryption } : {},
|
|
82
|
+
...connectionAccess ? { connectionAccess } : {},
|
|
83
|
+
...defaultAccess ? { defaultAccess } : {},
|
|
84
|
+
...sourceAccess ? { sourceAccess } : {}
|
|
85
|
+
};
|
|
86
|
+
};
|
|
87
|
+
/** `providers`: the collection or `resolve` (never both), and the hosts either may reach. */
|
|
88
|
+
const resolveProviders = (option, adapters) => {
|
|
89
|
+
if (option !== void 0) optionsObject(option, {
|
|
90
|
+
path: "providers",
|
|
91
|
+
known: PROVIDERS_KEYS,
|
|
92
|
+
example: "an object such as { collection: true }"
|
|
93
|
+
});
|
|
94
|
+
const resolve = optionalFunction(option?.resolve, "providers.resolve");
|
|
95
|
+
const collection = resolveProvidersCollection(option?.collection, availableTypes(adapters));
|
|
96
|
+
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.");
|
|
97
|
+
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.");
|
|
98
|
+
return {
|
|
99
|
+
collection,
|
|
100
|
+
...resolve ? { resolve } : {},
|
|
101
|
+
hosts: resolveHostPolicy(option?.hosts)
|
|
102
|
+
};
|
|
103
|
+
};
|
|
104
|
+
//#endregion
|
|
105
|
+
export { assertAdapters, assertNamesAdapter, resolveProviders };
|
|
106
|
+
|
|
107
|
+
//# 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\tservedProviderTypes,\n} from '../providers/collection'\nimport { PROVIDER_IDS, type ProviderId } from '../providers/factory'\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\tdefaultAccess: true,\n\ttypes: true,\n\tsourceAccess: true,\n})\nconst PROVIDER_FIELD_KEYS = keysOf<ProviderCollectionFieldOverrides>({\n\tname: true,\n\tprovider: true,\n\tenabled: true,\n\tisDefault: true,\n\twithoutConsent: 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/** A `native` document lends the config native(), so the type is served only beside one. */\nconst availableTypes = (adapters: readonly { id: string }[]): ProviderId[] =>\n\tPROVIDER_IDS.filter((type) => type !== 'native' || adapters.some((a) => a.id === 'native'))\n\n/** `providers.collection` turned on, with what only that collection takes. */\nconst resolveProvidersCollection = (\n\toption: ProvidersOptions['collection'],\n\tavailable: readonly ProviderId[]\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, types: available }\n\t}\n\tassertEncryption(option.encryption)\n\tconst connectionAccess = connectionFieldAccess(\n\t\t'providers.collection.connectionAccess',\n\t\toption.connectionAccess\n\t)\n\tconst defaultAccess = connectionFieldAccess(\n\t\t'providers.collection.defaultAccess',\n\t\toption.defaultAccess\n\t)\n\tconst sourceAccess = optionalFunction(option.sourceAccess, 'providers.collection.sourceAccess')\n\treturn {\n\t\t...collection,\n\t\ttypes: servedProviderTypes('providers.collection.types', option.types, available),\n\t\t...(option.encryption ? { encryption: option.encryption } : {}),\n\t\t...(connectionAccess ? { connectionAccess } : {}),\n\t\t...(defaultAccess ? { defaultAccess } : {}),\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\tadapters: readonly { id: string }[]\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, availableTypes(adapters))\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":";;;;;;;AAaA,MAAM,iBAAiB,OAAyB;CAAE,YAAY;CAAM,SAAS;CAAM,OAAO;AAAK,CAAC;AAChG,MAAM,4BAA4B,OAAmC;CACpE,MAAM;CACN,YAAY;CACZ,QAAQ;CACR,WAAW;CACX,QAAQ;CACR,YAAY;CACZ,kBAAkB;CAClB,eAAe;CACf,OAAO;CACP,cAAc;AACf,CAAC;AACD,MAAM,sBAAsB,OAAyC;CACpE,MAAM;CACN,UAAU;CACV,SAAS;CACT,WAAW;CACX,gBAAgB;AACjB,CAAC;AACD,MAAM,kBAAkB,OAA8D,EACrF,MAAM,KACP,CAAC;AAED,MAAM,mBAAmB,UACxB,SAAS,KAAK,KACd,OAAO,MAAM,OAAO,YACpB,MAAM,OAAO,MACb,OAAO,MAAM,iBAAiB,cAC9B,OAAO,MAAM,UAAU,cACvB,SAAS,MAAM,YAAY;;AAG5B,MAAa,kBAAkB,UAAyB;CACvD,MAAM,sBAAM,IAAI,IAAY;CAC5B,KAAK,MAAM,CAAC,OAAO,YAAY,aAAa,OAAO,YAAY,YAAY,EAAE,QAAQ,GAAG;EACvF,IAAI,CAAC,gBAAgB,OAAO,GAC3B,MAAM,IAAI,MACT,uBAAuB,MAAM,8EAA8E,OAAO,OAAO,GAC1H;EAED,IAAI,IAAI,IAAI,QAAQ,EAAE,GACrB,MAAM,IAAI,MACT,uDAAuD,QAAQ,GAAG,wDACnE;EAED,IAAI,IAAI,QAAQ,EAAE;CACnB;AACD;;AAGA,MAAa,sBACZ,OACA,MACA,aACU;CACV,IAAI,UAAU,KAAA,GACb;CAED,IAAI,OAAO,UAAU,UACpB,MAAM,IAAI,MACT,cAAc,KAAK,iDAAiD,OAAO,KAAK,GACjF;CAED,IAAI,CAAC,SAAS,MAAM,YAAY,QAAQ,OAAO,KAAK,GACnD,MAAM,IAAI,MACT,cAAc,KAAK,IAAI,MAAM,gDAAgD,OAAO,SAAS,KAAK,YAAY,IAAI,QAAQ,GAAG,EAAE,CAAC,GACjI;AAEF;;AAGA,MAAM,oBAAoB,UAAyB;CAClD,IAAI,UAAU,KAAA,GACb;CAED,MAAM,EAAE,SAAS,cAAc,OAAO;EACrC,MAAM;EACN,OAAO;EACP,SAAS;CACV,CAAC;CACD,IACC,SAAS,KAAA,MACR,CAAC,SAAS,IAAI,KAAK,OAAO,KAAK,WAAW,YAAY,CAAC,SAAS,KAAK,IAAI,IAE1E,MAAM,IAAI,MACT,2IAA2I,OAAO,IAAI,GACvJ;AAEF;;AAGA,MAAM,kBAAkB,aACvB,aAAa,QAAQ,SAAS,SAAS,YAAY,SAAS,MAAM,MAAM,EAAE,OAAO,QAAQ,CAAC;;AAG3F,MAAM,8BACL,QACA,cACgD;CAChD,MAAM,aAAa,wBAAwB,QAAQ;EAClD,MAAM;EACN,UAAU;EACV,OAAO;EACP,WAAW;EACX,aAAa;CACd,CAAC;CACD,IAAI,WAAW,KAAA,KAAa,OAAO,WAAW,WAC7C,OAAO;EAAE,GAAG;EAAY,OAAO;CAAU;CAE1C,iBAAiB,OAAO,UAAU;CAClC,MAAM,mBAAmB,sBACxB,yCACA,OAAO,gBACR;CACA,MAAM,gBAAgB,sBACrB,sCACA,OAAO,aACR;CACA,MAAM,eAAe,iBAAiB,OAAO,cAAc,mCAAmC;CAC9F,OAAO;EACN,GAAG;EACH,OAAO,oBAAoB,8BAA8B,OAAO,OAAO,SAAS;EAChF,GAAI,OAAO,aAAa,EAAE,YAAY,OAAO,WAAW,IAAI,CAAC;EAC7D,GAAI,mBAAmB,EAAE,iBAAiB,IAAI,CAAC;EAC/C,GAAI,gBAAgB,EAAE,cAAc,IAAI,CAAC;EACzC,GAAI,eAAe,EAAE,aAAa,IAAI,CAAC;CACxC;AACD;;AAGA,MAAa,oBACZ,QACA,aACkC;CAClC,IAAI,WAAW,KAAA,GACd,cAAc,QAAQ;EACrB,MAAM;EACN,OAAO;EACP,SAAS;CACV,CAAC;CAEF,MAAM,UAAU,iBAAiB,QAAQ,SAAS,mBAAmB;CACrE,MAAM,aAAa,2BAA2B,QAAQ,YAAY,eAAe,QAAQ,CAAC;CAC1F,IAAI,WAAW,WAAW,SACzB,MAAM,IAAI,MACT,qSACD;CAED,IAAI,QAAQ,UAAU,KAAA,KAAa,CAAC,WAAW,WAAW,CAAC,SAC1D,MAAM,IAAI,MACT,sJACD;CAED,OAAO;EACN;EACA,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;EAC7B,OAAO,kBAAkB,QAAQ,KAAK;CACvC;AACD"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { PayloadRequest } from "payload";
|
|
2
|
+
|
|
3
|
+
//#region src/core/sourcePolicy.d.ts
|
|
4
|
+
/** A source one scope reads through, as `defaultSource` is shown it. */
|
|
5
|
+
interface SourceRef {
|
|
6
|
+
id: string;
|
|
7
|
+
label: string;
|
|
8
|
+
/** `config` for an adapter every scope shares, `runtime` for one resolved per scope. */
|
|
9
|
+
kind: 'config' | 'runtime';
|
|
10
|
+
/** The provider document granting it to the scope; absent for a shared adapter none grants. */
|
|
11
|
+
docId?: string;
|
|
12
|
+
}
|
|
13
|
+
/** A source the reader reads a scope through by one of that scope's own provider documents. */
|
|
14
|
+
interface OwnSource {
|
|
15
|
+
id: string;
|
|
16
|
+
label: string;
|
|
17
|
+
docId: string;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Decides whether a member of `scope` reads it through the shared adapter `adapterId`. Asked at
|
|
21
|
+
* most once per request, scope and adapter; a throw counts as no.
|
|
22
|
+
*/
|
|
23
|
+
type SourcePolicyFunction = (args: {
|
|
24
|
+
req: PayloadRequest;
|
|
25
|
+
scope: string;
|
|
26
|
+
adapterId: string; /** Sources the reader already reads the scope through by its own provider documents. */
|
|
27
|
+
ownSources: OwnSource[];
|
|
28
|
+
}) => boolean | Promise<boolean>;
|
|
29
|
+
/**
|
|
30
|
+
* Who besides `access.crossScope.unscopedSource` reads a tenant through a shared adapter: `staff`
|
|
31
|
+
* nobody else, `tenant` the scope's members, `fallback` its members until they have a source of their own.
|
|
32
|
+
*/
|
|
33
|
+
type SourcePolicy = 'staff' | 'tenant' | 'fallback' | SourcePolicyFunction;
|
|
34
|
+
/** How tenants reach one shared config adapter. */
|
|
35
|
+
interface AnalyticsSourceOptions {
|
|
36
|
+
/**
|
|
37
|
+
* Which of a tenant's own users read it, narrowed to their tenant. Default `staff`. Anything else
|
|
38
|
+
* needs an adapter that narrows a query to one scope (`capabilities.scopedQueries`).
|
|
39
|
+
*/
|
|
40
|
+
tenants?: SourcePolicy;
|
|
41
|
+
}
|
|
42
|
+
/** Picks a tenant scope's default source by id; an id it cannot read leaves the default alone. */
|
|
43
|
+
type DefaultSourceFunction = (args: {
|
|
44
|
+
req: PayloadRequest;
|
|
45
|
+
scope: string;
|
|
46
|
+
sources: SourceRef[];
|
|
47
|
+
}) => string | undefined | Promise<string | undefined>;
|
|
48
|
+
/**
|
|
49
|
+
* A tenant scope's default source when no provider document of it is flagged the default:
|
|
50
|
+
* `tenantFirst` its own first, `platformFirst` the `platformAdapter`, or a function.
|
|
51
|
+
*/
|
|
52
|
+
type DefaultSourceRule = 'tenantFirst' | 'platformFirst' | DefaultSourceFunction;
|
|
53
|
+
//#endregion
|
|
54
|
+
export { AnalyticsSourceOptions, DefaultSourceFunction, DefaultSourceRule, OwnSource, SourcePolicy, SourcePolicyFunction, SourceRef };
|
|
55
|
+
//# sourceMappingURL=sourcePolicy.d.ts.map
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { isRecord, kindOf, listOf } from "./values.js";
|
|
2
|
+
import { keysOf, optionsObject } from "./optionChecks.js";
|
|
3
|
+
//#region src/core/sourcePolicy.ts
|
|
4
|
+
const SOURCE_KEYS = keysOf({ tenants: true });
|
|
5
|
+
const POLICY_NAMES = [
|
|
6
|
+
"staff",
|
|
7
|
+
"tenant",
|
|
8
|
+
"fallback"
|
|
9
|
+
];
|
|
10
|
+
const DEFAULT_RULES = ["tenantFirst", "platformFirst"];
|
|
11
|
+
const isPolicy = (value) => typeof value === "function" || typeof value === "string" && POLICY_NAMES.includes(value);
|
|
12
|
+
const isDefaultRule = (value) => typeof value === "function" || typeof value === "string" && DEFAULT_RULES.includes(value);
|
|
13
|
+
const resolvePolicy = (id, entry, adapter) => {
|
|
14
|
+
const { tenants } = optionsObject(entry, {
|
|
15
|
+
path: `sources.${id}`,
|
|
16
|
+
known: SOURCE_KEYS,
|
|
17
|
+
example: "an object such as { tenants: 'fallback' }"
|
|
18
|
+
});
|
|
19
|
+
if (tenants === void 0) return;
|
|
20
|
+
if (!isPolicy(tenants)) throw new Error(`analytics: sources.${id}.tenants must be 'staff', 'tenant', 'fallback' or a function, got ${kindOf(tenants)}`);
|
|
21
|
+
if (tenants === "staff") return;
|
|
22
|
+
if (adapter.capabilities.scopedQueries !== true) throw new Error(`analytics: sources.${id}.tenants lets a tenant's own users read through the "${id}" adapter, which cannot narrow a query to one scope (it lacks capabilities.scopedQueries), so a tenant would read every tenant's totals. Leave it 'staff', or give it to an adapter that supports scoped queries.`);
|
|
23
|
+
return tenants;
|
|
24
|
+
};
|
|
25
|
+
/**
|
|
26
|
+
* `sources` and `defaultSource`. A switched-off plugin given no adapters has nothing to check
|
|
27
|
+
* the keys against, and reads through nothing anyway.
|
|
28
|
+
*/
|
|
29
|
+
const resolveSources = (options) => {
|
|
30
|
+
const { sources, defaultSource } = options;
|
|
31
|
+
if (defaultSource !== void 0 && !isDefaultRule(defaultSource)) throw new Error(`analytics: defaultSource must be 'tenantFirst', 'platformFirst' or a function, got ${kindOf(defaultSource)}`);
|
|
32
|
+
if (defaultSource === "platformFirst" && options.platformAdapter === void 0) throw new Error("analytics: defaultSource 'platformFirst' opens each tenant on the platformAdapter, which is not set; set platformAdapter or pick another rule");
|
|
33
|
+
const policies = /* @__PURE__ */ new Map();
|
|
34
|
+
if (sources !== void 0 && (!isRecord(sources) || Array.isArray(sources))) throw new Error(`analytics: sources must be an object keyed by adapter id, such as { posthog: { tenants: 'fallback' } }, got ${kindOf(sources)}`);
|
|
35
|
+
const adapters = options.adapters ?? [];
|
|
36
|
+
if (adapters.length > 0) for (const [id, entry] of Object.entries(sources ?? {})) {
|
|
37
|
+
if (entry === void 0) continue;
|
|
38
|
+
const adapter = adapters.find((candidate) => candidate.id === id);
|
|
39
|
+
if (!adapter) throw new Error(`analytics: sources.${id} names no adapter in adapters, whose ids are ${listOf(adapters.map((known) => `"${known.id}"`))}; sources is keyed by the id of a config adapter`);
|
|
40
|
+
const policy = resolvePolicy(id, entry, adapter);
|
|
41
|
+
if (policy !== void 0) policies.set(id, policy);
|
|
42
|
+
}
|
|
43
|
+
return {
|
|
44
|
+
policies,
|
|
45
|
+
...defaultSource === void 0 ? {} : { defaultSource }
|
|
46
|
+
};
|
|
47
|
+
};
|
|
48
|
+
//#endregion
|
|
49
|
+
export { resolveSources };
|
|
50
|
+
|
|
51
|
+
//# sourceMappingURL=sourcePolicy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sourcePolicy.js","names":[],"sources":["../../src/core/sourcePolicy.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { AnalyticsAdapter } from './contract'\nimport { keysOf, optionsObject } from './optionChecks'\nimport { isRecord, kindOf, listOf } from './values'\n\n/** A source one scope reads through, as `defaultSource` is shown it. */\nexport interface SourceRef {\n\tid: string\n\tlabel: string\n\t/** `config` for an adapter every scope shares, `runtime` for one resolved per scope. */\n\tkind: 'config' | 'runtime'\n\t/** The provider document granting it to the scope; absent for a shared adapter none grants. */\n\tdocId?: string\n}\n\n/** A source the reader reads a scope through by one of that scope's own provider documents. */\nexport interface OwnSource {\n\tid: string\n\tlabel: string\n\tdocId: string\n}\n\n/**\n * Decides whether a member of `scope` reads it through the shared adapter `adapterId`. Asked at\n * most once per request, scope and adapter; a throw counts as no.\n */\nexport type SourcePolicyFunction = (args: {\n\treq: PayloadRequest\n\tscope: string\n\tadapterId: string\n\t/** Sources the reader already reads the scope through by its own provider documents. */\n\townSources: OwnSource[]\n}) => boolean | Promise<boolean>\n\n/**\n * Who besides `access.crossScope.unscopedSource` reads a tenant through a shared adapter: `staff`\n * nobody else, `tenant` the scope's members, `fallback` its members until they have a source of their own.\n */\nexport type SourcePolicy = 'staff' | 'tenant' | 'fallback' | SourcePolicyFunction\n\n/** How tenants reach one shared config adapter. */\nexport interface AnalyticsSourceOptions {\n\t/**\n\t * Which of a tenant's own users read it, narrowed to their tenant. Default `staff`. Anything else\n\t * needs an adapter that narrows a query to one scope (`capabilities.scopedQueries`).\n\t */\n\ttenants?: SourcePolicy\n}\n\n/** Picks a tenant scope's default source by id; an id it cannot read leaves the default alone. */\nexport type DefaultSourceFunction = (args: {\n\treq: PayloadRequest\n\tscope: string\n\tsources: SourceRef[]\n}) => string | undefined | Promise<string | undefined>\n\n/**\n * A tenant scope's default source when no provider document of it is flagged the default:\n * `tenantFirst` its own first, `platformFirst` the `platformAdapter`, or a function.\n */\nexport type DefaultSourceRule = 'tenantFirst' | 'platformFirst' | DefaultSourceFunction\n\n/** `sources` and `defaultSource`, checked against the adapters they name. */\nexport interface ResolvedSources {\n\t/** Each config adapter whose tenants read under a policy other than `staff`. */\n\tpolicies: ReadonlyMap<string, Exclude<SourcePolicy, 'staff'>>\n\tdefaultSource?: DefaultSourceRule\n}\n\nconst SOURCE_KEYS = keysOf<AnalyticsSourceOptions>({ tenants: true })\nconst POLICY_NAMES: readonly string[] = ['staff', 'tenant', 'fallback']\nconst DEFAULT_RULES: readonly string[] = ['tenantFirst', 'platformFirst']\n\nconst isPolicy = (value: unknown): value is SourcePolicy =>\n\ttypeof value === 'function' || (typeof value === 'string' && POLICY_NAMES.includes(value))\n\nconst isDefaultRule = (value: unknown): value is DefaultSourceRule =>\n\ttypeof value === 'function' || (typeof value === 'string' && DEFAULT_RULES.includes(value))\n\nconst resolvePolicy = (\n\tid: string,\n\tentry: unknown,\n\tadapter: AnalyticsAdapter\n): Exclude<SourcePolicy, 'staff'> | undefined => {\n\tconst { tenants } = optionsObject(entry, {\n\t\tpath: `sources.${id}`,\n\t\tknown: SOURCE_KEYS,\n\t\texample: \"an object such as { tenants: 'fallback' }\",\n\t})\n\tif (tenants === undefined) {\n\t\treturn undefined\n\t}\n\tif (!isPolicy(tenants)) {\n\t\tthrow new Error(\n\t\t\t`analytics: sources.${id}.tenants must be 'staff', 'tenant', 'fallback' or a function, got ${kindOf(tenants)}`\n\t\t)\n\t}\n\tif (tenants === 'staff') {\n\t\treturn undefined\n\t}\n\tif (adapter.capabilities.scopedQueries !== true) {\n\t\tthrow new Error(\n\t\t\t`analytics: sources.${id}.tenants lets a tenant's own users read through the \"${id}\" adapter, which cannot narrow a query to one scope (it lacks capabilities.scopedQueries), so a tenant would read every tenant's totals. Leave it 'staff', or give it to an adapter that supports scoped queries.`\n\t\t)\n\t}\n\treturn tenants\n}\n\n/**\n * `sources` and `defaultSource`. A switched-off plugin given no adapters has nothing to check\n * the keys against, and reads through nothing anyway.\n */\nexport const resolveSources = (options: {\n\tadapters?: readonly AnalyticsAdapter[]\n\tplatformAdapter?: string\n\tsources?: unknown\n\tdefaultSource?: unknown\n}): ResolvedSources => {\n\tconst { sources, defaultSource } = options\n\tif (defaultSource !== undefined && !isDefaultRule(defaultSource)) {\n\t\tthrow new Error(\n\t\t\t`analytics: defaultSource must be 'tenantFirst', 'platformFirst' or a function, got ${kindOf(defaultSource)}`\n\t\t)\n\t}\n\tif (defaultSource === 'platformFirst' && options.platformAdapter === undefined) {\n\t\tthrow new Error(\n\t\t\t\"analytics: defaultSource 'platformFirst' opens each tenant on the platformAdapter, which is not set; set platformAdapter or pick another rule\"\n\t\t)\n\t}\n\tconst policies = new Map<string, Exclude<SourcePolicy, 'staff'>>()\n\tif (sources !== undefined && (!isRecord(sources) || Array.isArray(sources))) {\n\t\tthrow new Error(\n\t\t\t`analytics: sources must be an object keyed by adapter id, such as { posthog: { tenants: 'fallback' } }, got ${kindOf(sources)}`\n\t\t)\n\t}\n\tconst adapters = options.adapters ?? []\n\tif (adapters.length > 0) {\n\t\tfor (const [id, entry] of Object.entries(sources ?? {})) {\n\t\t\tif (entry === undefined) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst adapter = adapters.find((candidate) => candidate.id === id)\n\t\t\tif (!adapter) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`analytics: sources.${id} names no adapter in adapters, whose ids are ${listOf(adapters.map((known) => `\"${known.id}\"`))}; sources is keyed by the id of a config adapter`\n\t\t\t\t)\n\t\t\t}\n\t\t\tconst policy = resolvePolicy(id, entry, adapter)\n\t\t\tif (policy !== undefined) {\n\t\t\t\tpolicies.set(id, policy)\n\t\t\t}\n\t\t}\n\t}\n\treturn { policies, ...(defaultSource === undefined ? {} : { defaultSource }) }\n}\n"],"mappings":";;;AAqEA,MAAM,cAAc,OAA+B,EAAE,SAAS,KAAK,CAAC;AACpE,MAAM,eAAkC;CAAC;CAAS;CAAU;AAAU;AACtE,MAAM,gBAAmC,CAAC,eAAe,eAAe;AAExE,MAAM,YAAY,UACjB,OAAO,UAAU,cAAe,OAAO,UAAU,YAAY,aAAa,SAAS,KAAK;AAEzF,MAAM,iBAAiB,UACtB,OAAO,UAAU,cAAe,OAAO,UAAU,YAAY,cAAc,SAAS,KAAK;AAE1F,MAAM,iBACL,IACA,OACA,YACgD;CAChD,MAAM,EAAE,YAAY,cAAc,OAAO;EACxC,MAAM,WAAW;EACjB,OAAO;EACP,SAAS;CACV,CAAC;CACD,IAAI,YAAY,KAAA,GACf;CAED,IAAI,CAAC,SAAS,OAAO,GACpB,MAAM,IAAI,MACT,sBAAsB,GAAG,oEAAoE,OAAO,OAAO,GAC5G;CAED,IAAI,YAAY,SACf;CAED,IAAI,QAAQ,aAAa,kBAAkB,MAC1C,MAAM,IAAI,MACT,sBAAsB,GAAG,uDAAuD,GAAG,kNACpF;CAED,OAAO;AACR;;;;;AAMA,MAAa,kBAAkB,YAKR;CACtB,MAAM,EAAE,SAAS,kBAAkB;CACnC,IAAI,kBAAkB,KAAA,KAAa,CAAC,cAAc,aAAa,GAC9D,MAAM,IAAI,MACT,sFAAsF,OAAO,aAAa,GAC3G;CAED,IAAI,kBAAkB,mBAAmB,QAAQ,oBAAoB,KAAA,GACpE,MAAM,IAAI,MACT,+IACD;CAED,MAAM,2BAAW,IAAI,IAA4C;CACjE,IAAI,YAAY,KAAA,MAAc,CAAC,SAAS,OAAO,KAAK,MAAM,QAAQ,OAAO,IACxE,MAAM,IAAI,MACT,+GAA+G,OAAO,OAAO,GAC9H;CAED,MAAM,WAAW,QAAQ,YAAY,CAAC;CACtC,IAAI,SAAS,SAAS,GACrB,KAAK,MAAM,CAAC,IAAI,UAAU,OAAO,QAAQ,WAAW,CAAC,CAAC,GAAG;EACxD,IAAI,UAAU,KAAA,GACb;EAED,MAAM,UAAU,SAAS,MAAM,cAAc,UAAU,OAAO,EAAE;EAChE,IAAI,CAAC,SACJ,MAAM,IAAI,MACT,sBAAsB,GAAG,+CAA+C,OAAO,SAAS,KAAK,UAAU,IAAI,MAAM,GAAG,EAAE,CAAC,EAAE,iDAC1H;EAED,MAAM,SAAS,cAAc,IAAI,OAAO,OAAO;EAC/C,IAAI,WAAW,KAAA,GACd,SAAS,IAAI,IAAI,MAAM;CAEzB;CAED,OAAO;EAAE;EAAU,GAAI,kBAAkB,KAAA,IAAY,CAAC,IAAI,EAAE,cAAc;CAAG;AAC9E"}
|