@10x-media/analytics 1.0.0-beta.11 → 1.0.0-beta.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +463 -0
- package/README.md +30 -37
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +7 -9
- package/dist/adapters/ga4/disableKey.js.map +1 -1
- package/dist/adapters/ga4/eventName.d.ts +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +11 -0
- package/dist/adapters/ga4/ga4.js +206 -123
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +2 -3
- package/dist/adapters/ga4/measurementId.js.map +1 -1
- package/dist/adapters/goalRead.js +15 -29
- package/dist/adapters/goalRead.js.map +1 -1
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +13 -13
- package/dist/adapters/plausible/plausible.js +137 -122
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +20 -9
- package/dist/adapters/posthog/posthog.js +179 -113
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +7 -9
- package/dist/adapters/umami/umami.js +184 -172
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +16 -29
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +48 -95
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +100 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/charts/BarList.d.ts +27 -14
- package/dist/charts/BarList.js +38 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +15 -1
- package/dist/charts/bars.js +12 -12
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +193 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +48 -37
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +26 -25
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +258 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +104 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +285 -59
- package/dist/core/contract.js +6 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +473 -157
- package/dist/core/options.js +154 -219
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +112 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +182 -72
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +38 -20
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceOptions.js +94 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +14 -0
- package/dist/exports/adapters/ga4.d.ts +15 -1
- package/dist/exports/adapters/native.d.ts +26 -2
- package/dist/exports/adapters/native.js +4 -1
- package/dist/exports/adapters/plausible.d.ts +15 -1
- package/dist/exports/adapters/posthog.d.ts +15 -1
- package/dist/exports/adapters/umami.d.ts +15 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +41 -13
- package/dist/exports/client.js +21 -9
- package/dist/exports/geo.d.ts +3 -1
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/next.d.ts +18 -1
- package/dist/exports/next.js +3 -1
- package/dist/exports/react.d.ts +3 -2
- package/dist/exports/react.js +1 -2
- package/dist/exports/rsc.d.ts +31 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +17 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +5 -20
- package/dist/exports/tracker.js +3 -14
- package/dist/exports/types.d.ts +40 -14
- package/dist/exports/types.js +5 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +20 -8
- package/dist/fields/AnalyticsPanelField.js +121 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +18 -7
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +217 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
- package/dist/fields/config/FilterDimensionSelectField.js +26 -54
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
- package/dist/fields/config/FilterOperatorSelectField.js +37 -53
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +18 -30
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.js +14 -26
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +31 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +66 -37
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +78 -26
- package/dist/fields/readForDocument.js +446 -116
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +162 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +141 -100
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -26
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +39 -40
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +154 -46
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -27
- package/dist/goals/trackGoalAction.js +38 -52
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +63 -11
- package/dist/index.js +257 -247
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +81 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.d.ts +1 -0
- package/dist/maintenance/taskSchedule.js +62 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +102 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +29 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1623 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +198 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +108 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +4 -1
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +20 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +2 -3
- package/dist/native/ingest/bots.js +8 -13
- package/dist/native/ingest/bots.js.map +1 -1
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +30 -9
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +119 -34
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +60 -7
- package/dist/native/ingest/normalizeEvent.js +226 -61
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +10 -23
- package/dist/native/ingest/requestHost.js.map +1 -1
- package/dist/native/ingest/resolveHostname.d.ts +4 -13
- package/dist/native/ingest/resolveHostname.js +5 -6
- package/dist/native/ingest/resolveHostname.js.map +1 -1
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +82 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +181 -72
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +2 -3
- package/dist/native/ingest/source.js +35 -54
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +20 -10
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +101 -33
- package/dist/native/nativeAdapter.js +375 -317
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +116 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +63 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +430 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +695 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +95 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +384 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +345 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +48 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +656 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +9 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +68 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +4 -24
- package/dist/next/captureRewrites.js +6 -50
- package/dist/next/captureRewrites.js.map +1 -1
- package/dist/next/captureRoute.d.ts +28 -0
- package/dist/next/captureRoute.js +67 -0
- package/dist/next/captureRoute.js.map +1 -0
- package/dist/next/ingestRoute.d.ts +17 -0
- package/dist/next/ingestRoute.js +17 -0
- package/dist/next/ingestRoute.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +3 -25
- package/dist/next/posthogProxyRewrites.js +5 -37
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +336 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +76 -53
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +5 -12
- package/dist/plugin/errors.js +23 -16
- package/dist/plugin/errors.js.map +1 -1
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/jobsAccess.js +91 -0
- package/dist/plugin/jobsAccess.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +155 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +69 -44
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +52 -17
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +64 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +77 -25
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +69 -44
- package/dist/plugin/refreshEndpoint.js.map +1 -1
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +226 -30
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +63 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +6 -5
- package/dist/plugin/scopeChange.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +46 -12
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +22 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +53 -0
- package/dist/providers/collection.js +274 -150
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +76 -0
- package/dist/providers/factory.js +76 -23
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +101 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +318 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +23 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +1 -5
- package/dist/query/fetchQuery.d.ts +25 -32
- package/dist/query/fetchQuery.js +91 -91
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +6 -0
- package/dist/query/parse.js +153 -106
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +26 -17
- package/dist/react/AnalyticsProvider.js +23 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -11
- package/dist/react/useAnalytics.js +22 -24
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/site/AnalyticsScripts.d.ts +34 -0
- package/dist/site/AnalyticsScripts.js +30 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +40 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +69 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -72
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.js +70 -26
- package/dist/surfacing/epoch.js.map +1 -1
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +113 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +28 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +226 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +144 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +4 -10
- package/dist/tracker/createTracker.js +386 -115
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +2 -22
- package/dist/tracker/exclusion.js +53 -21
- package/dist/tracker/exclusion.js.map +1 -1
- package/dist/tracker/gate.js +194 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +21 -14
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +118 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +38 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +64 -20
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +7 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +27 -22
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +26 -22
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +14 -12
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +30 -27
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +86 -63
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +226 -71
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +215 -69
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +209 -67
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +217 -68
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +221 -72
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +212 -67
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +185 -14
- package/dist/translations/keys.js +190 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +214 -69
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +226 -77
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +217 -66
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +217 -66
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +212 -67
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +112 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1528 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +26 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +11 -6
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +8 -10
- package/dist/view/AnalyticsView.js +47 -18
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -229
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +150 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +66 -31
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +95 -10
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +10 -9
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +196 -134
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +118 -30
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +124 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +29 -33
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +123 -82
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +47 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +64 -7
- package/dist/view/viewProps.js +121 -35
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +80 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +129 -123
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +24 -4
- package/dist/widgets/RealtimeCounter.js +91 -77
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +12 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaults.d.ts +4 -7
- package/dist/widgets/defaults.js +4 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +73 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +5 -1
- package/dist/widgets/prepareWidgetRead.js +59 -27
- package/dist/widgets/prepareWidgetRead.js.map +1 -1
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +27 -18
- package/dist/widgets/readForWidget.js +31 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
- package/dist/widgets/readForWidgetBreakdown.js +46 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +17 -23
- package/dist/widgets/readForWidgetGoals.js +50 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
- package/dist/widgets/readForWidgetRealtime.js +51 -27
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +26 -31
- package/dist/widgets/readForWidgetSeries.js +43 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +44 -0
- package/dist/widgets/readMeta.js +47 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +53 -25
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +204 -126
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +4 -3
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +31 -24
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +44 -22
- package/dist/adapters/ga4/disableKey.d.ts +0 -9
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -165
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -39
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -175
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -69
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -106
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/plugin/paths.js +0 -29
- package/dist/plugin/paths.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -29
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -20
- package/dist/tracker/sinks/posthog.d.ts +0 -18
- package/dist/tracker/sinks/umami.d.ts +0 -18
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -76
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
|
@@ -1,27 +1,34 @@
|
|
|
1
|
-
import "
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
1
|
+
import { readReportMode, reportModes } from "../binding/report.js";
|
|
2
|
+
import { readGate } from "../access/readGate.js";
|
|
3
|
+
import { wholeNumberParam } from "../core/values.js";
|
|
4
|
+
import { isMetricKey } from "../core/guards.js";
|
|
5
|
+
import { describeWithCauses } from "../core/sourceErrors.js";
|
|
6
|
+
import { currentDate } from "../core/clock.js";
|
|
7
|
+
import { getRuntime, requestTimezone } from "./runtime.js";
|
|
8
|
+
import { exceedsRangeCap } from "../query/limits.js";
|
|
9
|
+
import { NO_STORE, analyticsError, errorResponse, notAvailableResponse, readDeniedResponse, unauthorizedResponse, untrustedScopeResponse } from "./errors.js";
|
|
10
|
+
import { isTimeframePreset } from "../timeframe/presets.js";
|
|
11
|
+
import { ITEM_PANEL_METRICS, ITEM_PANEL_OPTIONAL_METRICS } from "../fields/itemReport.js";
|
|
12
|
+
import { engineReads, readFieldWith } from "../fields/readForDocument.js";
|
|
7
13
|
import { parseDayOrInstant } from "../query/dates.js";
|
|
8
|
-
import {
|
|
14
|
+
import { readDimensionList } from "../query/parse.js";
|
|
15
|
+
import { resolveBoundDocument, unloadedDocumentResponse } from "./boundDocument.js";
|
|
16
|
+
import { queryParams } from "./queryParams.js";
|
|
9
17
|
//#region src/plugin/documentEndpoint.ts
|
|
10
|
-
const KNOWN_METRICS = new Set(Object.keys(METRIC_KEYS));
|
|
11
18
|
const MAX_METRICS = 8;
|
|
19
|
+
/** A panel row holds three small lists; more would stop being a panel. */
|
|
20
|
+
const MAX_PANEL_DIMENSIONS = 3;
|
|
21
|
+
const MAX_PANEL_ROWS = 25;
|
|
22
|
+
/** A source with no time per pageview (most vendors) leaves that card out without a warning. */
|
|
23
|
+
const PAGE_PANEL_OPTIONAL_METRICS = ["avgDuration"];
|
|
12
24
|
const parseMetrics = (raw) => {
|
|
13
25
|
if (!raw) return null;
|
|
14
|
-
const metrics = raw.split(",").map((m) => m.trim()).filter(
|
|
26
|
+
const metrics = raw.split(",").map((m) => m.trim()).filter(isMetricKey);
|
|
15
27
|
return metrics.length > 0 ? metrics.slice(0, MAX_METRICS) : null;
|
|
16
28
|
};
|
|
17
29
|
/**
|
|
18
|
-
* A custom window
|
|
19
|
-
*
|
|
20
|
-
* its final instant), a datetime must carry `Z` or a `±HH:MM` offset, and anything else,
|
|
21
|
-
* including an offset-less datetime, is rejected. `from` equal to `to` is one whole day for
|
|
22
|
-
* day strings and a zero-width window for two instants, so only the latter is rejected. A
|
|
23
|
-
* rejection names the bound at fault, and an inverted window blames `to`: `from` is the one
|
|
24
|
-
* the reader picked first.
|
|
30
|
+
* A custom window read like the query endpoint's, capped at `MAX_QUERY_RANGE_DAYS`; a `YYYY-MM-DD`
|
|
31
|
+
* day spans the whole day in the reporting timezone. An inverted window blames `to`, picked second.
|
|
25
32
|
*/
|
|
26
33
|
const parseRange = (from, to, timezone) => {
|
|
27
34
|
if (!from) return {
|
|
@@ -48,6 +55,14 @@ const parseRange = (from, to, timezone) => {
|
|
|
48
55
|
ok: false,
|
|
49
56
|
param: "to"
|
|
50
57
|
};
|
|
58
|
+
if (exceedsRangeCap({
|
|
59
|
+
start,
|
|
60
|
+
end
|
|
61
|
+
})) return {
|
|
62
|
+
ok: false,
|
|
63
|
+
param: "to",
|
|
64
|
+
tooLong: true
|
|
65
|
+
};
|
|
51
66
|
return {
|
|
52
67
|
ok: true,
|
|
53
68
|
range: {
|
|
@@ -57,68 +72,76 @@ const parseRange = (from, to, timezone) => {
|
|
|
57
72
|
};
|
|
58
73
|
};
|
|
59
74
|
/**
|
|
60
|
-
* Authenticated GET
|
|
61
|
-
*
|
|
62
|
-
* read the target document (enforced through `findByID`
|
|
63
|
-
* without `overrideAccess`), so analytics never leak for content the user cannot
|
|
64
|
-
* see; an unreadable or missing document is a uniform 404, while a read that fails for
|
|
65
|
-
* any other reason is a logged 500 rather than a 404 that hides a broken install.
|
|
66
|
-
* Timeframe, metrics, and data source are whitelist-validated; `timeframe=custom`
|
|
67
|
-
* requires a parseable `from`/`to` pair.
|
|
75
|
+
* Authenticated GET behind the document panel, in the document's own scope (no parameter names
|
|
76
|
+
* one). Unreadable and missing are one 404; other failures are a logged 500, never a masking 404.
|
|
68
77
|
*/
|
|
69
78
|
const makeDocumentHandler = () => async (req) => {
|
|
70
|
-
if (!req.user) return
|
|
79
|
+
if (!req.user) return unauthorizedResponse();
|
|
71
80
|
const runtime = getRuntime(req.payload);
|
|
72
|
-
if (!runtime) return
|
|
73
|
-
|
|
74
|
-
|
|
81
|
+
if (!runtime) return notAvailableResponse();
|
|
82
|
+
try {
|
|
83
|
+
return await answerDocument(req, runtime);
|
|
84
|
+
} catch (err) {
|
|
85
|
+
req.payload.logger?.error(`analytics: document read failed: ${describeWithCauses(err)}`);
|
|
86
|
+
return errorResponse(500, analyticsError("internal", "analytics: document read failed"));
|
|
87
|
+
}
|
|
88
|
+
};
|
|
89
|
+
const answerDocument = async (req, runtime) => {
|
|
90
|
+
if (!await readGate(runtime, req)) return readDeniedResponse();
|
|
91
|
+
const params = queryParams(req);
|
|
75
92
|
const collection = params.get("collection") ?? "";
|
|
76
93
|
const id = params.get("id") ?? "";
|
|
77
|
-
if (!runtime.bindings[collection] || !id) return
|
|
94
|
+
if (!runtime.bindings[collection] || !id) return unloadedDocumentResponse(404);
|
|
78
95
|
const rawTimeframe = params.get("timeframe") ?? "last30days";
|
|
79
96
|
let timezone;
|
|
80
97
|
let range;
|
|
81
98
|
if (rawTimeframe === "custom") {
|
|
82
99
|
timezone = await requestTimezone(req);
|
|
83
100
|
const parsed = parseRange(params.get("from"), params.get("to"), timezone);
|
|
84
|
-
if (!parsed.ok) return errorResponse(400, analyticsError("invalid_param", "analytics: the custom range could not be read", parsed.param));
|
|
101
|
+
if (!parsed.ok) return errorResponse(400, parsed.tooLong ? analyticsError("range_too_long", `analytics: the range must not exceed 366 days`, parsed.param) : analyticsError("invalid_param", "analytics: the custom range could not be read", parsed.param));
|
|
85
102
|
range = parsed.range;
|
|
86
103
|
}
|
|
87
|
-
const timeframe =
|
|
88
|
-
const
|
|
104
|
+
const timeframe = isTimeframePreset(rawTimeframe) ? rawTimeframe : "last30days";
|
|
105
|
+
const report = readReportMode(params.get("report")) ?? reportModes(runtime.bindings[collection])[0] ?? "page";
|
|
106
|
+
const requested = parseMetrics(params.get("metrics"));
|
|
107
|
+
const metrics = requested ?? (report === "item" ? ITEM_PANEL_METRICS : [
|
|
89
108
|
"pageviews",
|
|
90
109
|
"visitors",
|
|
91
110
|
"sessions",
|
|
92
111
|
"avgDuration"
|
|
93
|
-
];
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
const result = await readForField({
|
|
112
|
+
]);
|
|
113
|
+
const optionalMetrics = parseMetrics(params.get("optional")) ?? (requested === null ? report === "item" ? ITEM_PANEL_OPTIONAL_METRICS : PAGE_PANEL_OPTIONAL_METRICS : []);
|
|
114
|
+
const dimensions = readDimensionList(params.get("dimensions"), MAX_PANEL_DIMENSIONS);
|
|
115
|
+
const rawLimit = wholeNumberParam(params.get("limit"));
|
|
116
|
+
const limit = rawLimit === void 0 ? void 0 : Math.min(Math.max(rawLimit, 1), MAX_PANEL_ROWS);
|
|
117
|
+
const bound = await resolveBoundDocument({
|
|
118
|
+
req,
|
|
119
|
+
collection,
|
|
120
|
+
id
|
|
121
|
+
});
|
|
122
|
+
if (!bound.ok) return unloadedDocumentResponse(bound.status);
|
|
123
|
+
const reads = engineReads({
|
|
124
|
+
priority: "interactive",
|
|
125
|
+
...params.get("fresh") === "1" ? { allowStale: false } : {}
|
|
126
|
+
});
|
|
127
|
+
const result = await readFieldWith({
|
|
110
128
|
req,
|
|
111
129
|
collectionSlug: collection,
|
|
112
|
-
data,
|
|
130
|
+
data: bound.data,
|
|
113
131
|
metrics,
|
|
132
|
+
optionalMetrics,
|
|
114
133
|
timeframe,
|
|
115
134
|
range,
|
|
116
135
|
...timezone !== void 0 ? { timezone } : {},
|
|
136
|
+
...dimensions.length > 0 ? { dimensions } : {},
|
|
137
|
+
...limit === void 0 ? {} : { limit },
|
|
117
138
|
adapterId: params.get("dataSource") ?? void 0,
|
|
118
|
-
now:
|
|
139
|
+
now: currentDate(),
|
|
119
140
|
compare: params.get("compare") === "1",
|
|
120
|
-
series: params.get("series") === "1"
|
|
121
|
-
|
|
141
|
+
series: params.get("series") === "1",
|
|
142
|
+
report
|
|
143
|
+
}, reads);
|
|
144
|
+
if (result.untrustedScope) return untrustedScopeResponse();
|
|
122
145
|
return Response.json(result, { headers: NO_STORE });
|
|
123
146
|
};
|
|
124
147
|
//#endregion
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"documentEndpoint.js","names":[],"sources":["../../src/plugin/documentEndpoint.ts"],"sourcesContent":["import {
|
|
1
|
+
{"version":3,"file":"documentEndpoint.js","names":[],"sources":["../../src/plugin/documentEndpoint.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport { readGate } from '../access/readGate'\nimport { readReportMode, reportModes } from '../binding/report'\nimport { currentDate } from '../core/clock'\nimport type { DateRange, MetricKey } from '../core/contract'\nimport { isMetricKey } from '../core/guards'\nimport { describeWithCauses } from '../core/sourceErrors'\nimport { wholeNumberParam } from '../core/values'\nimport { ITEM_PANEL_METRICS, ITEM_PANEL_OPTIONAL_METRICS } from '../fields/itemReport'\nimport { engineReads, readFieldWith } from '../fields/readForDocument'\nimport { parseDayOrInstant } from '../query/dates'\nimport { exceedsRangeCap, MAX_QUERY_RANGE_DAYS } from '../query/limits'\nimport { readDimensionList } from '../query/parse'\nimport { isTimeframePreset, type TimeframePreset } from '../timeframe/presets'\nimport { resolveBoundDocument, unloadedDocumentResponse } from './boundDocument'\nimport {\n\tanalyticsError,\n\terrorResponse,\n\tNO_STORE,\n\tnotAvailableResponse,\n\treadDeniedResponse,\n\tunauthorizedResponse,\n\tuntrustedScopeResponse,\n} from './errors'\nimport { queryParams } from './queryParams'\nimport { type AnalyticsRuntime, getRuntime, requestTimezone } from './runtime'\n\nconst MAX_METRICS = 8\n/** A panel row holds three small lists; more would stop being a panel. */\nconst MAX_PANEL_DIMENSIONS = 3\nconst MAX_PANEL_ROWS = 25\n/** A source with no time per pageview (most vendors) leaves that card out without a warning. */\nconst PAGE_PANEL_OPTIONAL_METRICS: MetricKey[] = ['avgDuration']\n\nconst parseMetrics = (raw: string | null): MetricKey[] | null => {\n\tif (!raw) {\n\t\treturn null\n\t}\n\tconst metrics = raw\n\t\t.split(',')\n\t\t.map((m) => m.trim())\n\t\t.filter(isMetricKey)\n\treturn metrics.length > 0 ? metrics.slice(0, MAX_METRICS) : null\n}\n\ntype RangeResult =\n\t| { ok: true; range: DateRange }\n\t| { ok: false; param: 'from' | 'to'; tooLong?: true }\n\n/**\n * A custom window read like the query endpoint's, capped at `MAX_QUERY_RANGE_DAYS`; a `YYYY-MM-DD`\n * day spans the whole day in the reporting timezone. An inverted window blames `to`, picked second.\n */\nconst parseRange = (from: string | null, to: string | null, timezone: string): RangeResult => {\n\tif (!from) {\n\t\treturn { ok: false, param: 'from' }\n\t}\n\tif (!to) {\n\t\treturn { ok: false, param: 'to' }\n\t}\n\tconst start = parseDayOrInstant(from, { timezone, edge: 'start' })\n\tif (!start) {\n\t\treturn { ok: false, param: 'from' }\n\t}\n\tconst end = parseDayOrInstant(to, { timezone, edge: 'end' })\n\tif (!end || end.getTime() <= start.getTime()) {\n\t\treturn { ok: false, param: 'to' }\n\t}\n\tif (exceedsRangeCap({ start, end })) {\n\t\treturn { ok: false, param: 'to', tooLong: true }\n\t}\n\treturn { ok: true, range: { start, end } }\n}\n\n/**\n * Authenticated GET behind the document panel, in the document's own scope (no parameter names\n * one). Unreadable and missing are one 404; other failures are a logged 500, never a masking 404.\n */\nexport const makeDocumentHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn unauthorizedResponse()\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn notAvailableResponse()\n\t}\n\ttry {\n\t\treturn await answerDocument(req, runtime)\n\t} catch (err) {\n\t\treq.payload.logger?.error(`analytics: document read failed: ${describeWithCauses(err)}`)\n\t\treturn errorResponse(500, analyticsError('internal', 'analytics: document read failed'))\n\t}\n}\n\nconst answerDocument = async (\n\treq: PayloadRequest,\n\truntime: AnalyticsRuntime\n): Promise<Response> => {\n\tif (!(await readGate(runtime, req))) {\n\t\treturn readDeniedResponse()\n\t}\n\tconst params = queryParams(req)\n\tconst collection = params.get('collection') ?? ''\n\tconst id = params.get('id') ?? ''\n\tif (!runtime.bindings[collection] || !id) {\n\t\treturn unloadedDocumentResponse(404)\n\t}\n\tconst rawTimeframe = params.get('timeframe') ?? 'last30days'\n\tlet timezone: string | undefined\n\tlet range: DateRange | undefined\n\tif (rawTimeframe === 'custom') {\n\t\t// Custom bounds name calendar days, so the reporting timezone must resolve before they are\n\t\t// read; a preset resolves its window inside `readForField`.\n\t\ttimezone = await requestTimezone(req)\n\t\tconst parsed = parseRange(params.get('from'), params.get('to'), timezone)\n\t\tif (!parsed.ok) {\n\t\t\treturn errorResponse(\n\t\t\t\t400,\n\t\t\t\tparsed.tooLong\n\t\t\t\t\t? analyticsError(\n\t\t\t\t\t\t\t'range_too_long',\n\t\t\t\t\t\t\t`analytics: the range must not exceed ${MAX_QUERY_RANGE_DAYS} days`,\n\t\t\t\t\t\t\tparsed.param\n\t\t\t\t\t\t)\n\t\t\t\t\t: analyticsError(\n\t\t\t\t\t\t\t'invalid_param',\n\t\t\t\t\t\t\t'analytics: the custom range could not be read',\n\t\t\t\t\t\t\tparsed.param\n\t\t\t\t\t\t)\n\t\t\t)\n\t\t}\n\t\trange = parsed.range\n\t}\n\tconst timeframe: TimeframePreset = isTimeframePreset(rawTimeframe) ? rawTimeframe : 'last30days'\n\tconst report =\n\t\treadReportMode(params.get('report')) ?? reportModes(runtime.bindings[collection])[0] ?? 'page'\n\tconst requested = parseMetrics(params.get('metrics'))\n\tconst metrics =\n\t\trequested ??\n\t\t(report === 'item' ? ITEM_PANEL_METRICS : ['pageviews', 'visitors', 'sessions', 'avgDuration'])\n\t// Metrics the panel asked for on spec, so a source serving none of them warns nobody.\n\tconst optionalMetrics =\n\t\tparseMetrics(params.get('optional')) ??\n\t\t(requested === null\n\t\t\t? report === 'item'\n\t\t\t\t? ITEM_PANEL_OPTIONAL_METRICS\n\t\t\t\t: PAGE_PANEL_OPTIONAL_METRICS\n\t\t\t: [])\n\tconst dimensions = readDimensionList(params.get('dimensions'), MAX_PANEL_DIMENSIONS)\n\tconst rawLimit = wholeNumberParam(params.get('limit'))\n\tconst limit = rawLimit === undefined ? undefined : Math.min(Math.max(rawLimit, 1), MAX_PANEL_ROWS)\n\tconst bound = await resolveBoundDocument({ req, collection, id })\n\tif (!bound.ok) {\n\t\treturn unloadedDocumentResponse(bound.status)\n\t}\n\t// `fresh=1` waits for the source rather than answering with an expired entry: the panel asks it\n\t// when its first render could only show saved numbers, and falls back to them if the source fails.\n\tconst reads = engineReads({\n\t\tpriority: 'interactive',\n\t\t...(params.get('fresh') === '1' ? { allowStale: false } : {}),\n\t})\n\tconst result = await readFieldWith(\n\t\t{\n\t\t\treq,\n\t\t\tcollectionSlug: collection,\n\t\t\tdata: bound.data,\n\t\t\tmetrics,\n\t\t\toptionalMetrics,\n\t\t\ttimeframe,\n\t\t\trange,\n\t\t\t...(timezone !== undefined ? { timezone } : {}),\n\t\t\t...(dimensions.length > 0 ? { dimensions } : {}),\n\t\t\t...(limit === undefined ? {} : { limit }),\n\t\t\tadapterId: params.get('dataSource') ?? undefined,\n\t\t\tnow: currentDate(),\n\t\t\tcompare: params.get('compare') === '1',\n\t\t\tseries: params.get('series') === '1',\n\t\t\treport,\n\t\t},\n\t\treads\n\t)\n\tif (result.untrustedScope) {\n\t\treturn untrustedScopeResponse()\n\t}\n\treturn Response.json(result, { headers: NO_STORE })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA2BA,MAAM,cAAc;;AAEpB,MAAM,uBAAuB;AAC7B,MAAM,iBAAiB;;AAEvB,MAAM,8BAA2C,CAAC,aAAa;AAE/D,MAAM,gBAAgB,QAA2C;CAChE,IAAI,CAAC,KACJ,OAAO;CAER,MAAM,UAAU,IACd,MAAM,GAAG,EACT,KAAK,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,WAAW;CACpB,OAAO,QAAQ,SAAS,IAAI,QAAQ,MAAM,GAAG,WAAW,IAAI;AAC7D;;;;;AAUA,MAAM,cAAc,MAAqB,IAAmB,aAAkC;CAC7F,IAAI,CAAC,MACJ,OAAO;EAAE,IAAI;EAAO,OAAO;CAAO;CAEnC,IAAI,CAAC,IACJ,OAAO;EAAE,IAAI;EAAO,OAAO;CAAK;CAEjC,MAAM,QAAQ,kBAAkB,MAAM;EAAE;EAAU,MAAM;CAAQ,CAAC;CACjE,IAAI,CAAC,OACJ,OAAO;EAAE,IAAI;EAAO,OAAO;CAAO;CAEnC,MAAM,MAAM,kBAAkB,IAAI;EAAE;EAAU,MAAM;CAAM,CAAC;CAC3D,IAAI,CAAC,OAAO,IAAI,QAAQ,KAAK,MAAM,QAAQ,GAC1C,OAAO;EAAE,IAAI;EAAO,OAAO;CAAK;CAEjC,IAAI,gBAAgB;EAAE;EAAO;CAAI,CAAC,GACjC,OAAO;EAAE,IAAI;EAAO,OAAO;EAAM,SAAS;CAAK;CAEhD,OAAO;EAAE,IAAI;EAAM,OAAO;GAAE;GAAO;EAAI;CAAE;AAC1C;;;;;AAMA,MAAa,4BAA4C,OAAO,QAAQ;CACvE,IAAI,CAAC,IAAI,MACR,OAAO,qBAAqB;CAE7B,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,qBAAqB;CAE7B,IAAI;EACH,OAAO,MAAM,eAAe,KAAK,OAAO;CACzC,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,MAAM,oCAAoC,mBAAmB,GAAG,GAAG;EACvF,OAAO,cAAc,KAAK,eAAe,YAAY,iCAAiC,CAAC;CACxF;AACD;AAEA,MAAM,iBAAiB,OACtB,KACA,YACuB;CACvB,IAAI,CAAE,MAAM,SAAS,SAAS,GAAG,GAChC,OAAO,mBAAmB;CAE3B,MAAM,SAAS,YAAY,GAAG;CAC9B,MAAM,aAAa,OAAO,IAAI,YAAY,KAAK;CAC/C,MAAM,KAAK,OAAO,IAAI,IAAI,KAAK;CAC/B,IAAI,CAAC,QAAQ,SAAS,eAAe,CAAC,IACrC,OAAO,yBAAyB,GAAG;CAEpC,MAAM,eAAe,OAAO,IAAI,WAAW,KAAK;CAChD,IAAI;CACJ,IAAI;CACJ,IAAI,iBAAiB,UAAU;EAG9B,WAAW,MAAM,gBAAgB,GAAG;EACpC,MAAM,SAAS,WAAW,OAAO,IAAI,MAAM,GAAG,OAAO,IAAI,IAAI,GAAG,QAAQ;EACxE,IAAI,CAAC,OAAO,IACX,OAAO,cACN,KACA,OAAO,UACJ,eACA,kBACA,iDACA,OAAO,KACR,IACC,eACA,iBACA,iDACA,OAAO,KACR,CACH;EAED,QAAQ,OAAO;CAChB;CACA,MAAM,YAA6B,kBAAkB,YAAY,IAAI,eAAe;CACpF,MAAM,SACL,eAAe,OAAO,IAAI,QAAQ,CAAC,KAAK,YAAY,QAAQ,SAAS,WAAW,EAAE,MAAM;CACzF,MAAM,YAAY,aAAa,OAAO,IAAI,SAAS,CAAC;CACpD,MAAM,UACL,cACC,WAAW,SAAS,qBAAqB;EAAC;EAAa;EAAY;EAAY;CAAa;CAE9F,MAAM,kBACL,aAAa,OAAO,IAAI,UAAU,CAAC,MAClC,cAAc,OACZ,WAAW,SACV,8BACA,8BACD,CAAC;CACL,MAAM,aAAa,kBAAkB,OAAO,IAAI,YAAY,GAAG,oBAAoB;CACnF,MAAM,WAAW,iBAAiB,OAAO,IAAI,OAAO,CAAC;CACrD,MAAM,QAAQ,aAAa,KAAA,IAAY,KAAA,IAAY,KAAK,IAAI,KAAK,IAAI,UAAU,CAAC,GAAG,cAAc;CACjG,MAAM,QAAQ,MAAM,qBAAqB;EAAE;EAAK;EAAY;CAAG,CAAC;CAChE,IAAI,CAAC,MAAM,IACV,OAAO,yBAAyB,MAAM,MAAM;CAI7C,MAAM,QAAQ,YAAY;EACzB,UAAU;EACV,GAAI,OAAO,IAAI,OAAO,MAAM,MAAM,EAAE,YAAY,MAAM,IAAI,CAAC;CAC5D,CAAC;CACD,MAAM,SAAS,MAAM,cACpB;EACC;EACA,gBAAgB;EAChB,MAAM,MAAM;EACZ;EACA;EACA;EACA;EACA,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;EAC7C,GAAI,WAAW,SAAS,IAAI,EAAE,WAAW,IAAI,CAAC;EAC9C,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;EACvC,WAAW,OAAO,IAAI,YAAY,KAAK,KAAA;EACvC,KAAK,YAAY;EACjB,SAAS,OAAO,IAAI,SAAS,MAAM;EACnC,QAAQ,OAAO,IAAI,QAAQ,MAAM;EACjC;CACD,GACA,KACD;CACA,IAAI,OAAO,gBACV,OAAO,uBAAuB;CAE/B,OAAO,SAAS,KAAK,QAAQ,EAAE,SAAS,SAAS,CAAC;AACnD"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { scopeGates } from "./runtime.js";
|
|
2
|
+
import { resolveRequestedScope } from "../core/scopedRead.js";
|
|
3
|
+
import { scopeFromDocument } from "../fields/documentScope.js";
|
|
4
|
+
//#region src/plugin/documentScopes.ts
|
|
5
|
+
/**
|
|
6
|
+
* Field a collection's documents carry their scope in: the binding's server-side `scopeField`, so
|
|
7
|
+
* no request can choose which field a scope is read out of.
|
|
8
|
+
*/
|
|
9
|
+
const scopeFieldFor = (runtime, collection) => runtime.bindings[collection]?.scopeField ?? false;
|
|
10
|
+
/**
|
|
11
|
+
* A document's scope, gated via {@link resolveRequestedScope} like a named `scope` parameter.
|
|
12
|
+
* Payload read access is a separate first gate: a readable foreign row still reports nothing.
|
|
13
|
+
*/
|
|
14
|
+
const resolveDocumentScope = async (args) => {
|
|
15
|
+
const { runtime, req } = args;
|
|
16
|
+
const scope = scopeFromDocument(args.data, scopeFieldFor(runtime, args.collection));
|
|
17
|
+
if (scope === null) return {
|
|
18
|
+
ok: true,
|
|
19
|
+
scope: null
|
|
20
|
+
};
|
|
21
|
+
const requested = await resolveRequestedScope({
|
|
22
|
+
runtime,
|
|
23
|
+
req,
|
|
24
|
+
raw: scope,
|
|
25
|
+
gates: args.gates ?? scopeGates(runtime, req)
|
|
26
|
+
});
|
|
27
|
+
if (!requested.ok || requested.scope === null) return { ok: false };
|
|
28
|
+
return {
|
|
29
|
+
ok: true,
|
|
30
|
+
scope: requested.scope,
|
|
31
|
+
gated: requested.gated
|
|
32
|
+
};
|
|
33
|
+
};
|
|
34
|
+
//#endregion
|
|
35
|
+
export { resolveDocumentScope };
|
|
36
|
+
|
|
37
|
+
//# sourceMappingURL=documentScopes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"documentScopes.js","names":[],"sources":["../../src/plugin/documentScopes.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { GatedScope } from '../access/principal'\nimport type { BindingDoc, DocumentScopeField } from '../binding/types'\nimport { resolveRequestedScope } from '../core/scopedRead'\nimport { scopeFromDocument } from '../fields/documentScope'\nimport { type AnalyticsRuntime, type ScopeGates, scopeGates } from './runtime'\n\n/**\n * Field a collection's documents carry their scope in: the binding's server-side `scopeField`, so\n * no request can choose which field a scope is read out of.\n */\nexport const scopeFieldFor = (runtime: AnalyticsRuntime, collection: string): DocumentScopeField =>\n\truntime.bindings[collection]?.scopeField ?? false\n\n/**\n * A document's own scope, or a refusal to read across into it. `gated` is that scope cleared\n * for the request, absent when the document names none and the read stays on the request's own.\n */\nexport type DocumentScope =\n\t| { ok: true; scope: null }\n\t| { ok: true; scope: string; gated: GatedScope }\n\t| { ok: false }\n\ninterface DocumentScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tcollection: string\n\tdata: BindingDoc\n\t/** Shared cross-scope decisions; one set is created per call when omitted. */\n\tgates?: ScopeGates\n}\n\n/**\n * A document's scope, gated via {@link resolveRequestedScope} like a named `scope` parameter.\n * Payload read access is a separate first gate: a readable foreign row still reports nothing.\n */\nexport const resolveDocumentScope = async (args: DocumentScopeArgs): Promise<DocumentScope> => {\n\tconst { runtime, req } = args\n\tconst scope = scopeFromDocument(args.data, scopeFieldFor(runtime, args.collection))\n\tif (scope === null) {\n\t\treturn { ok: true, scope: null }\n\t}\n\tconst requested = await resolveRequestedScope({\n\t\truntime,\n\t\treq,\n\t\traw: scope,\n\t\tgates: args.gates ?? scopeGates(runtime, req),\n\t})\n\tif (!requested.ok || requested.scope === null) {\n\t\treturn { ok: false }\n\t}\n\treturn { ok: true, scope: requested.scope, gated: requested.gated }\n}\n"],"mappings":";;;;;;;;AAWA,MAAa,iBAAiB,SAA2B,eACxD,QAAQ,SAAS,aAAa,cAAc;;;;;AAwB7C,MAAa,uBAAuB,OAAO,SAAoD;CAC9F,MAAM,EAAE,SAAS,QAAQ;CACzB,MAAM,QAAQ,kBAAkB,KAAK,MAAM,cAAc,SAAS,KAAK,UAAU,CAAC;CAClF,IAAI,UAAU,MACb,OAAO;EAAE,IAAI;EAAM,OAAO;CAAK;CAEhC,MAAM,YAAY,MAAM,sBAAsB;EAC7C;EACA;EACA,KAAK;EACL,OAAO,KAAK,SAAS,WAAW,SAAS,GAAG;CAC7C,CAAC;CACD,IAAI,CAAC,UAAU,MAAM,UAAU,UAAU,MACxC,OAAO,EAAE,IAAI,MAAM;CAEpB,OAAO;EAAE,IAAI;EAAM,OAAO,UAAU;EAAO,OAAO,UAAU;CAAM;AACnE"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { hasMethods } from "../core/values.js";
|
|
2
|
+
import { peerError } from "./peers.js";
|
|
3
|
+
//#region src/plugin/encrypted.ts
|
|
4
|
+
const HELPERS = [
|
|
5
|
+
"decryptFieldValue",
|
|
6
|
+
"encryptedField",
|
|
7
|
+
"isSealed",
|
|
8
|
+
"validateEncryptedBoot",
|
|
9
|
+
"withEncryptedQueryRewrite",
|
|
10
|
+
"withRawEncrypted"
|
|
11
|
+
];
|
|
12
|
+
const isEncryptedModule = (mod) => hasMethods(mod, HELPERS);
|
|
13
|
+
/**
|
|
14
|
+
* The encrypted field helpers the providers collection is built on. A literal specifier, so file
|
|
15
|
+
* tracing ships the required peer and a bundler resolves the one copy the host's imports use.
|
|
16
|
+
*/
|
|
17
|
+
const loadEncrypted = async () => {
|
|
18
|
+
const mod = await import("@10x-media/fields/encrypted");
|
|
19
|
+
if (!isEncryptedModule(mod)) throw new Error(peerError("@10x-media/fields", "has no encrypted field helpers. Update it: pnpm add @10x-media/fields@latest"));
|
|
20
|
+
return mod;
|
|
21
|
+
};
|
|
22
|
+
//#endregion
|
|
23
|
+
export { loadEncrypted };
|
|
24
|
+
|
|
25
|
+
//# sourceMappingURL=encrypted.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"encrypted.js","names":[],"sources":["../../src/plugin/encrypted.ts"],"sourcesContent":["import { hasMethods } from '../core/values'\nimport { peerError } from './peers'\n\ntype EncryptedModule = typeof import('@10x-media/fields/encrypted')\n\nconst HELPERS: readonly string[] = [\n\t'decryptFieldValue',\n\t'encryptedField',\n\t'isSealed',\n\t'validateEncryptedBoot',\n\t'withEncryptedQueryRewrite',\n\t'withRawEncrypted',\n]\n\nconst isEncryptedModule = (mod: unknown): mod is EncryptedModule => hasMethods(mod, HELPERS)\n\n/**\n * The encrypted field helpers the providers collection is built on. A literal specifier, so file\n * tracing ships the required peer and a bundler resolves the one copy the host's imports use.\n */\nexport const loadEncrypted = async (): Promise<EncryptedModule> => {\n\tconst mod: unknown = await import('@10x-media/fields/encrypted')\n\tif (!isEncryptedModule(mod)) {\n\t\tthrow new Error(\n\t\t\tpeerError(\n\t\t\t\t'@10x-media/fields',\n\t\t\t\t'has no encrypted field helpers. Update it: pnpm add @10x-media/fields@latest'\n\t\t\t)\n\t\t)\n\t}\n\treturn mod\n}\n"],"mappings":";;;AAKA,MAAM,UAA6B;CAClC;CACA;CACA;CACA;CACA;CACA;AACD;AAEA,MAAM,qBAAqB,QAAyC,WAAW,KAAK,OAAO;;;;;AAM3F,MAAa,gBAAgB,YAAsC;CAClE,MAAM,MAAe,MAAM,OAAO;CAClC,IAAI,CAAC,kBAAkB,GAAG,GACzB,MAAM,IAAI,MACT,UACC,qBACA,8EACD,CACD;CAED,OAAO;AACR"}
|
package/dist/plugin/errors.d.ts
CHANGED
|
@@ -1,15 +1,9 @@
|
|
|
1
1
|
//#region src/plugin/errors.d.ts
|
|
2
2
|
/**
|
|
3
|
-
* Every code
|
|
4
|
-
*
|
|
5
|
-
* import {@link readErrorCode} from here to branch on what an endpoint said.
|
|
6
|
-
*
|
|
7
|
-
* `invalid_param` and the `unsupported_*` family are the query parser's `400`s;
|
|
8
|
-
* `unauthorized` (`401`), `forbidden` (`403`), `not_found` (`404`), `unknown_source`
|
|
9
|
-
* (`404`), `untrusted_scope` (`400`), `payload_too_large` (`413`), `unavailable` (`503`)
|
|
10
|
-
* and `internal` (`500`) are raised by the handlers themselves.
|
|
3
|
+
* Every code an analytics endpoint answers with, so no handler invents one only its client knows.
|
|
4
|
+
* Free of Payload and Node imports: admin clients import {@link readErrorCode} from here.
|
|
11
5
|
*/
|
|
12
|
-
declare const ANALYTICS_ERROR_CODES: readonly ["invalid_param", "unsupported_metric", "unsupported_dimension", "unsupported_filter", "unsupported_operator", "unsupported_granularity", "range_too_long", "unknown_source", "untrusted_scope", "not_found", "payload_too_large", "unauthorized", "forbidden", "unavailable", "internal"];
|
|
6
|
+
declare const ANALYTICS_ERROR_CODES: readonly ["invalid_param", "unsupported_metric", "unsupported_dimension", "unsupported_filter", "unsupported_operator", "unsupported_granularity", "range_too_long", "unknown_source", "untrusted_scope", "not_found", "payload_too_large", "unauthorized", "forbidden", "rate_limited", "source_misconfigured", "unavailable", "internal"];
|
|
13
7
|
type AnalyticsErrorCode = (typeof ANALYTICS_ERROR_CODES)[number];
|
|
14
8
|
/** Wire shape of a refused request: `param` names the parameter or field at fault. */
|
|
15
9
|
interface AnalyticsError {
|
|
@@ -21,9 +15,8 @@ declare const analyticsError: (code: AnalyticsErrorCode, message: string, param?
|
|
|
21
15
|
/** The code an endpoint answered with, or undefined when the body is not the envelope. */
|
|
22
16
|
declare const readErrorCode: (body: unknown) => AnalyticsErrorCode | undefined;
|
|
23
17
|
/**
|
|
24
|
-
* {@link readError} over
|
|
25
|
-
*
|
|
26
|
-
* carries the failure.
|
|
18
|
+
* {@link readError} over an unread response. A non-JSON or empty body reads as no error rather than
|
|
19
|
+
* throwing, since the status still carries the failure.
|
|
27
20
|
*/
|
|
28
21
|
declare const readResponseError: (res: Response) => Promise<AnalyticsError | undefined>;
|
|
29
22
|
//#endregion
|
package/dist/plugin/errors.js
CHANGED
|
@@ -1,13 +1,8 @@
|
|
|
1
|
+
import { isRecord } from "../core/values.js";
|
|
1
2
|
//#region src/plugin/errors.ts
|
|
2
3
|
/**
|
|
3
|
-
* Every code
|
|
4
|
-
*
|
|
5
|
-
* import {@link readErrorCode} from here to branch on what an endpoint said.
|
|
6
|
-
*
|
|
7
|
-
* `invalid_param` and the `unsupported_*` family are the query parser's `400`s;
|
|
8
|
-
* `unauthorized` (`401`), `forbidden` (`403`), `not_found` (`404`), `unknown_source`
|
|
9
|
-
* (`404`), `untrusted_scope` (`400`), `payload_too_large` (`413`), `unavailable` (`503`)
|
|
10
|
-
* and `internal` (`500`) are raised by the handlers themselves.
|
|
4
|
+
* Every code an analytics endpoint answers with, so no handler invents one only its client knows.
|
|
5
|
+
* Free of Payload and Node imports: admin clients import {@link readErrorCode} from here.
|
|
11
6
|
*/
|
|
12
7
|
const ANALYTICS_ERROR_CODES = [
|
|
13
8
|
"invalid_param",
|
|
@@ -23,6 +18,8 @@ const ANALYTICS_ERROR_CODES = [
|
|
|
23
18
|
"payload_too_large",
|
|
24
19
|
"unauthorized",
|
|
25
20
|
"forbidden",
|
|
21
|
+
"rate_limited",
|
|
22
|
+
"source_misconfigured",
|
|
26
23
|
"unavailable",
|
|
27
24
|
"internal"
|
|
28
25
|
];
|
|
@@ -35,6 +32,11 @@ const analyticsError = (code, message, param) => ({
|
|
|
35
32
|
const NO_STORE = { "Cache-Control": "private, no-store" };
|
|
36
33
|
/** How long a client should wait out a provider outage before retrying the same read. */
|
|
37
34
|
const RETRY_AFTER = { "Retry-After": "30" };
|
|
35
|
+
/**
|
|
36
|
+
* A `Retry-After` header for a wait in milliseconds, in whole seconds and never below 1; the
|
|
37
|
+
* default 30 seconds when the wait is unknown.
|
|
38
|
+
*/
|
|
39
|
+
const retryAfter = (ms) => ms === void 0 ? RETRY_AFTER : { "Retry-After": String(Math.max(1, Math.ceil(ms / 1e3))) };
|
|
38
40
|
/** An endpoint's error answer: coded body, never cached, headers merged over `NO_STORE`. */
|
|
39
41
|
const errorResponse = (status, error, headers = {}) => Response.json({ error }, {
|
|
40
42
|
status,
|
|
@@ -43,13 +45,19 @@ const errorResponse = (status, error, headers = {}) => Response.json({ error },
|
|
|
43
45
|
...headers
|
|
44
46
|
}
|
|
45
47
|
});
|
|
48
|
+
/** 401 for a request with no signed-in user. */
|
|
49
|
+
const unauthorizedResponse = () => errorResponse(401, analyticsError("unauthorized", "analytics: authentication required"));
|
|
50
|
+
/** 403 for a reader `access.read` turns away. */
|
|
51
|
+
const readDeniedResponse = () => errorResponse(403, analyticsError("forbidden", "analytics: read access denied"));
|
|
52
|
+
/** 503 while no runtime is registered; as retryable as a provider outage, so it waits as long. */
|
|
53
|
+
const notAvailableResponse = () => errorResponse(503, analyticsError("unavailable", "analytics: not available"), RETRY_AFTER);
|
|
54
|
+
/** 400 for a scope the request may not read; `param` names the parameter that carried it. */
|
|
55
|
+
const untrustedScopeResponse = (param) => errorResponse(400, analyticsError("untrusted_scope", "analytics: scope is not permitted for this request", param));
|
|
46
56
|
const CODES = new Set(ANALYTICS_ERROR_CODES);
|
|
47
|
-
const isRecord = (value) => typeof value === "object" && value !== null;
|
|
48
57
|
const isErrorCode = (value) => CODES.has(value);
|
|
49
58
|
/**
|
|
50
|
-
* The error
|
|
51
|
-
*
|
|
52
|
-
* A code added by a newer server therefore reads as a generic failure rather than as a lie.
|
|
59
|
+
* The error in a parsed body, or undefined for a non-envelope body or a code this version never
|
|
60
|
+
* sent, so a newer server's code reads as a generic failure rather than a lie.
|
|
53
61
|
*/
|
|
54
62
|
const readError = (body) => {
|
|
55
63
|
if (!isRecord(body)) return;
|
|
@@ -62,9 +70,8 @@ const readError = (body) => {
|
|
|
62
70
|
/** The code an endpoint answered with, or undefined when the body is not the envelope. */
|
|
63
71
|
const readErrorCode = (body) => readError(body)?.code;
|
|
64
72
|
/**
|
|
65
|
-
* {@link readError} over
|
|
66
|
-
*
|
|
67
|
-
* carries the failure.
|
|
73
|
+
* {@link readError} over an unread response. A non-JSON or empty body reads as no error rather than
|
|
74
|
+
* throwing, since the status still carries the failure.
|
|
68
75
|
*/
|
|
69
76
|
const readResponseError = async (res) => {
|
|
70
77
|
try {
|
|
@@ -74,6 +81,6 @@ const readResponseError = async (res) => {
|
|
|
74
81
|
}
|
|
75
82
|
};
|
|
76
83
|
//#endregion
|
|
77
|
-
export { ANALYTICS_ERROR_CODES, NO_STORE, RETRY_AFTER, analyticsError, errorResponse, readErrorCode, readResponseError };
|
|
84
|
+
export { ANALYTICS_ERROR_CODES, NO_STORE, RETRY_AFTER, analyticsError, errorResponse, notAvailableResponse, readDeniedResponse, readErrorCode, readResponseError, retryAfter, unauthorizedResponse, untrustedScopeResponse };
|
|
78
85
|
|
|
79
86
|
//# sourceMappingURL=errors.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","names":[],"sources":["../../src/plugin/errors.ts"],"sourcesContent":["/**\n * Every code
|
|
1
|
+
{"version":3,"file":"errors.js","names":[],"sources":["../../src/plugin/errors.ts"],"sourcesContent":["import { isRecord } from '../core/values'\n\n/**\n * Every code an analytics endpoint answers with, so no handler invents one only its client knows.\n * Free of Payload and Node imports: admin clients import {@link readErrorCode} from here.\n */\nexport const ANALYTICS_ERROR_CODES = [\n\t'invalid_param',\n\t'unsupported_metric',\n\t'unsupported_dimension',\n\t'unsupported_filter',\n\t'unsupported_operator',\n\t'unsupported_granularity',\n\t'range_too_long',\n\t'unknown_source',\n\t'untrusted_scope',\n\t'not_found',\n\t'payload_too_large',\n\t'unauthorized',\n\t'forbidden',\n\t'rate_limited',\n\t'source_misconfigured',\n\t'unavailable',\n\t'internal',\n] as const\n\nexport type AnalyticsErrorCode = (typeof ANALYTICS_ERROR_CODES)[number]\n\n/** Wire shape of a refused request: `param` names the parameter or field at fault. */\nexport interface AnalyticsError {\n\tcode: AnalyticsErrorCode\n\tmessage: string\n\tparam?: string\n}\n\nexport const analyticsError = (\n\tcode: AnalyticsErrorCode,\n\tmessage: string,\n\tparam?: string\n): AnalyticsError => ({\n\tcode,\n\tmessage,\n\t...(param === undefined ? {} : { param }),\n})\n\n/** Scope depends on the caller's cookies, so no shared cache may ever hold an answer. */\nexport const NO_STORE = { 'Cache-Control': 'private, no-store' }\n\n/** How long a client should wait out a provider outage before retrying the same read. */\nexport const RETRY_AFTER = { 'Retry-After': '30' }\n\n/**\n * A `Retry-After` header for a wait in milliseconds, in whole seconds and never below 1; the\n * default 30 seconds when the wait is unknown.\n */\nexport const retryAfter = (ms: number | undefined): Record<'Retry-After', string> =>\n\tms === undefined ? RETRY_AFTER : { 'Retry-After': String(Math.max(1, Math.ceil(ms / 1000))) }\n\n/** An endpoint's error answer: coded body, never cached, headers merged over `NO_STORE`. */\nexport const errorResponse = (\n\tstatus: number,\n\terror: AnalyticsError,\n\theaders: Record<string, string> = {}\n): Response => Response.json({ error }, { status, headers: { ...NO_STORE, ...headers } })\n\n/** 401 for a request with no signed-in user. */\nexport const unauthorizedResponse = (): Response =>\n\terrorResponse(401, analyticsError('unauthorized', 'analytics: authentication required'))\n\n/** 403 for a reader `access.read` turns away. */\nexport const readDeniedResponse = (): Response =>\n\terrorResponse(403, analyticsError('forbidden', 'analytics: read access denied'))\n\n/** 503 while no runtime is registered; as retryable as a provider outage, so it waits as long. */\nexport const notAvailableResponse = (): Response =>\n\terrorResponse(503, analyticsError('unavailable', 'analytics: not available'), RETRY_AFTER)\n\n/** 400 for a scope the request may not read; `param` names the parameter that carried it. */\nexport const untrustedScopeResponse = (param?: string): Response =>\n\terrorResponse(\n\t\t400,\n\t\tanalyticsError('untrusted_scope', 'analytics: scope is not permitted for this request', param)\n\t)\n\nconst CODES: ReadonlySet<string> = new Set<AnalyticsErrorCode>(ANALYTICS_ERROR_CODES)\n\nconst isErrorCode = (value: string): value is AnalyticsErrorCode => CODES.has(value)\n\n/**\n * The error in a parsed body, or undefined for a non-envelope body or a code this version never\n * sent, so a newer server's code reads as a generic failure rather than a lie.\n */\nexport const readError = (body: unknown): AnalyticsError | undefined => {\n\tif (!isRecord(body)) {\n\t\treturn undefined\n\t}\n\tconst error: unknown = body.error\n\tif (!isRecord(error)) {\n\t\treturn undefined\n\t}\n\tconst { code, message, param } = error\n\tif (typeof code !== 'string' || !isErrorCode(code) || typeof message !== 'string') {\n\t\treturn undefined\n\t}\n\treturn analyticsError(code, message, typeof param === 'string' ? param : undefined)\n}\n\n/** The code an endpoint answered with, or undefined when the body is not the envelope. */\nexport const readErrorCode = (body: unknown): AnalyticsErrorCode | undefined =>\n\treadError(body)?.code\n\n/**\n * {@link readError} over an unread response. A non-JSON or empty body reads as no error rather than\n * throwing, since the status still carries the failure.\n */\nexport const readResponseError = async (res: Response): Promise<AnalyticsError | undefined> => {\n\ttry {\n\t\treturn readError(await res.json())\n\t} catch {\n\t\treturn undefined\n\t}\n}\n"],"mappings":";;;;;;AAMA,MAAa,wBAAwB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;AAWA,MAAa,kBACZ,MACA,SACA,WACqB;CACrB;CACA;CACA,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;AACxC;;AAGA,MAAa,WAAW,EAAE,iBAAiB,oBAAoB;;AAG/D,MAAa,cAAc,EAAE,eAAe,KAAK;;;;;AAMjD,MAAa,cAAc,OAC1B,OAAO,KAAA,IAAY,cAAc,EAAE,eAAe,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,GAAI,CAAC,CAAC,EAAE;;AAG7F,MAAa,iBACZ,QACA,OACA,UAAkC,CAAC,MACrB,SAAS,KAAK,EAAE,MAAM,GAAG;CAAE;CAAQ,SAAS;EAAE,GAAG;EAAU,GAAG;CAAQ;AAAE,CAAC;;AAGxF,MAAa,6BACZ,cAAc,KAAK,eAAe,gBAAgB,oCAAoC,CAAC;;AAGxF,MAAa,2BACZ,cAAc,KAAK,eAAe,aAAa,+BAA+B,CAAC;;AAGhF,MAAa,6BACZ,cAAc,KAAK,eAAe,eAAe,0BAA0B,GAAG,WAAW;;AAG1F,MAAa,0BAA0B,UACtC,cACC,KACA,eAAe,mBAAmB,sDAAsD,KAAK,CAC9F;AAED,MAAM,QAA6B,IAAI,IAAwB,qBAAqB;AAEpF,MAAM,eAAe,UAA+C,MAAM,IAAI,KAAK;;;;;AAMnF,MAAa,aAAa,SAA8C;CACvE,IAAI,CAAC,SAAS,IAAI,GACjB;CAED,MAAM,QAAiB,KAAK;CAC5B,IAAI,CAAC,SAAS,KAAK,GAClB;CAED,MAAM,EAAE,MAAM,SAAS,UAAU;CACjC,IAAI,OAAO,SAAS,YAAY,CAAC,YAAY,IAAI,KAAK,OAAO,YAAY,UACxE;CAED,OAAO,eAAe,MAAM,SAAS,OAAO,UAAU,WAAW,QAAQ,KAAA,CAAS;AACnF;;AAGA,MAAa,iBAAiB,SAC7B,UAAU,IAAI,GAAG;;;;;AAMlB,MAAa,oBAAoB,OAAO,QAAuD;CAC9F,IAAI;EACH,OAAO,UAAU,MAAM,IAAI,KAAK,CAAC;CAClC,QAAQ;EACP;CACD;AACD"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { analyticsError, errorResponse } from "./errors.js";
|
|
2
|
+
//#region src/plugin/flagsEndpoint.ts
|
|
3
|
+
let loading;
|
|
4
|
+
/**
|
|
5
|
+
* Flags as SVG strings, loaded lazily: the entry is a barrel of some 300 modules that every route
|
|
6
|
+
* importing the config would pull in. A failed import is not cached, so later requests retry.
|
|
7
|
+
*/
|
|
8
|
+
const flagsByCode = () => {
|
|
9
|
+
loading ??= import("country-flag-icons/string/3x2").then((module) => new Map(Object.entries(module))).catch((err) => {
|
|
10
|
+
loading = void 0;
|
|
11
|
+
throw err;
|
|
12
|
+
});
|
|
13
|
+
return loading;
|
|
14
|
+
};
|
|
15
|
+
const CODE = /^[A-Za-z]{2}$/;
|
|
16
|
+
const SVG_HEADERS = {
|
|
17
|
+
"Content-Type": "image/svg+xml; charset=utf-8",
|
|
18
|
+
"Cache-Control": "public, max-age=31536000, immutable",
|
|
19
|
+
"X-Content-Type-Options": "nosniff",
|
|
20
|
+
"Content-Security-Policy": "default-src 'none'; style-src 'unsafe-inline'"
|
|
21
|
+
};
|
|
22
|
+
/**
|
|
23
|
+
* Public GET serving one country flag SVG, so the admin bundle ships no flag artwork.
|
|
24
|
+
* Unauthenticated on purpose: it reads only a static map, never data, user or scope.
|
|
25
|
+
*/
|
|
26
|
+
const makeFlagsHandler = () => async (req) => {
|
|
27
|
+
const raw = req.routeParams?.code;
|
|
28
|
+
const param = typeof raw === "string" ? raw : "";
|
|
29
|
+
const code = param.endsWith(".svg") ? param.slice(0, -4) : param;
|
|
30
|
+
if (!CODE.test(code)) return errorResponse(400, analyticsError("invalid_param", "analytics: flag code must be two letters", "code"));
|
|
31
|
+
const svg = (await flagsByCode()).get(code.toUpperCase());
|
|
32
|
+
if (svg === void 0) return errorResponse(404, analyticsError("not_found", `analytics: no flag for "${code.toUpperCase()}"`));
|
|
33
|
+
return new Response(svg, {
|
|
34
|
+
headers: SVG_HEADERS,
|
|
35
|
+
status: 200
|
|
36
|
+
});
|
|
37
|
+
};
|
|
38
|
+
//#endregion
|
|
39
|
+
export { makeFlagsHandler };
|
|
40
|
+
|
|
41
|
+
//# sourceMappingURL=flagsEndpoint.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flagsEndpoint.js","names":[],"sources":["../../src/plugin/flagsEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { analyticsError, errorResponse } from './errors'\n\nlet loading: Promise<Map<string, string>> | undefined\n\n/**\n * Flags as SVG strings, loaded lazily: the entry is a barrel of some 300 modules that every route\n * importing the config would pull in. A failed import is not cached, so later requests retry.\n */\nconst flagsByCode = (): Promise<Map<string, string>> => {\n\tloading ??= import('country-flag-icons/string/3x2')\n\t\t.then((module) => new Map<string, string>(Object.entries(module)))\n\t\t.catch((err: unknown) => {\n\t\t\tloading = undefined\n\t\t\tthrow err\n\t\t})\n\treturn loading\n}\n\nconst CODE = /^[A-Za-z]{2}$/\n\nconst SVG_HEADERS: Record<string, string> = {\n\t'Content-Type': 'image/svg+xml; charset=utf-8',\n\t// A flag is keyed by its country code and only ever changes in a new release of the\n\t// package, so the URL itself is the version and the answer never needs revalidating.\n\t'Cache-Control': 'public, max-age=31536000, immutable',\n\t'X-Content-Type-Options': 'nosniff',\n\t// Opened directly rather than through an <img>, an SVG is a document that can run\n\t// script. This one is denied everything but the inline fills the artwork needs.\n\t'Content-Security-Policy': \"default-src 'none'; style-src 'unsafe-inline'\",\n}\n\n/**\n * Public GET serving one country flag SVG, so the admin bundle ships no flag artwork.\n * Unauthenticated on purpose: it reads only a static map, never data, user or scope.\n */\nexport const makeFlagsHandler = (): PayloadHandler => async (req) => {\n\tconst raw = req.routeParams?.code\n\tconst param = typeof raw === 'string' ? raw : ''\n\tconst code = param.endsWith('.svg') ? param.slice(0, -'.svg'.length) : param\n\t// Checked before the artwork is loaded, so a malformed code costs nothing at all.\n\tif (!CODE.test(code)) {\n\t\treturn errorResponse(\n\t\t\t400,\n\t\t\tanalyticsError('invalid_param', 'analytics: flag code must be two letters', 'code')\n\t\t)\n\t}\n\tconst svg = (await flagsByCode()).get(code.toUpperCase())\n\tif (svg === undefined) {\n\t\treturn errorResponse(\n\t\t\t404,\n\t\t\tanalyticsError('not_found', `analytics: no flag for \"${code.toUpperCase()}\"`)\n\t\t)\n\t}\n\treturn new Response(svg, { headers: SVG_HEADERS, status: 200 })\n}\n"],"mappings":";;AAGA,IAAI;;;;;AAMJ,MAAM,oBAAkD;CACvD,YAAY,OAAO,iCACjB,MAAM,WAAW,IAAI,IAAoB,OAAO,QAAQ,MAAM,CAAC,CAAC,EAChE,OAAO,QAAiB;EACxB,UAAU,KAAA;EACV,MAAM;CACP,CAAC;CACF,OAAO;AACR;AAEA,MAAM,OAAO;AAEb,MAAM,cAAsC;CAC3C,gBAAgB;CAGhB,iBAAiB;CACjB,0BAA0B;CAG1B,2BAA2B;AAC5B;;;;;AAMA,MAAa,yBAAyC,OAAO,QAAQ;CACpE,MAAM,MAAM,IAAI,aAAa;CAC7B,MAAM,QAAQ,OAAO,QAAQ,WAAW,MAAM;CAC9C,MAAM,OAAO,MAAM,SAAS,MAAM,IAAI,MAAM,MAAM,GAAG,EAAc,IAAI;CAEvE,IAAI,CAAC,KAAK,KAAK,IAAI,GAClB,OAAO,cACN,KACA,eAAe,iBAAiB,4CAA4C,MAAM,CACnF;CAED,MAAM,OAAO,MAAM,YAAY,GAAG,IAAI,KAAK,YAAY,CAAC;CACxD,IAAI,QAAQ,KAAA,GACX,OAAO,cACN,KACA,eAAe,aAAa,2BAA2B,KAAK,YAAY,EAAE,EAAE,CAC7E;CAED,OAAO,IAAI,SAAS,KAAK;EAAE,SAAS;EAAa,QAAQ;CAAI,CAAC;AAC/D"}
|
package/dist/plugin/goalHint.js
CHANGED
|
@@ -1,24 +1,35 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { goalNamesFor, resolveGoalsDetailedFor } from "./runtime.js";
|
|
2
2
|
//#region src/plugin/goalHint.ts
|
|
3
|
-
/** A read whose numbers are goal completions: the `goal` breakdown, or the `conversions` metric. */
|
|
4
3
|
const needsGoalHint = (read) => read.metrics.includes("conversions") || (read.dimensions ?? []).includes("goal");
|
|
5
4
|
/**
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* as an empty result; a resolver that throws hints `'unresolved'` instead, so the read
|
|
9
|
-
* costs only its goal rows (the provider answers `goalsUnresolved`) and is neither cached
|
|
10
|
-
* as a healthy answer nor mistaken for an install that configured nothing.
|
|
5
|
+
* Goal hint for a read about goals, else undefined. A throwing resolver hints `'unresolved'`, which
|
|
6
|
+
* is never cached as healthy nor mistaken for an install with no goals.
|
|
11
7
|
*/
|
|
12
|
-
const
|
|
8
|
+
const goalHintFor = async (args) => {
|
|
13
9
|
if (!needsGoalHint(args)) return;
|
|
14
10
|
try {
|
|
15
|
-
|
|
11
|
+
const goals = await resolveGoalsDetailedFor(args.runtime, args.req, args.scope);
|
|
12
|
+
const names = await goalNamesFor({
|
|
13
|
+
...args,
|
|
14
|
+
resolved: goals
|
|
15
|
+
});
|
|
16
|
+
return {
|
|
17
|
+
slugs: goals.map(({ goal }) => goal.slug),
|
|
18
|
+
builtin: goals.filter((entry) => entry.source === "builtin").map(({ goal }) => goal.slug),
|
|
19
|
+
names
|
|
20
|
+
};
|
|
16
21
|
} catch (err) {
|
|
17
22
|
args.req.payload.logger?.warn(`analytics: goal slugs failed to resolve: ${String(err)}`);
|
|
18
|
-
return
|
|
23
|
+
return {
|
|
24
|
+
slugs: "unresolved",
|
|
25
|
+
builtin: [],
|
|
26
|
+
names: []
|
|
27
|
+
};
|
|
19
28
|
}
|
|
20
29
|
};
|
|
30
|
+
/** The hint's slugs alone, for a caller that never lists goal rows of its own. */
|
|
31
|
+
const goalSlugsFor = async (args) => (await goalHintFor(args))?.slugs;
|
|
21
32
|
//#endregion
|
|
22
|
-
export { goalSlugsFor };
|
|
33
|
+
export { goalHintFor, goalSlugsFor };
|
|
23
34
|
|
|
24
35
|
//# sourceMappingURL=goalHint.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"goalHint.js","names":[],"sources":["../../src/plugin/goalHint.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { DimensionKey, MetricKey } from '../core/contract'\nimport { type AnalyticsRuntime,
|
|
1
|
+
{"version":3,"file":"goalHint.js","names":[],"sources":["../../src/plugin/goalHint.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { DimensionKey, MetricKey } from '../core/contract'\nimport { type AnalyticsRuntime, goalNamesFor, resolveGoalsDetailedFor } from './runtime'\n\n/** The slice of a read that decides whether it is about goals. */\nexport interface GoalRead {\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n}\n\ninterface GoalSlugsArgs extends GoalRead {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The read's own scope; goals are resolved per scope. */\n\tscope: string | null | undefined\n}\n\nconst needsGoalHint = (read: GoalRead): boolean =>\n\tread.metrics.includes('conversions') || (read.dimensions ?? []).includes('goal')\n\ninterface ResolvedGoalHint {\n\t/** Every slug the read restricts to, the latent built-in goal included. */\n\tslugs: string[] | 'unresolved'\n\t/**\n\t * Which of those slugs the install did not declare: the built-in `purchase` goal, which\n\t * counts at ingest but is not a goal a report may list until it has conversions.\n\t */\n\tbuiltin: string[]\n\t/**\n\t * Every resolved goal's name, so a report lists a goal by name rather than by its slug; for a\n\t * read spanning every scope, the names of every scope's goals the reader may see.\n\t */\n\tnames: Array<{ slug: string; name: string }>\n}\n\n/**\n * Goal hint for a read about goals, else undefined. A throwing resolver hints `'unresolved'`, which\n * is never cached as healthy nor mistaken for an install with no goals.\n */\nexport const goalHintFor = async (args: GoalSlugsArgs): Promise<ResolvedGoalHint | undefined> => {\n\tif (!needsGoalHint(args)) {\n\t\treturn undefined\n\t}\n\ttry {\n\t\tconst goals = await resolveGoalsDetailedFor(args.runtime, args.req, args.scope)\n\t\tconst names = await goalNamesFor({ ...args, resolved: goals })\n\t\treturn {\n\t\t\tslugs: goals.map(({ goal }) => goal.slug),\n\t\t\tbuiltin: goals.filter((entry) => entry.source === 'builtin').map(({ goal }) => goal.slug),\n\t\t\tnames,\n\t\t}\n\t} catch (err) {\n\t\targs.req.payload.logger?.warn(`analytics: goal slugs failed to resolve: ${String(err)}`)\n\t\treturn { slugs: 'unresolved', builtin: [], names: [] }\n\t}\n}\n\n/** The hint's slugs alone, for a caller that never lists goal rows of its own. */\nexport const goalSlugsFor = async (\n\targs: GoalSlugsArgs\n): Promise<string[] | 'unresolved' | undefined> => (await goalHintFor(args))?.slugs\n"],"mappings":";;AAiBA,MAAM,iBAAiB,SACtB,KAAK,QAAQ,SAAS,aAAa,MAAM,KAAK,cAAc,CAAC,GAAG,SAAS,MAAM;;;;;AAqBhF,MAAa,cAAc,OAAO,SAA+D;CAChG,IAAI,CAAC,cAAc,IAAI,GACtB;CAED,IAAI;EACH,MAAM,QAAQ,MAAM,wBAAwB,KAAK,SAAS,KAAK,KAAK,KAAK,KAAK;EAC9E,MAAM,QAAQ,MAAM,aAAa;GAAE,GAAG;GAAM,UAAU;EAAM,CAAC;EAC7D,OAAO;GACN,OAAO,MAAM,KAAK,EAAE,WAAW,KAAK,IAAI;GACxC,SAAS,MAAM,QAAQ,UAAU,MAAM,WAAW,SAAS,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI;GACxF;EACD;CACD,SAAS,KAAK;EACb,KAAK,IAAI,QAAQ,QAAQ,KAAK,4CAA4C,OAAO,GAAG,GAAG;EACvF,OAAO;GAAE,OAAO;GAAc,SAAS,CAAC;GAAG,OAAO,CAAC;EAAE;CACtD;AACD;;AAGA,MAAa,eAAe,OAC3B,UACmD,MAAM,YAAY,IAAI,IAAI"}
|