@10x-media/analytics 0.1.0-beta.5 → 1.0.0-beta.10
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 +270 -0
- package/LICENSE +21 -21
- package/README.md +15 -4
- package/dist/adapters/ga4/disableKey.d.ts +9 -0
- package/dist/adapters/ga4/disableKey.js +21 -0
- package/dist/adapters/ga4/disableKey.js.map +1 -0
- package/dist/adapters/ga4/eventName.d.ts +15 -0
- package/dist/adapters/ga4/eventName.js +19 -0
- package/dist/adapters/ga4/eventName.js.map +1 -0
- package/dist/adapters/ga4/ga4.d.ts +5 -0
- package/dist/adapters/ga4/ga4.js +186 -58
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +15 -0
- package/dist/adapters/ga4/measurementId.js.map +1 -0
- package/dist/adapters/goalRead.js +126 -0
- package/dist/adapters/goalRead.js.map +1 -0
- package/dist/adapters/http/fetchJson.js +1 -1
- package/dist/adapters/plausible/plausible.d.ts +25 -0
- package/dist/adapters/plausible/plausible.js +159 -38
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/posthog/posthog.d.ts +10 -1
- package/dist/adapters/posthog/posthog.js +130 -21
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/series.js +11 -1
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +13 -1
- package/dist/adapters/umami/umami.js +278 -26
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/binding/resolvePath.js +18 -2
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/capture/getTrackerConfig.d.ts +20 -0
- package/dist/capture/getTrackerConfig.js +31 -0
- package/dist/capture/getTrackerConfig.js.map +1 -0
- package/dist/capture/mountPath.js +14 -0
- package/dist/capture/mountPath.js.map +1 -0
- package/dist/capture/proxyEndpoint.js +127 -0
- package/dist/capture/proxyEndpoint.js.map +1 -0
- package/dist/capture/proxyRoutes.js +108 -0
- package/dist/capture/proxyRoutes.js.map +1 -0
- package/dist/capture/requestBody.js +68 -0
- package/dist/capture/requestBody.js.map +1 -0
- package/dist/capture/slots.d.ts +8 -0
- package/dist/capture/slots.js +54 -0
- package/dist/capture/slots.js.map +1 -0
- package/dist/capture/trackerConfig.d.ts +33 -0
- package/dist/capture/trackerConfig.js +95 -0
- package/dist/capture/trackerConfig.js.map +1 -0
- package/dist/capture/trackerEndpoint.js +35 -0
- package/dist/capture/trackerEndpoint.js.map +1 -0
- package/dist/charts/BarList.d.ts +16 -1
- package/dist/charts/BarList.js +41 -19
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +16 -3
- package/dist/charts/TrendChart.js +172 -106
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +4 -0
- package/dist/charts/bars.js +3 -1
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +10 -1
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/spline.js +2 -2
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/styles.js +18 -1
- package/dist/charts/styles.js.map +1 -1
- package/dist/core/cacheKey.js +26 -3
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/capabilities.d.ts +5 -1
- package/dist/core/capabilities.js +11 -2
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +49 -0
- package/dist/core/contract.d.ts +74 -5
- package/dist/core/contract.js +30 -1
- package/dist/core/contract.js.map +1 -1
- package/dist/core/granularity.js +1 -1
- package/dist/core/options.d.ts +164 -6
- package/dist/core/options.js +126 -3
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.d.ts +1 -0
- package/dist/core/scopeList.js +32 -0
- package/dist/core/scopeList.js.map +1 -0
- package/dist/core/scopedRead.js +101 -30
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/serverEvent.d.ts +60 -0
- package/dist/core/serverEvent.js +12 -0
- package/dist/core/serverEvent.js.map +1 -0
- package/dist/exports/adapters/ga4.d.ts +2 -1
- package/dist/exports/adapters/ga4.js +2 -1
- package/dist/exports/adapters/native.d.ts +3 -1
- package/dist/exports/adapters/native.js +2 -1
- package/dist/exports/client.d.ts +13 -3
- package/dist/exports/client.js +10 -1
- package/dist/exports/geo.d.ts +2 -2
- package/dist/exports/next.d.ts +2 -1
- package/dist/exports/next.js +2 -1
- package/dist/exports/react.d.ts +4 -0
- package/dist/exports/react.js +5 -0
- package/dist/exports/rsc.d.ts +11 -3
- package/dist/exports/rsc.js +7 -2
- package/dist/exports/tracker.d.ts +21 -0
- package/dist/exports/tracker.js +15 -0
- package/dist/exports/types.d.ts +16 -3
- package/dist/exports/types.js +4 -2
- package/dist/fields/AnalyticsPanelClient.js +2 -2
- package/dist/fields/AnalyticsPanelField.js +1 -1
- package/dist/fields/AnalyticsStatField.js +2 -2
- package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
- package/dist/fields/config/FilterDimensionSelectField.js +77 -0
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
- package/dist/fields/config/FilterOperatorSelectField.js +75 -0
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.js +3 -3
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/SourceSelectField.js +3 -3
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.d.ts +5 -1
- package/dist/fields/config/fetchSources.js +7 -3
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/narrow.js +2 -0
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/sourcesState.js +19 -3
- package/dist/fields/config/sourcesState.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
- package/dist/fields/config/useAnalyticsSources.js +9 -6
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
- package/dist/fields/config/useFilterCapabilities.js +52 -0
- package/dist/fields/config/useFilterCapabilities.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +5 -0
- package/dist/fields/readForDocument.js +22 -10
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/goals/GoalSelectField.d.ts +7 -0
- package/dist/goals/GoalSelectField.js +77 -0
- package/dist/goals/GoalSelectField.js.map +1 -0
- package/dist/goals/collection.js +254 -0
- package/dist/goals/collection.js.map +1 -0
- package/dist/goals/currency.js +14 -0
- package/dist/goals/currency.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +18 -0
- package/dist/goals/fetchGoals.js +33 -0
- package/dist/goals/fetchGoals.js.map +1 -0
- package/dist/goals/goalField.d.ts +31 -0
- package/dist/goals/goalField.js +56 -0
- package/dist/goals/goalField.js.map +1 -0
- package/dist/goals/goalsEndpoint.d.ts +1 -0
- package/dist/goals/goalsEndpoint.js +58 -0
- package/dist/goals/goalsEndpoint.js.map +1 -0
- package/dist/goals/match.js +64 -0
- package/dist/goals/match.js.map +1 -0
- package/dist/goals/resolver.d.ts +8 -0
- package/dist/goals/resolver.js +147 -0
- package/dist/goals/resolver.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +76 -0
- package/dist/goals/trackGoalAction.js +158 -0
- package/dist/goals/trackGoalAction.js.map +1 -0
- package/dist/goals/types.d.ts +33 -0
- package/dist/goals/types.js +7 -0
- package/dist/goals/types.js.map +1 -0
- package/dist/goals/useAnalyticsGoals.d.ts +20 -0
- package/dist/goals/useAnalyticsGoals.js +67 -0
- package/dist/goals/useAnalyticsGoals.js.map +1 -0
- package/dist/index.d.ts +14 -3
- package/dist/index.js +174 -19
- package/dist/index.js.map +1 -1
- package/dist/native/collections/events.js +65 -1
- package/dist/native/collections/events.js.map +1 -1
- package/dist/native/collections/rollups.js +39 -3
- package/dist/native/collections/rollups.js.map +1 -1
- package/dist/native/eventScan.js +25 -0
- package/dist/native/eventScan.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.js +2 -2
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +9 -2
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.js +3 -5
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/ingest/bots.d.ts +11 -0
- package/dist/native/ingest/bots.js +71 -0
- package/dist/native/ingest/bots.js.map +1 -0
- package/dist/native/ingest/browser.js +47 -0
- package/dist/native/ingest/browser.js.map +1 -0
- package/dist/native/ingest/clientIp.js +20 -0
- package/dist/native/ingest/clientIp.js.map +1 -0
- package/dist/native/ingest/device.js +11 -3
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -0
- package/dist/native/ingest/endpoint.js +107 -21
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/flushBatch.js +29 -38
- package/dist/native/ingest/flushBatch.js.map +1 -1
- package/dist/native/ingest/language.js +14 -0
- package/dist/native/ingest/language.js.map +1 -0
- package/dist/native/ingest/normalizeEvent.d.ts +30 -0
- package/dist/native/ingest/normalizeEvent.js +115 -16
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/referrer.js +48 -0
- package/dist/native/ingest/referrer.js.map +1 -0
- package/dist/native/ingest/requestHost.js +57 -0
- package/dist/native/ingest/requestHost.js.map +1 -0
- package/dist/native/ingest/resolveHostname.d.ts +29 -0
- package/dist/native/ingest/resolveHostname.js +52 -0
- package/dist/native/ingest/resolveHostname.js.map +1 -0
- package/dist/native/ingest/salt.js +27 -2
- package/dist/native/ingest/salt.js.map +1 -1
- package/dist/native/ingest/serverTrack.d.ts +20 -0
- package/dist/native/ingest/serverTrack.js +109 -0
- package/dist/native/ingest/serverTrack.js.map +1 -0
- package/dist/native/ingest/source.d.ts +11 -0
- package/dist/native/ingest/source.js +264 -16
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +33 -0
- package/dist/native/ingest/utm.js.map +1 -0
- package/dist/native/ingest/validate.js +26 -0
- package/dist/native/ingest/validate.js.map +1 -0
- package/dist/native/nativeAdapter.d.ts +37 -1
- package/dist/native/nativeAdapter.js +175 -22
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/query/eventAgg.js +175 -0
- package/dist/native/query/eventAgg.js.map +1 -0
- package/dist/native/retention/pruneTask.js +53 -13
- package/dist/native/retention/pruneTask.js.map +1 -1
- package/dist/native/rollupAcc.js +12 -1
- package/dist/native/rollupAcc.js.map +1 -1
- package/dist/native/rollups/bucketKey.js +15 -0
- package/dist/native/rollups/bucketKey.js.map +1 -0
- package/dist/native/rollups/bumpRollups.js +116 -0
- package/dist/native/rollups/bumpRollups.js.map +1 -0
- package/dist/native/rollups/deltas.js +86 -11
- package/dist/native/rollups/deltas.js.map +1 -1
- package/dist/native/rollups/insertManyIfNew.js +93 -0
- package/dist/native/rollups/insertManyIfNew.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +42 -0
- package/dist/next/captureRewrites.js +57 -0
- package/dist/next/captureRewrites.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +5 -0
- package/dist/next/posthogProxyRewrites.js +16 -21
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/documentEndpoint.js +71 -24
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/errors.d.ts +31 -0
- package/dist/plugin/errors.js +79 -0
- package/dist/plugin/errors.js.map +1 -0
- package/dist/plugin/goalHint.d.ts +1 -0
- package/dist/plugin/goalHint.js +24 -0
- package/dist/plugin/goalHint.js.map +1 -0
- package/dist/plugin/paths.js +17 -1
- package/dist/plugin/paths.js.map +1 -1
- package/dist/plugin/queryEndpoint.js +124 -0
- package/dist/plugin/queryEndpoint.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +73 -0
- package/dist/plugin/readContextForRequest.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +37 -16
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +113 -0
- package/dist/plugin/refreshEndpoint.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -0
- package/dist/plugin/runtime.js +33 -1
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/scopeChange.js +22 -0
- package/dist/plugin/scopeChange.js.map +1 -0
- package/dist/plugin/scopeFieldBoot.js +22 -0
- package/dist/plugin/scopeFieldBoot.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +16 -41
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/collection.js +89 -29
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.js +11 -3
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/resolver.js.map +1 -1
- package/dist/query/dates.js +64 -0
- package/dist/query/dates.js.map +1 -0
- package/dist/query/errors.d.ts +14 -0
- package/dist/query/fetchQuery.d.ts +79 -0
- package/dist/query/fetchQuery.js +117 -0
- package/dist/query/fetchQuery.js.map +1 -0
- package/dist/query/parse.d.ts +22 -0
- package/dist/query/parse.js +168 -0
- package/dist/query/parse.js.map +1 -0
- package/dist/query/response.d.ts +39 -0
- package/dist/query/response.js +11 -0
- package/dist/query/response.js.map +1 -0
- package/dist/react/AnalyticsProvider.d.ts +50 -0
- package/dist/react/AnalyticsProvider.js +67 -0
- package/dist/react/AnalyticsProvider.js.map +1 -0
- package/dist/react/TrackerBoot.d.ts +22 -0
- package/dist/react/TrackerBoot.js +30 -0
- package/dist/react/TrackerBoot.js.map +1 -0
- package/dist/react/useAnalytics.d.ts +20 -0
- package/dist/react/useAnalytics.js +52 -0
- package/dist/react/useAnalytics.js.map +1 -0
- package/dist/rsc/AnalyticsScripts.d.ts +30 -0
- package/dist/rsc/AnalyticsScripts.js +41 -0
- package/dist/rsc/AnalyticsScripts.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +1 -0
- package/dist/surfacing/cacheStore.js +18 -2
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/engine.d.ts +1 -0
- package/dist/surfacing/engine.js +47 -6
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.d.ts +1 -0
- package/dist/surfacing/epoch.js +72 -0
- package/dist/surfacing/epoch.js.map +1 -0
- package/dist/surfacing/queue.js +22 -6
- package/dist/surfacing/queue.js.map +1 -1
- package/dist/surfacing/rateLimiter.js +130 -0
- package/dist/surfacing/rateLimiter.js.map +1 -0
- package/dist/surfacing/retryPolicy.js +15 -0
- package/dist/surfacing/retryPolicy.js.map +1 -0
- package/dist/sync/collection.js +23 -7
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/syncTask.js +68 -33
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +2 -0
- package/dist/testing/memoryAdapter.js +17 -1
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/timeframe/tz.js +17 -6
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.d.ts +48 -0
- package/dist/tracker/autoCapture.js +129 -0
- package/dist/tracker/autoCapture.js.map +1 -0
- package/dist/tracker/consent.d.ts +24 -0
- package/dist/tracker/consent.js +48 -0
- package/dist/tracker/consent.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +18 -0
- package/dist/tracker/createTracker.js +215 -0
- package/dist/tracker/createTracker.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +28 -0
- package/dist/tracker/exclusion.js +50 -0
- package/dist/tracker/exclusion.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +22 -0
- package/dist/tracker/initTracker.js +33 -0
- package/dist/tracker/initTracker.js.map +1 -0
- package/dist/tracker/loadScript.d.ts +14 -0
- package/dist/tracker/loadScript.js +41 -0
- package/dist/tracker/loadScript.js.map +1 -0
- package/dist/tracker/pageTracking.d.ts +17 -0
- package/dist/tracker/pageTracking.js +38 -0
- package/dist/tracker/pageTracking.js.map +1 -0
- package/dist/tracker/registry.d.ts +27 -0
- package/dist/tracker/registry.js +73 -0
- package/dist/tracker/registry.js.map +1 -0
- package/dist/tracker/sinks/ga4.d.ts +29 -0
- package/dist/tracker/sinks/ga4.js +30 -0
- package/dist/tracker/sinks/ga4.js.map +1 -0
- package/dist/tracker/sinks/native.d.ts +22 -0
- package/dist/tracker/sinks/native.js +56 -0
- package/dist/tracker/sinks/native.js.map +1 -0
- package/dist/tracker/sinks/plausible.d.ts +20 -0
- package/dist/tracker/sinks/plausible.js +32 -0
- package/dist/tracker/sinks/plausible.js.map +1 -0
- package/dist/tracker/sinks/posthog.d.ts +18 -0
- package/dist/tracker/sinks/posthog.js +30 -0
- package/dist/tracker/sinks/posthog.js.map +1 -0
- package/dist/tracker/sinks/umami.d.ts +18 -0
- package/dist/tracker/sinks/umami.js +23 -0
- package/dist/tracker/sinks/umami.js.map +1 -0
- package/dist/tracker/sinks/vendor.d.ts +14 -0
- package/dist/tracker/sinks/vendor.js +81 -0
- package/dist/tracker/sinks/vendor.js.map +1 -0
- package/dist/tracker/transport.js +28 -0
- package/dist/tracker/transport.js.map +1 -0
- package/dist/tracker/types.d.ts +91 -0
- package/dist/translations/ar.js +221 -0
- package/dist/translations/ar.js.map +1 -0
- package/dist/translations/de.js +145 -1
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +145 -1
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +221 -0
- package/dist/translations/es.js.map +1 -0
- package/dist/translations/fr.js +221 -0
- package/dist/translations/fr.js.map +1 -0
- package/dist/translations/id.js +221 -0
- package/dist/translations/id.js.map +1 -0
- package/dist/translations/index.d.ts +10 -1
- package/dist/translations/index.js +19 -1
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/keys.d.ts +144 -0
- package/dist/translations/keys.js +145 -1
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +221 -0
- package/dist/translations/ko.js.map +1 -0
- package/dist/translations/metricKeys.js +8 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/pt.js +221 -0
- package/dist/translations/pt.js.map +1 -0
- package/dist/translations/ru.js +221 -0
- package/dist/translations/ru.js.map +1 -0
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/uk.js +221 -0
- package/dist/translations/uk.js.map +1 -0
- package/dist/translations/zh.js +221 -0
- package/dist/translations/zh.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +19 -0
- package/dist/view/AnalyticsNavLink.js +40 -0
- package/dist/view/AnalyticsNavLink.js.map +1 -0
- package/dist/view/AnalyticsView.d.ts +23 -0
- package/dist/view/AnalyticsView.js +45 -0
- package/dist/view/AnalyticsView.js.map +1 -0
- package/dist/view/AnalyticsViewClient.d.ts +15 -0
- package/dist/view/AnalyticsViewClient.js +244 -0
- package/dist/view/AnalyticsViewClient.js.map +1 -0
- package/dist/view/authRedirect.js +32 -0
- package/dist/view/authRedirect.js.map +1 -0
- package/dist/view/conversionRate.js +18 -0
- package/dist/view/conversionRate.js.map +1 -0
- package/dist/view/dayRange.js +68 -0
- package/dist/view/dayRange.js.map +1 -0
- package/dist/view/gating.d.ts +1 -0
- package/dist/view/gating.js +142 -0
- package/dist/view/gating.js.map +1 -0
- package/dist/view/labels.js +76 -0
- package/dist/view/labels.js.map +1 -0
- package/dist/view/registerView.js +48 -0
- package/dist/view/registerView.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +198 -0
- package/dist/view/sections/Breakdowns.js.map +1 -0
- package/dist/view/sections/EmptyStates.js +92 -0
- package/dist/view/sections/EmptyStates.js.map +1 -0
- package/dist/view/sections/FilterChips.js +46 -0
- package/dist/view/sections/FilterChips.js.map +1 -0
- package/dist/view/sections/GoalsPanel.js +82 -0
- package/dist/view/sections/GoalsPanel.js.map +1 -0
- package/dist/view/sections/OverviewCards.js +65 -0
- package/dist/view/sections/OverviewCards.js.map +1 -0
- package/dist/view/sections/RealtimeStrip.js +80 -0
- package/dist/view/sections/RealtimeStrip.js.map +1 -0
- package/dist/view/sections/Toolbar.js +207 -0
- package/dist/view/sections/Toolbar.js.map +1 -0
- package/dist/view/sections/Trend.js +125 -0
- package/dist/view/sections/Trend.js.map +1 -0
- package/dist/view/sections/styles.js +76 -0
- package/dist/view/sections/styles.js.map +1 -0
- package/dist/view/state.js +211 -0
- package/dist/view/state.js.map +1 -0
- package/dist/view/useViewQueries.js +153 -0
- package/dist/view/useViewQueries.js.map +1 -0
- package/dist/view/viewProps.d.ts +40 -0
- package/dist/view/viewProps.js +90 -0
- package/dist/view/viewProps.js.map +1 -0
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
- package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
- package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsMetricWidget.js +63 -13
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsTrendWidget.js +79 -16
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +4 -0
- package/dist/widgets/RealtimeCounter.js +18 -4
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetViewLink.js +17 -0
- package/dist/widgets/WidgetViewLink.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +38 -0
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/cardChrome.js +31 -7
- package/dist/widgets/cardChrome.js.map +1 -1
- package/dist/widgets/comparison.js +15 -1
- package/dist/widgets/comparison.js.map +1 -1
- package/dist/widgets/defaults.d.ts +6 -2
- package/dist/widgets/defaults.js +78 -23
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/filterCaption.js +27 -0
- package/dist/widgets/filterCaption.js.map +1 -0
- package/dist/widgets/filterField.d.ts +19 -0
- package/dist/widgets/filterField.js +75 -0
- package/dist/widgets/filterField.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +7 -0
- package/dist/widgets/prepareWidgetRead.js +74 -0
- package/dist/widgets/prepareWidgetRead.js.map +1 -0
- package/dist/widgets/range.js +43 -12
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +26 -3
- package/dist/widgets/readForWidget.js +48 -44
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
- package/dist/widgets/readForWidgetBreakdown.js +53 -49
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +67 -0
- package/dist/widgets/readForWidgetGoals.js +140 -0
- package/dist/widgets/readForWidgetGoals.js.map +1 -0
- package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
- package/dist/widgets/readForWidgetRealtime.js +23 -21
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +26 -2
- package/dist/widgets/readForWidgetSeries.js +78 -53
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.js +18 -0
- package/dist/widgets/readMeta.js.map +1 -0
- package/dist/widgets/realtimePoll.js +13 -1
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +62 -10
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/types.d.ts +15 -0
- package/dist/widgets/types.js +16 -2
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +22 -0
- package/dist/widgets/viewLink.js +86 -0
- package/dist/widgets/viewLink.js.map +1 -0
- package/package.json +28 -8
- package/dist/native/rollups/applyDistinctDeltas.js +0 -9
- package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
- package/dist/native/rollups/bumpRollup.js +0 -68
- package/dist/native/rollups/bumpRollup.js.map +0 -1
- package/dist/native/rollups/insertIfNew.js +0 -19
- package/dist/native/rollups/insertIfNew.js.map +0 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trackGoalAction.js","names":[],"sources":["../../src/goals/trackGoalAction.ts"],"sourcesContent":["import type { Field, Payload, PayloadRequest } from 'payload'\nimport { AnalyticsTrackError } from '../core/serverEvent'\nimport { normalizeHostname, requestHostname } from '../native/ingest/requestHost'\nimport { ingestAdapter, trackServerEvent } from '../native/ingest/serverTrack'\nimport { getRuntime } from '../plugin/runtime'\nimport { keys } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport { validateCurrency } from './currency'\nimport { goalField, goalSlug } from './goalField'\n\n/** The action type form-builder stores as the block slug on a form's `actions` array. */\nexport const GOAL_ACTION_TYPE = 'analyticsGoal'\n\n/**\n * The run context form-builder hands a post-submit action, narrowed to what goal tracking\n * reads. A structural subset rather than an import: analytics never depends on form-builder\n * at runtime, so an install without it still resolves this module.\n */\nexport interface GoalActionRunArgs {\n\tform: { id: number | string; title?: string }\n\tsubmissionId: number | string\n\t/** One entry per answered field, keyed by the field's machine name. */\n\tvalues: Array<{ field: string; value: unknown }>\n\tconfig: Record<string, unknown>\n\tpayload: Payload\n\t/**\n\t * The request the action runs under. On a queued dispatch this is the job runner's own\n\t * request, not the visitor's, so it carries neither the submitting host nor the tenant.\n\t */\n\treq?: PayloadRequest\n}\n\n/**\n * Structural counterpart of form-builder's `ActionDefinition<Record<string, unknown>>`; a\n * value of this type is assignable to it, which `trackGoalAction.test.ts` pins.\n */\nexport interface GoalActionDefinition {\n\ttype: typeof GOAL_ACTION_TYPE\n\tlabel: string | Record<string, string>\n\tconfig: Field[]\n\trun: (args: GoalActionRunArgs) => Promise<void>\n}\n\nexport interface TrackGoalActionOptions {\n\t/**\n\t * Site the completion belongs to. Falls back to the submitting request's host as the\n\t * native adapter's `hostname` policy judges it, then to the host of `serverURL`. With none\n\t * of the three the completion is not recorded at all, and one warning names the install.\n\t * Set it whenever a jobs runner queues actions: the runner's request carries the CMS host\n\t * at best, and often no host at all.\n\t */\n\thostname?: string | ((args: GoalActionRunArgs) => string)\n\t/** Page the completion is attributed to. Defaults to `/forms/<form id>`. */\n\tpath?: string | ((args: GoalActionRunArgs) => string)\n\t/**\n\t * Analytics boundary to stamp; `null` is install-wide. Leave unset and the scope resolves\n\t * from the action's request, which on a queued dispatch is the runner's rather than the\n\t * submitter's and so usually lands install-wide. Set it on any scoped install whose\n\t * actions are queued, since the submitter's tenant cannot be recovered there.\n\t */\n\tscope?: string | null | ((args: GoalActionRunArgs) => string | null | Promise<string | null>)\n}\n\nconst configFields = (): Field[] => [\n\tgoalField({ name: 'goal', required: true }),\n\t{\n\t\tname: 'value',\n\t\ttype: 'number',\n\t\tmin: 0,\n\t\tlabel: labelForKey(keys.goalFieldValue),\n\t},\n\t{\n\t\tname: 'valueFrom',\n\t\ttype: 'text',\n\t\tlabel: labelForKey(keys.actionGoalFieldValueFrom),\n\t\tadmin: { description: labelForKey(keys.actionGoalFieldValueFromHelp) },\n\t},\n\t{\n\t\tname: 'currency',\n\t\ttype: 'text',\n\t\tlabel: labelForKey(keys.goalFieldCurrency),\n\t\tvalidate: validateCurrency,\n\t},\n]\n\nconst finiteNumber = (value: unknown): number | undefined => {\n\tif (typeof value === 'number') {\n\t\treturn Number.isFinite(value) ? value : undefined\n\t}\n\tif (typeof value === 'string' && value.trim() !== '') {\n\t\tconst parsed = Number(value)\n\t\treturn Number.isFinite(parsed) ? parsed : undefined\n\t}\n\treturn undefined\n}\n\nconst nonEmpty = (value: unknown): string | undefined => {\n\tif (typeof value !== 'string') {\n\t\treturn undefined\n\t}\n\tconst trimmed = value.trim()\n\treturn trimmed === '' ? undefined : trimmed\n}\n\nconst fromOption = (\n\toption: string | ((args: GoalActionRunArgs) => string) | undefined,\n\targs: GoalActionRunArgs\n): string | undefined =>\n\tnonEmpty(typeof option === 'function' ? option(args) : (option ?? undefined))\n\nconst serverUrlHost = (payload: Payload): string | null => {\n\tconst serverURL = nonEmpty(payload.config?.serverURL)\n\tif (!serverURL) {\n\t\treturn null\n\t}\n\ttry {\n\t\treturn normalizeHostname(new URL(serverURL).hostname)\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * The submitting request's host as the hostname policy of the very adapter the event is written\n * through judges it: a `Host` header is forgeable, and a conversion must not be able to mint a\n * hostname the ingest endpoint would have refused. Without that adapter exposing the seam the\n * request's own host stands in, which is the policy's default anyway.\n */\nconst policyHostname = async (\n\targs: GoalActionRunArgs,\n\tscope: string | null\n): Promise<string | null> => {\n\tif (!args.req) {\n\t\treturn null\n\t}\n\tconst policy = ingestAdapter(args.payload)?.ingest?.hostname\n\tif (policy) {\n\t\treturn policy({ req: args.req, scope })\n\t}\n\treturn requestHostname(args.req.headers, {\n\t\ttrustedProxyHops: getRuntime(args.payload)?.trustedProxyHops,\n\t})\n}\n\n/**\n * The option, then the submitting request under the ingest hostname policy, then the install's\n * own `serverURL`. Every rung is normalized to the one hostname shape, and null means the\n * conversion cannot be attributed to any site at all. The queued dispatch path reaches the last\n * two with the runner's request, so an install that queues actions and serves more than one\n * site has to say which site in the option.\n */\nconst hostnameFor = async (\n\toptions: TrackGoalActionOptions,\n\targs: GoalActionRunArgs,\n\tscope: string | null\n): Promise<string | null> => {\n\tconst configured = normalizeHostname(fromOption(options.hostname, args))\n\tif (configured) {\n\t\treturn configured\n\t}\n\treturn (await policyHostname(args, scope)) ?? serverUrlHost(args.payload)\n}\n\nlet warnedNoHostname = false\n\n/**\n * Once per process: a public form would otherwise let a repeated submission choose how much the\n * log grows, and a whole install misconfigured this way is one line's worth of news.\n */\nconst warnNoHostname = (payload: Payload): void => {\n\tif (warnedNoHostname) {\n\t\treturn\n\t}\n\twarnedNoHostname = true\n\tpayload.logger?.warn(\n\t\t\"analytics: a form goal could not be recorded because no hostname resolved: set serverURL or check the adapter's hostname policy\"\n\t)\n}\n\n/** The fixed value wins; otherwise the named answer, and only when it reads as a number. */\nconst valueFor = (args: GoalActionRunArgs): number | undefined => {\n\tconst fixed = finiteNumber(args.config.value)\n\tif (fixed !== undefined) {\n\t\treturn fixed\n\t}\n\tconst field = nonEmpty(args.config.valueFrom)\n\tif (!field) {\n\t\treturn undefined\n\t}\n\treturn finiteNumber(args.values.find((entry) => entry.field === field)?.value)\n}\n\nconst propsFor = (args: GoalActionRunArgs): Record<string, unknown> => {\n\tconst props: Record<string, unknown> = {\n\t\tformId: String(args.form.id),\n\t\tsubmissionId: String(args.submissionId),\n\t}\n\tconst title = nonEmpty(args.form.title)\n\tif (title) {\n\t\tprops.formTitle = title\n\t}\n\treturn props\n}\n\nconst scopeFor = async (\n\toptions: TrackGoalActionOptions,\n\targs: GoalActionRunArgs\n): Promise<{ scope?: string | null }> => {\n\tif (options.scope === undefined) {\n\t\treturn {}\n\t}\n\treturn { scope: typeof options.scope === 'function' ? await options.scope(args) : options.scope }\n}\n\n/**\n * A form-builder post-submit action that completes an analytics goal, authored per form in\n * the admin: pick the goal, optionally a revenue value (fixed, or read from a submission\n * field) and its currency. Register it through form-builder's `actions` option under\n * {@link GOAL_ACTION_TYPE}.\n *\n * Needs the native adapter, since it records through {@link trackServerEvent}. `essential`\n * is deliberately unset: a goal is a measurement, so a failed write is logged and the\n * submission still succeeds.\n *\n * On any install with a jobs runner, form-builder queues non-essential actions, and the\n * queued run carries the runner's request rather than the visitor's. Set `hostname` (and\n * `scope`, on a scoped install) there, since neither can be recovered from that request.\n */\nexport const trackGoalAction = (options: TrackGoalActionOptions = {}): GoalActionDefinition => ({\n\ttype: GOAL_ACTION_TYPE,\n\tlabel: keys.actionGoalLabel,\n\tconfig: configFields(),\n\trun: async (args) => {\n\t\tconst slug = goalSlug(args.config.goal)\n\t\tif (!slug) {\n\t\t\tthrow new AnalyticsTrackError('analytics: trackGoalAction has no goal configured')\n\t\t}\n\t\tconst scope = await scopeFor(options, args)\n\t\tconst hostname = await hostnameFor(options, args, scope.scope ?? null)\n\t\tif (!hostname) {\n\t\t\twarnNoHostname(args.payload)\n\t\t\treturn\n\t\t}\n\t\tawait trackServerEvent(\n\t\t\targs.payload,\n\t\t\t{\n\t\t\t\ttype: 'goal',\n\t\t\t\tname: slug,\n\t\t\t\tpath: fromOption(options.path, args) ?? `/forms/${args.form.id}`,\n\t\t\t\thostname,\n\t\t\t\tvalue: valueFor(args),\n\t\t\t\tcurrency: nonEmpty(args.config.currency),\n\t\t\t\tprops: propsFor(args),\n\t\t\t\t...scope,\n\t\t\t},\n\t\t\t{ req: args.req }\n\t\t)\n\t},\n})\n"],"mappings":"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"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
//#region src/goals/types.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* How an incoming event is recognized as a completion of this goal. `goal` matches an
|
|
4
|
+
* explicit `trackGoal(slug)` call, which is what the attribute and action hookups emit.
|
|
5
|
+
*/
|
|
6
|
+
type GoalMatch = {
|
|
7
|
+
kind: 'event';
|
|
8
|
+
name: string;
|
|
9
|
+
} | {
|
|
10
|
+
kind: 'path';
|
|
11
|
+
pattern: string;
|
|
12
|
+
} | {
|
|
13
|
+
kind: 'goal';
|
|
14
|
+
};
|
|
15
|
+
interface Goal {
|
|
16
|
+
/** Stable identifier, kebab-case; unique across the install's goals. */
|
|
17
|
+
slug: string;
|
|
18
|
+
/** Admin-facing label. Never leaves the server: the tracker config carries slugs only. */
|
|
19
|
+
name: string;
|
|
20
|
+
match: GoalMatch;
|
|
21
|
+
/** Revenue for one completion: a fixed amount, or read from an event property. */
|
|
22
|
+
value?: {
|
|
23
|
+
fixed?: number;
|
|
24
|
+
prop?: string;
|
|
25
|
+
};
|
|
26
|
+
/** ISO 4217 code the goal's value is denominated in. */
|
|
27
|
+
currency?: string;
|
|
28
|
+
}
|
|
29
|
+
/** The goal fields the browser tracker needs; `name` is admin-facing only. */
|
|
30
|
+
type TrackerGoal = Pick<Goal, 'slug' | 'match' | 'value' | 'currency'>;
|
|
31
|
+
//#endregion
|
|
32
|
+
export { Goal, GoalMatch, TrackerGoal };
|
|
33
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","names":[],"sources":["../../src/goals/types.ts"],"sourcesContent":["/**\n * How an incoming event is recognized as a completion of this goal. `goal` matches an\n * explicit `trackGoal(slug)` call, which is what the attribute and action hookups emit.\n */\nexport type GoalMatch =\n\t| { kind: 'event'; name: string }\n\t| { kind: 'path'; pattern: string }\n\t| { kind: 'goal' }\n\nexport interface Goal {\n\t/** Stable identifier, kebab-case; unique across the install's goals. */\n\tslug: string\n\t/** Admin-facing label. Never leaves the server: the tracker config carries slugs only. */\n\tname: string\n\tmatch: GoalMatch\n\t/** Revenue for one completion: a fixed amount, or read from an event property. */\n\tvalue?: { fixed?: number; prop?: string }\n\t/** ISO 4217 code the goal's value is denominated in. */\n\tcurrency?: string\n}\n\n/** The goal fields the browser tracker needs; `name` is admin-facing only. */\nexport type TrackerGoal = Pick<Goal, 'slug' | 'match' | 'value' | 'currency'>\n\n/** Kebab-case, so a slug is safe in a URL, a data attribute, and a rollup bucket key. */\nexport const GOAL_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/\n"],"mappings":";;AAyBA,MAAa,oBAAoB"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { GoalsResponse } from "./fetchGoals.js";
|
|
2
|
+
|
|
3
|
+
//#region src/goals/useAnalyticsGoals.d.ts
|
|
4
|
+
interface AnalyticsGoals {
|
|
5
|
+
/** Null until the fetch settles, and on a failed one: not the same thing as none. */
|
|
6
|
+
goals: GoalsResponse['goals'] | null;
|
|
7
|
+
collection: GoalsResponse['collection'];
|
|
8
|
+
/** The fetch settled in failure, so a picker can say so instead of claiming none exist. */
|
|
9
|
+
error: boolean;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Fetches the caller-scope goal list for the admin goal picker. `goals` stays null while
|
|
13
|
+
* the fetch is in flight, when it fails, and when there is no authenticated user yet, so
|
|
14
|
+
* a picker can tell "still loading" from "this scope has no goals". Goals fetched for a
|
|
15
|
+
* previous user are never returned while a new user's fetch is pending.
|
|
16
|
+
*/
|
|
17
|
+
declare const useAnalyticsGoals: () => AnalyticsGoals;
|
|
18
|
+
//#endregion
|
|
19
|
+
export { useAnalyticsGoals };
|
|
20
|
+
//# sourceMappingURL=useAnalyticsGoals.d.ts.map
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { fetchGoals } from "./fetchGoals.js";
|
|
3
|
+
import { useEffect, useState } from "react";
|
|
4
|
+
import { useAuth, useConfig } from "@payloadcms/ui";
|
|
5
|
+
//#region src/goals/useAnalyticsGoals.ts
|
|
6
|
+
const EMPTY = {
|
|
7
|
+
collection: null,
|
|
8
|
+
error: false,
|
|
9
|
+
goals: null
|
|
10
|
+
};
|
|
11
|
+
const FAILED = {
|
|
12
|
+
collection: null,
|
|
13
|
+
error: true,
|
|
14
|
+
goals: null
|
|
15
|
+
};
|
|
16
|
+
/**
|
|
17
|
+
* Fetches the caller-scope goal list for the admin goal picker. `goals` stays null while
|
|
18
|
+
* the fetch is in flight, when it fails, and when there is no authenticated user yet, so
|
|
19
|
+
* a picker can tell "still loading" from "this scope has no goals". Goals fetched for a
|
|
20
|
+
* previous user are never returned while a new user's fetch is pending.
|
|
21
|
+
*/
|
|
22
|
+
const useAnalyticsGoals = () => {
|
|
23
|
+
const { user } = useAuth();
|
|
24
|
+
const { config: { routes: { api }, serverURL } } = useConfig();
|
|
25
|
+
const userKey = String(user?.id ?? "");
|
|
26
|
+
const [state, setState] = useState({
|
|
27
|
+
data: EMPTY,
|
|
28
|
+
key: ""
|
|
29
|
+
});
|
|
30
|
+
useEffect(() => {
|
|
31
|
+
if (!userKey) {
|
|
32
|
+
setState({
|
|
33
|
+
data: EMPTY,
|
|
34
|
+
key: ""
|
|
35
|
+
});
|
|
36
|
+
return;
|
|
37
|
+
}
|
|
38
|
+
let cancelled = false;
|
|
39
|
+
fetchGoals(serverURL ?? "", api, userKey).then(({ collection, goals }) => {
|
|
40
|
+
if (!cancelled) setState({
|
|
41
|
+
data: {
|
|
42
|
+
collection,
|
|
43
|
+
error: false,
|
|
44
|
+
goals
|
|
45
|
+
},
|
|
46
|
+
key: userKey
|
|
47
|
+
});
|
|
48
|
+
}).catch(() => {
|
|
49
|
+
if (!cancelled) setState({
|
|
50
|
+
data: FAILED,
|
|
51
|
+
key: userKey
|
|
52
|
+
});
|
|
53
|
+
});
|
|
54
|
+
return () => {
|
|
55
|
+
cancelled = true;
|
|
56
|
+
};
|
|
57
|
+
}, [
|
|
58
|
+
api,
|
|
59
|
+
serverURL,
|
|
60
|
+
userKey
|
|
61
|
+
]);
|
|
62
|
+
return state.key === userKey ? state.data : EMPTY;
|
|
63
|
+
};
|
|
64
|
+
//#endregion
|
|
65
|
+
export { useAnalyticsGoals };
|
|
66
|
+
|
|
67
|
+
//# sourceMappingURL=useAnalyticsGoals.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"useAnalyticsGoals.js","names":[],"sources":["../../src/goals/useAnalyticsGoals.ts"],"sourcesContent":["'use client'\n\nimport { useAuth, useConfig } from '@payloadcms/ui'\nimport { useEffect, useState } from 'react'\nimport { fetchGoals, type GoalsResponse } from './fetchGoals'\n\nexport interface AnalyticsGoals {\n\t/** Null until the fetch settles, and on a failed one: not the same thing as none. */\n\tgoals: GoalsResponse['goals'] | null\n\tcollection: GoalsResponse['collection']\n\t/** The fetch settled in failure, so a picker can say so instead of claiming none exist. */\n\terror: boolean\n}\n\nconst EMPTY: AnalyticsGoals = { collection: null, error: false, goals: null }\nconst FAILED: AnalyticsGoals = { collection: null, error: true, goals: null }\n\n/**\n * Fetches the caller-scope goal list for the admin goal picker. `goals` stays null while\n * the fetch is in flight, when it fails, and when there is no authenticated user yet, so\n * a picker can tell \"still loading\" from \"this scope has no goals\". Goals fetched for a\n * previous user are never returned while a new user's fetch is pending.\n */\nexport const useAnalyticsGoals = (): AnalyticsGoals => {\n\tconst { user } = useAuth()\n\tconst {\n\t\tconfig: {\n\t\t\troutes: { api },\n\t\t\tserverURL,\n\t\t},\n\t} = useConfig()\n\tconst userKey = String(user?.id ?? '')\n\tconst [state, setState] = useState<{ key: string; data: AnalyticsGoals }>({\n\t\tdata: EMPTY,\n\t\tkey: '',\n\t})\n\n\tuseEffect(() => {\n\t\tif (!userKey) {\n\t\t\tsetState({ data: EMPTY, key: '' })\n\t\t\treturn\n\t\t}\n\t\tlet cancelled = false\n\t\tfetchGoals(serverURL ?? '', api, userKey)\n\t\t\t.then(({ collection, goals }) => {\n\t\t\t\tif (!cancelled) setState({ data: { collection, error: false, goals }, key: userKey })\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\tif (!cancelled) setState({ data: FAILED, key: userKey })\n\t\t\t})\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [api, serverURL, userKey])\n\n\treturn state.key === userKey ? state.data : EMPTY\n}\n"],"mappings":";;;;;AAcA,MAAM,QAAwB;CAAE,YAAY;CAAM,OAAO;CAAO,OAAO;AAAK;AAC5E,MAAM,SAAyB;CAAE,YAAY;CAAM,OAAO;CAAM,OAAO;AAAK;;;;;;;AAQ5E,MAAa,0BAA0C;CACtD,MAAM,EAAE,SAAS,QAAQ;CACzB,MAAM,EACL,QAAQ,EACP,QAAQ,EAAE,OACV,gBAEE,UAAU;CACd,MAAM,UAAU,OAAO,MAAM,MAAM,EAAE;CACrC,MAAM,CAAC,OAAO,YAAY,SAAgD;EACzE,MAAM;EACN,KAAK;CACN,CAAC;CAED,gBAAgB;EACf,IAAI,CAAC,SAAS;GACb,SAAS;IAAE,MAAM;IAAO,KAAK;GAAG,CAAC;GACjC;EACD;EACA,IAAI,YAAY;EAChB,WAAW,aAAa,IAAI,KAAK,OAAO,EACtC,MAAM,EAAE,YAAY,YAAY;GAChC,IAAI,CAAC,WAAW,SAAS;IAAE,MAAM;KAAE;KAAY,OAAO;KAAO;IAAM;IAAG,KAAK;GAAQ,CAAC;EACrF,CAAC,EACA,YAAY;GACZ,IAAI,CAAC,WAAW,SAAS;IAAE,MAAM;IAAQ,KAAK;GAAQ,CAAC;EACxD,CAAC;EACF,aAAa;GACZ,YAAY;EACb;CACD,GAAG;EAAC;EAAK;EAAW;CAAO,CAAC;CAE5B,OAAO,MAAM,QAAQ,UAAU,MAAM,OAAO;AAC7C"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,10 +1,21 @@
|
|
|
1
|
+
import { Goal, GoalMatch, TrackerGoal } from "./goals/types.js";
|
|
2
|
+
import { AnalyticsTrackError, ServerEventInput, ServerTrack, ServerTrackOptions } from "./core/serverEvent.js";
|
|
1
3
|
import { PLATFORM_SCOPE } from "./core/contract.js";
|
|
4
|
+
import { GoalsResponse, WireGoal } from "./goals/fetchGoals.js";
|
|
5
|
+
import { ANALYTICS_ERROR_CODES, AnalyticsError, AnalyticsErrorCode, analyticsError, readErrorCode } from "./plugin/errors.js";
|
|
6
|
+
import { QueryError, QueryErrorCode } from "./query/errors.js";
|
|
7
|
+
import { QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery } from "./query/response.js";
|
|
2
8
|
import { AnalyticsBinding, BindingContext, HostnameResolver, PathResolver } from "./binding/types.js";
|
|
3
9
|
import { TimeframePreset } from "./timeframe/presets.js";
|
|
4
|
-
import { AnalyticsFieldsOptions, AnalyticsMetricLabel, AnalyticsMetricLabels, AnalyticsStatOptions, AnalyticsStatRowOptions, AnalyticsTabOptions, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
|
|
5
10
|
import { CustomWidgetDef } from "./widgets/customWidget.js";
|
|
6
|
-
import { AnalyticsAccessOptions, AnalyticsPluginOptions, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver, TimezoneResolver } from "./core/options.js";
|
|
11
|
+
import { AnalyticsAccessOptions, AnalyticsCaptureOptions, AnalyticsGoalsCollectionOptions, AnalyticsGoalsOptions, AnalyticsPluginOptions, AnalyticsReadAccess, AnalyticsViewAccess, AnalyticsViewOptions, AutoCaptureOptions, CaptureConsentOption, ConsentMode, ConsentResolver, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver, ScopesResolver, TimezoneResolver } from "./core/options.js";
|
|
12
|
+
import { AnalyticsFieldsOptions, AnalyticsMetricLabel, AnalyticsMetricLabels, AnalyticsStatOptions, AnalyticsStatRowOptions, AnalyticsTabOptions, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
|
|
13
|
+
import { GoalFieldOptions, goalField, goalSlug } from "./goals/goalField.js";
|
|
14
|
+
import { GOAL_ACTION_TYPE, GoalActionDefinition, GoalActionRunArgs, TrackGoalActionOptions, trackGoalAction } from "./goals/trackGoalAction.js";
|
|
15
|
+
import { trackServerEvent } from "./native/ingest/serverTrack.js";
|
|
7
16
|
import { analyticsDefaultWidgets } from "./widgets/defaults.js";
|
|
17
|
+
import { WidgetFilter } from "./widgets/types.js";
|
|
18
|
+
import { widgetFilters } from "./widgets/filterField.js";
|
|
8
19
|
|
|
9
20
|
//#region src/index.d.ts
|
|
10
21
|
declare module 'payload' {
|
|
@@ -14,5 +25,5 @@ declare module 'payload' {
|
|
|
14
25
|
}
|
|
15
26
|
declare const analytics: (options: AnalyticsPluginOptions) => import("payload").Plugin;
|
|
16
27
|
//#endregion
|
|
17
|
-
export { type AnalyticsAccessOptions, type AnalyticsBinding, type AnalyticsFieldsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsTabOptions, type BindingContext, type CustomWidgetDef, type HostnameResolver, PLATFORM_SCOPE, type PathResolver, type PlatformReadAccess, type AnalyticsPluginOptions as PluginOptions, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type ScopeResolver, type TimeframePreset, type TimezoneResolver, analytics, analyticsDefaultWidgets, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField };
|
|
28
|
+
export { ANALYTICS_ERROR_CODES, type AnalyticsAccessOptions, type AnalyticsBinding, type AnalyticsCaptureOptions, type AnalyticsError, type AnalyticsErrorCode, type AnalyticsFieldsOptions, type AnalyticsGoalsCollectionOptions, type AnalyticsGoalsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsReadAccess, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsTabOptions, AnalyticsTrackError, type AnalyticsViewAccess, type AnalyticsViewOptions, type AutoCaptureOptions, type BindingContext, type CaptureConsentOption, type ConsentMode, type ConsentResolver, type CustomWidgetDef, GOAL_ACTION_TYPE, type Goal, type GoalActionDefinition, type GoalActionRunArgs, type GoalFieldOptions, type GoalMatch, type GoalsResponse, type HostnameResolver, PLATFORM_SCOPE, type PathResolver, type PlatformReadAccess, type AnalyticsPluginOptions as PluginOptions, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type QueryError, type QueryErrorCode, type QueryErrorResponse, type QueryResponse, type QuerySourceRef, type ScopeResolver, type ScopesResolver, type SerializedAnalyticsQuery, type ServerEventInput, type ServerTrack, type ServerTrackOptions, type TimeframePreset, type TimezoneResolver, type TrackGoalActionOptions, type TrackerGoal, type WidgetFilter, type WireGoal, analytics, analyticsDefaultWidgets, analyticsError, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, goalField, goalSlug, readErrorCode, trackGoalAction, trackServerEvent, widgetFilters };
|
|
18
29
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.js
CHANGED
|
@@ -1,31 +1,66 @@
|
|
|
1
|
+
import { DOCUMENT_PATH, GOALS_PATH, QUERY_PATH, REALTIME_PATH, REFRESH_PATH, SOURCES_PATH } from "./plugin/paths.js";
|
|
2
|
+
import { PLATFORM_SCOPE } from "./core/contract.js";
|
|
3
|
+
import { createEpochStore } from "./surfacing/epoch.js";
|
|
4
|
+
import { isValidTimeZone } from "./timeframe/tz.js";
|
|
5
|
+
import { setRuntime } from "./plugin/runtime.js";
|
|
6
|
+
import { proxyEndpoints } from "./capture/proxyEndpoint.js";
|
|
7
|
+
import { configGoalsResolver, createGoalsResolver } from "./goals/resolver.js";
|
|
8
|
+
import { buildGoalsCollection } from "./goals/collection.js";
|
|
1
9
|
import { buildProvidersCollection } from "./providers/collection.js";
|
|
2
10
|
import { resolveOptions } from "./core/options.js";
|
|
11
|
+
import { trackerEndpoint } from "./capture/trackerEndpoint.js";
|
|
3
12
|
import { createRegistry, staticRegistryResolver } from "./core/registry.js";
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
13
|
+
import { ANALYTICS_ERROR_CODES, analyticsError, readErrorCode } from "./plugin/errors.js";
|
|
14
|
+
import { makeGoalsHandler } from "./goals/goalsEndpoint.js";
|
|
15
|
+
import { AnalyticsTrackError } from "./core/serverEvent.js";
|
|
16
|
+
import { trackServerEvent } from "./native/ingest/serverTrack.js";
|
|
8
17
|
import { makeDocumentHandler } from "./plugin/documentEndpoint.js";
|
|
9
18
|
import { isModuleNotFoundError } from "./plugin/peerImportError.js";
|
|
19
|
+
import { makeQueryHandler } from "./plugin/queryEndpoint.js";
|
|
10
20
|
import { kvCacheStore } from "./surfacing/cacheStore.js";
|
|
11
21
|
import { makeRealtimeHandler } from "./plugin/realtimeEndpoint.js";
|
|
22
|
+
import { makeRefreshHandler } from "./plugin/refreshEndpoint.js";
|
|
12
23
|
import { registerTranslations } from "./plugin/registerTranslations.js";
|
|
24
|
+
import { validateScopeField } from "./plugin/scopeFieldBoot.js";
|
|
13
25
|
import { makeSourcesHandler } from "./plugin/sourcesEndpoint.js";
|
|
14
26
|
import { warmTask } from "./plugin/warmTask.js";
|
|
15
27
|
import { collectionProvidersSource, combineRegistries, createScopedRegistryResolver } from "./providers/resolver.js";
|
|
16
28
|
import { createEngine } from "./surfacing/engine.js";
|
|
17
29
|
import { syncCollection } from "./sync/collection.js";
|
|
18
30
|
import { syncTask } from "./sync/syncTask.js";
|
|
31
|
+
import { registerView } from "./view/registerView.js";
|
|
32
|
+
import { widgetFilters } from "./widgets/filterField.js";
|
|
19
33
|
import { registerWidgets } from "./widgets/registerWidgets.js";
|
|
20
34
|
import { analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
|
|
35
|
+
import { goalField, goalSlug } from "./goals/goalField.js";
|
|
36
|
+
import { GOAL_ACTION_TYPE, trackGoalAction } from "./goals/trackGoalAction.js";
|
|
21
37
|
import { analyticsDefaultWidgets } from "./widgets/defaults.js";
|
|
22
38
|
import { definePlugin } from "payload";
|
|
23
39
|
//#region src/index.ts
|
|
40
|
+
/** How long a collection write waits on its cache epoch bumps, however many scopes they cover. */
|
|
41
|
+
const EPOCH_BUMP_DEADLINE_MS = 2e3;
|
|
42
|
+
/**
|
|
43
|
+
* Settles with `work`, or rejects once `ms` has passed. A KV that hangs rather than failing
|
|
44
|
+
* would otherwise hold an editor's save open for as long as it hangs; the race keeps a
|
|
45
|
+
* handler on `work`, so a rejection arriving after the deadline stays handled.
|
|
46
|
+
*/
|
|
47
|
+
const withDeadline = async (work, ms) => {
|
|
48
|
+
let timer;
|
|
49
|
+
const deadline = new Promise((_resolve, reject) => {
|
|
50
|
+
timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`timed out after ${ms}ms`)), ms);
|
|
51
|
+
});
|
|
52
|
+
try {
|
|
53
|
+
await Promise.race([work, deadline]);
|
|
54
|
+
} finally {
|
|
55
|
+
clearTimeout(timer);
|
|
56
|
+
}
|
|
57
|
+
};
|
|
24
58
|
const analytics = definePlugin({
|
|
25
59
|
slug: "@10x-media/analytics",
|
|
26
60
|
plugin: async ({ config, plugins: _plugins, ...options }) => {
|
|
27
61
|
if (options.disabled === true) return config;
|
|
28
62
|
const resolved = resolveOptions(options);
|
|
63
|
+
const providersEnabled = resolved.providers.collection.enabled || Boolean(resolved.providers.resolve);
|
|
29
64
|
const defaultLayout = config.admin?.dashboard?.defaultLayout;
|
|
30
65
|
registerTranslations(config, options.translations);
|
|
31
66
|
const registry = createRegistry(resolved.adapters, resolved.defaultAdapter);
|
|
@@ -35,6 +70,14 @@ const analytics = definePlugin({
|
|
|
35
70
|
};
|
|
36
71
|
let resolveRegistry = staticRegistryResolver(registry);
|
|
37
72
|
let invalidateProviders = () => {};
|
|
73
|
+
/**
|
|
74
|
+
* Retires the cached reads of every scope a collection write touched. Bound at init,
|
|
75
|
+
* where the epoch store exists; goals defined in plugin config cannot change at
|
|
76
|
+
* runtime, so only the collections ever bump. A bump that fails or outlives its
|
|
77
|
+
* deadline is logged and swallowed: an unreachable token store must never fail or
|
|
78
|
+
* stall an editor's save.
|
|
79
|
+
*/
|
|
80
|
+
let bumpScopes = async () => {};
|
|
38
81
|
const providersResolve = resolved.providers.resolve;
|
|
39
82
|
if (providersResolve) resolveRegistry = async (args) => combineRegistries(registryBase, await providersResolve({
|
|
40
83
|
payload: args.payload,
|
|
@@ -66,7 +109,10 @@ const analytics = definePlugin({
|
|
|
66
109
|
slug: resolved.providers.collection.slug,
|
|
67
110
|
access: resolved.providers.collection.access,
|
|
68
111
|
overrides: resolved.providers.collection.overrides,
|
|
69
|
-
onChange: () =>
|
|
112
|
+
onChange: (change) => {
|
|
113
|
+
invalidateProviders();
|
|
114
|
+
return bumpScopes(change);
|
|
115
|
+
},
|
|
70
116
|
scoped: resolved.scoped,
|
|
71
117
|
scopeField: resolved.providers.collection.scopeField,
|
|
72
118
|
resolveScope,
|
|
@@ -75,6 +121,25 @@ const analytics = definePlugin({
|
|
|
75
121
|
});
|
|
76
122
|
config.collections = [...config.collections ?? [], withEncryptedQueryRewrite(providersCollection)];
|
|
77
123
|
}
|
|
124
|
+
const goalsResolver = resolved.goalsCollection.enabled ? createGoalsResolver({
|
|
125
|
+
slug: resolved.goalsCollection.slug,
|
|
126
|
+
scopeField: resolved.goalsCollection.scopeField,
|
|
127
|
+
scoped: resolved.scoped,
|
|
128
|
+
config: resolved.goals
|
|
129
|
+
}) : configGoalsResolver(resolved.goals);
|
|
130
|
+
if (resolved.goalsCollection.enabled) config.collections = [...config.collections ?? [], buildGoalsCollection({
|
|
131
|
+
slug: resolved.goalsCollection.slug,
|
|
132
|
+
access: resolved.goalsCollection.access,
|
|
133
|
+
overrides: resolved.goalsCollection.overrides,
|
|
134
|
+
onChange: (change) => {
|
|
135
|
+
goalsResolver.invalidate();
|
|
136
|
+
return bumpScopes(change);
|
|
137
|
+
},
|
|
138
|
+
scoped: resolved.scoped,
|
|
139
|
+
scopeField: resolved.goalsCollection.scopeField,
|
|
140
|
+
resolveScope,
|
|
141
|
+
platformRead: resolved.access.platformRead
|
|
142
|
+
})];
|
|
78
143
|
const resolveTimezone = async (req, scope) => {
|
|
79
144
|
const opt = resolved.reportingTimezone;
|
|
80
145
|
if (opt === void 0) return "UTC";
|
|
@@ -92,9 +157,11 @@ const analytics = definePlugin({
|
|
|
92
157
|
for (const adapter of resolved.adapters) adapter.register?.(config, {
|
|
93
158
|
scoped: resolved.scoped,
|
|
94
159
|
resolveScope,
|
|
95
|
-
resolveTimezone
|
|
160
|
+
resolveTimezone,
|
|
161
|
+
resolveGoals: goalsResolver.resolve,
|
|
162
|
+
trustedProxyHops: resolved.trustedProxyHops
|
|
96
163
|
});
|
|
97
|
-
if (resolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === "function")) config.endpoints = [...config.endpoints ?? [], {
|
|
164
|
+
if (resolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === "function") || providersEnabled) config.endpoints = [...config.endpoints ?? [], {
|
|
98
165
|
method: "get",
|
|
99
166
|
path: REALTIME_PATH,
|
|
100
167
|
handler: makeRealtimeHandler()
|
|
@@ -104,48 +171,121 @@ const analytics = definePlugin({
|
|
|
104
171
|
path: DOCUMENT_PATH,
|
|
105
172
|
handler: makeDocumentHandler()
|
|
106
173
|
}];
|
|
107
|
-
config.endpoints = [
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
174
|
+
config.endpoints = [
|
|
175
|
+
...config.endpoints ?? [],
|
|
176
|
+
{
|
|
177
|
+
method: "get",
|
|
178
|
+
path: SOURCES_PATH,
|
|
179
|
+
handler: makeSourcesHandler()
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
method: "get",
|
|
183
|
+
path: GOALS_PATH,
|
|
184
|
+
handler: makeGoalsHandler()
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
method: "get",
|
|
188
|
+
path: QUERY_PATH,
|
|
189
|
+
handler: makeQueryHandler()
|
|
190
|
+
},
|
|
191
|
+
{
|
|
192
|
+
method: "post",
|
|
193
|
+
path: REFRESH_PATH,
|
|
194
|
+
handler: makeRefreshHandler()
|
|
195
|
+
}
|
|
196
|
+
];
|
|
197
|
+
if (resolved.adapters.some((a) => a.capture) || providersEnabled) config.endpoints = [
|
|
198
|
+
...config.endpoints,
|
|
199
|
+
...proxyEndpoints(),
|
|
200
|
+
trackerEndpoint()
|
|
201
|
+
];
|
|
112
202
|
if (resolved.widgets.enabled) {
|
|
113
|
-
const multiProvider = registry.isMultiProvider() ||
|
|
203
|
+
const multiProvider = registry.isMultiProvider() || providersEnabled;
|
|
114
204
|
registerWidgets(config, {
|
|
115
205
|
adapters: resolved.adapters,
|
|
116
206
|
multiProvider,
|
|
207
|
+
providersEnabled,
|
|
117
208
|
disabled: resolved.widgets.disabled,
|
|
118
209
|
register: resolved.widgets.register,
|
|
119
210
|
localizeText: resolved.widgets.localizeText,
|
|
120
|
-
defaultId: resolved.defaultAdapter
|
|
211
|
+
defaultId: resolved.defaultAdapter,
|
|
212
|
+
comparison: resolved.widgets.comparison,
|
|
213
|
+
view: resolved.view === false ? false : {
|
|
214
|
+
path: resolved.view.path,
|
|
215
|
+
defaultRange: resolved.view.defaultRange,
|
|
216
|
+
defaultMetric: resolved.view.defaultMetric
|
|
217
|
+
}
|
|
121
218
|
});
|
|
122
219
|
}
|
|
220
|
+
registerView(config, {
|
|
221
|
+
view: resolved.view,
|
|
222
|
+
pluginOptions: options
|
|
223
|
+
});
|
|
123
224
|
if (resolved.cache.warm.enabled) config.jobs = {
|
|
124
225
|
...config.jobs,
|
|
125
|
-
tasks: [...config.jobs?.tasks ?? [], warmTask(resolved.cache.warm.cron, defaultLayout)]
|
|
226
|
+
tasks: [...config.jobs?.tasks ?? [], warmTask(resolved.cache.warm.cron, defaultLayout, resolved.scopes)]
|
|
126
227
|
};
|
|
127
228
|
if (resolved.sync.enabled) {
|
|
128
|
-
config.collections = [...config.collections ?? [], syncCollection(resolved.sync.collectionSlug, resolved.sync.hidden
|
|
229
|
+
config.collections = [...config.collections ?? [], syncCollection(resolved.sync.collectionSlug, resolved.sync.hidden, {
|
|
230
|
+
scoped: resolved.scoped,
|
|
231
|
+
scopeField: "scope",
|
|
232
|
+
resolveScope,
|
|
233
|
+
platformRead: resolved.access.platformRead
|
|
234
|
+
})];
|
|
129
235
|
config.jobs = {
|
|
130
236
|
...config.jobs,
|
|
131
237
|
tasks: [...config.jobs?.tasks ?? [], syncTask({
|
|
132
238
|
cron: resolved.sync.cron,
|
|
133
239
|
lookbackDays: resolved.sync.lookbackDays,
|
|
134
240
|
collectionSlug: resolved.sync.collectionSlug,
|
|
135
|
-
adapterIds: resolved.sync.adapters
|
|
241
|
+
adapterIds: resolved.sync.adapters,
|
|
242
|
+
scopes: resolved.scopes
|
|
136
243
|
})]
|
|
137
244
|
};
|
|
138
245
|
}
|
|
139
246
|
const prevOnInit = config.onInit;
|
|
140
247
|
config.onInit = async (payload) => {
|
|
248
|
+
if (resolved.scoped && resolved.goalsCollection.enabled) validateScopeField(payload, {
|
|
249
|
+
option: "goals.collection.scopeField",
|
|
250
|
+
slug: resolved.goalsCollection.slug,
|
|
251
|
+
scopeField: resolved.goalsCollection.scopeField
|
|
252
|
+
});
|
|
253
|
+
if (resolved.scoped && resolved.providers.collection.enabled) validateScopeField(payload, {
|
|
254
|
+
option: "providers.collection.scopeField",
|
|
255
|
+
slug: resolved.providers.collection.slug,
|
|
256
|
+
scopeField: resolved.providers.collection.scopeField
|
|
257
|
+
});
|
|
141
258
|
if (resolved.providers.collection.enabled) {
|
|
142
259
|
const { validateEncryptedBoot } = await import("@10x-media/fields/encrypted");
|
|
143
260
|
await validateEncryptedBoot(payload, resolved.providers.collection.encryption?.keys);
|
|
144
261
|
}
|
|
262
|
+
const epoch = createEpochStore(payload);
|
|
263
|
+
bumpScopes = async (change) => {
|
|
264
|
+
const scopes = new Set([change.scope]);
|
|
265
|
+
if (change.previousScope !== void 0) scopes.add(change.previousScope);
|
|
266
|
+
const bumps = [...scopes].map(async (scope) => {
|
|
267
|
+
try {
|
|
268
|
+
await epoch.bump(scope);
|
|
269
|
+
} catch (err) {
|
|
270
|
+
payload.logger?.warn(`analytics: cache epoch bump failed for scope "${scope ?? "global"}", cached reads stay until their ttl: ${String(err)}`);
|
|
271
|
+
}
|
|
272
|
+
});
|
|
273
|
+
try {
|
|
274
|
+
await withDeadline(Promise.allSettled(bumps), EPOCH_BUMP_DEADLINE_MS);
|
|
275
|
+
} catch (err) {
|
|
276
|
+
const named = [...scopes].map((scope) => `"${scope ?? "global"}"`).join(", ");
|
|
277
|
+
payload.logger?.warn(`analytics: cache epoch bump did not settle for ${named}, cached reads stay until their ttl: ${String(err)}`);
|
|
278
|
+
}
|
|
279
|
+
};
|
|
145
280
|
const engine = createEngine({
|
|
146
281
|
store: kvCacheStore(payload.kv),
|
|
147
282
|
queue: { concurrency: 4 },
|
|
148
|
-
ttl: resolved.cache.ttl
|
|
283
|
+
ttl: resolved.cache.ttl,
|
|
284
|
+
timeoutMs: resolved.cache.timeoutMs,
|
|
285
|
+
epoch,
|
|
286
|
+
onError: (err, adapterId) => {
|
|
287
|
+
payload.logger?.warn(`analytics: read failed for adapter "${adapterId}": ${String(err)}`);
|
|
288
|
+
}
|
|
149
289
|
});
|
|
150
290
|
setRuntime(payload, {
|
|
151
291
|
registry,
|
|
@@ -153,10 +293,25 @@ const analytics = definePlugin({
|
|
|
153
293
|
resolveScope,
|
|
154
294
|
resolveTimezone,
|
|
155
295
|
platformAdapterId: resolved.platformAdapter,
|
|
296
|
+
captureSlots: resolved.capture.slots,
|
|
297
|
+
capturePaths: resolved.capture.paths,
|
|
298
|
+
captureProxy: resolved.capture.proxy,
|
|
299
|
+
trustedProxyHops: resolved.trustedProxyHops,
|
|
300
|
+
consentFor: resolved.capture.consent,
|
|
301
|
+
autoCapture: resolved.capture.autoCapture,
|
|
302
|
+
goals: resolved.goals,
|
|
303
|
+
resolveGoals: goalsResolver.resolve,
|
|
304
|
+
resolveGoalsDetailed: goalsResolver.resolveDetailed,
|
|
305
|
+
...resolved.goalsCollection.enabled ? { goalsCollectionSlug: resolved.goalsCollection.slug } : {},
|
|
306
|
+
ingestPath: resolved.adapters.find((a) => a.ingest)?.ingest?.path,
|
|
307
|
+
track: (event, opts) => trackServerEvent(payload, event, opts),
|
|
308
|
+
scoped: resolved.scoped,
|
|
156
309
|
configAdapterIds: new Set(resolved.adapters.map((a) => a.id)),
|
|
157
310
|
platformRead: resolved.access.platformRead,
|
|
311
|
+
readAccess: resolved.access.read,
|
|
158
312
|
bindings: resolved.bindings,
|
|
159
313
|
engine,
|
|
314
|
+
epoch,
|
|
160
315
|
ttl: resolved.cache.ttl,
|
|
161
316
|
comparison: resolved.widgets.comparison
|
|
162
317
|
});
|
|
@@ -166,6 +321,6 @@ const analytics = definePlugin({
|
|
|
166
321
|
}
|
|
167
322
|
});
|
|
168
323
|
//#endregion
|
|
169
|
-
export { PLATFORM_SCOPE, analytics, analyticsDefaultWidgets, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField };
|
|
324
|
+
export { ANALYTICS_ERROR_CODES, AnalyticsTrackError, GOAL_ACTION_TYPE, PLATFORM_SCOPE, analytics, analyticsDefaultWidgets, analyticsError, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, goalField, goalSlug, readErrorCode, trackGoalAction, trackServerEvent, widgetFilters };
|
|
170
325
|
|
|
171
326
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type Config, definePlugin, type PayloadRequest } from 'payload'\n\nimport { type AnalyticsPluginOptions, resolveOptions } from './core/options'\nimport { createRegistry, staticRegistryResolver } from './core/registry'\nimport { DOCUMENT_PATH, makeDocumentHandler } from './plugin/documentEndpoint'\nimport { isModuleNotFoundError } from './plugin/peerImportError'\nimport { makeRealtimeHandler, REALTIME_PATH } from './plugin/realtimeEndpoint'\nimport { registerTranslations } from './plugin/registerTranslations'\nimport { setRuntime } from './plugin/runtime'\nimport { makeSourcesHandler, SOURCES_PATH } from './plugin/sourcesEndpoint'\nimport { warmTask } from './plugin/warmTask'\nimport type { BuildSecretField } from './providers/collection'\nimport { buildProvidersCollection } from './providers/collection'\nimport {\n\tcollectionProvidersSource,\n\tcombineRegistries,\n\tcreateScopedRegistryResolver,\n} from './providers/resolver'\nimport { kvCacheStore } from './surfacing/cacheStore'\nimport { createEngine } from './surfacing/engine'\nimport { syncCollection } from './sync/collection'\nimport { syncTask } from './sync/syncTask'\nimport { DEFAULT_TIMEZONE, isValidTimeZone } from './timeframe/tz'\nimport { registerWidgets } from './widgets/registerWidgets'\n\ndeclare module 'payload' {\n\tinterface RegisteredPlugins {\n\t\t'@10x-media/analytics': AnalyticsPluginOptions\n\t}\n}\n\nexport const analytics = definePlugin<AnalyticsPluginOptions>({\n\tslug: '@10x-media/analytics',\n\tplugin: async ({ config, plugins: _plugins, ...options }): Promise<Config> => {\n\t\tif (options.disabled === true) {\n\t\t\treturn config\n\t\t}\n\t\tconst resolved = resolveOptions(options)\n\t\tconst defaultLayout = config.admin?.dashboard?.defaultLayout\n\t\tregisterTranslations(config, options.translations)\n\t\tconst registry = createRegistry(resolved.adapters, resolved.defaultAdapter)\n\t\tconst registryBase = { adapters: resolved.adapters, defaultId: resolved.defaultAdapter }\n\t\tlet resolveRegistry = staticRegistryResolver(registry)\n\t\tlet invalidateProviders = () => {}\n\t\tconst providersResolve = resolved.providers.resolve\n\t\tif (providersResolve) {\n\t\t\tresolveRegistry = async (args) =>\n\t\t\t\tcombineRegistries(\n\t\t\t\t\tregistryBase,\n\t\t\t\t\tawait providersResolve({ payload: args.payload, req: args.req, scope: args.scope })\n\t\t\t\t)\n\t\t} else if (resolved.providers.collection.enabled) {\n\t\t\tconst scoped = createScopedRegistryResolver({\n\t\t\t\tbase: registryBase,\n\t\t\t\tsource: collectionProvidersSource(\n\t\t\t\t\tresolved.providers.collection.slug,\n\t\t\t\t\tresolved.providers.collection.scopeField\n\t\t\t\t),\n\t\t\t})\n\t\t\tresolveRegistry = scoped.resolver\n\t\t\tinvalidateProviders = scoped.invalidate\n\t\t}\n\t\tconst resolveScope = async (req: PayloadRequest) => resolved.scopeResolver({ req })\n\t\tif (resolved.providers.collection.enabled) {\n\t\t\tconst { encryptedField, withEncryptedQueryRewrite } = await import(\n\t\t\t\t'@10x-media/fields/encrypted'\n\t\t\t).catch((err: unknown) => {\n\t\t\t\tif (isModuleNotFoundError(err)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t'analytics: providers.collection requires @10x-media/fields (peer). Install it: pnpm add @10x-media/fields'\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t\tthrow err\n\t\t\t})\n\t\t\tconst encryption = resolved.providers.collection.encryption\n\t\t\tconst buildSecret: BuildSecretField = (source) =>\n\t\t\t\tencryptedField(source, {\n\t\t\t\t\tprotection: 'writeOnly',\n\t\t\t\t\taadScope: '10x-analytics:providers',\n\t\t\t\t\t...(source.type === 'text' ? { hint: { suffix: 4 } } : {}),\n\t\t\t\t\t...(encryption?.keys ? { keys: encryption.keys } : {}),\n\t\t\t\t})\n\t\t\tconst providersCollection = buildProvidersCollection({\n\t\t\t\tslug: resolved.providers.collection.slug,\n\t\t\t\taccess: resolved.providers.collection.access,\n\t\t\t\toverrides: resolved.providers.collection.overrides,\n\t\t\t\tonChange: () => invalidateProviders(),\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tscopeField: resolved.providers.collection.scopeField,\n\t\t\t\tresolveScope,\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\tbuildSecret,\n\t\t\t})\n\t\t\t// Always wrap, even though a consumer's own @10x-media/fields plugin (if\n\t\t\t// registered) may wrap this collection again later: double application is\n\t\t\t// inert here (writeOnly forbids queryable, so there are no blind-index\n\t\t\t// markers to rewrite and the response strip is an idempotent delete),\n\t\t\t// while skipping would leak ciphertext whenever fields() runs before this\n\t\t\t// collection exists (e.g. an earlier plugin `order`).\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\twithEncryptedQueryRewrite(providersCollection),\n\t\t\t]\n\t\t}\n\t\tconst resolveTimezone = async (req: PayloadRequest, scope?: string | null): Promise<string> => {\n\t\t\tconst opt = resolved.reportingTimezone\n\t\t\tif (opt === undefined) {\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst tz =\n\t\t\t\t\ttypeof opt === 'string'\n\t\t\t\t\t\t? opt\n\t\t\t\t\t\t: await opt({ req, scope: scope !== undefined ? scope : await resolveScope(req) })\n\t\t\t\treturn tz && isValidTimeZone(tz) ? tz : DEFAULT_TIMEZONE\n\t\t\t} catch (err) {\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: reportingTimezone resolution failed, falling back to UTC: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t}\n\t\tfor (const adapter of resolved.adapters) {\n\t\t\tadapter.register?.(config, { scoped: resolved.scoped, resolveScope, resolveTimezone })\n\t\t}\n\t\tif (\n\t\t\tresolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === 'function')\n\t\t) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: REALTIME_PATH, handler: makeRealtimeHandler() },\n\t\t\t]\n\t\t}\n\t\tif (Object.keys(resolved.bindings).length > 0) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: DOCUMENT_PATH, handler: makeDocumentHandler() },\n\t\t\t]\n\t\t}\n\t\tconfig.endpoints = [\n\t\t\t...(config.endpoints ?? []),\n\t\t\t{ method: 'get', path: SOURCES_PATH, handler: makeSourcesHandler() },\n\t\t]\n\t\tif (resolved.widgets.enabled) {\n\t\t\tconst multiProvider =\n\t\t\t\tregistry.isMultiProvider() ||\n\t\t\t\tresolved.providers.collection.enabled ||\n\t\t\t\tBoolean(resolved.providers.resolve)\n\t\t\tregisterWidgets(config, {\n\t\t\t\tadapters: resolved.adapters,\n\t\t\t\tmultiProvider,\n\t\t\t\tdisabled: resolved.widgets.disabled,\n\t\t\t\tregister: resolved.widgets.register,\n\t\t\t\tlocalizeText: resolved.widgets.localizeText,\n\t\t\t\tdefaultId: resolved.defaultAdapter,\n\t\t\t})\n\t\t}\n\t\tif (resolved.cache.warm.enabled) {\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [...(config.jobs?.tasks ?? []), warmTask(resolved.cache.warm.cron, defaultLayout)],\n\t\t\t}\n\t\t}\n\t\tif (resolved.sync.enabled) {\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\tsyncCollection(resolved.sync.collectionSlug, resolved.sync.hidden),\n\t\t\t]\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [\n\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\tsyncTask({\n\t\t\t\t\t\tcron: resolved.sync.cron,\n\t\t\t\t\t\tlookbackDays: resolved.sync.lookbackDays,\n\t\t\t\t\t\tcollectionSlug: resolved.sync.collectionSlug,\n\t\t\t\t\t\tadapterIds: resolved.sync.adapters,\n\t\t\t\t\t}),\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t\tconst prevOnInit = config.onInit\n\t\t// The runtime is installed before the app's own onInit runs so consumer init code\n\t\t// (seeding, cache warming, sync passes) can already read through the plugin.\n\t\tconfig.onInit = async (payload) => {\n\t\t\tif (resolved.providers.collection.enabled) {\n\t\t\t\tconst { validateEncryptedBoot } = await import('@10x-media/fields/encrypted')\n\t\t\t\tawait validateEncryptedBoot(payload, resolved.providers.collection.encryption?.keys)\n\t\t\t}\n\t\t\tconst engine = createEngine({\n\t\t\t\tstore: kvCacheStore(payload.kv),\n\t\t\t\tqueue: { concurrency: 4 },\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t})\n\t\t\tsetRuntime(payload, {\n\t\t\t\tregistry,\n\t\t\t\tresolveRegistry,\n\t\t\t\tresolveScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tplatformAdapterId: resolved.platformAdapter,\n\t\t\t\tconfigAdapterIds: new Set(resolved.adapters.map((a) => a.id)),\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\tbindings: resolved.bindings,\n\t\t\t\tengine,\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t\tcomparison: resolved.widgets.comparison,\n\t\t\t})\n\t\t\tawait prevOnInit?.(payload)\n\t\t}\n\t\treturn config\n\t},\n})\n\nexport type {\n\tAnalyticsBinding,\n\tBindingContext,\n\tHostnameResolver,\n\tPathResolver,\n} from './binding/types'\nexport { PLATFORM_SCOPE } from './core/contract'\nexport type {\n\tAnalyticsAccessOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsPluginOptions as PluginOptions,\n\tPlatformReadAccess,\n\tProvidersCollectionOptions,\n\tProvidersOptions,\n\tProvidersResolve,\n\tScopeResolver,\n\tTimezoneResolver,\n} from './core/options'\nexport type {\n\tAnalyticsFieldsOptions,\n\tAnalyticsMetricLabel,\n\tAnalyticsMetricLabels,\n\tAnalyticsStatOptions,\n\tAnalyticsStatRowOptions,\n\tAnalyticsTabOptions,\n} from './fields/factories'\nexport {\n\tanalyticsFields,\n\tanalyticsStat,\n\tanalyticsStatRow,\n\tanalyticsTab,\n\tanalyticsTabsField,\n} from './fields/factories'\nexport type { TimeframePreset } from './timeframe/presets'\nexport type { CustomWidgetDef } from './widgets/customWidget'\nexport { analyticsDefaultWidgets } from './widgets/defaults'\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type Config, definePlugin, type PayloadRequest } from 'payload'\n\nimport { proxyEndpoints } from './capture/proxyEndpoint'\nimport { trackerEndpoint } from './capture/trackerEndpoint'\nimport { type AnalyticsPluginOptions, resolveOptions } from './core/options'\nimport { createRegistry, staticRegistryResolver } from './core/registry'\nimport { buildGoalsCollection } from './goals/collection'\nimport { GOALS_PATH, makeGoalsHandler } from './goals/goalsEndpoint'\nimport { configGoalsResolver, createGoalsResolver } from './goals/resolver'\nimport { trackServerEvent } from './native/ingest/serverTrack'\nimport { DOCUMENT_PATH, makeDocumentHandler } from './plugin/documentEndpoint'\nimport { isModuleNotFoundError } from './plugin/peerImportError'\nimport { makeQueryHandler, QUERY_PATH } from './plugin/queryEndpoint'\nimport { makeRealtimeHandler, REALTIME_PATH } from './plugin/realtimeEndpoint'\nimport { makeRefreshHandler, REFRESH_PATH } from './plugin/refreshEndpoint'\nimport { registerTranslations } from './plugin/registerTranslations'\nimport { setRuntime } from './plugin/runtime'\nimport type { ScopeChange } from './plugin/scopeChange'\nimport { validateScopeField } from './plugin/scopeFieldBoot'\nimport { makeSourcesHandler, SOURCES_PATH } from './plugin/sourcesEndpoint'\nimport { warmTask } from './plugin/warmTask'\nimport type { BuildSecretField } from './providers/collection'\nimport { buildProvidersCollection } from './providers/collection'\nimport {\n\tcollectionProvidersSource,\n\tcombineRegistries,\n\tcreateScopedRegistryResolver,\n} from './providers/resolver'\nimport { kvCacheStore } from './surfacing/cacheStore'\nimport { createEngine } from './surfacing/engine'\nimport { createEpochStore } from './surfacing/epoch'\nimport { syncCollection } from './sync/collection'\nimport { syncTask } from './sync/syncTask'\nimport { DEFAULT_TIMEZONE, isValidTimeZone } from './timeframe/tz'\nimport { registerView } from './view/registerView'\nimport { registerWidgets } from './widgets/registerWidgets'\n\ndeclare module 'payload' {\n\tinterface RegisteredPlugins {\n\t\t'@10x-media/analytics': AnalyticsPluginOptions\n\t}\n}\n\n/** How long a collection write waits on its cache epoch bumps, however many scopes they cover. */\nconst EPOCH_BUMP_DEADLINE_MS = 2_000\n\n/**\n * Settles with `work`, or rejects once `ms` has passed. A KV that hangs rather than failing\n * would otherwise hold an editor's save open for as long as it hangs; the race keeps a\n * handler on `work`, so a rejection arriving after the deadline stays handled.\n */\nconst withDeadline = async (work: Promise<unknown>, ms: number): Promise<void> => {\n\tlet timer: ReturnType<typeof setTimeout> | undefined\n\tconst deadline = new Promise<never>((_resolve, reject) => {\n\t\ttimer = setTimeout(() => reject(new Error(`timed out after ${ms}ms`)), ms)\n\t})\n\ttry {\n\t\tawait Promise.race([work, deadline])\n\t} finally {\n\t\tclearTimeout(timer)\n\t}\n}\n\nexport const analytics = definePlugin<AnalyticsPluginOptions>({\n\tslug: '@10x-media/analytics',\n\tplugin: async ({ config, plugins: _plugins, ...options }): Promise<Config> => {\n\t\tif (options.disabled === true) {\n\t\t\treturn config\n\t\t}\n\t\tconst resolved = resolveOptions(options)\n\t\t// A tenant's own runtime adapter (providers.collection or providers.resolve) has\n\t\t// capabilities unknown at config time, so it opens the widget/endpoint gates that\n\t\t// otherwise key off the config-adapter capability union.\n\t\tconst providersEnabled =\n\t\t\tresolved.providers.collection.enabled || Boolean(resolved.providers.resolve)\n\t\tconst defaultLayout = config.admin?.dashboard?.defaultLayout\n\t\tregisterTranslations(config, options.translations)\n\t\tconst registry = createRegistry(resolved.adapters, resolved.defaultAdapter)\n\t\tconst registryBase = { adapters: resolved.adapters, defaultId: resolved.defaultAdapter }\n\t\tlet resolveRegistry = staticRegistryResolver(registry)\n\t\tlet invalidateProviders = () => {}\n\t\t/**\n\t\t * Retires the cached reads of every scope a collection write touched. Bound at init,\n\t\t * where the epoch store exists; goals defined in plugin config cannot change at\n\t\t * runtime, so only the collections ever bump. A bump that fails or outlives its\n\t\t * deadline is logged and swallowed: an unreachable token store must never fail or\n\t\t * stall an editor's save.\n\t\t */\n\t\tlet bumpScopes: (change: ScopeChange) => Promise<void> = async () => {}\n\t\tconst providersResolve = resolved.providers.resolve\n\t\tif (providersResolve) {\n\t\t\tresolveRegistry = async (args) =>\n\t\t\t\tcombineRegistries(\n\t\t\t\t\tregistryBase,\n\t\t\t\t\tawait providersResolve({ payload: args.payload, req: args.req, scope: args.scope })\n\t\t\t\t)\n\t\t} else if (resolved.providers.collection.enabled) {\n\t\t\tconst scoped = createScopedRegistryResolver({\n\t\t\t\tbase: registryBase,\n\t\t\t\tsource: collectionProvidersSource(\n\t\t\t\t\tresolved.providers.collection.slug,\n\t\t\t\t\tresolved.providers.collection.scopeField\n\t\t\t\t),\n\t\t\t})\n\t\t\tresolveRegistry = scoped.resolver\n\t\t\tinvalidateProviders = scoped.invalidate\n\t\t}\n\t\tconst resolveScope = async (req: PayloadRequest) => resolved.scopeResolver({ req })\n\t\tif (resolved.providers.collection.enabled) {\n\t\t\tconst { encryptedField, withEncryptedQueryRewrite } = await import(\n\t\t\t\t'@10x-media/fields/encrypted'\n\t\t\t).catch((err: unknown) => {\n\t\t\t\tif (isModuleNotFoundError(err)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t'analytics: providers.collection requires @10x-media/fields (peer). Install it: pnpm add @10x-media/fields'\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t\tthrow err\n\t\t\t})\n\t\t\tconst encryption = resolved.providers.collection.encryption\n\t\t\tconst buildSecret: BuildSecretField = (source) =>\n\t\t\t\tencryptedField(source, {\n\t\t\t\t\tprotection: 'writeOnly',\n\t\t\t\t\taadScope: '10x-analytics:providers',\n\t\t\t\t\t...(source.type === 'text' ? { hint: { suffix: 4 } } : {}),\n\t\t\t\t\t...(encryption?.keys ? { keys: encryption.keys } : {}),\n\t\t\t\t})\n\t\t\tconst providersCollection = buildProvidersCollection({\n\t\t\t\tslug: resolved.providers.collection.slug,\n\t\t\t\taccess: resolved.providers.collection.access,\n\t\t\t\toverrides: resolved.providers.collection.overrides,\n\t\t\t\tonChange: (change) => {\n\t\t\t\t\tinvalidateProviders()\n\t\t\t\t\treturn bumpScopes(change)\n\t\t\t\t},\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tscopeField: resolved.providers.collection.scopeField,\n\t\t\t\tresolveScope,\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\tbuildSecret,\n\t\t\t})\n\t\t\t// Always wrap, even though a consumer's own @10x-media/fields plugin (if\n\t\t\t// registered) may wrap this collection again later: double application is\n\t\t\t// inert here (writeOnly forbids queryable, so there are no blind-index\n\t\t\t// markers to rewrite and the response strip is an idempotent delete),\n\t\t\t// while skipping would leak ciphertext whenever fields() runs before this\n\t\t\t// collection exists (e.g. an earlier plugin `order`).\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\twithEncryptedQueryRewrite(providersCollection),\n\t\t\t]\n\t\t}\n\t\t// Config goals are install-wide; the collection resolves per scope and merges over\n\t\t// them behind the same signature, so ingest and the tracker config read one source.\n\t\tconst goalsResolver = resolved.goalsCollection.enabled\n\t\t\t? createGoalsResolver({\n\t\t\t\t\tslug: resolved.goalsCollection.slug,\n\t\t\t\t\tscopeField: resolved.goalsCollection.scopeField,\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tconfig: resolved.goals,\n\t\t\t\t})\n\t\t\t: configGoalsResolver(resolved.goals)\n\t\tif (resolved.goalsCollection.enabled) {\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\tbuildGoalsCollection({\n\t\t\t\t\tslug: resolved.goalsCollection.slug,\n\t\t\t\t\taccess: resolved.goalsCollection.access,\n\t\t\t\t\toverrides: resolved.goalsCollection.overrides,\n\t\t\t\t\tonChange: (change) => {\n\t\t\t\t\t\tgoalsResolver.invalidate()\n\t\t\t\t\t\treturn bumpScopes(change)\n\t\t\t\t\t},\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tscopeField: resolved.goalsCollection.scopeField,\n\t\t\t\t\tresolveScope,\n\t\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\t}),\n\t\t\t]\n\t\t}\n\t\tconst resolveTimezone = async (req: PayloadRequest, scope?: string | null): Promise<string> => {\n\t\t\tconst opt = resolved.reportingTimezone\n\t\t\tif (opt === undefined) {\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst tz =\n\t\t\t\t\ttypeof opt === 'string'\n\t\t\t\t\t\t? opt\n\t\t\t\t\t\t: await opt({ req, scope: scope !== undefined ? scope : await resolveScope(req) })\n\t\t\t\treturn tz && isValidTimeZone(tz) ? tz : DEFAULT_TIMEZONE\n\t\t\t} catch (err) {\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: reportingTimezone resolution failed, falling back to UTC: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t}\n\t\tfor (const adapter of resolved.adapters) {\n\t\t\tadapter.register?.(config, {\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tresolveScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tresolveGoals: goalsResolver.resolve,\n\t\t\t\ttrustedProxyHops: resolved.trustedProxyHops,\n\t\t\t})\n\t\t}\n\t\tif (\n\t\t\tresolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === 'function') ||\n\t\t\tprovidersEnabled\n\t\t) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: REALTIME_PATH, handler: makeRealtimeHandler() },\n\t\t\t]\n\t\t}\n\t\tif (Object.keys(resolved.bindings).length > 0) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: DOCUMENT_PATH, handler: makeDocumentHandler() },\n\t\t\t]\n\t\t}\n\t\tconfig.endpoints = [\n\t\t\t...(config.endpoints ?? []),\n\t\t\t{ method: 'get', path: SOURCES_PATH, handler: makeSourcesHandler() },\n\t\t\t{ method: 'get', path: GOALS_PATH, handler: makeGoalsHandler() },\n\t\t\t{ method: 'get', path: QUERY_PATH, handler: makeQueryHandler() },\n\t\t\t{ method: 'post', path: REFRESH_PATH, handler: makeRefreshHandler() },\n\t\t]\n\t\t// A runtime provider's capture support is unknown at config time, so providers\n\t\t// alone are enough to mount the proxy; every slot is still resolved per request.\n\t\tif (resolved.adapters.some((a) => a.capture) || providersEnabled) {\n\t\t\tconfig.endpoints = [...config.endpoints, ...proxyEndpoints(), trackerEndpoint()]\n\t\t}\n\t\tif (resolved.widgets.enabled) {\n\t\t\tconst multiProvider = registry.isMultiProvider() || providersEnabled\n\t\t\tregisterWidgets(config, {\n\t\t\t\tadapters: resolved.adapters,\n\t\t\t\tmultiProvider,\n\t\t\t\tprovidersEnabled,\n\t\t\t\tdisabled: resolved.widgets.disabled,\n\t\t\t\tregister: resolved.widgets.register,\n\t\t\t\tlocalizeText: resolved.widgets.localizeText,\n\t\t\t\tdefaultId: resolved.defaultAdapter,\n\t\t\t\tcomparison: resolved.widgets.comparison,\n\t\t\t\tview:\n\t\t\t\t\tresolved.view === false\n\t\t\t\t\t\t? false\n\t\t\t\t\t\t: {\n\t\t\t\t\t\t\t\tpath: resolved.view.path,\n\t\t\t\t\t\t\t\tdefaultRange: resolved.view.defaultRange,\n\t\t\t\t\t\t\t\tdefaultMetric: resolved.view.defaultMetric,\n\t\t\t\t\t\t\t},\n\t\t\t})\n\t\t}\n\t\tregisterView(config, { view: resolved.view, pluginOptions: options })\n\t\tif (resolved.cache.warm.enabled) {\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [\n\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\twarmTask(resolved.cache.warm.cron, defaultLayout, resolved.scopes),\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t\tif (resolved.sync.enabled) {\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\tsyncCollection(resolved.sync.collectionSlug, resolved.sync.hidden, {\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tscopeField: 'scope',\n\t\t\t\t\tresolveScope,\n\t\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\t}),\n\t\t\t]\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [\n\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\tsyncTask({\n\t\t\t\t\t\tcron: resolved.sync.cron,\n\t\t\t\t\t\tlookbackDays: resolved.sync.lookbackDays,\n\t\t\t\t\t\tcollectionSlug: resolved.sync.collectionSlug,\n\t\t\t\t\t\tadapterIds: resolved.sync.adapters,\n\t\t\t\t\t\tscopes: resolved.scopes,\n\t\t\t\t\t}),\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t\tconst prevOnInit = config.onInit\n\t\t// The runtime is installed before the app's own onInit runs so consumer init code\n\t\t// (seeding, cache warming, sync passes) can already read through the plugin.\n\t\tconfig.onInit = async (payload) => {\n\t\t\t// Host-owned scope fields only exist once every plugin has run, so the collections\n\t\t\t// are checked against the assembled config rather than at config time.\n\t\t\tif (resolved.scoped && resolved.goalsCollection.enabled) {\n\t\t\t\tvalidateScopeField(payload, {\n\t\t\t\t\toption: 'goals.collection.scopeField',\n\t\t\t\t\tslug: resolved.goalsCollection.slug,\n\t\t\t\t\tscopeField: resolved.goalsCollection.scopeField,\n\t\t\t\t})\n\t\t\t}\n\t\t\tif (resolved.scoped && resolved.providers.collection.enabled) {\n\t\t\t\tvalidateScopeField(payload, {\n\t\t\t\t\toption: 'providers.collection.scopeField',\n\t\t\t\t\tslug: resolved.providers.collection.slug,\n\t\t\t\t\tscopeField: resolved.providers.collection.scopeField,\n\t\t\t\t})\n\t\t\t}\n\t\t\tif (resolved.providers.collection.enabled) {\n\t\t\t\tconst { validateEncryptedBoot } = await import('@10x-media/fields/encrypted')\n\t\t\t\tawait validateEncryptedBoot(payload, resolved.providers.collection.encryption?.keys)\n\t\t\t}\n\t\t\tconst epoch = createEpochStore(payload)\n\t\t\tbumpScopes = async (change) => {\n\t\t\t\tconst scopes = new Set<string | null>([change.scope])\n\t\t\t\tif (change.previousScope !== undefined) {\n\t\t\t\t\tscopes.add(change.previousScope)\n\t\t\t\t}\n\t\t\t\tconst bumps = [...scopes].map(async (scope) => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait epoch.bump(scope)\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\tpayload.logger?.warn(\n\t\t\t\t\t\t\t`analytics: cache epoch bump failed for scope \"${scope ?? 'global'}\", cached reads stay until their ttl: ${String(err)}`\n\t\t\t\t\t\t)\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t\t// One deadline covers every scope a save touches: a document moving between two\n\t\t\t\t// of them must not be able to hold the write open for one deadline each.\n\t\t\t\ttry {\n\t\t\t\t\tawait withDeadline(Promise.allSettled(bumps), EPOCH_BUMP_DEADLINE_MS)\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconst named = [...scopes].map((scope) => `\"${scope ?? 'global'}\"`).join(', ')\n\t\t\t\t\tpayload.logger?.warn(\n\t\t\t\t\t\t`analytics: cache epoch bump did not settle for ${named}, cached reads stay until their ttl: ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst engine = createEngine({\n\t\t\t\tstore: kvCacheStore(payload.kv),\n\t\t\t\tqueue: { concurrency: 4 },\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t\ttimeoutMs: resolved.cache.timeoutMs,\n\t\t\t\tepoch,\n\t\t\t\tonError: (err, adapterId) => {\n\t\t\t\t\tpayload.logger?.warn(`analytics: read failed for adapter \"${adapterId}\": ${String(err)}`)\n\t\t\t\t},\n\t\t\t})\n\t\t\tsetRuntime(payload, {\n\t\t\t\tregistry,\n\t\t\t\tresolveRegistry,\n\t\t\t\tresolveScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tplatformAdapterId: resolved.platformAdapter,\n\t\t\t\tcaptureSlots: resolved.capture.slots,\n\t\t\t\tcapturePaths: resolved.capture.paths,\n\t\t\t\tcaptureProxy: resolved.capture.proxy,\n\t\t\t\ttrustedProxyHops: resolved.trustedProxyHops,\n\t\t\t\tconsentFor: resolved.capture.consent,\n\t\t\t\tautoCapture: resolved.capture.autoCapture,\n\t\t\t\tgoals: resolved.goals,\n\t\t\t\tresolveGoals: goalsResolver.resolve,\n\t\t\t\tresolveGoalsDetailed: goalsResolver.resolveDetailed,\n\t\t\t\t...(resolved.goalsCollection.enabled\n\t\t\t\t\t? { goalsCollectionSlug: resolved.goalsCollection.slug }\n\t\t\t\t\t: {}),\n\t\t\t\tingestPath: resolved.adapters.find((a) => a.ingest)?.ingest?.path,\n\t\t\t\ttrack: (event, opts) => trackServerEvent(payload, event, opts),\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tconfigAdapterIds: new Set(resolved.adapters.map((a) => a.id)),\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\treadAccess: resolved.access.read,\n\t\t\t\tbindings: resolved.bindings,\n\t\t\t\tengine,\n\t\t\t\tepoch,\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t\tcomparison: resolved.widgets.comparison,\n\t\t\t})\n\t\t\tawait prevOnInit?.(payload)\n\t\t}\n\t\treturn config\n\t},\n})\n\nexport type {\n\tAnalyticsBinding,\n\tBindingContext,\n\tHostnameResolver,\n\tPathResolver,\n} from './binding/types'\nexport { PLATFORM_SCOPE } from './core/contract'\nexport type {\n\tAnalyticsAccessOptions,\n\tAnalyticsCaptureOptions,\n\tAnalyticsGoalsCollectionOptions,\n\tAnalyticsGoalsOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsPluginOptions as PluginOptions,\n\tAnalyticsReadAccess,\n\tAnalyticsViewAccess,\n\tAnalyticsViewOptions,\n\tAutoCaptureOptions,\n\tCaptureConsentOption,\n\tConsentMode,\n\tConsentResolver,\n\tPlatformReadAccess,\n\tProvidersCollectionOptions,\n\tProvidersOptions,\n\tProvidersResolve,\n\tScopeResolver,\n\tScopesResolver,\n\tTimezoneResolver,\n} from './core/options'\nexport type { ServerEventInput, ServerTrack, ServerTrackOptions } from './core/serverEvent'\nexport { AnalyticsTrackError } from './core/serverEvent'\nexport type {\n\tAnalyticsFieldsOptions,\n\tAnalyticsMetricLabel,\n\tAnalyticsMetricLabels,\n\tAnalyticsStatOptions,\n\tAnalyticsStatRowOptions,\n\tAnalyticsTabOptions,\n} from './fields/factories'\nexport {\n\tanalyticsFields,\n\tanalyticsStat,\n\tanalyticsStatRow,\n\tanalyticsTab,\n\tanalyticsTabsField,\n} from './fields/factories'\nexport type { GoalFieldOptions } from './goals/goalField'\nexport { goalField, goalSlug } from './goals/goalField'\nexport type { GoalsResponse, WireGoal } from './goals/goalsEndpoint'\nexport type {\n\tGoalActionDefinition,\n\tGoalActionRunArgs,\n\tTrackGoalActionOptions,\n} from './goals/trackGoalAction'\nexport { GOAL_ACTION_TYPE, trackGoalAction } from './goals/trackGoalAction'\nexport type { Goal, GoalMatch, TrackerGoal } from './goals/types'\nexport { trackServerEvent } from './native/ingest/serverTrack'\nexport {\n\tANALYTICS_ERROR_CODES,\n\ttype AnalyticsError,\n\ttype AnalyticsErrorCode,\n\tanalyticsError,\n\treadErrorCode,\n} from './plugin/errors'\nexport type { QueryError, QueryErrorCode } from './query/errors'\nexport type {\n\tQueryErrorResponse,\n\tQueryResponse,\n\tQuerySourceRef,\n\tSerializedAnalyticsQuery,\n} from './query/response'\nexport type { TimeframePreset } from './timeframe/presets'\nexport type { CustomWidgetDef } from './widgets/customWidget'\nexport { analyticsDefaultWidgets } from './widgets/defaults'\nexport { widgetFilters } from './widgets/filterField'\nexport type { WidgetFilter } from './widgets/types'\n"],"mappings":"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"}
|