@10x-media/analytics 1.0.0-beta.9 → 4.0.0-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +710 -0
- package/README.md +35 -36
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +19 -0
- package/dist/adapters/ga4/disableKey.js.map +1 -0
- package/dist/adapters/ga4/eventName.d.ts +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +24 -0
- package/dist/adapters/ga4/ga4.js +226 -122
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +2 -3
- package/dist/adapters/ga4/measurementId.js.map +1 -1
- package/dist/adapters/goalRead.js +15 -29
- package/dist/adapters/goalRead.js.map +1 -1
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +25 -13
- package/dist/adapters/plausible/plausible.js +144 -124
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +33 -9
- package/dist/adapters/posthog/posthog.js +279 -121
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/posthog/projectCheck.js +56 -0
- package/dist/adapters/posthog/projectCheck.js.map +1 -0
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +19 -9
- package/dist/adapters/umami/umami.js +196 -166
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +28 -25
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +49 -92
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +131 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/capture/withoutConsent.js +91 -0
- package/dist/capture/withoutConsent.js.map +1 -0
- package/dist/charts/BarList.d.ts +27 -13
- package/dist/charts/BarList.js +38 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +17 -1
- package/dist/charts/bars.js +12 -11
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +198 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +48 -36
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +59 -26
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +347 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +105 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +321 -60
- package/dist/core/contract.js +7 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +530 -152
- package/dist/core/options.js +158 -216
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +114 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +349 -36
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +50 -16
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceLabel.d.ts +10 -0
- package/dist/core/sourceLabel.js +63 -0
- package/dist/core/sourceLabel.js.map +1 -0
- package/dist/core/sourceOptions.js +107 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/sourcePolicy.d.ts +55 -0
- package/dist/core/sourcePolicy.js +51 -0
- package/dist/core/sourcePolicy.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +15 -0
- package/dist/exports/adapters/ga4.d.ts +16 -1
- package/dist/exports/adapters/native.d.ts +29 -2
- package/dist/exports/adapters/native.js +5 -1
- package/dist/exports/adapters/plausible.d.ts +16 -1
- package/dist/exports/adapters/posthog.d.ts +16 -1
- package/dist/exports/adapters/umami.d.ts +16 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +43 -12
- package/dist/exports/client.js +22 -8
- package/dist/exports/geo.d.ts +4 -2
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/react.d.ts +5 -3
- package/dist/exports/react.js +1 -2
- package/dist/exports/routes.d.ts +19 -0
- package/dist/exports/routes.js +3 -0
- package/dist/exports/rsc.d.ts +32 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +18 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +6 -18
- package/dist/exports/tracker.js +3 -12
- package/dist/exports/types.d.ts +45 -14
- package/dist/exports/types.js +6 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +19 -7
- package/dist/fields/AnalyticsPanelField.js +123 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +17 -6
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +222 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
- package/dist/fields/config/FilterDimensionSelectField.js +26 -54
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
- package/dist/fields/config/FilterOperatorSelectField.js +37 -53
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +18 -30
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.d.ts +3 -0
- package/dist/fields/config/fetchSources.js +17 -23
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +30 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +67 -38
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +79 -26
- package/dist/fields/readForDocument.js +450 -116
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +179 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +143 -124
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -22
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +40 -38
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +155 -47
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -25
- package/dist/goals/trackGoalAction.js +71 -66
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +68 -12
- package/dist/index.js +261 -192
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +79 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.js +27 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +103 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +31 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1627 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +199 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +110 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +5 -2
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +27 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +10 -0
- package/dist/native/ingest/bots.js +66 -0
- package/dist/native/ingest/bots.js.map +1 -0
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +34 -8
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +185 -32
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +70 -8
- package/dist/native/ingest/normalizeEvent.js +239 -60
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +44 -0
- package/dist/native/ingest/requestHost.js.map +1 -0
- package/dist/native/ingest/resolveHostname.d.ts +20 -0
- package/dist/native/ingest/resolveHostname.js +51 -0
- package/dist/native/ingest/resolveHostname.js.map +1 -0
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +85 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +188 -69
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +5 -2
- package/dist/native/ingest/source.js +163 -59
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +25 -13
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +128 -9
- package/dist/native/nativeAdapter.js +396 -288
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +119 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +65 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +438 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +705 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +101 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +387 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +349 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +49 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +668 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +15 -0
- package/dist/native/store/types.js +10 -0
- package/dist/native/store/types.js.map +1 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +57 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +346 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +105 -71
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +24 -0
- package/dist/plugin/errors.js +86 -0
- package/dist/plugin/errors.js.map +1 -0
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +161 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +80 -51
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.d.ts +11 -0
- package/dist/plugin/readContextForRequest.js +79 -32
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +67 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +79 -34
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +138 -0
- package/dist/plugin/refreshEndpoint.js.map +1 -0
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +235 -29
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +61 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +23 -0
- package/dist/plugin/scopeChange.js.map +1 -0
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +50 -23
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +24 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/ProvidersListNotice.d.ts +11 -0
- package/dist/providers/ProvidersListNotice.js +36 -0
- package/dist/providers/ProvidersListNotice.js.map +1 -0
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +63 -0
- package/dist/providers/collection.js +369 -150
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +84 -0
- package/dist/providers/factory.js +84 -25
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +105 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +329 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +26 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/scopeUnique.js +41 -0
- package/dist/providers/scopeUnique.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +6 -13
- package/dist/query/fetchQuery.d.ts +36 -23
- package/dist/query/fetchQuery.js +96 -89
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +8 -2
- package/dist/query/parse.js +155 -108
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +42 -20
- package/dist/react/AnalyticsProvider.js +24 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -8
- package/dist/react/useAnalytics.js +31 -13
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/routes/captureRoute.d.ts +28 -0
- package/dist/routes/captureRoute.js +67 -0
- package/dist/routes/captureRoute.js.map +1 -0
- package/dist/routes/ingestRoute.d.ts +17 -0
- package/dist/routes/ingestRoute.js +17 -0
- package/dist/routes/ingestRoute.js.map +1 -0
- package/dist/site/AnalyticsScripts.d.ts +35 -0
- package/dist/site/AnalyticsScripts.js +44 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +43 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +71 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -71
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.d.ts +1 -0
- package/dist/surfacing/epoch.js +116 -0
- package/dist/surfacing/epoch.js.map +1 -0
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +119 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +30 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +222 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +174 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +5 -10
- package/dist/tracker/createTracker.js +434 -91
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +8 -0
- package/dist/tracker/exclusion.js +82 -0
- package/dist/tracker/exclusion.js.map +1 -0
- package/dist/tracker/gate.d.ts +8 -0
- package/dist/tracker/gate.js +244 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +23 -15
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +129 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +60 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +97 -17
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +21 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +36 -18
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +145 -9
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +18 -10
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +54 -22
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +99 -49
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +255 -74
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +243 -71
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +238 -70
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +246 -71
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +250 -75
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +241 -70
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +214 -17
- package/dist/translations/keys.js +219 -17
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +243 -72
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +255 -80
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +246 -69
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +246 -69
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +241 -70
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +110 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1667 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/ChoiceMenu.js +48 -0
- package/dist/ui/components/ChoiceMenu.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +25 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/components/SourcesNoticeBanner.js +20 -0
- package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +12 -8
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +9 -10
- package/dist/view/AnalyticsView.js +47 -19
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -185
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +155 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/consentShare.js +15 -0
- package/dist/view/consentShare.js.map +1 -0
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +67 -32
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +113 -16
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +13 -11
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +195 -132
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +120 -32
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +127 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +42 -36
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +181 -122
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +52 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +65 -8
- package/dist/view/viewProps.js +123 -36
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +81 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +130 -123
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +24 -4
- package/dist/widgets/RealtimeCounter.js +90 -71
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +18 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaultLayout.d.ts +26 -0
- package/dist/widgets/defaultLayout.js +51 -0
- package/dist/widgets/defaultLayout.js.map +1 -0
- package/dist/widgets/defaults.d.ts +4 -7
- package/dist/widgets/defaults.js +12 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +79 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +19 -2
- package/dist/widgets/prepareWidgetRead.js +63 -27
- package/dist/widgets/prepareWidgetRead.js.map +1 -1
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +28 -19
- package/dist/widgets/readForWidget.js +33 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
- package/dist/widgets/readForWidgetBreakdown.js +48 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +18 -24
- package/dist/widgets/readForWidgetGoals.js +52 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
- package/dist/widgets/readForWidgetRealtime.js +54 -27
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +27 -32
- package/dist/widgets/readForWidgetSeries.js +45 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +48 -0
- package/dist/widgets/readMeta.js +52 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +56 -16
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +207 -127
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +4 -3
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +31 -24
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +61 -42
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/exports/next.d.ts +0 -3
- package/dist/exports/next.js +0 -3
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -157
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -14
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -174
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -29
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -105
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/next/captureRewrites.d.ts +0 -42
- package/dist/next/captureRewrites.js +0 -57
- package/dist/next/captureRewrites.js.map +0 -1
- package/dist/next/posthogProxyRewrites.d.ts +0 -41
- package/dist/next/posthogProxyRewrites.js +0 -45
- package/dist/next/posthogProxyRewrites.js.map +0 -1
- package/dist/plugin/paths.js +0 -27
- package/dist/plugin/paths.js.map +0 -1
- package/dist/plugin/responses.js +0 -17
- package/dist/plugin/responses.js.map +0 -1
- package/dist/query/errors.js +0 -10
- package/dist/query/errors.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -21
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -14
- package/dist/tracker/sinks/posthog.d.ts +0 -14
- package/dist/tracker/sinks/umami.d.ts +0 -13
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -74
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
package/dist/core/cacheKey.js
CHANGED
|
@@ -1,50 +1,62 @@
|
|
|
1
|
+
import { canonicalJson } from "./values.js";
|
|
1
2
|
import { addDaysInTz, startOfDayInTz } from "../timeframe/tz.js";
|
|
3
|
+
import { createHash } from "node:crypto";
|
|
2
4
|
//#region src/core/cacheKey.ts
|
|
3
|
-
const stable = (xs) => xs ? [...xs].sort().join(",") : "";
|
|
4
5
|
/**
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
* of its day in `tz`, keys on its exact bounds instead: snapping those too would let two
|
|
8
|
-
* windows that differ only inside their last day share an entry, and an instant-comparing
|
|
9
|
-
* adapter read the narrower one's answer.
|
|
6
|
+
* Written into every key. Bump it when the key layout or what a metric means changes, so no entry
|
|
7
|
+
* written under the old meaning is ever read.
|
|
10
8
|
*/
|
|
11
|
-
const
|
|
9
|
+
const CACHE_KEY_VERSION = 3;
|
|
10
|
+
/**
|
|
11
|
+
* A live window snaps to whole days so renders within a day share an entry; a closed one keys on
|
|
12
|
+
* exact bounds, or two windows differing inside their last day would share one.
|
|
13
|
+
*/
|
|
14
|
+
const windowOf = (range, tz) => {
|
|
12
15
|
const nextDay = addDaysInTz(range.end, 1, tz);
|
|
13
16
|
if (nextDay.getTime() - 1 === range.end.getTime()) return `${range.start.toISOString()}_${range.end.toISOString()}`;
|
|
14
17
|
return `${startOfDayInTz(range.start, tz).toISOString()}_${nextDay.toISOString()}`;
|
|
15
18
|
};
|
|
19
|
+
/** A set, sorted and without repeats; an empty one keys like an absent one, asking the same. */
|
|
20
|
+
const setOf = (values) => values && values.length > 0 ? [...new Set(values)].sort() : void 0;
|
|
21
|
+
const filtersOf = (filters) => setOf(filters?.map((filter) => canonicalJson(filter)));
|
|
16
22
|
/**
|
|
17
|
-
* The
|
|
18
|
-
*
|
|
19
|
-
* `GOAL_SLUG_PATTERN` forbids, so no list of slugs can be written to look like it.
|
|
23
|
+
* The query as keyed: every field it carries, so a later field is never left out, with the window
|
|
24
|
+
* snapped and sets sorted. `'unresolved'` stays a string, apart from a goal of that name.
|
|
20
25
|
*/
|
|
21
|
-
const
|
|
22
|
-
|
|
23
|
-
|
|
26
|
+
const keyedQuery = (q) => {
|
|
27
|
+
const { dateRange, ...rest } = q;
|
|
28
|
+
const timezone = q.timezone ?? "UTC";
|
|
29
|
+
return {
|
|
30
|
+
...rest,
|
|
31
|
+
window: windowOf(dateRange, timezone),
|
|
32
|
+
timezone,
|
|
33
|
+
metrics: setOf(q.metrics),
|
|
34
|
+
dimensions: setOf(q.dimensions),
|
|
35
|
+
filters: filtersOf(q.filters),
|
|
36
|
+
goalSlugs: q.goalSlugs === "unresolved" ? q.goalSlugs : setOf(q.goalSlugs)
|
|
37
|
+
};
|
|
24
38
|
};
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
].join("|");
|
|
46
|
-
}
|
|
39
|
+
const hashed = (prefix, value) => `${prefix}${createHash("sha256").update(canonicalJson(value)).digest("base64url")}`;
|
|
40
|
+
/**
|
|
41
|
+
* `r:` plus the base64url SHA-256 of the canonical key fields: fixed length, and no value can be
|
|
42
|
+
* spelled to look like another field.
|
|
43
|
+
*/
|
|
44
|
+
const buildCacheKey = (source, q, epochs) => hashed("r:", {
|
|
45
|
+
v: CACHE_KEY_VERSION,
|
|
46
|
+
source,
|
|
47
|
+
configEpoch: epochs.config,
|
|
48
|
+
refreshEpoch: epochs.refresh,
|
|
49
|
+
q: keyedQuery(q)
|
|
50
|
+
});
|
|
51
|
+
/** `rt:` and the same digest over a live count's parts; such a key is only ever held in memory. */
|
|
52
|
+
const buildRealtimeKey = (source, parts, epochs) => hashed("rt:", {
|
|
53
|
+
v: CACHE_KEY_VERSION,
|
|
54
|
+
source,
|
|
55
|
+
configEpoch: epochs.config,
|
|
56
|
+
refreshEpoch: epochs.refresh,
|
|
57
|
+
parts
|
|
58
|
+
});
|
|
47
59
|
//#endregion
|
|
48
|
-
export { buildCacheKey };
|
|
60
|
+
export { buildCacheKey, buildRealtimeKey };
|
|
49
61
|
|
|
50
62
|
//# sourceMappingURL=cacheKey.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { AnalyticsQuery } from './contract'\
|
|
1
|
+
{"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import { createHash } from 'node:crypto'\nimport { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { AnalyticsFilter, AnalyticsQuery } from './contract'\nimport { canonicalJson } from './values'\n\n/**\n * Written into every key. Bump it when the key layout or what a metric means changes, so no entry\n * written under the old meaning is ever read.\n */\nconst CACHE_KEY_VERSION = 3\n\n/** The two tokens a cached read is keyed on; a new value of either retires it on every instance. */\nexport interface CacheKeyEpochs {\n\t/** The scope's provider and goal configuration. */\n\tconfig: string\n\t/** The scope's manual refresh token. */\n\trefresh: string\n}\n\n/**\n * A live window snaps to whole days so renders within a day share an entry; a closed one keys on\n * exact bounds, or two windows differing inside their last day would share one.\n */\nconst windowOf = (range: AnalyticsQuery['dateRange'], tz: string): string => {\n\tconst nextDay = addDaysInTz(range.end, 1, tz)\n\tif (nextDay.getTime() - 1 === range.end.getTime()) {\n\t\treturn `${range.start.toISOString()}_${range.end.toISOString()}`\n\t}\n\treturn `${startOfDayInTz(range.start, tz).toISOString()}_${nextDay.toISOString()}`\n}\n\n/** A set, sorted and without repeats; an empty one keys like an absent one, asking the same. */\nconst setOf = <T extends string>(values: readonly T[] | undefined): T[] | undefined =>\n\tvalues && values.length > 0 ? [...new Set(values)].sort() : undefined\n\nconst filtersOf = (filters: readonly AnalyticsFilter[] | undefined): string[] | undefined =>\n\tsetOf(filters?.map((filter) => canonicalJson(filter)))\n\n/**\n * The query as keyed: every field it carries, so a later field is never left out, with the window\n * snapped and sets sorted. `'unresolved'` stays a string, apart from a goal of that name.\n */\nexport const keyedQuery = (q: AnalyticsQuery): Record<string, unknown> => {\n\tconst { dateRange, ...rest } = q\n\tconst timezone = q.timezone ?? DEFAULT_TIMEZONE\n\treturn {\n\t\t...rest,\n\t\twindow: windowOf(dateRange, timezone),\n\t\ttimezone,\n\t\tmetrics: setOf(q.metrics),\n\t\tdimensions: setOf(q.dimensions),\n\t\tfilters: filtersOf(q.filters),\n\t\tgoalSlugs: q.goalSlugs === 'unresolved' ? q.goalSlugs : setOf(q.goalSlugs),\n\t}\n}\n\nconst hashed = (prefix: string, value: unknown): string =>\n\t`${prefix}${createHash('sha256').update(canonicalJson(value)).digest('base64url')}`\n\n/**\n * `r:` plus the base64url SHA-256 of the canonical key fields: fixed length, and no value can be\n * spelled to look like another field.\n */\nexport const buildCacheKey = (source: string, q: AnalyticsQuery, epochs: CacheKeyEpochs): string =>\n\thashed('r:', {\n\t\tv: CACHE_KEY_VERSION,\n\t\tsource,\n\t\tconfigEpoch: epochs.config,\n\t\trefreshEpoch: epochs.refresh,\n\t\tq: keyedQuery(q),\n\t})\n\n/** What a live count is keyed on; its window always ends now, so it carries a length instead. */\ninterface RealtimeKeyParts {\n\tmetric: string\n\twindowMinutes: number\n\tscope?: string\n\tpath?: string\n\tseries: boolean\n}\n\n/** `rt:` and the same digest over a live count's parts; such a key is only ever held in memory. */\nexport const buildRealtimeKey = (\n\tsource: string,\n\tparts: RealtimeKeyParts,\n\tepochs: CacheKeyEpochs\n): string =>\n\thashed('rt:', {\n\t\tv: CACHE_KEY_VERSION,\n\t\tsource,\n\t\tconfigEpoch: epochs.config,\n\t\trefreshEpoch: epochs.refresh,\n\t\tparts,\n\t})\n"],"mappings":";;;;;;;;AASA,MAAM,oBAAoB;;;;;AAc1B,MAAM,YAAY,OAAoC,OAAuB;CAC5E,MAAM,UAAU,YAAY,MAAM,KAAK,GAAG,EAAE;CAC5C,IAAI,QAAQ,QAAQ,IAAI,MAAM,MAAM,IAAI,QAAQ,GAC/C,OAAO,GAAG,MAAM,MAAM,YAAY,EAAE,GAAG,MAAM,IAAI,YAAY;CAE9D,OAAO,GAAG,eAAe,MAAM,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,QAAQ,YAAY;AAChF;;AAGA,MAAM,SAA2B,WAChC,UAAU,OAAO,SAAS,IAAI,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,KAAA;AAE7D,MAAM,aAAa,YAClB,MAAM,SAAS,KAAK,WAAW,cAAc,MAAM,CAAC,CAAC;;;;;AAMtD,MAAa,cAAc,MAA+C;CACzE,MAAM,EAAE,WAAW,GAAG,SAAS;CAC/B,MAAM,WAAW,EAAE,YAAA;CACnB,OAAO;EACN,GAAG;EACH,QAAQ,SAAS,WAAW,QAAQ;EACpC;EACA,SAAS,MAAM,EAAE,OAAO;EACxB,YAAY,MAAM,EAAE,UAAU;EAC9B,SAAS,UAAU,EAAE,OAAO;EAC5B,WAAW,EAAE,cAAc,eAAe,EAAE,YAAY,MAAM,EAAE,SAAS;CAC1E;AACD;AAEA,MAAM,UAAU,QAAgB,UAC/B,GAAG,SAAS,WAAW,QAAQ,EAAE,OAAO,cAAc,KAAK,CAAC,EAAE,OAAO,WAAW;;;;;AAMjF,MAAa,iBAAiB,QAAgB,GAAmB,WAChE,OAAO,MAAM;CACZ,GAAG;CACH;CACA,aAAa,OAAO;CACpB,cAAc,OAAO;CACrB,GAAG,WAAW,CAAC;AAChB,CAAC;;AAYF,MAAa,oBACZ,QACA,OACA,WAEA,OAAO,OAAO;CACb,GAAG;CACH;CACA,aAAa,OAAO;CACpB,cAAc,OAAO;CACrB;AACD,CAAC"}
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
import { kindOf } from "./values.js";
|
|
2
|
+
import { keysOf, optionalBoolean, optionalFunction, optionalList, optionalSeconds, optionsObject, positiveWhole } from "./optionChecks.js";
|
|
3
|
+
import { resolveCollectionOption } from "./collectionOption.js";
|
|
4
|
+
import { CACHE_SLUG } from "../surfacing/cacheCollection.js";
|
|
5
|
+
import { isCacheStore } from "../surfacing/cacheStore.js";
|
|
6
|
+
import { SYNC_SLUG } from "../sync/collection.js";
|
|
7
|
+
//#region src/core/cacheOptions.ts
|
|
8
|
+
const DEFAULT_TIMEOUT_MS = 15e3;
|
|
9
|
+
const DEFAULT_WARM_WINDOW_HOURS = 24;
|
|
10
|
+
const DEFAULT_WARM_MAX_READS = 200;
|
|
11
|
+
const DEFAULT_SYNC_LOOKBACK = 3;
|
|
12
|
+
const CACHE_KEYS = keysOf({
|
|
13
|
+
ttl: true,
|
|
14
|
+
warm: true,
|
|
15
|
+
timeoutMs: true,
|
|
16
|
+
concurrency: true,
|
|
17
|
+
store: true,
|
|
18
|
+
collection: true
|
|
19
|
+
});
|
|
20
|
+
const TTL_KEYS = keysOf({
|
|
21
|
+
aggregate: true,
|
|
22
|
+
realtime: true
|
|
23
|
+
});
|
|
24
|
+
const CONCURRENCY_KEYS = keysOf({
|
|
25
|
+
global: true,
|
|
26
|
+
perSource: true,
|
|
27
|
+
perScope: true
|
|
28
|
+
});
|
|
29
|
+
const WARM_KEYS = keysOf({
|
|
30
|
+
windowHours: true,
|
|
31
|
+
maxReads: true
|
|
32
|
+
});
|
|
33
|
+
const SYNC_KEYS = keysOf({
|
|
34
|
+
lookbackDays: true,
|
|
35
|
+
adapters: true,
|
|
36
|
+
collection: true
|
|
37
|
+
});
|
|
38
|
+
const HOOKS_KEYS = keysOf({ afterRead: true });
|
|
39
|
+
const resolveWarm = (option) => {
|
|
40
|
+
const defaults = {
|
|
41
|
+
windowHours: DEFAULT_WARM_WINDOW_HOURS,
|
|
42
|
+
maxReads: DEFAULT_WARM_MAX_READS
|
|
43
|
+
};
|
|
44
|
+
if (option === void 0 || option === false) return {
|
|
45
|
+
enabled: false,
|
|
46
|
+
...defaults
|
|
47
|
+
};
|
|
48
|
+
if (option === true) return {
|
|
49
|
+
enabled: true,
|
|
50
|
+
...defaults
|
|
51
|
+
};
|
|
52
|
+
optionsObject(option, {
|
|
53
|
+
path: "cache.warm",
|
|
54
|
+
known: WARM_KEYS,
|
|
55
|
+
example: "true, false or an object such as { windowHours: 24 }"
|
|
56
|
+
});
|
|
57
|
+
return {
|
|
58
|
+
enabled: true,
|
|
59
|
+
windowHours: positiveWhole(option.windowHours, "cache.warm.windowHours", defaults.windowHours),
|
|
60
|
+
maxReads: positiveWhole(option.maxReads, "cache.warm.maxReads", defaults.maxReads)
|
|
61
|
+
};
|
|
62
|
+
};
|
|
63
|
+
const resolveConcurrency = (option) => {
|
|
64
|
+
if (option !== void 0) optionsObject(option, {
|
|
65
|
+
path: "cache.concurrency",
|
|
66
|
+
known: CONCURRENCY_KEYS,
|
|
67
|
+
example: "an object such as { perSource: 4 }"
|
|
68
|
+
});
|
|
69
|
+
return {
|
|
70
|
+
global: positiveWhole(option?.global, "cache.concurrency.global", 16),
|
|
71
|
+
perSource: positiveWhole(option?.perSource, "cache.concurrency.perSource", 4),
|
|
72
|
+
perScope: positiveWhole(option?.perScope, "cache.concurrency.perScope", 8)
|
|
73
|
+
};
|
|
74
|
+
};
|
|
75
|
+
/** The host's store, or the `analytics-cache` collection it replaces: never both. */
|
|
76
|
+
const resolveCacheStorage = (option) => {
|
|
77
|
+
const store = option?.store;
|
|
78
|
+
const collection = option?.collection;
|
|
79
|
+
if (store !== void 0 && !isCacheStore(store)) throw new Error(`analytics: cache.store must be an object with get, set, touch, sweep and recentRecipes methods, got ${kindOf(store)}`);
|
|
80
|
+
if (store !== void 0 && collection !== void 0) throw new Error("analytics: cache.collection shapes the analytics-cache collection, which cache.store replaces; set one of them");
|
|
81
|
+
return {
|
|
82
|
+
...store === void 0 ? {} : { store },
|
|
83
|
+
collection: resolveCollectionOption(collection, {
|
|
84
|
+
path: "cache.collection",
|
|
85
|
+
fallback: CACHE_SLUG
|
|
86
|
+
})
|
|
87
|
+
};
|
|
88
|
+
};
|
|
89
|
+
/** `cache`: TTLs, warming, the source deadline, concurrency and where reads are stored. */
|
|
90
|
+
const resolveCache = (option) => {
|
|
91
|
+
if (option !== void 0) {
|
|
92
|
+
optionsObject(option, {
|
|
93
|
+
path: "cache",
|
|
94
|
+
known: CACHE_KEYS,
|
|
95
|
+
example: "an object such as { timeoutMs: 15000 }"
|
|
96
|
+
});
|
|
97
|
+
if (option.ttl !== void 0) optionsObject(option.ttl, {
|
|
98
|
+
path: "cache.ttl",
|
|
99
|
+
known: TTL_KEYS,
|
|
100
|
+
example: "an object such as { aggregate: 300 }"
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
return {
|
|
104
|
+
ttl: {
|
|
105
|
+
aggregate: optionalSeconds(option?.ttl?.aggregate, "cache.ttl.aggregate"),
|
|
106
|
+
realtime: optionalSeconds(option?.ttl?.realtime, "cache.ttl.realtime")
|
|
107
|
+
},
|
|
108
|
+
warm: resolveWarm(option?.warm),
|
|
109
|
+
timeoutMs: positiveWhole(option?.timeoutMs, "cache.timeoutMs", DEFAULT_TIMEOUT_MS),
|
|
110
|
+
concurrency: resolveConcurrency(option?.concurrency),
|
|
111
|
+
...resolveCacheStorage(option)
|
|
112
|
+
};
|
|
113
|
+
};
|
|
114
|
+
/** `sync`: off unless set; `true` copies every vendor source with the defaults. */
|
|
115
|
+
const resolveSync = (option) => {
|
|
116
|
+
const off = {
|
|
117
|
+
enabled: false,
|
|
118
|
+
lookbackDays: DEFAULT_SYNC_LOOKBACK,
|
|
119
|
+
collection: {
|
|
120
|
+
slug: SYNC_SLUG,
|
|
121
|
+
hidden: true
|
|
122
|
+
}
|
|
123
|
+
};
|
|
124
|
+
if (!option) return off;
|
|
125
|
+
if (option === true) return {
|
|
126
|
+
...off,
|
|
127
|
+
enabled: true
|
|
128
|
+
};
|
|
129
|
+
const shaped = optionsObject(option, {
|
|
130
|
+
path: "sync",
|
|
131
|
+
known: SYNC_KEYS,
|
|
132
|
+
example: "true, or an object such as { lookbackDays: 3 }"
|
|
133
|
+
});
|
|
134
|
+
for (const entry of optionalList(shaped.adapters, "sync.adapters", "['plausible']")) if (typeof entry !== "string" || entry.trim() === "") throw new Error(`analytics: sync.adapters entries must each be an adapter id or a provider type, got ${kindOf(entry)}`);
|
|
135
|
+
optionalBoolean(option.collection?.hidden, "sync.collection.hidden");
|
|
136
|
+
const collection = resolveCollectionOption(option.collection, {
|
|
137
|
+
path: "sync.collection",
|
|
138
|
+
fallback: SYNC_SLUG,
|
|
139
|
+
extra: ["hidden"]
|
|
140
|
+
});
|
|
141
|
+
return {
|
|
142
|
+
enabled: true,
|
|
143
|
+
lookbackDays: positiveWhole(option.lookbackDays, "sync.lookbackDays", DEFAULT_SYNC_LOOKBACK),
|
|
144
|
+
...option.adapters ? { adapters: option.adapters } : {},
|
|
145
|
+
collection: {
|
|
146
|
+
...collection,
|
|
147
|
+
hidden: option.collection?.hidden ?? true
|
|
148
|
+
}
|
|
149
|
+
};
|
|
150
|
+
};
|
|
151
|
+
/** `hooks`: functions the plugin calls around what it does. */
|
|
152
|
+
const resolveHooks = (option) => {
|
|
153
|
+
if (option === void 0) return {};
|
|
154
|
+
optionsObject(option, {
|
|
155
|
+
path: "hooks",
|
|
156
|
+
known: HOOKS_KEYS,
|
|
157
|
+
example: "an object such as { afterRead }"
|
|
158
|
+
});
|
|
159
|
+
const afterRead = optionalFunction(option.afterRead, "hooks.afterRead");
|
|
160
|
+
return afterRead ? { afterRead } : {};
|
|
161
|
+
};
|
|
162
|
+
//#endregion
|
|
163
|
+
export { resolveCache, resolveHooks, resolveSync };
|
|
164
|
+
|
|
165
|
+
//# sourceMappingURL=cacheOptions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cacheOptions.js","names":[],"sources":["../../src/core/cacheOptions.ts"],"sourcesContent":["import { CACHE_SLUG } from '../surfacing/cacheCollection'\nimport { isCacheStore } from '../surfacing/cacheStore'\nimport { DEFAULT_COLD_READS_PER_SCOPE } from '../surfacing/coldBudget'\nimport { DEFAULT_GLOBAL_CONCURRENCY, DEFAULT_SOURCE_CONCURRENCY } from '../surfacing/lanes'\nimport { SYNC_SLUG } from '../sync/collection'\nimport { resolveCollectionOption } from './collectionOption'\nimport {\n\tkeysOf,\n\toptionalBoolean,\n\toptionalFunction,\n\toptionalList,\n\toptionalSeconds,\n\toptionsObject,\n\tpositiveWhole,\n} from './optionChecks'\nimport type {\n\tAnalyticsCacheOptions,\n\tAnalyticsConcurrencyOptions,\n\tAnalyticsHooksOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsSyncOptions,\n\tAnalyticsWarmOptions,\n\tResolvedOptions,\n} from './options'\nimport { kindOf } from './values'\n\nconst DEFAULT_TIMEOUT_MS = 15_000\nconst DEFAULT_WARM_WINDOW_HOURS = 24\nconst DEFAULT_WARM_MAX_READS = 200\nconst DEFAULT_SYNC_LOOKBACK = 3\n\nconst CACHE_KEYS = keysOf<AnalyticsCacheOptions>({\n\tttl: true,\n\twarm: true,\n\ttimeoutMs: true,\n\tconcurrency: true,\n\tstore: true,\n\tcollection: true,\n})\nconst TTL_KEYS = keysOf<NonNullable<AnalyticsCacheOptions['ttl']>>({\n\taggregate: true,\n\trealtime: true,\n})\nconst CONCURRENCY_KEYS = keysOf<AnalyticsConcurrencyOptions>({\n\tglobal: true,\n\tperSource: true,\n\tperScope: true,\n})\nconst WARM_KEYS = keysOf<AnalyticsWarmOptions>({ windowHours: true, maxReads: true })\nconst SYNC_KEYS = keysOf<AnalyticsSyncOptions>({\n\tlookbackDays: true,\n\tadapters: true,\n\tcollection: true,\n})\nconst HOOKS_KEYS = keysOf<AnalyticsHooksOptions>({ afterRead: true })\n\ntype ResolvedCache = ResolvedOptions['cache']\n\nconst resolveWarm = (option: AnalyticsCacheOptions['warm']): ResolvedCache['warm'] => {\n\tconst defaults = { windowHours: DEFAULT_WARM_WINDOW_HOURS, maxReads: DEFAULT_WARM_MAX_READS }\n\tif (option === undefined || option === false) {\n\t\treturn { enabled: false, ...defaults }\n\t}\n\tif (option === true) {\n\t\treturn { enabled: true, ...defaults }\n\t}\n\toptionsObject(option, {\n\t\tpath: 'cache.warm',\n\t\tknown: WARM_KEYS,\n\t\texample: 'true, false or an object such as { windowHours: 24 }',\n\t})\n\treturn {\n\t\tenabled: true,\n\t\twindowHours: positiveWhole(option.windowHours, 'cache.warm.windowHours', defaults.windowHours),\n\t\tmaxReads: positiveWhole(option.maxReads, 'cache.warm.maxReads', defaults.maxReads),\n\t}\n}\n\nconst resolveConcurrency = (\n\toption: AnalyticsConcurrencyOptions | undefined\n): ResolvedCache['concurrency'] => {\n\tif (option !== undefined) {\n\t\toptionsObject(option, {\n\t\t\tpath: 'cache.concurrency',\n\t\t\tknown: CONCURRENCY_KEYS,\n\t\t\texample: 'an object such as { perSource: 4 }',\n\t\t})\n\t}\n\treturn {\n\t\tglobal: positiveWhole(option?.global, 'cache.concurrency.global', DEFAULT_GLOBAL_CONCURRENCY),\n\t\tperSource: positiveWhole(\n\t\t\toption?.perSource,\n\t\t\t'cache.concurrency.perSource',\n\t\t\tDEFAULT_SOURCE_CONCURRENCY\n\t\t),\n\t\tperScope: positiveWhole(\n\t\t\toption?.perScope,\n\t\t\t'cache.concurrency.perScope',\n\t\t\tDEFAULT_COLD_READS_PER_SCOPE\n\t\t),\n\t}\n}\n\n/** The host's store, or the `analytics-cache` collection it replaces: never both. */\nconst resolveCacheStorage = (\n\toption: AnalyticsCacheOptions | undefined\n): Pick<ResolvedCache, 'store' | 'collection'> => {\n\tconst store: unknown = option?.store\n\tconst collection = option?.collection\n\tif (store !== undefined && !isCacheStore(store)) {\n\t\tthrow new Error(\n\t\t\t`analytics: cache.store must be an object with get, set, touch, sweep and recentRecipes methods, got ${kindOf(store)}`\n\t\t)\n\t}\n\tif (store !== undefined && collection !== undefined) {\n\t\tthrow new Error(\n\t\t\t'analytics: cache.collection shapes the analytics-cache collection, which cache.store replaces; set one of them'\n\t\t)\n\t}\n\treturn {\n\t\t...(store === undefined ? {} : { store }),\n\t\tcollection: resolveCollectionOption(collection, {\n\t\t\tpath: 'cache.collection',\n\t\t\tfallback: CACHE_SLUG,\n\t\t}),\n\t}\n}\n\n/** `cache`: TTLs, warming, the source deadline, concurrency and where reads are stored. */\nexport const resolveCache = (option: AnalyticsCacheOptions | undefined): ResolvedCache => {\n\tif (option !== undefined) {\n\t\toptionsObject(option, {\n\t\t\tpath: 'cache',\n\t\t\tknown: CACHE_KEYS,\n\t\t\texample: 'an object such as { timeoutMs: 15000 }',\n\t\t})\n\t\tif (option.ttl !== undefined) {\n\t\t\toptionsObject(option.ttl, {\n\t\t\t\tpath: 'cache.ttl',\n\t\t\t\tknown: TTL_KEYS,\n\t\t\t\texample: 'an object such as { aggregate: 300 }',\n\t\t\t})\n\t\t}\n\t}\n\treturn {\n\t\tttl: {\n\t\t\taggregate: optionalSeconds(option?.ttl?.aggregate, 'cache.ttl.aggregate'),\n\t\t\trealtime: optionalSeconds(option?.ttl?.realtime, 'cache.ttl.realtime'),\n\t\t},\n\t\twarm: resolveWarm(option?.warm),\n\t\ttimeoutMs: positiveWhole(option?.timeoutMs, 'cache.timeoutMs', DEFAULT_TIMEOUT_MS),\n\t\tconcurrency: resolveConcurrency(option?.concurrency),\n\t\t...resolveCacheStorage(option),\n\t}\n}\n\n/** `sync`: off unless set; `true` copies every vendor source with the defaults. */\nexport const resolveSync = (option: AnalyticsPluginOptions['sync']): ResolvedOptions['sync'] => {\n\tconst off: ResolvedOptions['sync'] = {\n\t\tenabled: false,\n\t\tlookbackDays: DEFAULT_SYNC_LOOKBACK,\n\t\tcollection: { slug: SYNC_SLUG, hidden: true },\n\t}\n\tif (!option) {\n\t\treturn off\n\t}\n\tif (option === true) {\n\t\treturn { ...off, enabled: true }\n\t}\n\tconst shaped = optionsObject(option, {\n\t\tpath: 'sync',\n\t\tknown: SYNC_KEYS,\n\t\texample: 'true, or an object such as { lookbackDays: 3 }',\n\t})\n\tfor (const entry of optionalList(shaped.adapters, 'sync.adapters', \"['plausible']\")) {\n\t\tif (typeof entry !== 'string' || entry.trim() === '') {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: sync.adapters entries must each be an adapter id or a provider type, got ${kindOf(entry)}`\n\t\t\t)\n\t\t}\n\t}\n\toptionalBoolean(option.collection?.hidden, 'sync.collection.hidden')\n\tconst collection = resolveCollectionOption(option.collection, {\n\t\tpath: 'sync.collection',\n\t\tfallback: SYNC_SLUG,\n\t\textra: ['hidden'],\n\t})\n\treturn {\n\t\tenabled: true,\n\t\tlookbackDays: positiveWhole(option.lookbackDays, 'sync.lookbackDays', DEFAULT_SYNC_LOOKBACK),\n\t\t...(option.adapters ? { adapters: option.adapters } : {}),\n\t\tcollection: { ...collection, hidden: option.collection?.hidden ?? true },\n\t}\n}\n\n/** `hooks`: functions the plugin calls around what it does. */\nexport const resolveHooks = (\n\toption: AnalyticsHooksOptions | undefined\n): ResolvedOptions['hooks'] => {\n\tif (option === undefined) {\n\t\treturn {}\n\t}\n\toptionsObject(option, {\n\t\tpath: 'hooks',\n\t\tknown: HOOKS_KEYS,\n\t\texample: 'an object such as { afterRead }',\n\t})\n\tconst afterRead = optionalFunction(option.afterRead, 'hooks.afterRead')\n\treturn afterRead ? { afterRead } : {}\n}\n"],"mappings":"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"}
|
|
@@ -1,27 +1,40 @@
|
|
|
1
|
-
import { DimensionKey, FilterOperator, Granularity, MetricKey } from "./contract.js";
|
|
1
|
+
import { AnalyticsFilter, DimensionKey, FilterOperator, Granularity, MetricKey } from "./contract.js";
|
|
2
2
|
|
|
3
3
|
//#region src/core/capabilities.d.ts
|
|
4
|
+
/** A filter's dimension and operator: what a source has to accept for the filter to apply. */
|
|
5
|
+
type FilterPair = Pick<AnalyticsFilter, 'dimension' | 'operator'>;
|
|
4
6
|
interface CapabilityRequirement {
|
|
5
7
|
metrics?: MetricKey[];
|
|
6
8
|
dimensions?: DimensionKey[];
|
|
7
|
-
|
|
8
|
-
|
|
9
|
+
/**
|
|
10
|
+
* Filters the source must accept: a dimension alone asks that it filter by that dimension at
|
|
11
|
+
* all, a pair that it filter by it with that operator.
|
|
12
|
+
*/
|
|
13
|
+
filters?: ReadonlyArray<DimensionKey | FilterPair>;
|
|
9
14
|
realtime?: boolean;
|
|
10
|
-
|
|
15
|
+
perItemQuery?: boolean;
|
|
16
|
+
/** The read is about one page (`AnalyticsQuery.path`), which a metric needing `page` accepts. */
|
|
17
|
+
path?: boolean;
|
|
11
18
|
}
|
|
12
|
-
/**
|
|
19
|
+
/**
|
|
20
|
+
* Wire form of AnalyticsCapabilities for client pickers: an allowlist, so adapter internals (rate
|
|
21
|
+
* limits, TTLs) never become client contract by accident.
|
|
22
|
+
*/
|
|
13
23
|
type SerializedCapabilities = {
|
|
14
24
|
metrics: MetricKey[];
|
|
15
|
-
dimensions: DimensionKey[];
|
|
16
|
-
filters: DimensionKey[];
|
|
17
|
-
|
|
25
|
+
dimensions: DimensionKey[]; /** The operators each filterable dimension takes, both in contract order. */
|
|
26
|
+
filters: Partial<Record<DimensionKey, FilterOperator[]>>; /** Where each metric the source cannot read under every breakdown is read; absent when none. */
|
|
27
|
+
metricReach?: Partial<Record<MetricKey, {
|
|
28
|
+
dimensions?: DimensionKey[];
|
|
29
|
+
requires?: DimensionKey;
|
|
30
|
+
}>>;
|
|
18
31
|
realtime: boolean;
|
|
19
|
-
realtimeWindowMinutes?: number;
|
|
20
|
-
|
|
32
|
+
realtimeWindowMinutes?: number; /** Present, and true, only on a source that answers one content item's reads. */
|
|
33
|
+
perItemQuery?: boolean;
|
|
21
34
|
comparison: boolean;
|
|
22
35
|
minGranularity: Granularity;
|
|
23
36
|
maxLookbackDays: number | null;
|
|
24
37
|
};
|
|
25
38
|
//#endregion
|
|
26
|
-
export { CapabilityRequirement, SerializedCapabilities };
|
|
39
|
+
export { CapabilityRequirement, FilterPair, SerializedCapabilities };
|
|
27
40
|
//# sourceMappingURL=capabilities.d.ts.map
|
|
@@ -1,31 +1,110 @@
|
|
|
1
|
+
import { DIMENSION_KEYS, FILTER_OPERATORS } from "./contract.js";
|
|
2
|
+
import { onlyKeys } from "./values.js";
|
|
1
3
|
//#region src/core/capabilities.ts
|
|
4
|
+
/** Every key a {@link CapabilityRequirement} takes. */
|
|
5
|
+
const CAPABILITY_REQUIREMENT_KEYS = [
|
|
6
|
+
"metrics",
|
|
7
|
+
"dimensions",
|
|
8
|
+
"filters",
|
|
9
|
+
"realtime",
|
|
10
|
+
"perItemQuery",
|
|
11
|
+
"path"
|
|
12
|
+
];
|
|
13
|
+
/** Retired requirement keys and their replacements; a Map, so no caller's key hits a prototype. */
|
|
14
|
+
const RETIRED_REQUIREMENT_KEYS = new Map([["perPageQuery", "path: true, for a widget that reads one page's numbers"], ["filterOperators", "filters naming each operator with its dimension, such as filters: [{ dimension: 'page', operator: 'contains' }]"]]);
|
|
15
|
+
/**
|
|
16
|
+
* Refuses a requirement key no source is checked against, naming the replacement of a retired one:
|
|
17
|
+
* an ignored key would register the widget where it should be left out.
|
|
18
|
+
*/
|
|
19
|
+
const assertRequirementKeys = (value, path) => {
|
|
20
|
+
for (const key of Object.keys(value)) {
|
|
21
|
+
const replacement = RETIRED_REQUIREMENT_KEYS.get(key);
|
|
22
|
+
if (replacement !== void 0) throw new Error(`analytics: ${path}.${key} is gone since 1.0.0-beta.12; use ${replacement}`);
|
|
23
|
+
}
|
|
24
|
+
onlyKeys(value, CAPABILITY_REQUIREMENT_KEYS, path);
|
|
25
|
+
};
|
|
26
|
+
/** The operators a source filters one dimension with, in contract order; empty when it cannot. */
|
|
27
|
+
const filterOperatorsFor = (caps, dimension) => {
|
|
28
|
+
const offered = caps.filters?.[dimension] ?? [];
|
|
29
|
+
return FILTER_OPERATORS.filter((operator) => offered.includes(operator));
|
|
30
|
+
};
|
|
31
|
+
/** Whether a source applies a filter of this dimension and operator. */
|
|
32
|
+
const supportsFilter = (caps, filter) => filterOperatorsFor(caps, filter.dimension).includes(filter.operator);
|
|
33
|
+
/** The first filter the source cannot apply, named so a refusal can say which one it was. */
|
|
34
|
+
const unsupportedFilter = (caps, filters) => filters.find((filter) => !supportsFilter(caps, filter));
|
|
35
|
+
/** The dimensions a source filters by at all, in contract order. */
|
|
36
|
+
const filterableDimensions = (caps) => DIMENSION_KEYS.filter((dimension) => filterOperatorsFor(caps, dimension).length > 0);
|
|
37
|
+
/** Whether a source meets one entry of a requirement's `filters`. */
|
|
38
|
+
const meetsFilter = (caps, wanted) => typeof wanted === "string" ? filterOperatorsFor(caps, wanted).length > 0 : supportsFilter(caps, wanted);
|
|
39
|
+
const filtersBy = (shape, dimension) => shape.filters?.some((filter) => (typeof filter === "string" ? filter : filter.dimension) === dimension) ?? false;
|
|
40
|
+
/**
|
|
41
|
+
* Why a source cannot read `metric` for a read of this shape: the dimension it cannot break the
|
|
42
|
+
* metric down by, or the one the read lacks. Null when it can.
|
|
43
|
+
*/
|
|
44
|
+
const metricOutOfReach = (caps, metric, shape) => {
|
|
45
|
+
const reach = caps.metricReach?.[metric];
|
|
46
|
+
if (!reach) return null;
|
|
47
|
+
const allowed = reach.dimensions;
|
|
48
|
+
const breakdown = allowed ? shape.dimensions?.find((d) => !allowed.includes(d)) : void 0;
|
|
49
|
+
if (breakdown !== void 0) return { breakdown };
|
|
50
|
+
const needs = reach.requires;
|
|
51
|
+
if (needs !== void 0 && !shape.dimensions?.includes(needs) && !filtersBy(shape, needs) && !(needs === "page" && shape.path === true)) return { needs };
|
|
52
|
+
return null;
|
|
53
|
+
};
|
|
54
|
+
/** Whether a source reads `metric` for a read of this shape, per its `metricReach`. */
|
|
55
|
+
const metricReaches = (caps, metric, shape) => metricOutOfReach(caps, metric, shape) === null;
|
|
56
|
+
/** Whether each of a requirement's metrics is read for the shape the requirement describes. */
|
|
57
|
+
const metricsReach = (caps, req) => req.metrics?.every((metric) => metricReaches(caps, metric, {
|
|
58
|
+
...req.dimensions ? { dimensions: req.dimensions } : {},
|
|
59
|
+
...req.filters ? { filters: req.filters } : {},
|
|
60
|
+
...req.path ? { path: true } : {}
|
|
61
|
+
})) ?? true;
|
|
62
|
+
/** Whether a source meets every part of a requirement. */
|
|
2
63
|
function satisfiesCapabilities(caps, req) {
|
|
3
64
|
if (req.realtime && !caps.realtime) return false;
|
|
4
|
-
if (req.
|
|
65
|
+
if (req.perItemQuery && caps.perItemQuery !== true) return false;
|
|
5
66
|
if (req.metrics?.some((m) => !caps.metrics.has(m))) return false;
|
|
6
67
|
if (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false;
|
|
7
|
-
if (req.filters?.some((
|
|
8
|
-
|
|
9
|
-
return true;
|
|
68
|
+
if (req.filters?.some((wanted) => !meetsFilter(caps, wanted))) return false;
|
|
69
|
+
return metricsReach(caps, req);
|
|
10
70
|
}
|
|
11
71
|
/**
|
|
12
72
|
* Whether a source compares against its previous period. The engine does that read
|
|
13
73
|
* generically, so it is on unless an adapter opted out.
|
|
14
74
|
*/
|
|
15
75
|
const comparisonOf = (caps) => caps.comparison ?? true;
|
|
16
|
-
const
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
}
|
|
76
|
+
const serializeFilters = (caps) => {
|
|
77
|
+
const filters = {};
|
|
78
|
+
for (const dimension of filterableDimensions(caps)) filters[dimension] = filterOperatorsFor(caps, dimension);
|
|
79
|
+
return filters;
|
|
80
|
+
};
|
|
81
|
+
const serializeReach = (caps) => {
|
|
82
|
+
const out = {};
|
|
83
|
+
for (const metric of caps.metrics) {
|
|
84
|
+
const reach = caps.metricReach?.[metric];
|
|
85
|
+
if (reach) out[metric] = {
|
|
86
|
+
...reach.dimensions ? { dimensions: [...reach.dimensions] } : {},
|
|
87
|
+
...reach.requires !== void 0 ? { requires: reach.requires } : {}
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
return Object.keys(out).length > 0 ? out : void 0;
|
|
91
|
+
};
|
|
92
|
+
const serializeCapabilities = (caps) => {
|
|
93
|
+
const metricReach = serializeReach(caps);
|
|
94
|
+
return {
|
|
95
|
+
metrics: [...caps.metrics],
|
|
96
|
+
dimensions: [...caps.dimensions],
|
|
97
|
+
filters: serializeFilters(caps),
|
|
98
|
+
...metricReach ? { metricReach } : {},
|
|
99
|
+
realtime: caps.realtime,
|
|
100
|
+
...caps.realtimeWindowMinutes !== void 0 ? { realtimeWindowMinutes: caps.realtimeWindowMinutes } : {},
|
|
101
|
+
...caps.perItemQuery === true ? { perItemQuery: true } : {},
|
|
102
|
+
comparison: comparisonOf(caps),
|
|
103
|
+
minGranularity: caps.minGranularity,
|
|
104
|
+
maxLookbackDays: caps.maxLookbackDays
|
|
105
|
+
};
|
|
106
|
+
};
|
|
28
107
|
//#endregion
|
|
29
|
-
export { comparisonOf, satisfiesCapabilities, serializeCapabilities };
|
|
108
|
+
export { assertRequirementKeys, comparisonOf, filterOperatorsFor, filterableDimensions, meetsFilter, metricOutOfReach, metricReaches, metricsReach, satisfiesCapabilities, serializeCapabilities, supportsFilter, unsupportedFilter };
|
|
30
109
|
|
|
31
110
|
//# sourceMappingURL=capabilities.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import type {\n\tAnalyticsCapabilities,\n\tDimensionKey,\n\tFilterOperator,\n\tGranularity,\n\tMetricKey,\n} from './contract'\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfilters?: DimensionKey[]\n\tfilterOperators?: FilterOperator[]\n\trealtime?: boolean\n\tperPageQuery?: boolean\n}\n\nexport function satisfiesCapabilities(\n\tcaps: AnalyticsCapabilities,\n\treq: CapabilityRequirement\n): boolean {\n\tif (req.realtime && !caps.realtime) return false\n\tif (req.perPageQuery && !caps.perPageQuery) return false\n\tif (req.metrics?.some((m) => !caps.metrics.has(m))) return false\n\tif (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false\n\tif (req.filters?.some((d) => !caps.filters.has(d))) return false\n\tif (req.filterOperators?.some((op) => !caps.filterOperators.has(op))) return false\n\treturn true\n}\n\n/**\n * Whether a source compares against its previous period. The engine does that read\n * generically, so it is on unless an adapter opted out.\n */\nexport const comparisonOf = (caps: AnalyticsCapabilities): boolean => caps.comparison ?? true\n\n/** Wire form of AnalyticsCapabilities for client pickers: a deliberate allowlist, so adapter internals (rate limits, TTLs) never become client contract by accident. */\nexport type SerializedCapabilities = {\n\tmetrics: MetricKey[]\n\tdimensions: DimensionKey[]\n\tfilters: DimensionKey[]\n\tfilterOperators: FilterOperator[]\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\tperPageQuery: boolean\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n}\n\nexport const serializeCapabilities = (caps: AnalyticsCapabilities): SerializedCapabilities => ({\n\tmetrics: [...caps.metrics],\n\tdimensions: [...caps.dimensions],\n\tfilters: [...caps.filters],\n\tfilterOperators: [...caps.filterOperators],\n\trealtime: caps.realtime,\n\t...(caps.realtimeWindowMinutes !== undefined\n\t\t? { realtimeWindowMinutes: caps.realtimeWindowMinutes }\n\t\t: {}),\n\tperPageQuery: caps.perPageQuery,\n\tcomparison: comparisonOf(caps),\n\tminGranularity: caps.minGranularity,\n\tmaxLookbackDays: caps.maxLookbackDays,\n})\n"],"mappings":";AAiBA,SAAgB,sBACf,MACA,KACU;CACV,IAAI,IAAI,YAAY,CAAC,KAAK,UAAU,OAAO;CAC3C,IAAI,IAAI,gBAAgB,CAAC,KAAK,cAAc,OAAO;CACnD,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,YAAY,MAAM,MAAM,CAAC,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO;CACjE,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,iBAAiB,MAAM,OAAO,CAAC,KAAK,gBAAgB,IAAI,EAAE,CAAC,GAAG,OAAO;CAC7E,OAAO;AACR;;;;;AAMA,MAAa,gBAAgB,SAAyC,KAAK,cAAc;AAgBzF,MAAa,yBAAyB,UAAyD;CAC9F,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,YAAY,CAAC,GAAG,KAAK,UAAU;CAC/B,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,iBAAiB,CAAC,GAAG,KAAK,eAAe;CACzC,UAAU,KAAK;CACf,GAAI,KAAK,0BAA0B,KAAA,IAChC,EAAE,uBAAuB,KAAK,sBAAsB,IACpD,CAAC;CACJ,cAAc,KAAK;CACnB,YAAY,aAAa,IAAI;CAC7B,gBAAgB,KAAK;CACrB,iBAAiB,KAAK;AACvB"}
|
|
1
|
+
{"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import {\n\ttype AnalyticsCapabilities,\n\ttype AnalyticsFilter,\n\tDIMENSION_KEYS,\n\ttype DimensionKey,\n\tFILTER_OPERATORS,\n\ttype FilterOperator,\n\ttype FilterOperatorMap,\n\ttype Granularity,\n\ttype MetricKey,\n\ttype MetricReach,\n} from './contract'\nimport { onlyKeys } from './values'\n\n/** A filter's dimension and operator: what a source has to accept for the filter to apply. */\nexport type FilterPair = Pick<AnalyticsFilter, 'dimension' | 'operator'>\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\n\t/**\n\t * Filters the source must accept: a dimension alone asks that it filter by that dimension at\n\t * all, a pair that it filter by it with that operator.\n\t */\n\tfilters?: ReadonlyArray<DimensionKey | FilterPair>\n\trealtime?: boolean\n\tperItemQuery?: boolean\n\t/** The read is about one page (`AnalyticsQuery.path`), which a metric needing `page` accepts. */\n\tpath?: boolean\n}\n\n/** Every key a {@link CapabilityRequirement} takes. */\nexport const CAPABILITY_REQUIREMENT_KEYS = [\n\t'metrics',\n\t'dimensions',\n\t'filters',\n\t'realtime',\n\t'perItemQuery',\n\t'path',\n] as const satisfies ReadonlyArray<keyof CapabilityRequirement>\n\n/** Retired requirement keys and their replacements; a Map, so no caller's key hits a prototype. */\nconst RETIRED_REQUIREMENT_KEYS: ReadonlyMap<string, string> = new Map([\n\t['perPageQuery', \"path: true, for a widget that reads one page's numbers\"],\n\t[\n\t\t'filterOperators',\n\t\t\"filters naming each operator with its dimension, such as filters: [{ dimension: 'page', operator: 'contains' }]\",\n\t],\n])\n\n/**\n * Refuses a requirement key no source is checked against, naming the replacement of a retired one:\n * an ignored key would register the widget where it should be left out.\n */\nexport const assertRequirementKeys = (value: Record<string, unknown>, path: string): void => {\n\tfor (const key of Object.keys(value)) {\n\t\tconst replacement = RETIRED_REQUIREMENT_KEYS.get(key)\n\t\tif (replacement !== undefined) {\n\t\t\tthrow new Error(`analytics: ${path}.${key} is gone since 1.0.0-beta.12; use ${replacement}`)\n\t\t}\n\t}\n\tonlyKeys(value, CAPABILITY_REQUIREMENT_KEYS, path)\n}\n\n/** The operators a source filters one dimension with, in contract order; empty when it cannot. */\nexport const filterOperatorsFor = (\n\tcaps: { filters?: FilterOperatorMap },\n\tdimension: DimensionKey\n): FilterOperator[] => {\n\tconst offered = caps.filters?.[dimension] ?? []\n\treturn FILTER_OPERATORS.filter((operator) => offered.includes(operator))\n}\n\n/** Whether a source applies a filter of this dimension and operator. */\nexport const supportsFilter = (\n\tcaps: { filters?: FilterOperatorMap },\n\tfilter: FilterPair\n): boolean => filterOperatorsFor(caps, filter.dimension).includes(filter.operator)\n\n/** The first filter the source cannot apply, named so a refusal can say which one it was. */\nexport const unsupportedFilter = <F extends FilterPair>(\n\tcaps: { filters?: FilterOperatorMap },\n\tfilters: readonly F[]\n): F | undefined => filters.find((filter) => !supportsFilter(caps, filter))\n\n/** The dimensions a source filters by at all, in contract order. */\nexport const filterableDimensions = (caps: { filters?: FilterOperatorMap }): DimensionKey[] =>\n\tDIMENSION_KEYS.filter((dimension) => filterOperatorsFor(caps, dimension).length > 0)\n\n/** Whether a source meets one entry of a requirement's `filters`. */\nexport const meetsFilter = (\n\tcaps: { filters?: FilterOperatorMap },\n\twanted: DimensionKey | FilterPair\n): boolean =>\n\ttypeof wanted === 'string'\n\t\t? filterOperatorsFor(caps, wanted).length > 0\n\t\t: supportsFilter(caps, wanted)\n\n/** What a read is about, as far as where a source reads a metric depends on it. */\nexport interface ReadShape {\n\tdimensions?: readonly DimensionKey[]\n\t/** The read's filters, or only the dimensions it filters by. */\n\tfilters?: ReadonlyArray<DimensionKey | FilterPair>\n\t/** The read is about one page (`AnalyticsQuery.path`). */\n\tpath?: boolean\n}\n\ntype ReachMap = Partial<Record<MetricKey, MetricReach>>\n\nconst filtersBy = (shape: ReadShape, dimension: DimensionKey): boolean =>\n\tshape.filters?.some(\n\t\t(filter) => (typeof filter === 'string' ? filter : filter.dimension) === dimension\n\t) ?? false\n\n/**\n * Why a source cannot read `metric` for a read of this shape: the dimension it cannot break the\n * metric down by, or the one the read lacks. Null when it can.\n */\nexport const metricOutOfReach = (\n\tcaps: { metricReach?: ReachMap },\n\tmetric: MetricKey,\n\tshape: ReadShape\n): { breakdown: DimensionKey } | { needs: DimensionKey } | null => {\n\tconst reach = caps.metricReach?.[metric]\n\tif (!reach) {\n\t\treturn null\n\t}\n\tconst allowed = reach.dimensions\n\tconst breakdown = allowed ? shape.dimensions?.find((d) => !allowed.includes(d)) : undefined\n\tif (breakdown !== undefined) {\n\t\treturn { breakdown }\n\t}\n\tconst needs = reach.requires\n\tif (\n\t\tneeds !== undefined &&\n\t\t!shape.dimensions?.includes(needs) &&\n\t\t!filtersBy(shape, needs) &&\n\t\t!(needs === 'page' && shape.path === true)\n\t) {\n\t\treturn { needs }\n\t}\n\treturn null\n}\n\n/** Whether a source reads `metric` for a read of this shape, per its `metricReach`. */\nexport const metricReaches = (\n\tcaps: { metricReach?: ReachMap },\n\tmetric: MetricKey,\n\tshape: ReadShape\n): boolean => metricOutOfReach(caps, metric, shape) === null\n\n/** Whether each of a requirement's metrics is read for the shape the requirement describes. */\nexport const metricsReach = (\n\tcaps: { metricReach?: ReachMap },\n\treq: CapabilityRequirement\n): boolean =>\n\treq.metrics?.every((metric) =>\n\t\tmetricReaches(caps, metric, {\n\t\t\t...(req.dimensions ? { dimensions: req.dimensions } : {}),\n\t\t\t...(req.filters ? { filters: req.filters } : {}),\n\t\t\t...(req.path ? { path: true } : {}),\n\t\t})\n\t) ?? true\n\n/** Whether a source meets every part of a requirement. */\nexport function satisfiesCapabilities(\n\tcaps: AnalyticsCapabilities,\n\treq: CapabilityRequirement\n): boolean {\n\tif (req.realtime && !caps.realtime) return false\n\tif (req.perItemQuery && caps.perItemQuery !== true) return false\n\tif (req.metrics?.some((m) => !caps.metrics.has(m))) return false\n\tif (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false\n\tif (req.filters?.some((wanted) => !meetsFilter(caps, wanted))) return false\n\treturn metricsReach(caps, req)\n}\n\n/**\n * Whether a source compares against its previous period. The engine does that read\n * generically, so it is on unless an adapter opted out.\n */\nexport const comparisonOf = (caps: AnalyticsCapabilities): boolean => caps.comparison ?? true\n\n/**\n * Wire form of AnalyticsCapabilities for client pickers: an allowlist, so adapter internals (rate\n * limits, TTLs) never become client contract by accident.\n */\nexport type SerializedCapabilities = {\n\tmetrics: MetricKey[]\n\tdimensions: DimensionKey[]\n\t/** The operators each filterable dimension takes, both in contract order. */\n\tfilters: Partial<Record<DimensionKey, FilterOperator[]>>\n\t/** Where each metric the source cannot read under every breakdown is read; absent when none. */\n\tmetricReach?: Partial<Record<MetricKey, { dimensions?: DimensionKey[]; requires?: DimensionKey }>>\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\t/** Present, and true, only on a source that answers one content item's reads. */\n\tperItemQuery?: boolean\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n}\n\nconst serializeFilters = (\n\tcaps: AnalyticsCapabilities\n): Partial<Record<DimensionKey, FilterOperator[]>> => {\n\tconst filters: Partial<Record<DimensionKey, FilterOperator[]>> = {}\n\tfor (const dimension of filterableDimensions(caps)) {\n\t\tfilters[dimension] = filterOperatorsFor(caps, dimension)\n\t}\n\treturn filters\n}\n\nconst serializeReach = (\n\tcaps: AnalyticsCapabilities\n): SerializedCapabilities['metricReach'] | undefined => {\n\tconst out: NonNullable<SerializedCapabilities['metricReach']> = {}\n\tfor (const metric of caps.metrics) {\n\t\tconst reach = caps.metricReach?.[metric]\n\t\tif (reach) {\n\t\t\tout[metric] = {\n\t\t\t\t...(reach.dimensions ? { dimensions: [...reach.dimensions] } : {}),\n\t\t\t\t...(reach.requires !== undefined ? { requires: reach.requires } : {}),\n\t\t\t}\n\t\t}\n\t}\n\treturn Object.keys(out).length > 0 ? out : undefined\n}\n\nexport const serializeCapabilities = (caps: AnalyticsCapabilities): SerializedCapabilities => {\n\tconst metricReach = serializeReach(caps)\n\treturn {\n\t\tmetrics: [...caps.metrics],\n\t\tdimensions: [...caps.dimensions],\n\t\tfilters: serializeFilters(caps),\n\t\t...(metricReach ? { metricReach } : {}),\n\t\trealtime: caps.realtime,\n\t\t...(caps.realtimeWindowMinutes !== undefined\n\t\t\t? { realtimeWindowMinutes: caps.realtimeWindowMinutes }\n\t\t\t: {}),\n\t\t...(caps.perItemQuery === true ? { perItemQuery: true } : {}),\n\t\tcomparison: comparisonOf(caps),\n\t\tminGranularity: caps.minGranularity,\n\t\tmaxLookbackDays: caps.maxLookbackDays,\n\t}\n}\n"],"mappings":"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"}
|