@10x-media/analytics 1.0.0-beta.11 → 1.0.0-beta.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +530 -0
- package/README.md +30 -37
- package/dist/access/adminUser.d.ts +15 -0
- package/dist/access/adminUser.js +13 -0
- package/dist/access/adminUser.js.map +1 -0
- package/dist/access/decideOnce.js +16 -0
- package/dist/access/decideOnce.js.map +1 -0
- package/dist/access/membership.d.ts +23 -0
- package/dist/access/membership.js +63 -0
- package/dist/access/membership.js.map +1 -0
- package/dist/access/principal.d.ts +37 -0
- package/dist/access/principal.js +29 -0
- package/dist/access/principal.js.map +1 -0
- package/dist/access/readGate.js +16 -0
- package/dist/access/readGate.js.map +1 -0
- package/dist/adapters/ga4/disableKey.js +7 -9
- package/dist/adapters/ga4/disableKey.js.map +1 -1
- package/dist/adapters/ga4/eventName.d.ts +2 -8
- package/dist/adapters/ga4/eventName.js +2 -8
- package/dist/adapters/ga4/eventName.js.map +1 -1
- package/dist/adapters/ga4/ga4.d.ts +17 -0
- package/dist/adapters/ga4/ga4.js +208 -124
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +2 -3
- package/dist/adapters/ga4/measurementId.js.map +1 -1
- package/dist/adapters/goalRead.js +15 -29
- package/dist/adapters/goalRead.js.map +1 -1
- package/dist/adapters/http/baseUrl.js +15 -0
- package/dist/adapters/http/baseUrl.js.map +1 -0
- package/dist/adapters/http/fetchJson.d.ts +19 -0
- package/dist/adapters/http/fetchJson.js +27 -8
- package/dist/adapters/http/fetchJson.js.map +1 -1
- package/dist/adapters/mapping.js +52 -0
- package/dist/adapters/mapping.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +19 -13
- package/dist/adapters/plausible/plausible.js +139 -123
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/plausible/scriptId.js +19 -0
- package/dist/adapters/plausible/scriptId.js.map +1 -0
- package/dist/adapters/posthog/posthog.d.ts +26 -9
- package/dist/adapters/posthog/posthog.js +194 -115
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/readTime.js +7 -0
- package/dist/adapters/readTime.js.map +1 -0
- package/dist/adapters/series.js +14 -8
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +13 -9
- package/dist/adapters/umami/umami.js +186 -173
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/adapters/upstream.js +16 -0
- package/dist/adapters/upstream.js.map +1 -0
- package/dist/binding/report.d.ts +8 -0
- package/dist/binding/report.js +24 -0
- package/dist/binding/report.js.map +1 -0
- package/dist/binding/resolvePath.js +16 -29
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/binding/types.d.ts +14 -29
- package/dist/capture/captureRequest.js +28 -0
- package/dist/capture/captureRequest.js.map +1 -0
- package/dist/capture/exclusionEndpoint.js +98 -0
- package/dist/capture/exclusionEndpoint.js.map +1 -0
- package/dist/capture/exclusionPrelude.js +14 -0
- package/dist/capture/exclusionPrelude.js.map +1 -0
- package/dist/capture/exclusionToken.js +23 -0
- package/dist/capture/exclusionToken.js.map +1 -0
- package/dist/capture/jsLiteral.js +19 -0
- package/dist/capture/jsLiteral.js.map +1 -0
- package/dist/capture/mountPath.js +2 -3
- package/dist/capture/mountPath.js.map +1 -1
- package/dist/capture/proxyEndpoint.js +48 -95
- package/dist/capture/proxyEndpoint.js.map +1 -1
- package/dist/capture/proxyRoutes.js +58 -21
- package/dist/capture/proxyRoutes.js.map +1 -1
- package/dist/capture/relay.js +91 -0
- package/dist/capture/relay.js.map +1 -0
- package/dist/capture/requestBody.js +2 -6
- package/dist/capture/requestBody.js.map +1 -1
- package/dist/capture/requestTrust.js +45 -0
- package/dist/capture/requestTrust.js.map +1 -0
- package/dist/capture/sameSite.js +40 -0
- package/dist/capture/sameSite.js.map +1 -0
- package/dist/capture/slots.js +50 -25
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.js +108 -36
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/capture/trackerEndpoint.js +22 -21
- package/dist/capture/trackerEndpoint.js.map +1 -1
- package/dist/charts/BarList.d.ts +27 -14
- package/dist/charts/BarList.js +38 -83
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +40 -7
- package/dist/charts/TrendChart.js +243 -215
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +15 -1
- package/dist/charts/bars.js +12 -12
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +106 -73
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/inProgress.js +22 -0
- package/dist/charts/inProgress.js.map +1 -0
- package/dist/charts/series.d.ts +15 -0
- package/dist/charts/series.js +123 -0
- package/dist/charts/series.js.map +1 -0
- package/dist/charts/spline.js +91 -25
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/trendGeometry.js +91 -0
- package/dist/charts/trendGeometry.js.map +1 -0
- package/dist/core/adminOptions.d.ts +1 -0
- package/dist/core/adminOptions.js +198 -0
- package/dist/core/adminOptions.js.map +1 -0
- package/dist/core/budget.js +24 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/cacheKey.d.ts +1 -0
- package/dist/core/cacheKey.js +48 -37
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/cacheOptions.js +165 -0
- package/dist/core/cacheOptions.js.map +1 -0
- package/dist/core/capabilities.d.ts +24 -11
- package/dist/core/capabilities.js +96 -17
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +28 -25
- package/dist/core/captureOptions.d.ts +1 -0
- package/dist/core/captureOptions.js +258 -0
- package/dist/core/captureOptions.js.map +1 -0
- package/dist/core/clock.js +13 -0
- package/dist/core/clock.js.map +1 -0
- package/dist/core/collectionOption.d.ts +17 -0
- package/dist/core/collectionOption.js +104 -0
- package/dist/core/collectionOption.js.map +1 -0
- package/dist/core/collectionSlug.js +7 -0
- package/dist/core/collectionSlug.js.map +1 -0
- package/dist/core/contract.d.ts +297 -59
- package/dist/core/contract.js +6 -4
- package/dist/core/contract.js.map +1 -1
- package/dist/core/cron.js +57 -0
- package/dist/core/cron.js.map +1 -0
- package/dist/core/fetch.d.ts +17 -0
- package/dist/core/goalOptions.d.ts +1 -0
- package/dist/core/goalOptions.js +166 -0
- package/dist/core/goalOptions.js.map +1 -0
- package/dist/core/granularity.js +3 -2
- package/dist/core/granularity.js.map +1 -1
- package/dist/core/guards.js +17 -0
- package/dist/core/guards.js.map +1 -0
- package/dist/core/jobs.d.ts +40 -0
- package/dist/core/jobs.js +132 -0
- package/dist/core/jobs.js.map +1 -0
- package/dist/core/legacyOptions.js +145 -0
- package/dist/core/legacyOptions.js.map +1 -0
- package/dist/core/metricAliases.js +81 -0
- package/dist/core/metricAliases.js.map +1 -0
- package/dist/core/metricValues.js +57 -0
- package/dist/core/metricValues.js.map +1 -0
- package/dist/core/monotonic.js +10 -0
- package/dist/core/monotonic.js.map +1 -0
- package/dist/core/optionChecks.js +51 -0
- package/dist/core/optionChecks.js.map +1 -0
- package/dist/core/options.d.ts +505 -157
- package/dist/core/options.js +158 -219
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.js +45 -5
- package/dist/core/registry.js.map +1 -1
- package/dist/core/scopeList.js +7 -9
- package/dist/core/scopeList.js.map +1 -1
- package/dist/core/scopeOptions.d.ts +1 -0
- package/dist/core/scopeOptions.js +114 -0
- package/dist/core/scopeOptions.js.map +1 -0
- package/dist/core/scopedRead.js +330 -71
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/sdks.d.ts +81 -0
- package/dist/core/sdks.js +23 -0
- package/dist/core/sdks.js.map +1 -0
- package/dist/core/serverEvent.d.ts +38 -20
- package/dist/core/serverEvent.js.map +1 -1
- package/dist/core/siteAddress.js +20 -0
- package/dist/core/siteAddress.js.map +1 -0
- package/dist/core/sourceErrors.js +109 -0
- package/dist/core/sourceErrors.js.map +1 -0
- package/dist/core/sourceLabel.d.ts +10 -0
- package/dist/core/sourceLabel.js +63 -0
- package/dist/core/sourceLabel.js.map +1 -0
- package/dist/core/sourceOptions.js +106 -0
- package/dist/core/sourceOptions.js.map +1 -0
- package/dist/core/sourcePolicy.d.ts +55 -0
- package/dist/core/sourcePolicy.js +51 -0
- package/dist/core/sourcePolicy.js.map +1 -0
- package/dist/core/throttle.js +18 -0
- package/dist/core/throttle.js.map +1 -0
- package/dist/core/values.js +61 -0
- package/dist/core/values.js.map +1 -0
- package/dist/core/widgetSlugs.d.ts +17 -0
- package/dist/core/widgetSlugs.js +29 -0
- package/dist/core/widgetSlugs.js.map +1 -0
- package/dist/db/detachedWrite.js +36 -0
- package/dist/db/detachedWrite.js.map +1 -0
- package/dist/db/errors.js +182 -0
- package/dist/db/errors.js.map +1 -0
- package/dist/db/kind.js +32 -0
- package/dist/db/kind.js.map +1 -0
- package/dist/db/openTransaction.js +51 -0
- package/dist/db/openTransaction.js.map +1 -0
- package/dist/exports/adapters/contract.d.ts +15 -0
- package/dist/exports/adapters/ga4.d.ts +16 -1
- package/dist/exports/adapters/native.d.ts +27 -2
- package/dist/exports/adapters/native.js +4 -1
- package/dist/exports/adapters/plausible.d.ts +16 -1
- package/dist/exports/adapters/posthog.d.ts +16 -1
- package/dist/exports/adapters/umami.d.ts +16 -1
- package/dist/exports/attributes.d.ts +42 -0
- package/dist/exports/attributes.js +83 -0
- package/dist/exports/attributes.js.map +1 -0
- package/dist/exports/client.d.ts +43 -13
- package/dist/exports/client.js +22 -9
- package/dist/exports/geo.d.ts +3 -1
- package/dist/exports/geo.js +1 -1
- package/dist/exports/i18n.d.ts +2 -2
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/migrations.d.ts +2 -0
- package/dist/exports/migrations.js +2 -0
- package/dist/exports/next.d.ts +19 -1
- package/dist/exports/next.js +3 -1
- package/dist/exports/react.d.ts +3 -2
- package/dist/exports/react.js +1 -2
- package/dist/exports/rsc.d.ts +32 -14
- package/dist/exports/rsc.js +11 -6
- package/dist/exports/site.d.ts +5 -0
- package/dist/exports/site.js +3 -0
- package/dist/exports/testing.d.ts +18 -0
- package/dist/exports/testing.js +3 -0
- package/dist/exports/tracker.d.ts +5 -20
- package/dist/exports/tracker.js +3 -14
- package/dist/exports/types.d.ts +44 -14
- package/dist/exports/types.js +5 -1
- package/dist/fields/AnalyticsPanelClient.js +265 -154
- package/dist/fields/AnalyticsPanelClient.js.map +1 -1
- package/dist/fields/AnalyticsPanelField.d.ts +19 -7
- package/dist/fields/AnalyticsPanelField.js +123 -30
- package/dist/fields/AnalyticsPanelField.js.map +1 -1
- package/dist/fields/AnalyticsStatField.d.ts +17 -6
- package/dist/fields/AnalyticsStatField.js +98 -63
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/FieldShimmer.js +15 -0
- package/dist/fields/FieldShimmer.js.map +1 -0
- package/dist/fields/PanelContent.js +222 -0
- package/dist/fields/PanelContent.js.map +1 -0
- package/dist/fields/PanelList.js +82 -0
- package/dist/fields/PanelList.js.map +1 -0
- package/dist/fields/PanelLiveCounter.js +63 -0
- package/dist/fields/PanelLiveCounter.js.map +1 -0
- package/dist/fields/PanelSkeleton.js +63 -0
- package/dist/fields/PanelSkeleton.js.map +1 -0
- package/dist/fields/componentPaths.js +8 -0
- package/dist/fields/componentPaths.js.map +1 -0
- package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
- package/dist/fields/config/FilterDimensionSelectField.js +26 -54
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
- package/dist/fields/config/FilterKeySelect.js +66 -0
- package/dist/fields/config/FilterKeySelect.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
- package/dist/fields/config/FilterOperatorSelectField.js +37 -53
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
- package/dist/fields/config/FilterValueField.d.ts +17 -0
- package/dist/fields/config/FilterValueField.js +130 -0
- package/dist/fields/config/FilterValueField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.d.ts +5 -12
- package/dist/fields/config/MetricSelectField.js +18 -30
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/OptionSelect.js +52 -0
- package/dist/fields/config/OptionSelect.js.map +1 -0
- package/dist/fields/config/SourceSelectField.js +16 -31
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.d.ts +3 -0
- package/dist/fields/config/fetchSources.js +17 -27
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/filterValues.js +106 -0
- package/dist/fields/config/filterValues.js.map +1 -0
- package/dist/fields/config/narrow.js +8 -10
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/retiredPickers.d.ts +45 -0
- package/dist/fields/config/retiredPickers.js +46 -0
- package/dist/fields/config/retiredPickers.js.map +1 -0
- package/dist/fields/config/scopedFields.d.ts +40 -0
- package/dist/fields/config/scopedFields.js +68 -0
- package/dist/fields/config/scopedFields.js.map +1 -0
- package/dist/fields/config/toSelectOption.js +13 -7
- package/dist/fields/config/toSelectOption.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
- package/dist/fields/config/useAnalyticsSources.js +17 -21
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
- package/dist/fields/config/useFilterCapabilities.js +23 -15
- package/dist/fields/config/useFilterCapabilities.js.map +1 -1
- package/dist/fields/config/useFormString.js +12 -0
- package/dist/fields/config/useFormString.js.map +1 -0
- package/dist/fields/dateRange/field.js +7 -19
- package/dist/fields/dateRange/field.js.map +1 -1
- package/dist/fields/dateRange/types.d.ts +5 -1
- package/dist/fields/dateRange/ui.d.ts +3 -2
- package/dist/fields/dateRange/ui.js +57 -319
- package/dist/fields/dateRange/ui.js.map +1 -1
- package/dist/fields/documentScope.js +21 -0
- package/dist/fields/documentScope.js.map +1 -0
- package/dist/fields/emptyState.js +31 -26
- package/dist/fields/emptyState.js.map +1 -1
- package/dist/fields/factories.d.ts +35 -16
- package/dist/fields/factories.js +66 -37
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/format.d.ts +12 -3
- package/dist/fields/format.js +77 -13
- package/dist/fields/format.js.map +1 -1
- package/dist/fields/itemReport.js +45 -0
- package/dist/fields/itemReport.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +79 -26
- package/dist/fields/readForDocument.js +450 -116
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/fields/stateKeys.js +20 -0
- package/dist/fields/stateKeys.js.map +1 -0
- package/dist/goals/GoalAmountField.d.ts +10 -0
- package/dist/goals/GoalAmountField.js +162 -0
- package/dist/goals/GoalAmountField.js.map +1 -0
- package/dist/goals/GoalSelectField.js +89 -40
- package/dist/goals/GoalSelectField.js.map +1 -1
- package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
- package/dist/goals/GoalSelectFieldServer.js +21 -0
- package/dist/goals/GoalSelectFieldServer.js.map +1 -0
- package/dist/goals/amountField.d.ts +20 -0
- package/dist/goals/amountField.js +37 -0
- package/dist/goals/amountField.js.map +1 -0
- package/dist/goals/builtin.js +17 -0
- package/dist/goals/builtin.js.map +1 -0
- package/dist/goals/collection.d.ts +22 -0
- package/dist/goals/collection.js +139 -125
- package/dist/goals/collection.js.map +1 -1
- package/dist/goals/constants.d.ts +38 -0
- package/dist/goals/constants.js +49 -0
- package/dist/goals/constants.js.map +1 -0
- package/dist/goals/currency.d.ts +16 -0
- package/dist/goals/currency.js +46 -4
- package/dist/goals/currency.js.map +1 -1
- package/dist/goals/currencyOptions.js +70 -0
- package/dist/goals/currencyOptions.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +10 -0
- package/dist/goals/fetchGoals.js +12 -26
- package/dist/goals/fetchGoals.js.map +1 -1
- package/dist/goals/goalField.d.ts +4 -6
- package/dist/goals/goalField.js +9 -19
- package/dist/goals/goalField.js.map +1 -1
- package/dist/goals/goalsEndpoint.js +39 -40
- package/dist/goals/goalsEndpoint.js.map +1 -1
- package/dist/goals/items.js +35 -0
- package/dist/goals/items.js.map +1 -0
- package/dist/goals/latent.js +9 -0
- package/dist/goals/latent.js.map +1 -0
- package/dist/goals/linkFields.d.ts +35 -0
- package/dist/goals/linkFields.js +31 -0
- package/dist/goals/linkFields.js.map +1 -0
- package/dist/goals/match.d.ts +14 -0
- package/dist/goals/match.js +67 -46
- package/dist/goals/match.js.map +1 -1
- package/dist/goals/moneyFields.js +56 -0
- package/dist/goals/moneyFields.js.map +1 -0
- package/dist/goals/pathMatch.js +122 -0
- package/dist/goals/pathMatch.js.map +1 -0
- package/dist/goals/placeholder.js +12 -0
- package/dist/goals/placeholder.js.map +1 -0
- package/dist/goals/resolver.d.ts +3 -3
- package/dist/goals/resolver.js +155 -47
- package/dist/goals/resolver.js.map +1 -1
- package/dist/goals/serverRevenue.d.ts +60 -0
- package/dist/goals/serverRevenue.js +41 -0
- package/dist/goals/serverRevenue.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +26 -27
- package/dist/goals/trackGoalAction.js +38 -52
- package/dist/goals/trackGoalAction.js.map +1 -1
- package/dist/goals/types.d.ts +13 -28
- package/dist/goals/types.js +1 -1
- package/dist/goals/types.js.map +1 -1
- package/dist/goals/useAnalyticsGoals.d.ts +6 -5
- package/dist/goals/useAnalyticsGoals.js +17 -18
- package/dist/goals/useAnalyticsGoals.js.map +1 -1
- package/dist/index.d.ts +67 -12
- package/dist/index.js +258 -247
- package/dist/index.js.map +1 -1
- package/dist/items/collectionIdType.js +20 -0
- package/dist/items/collectionIdType.js.map +1 -0
- package/dist/items/idType.js +31 -0
- package/dist/items/idType.js.map +1 -0
- package/dist/items/ref.js +73 -0
- package/dist/items/ref.js.map +1 -0
- package/dist/maintenance/apiTaskState.js +141 -0
- package/dist/maintenance/apiTaskState.js.map +1 -0
- package/dist/maintenance/heartbeat.js +51 -0
- package/dist/maintenance/heartbeat.js.map +1 -0
- package/dist/maintenance/lease.d.ts +1 -0
- package/dist/maintenance/lease.js +81 -0
- package/dist/maintenance/lease.js.map +1 -0
- package/dist/maintenance/taskSchedule.d.ts +1 -0
- package/dist/maintenance/taskSchedule.js +62 -0
- package/dist/maintenance/taskSchedule.js.map +1 -0
- package/dist/maintenance/underLease.js +35 -0
- package/dist/maintenance/underLease.js.map +1 -0
- package/dist/migrations/legacy.d.ts +54 -0
- package/dist/migrations/legacy.js +117 -0
- package/dist/migrations/legacy.js.map +1 -0
- package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
- package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
- package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
- package/dist/native/collections/aggregates.js +54 -0
- package/dist/native/collections/aggregates.js.map +1 -0
- package/dist/native/collections/hits.js +102 -0
- package/dist/native/collections/hits.js.map +1 -0
- package/dist/native/collections/slugs.d.ts +10 -0
- package/dist/native/collections/slugs.js +16 -0
- package/dist/native/collections/slugs.js.map +1 -0
- package/dist/native/collections/state.js +84 -0
- package/dist/native/collections/state.js.map +1 -0
- package/dist/native/collections/storeCollection.js +29 -0
- package/dist/native/collections/storeCollection.js.map +1 -0
- package/dist/native/engine/buckets.d.ts +1 -0
- package/dist/native/engine/buckets.js +53 -0
- package/dist/native/engine/buckets.js.map +1 -0
- package/dist/native/engine/capabilities.js +87 -0
- package/dist/native/engine/capabilities.js.map +1 -0
- package/dist/native/engine/cost.js +72 -0
- package/dist/native/engine/cost.js.map +1 -0
- package/dist/native/engine/days.d.ts +1 -0
- package/dist/native/engine/days.js +182 -0
- package/dist/native/engine/days.js.map +1 -0
- package/dist/native/engine/engine.d.ts +1 -0
- package/dist/native/engine/engine.js +1623 -0
- package/dist/native/engine/engine.js.map +1 -0
- package/dist/native/engine/instance.js +58 -0
- package/dist/native/engine/instance.js.map +1 -0
- package/dist/native/engine/maintenance.d.ts +1 -0
- package/dist/native/engine/maintenance.js +677 -0
- package/dist/native/engine/maintenance.js.map +1 -0
- package/dist/native/engine/merge.js +41 -0
- package/dist/native/engine/merge.js.map +1 -0
- package/dist/native/engine/nudge.js +26 -0
- package/dist/native/engine/nudge.js.map +1 -0
- package/dist/native/engine/planner.js +198 -0
- package/dist/native/engine/planner.js.map +1 -0
- package/dist/native/engine/rebuild.d.ts +22 -0
- package/dist/native/engine/rebuild.js +76 -0
- package/dist/native/engine/rebuild.js.map +1 -0
- package/dist/native/engine/recent.js +17 -0
- package/dist/native/engine/recent.js.map +1 -0
- package/dist/native/engine/salt.d.ts +1 -0
- package/dist/native/engine/salt.js +98 -0
- package/dist/native/engine/salt.js.map +1 -0
- package/dist/native/engine/siteHosts.d.ts +1 -0
- package/dist/native/engine/siteHosts.js +58 -0
- package/dist/native/engine/siteHosts.js.map +1 -0
- package/dist/native/engine/toHit.js +108 -0
- package/dist/native/engine/toHit.js.map +1 -0
- package/dist/native/engine/writeBuffer.d.ts +14 -0
- package/dist/native/engine/writeBuffer.js +317 -0
- package/dist/native/engine/writeBuffer.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
- package/dist/native/geo/composeGeoResolvers.js +4 -1
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +20 -2
- package/dist/native/geo/geoResolver.js +42 -6
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.d.ts +8 -4
- package/dist/native/geo/maxmindResolver.js +20 -16
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/geo/resolveGeo.js +31 -0
- package/dist/native/geo/resolveGeo.js.map +1 -0
- package/dist/native/ingest/bots.d.ts +2 -3
- package/dist/native/ingest/bots.js +8 -13
- package/dist/native/ingest/bots.js.map +1 -1
- package/dist/native/ingest/browser.js +4 -6
- package/dist/native/ingest/browser.js.map +1 -1
- package/dist/native/ingest/clientIp.js +30 -9
- package/dist/native/ingest/clientIp.js.map +1 -1
- package/dist/native/ingest/device.js +4 -6
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -1
- package/dist/native/ingest/endpoint.js +119 -34
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/itemSignature.d.ts +26 -0
- package/dist/native/ingest/itemSignature.js +45 -0
- package/dist/native/ingest/itemSignature.js.map +1 -0
- package/dist/native/ingest/language.js +2 -3
- package/dist/native/ingest/language.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +60 -7
- package/dist/native/ingest/normalizeEvent.js +226 -61
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/orderSignature.d.ts +13 -0
- package/dist/native/ingest/orderSignature.js +50 -0
- package/dist/native/ingest/orderSignature.js.map +1 -0
- package/dist/native/ingest/referrer.js +30 -32
- package/dist/native/ingest/referrer.js.map +1 -1
- package/dist/native/ingest/requestHost.js +10 -23
- package/dist/native/ingest/requestHost.js.map +1 -1
- package/dist/native/ingest/resolveHostname.d.ts +4 -13
- package/dist/native/ingest/resolveHostname.js +5 -6
- package/dist/native/ingest/resolveHostname.js.map +1 -1
- package/dist/native/ingest/revenue.d.ts +1 -0
- package/dist/native/ingest/revenue.js +121 -0
- package/dist/native/ingest/revenue.js.map +1 -0
- package/dist/native/ingest/route.d.ts +10 -0
- package/dist/native/ingest/route.js +82 -0
- package/dist/native/ingest/route.js.map +1 -0
- package/dist/native/ingest/serverTrack.d.ts +2 -10
- package/dist/native/ingest/serverTrack.js +181 -72
- package/dist/native/ingest/serverTrack.js.map +1 -1
- package/dist/native/ingest/signature.js +28 -0
- package/dist/native/ingest/signature.js.map +1 -0
- package/dist/native/ingest/source.d.ts +2 -3
- package/dist/native/ingest/source.js +35 -54
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +9 -9
- package/dist/native/ingest/utm.js.map +1 -1
- package/dist/native/ingest/validate.js +20 -10
- package/dist/native/ingest/validate.js.map +1 -1
- package/dist/native/ingest/visitorHash.js +6 -8
- package/dist/native/ingest/visitorHash.js.map +1 -1
- package/dist/native/nativeAdapter.d.ts +107 -33
- package/dist/native/nativeAdapter.js +376 -317
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rebuildDays.d.ts +12 -0
- package/dist/native/rebuildDays.js +16 -0
- package/dist/native/rebuildDays.js.map +1 -0
- package/dist/native/store/aggregate.js +450 -0
- package/dist/native/store/aggregate.js.map +1 -0
- package/dist/native/store/caps.d.ts +18 -0
- package/dist/native/store/caps.js +76 -0
- package/dist/native/store/caps.js.map +1 -0
- package/dist/native/store/chunks.js +34 -0
- package/dist/native/store/chunks.js.map +1 -0
- package/dist/native/store/columnValues.js +31 -0
- package/dist/native/store/columnValues.js.map +1 -0
- package/dist/native/store/dialect.js +106 -0
- package/dist/native/store/dialect.js.map +1 -0
- package/dist/native/store/eventStore.js +44 -0
- package/dist/native/store/eventStore.js.map +1 -0
- package/dist/native/store/hitRow.js +116 -0
- package/dist/native/store/hitRow.js.map +1 -0
- package/dist/native/store/hits.js +63 -0
- package/dist/native/store/hits.js.map +1 -0
- package/dist/native/store/ids.js +105 -0
- package/dist/native/store/ids.js.map +1 -0
- package/dist/native/store/mongo/aggregatePipelines.js +430 -0
- package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
- package/dist/native/store/mongo/mongoState.js +375 -0
- package/dist/native/store/mongo/mongoState.js.map +1 -0
- package/dist/native/store/mongo/mongoStore.js +618 -0
- package/dist/native/store/mongo/mongoStore.js.map +1 -0
- package/dist/native/store/mongo/pipelines.js +695 -0
- package/dist/native/store/mongo/pipelines.js.map +1 -0
- package/dist/native/store/mongo/results.js +20 -0
- package/dist/native/store/mongo/results.js.map +1 -0
- package/dist/native/store/parts.d.ts +1 -0
- package/dist/native/store/parts.js +95 -0
- package/dist/native/store/parts.js.map +1 -0
- package/dist/native/store/pattern.js +213 -0
- package/dist/native/store/pattern.js.map +1 -0
- package/dist/native/store/rawRead.d.ts +23 -0
- package/dist/native/store/rawRead.js +384 -0
- package/dist/native/store/rawRead.js.map +1 -0
- package/dist/native/store/reclassify.js +53 -0
- package/dist/native/store/reclassify.js.map +1 -0
- package/dist/native/store/sql/aggregateSql.js +345 -0
- package/dist/native/store/sql/aggregateSql.js.map +1 -0
- package/dist/native/store/sql/columns.js +48 -0
- package/dist/native/store/sql/columns.js.map +1 -0
- package/dist/native/store/sql/compile.js +656 -0
- package/dist/native/store/sql/compile.js.map +1 -0
- package/dist/native/store/sql/drivers.js +218 -0
- package/dist/native/store/sql/drivers.js.map +1 -0
- package/dist/native/store/sql/executor.js +132 -0
- package/dist/native/store/sql/executor.js.map +1 -0
- package/dist/native/store/sql/fragment.js +104 -0
- package/dist/native/store/sql/fragment.js.map +1 -0
- package/dist/native/store/sql/maintenanceSql.js +59 -0
- package/dist/native/store/sql/maintenanceSql.js.map +1 -0
- package/dist/native/store/sql/ownConnection.js +107 -0
- package/dist/native/store/sql/ownConnection.js.map +1 -0
- package/dist/native/store/sql/poolShare.js +101 -0
- package/dist/native/store/sql/poolShare.js.map +1 -0
- package/dist/native/store/sql/sqlState.js +325 -0
- package/dist/native/store/sql/sqlState.js.map +1 -0
- package/dist/native/store/sql/sqlStore.js +355 -0
- package/dist/native/store/sql/sqlStore.js.map +1 -0
- package/dist/native/store/sql/sqliteThread.d.ts +9 -0
- package/dist/native/store/sql/sqliteThread.js +314 -0
- package/dist/native/store/sql/sqliteThread.js.map +1 -0
- package/dist/native/store/sql/sqliteWorker.js +327 -0
- package/dist/native/store/sql/sqliteWorker.js.map +1 -0
- package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
- package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
- package/dist/native/store/state.js +151 -0
- package/dist/native/store/state.js.map +1 -0
- package/dist/native/store/stateStore.js +29 -0
- package/dist/native/store/stateStore.js.map +1 -0
- package/dist/native/store/types.d.ts +9 -0
- package/dist/native/tasks/maintainTask.d.ts +19 -0
- package/dist/native/tasks/maintainTask.js +68 -0
- package/dist/native/tasks/maintainTask.js.map +1 -0
- package/dist/net/guardedFetch.d.ts +32 -0
- package/dist/net/guardedFetch.js +220 -0
- package/dist/net/guardedFetch.js.map +1 -0
- package/dist/net/origin.js +40 -0
- package/dist/net/origin.js.map +1 -0
- package/dist/net/platform.d.ts +9 -0
- package/dist/net/platform.js +35 -0
- package/dist/net/platform.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +4 -24
- package/dist/next/captureRewrites.js +6 -50
- package/dist/next/captureRewrites.js.map +1 -1
- package/dist/next/captureRoute.d.ts +28 -0
- package/dist/next/captureRoute.js +67 -0
- package/dist/next/captureRoute.js.map +1 -0
- package/dist/next/ingestRoute.d.ts +17 -0
- package/dist/next/ingestRoute.js +17 -0
- package/dist/next/ingestRoute.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +3 -25
- package/dist/next/posthogProxyRewrites.js +5 -37
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/adminDependencies.js +34 -0
- package/dist/plugin/adminDependencies.js.map +1 -0
- package/dist/plugin/apiPath.js +23 -0
- package/dist/plugin/apiPath.js.map +1 -0
- package/dist/plugin/boundDocument.js +58 -0
- package/dist/plugin/boundDocument.js.map +1 -0
- package/dist/plugin/buildPhase.js +10 -0
- package/dist/plugin/buildPhase.js.map +1 -0
- package/dist/plugin/collectionChecks.js +232 -0
- package/dist/plugin/collectionChecks.js.map +1 -0
- package/dist/plugin/collectionFields.d.ts +13 -0
- package/dist/plugin/collectionFields.js +22 -0
- package/dist/plugin/collectionFields.js.map +1 -0
- package/dist/plugin/createRuntime.js +339 -0
- package/dist/plugin/createRuntime.js.map +1 -0
- package/dist/plugin/destroy.js +58 -0
- package/dist/plugin/destroy.js.map +1 -0
- package/dist/plugin/documentEndpoint.js +77 -53
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/documentScopes.js +37 -0
- package/dist/plugin/documentScopes.js.map +1 -0
- package/dist/plugin/encrypted.js +25 -0
- package/dist/plugin/encrypted.js.map +1 -0
- package/dist/plugin/errors.d.ts +5 -12
- package/dist/plugin/errors.js +23 -16
- package/dist/plugin/errors.js.map +1 -1
- package/dist/plugin/flagsEndpoint.js +41 -0
- package/dist/plugin/flagsEndpoint.js.map +1 -0
- package/dist/plugin/goalHint.js +22 -11
- package/dist/plugin/goalHint.js.map +1 -1
- package/dist/plugin/itemLabels.js +114 -0
- package/dist/plugin/itemLabels.js.map +1 -0
- package/dist/plugin/jobsAccess.js +91 -0
- package/dist/plugin/jobsAccess.js.map +1 -0
- package/dist/plugin/keepAlive.js +48 -0
- package/dist/plugin/keepAlive.js.map +1 -0
- package/dist/plugin/peerImportError.js +3 -6
- package/dist/plugin/peerImportError.js.map +1 -1
- package/dist/plugin/peers.js +64 -0
- package/dist/plugin/peers.js.map +1 -0
- package/dist/plugin/pluginCollections.js +161 -0
- package/dist/plugin/pluginCollections.js.map +1 -0
- package/dist/plugin/queryEndpoint.js +70 -45
- package/dist/plugin/queryEndpoint.js.map +1 -1
- package/dist/plugin/queryParams.js +7 -0
- package/dist/plugin/queryParams.js.map +1 -0
- package/dist/plugin/readContextForRequest.d.ts +11 -0
- package/dist/plugin/readContextForRequest.js +70 -25
- package/dist/plugin/readContextForRequest.js.map +1 -1
- package/dist/plugin/readFailure.js +22 -0
- package/dist/plugin/readFailure.js.map +1 -0
- package/dist/plugin/readableProviders.js +64 -0
- package/dist/plugin/readableProviders.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +77 -25
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +69 -44
- package/dist/plugin/refreshEndpoint.js.map +1 -1
- package/dist/plugin/relabelFields.js +36 -0
- package/dist/plugin/relabelFields.js.map +1 -0
- package/dist/plugin/requestMemo.js +35 -0
- package/dist/plugin/requestMemo.js.map +1 -0
- package/dist/plugin/routeChecks.js +39 -0
- package/dist/plugin/routeChecks.js.map +1 -0
- package/dist/plugin/routes.d.ts +53 -0
- package/dist/plugin/routes.js +92 -0
- package/dist/plugin/routes.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -1
- package/dist/plugin/runtime.js +234 -30
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/schemaOnly.js +63 -0
- package/dist/plugin/schemaOnly.js.map +1 -0
- package/dist/plugin/scopeChange.js +6 -5
- package/dist/plugin/scopeChange.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +4 -4
- package/dist/plugin/scopeFieldBoot.js.map +1 -1
- package/dist/plugin/scopeToken.js +33 -0
- package/dist/plugin/scopeToken.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +50 -17
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/unbundledLanguages.js +25 -0
- package/dist/plugin/unbundledLanguages.js.map +1 -0
- package/dist/plugin/walkFields.js +22 -0
- package/dist/plugin/walkFields.js.map +1 -0
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/ProvidersListNotice.d.ts +11 -0
- package/dist/providers/ProvidersListNotice.js +36 -0
- package/dist/providers/ProvidersListNotice.js.map +1 -0
- package/dist/providers/access.d.ts +1 -0
- package/dist/providers/access.js +35 -26
- package/dist/providers/access.js.map +1 -1
- package/dist/providers/adapterPool.js +121 -0
- package/dist/providers/adapterPool.js.map +1 -0
- package/dist/providers/collection.d.ts +61 -0
- package/dist/providers/collection.js +340 -151
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.d.ts +76 -0
- package/dist/providers/factory.js +75 -25
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/hosts.d.ts +25 -0
- package/dist/providers/hosts.js +128 -0
- package/dist/providers/hosts.js.map +1 -0
- package/dist/providers/probe.d.ts +1 -0
- package/dist/providers/probe.js +105 -0
- package/dist/providers/probe.js.map +1 -0
- package/dist/providers/refresh.d.ts +18 -0
- package/dist/providers/refresh.js +49 -0
- package/dist/providers/refresh.js.map +1 -0
- package/dist/providers/registry.js +328 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/resolver.js +26 -88
- package/dist/providers/resolver.js.map +1 -1
- package/dist/providers/retarget.js +45 -0
- package/dist/providers/retarget.js.map +1 -0
- package/dist/providers/scopeUnique.js +41 -0
- package/dist/providers/scopeUnique.js.map +1 -0
- package/dist/providers/secrets.d.ts +26 -0
- package/dist/providers/secrets.js +61 -4
- package/dist/providers/secrets.js.map +1 -1
- package/dist/providers/stampScope.js +9 -6
- package/dist/providers/stampScope.js.map +1 -1
- package/dist/query/dates.js +10 -12
- package/dist/query/dates.js.map +1 -1
- package/dist/query/errors.d.ts +1 -5
- package/dist/query/fetchQuery.d.ts +25 -32
- package/dist/query/fetchQuery.js +91 -91
- package/dist/query/fetchQuery.js.map +1 -1
- package/dist/query/limits.js +8 -0
- package/dist/query/limits.js.map +1 -0
- package/dist/query/parse.d.ts +6 -0
- package/dist/query/parse.js +153 -106
- package/dist/query/parse.js.map +1 -1
- package/dist/query/response.d.ts +23 -3
- package/dist/query/response.js +12 -5
- package/dist/query/response.js.map +1 -1
- package/dist/react/AnalyticsProvider.d.ts +26 -17
- package/dist/react/AnalyticsProvider.js +23 -22
- package/dist/react/AnalyticsProvider.js.map +1 -1
- package/dist/react/TrackerBoot.js +15 -9
- package/dist/react/TrackerBoot.js.map +1 -1
- package/dist/react/useAnalytics.d.ts +2 -11
- package/dist/react/useAnalytics.js +22 -24
- package/dist/react/useAnalytics.js.map +1 -1
- package/dist/site/AnalyticsScripts.d.ts +34 -0
- package/dist/site/AnalyticsScripts.js +30 -0
- package/dist/site/AnalyticsScripts.js.map +1 -0
- package/dist/site/getTrackerConfig.d.ts +15 -0
- package/dist/site/getTrackerConfig.js +40 -0
- package/dist/site/getTrackerConfig.js.map +1 -0
- package/dist/surfacing/afterRead.d.ts +37 -0
- package/dist/surfacing/bounded.js +38 -0
- package/dist/surfacing/bounded.js.map +1 -0
- package/dist/surfacing/breaker.js +107 -0
- package/dist/surfacing/breaker.js.map +1 -0
- package/dist/surfacing/cacheCollection.d.ts +8 -0
- package/dist/surfacing/cacheCollection.js +69 -0
- package/dist/surfacing/cacheCollection.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +71 -1
- package/dist/surfacing/cacheStore.js +16 -37
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/cacheSweep.d.ts +1 -0
- package/dist/surfacing/cacheSweep.js +59 -0
- package/dist/surfacing/cacheSweep.js.map +1 -0
- package/dist/surfacing/classifyError.js +282 -0
- package/dist/surfacing/classifyError.js.map +1 -0
- package/dist/surfacing/coalesce.js +2 -1
- package/dist/surfacing/coalesce.js.map +1 -1
- package/dist/surfacing/coldBudget.js +60 -0
- package/dist/surfacing/coldBudget.js.map +1 -0
- package/dist/surfacing/collectionCacheStore.js +183 -0
- package/dist/surfacing/collectionCacheStore.js.map +1 -0
- package/dist/surfacing/engine.d.ts +1 -1
- package/dist/surfacing/engine.js +514 -72
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.js +70 -26
- package/dist/surfacing/epoch.js.map +1 -1
- package/dist/surfacing/lanes.d.ts +1 -0
- package/dist/surfacing/lanes.js +297 -0
- package/dist/surfacing/lanes.js.map +1 -0
- package/dist/surfacing/memo.js +40 -0
- package/dist/surfacing/memo.js.map +1 -0
- package/dist/surfacing/rateLimiter.d.ts +1 -0
- package/dist/surfacing/rateLimiter.js +69 -94
- package/dist/surfacing/rateLimiter.js.map +1 -1
- package/dist/surfacing/rebucket.js +178 -0
- package/dist/surfacing/rebucket.js.map +1 -0
- package/dist/surfacing/recipe.js +28 -0
- package/dist/surfacing/recipe.js.map +1 -0
- package/dist/surfacing/shape.js +22 -0
- package/dist/surfacing/shape.js.map +1 -0
- package/dist/surfacing/todaySplit.js +113 -0
- package/dist/surfacing/todaySplit.js.map +1 -0
- package/dist/sync/collection.d.ts +8 -0
- package/dist/sync/collection.js +28 -18
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/rekeyDurations.js +70 -0
- package/dist/sync/rekeyDurations.js.map +1 -0
- package/dist/sync/syncTask.js +226 -109
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +6 -3
- package/dist/testing/memoryAdapter.js +12 -10
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/testing/settle.d.ts +11 -0
- package/dist/testing/settle.js +19 -0
- package/dist/testing/settle.js.map +1 -0
- package/dist/timeframe/calendar.js +65 -0
- package/dist/timeframe/calendar.js.map +1 -0
- package/dist/timeframe/comparison.js +46 -0
- package/dist/timeframe/comparison.js.map +1 -0
- package/dist/timeframe/presets.d.ts +1 -1
- package/dist/timeframe/presets.js +5 -5
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/reportingTimezone.d.ts +1 -0
- package/dist/timeframe/reportingTimezone.js +64 -0
- package/dist/timeframe/reportingTimezone.js.map +1 -0
- package/dist/timeframe/tz.js +55 -39
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.js +125 -38
- package/dist/tracker/autoCapture.js.map +1 -1
- package/dist/tracker/campaign.js +52 -0
- package/dist/tracker/campaign.js.map +1 -0
- package/dist/tracker/config.d.ts +149 -0
- package/dist/tracker/config.js +25 -0
- package/dist/tracker/config.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +4 -10
- package/dist/tracker/createTracker.js +386 -115
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/digest.js +28 -0
- package/dist/tracker/digest.js.map +1 -0
- package/dist/tracker/engagement.js +100 -0
- package/dist/tracker/engagement.js.map +1 -0
- package/dist/tracker/events.js +37 -0
- package/dist/tracker/events.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +2 -22
- package/dist/tracker/exclusion.js +53 -21
- package/dist/tracker/exclusion.js.map +1 -1
- package/dist/tracker/gate.js +194 -0
- package/dist/tracker/gate.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +5 -8
- package/dist/tracker/initTracker.js +42 -14
- package/dist/tracker/initTracker.js.map +1 -1
- package/dist/tracker/itemCapture.js +224 -0
- package/dist/tracker/itemCapture.js.map +1 -0
- package/dist/tracker/loadScript.js +21 -14
- package/dist/tracker/loadScript.js.map +1 -1
- package/dist/tracker/pageTracking.js +6 -6
- package/dist/tracker/pageTracking.js.map +1 -1
- package/dist/tracker/registry.js +118 -30
- package/dist/tracker/registry.js.map +1 -1
- package/dist/tracker/sinks/createSink.js +41 -0
- package/dist/tracker/sinks/createSink.js.map +1 -0
- package/dist/tracker/sinks/ga4.js +64 -20
- package/dist/tracker/sinks/ga4.js.map +1 -1
- package/dist/tracker/sinks/native.js +7 -42
- package/dist/tracker/sinks/native.js.map +1 -1
- package/dist/tracker/sinks/plausible.js +27 -22
- package/dist/tracker/sinks/plausible.js.map +1 -1
- package/dist/tracker/sinks/posthog.js +54 -22
- package/dist/tracker/sinks/posthog.js.map +1 -1
- package/dist/tracker/sinks/umami.js +14 -12
- package/dist/tracker/sinks/umami.js.map +1 -1
- package/dist/tracker/sinks/vendor.js +30 -27
- package/dist/tracker/sinks/vendor.js.map +1 -1
- package/dist/tracker/skip.js +81 -0
- package/dist/tracker/skip.js.map +1 -0
- package/dist/tracker/storage.js +23 -0
- package/dist/tracker/storage.js.map +1 -0
- package/dist/tracker/transport.js +2 -5
- package/dist/tracker/transport.js.map +1 -1
- package/dist/tracker/types.d.ts +86 -63
- package/dist/tracker/window.js +7 -0
- package/dist/tracker/window.js.map +1 -0
- package/dist/translations/ar.js +232 -71
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +221 -69
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +215 -67
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +223 -68
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +227 -72
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +218 -67
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/index.d.ts +1 -1
- package/dist/translations/index.js +5 -7
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/intl.js +71 -0
- package/dist/translations/intl.js.map +1 -0
- package/dist/translations/keys.d.ts +191 -14
- package/dist/translations/keys.js +196 -14
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +220 -69
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/labelMap.d.ts +10 -0
- package/dist/translations/labelMap.js +22 -0
- package/dist/translations/labelMap.js.map +1 -0
- package/dist/translations/metricKeys.js +10 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/parts.js +20 -0
- package/dist/translations/parts.js.map +1 -0
- package/dist/translations/plural.js +61 -0
- package/dist/translations/plural.js.map +1 -0
- package/dist/translations/pt.js +232 -77
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +223 -66
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.d.ts +1 -0
- package/dist/translations/server.js +2 -3
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/staticLabel.js +69 -0
- package/dist/translations/staticLabel.js.map +1 -0
- package/dist/translations/uk.js +223 -66
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +218 -67
- package/dist/translations/zh.js.map +1 -1
- package/dist/ui/RangePicker.js +112 -0
- package/dist/ui/RangePicker.js.map +1 -0
- package/dist/ui/analytics.css +1533 -0
- package/dist/ui/calendarDays.js +27 -0
- package/dist/ui/calendarDays.js.map +1 -0
- package/dist/ui/classNames.js +7 -0
- package/dist/ui/classNames.js.map +1 -0
- package/dist/ui/components/Card.d.ts +28 -0
- package/dist/ui/components/Card.js +21 -0
- package/dist/ui/components/Card.js.map +1 -0
- package/dist/ui/components/ChartDataTable.d.ts +41 -0
- package/dist/ui/components/ChartDataTable.js +48 -0
- package/dist/ui/components/ChartDataTable.js.map +1 -0
- package/dist/ui/components/DataTable.d.ts +82 -0
- package/dist/ui/components/DataTable.js +214 -0
- package/dist/ui/components/DataTable.js.map +1 -0
- package/dist/ui/components/LabeledSelect.js +62 -0
- package/dist/ui/components/LabeledSelect.js.map +1 -0
- package/dist/ui/components/LiveAnnouncement.js +21 -0
- package/dist/ui/components/LiveAnnouncement.js.map +1 -0
- package/dist/ui/components/MetricCard.d.ts +38 -0
- package/dist/ui/components/MetricCard.js +39 -0
- package/dist/ui/components/MetricCard.js.map +1 -0
- package/dist/ui/components/NoValue.js +22 -0
- package/dist/ui/components/NoValue.js.map +1 -0
- package/dist/ui/components/ReadState.js +27 -0
- package/dist/ui/components/ReadState.js.map +1 -0
- package/dist/ui/components/RefreshButton.js +26 -0
- package/dist/ui/components/RefreshButton.js.map +1 -0
- package/dist/ui/components/SourcesNoticeBanner.js +20 -0
- package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
- package/dist/ui/cssVars.js +7 -0
- package/dist/ui/cssVars.js.map +1 -0
- package/dist/ui/data/WithScopeToken.d.ts +20 -0
- package/dist/ui/data/WithScopeToken.js +20 -0
- package/dist/ui/data/WithScopeToken.js.map +1 -0
- package/dist/ui/data/clientFieldProps.js +16 -0
- package/dist/ui/data/clientFieldProps.js.map +1 -0
- package/dist/ui/data/request.d.ts +46 -0
- package/dist/ui/data/request.js +119 -0
- package/dist/ui/data/request.js.map +1 -0
- package/dist/ui/data/scopeTokenContext.js +18 -0
- package/dist/ui/data/scopeTokenContext.js.map +1 -0
- package/dist/ui/data/sharedCache.js +48 -0
- package/dist/ui/data/sharedCache.js.map +1 -0
- package/dist/ui/data/useRequest.d.ts +19 -0
- package/dist/ui/data/useRequest.js +123 -0
- package/dist/ui/data/useRequest.js.map +1 -0
- package/dist/ui/data/useRequestScope.js +25 -0
- package/dist/ui/data/useRequestScope.js.map +1 -0
- package/dist/ui/hooks/useDirection.js +47 -0
- package/dist/ui/hooks/useDirection.js.map +1 -0
- package/dist/ui/hooks/useDismissOnEscape.js +25 -0
- package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
- package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
- package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
- package/dist/ui/hooks/useRealtimePoll.js +112 -0
- package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
- package/dist/ui/readState.js +19 -0
- package/dist/ui/readState.js.map +1 -0
- package/dist/ui/rows/toDisplayRows.js +49 -0
- package/dist/ui/rows/toDisplayRows.js.map +1 -0
- package/dist/ui/viewerClock.js +7 -0
- package/dist/ui/viewerClock.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +5 -3
- package/dist/view/AnalyticsNavLink.js +11 -6
- package/dist/view/AnalyticsNavLink.js.map +1 -1
- package/dist/view/AnalyticsView.d.ts +8 -10
- package/dist/view/AnalyticsView.js +47 -18
- package/dist/view/AnalyticsView.js.map +1 -1
- package/dist/view/AnalyticsViewClient.d.ts +4 -7
- package/dist/view/AnalyticsViewClient.js +15 -229
- package/dist/view/AnalyticsViewClient.js.map +1 -1
- package/dist/view/CountryFlag.d.ts +27 -0
- package/dist/view/CountryFlag.js +44 -0
- package/dist/view/CountryFlag.js.map +1 -0
- package/dist/view/DocumentTitle.js +27 -0
- package/dist/view/DocumentTitle.js.map +1 -0
- package/dist/view/ViewRoot.d.ts +21 -0
- package/dist/view/ViewRoot.js +152 -0
- package/dist/view/ViewRoot.js.map +1 -0
- package/dist/view/ViewSections.d.ts +38 -0
- package/dist/view/ViewSections.js +190 -0
- package/dist/view/ViewSections.js.map +1 -0
- package/dist/view/authRedirect.js +2 -4
- package/dist/view/authRedirect.js.map +1 -1
- package/dist/view/conversionRate.js +9 -7
- package/dist/view/conversionRate.js.map +1 -1
- package/dist/view/dayRange.js +6 -10
- package/dist/view/dayRange.js.map +1 -1
- package/dist/view/exclusionLink.d.ts +27 -0
- package/dist/view/exclusionLink.js +46 -0
- package/dist/view/exclusionLink.js.map +1 -0
- package/dist/view/flagSrc.js +14 -0
- package/dist/view/flagSrc.js.map +1 -0
- package/dist/view/gating.d.ts +15 -1
- package/dist/view/gating.js +66 -31
- package/dist/view/gating.js.map +1 -1
- package/dist/view/hostCountryFlag.js +41 -0
- package/dist/view/hostCountryFlag.js.map +1 -0
- package/dist/view/labels.js +95 -10
- package/dist/view/labels.js.map +1 -1
- package/dist/view/metricAliases.js +10 -0
- package/dist/view/metricAliases.js.map +1 -0
- package/dist/view/navLabel.js +15 -0
- package/dist/view/navLabel.js.map +1 -0
- package/dist/view/registerView.js +13 -11
- package/dist/view/registerView.js.map +1 -1
- package/dist/view/scopeLabel.js +21 -0
- package/dist/view/scopeLabel.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +196 -134
- package/dist/view/sections/Breakdowns.js.map +1 -1
- package/dist/view/sections/EmptyStates.js +118 -30
- package/dist/view/sections/EmptyStates.js.map +1 -1
- package/dist/view/sections/ExcludeBrowser.js +188 -0
- package/dist/view/sections/ExcludeBrowser.js.map +1 -0
- package/dist/view/sections/FilterChips.js +124 -27
- package/dist/view/sections/FilterChips.js.map +1 -1
- package/dist/view/sections/GoalsPanel.js +68 -60
- package/dist/view/sections/GoalsPanel.js.map +1 -1
- package/dist/view/sections/OverviewCards.js +29 -33
- package/dist/view/sections/OverviewCards.js.map +1 -1
- package/dist/view/sections/RealtimeStrip.js +70 -59
- package/dist/view/sections/RealtimeStrip.js.map +1 -1
- package/dist/view/sections/SectionBoundary.js +34 -0
- package/dist/view/sections/SectionBoundary.js.map +1 -0
- package/dist/view/sections/Toolbar.d.ts +11 -0
- package/dist/view/sections/Toolbar.js +123 -82
- package/dist/view/sections/Toolbar.js.map +1 -1
- package/dist/view/sections/Trend.js +176 -76
- package/dist/view/sections/Trend.js.map +1 -1
- package/dist/view/state.d.ts +42 -0
- package/dist/view/state.js +93 -54
- package/dist/view/state.js.map +1 -1
- package/dist/view/useViewClock.js +31 -0
- package/dist/view/useViewClock.js.map +1 -0
- package/dist/view/useViewQueries.d.ts +21 -0
- package/dist/view/useViewQueries.js +45 -77
- package/dist/view/useViewQueries.js.map +1 -1
- package/dist/view/useViewState.js +42 -0
- package/dist/view/useViewState.js.map +1 -0
- package/dist/view/useViewUrl.js +47 -0
- package/dist/view/useViewUrl.js.map +1 -0
- package/dist/view/viewBody.js +30 -0
- package/dist/view/viewBody.js.map +1 -0
- package/dist/view/viewContext.d.ts +81 -0
- package/dist/view/viewContext.js +49 -0
- package/dist/view/viewContext.js.map +1 -0
- package/dist/view/viewProps.d.ts +65 -8
- package/dist/view/viewProps.js +123 -36
- package/dist/view/viewProps.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
- package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsMetricWidget.js +81 -106
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
- package/dist/widgets/AnalyticsTrendWidget.js +130 -123
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +33 -42
- package/dist/widgets/ComparisonDelta.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +24 -4
- package/dist/widgets/RealtimeCounter.js +91 -77
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetCard.d.ts +80 -0
- package/dist/widgets/WidgetCard.js +99 -0
- package/dist/widgets/WidgetCard.js.map +1 -0
- package/dist/widgets/WidgetFrame.js +42 -0
- package/dist/widgets/WidgetFrame.js.map +1 -0
- package/dist/widgets/WidgetShimmer.d.ts +55 -0
- package/dist/widgets/WidgetShimmer.js +86 -0
- package/dist/widgets/WidgetShimmer.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +12 -2
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/customWidget.d.ts +5 -1
- package/dist/widgets/customWidget.js +6 -7
- package/dist/widgets/customWidget.js.map +1 -1
- package/dist/widgets/defaultLayout.d.ts +26 -0
- package/dist/widgets/defaultLayout.js +51 -0
- package/dist/widgets/defaultLayout.js.map +1 -0
- package/dist/widgets/defaults.d.ts +4 -7
- package/dist/widgets/defaults.js +4 -7
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/fieldRows.js +14 -0
- package/dist/widgets/fieldRows.js.map +1 -0
- package/dist/widgets/filterCaption.js +6 -7
- package/dist/widgets/filterCaption.js.map +1 -1
- package/dist/widgets/filterField.d.ts +3 -7
- package/dist/widgets/filterField.js +46 -35
- package/dist/widgets/filterField.js.map +1 -1
- package/dist/widgets/filterValueLabel.d.ts +1 -0
- package/dist/widgets/filterValueLabel.js +45 -0
- package/dist/widgets/filterValueLabel.js.map +1 -0
- package/dist/widgets/notices.js +74 -0
- package/dist/widgets/notices.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +19 -2
- package/dist/widgets/prepareWidgetRead.js +63 -27
- package/dist/widgets/prepareWidgetRead.js.map +1 -1
- package/dist/widgets/range.js +26 -21
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +28 -19
- package/dist/widgets/readForWidget.js +33 -29
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
- package/dist/widgets/readForWidgetBreakdown.js +48 -22
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +18 -24
- package/dist/widgets/readForWidgetGoals.js +52 -46
- package/dist/widgets/readForWidgetGoals.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
- package/dist/widgets/readForWidgetRealtime.js +54 -28
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +27 -32
- package/dist/widgets/readForWidgetSeries.js +45 -82
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.d.ts +44 -0
- package/dist/widgets/readMeta.js +47 -4
- package/dist/widgets/readMeta.js.map +1 -1
- package/dist/widgets/realtimePoll.d.ts +1 -0
- package/dist/widgets/realtimePoll.js +53 -25
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +207 -127
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/stateKeys.js +30 -0
- package/dist/widgets/stateKeys.js.map +1 -0
- package/dist/widgets/titleForecast.js +89 -0
- package/dist/widgets/titleForecast.js.map +1 -0
- package/dist/widgets/types.d.ts +4 -3
- package/dist/widgets/types.js +2 -0
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +24 -6
- package/dist/widgets/viewLink.js +31 -24
- package/dist/widgets/viewLink.js.map +1 -1
- package/dist/widgets/widgetData.js +34 -0
- package/dist/widgets/widgetData.js.map +1 -0
- package/dist/widgets/widgetWindow.d.ts +1 -0
- package/dist/widgets/widgetWindow.js +51 -0
- package/dist/widgets/widgetWindow.js.map +1 -0
- package/package.json +44 -22
- package/dist/adapters/ga4/disableKey.d.ts +0 -9
- package/dist/capture/getTrackerConfig.d.ts +0 -20
- package/dist/capture/getTrackerConfig.js +0 -31
- package/dist/capture/getTrackerConfig.js.map +0 -1
- package/dist/capture/slots.d.ts +0 -8
- package/dist/capture/trackerConfig.d.ts +0 -33
- package/dist/charts/styles.js +0 -59
- package/dist/charts/styles.js.map +0 -1
- package/dist/fields/config/SourceSelectField.d.ts +0 -14
- package/dist/fields/dateRange/styles.js +0 -23
- package/dist/fields/dateRange/styles.js.map +0 -1
- package/dist/goals/GoalSelectField.d.ts +0 -7
- package/dist/native/collections/events.js +0 -165
- package/dist/native/collections/events.js.map +0 -1
- package/dist/native/collections/rollups.js +0 -151
- package/dist/native/collections/rollups.js.map +0 -1
- package/dist/native/collections/seen.js +0 -47
- package/dist/native/collections/seen.js.map +0 -1
- package/dist/native/eventScan.js +0 -25
- package/dist/native/eventScan.js.map +0 -1
- package/dist/native/ingest/flushBatch.js +0 -60
- package/dist/native/ingest/flushBatch.js.map +0 -1
- package/dist/native/ingest/salt.js +0 -39
- package/dist/native/ingest/salt.js.map +0 -1
- package/dist/native/ingest/writeBuffer.js +0 -55
- package/dist/native/ingest/writeBuffer.js.map +0 -1
- package/dist/native/ingest/writeEvent.js +0 -14
- package/dist/native/ingest/writeEvent.js.map +0 -1
- package/dist/native/query/eventAgg.js +0 -175
- package/dist/native/query/eventAgg.js.map +0 -1
- package/dist/native/realtime/buildRealtime.js +0 -53
- package/dist/native/realtime/buildRealtime.js.map +0 -1
- package/dist/native/retention/pruneTask.js +0 -69
- package/dist/native/retention/pruneTask.js.map +0 -1
- package/dist/native/rollupAcc.js +0 -64
- package/dist/native/rollupAcc.js.map +0 -1
- package/dist/native/rollups/bucketKey.js +0 -15
- package/dist/native/rollups/bucketKey.js.map +0 -1
- package/dist/native/rollups/bumpRollups.js +0 -116
- package/dist/native/rollups/bumpRollups.js.map +0 -1
- package/dist/native/rollups/deltas.js +0 -106
- package/dist/native/rollups/deltas.js.map +0 -1
- package/dist/native/rollups/insertManyIfNew.js +0 -93
- package/dist/native/rollups/insertManyIfNew.js.map +0 -1
- package/dist/plugin/paths.js +0 -29
- package/dist/plugin/paths.js.map +0 -1
- package/dist/react/TrackerBoot.d.ts +0 -22
- package/dist/rsc/AnalyticsScripts.d.ts +0 -30
- package/dist/rsc/AnalyticsScripts.js +0 -41
- package/dist/rsc/AnalyticsScripts.js.map +0 -1
- package/dist/surfacing/queue.js +0 -60
- package/dist/surfacing/queue.js.map +0 -1
- package/dist/surfacing/retryPolicy.js +0 -15
- package/dist/surfacing/retryPolicy.js.map +0 -1
- package/dist/tracker/autoCapture.d.ts +0 -48
- package/dist/tracker/consent.d.ts +0 -24
- package/dist/tracker/consent.js +0 -48
- package/dist/tracker/consent.js.map +0 -1
- package/dist/tracker/loadScript.d.ts +0 -14
- package/dist/tracker/pageTracking.d.ts +0 -17
- package/dist/tracker/registry.d.ts +0 -27
- package/dist/tracker/sinks/ga4.d.ts +0 -29
- package/dist/tracker/sinks/native.d.ts +0 -22
- package/dist/tracker/sinks/plausible.d.ts +0 -20
- package/dist/tracker/sinks/posthog.d.ts +0 -18
- package/dist/tracker/sinks/umami.d.ts +0 -18
- package/dist/tracker/sinks/vendor.d.ts +0 -14
- package/dist/view/sections/styles.js +0 -76
- package/dist/view/sections/styles.js.map +0 -1
- package/dist/widgets/WidgetViewLink.js +0 -17
- package/dist/widgets/WidgetViewLink.js.map +0 -1
- package/dist/widgets/cardChrome.d.ts +0 -8
- package/dist/widgets/cardChrome.js +0 -46
- package/dist/widgets/cardChrome.js.map +0 -1
- package/dist/widgets/comparison.js +0 -57
- package/dist/widgets/comparison.js.map +0 -1
package/dist/core/cacheKey.js
CHANGED
|
@@ -1,51 +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
|
-
...goalKey(q.goalSlugs)
|
|
46
|
-
].join("|");
|
|
47
|
-
}
|
|
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
|
+
});
|
|
48
59
|
//#endregion
|
|
49
|
-
export { buildCacheKey };
|
|
60
|
+
export { buildCacheKey, buildRealtimeKey };
|
|
50
61
|
|
|
51
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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"}
|
package/dist/core/capture.d.ts
CHANGED
|
@@ -1,49 +1,52 @@
|
|
|
1
|
+
import { CaptureSnippet, TrackerSlotConfig } from "../tracker/config.js";
|
|
2
|
+
import { FetchLike } from "./fetch.js";
|
|
3
|
+
|
|
1
4
|
//#region src/core/capture.d.ts
|
|
5
|
+
/** What a proxied route serves: a script the browser runs, or data its tracker sends and reads. */
|
|
6
|
+
type ProxyRouteKind = 'script' | 'data';
|
|
2
7
|
/** One rewrite the runtime proxy endpoint answers, source pattern to vendor upstream. */
|
|
3
8
|
interface ProxyRoute {
|
|
4
9
|
source: string;
|
|
5
10
|
upstream: string;
|
|
11
|
+
/**
|
|
12
|
+
* How the runtime proxy labels the answer: `script` as JavaScript; `data` keeps JSON or plain
|
|
13
|
+
* text, else becomes plain text, and is sandboxed so it never runs as a page of the site.
|
|
14
|
+
*/
|
|
15
|
+
kind: ProxyRouteKind;
|
|
6
16
|
}
|
|
7
17
|
/** Routes a Next rewrites helper and the runtime proxy endpoint both consume. */
|
|
8
18
|
interface ProxyDescriptor {
|
|
9
19
|
routes: ProxyRoute[];
|
|
10
20
|
forwardHeaders?: string[];
|
|
11
21
|
/**
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
* true keeps the request's trailing slash on the upstream path, absent or false
|
|
15
|
-
* normalizes it away. Next apps proxying such a vendor through rewrites also need
|
|
16
|
-
* `skipTrailingSlashRedirect: true`.
|
|
22
|
+
* True keeps the request's trailing slash upstream (PostHog's capture endpoints need it); absent
|
|
23
|
+
* or false strips it. Next rewrites to such a vendor also need `skipTrailingSlashRedirect: true`.
|
|
17
24
|
*/
|
|
18
25
|
trailingSlashes?: boolean;
|
|
26
|
+
/**
|
|
27
|
+
* The fetch the runtime proxy reaches these routes with, the same one the adapter reads with.
|
|
28
|
+
* Unset, the global fetch.
|
|
29
|
+
*/
|
|
30
|
+
fetch?: FetchLike;
|
|
19
31
|
}
|
|
20
|
-
interface SnippetScript {
|
|
21
|
-
src?: string;
|
|
22
|
-
inline?: string;
|
|
23
|
-
attrs?: Record<string, string>;
|
|
24
|
-
async?: boolean;
|
|
25
|
-
defer?: boolean;
|
|
26
|
-
type?: string;
|
|
27
|
-
}
|
|
28
|
-
interface CaptureSnippet {
|
|
29
|
-
scripts: SnippetScript[];
|
|
30
|
-
}
|
|
31
|
-
type CaptureClientKind = 'native' | 'posthog' | 'plausible' | 'umami' | 'ga4';
|
|
32
32
|
/**
|
|
33
|
-
*
|
|
34
|
-
* a
|
|
35
|
-
* carries private/secret credentials (e.g. PostHog's Query API key); only what the
|
|
36
|
-
* browser is allowed to see.
|
|
33
|
+
* How a vendor's browser tracker is proxied and booted. Carries only what the browser may see,
|
|
34
|
+
* never a secret credential such as PostHog's Query API key.
|
|
37
35
|
*/
|
|
38
36
|
interface CaptureSupport {
|
|
39
37
|
proxy: ProxyDescriptor;
|
|
38
|
+
/**
|
|
39
|
+
* `scope` is the request's resolved scope, which a vendor able to carry it stamps on every event.
|
|
40
|
+
* Null when unscoped or unresolved. `instance` names the client the snippet initialises, set
|
|
41
|
+
* only for a vendor that runs a second client beside the other slot's (PostHog).
|
|
42
|
+
*/
|
|
40
43
|
snippet(args: {
|
|
41
44
|
path: string;
|
|
45
|
+
scope?: string | null;
|
|
46
|
+
instance?: string;
|
|
42
47
|
}): CaptureSnippet;
|
|
43
|
-
client:
|
|
44
|
-
kind: CaptureClientKind;
|
|
45
|
-
} & Record<string, string | number | boolean>;
|
|
48
|
+
client: TrackerSlotConfig['client'];
|
|
46
49
|
}
|
|
47
50
|
//#endregion
|
|
48
|
-
export {
|
|
51
|
+
export { CaptureSupport, ProxyDescriptor, ProxyRoute, ProxyRouteKind };
|
|
49
52
|
//# sourceMappingURL=capture.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { };
|