@10x-media/analytics 1.0.0-beta.11 → 1.0.0-beta.13
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 +530 -0
- package/README.md +30 -37
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +7 -9
- package/dist/adapters/ga4/disableKey.js.map +1 -1
- package/dist/adapters/ga4/eventName.d.ts +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +17 -0
- package/dist/adapters/ga4/ga4.js +208 -124
- 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 +19 -13
- package/dist/adapters/plausible/plausible.js +139 -123
- 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 +26 -9
- package/dist/adapters/posthog/posthog.js +194 -115
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +13 -9
- package/dist/adapters/umami/umami.js +186 -173
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +16 -29
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +48 -95
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +108 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/charts/BarList.d.ts +27 -14
- package/dist/charts/BarList.js +38 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +15 -1
- package/dist/charts/bars.js +12 -12
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +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 -37
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +28 -25
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +258 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +104 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +297 -59
- package/dist/core/contract.js +6 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +505 -157
- package/dist/core/options.js +158 -219
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +114 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +330 -71
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +38 -20
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/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 +106 -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 +27 -2
- package/dist/exports/adapters/native.js +4 -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 -13
- package/dist/exports/client.js +22 -9
- package/dist/exports/geo.d.ts +3 -1
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/next.d.ts +19 -1
- package/dist/exports/next.js +3 -1
- package/dist/exports/react.d.ts +3 -2
- package/dist/exports/react.js +1 -2
- package/dist/exports/rsc.d.ts +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 +5 -20
- package/dist/exports/tracker.js +3 -14
- package/dist/exports/types.d.ts +44 -14
- package/dist/exports/types.js +5 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +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 -27
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +31 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +66 -37
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +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 +162 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +139 -125
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -26
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +39 -40
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +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 -27
- package/dist/goals/trackGoalAction.js +38 -52
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +67 -12
- package/dist/index.js +258 -247
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +81 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.d.ts +1 -0
- package/dist/maintenance/taskSchedule.js +62 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +102 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +29 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1623 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +198 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +108 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +4 -1
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +20 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +2 -3
- package/dist/native/ingest/bots.js +8 -13
- package/dist/native/ingest/bots.js.map +1 -1
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +30 -9
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +119 -34
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +60 -7
- package/dist/native/ingest/normalizeEvent.js +226 -61
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +10 -23
- package/dist/native/ingest/requestHost.js.map +1 -1
- package/dist/native/ingest/resolveHostname.d.ts +4 -13
- package/dist/native/ingest/resolveHostname.js +5 -6
- package/dist/native/ingest/resolveHostname.js.map +1 -1
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +82 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +181 -72
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +2 -3
- package/dist/native/ingest/source.js +35 -54
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +20 -10
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +107 -33
- package/dist/native/nativeAdapter.js +376 -317
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +116 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +63 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +430 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +695 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +95 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +384 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +345 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +48 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +656 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +9 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +68 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +4 -24
- package/dist/next/captureRewrites.js +6 -50
- package/dist/next/captureRewrites.js.map +1 -1
- package/dist/next/captureRoute.d.ts +28 -0
- package/dist/next/captureRoute.js +67 -0
- package/dist/next/captureRoute.js.map +1 -0
- package/dist/next/ingestRoute.d.ts +17 -0
- package/dist/next/ingestRoute.js +17 -0
- package/dist/next/ingestRoute.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +3 -25
- package/dist/next/posthogProxyRewrites.js +5 -37
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +339 -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 +77 -53
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +5 -12
- package/dist/plugin/errors.js +23 -16
- package/dist/plugin/errors.js.map +1 -1
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/jobsAccess.js +91 -0
- package/dist/plugin/jobsAccess.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +161 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +70 -45
- 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 +70 -25
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +64 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +77 -25
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +69 -44
- package/dist/plugin/refreshEndpoint.js.map +1 -1
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +234 -30
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +63 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +6 -5
- package/dist/plugin/scopeChange.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +50 -17
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +22 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/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 +61 -0
- package/dist/providers/collection.js +340 -151
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +76 -0
- package/dist/providers/factory.js +75 -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 +328 -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 +1 -5
- package/dist/query/fetchQuery.d.ts +25 -32
- package/dist/query/fetchQuery.js +91 -91
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +6 -0
- package/dist/query/parse.js +153 -106
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +26 -17
- package/dist/react/AnalyticsProvider.js +23 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -11
- package/dist/react/useAnalytics.js +22 -24
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/site/AnalyticsScripts.d.ts +34 -0
- package/dist/site/AnalyticsScripts.js +30 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +40 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +69 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -72
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.js +70 -26
- package/dist/surfacing/epoch.js.map +1 -1
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +113 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +28 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +226 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +149 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +4 -10
- package/dist/tracker/createTracker.js +386 -115
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +2 -22
- package/dist/tracker/exclusion.js +53 -21
- package/dist/tracker/exclusion.js.map +1 -1
- package/dist/tracker/gate.js +194 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +21 -14
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +118 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +41 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +64 -20
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +7 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +27 -22
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +54 -22
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +14 -12
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +30 -27
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +86 -63
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +232 -71
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +221 -69
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +215 -67
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +223 -68
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +227 -72
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +218 -67
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +191 -14
- package/dist/translations/keys.js +196 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +220 -69
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +232 -77
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +223 -66
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +223 -66
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +218 -67
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +112 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1533 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +26 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/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 +11 -6
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +8 -10
- package/dist/view/AnalyticsView.js +47 -18
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -229
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +152 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +66 -31
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +95 -10
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +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 +196 -134
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +118 -30
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +124 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +29 -33
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +123 -82
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +47 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +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 +125 -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 +91 -77
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +12 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/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 +4 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +74 -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 -28
- 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 +44 -0
- package/dist/widgets/readMeta.js +47 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +53 -25
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +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 +44 -22
- package/dist/adapters/ga4/disableKey.d.ts +0 -9
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -165
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -39
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -175
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -69
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -106
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/plugin/paths.js +0 -29
- package/dist/plugin/paths.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -29
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -20
- package/dist/tracker/sinks/posthog.d.ts +0 -18
- package/dist/tracker/sinks/umami.d.ts +0 -18
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -76
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -0,0 +1,258 @@
|
|
|
1
|
+
import { kindOf } from "./values.js";
|
|
2
|
+
import { siteAddress } from "./siteAddress.js";
|
|
3
|
+
import { isTrustedPlatform } from "../net/platform.js";
|
|
4
|
+
import { DEFAULT_PROXY_MAX_BODY_BYTES, DEFAULT_PROXY_TIMEOUT_MS } from "../capture/relay.js";
|
|
5
|
+
import { resolveAllowedOrigins } from "../capture/requestTrust.js";
|
|
6
|
+
import { isCaptureSlot } from "../capture/slots.js";
|
|
7
|
+
import { DEFAULT_AUTO_CAPTURE, DEFAULT_ITEM_CAPTURE, NO_ITEM_CAPTURE } from "../tracker/config.js";
|
|
8
|
+
import { DEFAULT_TRACKER_SKIP } from "../tracker/skip.js";
|
|
9
|
+
import { DEFAULT_EXCLUSION_PARAM } from "../tracker/exclusion.js";
|
|
10
|
+
import { keysOf, optionalBoolean, optionsObject, positiveWhole } from "./optionChecks.js";
|
|
11
|
+
import { assertNamesAdapter } from "./sourceOptions.js";
|
|
12
|
+
//#region src/core/captureOptions.ts
|
|
13
|
+
const CAPTURE_KEYS = keysOf({
|
|
14
|
+
gate: true,
|
|
15
|
+
allowedOrigins: true,
|
|
16
|
+
exclusion: true,
|
|
17
|
+
slots: true,
|
|
18
|
+
paths: true,
|
|
19
|
+
autoCapture: true,
|
|
20
|
+
skip: true,
|
|
21
|
+
proxy: true
|
|
22
|
+
});
|
|
23
|
+
const SLOT_KEYS = keysOf({
|
|
24
|
+
global: true,
|
|
25
|
+
tenant: true
|
|
26
|
+
});
|
|
27
|
+
const PROXY_KEYS = keysOf({
|
|
28
|
+
timeoutMs: true,
|
|
29
|
+
maxBodyBytes: true
|
|
30
|
+
});
|
|
31
|
+
const AUTO_CAPTURE_FLAGS = [
|
|
32
|
+
"scrollDepth",
|
|
33
|
+
"outboundLinks",
|
|
34
|
+
"fileDownloads",
|
|
35
|
+
"goalAttribute",
|
|
36
|
+
"query"
|
|
37
|
+
];
|
|
38
|
+
const AUTO_CAPTURE_KEYS = keysOf({
|
|
39
|
+
scrollDepth: true,
|
|
40
|
+
outboundLinks: true,
|
|
41
|
+
fileDownloads: true,
|
|
42
|
+
goalAttribute: true,
|
|
43
|
+
query: true,
|
|
44
|
+
items: true
|
|
45
|
+
});
|
|
46
|
+
const ITEM_CAPTURE_KEYS = keysOf({
|
|
47
|
+
impressions: true,
|
|
48
|
+
clicks: true,
|
|
49
|
+
pages: true
|
|
50
|
+
});
|
|
51
|
+
const EXCLUSION_KEYS = keysOf({
|
|
52
|
+
param: true,
|
|
53
|
+
sites: true
|
|
54
|
+
});
|
|
55
|
+
/** Unreserved URL characters, so the copied link needs no escaping. */
|
|
56
|
+
const EXCLUSION_PARAM_PATTERN = /^[A-Za-z0-9._~-]{1,64}$/;
|
|
57
|
+
const GATE_REQUIRED = "analytics: capture.gate is required: 'all' holds every slot until your consent manager calls setGate, 'off' captures without a gate, or list the slots that wait. The plugin does not decide which tracking needs consent.";
|
|
58
|
+
/**
|
|
59
|
+
* The capture slots that can fill on this config, as far as config time can see; a scoped install's
|
|
60
|
+
* tenant slot counts whenever runtime providers could bring a capture adapter.
|
|
61
|
+
*/
|
|
62
|
+
const fillableSlots = (options, scoped) => {
|
|
63
|
+
const slots = options.capture?.slots;
|
|
64
|
+
const adapters = options.adapters;
|
|
65
|
+
const fillable = [];
|
|
66
|
+
if (slots?.global !== false) {
|
|
67
|
+
const id = slots?.global ?? options.platformAdapter ?? (adapters.length === 1 ? adapters[0]?.id : void 0);
|
|
68
|
+
if (adapters.some((adapter) => adapter.id === id && adapter.capture !== void 0)) fillable.push("global");
|
|
69
|
+
}
|
|
70
|
+
const providers = Boolean(options.providers?.collection) || options.providers?.resolve !== void 0;
|
|
71
|
+
if (scoped && slots?.tenant !== false && (providers || adapters.some((adapter) => adapter.capture !== void 0))) fillable.push("tenant");
|
|
72
|
+
return fillable;
|
|
73
|
+
};
|
|
74
|
+
/**
|
|
75
|
+
* A function's answer gates its slot unless it is exactly `false`, so a gate that forgets to
|
|
76
|
+
* return holds the slot rather than capturing without consent.
|
|
77
|
+
*/
|
|
78
|
+
const resolveGate = (option, required) => {
|
|
79
|
+
if (option === void 0) {
|
|
80
|
+
if (required) throw new Error(GATE_REQUIRED);
|
|
81
|
+
return () => true;
|
|
82
|
+
}
|
|
83
|
+
if (option === "all") return () => true;
|
|
84
|
+
if (option === "off") return () => false;
|
|
85
|
+
if (Array.isArray(option)) {
|
|
86
|
+
for (const slot of option) if (typeof slot !== "string" || !isCaptureSlot(slot)) throw new Error(`analytics: capture.gate lists ${kindOf(slot)}, which is not a capture slot ('global' or 'tenant')`);
|
|
87
|
+
const gated = new Set(option);
|
|
88
|
+
return ({ slot }) => gated.has(slot);
|
|
89
|
+
}
|
|
90
|
+
if (typeof option === "function") return (args) => option(args) !== false;
|
|
91
|
+
throw new Error(`analytics: capture.gate must be 'all', 'off', a list of slots or a function, got ${kindOf(option)}`);
|
|
92
|
+
};
|
|
93
|
+
const resolveItemCapture = (option) => option === false ? { ...NO_ITEM_CAPTURE } : {
|
|
94
|
+
impressions: option?.impressions ?? DEFAULT_ITEM_CAPTURE.impressions,
|
|
95
|
+
clicks: option?.clicks ?? DEFAULT_ITEM_CAPTURE.clicks,
|
|
96
|
+
pages: option?.pages ?? DEFAULT_ITEM_CAPTURE.pages
|
|
97
|
+
};
|
|
98
|
+
const resolveAutoCapture = (option) => ({
|
|
99
|
+
scrollDepth: option?.scrollDepth ?? DEFAULT_AUTO_CAPTURE.scrollDepth,
|
|
100
|
+
outboundLinks: option?.outboundLinks ?? DEFAULT_AUTO_CAPTURE.outboundLinks,
|
|
101
|
+
fileDownloads: option?.fileDownloads ?? DEFAULT_AUTO_CAPTURE.fileDownloads,
|
|
102
|
+
goalAttribute: option?.goalAttribute ?? DEFAULT_AUTO_CAPTURE.goalAttribute,
|
|
103
|
+
query: option?.query ?? DEFAULT_AUTO_CAPTURE.query,
|
|
104
|
+
items: resolveItemCapture(option?.items)
|
|
105
|
+
});
|
|
106
|
+
/**
|
|
107
|
+
* The auto-capture the tracker is handed: item capture off while no collection is bound as items,
|
|
108
|
+
* since ingest would drop every ref it sent, so no page runs an observer for them.
|
|
109
|
+
*/
|
|
110
|
+
const trackerAutoCapture = (autoCapture, itemsBound) => itemsBound ? autoCapture : {
|
|
111
|
+
...autoCapture,
|
|
112
|
+
items: NO_ITEM_CAPTURE
|
|
113
|
+
};
|
|
114
|
+
/** A list checked once at boot; a function's answer is checked per request, by the endpoint. */
|
|
115
|
+
const resolveExclusionSites = (option) => {
|
|
116
|
+
if (option === void 0) return;
|
|
117
|
+
if (typeof option === "function") return option;
|
|
118
|
+
const invalid = Array.isArray(option) ? option.find((site) => siteAddress(site) === null) : option;
|
|
119
|
+
if (!Array.isArray(option) || invalid !== void 0) throw new Error(`analytics: capture.exclusion.sites must be a function or a list of http(s) addresses such as 'https://shop.example.com', got ${kindOf(invalid)}`);
|
|
120
|
+
const sites = option.flatMap((site) => {
|
|
121
|
+
const address = siteAddress(site);
|
|
122
|
+
return address === null ? [] : [address];
|
|
123
|
+
});
|
|
124
|
+
return () => sites;
|
|
125
|
+
};
|
|
126
|
+
const resolveExclusion = (option) => {
|
|
127
|
+
if (option === void 0 || option === false) return false;
|
|
128
|
+
if (option === true) return { param: DEFAULT_EXCLUSION_PARAM };
|
|
129
|
+
optionsObject(option, {
|
|
130
|
+
path: "capture.exclusion",
|
|
131
|
+
known: EXCLUSION_KEYS,
|
|
132
|
+
example: "true, false or an object such as { param: 'staff' }"
|
|
133
|
+
});
|
|
134
|
+
const param = option.param ?? "analytics_exclude";
|
|
135
|
+
if (typeof param !== "string" || !EXCLUSION_PARAM_PATTERN.test(param)) throw new Error(`analytics: capture.exclusion.param must be 1 to 64 letters, digits, ".", "_", "~" or "-", got ${kindOf(param)}`);
|
|
136
|
+
const sites = resolveExclusionSites(option.sites);
|
|
137
|
+
return sites ? {
|
|
138
|
+
param,
|
|
139
|
+
sites
|
|
140
|
+
} : { param };
|
|
141
|
+
};
|
|
142
|
+
const resolveSkip = (option) => {
|
|
143
|
+
if (option === void 0) return { ...DEFAULT_TRACKER_SKIP };
|
|
144
|
+
const shaped = optionsObject(option, {
|
|
145
|
+
path: "capture.skip",
|
|
146
|
+
known: Object.keys(DEFAULT_TRACKER_SKIP),
|
|
147
|
+
example: "an object such as { automation: false }"
|
|
148
|
+
});
|
|
149
|
+
const flag = (key) => optionalBoolean(shaped[key], `capture.skip.${key}`) ?? DEFAULT_TRACKER_SKIP[key];
|
|
150
|
+
return {
|
|
151
|
+
automation: flag("automation"),
|
|
152
|
+
previews: flag("previews")
|
|
153
|
+
};
|
|
154
|
+
};
|
|
155
|
+
/** Each of `capture.slots` or `capture.paths`, checked by `valid` and refused with `expected`. */
|
|
156
|
+
const assertPerSlot = (value, at) => {
|
|
157
|
+
if (value === void 0) return;
|
|
158
|
+
const perSlot = optionsObject(value, {
|
|
159
|
+
path: at.path,
|
|
160
|
+
known: SLOT_KEYS,
|
|
161
|
+
example: at.example
|
|
162
|
+
});
|
|
163
|
+
for (const [slot, entry] of Object.entries(perSlot)) if (entry !== void 0 && !at.valid(entry)) throw new Error(`analytics: ${at.path}.${slot} must be ${at.expected}, got ${kindOf(entry)}`);
|
|
164
|
+
};
|
|
165
|
+
/** `capture` and the objects inside it whose values are read as they are. */
|
|
166
|
+
const assertCaptureShape = (option) => {
|
|
167
|
+
if (option === void 0) return;
|
|
168
|
+
optionsObject(option, {
|
|
169
|
+
path: "capture",
|
|
170
|
+
known: CAPTURE_KEYS,
|
|
171
|
+
example: "an object such as { gate: 'off' }"
|
|
172
|
+
});
|
|
173
|
+
assertPerSlot(option.slots, {
|
|
174
|
+
path: "capture.slots",
|
|
175
|
+
example: "an object such as { global: 'native' }",
|
|
176
|
+
expected: "an adapter id or false",
|
|
177
|
+
valid: (entry) => entry === false || typeof entry === "string"
|
|
178
|
+
});
|
|
179
|
+
assertPerSlot(option.paths, {
|
|
180
|
+
path: "capture.paths",
|
|
181
|
+
example: "an object such as { global: '/stats' }",
|
|
182
|
+
expected: "a path starting with \"/\", such as \"/stats\"",
|
|
183
|
+
valid: (entry) => typeof entry === "string" && entry.startsWith("/")
|
|
184
|
+
});
|
|
185
|
+
if (option.proxy !== void 0) optionsObject(option.proxy, {
|
|
186
|
+
path: "capture.proxy",
|
|
187
|
+
known: PROXY_KEYS,
|
|
188
|
+
example: "an object such as { timeoutMs: 10000 }"
|
|
189
|
+
});
|
|
190
|
+
if (option.autoCapture === void 0) return;
|
|
191
|
+
const auto = optionsObject(option.autoCapture, {
|
|
192
|
+
path: "capture.autoCapture",
|
|
193
|
+
known: AUTO_CAPTURE_KEYS,
|
|
194
|
+
example: "an object such as { scrollDepth: true }"
|
|
195
|
+
});
|
|
196
|
+
for (const flag of AUTO_CAPTURE_FLAGS) optionalBoolean(auto[flag], `capture.autoCapture.${flag}`);
|
|
197
|
+
if (auto.items !== void 0 && auto.items !== false) {
|
|
198
|
+
const items = optionsObject(auto.items, {
|
|
199
|
+
path: "capture.autoCapture.items",
|
|
200
|
+
known: ITEM_CAPTURE_KEYS,
|
|
201
|
+
example: "false, or an object such as { clicks: false }"
|
|
202
|
+
});
|
|
203
|
+
for (const flag of ITEM_CAPTURE_KEYS) optionalBoolean(items[flag], `capture.autoCapture.items.${flag}`);
|
|
204
|
+
}
|
|
205
|
+
};
|
|
206
|
+
/**
|
|
207
|
+
* `capture` checked and filled. A global slot's adapter id is checked against `adapters` here; a
|
|
208
|
+
* tenant one may name a runtime provider instance, which only exists once a scope resolves.
|
|
209
|
+
*/
|
|
210
|
+
const resolveCapture = (options, scoped) => {
|
|
211
|
+
const option = options.capture;
|
|
212
|
+
assertCaptureShape(option);
|
|
213
|
+
const globalSlot = option?.slots?.global;
|
|
214
|
+
if (typeof globalSlot === "string") assertNamesAdapter(globalSlot, "capture.slots.global", options.adapters ?? []);
|
|
215
|
+
return {
|
|
216
|
+
slots: {
|
|
217
|
+
global: globalSlot,
|
|
218
|
+
tenant: option?.slots?.tenant
|
|
219
|
+
},
|
|
220
|
+
paths: {
|
|
221
|
+
global: option?.paths?.global,
|
|
222
|
+
tenant: option?.paths?.tenant
|
|
223
|
+
},
|
|
224
|
+
gate: resolveGate(option?.gate, fillableSlots(options, scoped).length > 0),
|
|
225
|
+
autoCapture: resolveAutoCapture(option?.autoCapture),
|
|
226
|
+
proxy: {
|
|
227
|
+
timeoutMs: positiveWhole(option?.proxy?.timeoutMs, "capture.proxy.timeoutMs", DEFAULT_PROXY_TIMEOUT_MS),
|
|
228
|
+
maxBodyBytes: positiveWhole(option?.proxy?.maxBodyBytes, "capture.proxy.maxBodyBytes", DEFAULT_PROXY_MAX_BODY_BYTES)
|
|
229
|
+
},
|
|
230
|
+
allowedOrigins: resolveAllowedOrigins(option?.allowedOrigins),
|
|
231
|
+
exclusion: resolveExclusion(option?.exclusion),
|
|
232
|
+
skip: resolveSkip(option?.skip)
|
|
233
|
+
};
|
|
234
|
+
};
|
|
235
|
+
/** Where the client address and location come from: a proxy count, a platform, or neither. */
|
|
236
|
+
const resolveTrust = (options) => {
|
|
237
|
+
const hops = options.trustedProxyHops;
|
|
238
|
+
if (hops !== void 0 && (!Number.isInteger(hops) || hops < 0)) throw new Error(`analytics: trustedProxyHops must be a non-negative integer, got ${String(hops)}`);
|
|
239
|
+
const platform = options.trustedPlatform;
|
|
240
|
+
if (platform !== void 0 && !isTrustedPlatform(platform)) throw new Error(`analytics: trustedPlatform must be 'vercel' or 'cloudflare', got ${kindOf(platform)}`);
|
|
241
|
+
if (hops !== void 0 && platform !== void 0) throw new Error("analytics: trustedProxyHops and trustedPlatform cannot both be set. trustedPlatform reads the visitor address from the platform header, trustedProxyHops from x-forwarded-for: keep the one that describes what sits in front of the app.");
|
|
242
|
+
return {
|
|
243
|
+
...hops === void 0 ? {} : { trustedProxyHops: hops },
|
|
244
|
+
...platform === void 0 ? {} : { trustedPlatform: platform }
|
|
245
|
+
};
|
|
246
|
+
};
|
|
247
|
+
/**
|
|
248
|
+
* The production boot notice for an install reading visitor addresses and countries from headers
|
|
249
|
+
* nothing vouches for, or null.
|
|
250
|
+
*/
|
|
251
|
+
const untrustedAddressNotice = (resolved, production) => {
|
|
252
|
+
if (!production || resolved.trustedProxyHops !== void 0 || resolved.trustedPlatform !== void 0) return null;
|
|
253
|
+
return resolved.providers.collection.enabled || resolved.providers.resolve !== void 0 || resolved.adapters.some((adapter) => adapter.ingest !== void 0 || (adapter.capture?.proxy.routes.length ?? 0) > 0) ? "analytics: visitor IP addresses and countries can be spoofed on this install. Neither trustedProxyHops nor trustedPlatform is set, so the plugin reads them from request headers a visitor can write. Set trustedPlatform to 'vercel' or 'cloudflare' when the app runs behind one, or trustedProxyHops to the number of proxies in front of it." : null;
|
|
254
|
+
};
|
|
255
|
+
//#endregion
|
|
256
|
+
export { fillableSlots, resolveCapture, resolveTrust, trackerAutoCapture, untrustedAddressNotice };
|
|
257
|
+
|
|
258
|
+
//# sourceMappingURL=captureOptions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"captureOptions.js","names":[],"sources":["../../src/core/captureOptions.ts"],"sourcesContent":["import { DEFAULT_PROXY_MAX_BODY_BYTES, DEFAULT_PROXY_TIMEOUT_MS } from '../capture/proxyEndpoint'\nimport { resolveAllowedOrigins } from '../capture/requestTrust'\nimport { isCaptureSlot } from '../capture/slots'\nimport { isTrustedPlatform } from '../net/platform'\nimport type { CaptureSlot, TrackerSkip } from '../tracker/config'\nimport {\n\tDEFAULT_AUTO_CAPTURE,\n\tDEFAULT_ITEM_CAPTURE,\n\tNO_ITEM_CAPTURE,\n\ttype ResolvedAutoCapture,\n\ttype ResolvedItemCapture,\n} from '../tracker/config'\nimport { DEFAULT_EXCLUSION_PARAM } from '../tracker/exclusion'\nimport { DEFAULT_TRACKER_SKIP } from '../tracker/skip'\nimport { keysOf, optionalBoolean, optionsObject, positiveWhole } from './optionChecks'\nimport type {\n\tAnalyticsCaptureOptions,\n\tAnalyticsExclusionOptions,\n\tAnalyticsPluginOptions,\n\tAutoCaptureOptions,\n\tCaptureGatePolicy,\n\tExclusionSitesResolver,\n\tItemCaptureOptions,\n\tResolvedCapture,\n\tResolvedOptions,\n} from './options'\nimport { siteAddress } from './siteAddress'\nimport { assertNamesAdapter } from './sourceOptions'\nimport { kindOf } from './values'\n\nconst CAPTURE_KEYS = keysOf<AnalyticsCaptureOptions>({\n\tgate: true,\n\tallowedOrigins: true,\n\texclusion: true,\n\tslots: true,\n\tpaths: true,\n\tautoCapture: true,\n\tskip: true,\n\tproxy: true,\n})\nconst SLOT_KEYS = keysOf<NonNullable<AnalyticsCaptureOptions['slots']>>({\n\tglobal: true,\n\ttenant: true,\n})\nconst PROXY_KEYS = keysOf<NonNullable<AnalyticsCaptureOptions['proxy']>>({\n\ttimeoutMs: true,\n\tmaxBodyBytes: true,\n})\nconst AUTO_CAPTURE_FLAGS = [\n\t'scrollDepth',\n\t'outboundLinks',\n\t'fileDownloads',\n\t'goalAttribute',\n\t'query',\n] as const\nconst AUTO_CAPTURE_KEYS = keysOf<AutoCaptureOptions>({\n\tscrollDepth: true,\n\toutboundLinks: true,\n\tfileDownloads: true,\n\tgoalAttribute: true,\n\tquery: true,\n\titems: true,\n})\nconst ITEM_CAPTURE_KEYS = keysOf<ItemCaptureOptions>({\n\timpressions: true,\n\tclicks: true,\n\tpages: true,\n})\nconst EXCLUSION_KEYS = keysOf<AnalyticsExclusionOptions>({ param: true, sites: true })\n\n/** Unreserved URL characters, so the copied link needs no escaping. */\nconst EXCLUSION_PARAM_PATTERN = /^[A-Za-z0-9._~-]{1,64}$/\n\nconst GATE_REQUIRED =\n\t\"analytics: capture.gate is required: 'all' holds every slot until your consent manager calls setGate, 'off' captures without a gate, or list the slots that wait. The plugin does not decide which tracking needs consent.\"\n\n/**\n * The capture slots that can fill on this config, as far as config time can see; a scoped install's\n * tenant slot counts whenever runtime providers could bring a capture adapter.\n */\nexport const fillableSlots = (options: AnalyticsPluginOptions, scoped: boolean): CaptureSlot[] => {\n\tconst slots = options.capture?.slots\n\tconst adapters = options.adapters\n\tconst fillable: CaptureSlot[] = []\n\tif (slots?.global !== false) {\n\t\tconst id =\n\t\t\tslots?.global ??\n\t\t\toptions.platformAdapter ??\n\t\t\t(adapters.length === 1 ? adapters[0]?.id : undefined)\n\t\tif (adapters.some((adapter) => adapter.id === id && adapter.capture !== undefined)) {\n\t\t\tfillable.push('global')\n\t\t}\n\t}\n\tconst providers =\n\t\tBoolean(options.providers?.collection) || options.providers?.resolve !== undefined\n\tif (\n\t\tscoped &&\n\t\tslots?.tenant !== false &&\n\t\t(providers || adapters.some((adapter) => adapter.capture !== undefined))\n\t) {\n\t\tfillable.push('tenant')\n\t}\n\treturn fillable\n}\n\n/**\n * A function's answer gates its slot unless it is exactly `false`, so a gate that forgets to\n * return holds the slot rather than capturing without consent.\n */\nconst resolveGate = (\n\toption: AnalyticsCaptureOptions['gate'],\n\trequired: boolean\n): CaptureGatePolicy => {\n\tif (option === undefined) {\n\t\tif (required) {\n\t\t\tthrow new Error(GATE_REQUIRED)\n\t\t}\n\t\treturn () => true\n\t}\n\tif (option === 'all') {\n\t\treturn () => true\n\t}\n\tif (option === 'off') {\n\t\treturn () => false\n\t}\n\tif (Array.isArray(option)) {\n\t\tfor (const slot of option) {\n\t\t\tif (typeof slot !== 'string' || !isCaptureSlot(slot)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`analytics: capture.gate lists ${kindOf(slot)}, which is not a capture slot ('global' or 'tenant')`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\tconst gated = new Set<CaptureSlot>(option)\n\t\treturn ({ slot }) => gated.has(slot)\n\t}\n\tif (typeof option === 'function') {\n\t\treturn (args) => option(args) !== false\n\t}\n\tthrow new Error(\n\t\t`analytics: capture.gate must be 'all', 'off', a list of slots or a function, got ${kindOf(option)}`\n\t)\n}\n\nconst resolveItemCapture = (option: AutoCaptureOptions['items']): ResolvedItemCapture =>\n\toption === false\n\t\t? { ...NO_ITEM_CAPTURE }\n\t\t: {\n\t\t\t\timpressions: option?.impressions ?? DEFAULT_ITEM_CAPTURE.impressions,\n\t\t\t\tclicks: option?.clicks ?? DEFAULT_ITEM_CAPTURE.clicks,\n\t\t\t\tpages: option?.pages ?? DEFAULT_ITEM_CAPTURE.pages,\n\t\t\t}\n\nconst resolveAutoCapture = (option: AutoCaptureOptions | undefined): ResolvedAutoCapture => ({\n\tscrollDepth: option?.scrollDepth ?? DEFAULT_AUTO_CAPTURE.scrollDepth,\n\toutboundLinks: option?.outboundLinks ?? DEFAULT_AUTO_CAPTURE.outboundLinks,\n\tfileDownloads: option?.fileDownloads ?? DEFAULT_AUTO_CAPTURE.fileDownloads,\n\tgoalAttribute: option?.goalAttribute ?? DEFAULT_AUTO_CAPTURE.goalAttribute,\n\tquery: option?.query ?? DEFAULT_AUTO_CAPTURE.query,\n\titems: resolveItemCapture(option?.items),\n})\n\n/**\n * The auto-capture the tracker is handed: item capture off while no collection is bound as items,\n * since ingest would drop every ref it sent, so no page runs an observer for them.\n */\nexport const trackerAutoCapture = (\n\tautoCapture: ResolvedAutoCapture,\n\titemsBound: boolean\n): ResolvedAutoCapture => (itemsBound ? autoCapture : { ...autoCapture, items: NO_ITEM_CAPTURE })\n\n/** A list checked once at boot; a function's answer is checked per request, by the endpoint. */\nconst resolveExclusionSites = (\n\toption: AnalyticsExclusionOptions['sites']\n): ExclusionSitesResolver | undefined => {\n\tif (option === undefined) {\n\t\treturn undefined\n\t}\n\tif (typeof option === 'function') {\n\t\treturn option\n\t}\n\tconst invalid: unknown = Array.isArray(option)\n\t\t? option.find((site) => siteAddress(site) === null)\n\t\t: option\n\tif (!Array.isArray(option) || invalid !== undefined) {\n\t\tthrow new Error(\n\t\t\t`analytics: capture.exclusion.sites must be a function or a list of http(s) addresses such as 'https://shop.example.com', got ${kindOf(invalid)}`\n\t\t)\n\t}\n\tconst sites = option.flatMap((site) => {\n\t\tconst address = siteAddress(site)\n\t\treturn address === null ? [] : [address]\n\t})\n\treturn () => sites\n}\n\nconst resolveExclusion = (\n\toption: AnalyticsCaptureOptions['exclusion']\n): ResolvedCapture['exclusion'] => {\n\tif (option === undefined || option === false) {\n\t\treturn false\n\t}\n\tif (option === true) {\n\t\treturn { param: DEFAULT_EXCLUSION_PARAM }\n\t}\n\toptionsObject(option, {\n\t\tpath: 'capture.exclusion',\n\t\tknown: EXCLUSION_KEYS,\n\t\texample: \"true, false or an object such as { param: 'staff' }\",\n\t})\n\tconst param = option.param ?? DEFAULT_EXCLUSION_PARAM\n\tif (typeof param !== 'string' || !EXCLUSION_PARAM_PATTERN.test(param)) {\n\t\tthrow new Error(\n\t\t\t`analytics: capture.exclusion.param must be 1 to 64 letters, digits, \".\", \"_\", \"~\" or \"-\", got ${kindOf(param)}`\n\t\t)\n\t}\n\tconst sites = resolveExclusionSites(option.sites)\n\treturn sites ? { param, sites } : { param }\n}\n\nconst resolveSkip = (option: AnalyticsCaptureOptions['skip']): TrackerSkip => {\n\tif (option === undefined) {\n\t\treturn { ...DEFAULT_TRACKER_SKIP }\n\t}\n\tconst shaped = optionsObject(option, {\n\t\tpath: 'capture.skip',\n\t\tknown: Object.keys(DEFAULT_TRACKER_SKIP),\n\t\texample: 'an object such as { automation: false }',\n\t})\n\tconst flag = (key: keyof TrackerSkip): boolean =>\n\t\toptionalBoolean(shaped[key], `capture.skip.${key}`) ?? DEFAULT_TRACKER_SKIP[key]\n\treturn { automation: flag('automation'), previews: flag('previews') }\n}\n\n/** Each of `capture.slots` or `capture.paths`, checked by `valid` and refused with `expected`. */\nconst assertPerSlot = (\n\tvalue: unknown,\n\tat: { path: string; example: string; expected: string; valid: (entry: unknown) => boolean }\n): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tconst perSlot = optionsObject(value, { path: at.path, known: SLOT_KEYS, example: at.example })\n\tfor (const [slot, entry] of Object.entries(perSlot)) {\n\t\tif (entry !== undefined && !at.valid(entry)) {\n\t\t\tthrow new Error(`analytics: ${at.path}.${slot} must be ${at.expected}, got ${kindOf(entry)}`)\n\t\t}\n\t}\n}\n\n/** `capture` and the objects inside it whose values are read as they are. */\nconst assertCaptureShape = (option: AnalyticsCaptureOptions | undefined): void => {\n\tif (option === undefined) {\n\t\treturn\n\t}\n\toptionsObject(option, {\n\t\tpath: 'capture',\n\t\tknown: CAPTURE_KEYS,\n\t\texample: \"an object such as { gate: 'off' }\",\n\t})\n\tassertPerSlot(option.slots, {\n\t\tpath: 'capture.slots',\n\t\texample: \"an object such as { global: 'native' }\",\n\t\texpected: 'an adapter id or false',\n\t\tvalid: (entry) => entry === false || typeof entry === 'string',\n\t})\n\tassertPerSlot(option.paths, {\n\t\tpath: 'capture.paths',\n\t\texample: \"an object such as { global: '/stats' }\",\n\t\texpected: 'a path starting with \"/\", such as \"/stats\"',\n\t\tvalid: (entry) => typeof entry === 'string' && entry.startsWith('/'),\n\t})\n\tif (option.proxy !== undefined) {\n\t\toptionsObject(option.proxy, {\n\t\t\tpath: 'capture.proxy',\n\t\t\tknown: PROXY_KEYS,\n\t\t\texample: 'an object such as { timeoutMs: 10000 }',\n\t\t})\n\t}\n\tif (option.autoCapture === undefined) {\n\t\treturn\n\t}\n\tconst auto = optionsObject(option.autoCapture, {\n\t\tpath: 'capture.autoCapture',\n\t\tknown: AUTO_CAPTURE_KEYS,\n\t\texample: 'an object such as { scrollDepth: true }',\n\t})\n\tfor (const flag of AUTO_CAPTURE_FLAGS) {\n\t\toptionalBoolean(auto[flag], `capture.autoCapture.${flag}`)\n\t}\n\tif (auto.items !== undefined && auto.items !== false) {\n\t\tconst items = optionsObject(auto.items, {\n\t\t\tpath: 'capture.autoCapture.items',\n\t\t\tknown: ITEM_CAPTURE_KEYS,\n\t\t\texample: 'false, or an object such as { clicks: false }',\n\t\t})\n\t\tfor (const flag of ITEM_CAPTURE_KEYS) {\n\t\t\toptionalBoolean(items[flag], `capture.autoCapture.items.${flag}`)\n\t\t}\n\t}\n}\n\n/**\n * `capture` checked and filled. A global slot's adapter id is checked against `adapters` here; a\n * tenant one may name a runtime provider instance, which only exists once a scope resolves.\n */\nexport const resolveCapture = (\n\toptions: AnalyticsPluginOptions,\n\tscoped: boolean\n): ResolvedCapture => {\n\tconst option = options.capture\n\tassertCaptureShape(option)\n\tconst globalSlot = option?.slots?.global\n\tif (typeof globalSlot === 'string') {\n\t\tassertNamesAdapter(globalSlot, 'capture.slots.global', options.adapters ?? [])\n\t}\n\treturn {\n\t\tslots: { global: globalSlot, tenant: option?.slots?.tenant },\n\t\tpaths: { global: option?.paths?.global, tenant: option?.paths?.tenant },\n\t\tgate: resolveGate(option?.gate, fillableSlots(options, scoped).length > 0),\n\t\tautoCapture: resolveAutoCapture(option?.autoCapture),\n\t\tproxy: {\n\t\t\ttimeoutMs: positiveWhole(\n\t\t\t\toption?.proxy?.timeoutMs,\n\t\t\t\t'capture.proxy.timeoutMs',\n\t\t\t\tDEFAULT_PROXY_TIMEOUT_MS\n\t\t\t),\n\t\t\tmaxBodyBytes: positiveWhole(\n\t\t\t\toption?.proxy?.maxBodyBytes,\n\t\t\t\t'capture.proxy.maxBodyBytes',\n\t\t\t\tDEFAULT_PROXY_MAX_BODY_BYTES\n\t\t\t),\n\t\t},\n\t\tallowedOrigins: resolveAllowedOrigins(option?.allowedOrigins),\n\t\texclusion: resolveExclusion(option?.exclusion),\n\t\tskip: resolveSkip(option?.skip),\n\t}\n}\n\n/** Where the client address and location come from: a proxy count, a platform, or neither. */\nexport const resolveTrust = (\n\toptions: AnalyticsPluginOptions\n): Pick<ResolvedOptions, 'trustedProxyHops' | 'trustedPlatform'> => {\n\tconst hops = options.trustedProxyHops\n\tif (hops !== undefined && (!Number.isInteger(hops) || hops < 0)) {\n\t\tthrow new Error(\n\t\t\t`analytics: trustedProxyHops must be a non-negative integer, got ${String(hops)}`\n\t\t)\n\t}\n\tconst platform: unknown = options.trustedPlatform\n\tif (platform !== undefined && !isTrustedPlatform(platform)) {\n\t\tthrow new Error(\n\t\t\t`analytics: trustedPlatform must be 'vercel' or 'cloudflare', got ${kindOf(platform)}`\n\t\t)\n\t}\n\tif (hops !== undefined && platform !== undefined) {\n\t\tthrow new Error(\n\t\t\t'analytics: trustedProxyHops and trustedPlatform cannot both be set. trustedPlatform reads the visitor address from the platform header, trustedProxyHops from x-forwarded-for: keep the one that describes what sits in front of the app.'\n\t\t)\n\t}\n\treturn {\n\t\t...(hops === undefined ? {} : { trustedProxyHops: hops }),\n\t\t...(platform === undefined ? {} : { trustedPlatform: platform }),\n\t}\n}\n\n/**\n * The production boot notice for an install reading visitor addresses and countries from headers\n * nothing vouches for, or null.\n */\nexport const untrustedAddressNotice = (\n\tresolved: Pick<\n\t\tResolvedOptions,\n\t\t'trustedProxyHops' | 'trustedPlatform' | 'adapters' | 'providers'\n\t>,\n\tproduction: boolean\n): string | null => {\n\tif (\n\t\t!production ||\n\t\tresolved.trustedProxyHops !== undefined ||\n\t\tresolved.trustedPlatform !== undefined\n\t) {\n\t\treturn null\n\t}\n\tconst reads =\n\t\tresolved.providers.collection.enabled ||\n\t\tresolved.providers.resolve !== undefined ||\n\t\tresolved.adapters.some(\n\t\t\t(adapter) => adapter.ingest !== undefined || (adapter.capture?.proxy.routes.length ?? 0) > 0\n\t\t)\n\treturn reads\n\t\t? \"analytics: visitor IP addresses and countries can be spoofed on this install. Neither trustedProxyHops nor trustedPlatform is set, so the plugin reads them from request headers a visitor can write. Set trustedPlatform to 'vercel' or 'cloudflare' when the app runs behind one, or trustedProxyHops to the number of proxies in front of it.\"\n\t\t: null\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { getCurrentDate } from "payload";
|
|
2
|
+
//#region src/core/clock.ts
|
|
3
|
+
/**
|
|
4
|
+
* What time it is for every server-side read: Payload's own clock, so a test that sets it moves
|
|
5
|
+
* every day cut, lease and cache stamp at once. Durations run on `monotonicMs`.
|
|
6
|
+
*/
|
|
7
|
+
const currentDate = () => getCurrentDate();
|
|
8
|
+
/** {@link currentDate} in epoch milliseconds. */
|
|
9
|
+
const currentTime = () => getCurrentDate().getTime();
|
|
10
|
+
//#endregion
|
|
11
|
+
export { currentDate, currentTime };
|
|
12
|
+
|
|
13
|
+
//# sourceMappingURL=clock.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"clock.js","names":[],"sources":["../../src/core/clock.ts"],"sourcesContent":["import { getCurrentDate } from 'payload'\n\n/**\n * What time it is for every server-side read: Payload's own clock, so a test that sets it moves\n * every day cut, lease and cache stamp at once. Durations run on `monotonicMs`.\n */\nexport const currentDate = (): Date => getCurrentDate()\n\n/** {@link currentDate} in epoch milliseconds. */\nexport const currentTime = (): number => getCurrentDate().getTime()\n"],"mappings":";;;;;;AAMA,MAAa,oBAA0B,eAAe;;AAGtD,MAAa,oBAA4B,eAAe,EAAE,QAAQ"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { CollectionConfig } from "payload";
|
|
2
|
+
|
|
3
|
+
//#region src/core/collectionOption.d.ts
|
|
4
|
+
/** Reshapes one of the plugin's generated collections; handed the finished config, it returns one. */
|
|
5
|
+
type CollectionOverrides = (collection: CollectionConfig) => CollectionConfig;
|
|
6
|
+
/** A plugin collection's name and shape, as each option naming one takes them. */
|
|
7
|
+
type AnalyticsCollectionOptions = {
|
|
8
|
+
/** The slug every part of the plugin reads the collection under. */slug?: string;
|
|
9
|
+
/**
|
|
10
|
+
* Reshapes the generated collection last. It may not rename it (`slug` does that) nor take away
|
|
11
|
+
* what the plugin reads and writes: the boot checks both, naming the collection and the field.
|
|
12
|
+
*/
|
|
13
|
+
overrides?: CollectionOverrides;
|
|
14
|
+
};
|
|
15
|
+
//#endregion
|
|
16
|
+
export { AnalyticsCollectionOptions, CollectionOverrides };
|
|
17
|
+
//# sourceMappingURL=collectionOption.d.ts.map
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import { kindOf } from "./values.js";
|
|
2
|
+
import { flatFieldName, keysOf, optionsObject } from "./optionChecks.js";
|
|
3
|
+
//#region src/core/collectionOption.ts
|
|
4
|
+
/** Only that it is a function can be checked at run time; the option's type promises the rest. */
|
|
5
|
+
const isOverrides = (value) => typeof value === "function";
|
|
6
|
+
/** `overrides` checked at boot: a function or nothing, since no object is ever merged in. */
|
|
7
|
+
const overridesOf = (value, path) => {
|
|
8
|
+
if (value === void 0) return;
|
|
9
|
+
if (!isOverrides(value)) throw new Error(`analytics: ${path} must be a function, (collection) => collection, got ${kindOf(value)}`);
|
|
10
|
+
return value;
|
|
11
|
+
};
|
|
12
|
+
/** A collection slug option checked at boot, trimmed, or the default when unset. */
|
|
13
|
+
const slugOf = (value, path, fallback) => {
|
|
14
|
+
if (value === void 0) return fallback;
|
|
15
|
+
if (typeof value !== "string" || value.trim() === "") throw new Error(`analytics: ${path} must be a non-empty collection slug, got ${kindOf(value)}`);
|
|
16
|
+
return value.trim();
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* One `{ slug, overrides }` option checked at boot. `path` names it in every refusal, and `extra`
|
|
20
|
+
* lists the other keys the option takes beside those two.
|
|
21
|
+
*/
|
|
22
|
+
const resolveCollectionOption = (value, where) => {
|
|
23
|
+
const { path, fallback, extra = [] } = where;
|
|
24
|
+
if (value === void 0) return { slug: fallback };
|
|
25
|
+
const shaped = optionsObject(value, {
|
|
26
|
+
path,
|
|
27
|
+
known: [
|
|
28
|
+
"slug",
|
|
29
|
+
"overrides",
|
|
30
|
+
...extra
|
|
31
|
+
],
|
|
32
|
+
example: `an object such as { slug: '${fallback}' }`
|
|
33
|
+
});
|
|
34
|
+
const overrides = overridesOf(shaped.overrides, `${path}.overrides`);
|
|
35
|
+
return {
|
|
36
|
+
slug: slugOf(shaped.slug, `${path}.slug`, fallback),
|
|
37
|
+
...overrides ? { overrides } : {}
|
|
38
|
+
};
|
|
39
|
+
};
|
|
40
|
+
/** The field a scoped plugin collection stamps each document's scope into, by default. */
|
|
41
|
+
const DEFAULT_SCOPE_FIELD = "scope";
|
|
42
|
+
const COLLECTION_ACCESS_KEYS = keysOf({
|
|
43
|
+
admin: true,
|
|
44
|
+
create: true,
|
|
45
|
+
delete: true,
|
|
46
|
+
read: true,
|
|
47
|
+
readVersions: true,
|
|
48
|
+
unlock: true,
|
|
49
|
+
update: true
|
|
50
|
+
});
|
|
51
|
+
/** `access` on one of the plugin's collections: a Payload access function per operation. */
|
|
52
|
+
const assertCollectionAccess = (value, path) => {
|
|
53
|
+
if (value === void 0) return;
|
|
54
|
+
const access = optionsObject(value, {
|
|
55
|
+
path,
|
|
56
|
+
known: COLLECTION_ACCESS_KEYS,
|
|
57
|
+
example: "an object such as { read }"
|
|
58
|
+
});
|
|
59
|
+
for (const [operation, fn] of Object.entries(access)) if (fn !== void 0 && typeof fn !== "function") throw new Error(`analytics: ${path}.${operation} must be an access function, got ${kindOf(fn)}`);
|
|
60
|
+
};
|
|
61
|
+
/** A collection's `fields` overrides: one function per field it may replace. */
|
|
62
|
+
const assertFieldOverrides = (value, path, known) => {
|
|
63
|
+
if (value === void 0) return;
|
|
64
|
+
const fields = optionsObject(value, {
|
|
65
|
+
path,
|
|
66
|
+
known,
|
|
67
|
+
example: "an object such as { name: ({ defaultField }) => defaultField }"
|
|
68
|
+
});
|
|
69
|
+
for (const [name, override] of Object.entries(fields)) if (override !== void 0 && typeof override !== "function") throw new Error(`analytics: ${path}.${name} must be a function receiving { defaultField }, got ${kindOf(override)}`);
|
|
70
|
+
};
|
|
71
|
+
/**
|
|
72
|
+
* A scoped collection option: off when unset or false, on under its defaults for `true`, and an
|
|
73
|
+
* object checked for its keys, `fields`, `access`, `overrides`, slug and scope field.
|
|
74
|
+
*/
|
|
75
|
+
const resolveScopedCollection = (option, at) => {
|
|
76
|
+
if (option === void 0 || typeof option === "boolean") return {
|
|
77
|
+
enabled: option === true,
|
|
78
|
+
slug: at.fallback,
|
|
79
|
+
scopeField: DEFAULT_SCOPE_FIELD
|
|
80
|
+
};
|
|
81
|
+
const shaped = optionsObject(option, {
|
|
82
|
+
path: at.path,
|
|
83
|
+
known: at.known,
|
|
84
|
+
example: `true, or an object such as { slug: '${at.exampleSlug}' }`
|
|
85
|
+
});
|
|
86
|
+
assertFieldOverrides(shaped.fields, `${at.path}.fields`, at.fieldKeys);
|
|
87
|
+
assertCollectionAccess(shaped.access, `${at.path}.access`);
|
|
88
|
+
const overrides = overridesOf(option.overrides, `${at.path}.overrides`);
|
|
89
|
+
return {
|
|
90
|
+
enabled: true,
|
|
91
|
+
slug: slugOf(option.slug, `${at.path}.slug`, at.fallback),
|
|
92
|
+
scopeField: flatFieldName(option.scopeField ?? DEFAULT_SCOPE_FIELD, {
|
|
93
|
+
path: `${at.path}.scopeField`,
|
|
94
|
+
reason: "the scope stamp writes it as a flat key"
|
|
95
|
+
}),
|
|
96
|
+
...option.fields ? { fields: option.fields } : {},
|
|
97
|
+
...overrides ? { overrides } : {},
|
|
98
|
+
...option.access ? { access: option.access } : {}
|
|
99
|
+
};
|
|
100
|
+
};
|
|
101
|
+
//#endregion
|
|
102
|
+
export { resolveCollectionOption, resolveScopedCollection };
|
|
103
|
+
|
|
104
|
+
//# sourceMappingURL=collectionOption.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collectionOption.js","names":[],"sources":["../../src/core/collectionOption.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\nimport { flatFieldName, keysOf, optionsObject } from './optionChecks'\nimport { kindOf } from './values'\n\n/** Reshapes one of the plugin's generated collections; handed the finished config, it returns one. */\nexport type CollectionOverrides = (collection: CollectionConfig) => CollectionConfig\n\n/** A plugin collection's name and shape, as each option naming one takes them. */\nexport type AnalyticsCollectionOptions = {\n\t/** The slug every part of the plugin reads the collection under. */\n\tslug?: string\n\t/**\n\t * Reshapes the generated collection last. It may not rename it (`slug` does that) nor take away\n\t * what the plugin reads and writes: the boot checks both, naming the collection and the field.\n\t */\n\toverrides?: CollectionOverrides\n}\n\nexport interface ResolvedCollectionOption {\n\tslug: string\n\toverrides?: CollectionOverrides\n}\n\n/** Only that it is a function can be checked at run time; the option's type promises the rest. */\nconst isOverrides = (value: unknown): value is CollectionOverrides => typeof value === 'function'\n\n/** `overrides` checked at boot: a function or nothing, since no object is ever merged in. */\nexport const overridesOf = (value: unknown, path: string): CollectionOverrides | undefined => {\n\tif (value === undefined) {\n\t\treturn undefined\n\t}\n\tif (!isOverrides(value)) {\n\t\tthrow new Error(\n\t\t\t`analytics: ${path} must be a function, (collection) => collection, got ${kindOf(value)}`\n\t\t)\n\t}\n\treturn value\n}\n\n/** A collection slug option checked at boot, trimmed, or the default when unset. */\nexport const slugOf = (value: unknown, path: string, fallback: string): string => {\n\tif (value === undefined) {\n\t\treturn fallback\n\t}\n\tif (typeof value !== 'string' || value.trim() === '') {\n\t\tthrow new Error(`analytics: ${path} must be a non-empty collection slug, got ${kindOf(value)}`)\n\t}\n\treturn value.trim()\n}\n\n/**\n * One `{ slug, overrides }` option checked at boot. `path` names it in every refusal, and `extra`\n * lists the other keys the option takes beside those two.\n */\nexport const resolveCollectionOption = (\n\tvalue: unknown,\n\twhere: { path: string; fallback: string; extra?: readonly string[] }\n): ResolvedCollectionOption => {\n\tconst { path, fallback, extra = [] } = where\n\tif (value === undefined) {\n\t\treturn { slug: fallback }\n\t}\n\tconst shaped = optionsObject(value, {\n\t\tpath,\n\t\tknown: ['slug', 'overrides', ...extra],\n\t\texample: `an object such as { slug: '${fallback}' }`,\n\t})\n\tconst overrides = overridesOf(shaped.overrides, `${path}.overrides`)\n\treturn {\n\t\tslug: slugOf(shaped.slug, `${path}.slug`, fallback),\n\t\t...(overrides ? { overrides } : {}),\n\t}\n}\n\n/** The field a scoped plugin collection stamps each document's scope into, by default. */\nconst DEFAULT_SCOPE_FIELD = 'scope'\n\ntype CollectionAccess = Partial<CollectionConfig['access']>\n\nconst COLLECTION_ACCESS_KEYS = keysOf<NonNullable<CollectionConfig['access']>>({\n\tadmin: true,\n\tcreate: true,\n\tdelete: true,\n\tread: true,\n\treadVersions: true,\n\tunlock: true,\n\tupdate: true,\n})\n\n/** `access` on one of the plugin's collections: a Payload access function per operation. */\nconst assertCollectionAccess = (value: unknown, path: string): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tconst access = optionsObject(value, {\n\t\tpath,\n\t\tknown: COLLECTION_ACCESS_KEYS,\n\t\texample: 'an object such as { read }',\n\t})\n\tfor (const [operation, fn] of Object.entries(access)) {\n\t\tif (fn !== undefined && typeof fn !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${path}.${operation} must be an access function, got ${kindOf(fn)}`\n\t\t\t)\n\t\t}\n\t}\n}\n\n/** A collection's `fields` overrides: one function per field it may replace. */\nconst assertFieldOverrides = (value: unknown, path: string, known: readonly string[]): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tconst fields = optionsObject(value, {\n\t\tpath,\n\t\tknown,\n\t\texample: 'an object such as { name: ({ defaultField }) => defaultField }',\n\t})\n\tfor (const [name, override] of Object.entries(fields)) {\n\t\tif (override !== undefined && typeof override !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${path}.${name} must be a function receiving { defaultField }, got ${kindOf(override)}`\n\t\t\t)\n\t\t}\n\t}\n}\n\n/** What an opt-in collection whose documents belong to a scope takes (goals, providers). */\ninterface ScopedCollectionOptions<TFields> {\n\tslug?: string\n\tscopeField?: string\n\tfields?: TFields\n\toverrides?: CollectionOverrides\n\taccess?: CollectionAccess\n}\n\n/** A scoped collection option resolved: on or off, its slug and scope field filled. */\nexport interface ResolvedScopedCollection<TFields> {\n\tenabled: boolean\n\tslug: string\n\tscopeField: string\n\tfields?: TFields\n\toverrides?: CollectionOverrides\n\taccess?: CollectionAccess\n}\n\n/** Where a scoped collection option sits, and what it takes. */\ninterface ScopedCollectionAt {\n\tpath: string\n\tfallback: string\n\t/** Every key the option takes. */\n\tknown: readonly string[]\n\t/** The fields its `fields` may replace. */\n\tfieldKeys: readonly string[]\n\t/** The custom slug a refusal shows as an example. */\n\texampleSlug: string\n}\n\n/**\n * A scoped collection option: off when unset or false, on under its defaults for `true`, and an\n * object checked for its keys, `fields`, `access`, `overrides`, slug and scope field.\n */\nexport const resolveScopedCollection = <TFields>(\n\toption: boolean | ScopedCollectionOptions<TFields> | undefined,\n\tat: ScopedCollectionAt\n): ResolvedScopedCollection<TFields> => {\n\tif (option === undefined || typeof option === 'boolean') {\n\t\treturn { enabled: option === true, slug: at.fallback, scopeField: DEFAULT_SCOPE_FIELD }\n\t}\n\tconst shaped = optionsObject(option, {\n\t\tpath: at.path,\n\t\tknown: at.known,\n\t\texample: `true, or an object such as { slug: '${at.exampleSlug}' }`,\n\t})\n\tassertFieldOverrides(shaped.fields, `${at.path}.fields`, at.fieldKeys)\n\tassertCollectionAccess(shaped.access, `${at.path}.access`)\n\tconst overrides = overridesOf(option.overrides, `${at.path}.overrides`)\n\treturn {\n\t\tenabled: true,\n\t\tslug: slugOf(option.slug, `${at.path}.slug`, at.fallback),\n\t\tscopeField: flatFieldName(option.scopeField ?? DEFAULT_SCOPE_FIELD, {\n\t\t\tpath: `${at.path}.scopeField`,\n\t\t\treason: 'the scope stamp writes it as a flat key',\n\t\t}),\n\t\t...(option.fields ? { fields: option.fields } : {}),\n\t\t...(overrides ? { overrides } : {}),\n\t\t...(option.access ? { access: option.access } : {}),\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
//#region src/core/collectionSlug.ts
|
|
2
|
+
/** Whether the instance registered a collection under `slug`. */
|
|
3
|
+
const isCollectionSlug = (payload, slug) => Object.hasOwn(payload.collections, slug);
|
|
4
|
+
//#endregion
|
|
5
|
+
export { isCollectionSlug };
|
|
6
|
+
|
|
7
|
+
//# sourceMappingURL=collectionSlug.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collectionSlug.js","names":[],"sources":["../../src/core/collectionSlug.ts"],"sourcesContent":["import type { CollectionSlug, Payload } from 'payload'\n\n/** Whether the instance registered a collection under `slug`. */\nexport const isCollectionSlug = (payload: Payload, slug: string): slug is CollectionSlug =>\n\tObject.hasOwn(payload.collections, slug)\n"],"mappings":";;AAGA,MAAa,oBAAoB,SAAkB,SAClD,OAAO,OAAO,QAAQ,aAAa,IAAI"}
|