@10x-media/analytics 1.0.0-beta.7 → 1.0.0-beta.9
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 +118 -0
- package/LICENSE +21 -21
- package/README.md +10 -4
- 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 +179 -70
- 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/plausible/plausible.d.ts +15 -0
- package/dist/adapters/plausible/plausible.js +112 -43
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/posthog/posthog.js +47 -25
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +8 -0
- package/dist/adapters/umami/umami.js +237 -28
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/capture/slots.js +16 -5
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.d.ts +1 -0
- package/dist/capture/trackerConfig.js +28 -3
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/charts/BarList.d.ts +15 -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 +2 -0
- package/dist/charts/bars.js +2 -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 +24 -2
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/capabilities.js +7 -2
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +1 -1
- package/dist/core/contract.d.ts +46 -9
- package/dist/core/contract.js +29 -1
- package/dist/core/contract.js.map +1 -1
- package/dist/core/granularity.js +1 -1
- package/dist/core/options.d.ts +62 -7
- package/dist/core/options.js +63 -4
- package/dist/core/options.js.map +1 -1
- package/dist/core/scopedRead.js +33 -23
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/serverEvent.d.ts +44 -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/client.d.ts +12 -3
- package/dist/exports/client.js +9 -1
- package/dist/exports/rsc.d.ts +7 -2
- package/dist/exports/rsc.js +6 -3
- package/dist/exports/tracker.d.ts +3 -2
- package/dist/exports/tracker.js +2 -1
- package/dist/exports/types.d.ts +13 -4
- package/dist/exports/types.js +3 -2
- package/dist/fields/AnalyticsPanelClient.js +1 -1
- 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/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 +21 -9
- 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 +250 -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 +29 -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 +55 -0
- package/dist/goals/goalsEndpoint.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 +74 -0
- package/dist/goals/trackGoalAction.js +139 -0
- package/dist/goals/trackGoalAction.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 +12 -3
- package/dist/index.js +75 -11
- package/dist/index.js.map +1 -1
- package/dist/native/collections/events.js +36 -0
- package/dist/native/collections/events.js.map +1 -1
- package/dist/native/eventScan.js +25 -0
- package/dist/native/eventScan.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/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 +2 -17
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/flushBatch.js +26 -26
- 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 +26 -0
- package/dist/native/ingest/normalizeEvent.js +35 -7
- 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/serverTrack.d.ts +20 -0
- package/dist/native/ingest/serverTrack.js +100 -0
- package/dist/native/ingest/serverTrack.js.map +1 -0
- package/dist/native/ingest/source.d.ts +7 -0
- package/dist/native/ingest/source.js +139 -14
- 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 +27 -0
- package/dist/native/ingest/validate.js.map +1 -0
- package/dist/native/nativeAdapter.d.ts +1 -1
- package/dist/native/nativeAdapter.js +53 -36
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/query/eventAgg.js +14 -1
- package/dist/native/query/eventAgg.js.map +1 -1
- package/dist/native/retention/pruneTask.js +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 +30 -15
- 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 +3 -2
- package/dist/next/captureRewrites.js +3 -2
- package/dist/next/captureRewrites.js.map +1 -1
- package/dist/plugin/documentEndpoint.js +52 -15
- package/dist/plugin/documentEndpoint.js.map +1 -1
- 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 +5 -1
- package/dist/plugin/paths.js.map +1 -1
- package/dist/plugin/queryEndpoint.js +120 -0
- package/dist/plugin/queryEndpoint.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +71 -0
- package/dist/plugin/readContextForRequest.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +43 -15
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/responses.js +17 -0
- package/dist/plugin/responses.js.map +1 -0
- package/dist/plugin/runtime.js +31 -1
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +22 -0
- package/dist/plugin/scopeFieldBoot.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +21 -52
- 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 +29 -13
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.js +4 -2
- 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 +17 -0
- package/dist/query/errors.js +10 -0
- package/dist/query/errors.js.map +1 -0
- package/dist/query/fetchQuery.d.ts +59 -0
- package/dist/query/fetchQuery.js +110 -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/surfacing/engine.js +1 -1
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/testing/memoryAdapter.js +0 -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/createTracker.js +13 -1
- package/dist/tracker/createTracker.js.map +1 -1
- package/dist/tracker/sinks/ga4.d.ts +21 -0
- package/dist/tracker/sinks/ga4.js +26 -0
- package/dist/tracker/sinks/ga4.js.map +1 -0
- package/dist/tracker/types.d.ts +5 -0
- package/dist/translations/ar.js +127 -1
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +127 -1
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +127 -1
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +127 -1
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +127 -1
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +127 -1
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/keys.d.ts +126 -0
- package/dist/translations/keys.js +127 -1
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +127 -1
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/metricKeys.js +8 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/pt.js +127 -1
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +127 -1
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/uk.js +127 -1
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +127 -1
- package/dist/translations/zh.js.map +1 -1
- 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 +200 -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 +64 -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 +197 -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 +186 -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 +74 -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 +10 -1
- 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 +28 -1
- 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 +72 -25
- 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 +24 -2
- package/dist/widgets/readForWidget.js +34 -48
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +32 -1
- package/dist/widgets/readForWidgetBreakdown.js +32 -42
- 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 +21 -20
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +24 -1
- package/dist/widgets/readForWidgetSeries.js +63 -56
- 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/registerWidgets.js +53 -7
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/types.d.ts +15 -0
- package/dist/widgets/types.js +12 -1
- 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 +9 -4
- package/dist/native/rollups/applyDistinctDeltas.js +0 -9
- package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
- package/dist/native/rollups/bumpRollup.js +0 -73
- 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
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"collection.js","names":[],"sources":["../../src/providers/collection.ts"],"sourcesContent":["import type { CollectionConfig, Field, TextareaField, TextField } from 'payload'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport type { ProviderAccessArgs } from './access'\nimport { providerCreateAccess, providerRowAccess } from './access'\nimport type { ProviderId } from './factory'\nimport { stampScope } from './stampScope'\n\nexport const PROVIDERS_SLUG = 'analytics-providers'\n\n/** Builds the sealed variant of a secret source field; injected so the fields peer stays lazy. */\nexport type BuildSecretField = (source: TextField | TextareaField) => Field[]\n\nexport interface BuildProvidersCollectionArgs extends ProviderAccessArgs {\n\tslug: string\n\taccess?: Partial<CollectionConfig['access']>\n\toverrides?: (collection: CollectionConfig) => CollectionConfig\n\t/** Called after any change or delete so the per-scope registry cache drops stale adapters. */\n\tonChange: () => void\n\tbuildSecret: BuildSecretField\n}\n\nconst textField = (name: string, label: TranslationKey, width?: string): Field => ({\n\tname,\n\ttype: 'text',\n\tlabel: labelForKey(label),\n\t...(width ? { admin: { width } } : {}),\n})\n\nconst secretField = (\n\targs: BuildProvidersCollectionArgs,\n\topts: { name: string; label: TranslationKey; width?: string }\n): Field[] =>\n\targs.buildSecret({\n\t\tname: opts.name,\n\t\ttype: 'text',\n\t\tlabel: labelForKey(opts.label),\n\t\t...(opts.width ? { admin: { width: opts.width } } : {}),\n\t})\n\n/**\n * Public capture config: plain text, never a sealed secret, because the tracker config\n * serves it to the browser. An adapter declares `capture` only when its public field is\n * filled, so these are what let a provider document fill a capture slot.\n */\nconst captureField = (name: string, label: TranslationKey, width?: string): Field => ({\n\tname,\n\ttype: 'text',\n\tlabel: labelForKey(label),\n\tadmin: {\n\t\tdescription: labelForKey(keys.providerFieldCaptureHelp),\n\t\t...(width ? { width } : {}),\n\t},\n})\n\nconst hostField = (): Field => ({\n\tname: 'host',\n\ttype: 'text',\n\tlabel: labelForKey(keys.providerFieldHost),\n\tadmin: { description: labelForKey(keys.providerFieldHostHelp) },\n})\n\nconst providerGroup = (provider: ProviderId, label: TranslationKey, fields: Field[]): Field => ({\n\tname: provider,\n\ttype: 'group',\n\tlabel: labelForKey(label),\n\tadmin: { condition: (data) => data?.provider === provider },\n\tfields,\n})\n\n/**\n * The runtime provider-settings collection: one document per provider (and per scope\n * in scoped installs). Admin-only by default; `access` entries override individual\n * operations and `overrides` reshapes the whole config last, so slugs, labels,\n * fields, and access all stay overridable.\n */\nexport const buildProvidersCollection = (args: BuildProvidersCollectionArgs): CollectionConfig => {\n\tconst collection: CollectionConfig = {\n\t\tslug: args.slug,\n\t\tlabels: {\n\t\t\tsingular: labelForKey(keys.providersCollectionSingular),\n\t\t\tplural: labelForKey(keys.providersCollectionPlural),\n\t\t},\n\t\tdisableDuplicate: true,\n\t\tadmin: {\n\t\t\tuseAsTitle: 'name',\n\t\t\tdefaultColumns: ['name', 'provider', 'enabled'],\n\t\t\tgroup: 'Analytics',\n\t\t},\n\t\taccess: {\n\t\t\tread: providerRowAccess(args),\n\t\t\tcreate: providerCreateAccess(args),\n\t\t\tupdate: providerRowAccess(args),\n\t\t\tdelete: providerRowAccess(args),\n\t\t\t...args.access,\n\t\t},\n\t\thooks: {\n\t\t\tbeforeChange: [stampScope(args)],\n\t\t\tafterChange: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t\tafterDelete: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'name',\n\t\t\t\ttype: 'text',\n\t\t\t\trequired: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldName),\n\t\t\t},\n\t\t\t{\n\t\t\t\ttype: 'row',\n\t\t\t\tfields: [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'provider',\n\t\t\t\t\t\ttype: 'select',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldProvider),\n\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePlausible), value: 'plausible' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameUmami), value: 'umami' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameGa4), value: 'ga4' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePosthog), value: 'posthog' },\n\t\t\t\t\t\t],\n\t\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'enabled',\n\t\t\t\t\t\ttype: 'checkbox',\n\t\t\t\t\t\tdefaultValue: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldEnabled),\n\t\t\t\t\t\tadmin: { width: '50%', style: { alignSelf: 'flex-end' } },\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\t// Written by scoped setups (or a tenant plugin's own field via `scopeField`);\n\t\t\t\t// hidden because single-site installs never touch it.\n\t\t\t\tname: 'scope',\n\t\t\t\ttype: 'text',\n\t\t\t\tindex: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldScope),\n\t\t\t\tadmin: { hidden: true },\n\t\t\t},\n\t\t\tproviderGroup('plausible', keys.providerNamePlausible, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('siteId', keys.providerFieldSiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\tcaptureField('domain', keys.providerFieldDomain, '50%'),\n\t\t\t\t\t\tcaptureField('scriptId', keys.providerFieldScriptId, '50%'),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('umami', keys.providerNameUmami, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('websiteId', keys.providerFieldWebsiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t...secretField(args, { name: 'token', label: keys.providerFieldToken }),\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('ga4', keys.providerNameGa4, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('propertyId', keys.providerFieldPropertyId, '50%'),\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\ttextField('clientEmail', keys.providerFieldClientEmail),\n\t\t\t\t...args.buildSecret({\n\t\t\t\t\tname: 'privateKey',\n\t\t\t\t\ttype: 'textarea',\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldPrivateKey),\n\t\t\t\t}),\n\t\t\t]),\n\t\t\tproviderGroup('posthog', keys.providerNamePosthog, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\tcaptureField('projectToken', keys.providerFieldProjectToken, '50%'),\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tname: 'region',\n\t\t\t\t\t\t\ttype: 'select',\n\t\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldRegion),\n\t\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t\t{ label: 'US', value: 'us' },\n\t\t\t\t\t\t\t\t{ label: 'EU', value: 'eu' },\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t],\n\t}\n\treturn args.overrides ? args.overrides(collection) : collection\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"collection.js","names":[],"sources":["../../src/providers/collection.ts"],"sourcesContent":["import type {\n\tCollectionConfig,\n\tField,\n\tTextareaField,\n\tTextField,\n\tTextFieldSingleValidation,\n} from 'payload'\nimport { validateMeasurementId } from '../adapters/ga4/measurementId'\nimport { validateCurrency } from '../goals/currency'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport type { ProviderAccessArgs } from './access'\nimport { providerCreateAccess, providerRowAccess } from './access'\nimport type { ProviderId } from './factory'\nimport { stampScope } from './stampScope'\n\nexport const PROVIDERS_SLUG = 'analytics-providers'\n\n/** Builds the sealed variant of a secret source field; injected so the fields peer stays lazy. */\nexport type BuildSecretField = (source: TextField | TextareaField) => Field[]\n\nexport interface BuildProvidersCollectionArgs extends ProviderAccessArgs {\n\tslug: string\n\taccess?: Partial<CollectionConfig['access']>\n\toverrides?: (collection: CollectionConfig) => CollectionConfig\n\t/** Called after any change or delete so the per-scope registry cache drops stale adapters. */\n\tonChange: () => void\n\tbuildSecret: BuildSecretField\n}\n\nconst textField = (name: string, label: TranslationKey, width?: string): Field => ({\n\tname,\n\ttype: 'text',\n\tlabel: labelForKey(label),\n\t...(width ? { admin: { width } } : {}),\n})\n\nconst secretField = (\n\targs: BuildProvidersCollectionArgs,\n\topts: { name: string; label: TranslationKey; width?: string }\n): Field[] =>\n\targs.buildSecret({\n\t\tname: opts.name,\n\t\ttype: 'text',\n\t\tlabel: labelForKey(opts.label),\n\t\t...(opts.width ? { admin: { width: opts.width } } : {}),\n\t})\n\n/**\n * Public capture config: plain text, never a sealed secret, because the tracker config\n * serves it to the browser. An adapter declares `capture` only when its public field is\n * filled, so these are what let a provider document fill a capture slot.\n */\nconst captureField = (\n\tname: string,\n\tlabel: TranslationKey,\n\topts: { width?: string; validate?: TextFieldSingleValidation } = {}\n): Field => ({\n\tname,\n\ttype: 'text',\n\tlabel: labelForKey(label),\n\t...(opts.validate ? { validate: opts.validate } : {}),\n\tadmin: {\n\t\tdescription: labelForKey(keys.providerFieldCaptureHelp),\n\t\t...(opts.width ? { width: opts.width } : {}),\n\t},\n})\n\n/**\n * The plugin's own scope field, and only when `scopeField` still names it: a host-owned\n * field (a tenant plugin's relationship) is the host's to register, and shadowing it with a\n * hidden text field of another name would store the scope twice.\n */\nconst scopeField = (args: BuildProvidersCollectionArgs): Field[] =>\n\targs.scopeField === 'scope'\n\t\t? [\n\t\t\t\t{\n\t\t\t\t\t// Written by scoped setups; hidden because single-site installs never touch it.\n\t\t\t\t\tname: 'scope',\n\t\t\t\t\ttype: 'text',\n\t\t\t\t\tindex: true,\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldScope),\n\t\t\t\t\tadmin: { hidden: true },\n\t\t\t\t},\n\t\t\t]\n\t\t: []\n\nconst hostField = (): Field => ({\n\tname: 'host',\n\ttype: 'text',\n\tlabel: labelForKey(keys.providerFieldHost),\n\tadmin: { description: labelForKey(keys.providerFieldHostHelp) },\n})\n\nconst providerGroup = (provider: ProviderId, label: TranslationKey, fields: Field[]): Field => ({\n\tname: provider,\n\ttype: 'group',\n\tlabel: labelForKey(label),\n\tadmin: { condition: (data) => data?.provider === provider },\n\tfields,\n})\n\n/**\n * The runtime provider-settings collection: one document per provider (and per scope\n * in scoped installs). Admin-only by default; `access` entries override individual\n * operations and `overrides` reshapes the whole config last, so slugs, labels,\n * fields, and access all stay overridable.\n */\nexport const buildProvidersCollection = (args: BuildProvidersCollectionArgs): CollectionConfig => {\n\tconst collection: CollectionConfig = {\n\t\tslug: args.slug,\n\t\tlabels: {\n\t\t\tsingular: labelForKey(keys.providersCollectionSingular),\n\t\t\tplural: labelForKey(keys.providersCollectionPlural),\n\t\t},\n\t\tdisableDuplicate: true,\n\t\tadmin: {\n\t\t\tuseAsTitle: 'name',\n\t\t\tdefaultColumns: ['name', 'provider', 'enabled'],\n\t\t\tgroup: 'Analytics',\n\t\t},\n\t\taccess: {\n\t\t\tread: providerRowAccess(args),\n\t\t\tcreate: providerCreateAccess(args),\n\t\t\tupdate: providerRowAccess(args),\n\t\t\tdelete: providerRowAccess(args),\n\t\t\t...args.access,\n\t\t},\n\t\thooks: {\n\t\t\tbeforeChange: [stampScope(args)],\n\t\t\tafterChange: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t\tafterDelete: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'name',\n\t\t\t\ttype: 'text',\n\t\t\t\trequired: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldName),\n\t\t\t},\n\t\t\t{\n\t\t\t\ttype: 'row',\n\t\t\t\tfields: [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'provider',\n\t\t\t\t\t\ttype: 'select',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldProvider),\n\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePlausible), value: 'plausible' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameUmami), value: 'umami' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameGa4), value: 'ga4' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePosthog), value: 'posthog' },\n\t\t\t\t\t\t],\n\t\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'enabled',\n\t\t\t\t\t\ttype: 'checkbox',\n\t\t\t\t\t\tdefaultValue: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldEnabled),\n\t\t\t\t\t\tadmin: { width: '50%', style: { alignSelf: 'flex-end' } },\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t\t...scopeField(args),\n\t\t\tproviderGroup('plausible', keys.providerNamePlausible, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('siteId', keys.providerFieldSiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\tcaptureField('domain', keys.providerFieldDomain, { width: '50%' }),\n\t\t\t\t\t\tcaptureField('scriptId', keys.providerFieldScriptId, { width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'revenueCurrency',\n\t\t\t\t\ttype: 'text',\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldRevenueCurrency),\n\t\t\t\t\tvalidate: validateCurrency,\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('umami', keys.providerNameUmami, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('websiteId', keys.providerFieldWebsiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t...secretField(args, { name: 'token', label: keys.providerFieldToken }),\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('ga4', keys.providerNameGa4, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('propertyId', keys.providerFieldPropertyId, '50%'),\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\ttextField('clientEmail', keys.providerFieldClientEmail),\n\t\t\t\tcaptureField('measurementId', keys.providerFieldMeasurementId, {\n\t\t\t\t\tvalidate: validateMeasurementId,\n\t\t\t\t}),\n\t\t\t\t...args.buildSecret({\n\t\t\t\t\tname: 'privateKey',\n\t\t\t\t\ttype: 'textarea',\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldPrivateKey),\n\t\t\t\t}),\n\t\t\t]),\n\t\t\tproviderGroup('posthog', keys.providerNamePosthog, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\tcaptureField('projectToken', keys.providerFieldProjectToken, { width: '50%' }),\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tname: 'region',\n\t\t\t\t\t\t\ttype: 'select',\n\t\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldRegion),\n\t\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t\t{ label: 'US', value: 'us' },\n\t\t\t\t\t\t\t\t{ label: 'EU', value: 'eu' },\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t],\n\t}\n\treturn args.overrides ? args.overrides(collection) : collection\n}\n"],"mappings":"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"}
|
|
@@ -30,7 +30,8 @@ const buildBaseAdapter = (doc) => {
|
|
|
30
30
|
apiKey: cfg.apiKey ?? "",
|
|
31
31
|
host: orUndefined(cfg.host),
|
|
32
32
|
domain: orUndefined(cfg.domain),
|
|
33
|
-
scriptId: orUndefined(cfg.scriptId)
|
|
33
|
+
scriptId: orUndefined(cfg.scriptId),
|
|
34
|
+
revenueCurrency: orUndefined(cfg.revenueCurrency)
|
|
34
35
|
});
|
|
35
36
|
}
|
|
36
37
|
case "umami": {
|
|
@@ -50,7 +51,8 @@ const buildBaseAdapter = (doc) => {
|
|
|
50
51
|
client_email: cfg.clientEmail ?? "",
|
|
51
52
|
private_key: normalizePrivateKey(cfg.privateKey ?? "")
|
|
52
53
|
},
|
|
53
|
-
projectId: orUndefined(cfg.projectId)
|
|
54
|
+
projectId: orUndefined(cfg.projectId),
|
|
55
|
+
measurementId: orUndefined(cfg.measurementId)
|
|
54
56
|
});
|
|
55
57
|
}
|
|
56
58
|
case "posthog": {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"factory.js","names":[],"sources":["../../src/providers/factory.ts"],"sourcesContent":["import { ga4 } from '../adapters/ga4/ga4'\nimport { plausible } from '../adapters/plausible/plausible'\nimport { posthog } from '../adapters/posthog/posthog'\nimport { umami } from '../adapters/umami/umami'\nimport type { AnalyticsAdapter } from '../core/contract'\n\nexport const PROVIDER_IDS = ['plausible', 'umami', 'ga4', 'posthog'] as const\nexport type ProviderId = (typeof PROVIDER_IDS)[number]\n\n/** The provider-settings document shape the adapter factory reads (depth 0, secrets revealed). */\nexport type ProviderDoc = {\n\tid?: number | string\n\tname?: string | null\n\tprovider?: string | null\n\tenabled?: boolean | null\n\tscope?: string | null\n\tplausible?: {\n\t\tsiteId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tdomain?: string | null\n\t\tscriptId?: string | null\n\t} | null\n\tumami?: {\n\t\twebsiteId?: string | null\n\t\tapiKey?: string | null\n\t\ttoken?: string | null\n\t\thost?: string | null\n\t} | null\n\tga4?: {\n\t\tpropertyId?: string | null\n\t\tclientEmail?: string | null\n\t\tprivateKey?: string | null\n\t\tprojectId?: string | null\n\t} | null\n\tposthog?: {\n\t\tprojectId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tprojectToken?: string | null\n\t\tregion?: string | null\n\t} | null\n}\n\nconst orUndefined = (value: string | null | undefined): string | undefined => value || undefined\n\n/** An unset or unrecognized stored region falls back to host-derived detection. */\nconst posthogRegion = (value: string | null | undefined): 'us' | 'eu' | undefined =>\n\tvalue === 'us' || value === 'eu' ? value : undefined\n\n/**\n * Keys pasted from a service-account JSON often carry escaped newlines; the gRPC\n * client needs real ones.\n */\nexport const normalizePrivateKey = (key: string): string => key.replace(/\\\\n/g, '\\n')\n\nconst shortId = (id: number | string): string => String(id).slice(-6)\n\n/** Runtime adapters carry a per-document instance id so two projects of one provider type never collide in a registry; config adapters keep their plain ids. */\nconst withInstanceIdentity = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter => {\n\tif (doc.id === undefined || doc.id === null || doc.id === '') {\n\t\treturn adapter\n\t}\n\treturn {\n\t\t...adapter,\n\t\tid: `${doc.provider}:${doc.id}`,\n\t\tlabel: doc.name || `${adapter.label} ${shortId(doc.id)}`,\n\t}\n}\n\nconst buildBaseAdapter = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tswitch (doc.provider) {\n\t\tcase 'plausible': {\n\t\t\tconst cfg = doc.plausible ?? {}\n\t\t\treturn plausible({\n\t\t\t\tsiteId: cfg.siteId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tdomain: orUndefined(cfg.domain),\n\t\t\t\tscriptId: orUndefined(cfg.scriptId),\n\t\t\t})\n\t\t}\n\t\tcase 'umami': {\n\t\t\tconst cfg = doc.umami ?? {}\n\t\t\treturn umami({\n\t\t\t\twebsiteId: cfg.websiteId ?? '',\n\t\t\t\tapiKey: orUndefined(cfg.apiKey),\n\t\t\t\ttoken: orUndefined(cfg.token),\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t})\n\t\t}\n\t\tcase 'ga4': {\n\t\t\tconst cfg = doc.ga4 ?? {}\n\t\t\treturn ga4({\n\t\t\t\tpropertyId: cfg.propertyId ?? '',\n\t\t\t\tcredentials: {\n\t\t\t\t\tclient_email: cfg.clientEmail ?? '',\n\t\t\t\t\tprivate_key: normalizePrivateKey(cfg.privateKey ?? ''),\n\t\t\t\t},\n\t\t\t\tprojectId: orUndefined(cfg.projectId),\n\t\t\t})\n\t\t}\n\t\tcase 'posthog': {\n\t\t\tconst cfg = doc.posthog ?? {}\n\t\t\treturn posthog({\n\t\t\t\tprojectId: cfg.projectId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tprojectToken: orUndefined(cfg.projectToken),\n\t\t\t\tregion: posthogRegion(cfg.region),\n\t\t\t})\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * Build an adapter instance from a provider-settings document using the same\n * constructors as config-time adapters. Missing credentials are passed through as\n * empty strings so the adapter reports `isConfigured() === false` instead of the\n * factory throwing; an unknown provider value returns null and is skipped.\n */\nexport const adapterFromProviderDoc = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tconst base = buildBaseAdapter(doc)\n\treturn base ? withInstanceIdentity(base, doc) : null\n}\n"],"mappings":";;;;;
|
|
1
|
+
{"version":3,"file":"factory.js","names":[],"sources":["../../src/providers/factory.ts"],"sourcesContent":["import { ga4 } from '../adapters/ga4/ga4'\nimport { plausible } from '../adapters/plausible/plausible'\nimport { posthog } from '../adapters/posthog/posthog'\nimport { umami } from '../adapters/umami/umami'\nimport type { AnalyticsAdapter } from '../core/contract'\n\nexport const PROVIDER_IDS = ['plausible', 'umami', 'ga4', 'posthog'] as const\nexport type ProviderId = (typeof PROVIDER_IDS)[number]\n\n/** The provider-settings document shape the adapter factory reads (depth 0, secrets revealed). */\nexport type ProviderDoc = {\n\tid?: number | string\n\tname?: string | null\n\tprovider?: string | null\n\tenabled?: boolean | null\n\tscope?: string | null\n\tplausible?: {\n\t\tsiteId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tdomain?: string | null\n\t\tscriptId?: string | null\n\t\trevenueCurrency?: string | null\n\t} | null\n\tumami?: {\n\t\twebsiteId?: string | null\n\t\tapiKey?: string | null\n\t\ttoken?: string | null\n\t\thost?: string | null\n\t} | null\n\tga4?: {\n\t\tpropertyId?: string | null\n\t\tclientEmail?: string | null\n\t\tprivateKey?: string | null\n\t\tprojectId?: string | null\n\t\tmeasurementId?: string | null\n\t} | null\n\tposthog?: {\n\t\tprojectId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tprojectToken?: string | null\n\t\tregion?: string | null\n\t} | null\n}\n\nconst orUndefined = (value: string | null | undefined): string | undefined => value || undefined\n\n/** An unset or unrecognized stored region falls back to host-derived detection. */\nconst posthogRegion = (value: string | null | undefined): 'us' | 'eu' | undefined =>\n\tvalue === 'us' || value === 'eu' ? value : undefined\n\n/**\n * Keys pasted from a service-account JSON often carry escaped newlines; the gRPC\n * client needs real ones.\n */\nexport const normalizePrivateKey = (key: string): string => key.replace(/\\\\n/g, '\\n')\n\nconst shortId = (id: number | string): string => String(id).slice(-6)\n\n/** Runtime adapters carry a per-document instance id so two projects of one provider type never collide in a registry; config adapters keep their plain ids. */\nconst withInstanceIdentity = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter => {\n\tif (doc.id === undefined || doc.id === null || doc.id === '') {\n\t\treturn adapter\n\t}\n\treturn {\n\t\t...adapter,\n\t\tid: `${doc.provider}:${doc.id}`,\n\t\tlabel: doc.name || `${adapter.label} ${shortId(doc.id)}`,\n\t}\n}\n\nconst buildBaseAdapter = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tswitch (doc.provider) {\n\t\tcase 'plausible': {\n\t\t\tconst cfg = doc.plausible ?? {}\n\t\t\treturn plausible({\n\t\t\t\tsiteId: cfg.siteId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tdomain: orUndefined(cfg.domain),\n\t\t\t\tscriptId: orUndefined(cfg.scriptId),\n\t\t\t\trevenueCurrency: orUndefined(cfg.revenueCurrency),\n\t\t\t})\n\t\t}\n\t\tcase 'umami': {\n\t\t\tconst cfg = doc.umami ?? {}\n\t\t\treturn umami({\n\t\t\t\twebsiteId: cfg.websiteId ?? '',\n\t\t\t\tapiKey: orUndefined(cfg.apiKey),\n\t\t\t\ttoken: orUndefined(cfg.token),\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t})\n\t\t}\n\t\tcase 'ga4': {\n\t\t\tconst cfg = doc.ga4 ?? {}\n\t\t\treturn ga4({\n\t\t\t\tpropertyId: cfg.propertyId ?? '',\n\t\t\t\tcredentials: {\n\t\t\t\t\tclient_email: cfg.clientEmail ?? '',\n\t\t\t\t\tprivate_key: normalizePrivateKey(cfg.privateKey ?? ''),\n\t\t\t\t},\n\t\t\t\tprojectId: orUndefined(cfg.projectId),\n\t\t\t\tmeasurementId: orUndefined(cfg.measurementId),\n\t\t\t})\n\t\t}\n\t\tcase 'posthog': {\n\t\t\tconst cfg = doc.posthog ?? {}\n\t\t\treturn posthog({\n\t\t\t\tprojectId: cfg.projectId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tprojectToken: orUndefined(cfg.projectToken),\n\t\t\t\tregion: posthogRegion(cfg.region),\n\t\t\t})\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * Build an adapter instance from a provider-settings document using the same\n * constructors as config-time adapters. Missing credentials are passed through as\n * empty strings so the adapter reports `isConfigured() === false` instead of the\n * factory throwing; an unknown provider value returns null and is skipped.\n */\nexport const adapterFromProviderDoc = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tconst base = buildBaseAdapter(doc)\n\treturn base ? withInstanceIdentity(base, doc) : null\n}\n"],"mappings":";;;;;AA8CA,MAAM,eAAe,UAAyD,SAAS,KAAA;;AAGvF,MAAM,iBAAiB,UACtB,UAAU,QAAQ,UAAU,OAAO,QAAQ,KAAA;;;;;AAM5C,MAAa,uBAAuB,QAAwB,IAAI,QAAQ,QAAQ,IAAI;AAEpF,MAAM,WAAW,OAAgC,OAAO,EAAE,EAAE,MAAM,EAAE;;AAGpE,MAAM,wBAAwB,SAA2B,QAAuC;CAC/F,IAAI,IAAI,OAAO,KAAA,KAAa,IAAI,OAAO,QAAQ,IAAI,OAAO,IACzD,OAAO;CAER,OAAO;EACN,GAAG;EACH,IAAI,GAAG,IAAI,SAAS,GAAG,IAAI;EAC3B,OAAO,IAAI,QAAQ,GAAG,QAAQ,MAAM,GAAG,QAAQ,IAAI,EAAE;CACtD;AACD;AAEA,MAAM,oBAAoB,QAA8C;CACvE,QAAQ,IAAI,UAAZ;EACC,KAAK,aAAa;GACjB,MAAM,MAAM,IAAI,aAAa,CAAC;GAC9B,OAAO,UAAU;IAChB,QAAQ,IAAI,UAAU;IACtB,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;IAC1B,QAAQ,YAAY,IAAI,MAAM;IAC9B,UAAU,YAAY,IAAI,QAAQ;IAClC,iBAAiB,YAAY,IAAI,eAAe;GACjD,CAAC;EACF;EACA,KAAK,SAAS;GACb,MAAM,MAAM,IAAI,SAAS,CAAC;GAC1B,OAAO,MAAM;IACZ,WAAW,IAAI,aAAa;IAC5B,QAAQ,YAAY,IAAI,MAAM;IAC9B,OAAO,YAAY,IAAI,KAAK;IAC5B,MAAM,YAAY,IAAI,IAAI;GAC3B,CAAC;EACF;EACA,KAAK,OAAO;GACX,MAAM,MAAM,IAAI,OAAO,CAAC;GACxB,OAAO,IAAI;IACV,YAAY,IAAI,cAAc;IAC9B,aAAa;KACZ,cAAc,IAAI,eAAe;KACjC,aAAa,oBAAoB,IAAI,cAAc,EAAE;IACtD;IACA,WAAW,YAAY,IAAI,SAAS;IACpC,eAAe,YAAY,IAAI,aAAa;GAC7C,CAAC;EACF;EACA,KAAK,WAAW;GACf,MAAM,MAAM,IAAI,WAAW,CAAC;GAC5B,OAAO,QAAQ;IACd,WAAW,IAAI,aAAa;IAC5B,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;IAC1B,cAAc,YAAY,IAAI,YAAY;IAC1C,QAAQ,cAAc,IAAI,MAAM;GACjC,CAAC;EACF;EACA,SACC,OAAO;CACT;AACD;;;;;;;AAQA,MAAa,0BAA0B,QAA8C;CACpF,MAAM,OAAO,iBAAiB,GAAG;CACjC,OAAO,OAAO,qBAAqB,MAAM,GAAG,IAAI;AACjD"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resolver.js","names":[],"sources":["../../src/providers/resolver.ts"],"sourcesContent":["import { createLocalReq, type Where } from 'payload'\nimport type { AnalyticsAdapter } from '../core/contract'\nimport {\n\ttype AdapterRegistry,\n\tcreateRegistry,\n\ttype RegistryResolver,\n\ttype ResolveRegistryArgs,\n} from '../core/registry'\nimport { adapterFromProviderDoc, type ProviderDoc } from './factory'\nimport { SECRET_PATHS } from './secrets'\n\nexport const PROVIDERS_CACHE_TTL_MS = 30_000\n\n/** Produces the runtime adapters layered onto the static base for one scope. */\nexport type ProvidersSource = (args: ResolveRegistryArgs) => Promise<AnalyticsAdapter[]>\n\nexport interface RegistryBase {\n\tadapters: AnalyticsAdapter[]\n\tdefaultId?: string\n}\n\n/**\n * Append runtime adapters after the static base. Ids are disjoint by\n * construction (instance ids carry a ':', config ids do not); an extra that\n * still collides with a base id (a custom providers.resolve returning a plain\n * provider id) is skipped so config adapters always win, and the default\n * adapter is always a config adapter.\n */\nexport const combineRegistries = (\n\tbase: RegistryBase,\n\textra: AnalyticsAdapter[]\n): AdapterRegistry => {\n\tif (extra.length === 0) {\n\t\treturn createRegistry(base.adapters, base.defaultId)\n\t}\n\tconst seen = new Set(base.adapters.map((a) => a.id))\n\tconst merged = [...base.adapters]\n\tfor (const adapter of extra) {\n\t\tif (!seen.has(adapter.id)) {\n\t\t\tmerged.push(adapter)\n\t\t\tseen.add(adapter.id)\n\t\t}\n\t}\n\treturn createRegistry(merged, base.defaultId)\n}\n\nconst setAtPath = (doc: Record<string, unknown>, path: string, value: unknown): void => {\n\tconst [group, field] = path.split('.') as [string, string]\n\tconst target = doc[group]\n\tif (target && typeof target === 'object') {\n\t\t;(target as Record<string, unknown>)[field] = value\n\t}\n}\n\nconst getAtPath = (doc: Record<string, unknown>, path: string): unknown => {\n\tconst [group, field] = path.split('.') as [string, string]\n\tconst target = doc[group]\n\treturn target && typeof target === 'object'\n\t\t? (target as Record<string, unknown>)[field]\n\t\t: undefined\n}\n\n/**\n * Look up a scope's enabled provider documents and build adapters from them.\n * Reads raw ciphertext inside a withRawEncrypted window (write-only secrets\n * are stripped from ordinary reads), then decrypts each credential through\n * the fields key ring. Legacy plaintext rows pass through decryptFieldValue\n * unchanged, so pre-encryption documents keep working until re-saved.\n */\nexport const collectionProvidersSource = (slug: string, scopeField: string): ProvidersSource => {\n\treturn async ({ payload, req, scope }) => {\n\t\tconst { decryptFieldValue, withRawEncrypted } = await import('@10x-media/fields/encrypted')\n\t\tconst readReq = req ?? (await createLocalReq({}, payload))\n\t\tconst scopeWhere: Where =\n\t\t\tscope === null\n\t\t\t\t? { or: [{ [scopeField]: { equals: null } }, { [scopeField]: { equals: '' } }] }\n\t\t\t\t: { [scopeField]: { equals: scope } }\n\t\tconst { docs } = await withRawEncrypted(readReq, () =>\n\t\t\tpayload.find({\n\t\t\t\tcollection: slug as never,\n\t\t\t\twhere: { and: [{ enabled: { equals: true } }, scopeWhere] },\n\t\t\t\tlimit: 100,\n\t\t\t\tpagination: false,\n\t\t\t\tdepth: 0,\n\t\t\t\toverrideAccess: true,\n\t\t\t\treq: readReq,\n\t\t\t})\n\t\t)\n\t\tconst adapters: AnalyticsAdapter[] = []\n\t\tfor (const raw of docs as Array<Record<string, unknown>>) {\n\t\t\ttry {\n\t\t\t\tconst doc = structuredClone(raw) as Record<string, unknown>\n\t\t\t\tfor (const { path } of SECRET_PATHS) {\n\t\t\t\t\tconst value = getAtPath(doc, path)\n\t\t\t\t\tif (typeof value === 'string' && value !== '') {\n\t\t\t\t\t\tconst plain = await decryptFieldValue(payload, { collection: slug, path, value })\n\t\t\t\t\t\tsetAtPath(doc, path, typeof plain === 'string' ? plain : '')\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tconst adapter = adapterFromProviderDoc(doc as ProviderDoc)\n\t\t\t\tif (adapter) adapters.push(adapter)\n\t\t\t} catch (err) {\n\t\t\t\t// A corrupted or key-rotated-away ciphertext must not take the whole\n\t\t\t\t// scope's registry down; skip just this document's adapter.\n\t\t\t\tpayload.logger.warn(\n\t\t\t\t\t`analytics: provider document \"${String(raw.id)}\" (${String(raw.provider)}) failed to decrypt, skipping it: ${String(err)}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\treturn adapters\n\t}\n}\n\nexport interface ScopedRegistryResolver {\n\tresolver: RegistryResolver\n\t/** Drops every cached scope registry; wired to the provider collection's change hooks. */\n\tinvalidate: () => void\n}\n\n/**\n * Cache resolved registries per scope for a short TTL so widget-heavy dashboards\n * do not re-query the provider collection on every read. Invalidation clears all\n * scopes at once: a document's scope binding can itself change, so per-scope\n * eviction could leave a stale entry under the old scope.\n */\nexport const createScopedRegistryResolver = (args: {\n\tbase: RegistryBase\n\tsource: ProvidersSource\n\tttlMs?: number\n}): ScopedRegistryResolver => {\n\tconst ttlMs = args.ttlMs ?? PROVIDERS_CACHE_TTL_MS\n\tconst cache = new Map<string | null, { registry: AdapterRegistry; expiresAt: number }>()\n\treturn {\n\t\tresolver: async (resolveArgs) => {\n\t\t\tconst now = Date.now()\n\t\t\tconst hit = cache.get(resolveArgs.scope)\n\t\t\tif (hit && hit.expiresAt > now) {\n\t\t\t\treturn hit.registry\n\t\t\t}\n\t\t\tconst registry = combineRegistries(args.base, await args.source(resolveArgs))\n\t\t\tcache.set(resolveArgs.scope, { registry, expiresAt: now + ttlMs })\n\t\t\treturn registry\n\t\t},\n\t\tinvalidate: () => cache.clear(),\n\t}\n}\n"],"mappings":";;;;;;;;;;;AA4BA,MAAa,qBACZ,MACA,UACqB;CACrB,IAAI,MAAM,WAAW,GACpB,OAAO,eAAe,KAAK,UAAU,KAAK,SAAS;CAEpD,MAAM,OAAO,IAAI,IAAI,KAAK,SAAS,KAAK,MAAM,EAAE,EAAE,CAAC;CACnD,MAAM,SAAS,CAAC,GAAG,KAAK,QAAQ;CAChC,KAAK,MAAM,WAAW,OACrB,IAAI,CAAC,KAAK,IAAI,QAAQ,EAAE,GAAG;EAC1B,OAAO,KAAK,OAAO;EACnB,KAAK,IAAI,QAAQ,EAAE;CACpB;CAED,OAAO,eAAe,QAAQ,KAAK,SAAS;AAC7C;AAEA,MAAM,aAAa,KAA8B,MAAc,UAAyB;CACvF,MAAM,CAAC,OAAO,SAAS,KAAK,MAAM,GAAG;CACrC,MAAM,SAAS,IAAI;CACnB,IAAI,UAAU,OAAO,WAAW,UAC9B,OAAoC,SAAS;AAEhD;AAEA,MAAM,aAAa,KAA8B,SAA0B;CAC1E,MAAM,CAAC,OAAO,SAAS,KAAK,MAAM,GAAG;CACrC,MAAM,SAAS,IAAI;CACnB,OAAO,UAAU,OAAO,WAAW,WAC/B,OAAmC,SACpC,KAAA;AACJ;;;;;;;;AASA,MAAa,6BAA6B,MAAc,eAAwC;CAC/F,OAAO,OAAO,EAAE,SAAS,KAAK,YAAY;EACzC,MAAM,EAAE,mBAAmB,qBAAqB,MAAM,OAAO;EAC7D,MAAM,UAAU,OAAQ,MAAM,eAAe,CAAC,GAAG,OAAO;
|
|
1
|
+
{"version":3,"file":"resolver.js","names":[],"sources":["../../src/providers/resolver.ts"],"sourcesContent":["import { createLocalReq, type Where } from 'payload'\nimport type { AnalyticsAdapter } from '../core/contract'\nimport {\n\ttype AdapterRegistry,\n\tcreateRegistry,\n\ttype RegistryResolver,\n\ttype ResolveRegistryArgs,\n} from '../core/registry'\nimport { adapterFromProviderDoc, type ProviderDoc } from './factory'\nimport { SECRET_PATHS } from './secrets'\n\nexport const PROVIDERS_CACHE_TTL_MS = 30_000\n\n/** Produces the runtime adapters layered onto the static base for one scope. */\nexport type ProvidersSource = (args: ResolveRegistryArgs) => Promise<AnalyticsAdapter[]>\n\nexport interface RegistryBase {\n\tadapters: AnalyticsAdapter[]\n\tdefaultId?: string\n}\n\n/**\n * Append runtime adapters after the static base. Ids are disjoint by\n * construction (instance ids carry a ':', config ids do not); an extra that\n * still collides with a base id (a custom providers.resolve returning a plain\n * provider id) is skipped so config adapters always win, and the default\n * adapter is always a config adapter.\n */\nexport const combineRegistries = (\n\tbase: RegistryBase,\n\textra: AnalyticsAdapter[]\n): AdapterRegistry => {\n\tif (extra.length === 0) {\n\t\treturn createRegistry(base.adapters, base.defaultId)\n\t}\n\tconst seen = new Set(base.adapters.map((a) => a.id))\n\tconst merged = [...base.adapters]\n\tfor (const adapter of extra) {\n\t\tif (!seen.has(adapter.id)) {\n\t\t\tmerged.push(adapter)\n\t\t\tseen.add(adapter.id)\n\t\t}\n\t}\n\treturn createRegistry(merged, base.defaultId)\n}\n\nconst setAtPath = (doc: Record<string, unknown>, path: string, value: unknown): void => {\n\tconst [group, field] = path.split('.') as [string, string]\n\tconst target = doc[group]\n\tif (target && typeof target === 'object') {\n\t\t;(target as Record<string, unknown>)[field] = value\n\t}\n}\n\nconst getAtPath = (doc: Record<string, unknown>, path: string): unknown => {\n\tconst [group, field] = path.split('.') as [string, string]\n\tconst target = doc[group]\n\treturn target && typeof target === 'object'\n\t\t? (target as Record<string, unknown>)[field]\n\t\t: undefined\n}\n\n/**\n * Look up a scope's enabled provider documents and build adapters from them.\n * Reads raw ciphertext inside a withRawEncrypted window (write-only secrets\n * are stripped from ordinary reads), then decrypts each credential through\n * the fields key ring. Legacy plaintext rows pass through decryptFieldValue\n * unchanged, so pre-encryption documents keep working until re-saved.\n */\nexport const collectionProvidersSource = (slug: string, scopeField: string): ProvidersSource => {\n\treturn async ({ payload, req, scope }) => {\n\t\tconst { decryptFieldValue, withRawEncrypted } = await import('@10x-media/fields/encrypted')\n\t\tconst readReq = req ?? (await createLocalReq({}, payload))\n\t\t// The empty string is not castable on a relationship-typed scopeField, so install-wide\n\t\t// lookups on a host-owned relationship field resolve the config adapters only.\n\t\tconst scopeWhere: Where =\n\t\t\tscope === null\n\t\t\t\t? { or: [{ [scopeField]: { equals: null } }, { [scopeField]: { equals: '' } }] }\n\t\t\t\t: { [scopeField]: { equals: scope } }\n\t\tconst { docs } = await withRawEncrypted(readReq, () =>\n\t\t\tpayload.find({\n\t\t\t\tcollection: slug as never,\n\t\t\t\twhere: { and: [{ enabled: { equals: true } }, scopeWhere] },\n\t\t\t\tlimit: 100,\n\t\t\t\tpagination: false,\n\t\t\t\tdepth: 0,\n\t\t\t\toverrideAccess: true,\n\t\t\t\treq: readReq,\n\t\t\t})\n\t\t)\n\t\tconst adapters: AnalyticsAdapter[] = []\n\t\tfor (const raw of docs as Array<Record<string, unknown>>) {\n\t\t\ttry {\n\t\t\t\tconst doc = structuredClone(raw) as Record<string, unknown>\n\t\t\t\tfor (const { path } of SECRET_PATHS) {\n\t\t\t\t\tconst value = getAtPath(doc, path)\n\t\t\t\t\tif (typeof value === 'string' && value !== '') {\n\t\t\t\t\t\tconst plain = await decryptFieldValue(payload, { collection: slug, path, value })\n\t\t\t\t\t\tsetAtPath(doc, path, typeof plain === 'string' ? plain : '')\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tconst adapter = adapterFromProviderDoc(doc as ProviderDoc)\n\t\t\t\tif (adapter) adapters.push(adapter)\n\t\t\t} catch (err) {\n\t\t\t\t// A corrupted or key-rotated-away ciphertext must not take the whole\n\t\t\t\t// scope's registry down; skip just this document's adapter.\n\t\t\t\tpayload.logger.warn(\n\t\t\t\t\t`analytics: provider document \"${String(raw.id)}\" (${String(raw.provider)}) failed to decrypt, skipping it: ${String(err)}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\treturn adapters\n\t}\n}\n\nexport interface ScopedRegistryResolver {\n\tresolver: RegistryResolver\n\t/** Drops every cached scope registry; wired to the provider collection's change hooks. */\n\tinvalidate: () => void\n}\n\n/**\n * Cache resolved registries per scope for a short TTL so widget-heavy dashboards\n * do not re-query the provider collection on every read. Invalidation clears all\n * scopes at once: a document's scope binding can itself change, so per-scope\n * eviction could leave a stale entry under the old scope.\n */\nexport const createScopedRegistryResolver = (args: {\n\tbase: RegistryBase\n\tsource: ProvidersSource\n\tttlMs?: number\n}): ScopedRegistryResolver => {\n\tconst ttlMs = args.ttlMs ?? PROVIDERS_CACHE_TTL_MS\n\tconst cache = new Map<string | null, { registry: AdapterRegistry; expiresAt: number }>()\n\treturn {\n\t\tresolver: async (resolveArgs) => {\n\t\t\tconst now = Date.now()\n\t\t\tconst hit = cache.get(resolveArgs.scope)\n\t\t\tif (hit && hit.expiresAt > now) {\n\t\t\t\treturn hit.registry\n\t\t\t}\n\t\t\tconst registry = combineRegistries(args.base, await args.source(resolveArgs))\n\t\t\tcache.set(resolveArgs.scope, { registry, expiresAt: now + ttlMs })\n\t\t\treturn registry\n\t\t},\n\t\tinvalidate: () => cache.clear(),\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { addDaysInTz, startOfCalendarDayInTz } from "../timeframe/tz.js";
|
|
2
|
+
//#region src/query/dates.ts
|
|
3
|
+
/**
|
|
4
|
+
* Range-bound parsing, shared by every surface that takes `from`/`to` from outside: the
|
|
5
|
+
* query endpoint's parser, the document panel endpoint, and the widgets' stored custom
|
|
6
|
+
* range. A leaf module so those cannot drift apart on what a calendar day means.
|
|
7
|
+
*/
|
|
8
|
+
/** The only offset-free bound form: a `YYYY-MM-DD` calendar day. */
|
|
9
|
+
const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
|
|
10
|
+
const DATE_TIME = /^(\d{4}-\d{2}-\d{2})T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?([Zz]|[+-]\d{2}:\d{2})$/;
|
|
11
|
+
const DAYS_IN_MONTH = [
|
|
12
|
+
31,
|
|
13
|
+
28,
|
|
14
|
+
31,
|
|
15
|
+
30,
|
|
16
|
+
31,
|
|
17
|
+
30,
|
|
18
|
+
31,
|
|
19
|
+
31,
|
|
20
|
+
30,
|
|
21
|
+
31,
|
|
22
|
+
30,
|
|
23
|
+
31
|
|
24
|
+
];
|
|
25
|
+
const isLeapYear = (year) => year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
|
|
26
|
+
/** Calendar parts of a `YYYY-MM-DD` string, or null when it names no real day. */
|
|
27
|
+
const calendarParts = (raw) => {
|
|
28
|
+
const year = Number(raw.slice(0, 4));
|
|
29
|
+
const month = Number(raw.slice(5, 7));
|
|
30
|
+
const day = Number(raw.slice(8, 10));
|
|
31
|
+
if (month < 1 || month > 12) return null;
|
|
32
|
+
const lastDay = month === 2 && isLeapYear(year) ? 29 : DAYS_IN_MONTH[month - 1];
|
|
33
|
+
if (lastDay === void 0 || day < 1 || day > lastDay) return null;
|
|
34
|
+
return {
|
|
35
|
+
year,
|
|
36
|
+
month,
|
|
37
|
+
day
|
|
38
|
+
};
|
|
39
|
+
};
|
|
40
|
+
/**
|
|
41
|
+
* A range bound. `YYYY-MM-DD` is the whole calendar day in `timezone`: the start edge is
|
|
42
|
+
* its first instant, the end edge its last, matching the inclusive `end` every adapter
|
|
43
|
+
* reads (`less_than_equal`, `timestamp <=`, GA4's inclusive `endDate`). The only other
|
|
44
|
+
* accepted form is a full datetime carrying `Z` or a `±HH:MM` offset, taken as the instant
|
|
45
|
+
* it names. A datetime without an offset is rejected rather than silently read in the
|
|
46
|
+
* server's own zone, and so are the loose forms `Date` would otherwise accept (`2026`,
|
|
47
|
+
* `Sep 1 2026`).
|
|
48
|
+
*/
|
|
49
|
+
const parseDayOrInstant = (raw, args) => {
|
|
50
|
+
if (DATE_ONLY.test(raw)) {
|
|
51
|
+
const ymd = calendarParts(raw);
|
|
52
|
+
if (!ymd) return null;
|
|
53
|
+
const dayStart = startOfCalendarDayInTz(ymd, args.timezone);
|
|
54
|
+
return args.edge === "start" ? dayStart : /* @__PURE__ */ new Date(addDaysInTz(dayStart, 1, args.timezone).getTime() - 1);
|
|
55
|
+
}
|
|
56
|
+
const datePart = DATE_TIME.exec(raw)?.[1];
|
|
57
|
+
if (datePart === void 0 || !calendarParts(datePart)) return null;
|
|
58
|
+
const parsed = new Date(raw);
|
|
59
|
+
return Number.isNaN(parsed.getTime()) ? null : parsed;
|
|
60
|
+
};
|
|
61
|
+
//#endregion
|
|
62
|
+
export { DATE_ONLY, parseDayOrInstant };
|
|
63
|
+
|
|
64
|
+
//# sourceMappingURL=dates.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dates.js","names":[],"sources":["../../src/query/dates.ts"],"sourcesContent":["import { addDaysInTz, startOfCalendarDayInTz } from '../timeframe/tz'\n\n/**\n * Range-bound parsing, shared by every surface that takes `from`/`to` from outside: the\n * query endpoint's parser, the document panel endpoint, and the widgets' stored custom\n * range. A leaf module so those cannot drift apart on what a calendar day means.\n */\n\n/** The only offset-free bound form: a `YYYY-MM-DD` calendar day. */\nexport const DATE_ONLY = /^\\d{4}-\\d{2}-\\d{2}$/\n\n// Fractional seconds run to nanoseconds because Python emits microseconds; `Date` truncates.\nconst DATE_TIME = /^(\\d{4}-\\d{2}-\\d{2})T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?([Zz]|[+-]\\d{2}:\\d{2})$/\n\nconst DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]\n\nconst isLeapYear = (year: number): boolean =>\n\t(year % 4 === 0 && year % 100 !== 0) || year % 400 === 0\n\n/** Calendar parts of a `YYYY-MM-DD` string, or null when it names no real day. */\nconst calendarParts = (raw: string): { year: number; month: number; day: number } | null => {\n\tconst year = Number(raw.slice(0, 4))\n\tconst month = Number(raw.slice(5, 7))\n\tconst day = Number(raw.slice(8, 10))\n\tif (month < 1 || month > 12) {\n\t\treturn null\n\t}\n\tconst lastDay = month === 2 && isLeapYear(year) ? 29 : DAYS_IN_MONTH[month - 1]\n\tif (lastDay === undefined || day < 1 || day > lastDay) {\n\t\treturn null\n\t}\n\treturn { year, month, day }\n}\n\nexport interface BoundArgs {\n\t/** Reporting timezone a day string is read in; ignored for an instant. */\n\ttimezone: string\n\t/** Which end of the window this value bounds. */\n\tedge: 'start' | 'end'\n}\n\n/**\n * A range bound. `YYYY-MM-DD` is the whole calendar day in `timezone`: the start edge is\n * its first instant, the end edge its last, matching the inclusive `end` every adapter\n * reads (`less_than_equal`, `timestamp <=`, GA4's inclusive `endDate`). The only other\n * accepted form is a full datetime carrying `Z` or a `±HH:MM` offset, taken as the instant\n * it names. A datetime without an offset is rejected rather than silently read in the\n * server's own zone, and so are the loose forms `Date` would otherwise accept (`2026`,\n * `Sep 1 2026`).\n */\nexport const parseDayOrInstant = (raw: string, args: BoundArgs): Date | null => {\n\tif (DATE_ONLY.test(raw)) {\n\t\tconst ymd = calendarParts(raw)\n\t\tif (!ymd) {\n\t\t\treturn null\n\t\t}\n\t\tconst dayStart = startOfCalendarDayInTz(ymd, args.timezone)\n\t\treturn args.edge === 'start'\n\t\t\t? dayStart\n\t\t\t: new Date(addDaysInTz(dayStart, 1, args.timezone).getTime() - 1)\n\t}\n\tconst datePart = DATE_TIME.exec(raw)?.[1]\n\tif (datePart === undefined || !calendarParts(datePart)) {\n\t\treturn null\n\t}\n\tconst parsed = new Date(raw)\n\treturn Number.isNaN(parsed.getTime()) ? null : parsed\n}\n"],"mappings":";;;;;;;;AASA,MAAa,YAAY;AAGzB,MAAM,YAAY;AAElB,MAAM,gBAAgB;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;AAAE;AAErE,MAAM,cAAc,SAClB,OAAO,MAAM,KAAK,OAAO,QAAQ,KAAM,OAAO,QAAQ;;AAGxD,MAAM,iBAAiB,QAAqE;CAC3F,MAAM,OAAO,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC;CACnC,MAAM,QAAQ,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC;CACpC,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC;CACnC,IAAI,QAAQ,KAAK,QAAQ,IACxB,OAAO;CAER,MAAM,UAAU,UAAU,KAAK,WAAW,IAAI,IAAI,KAAK,cAAc,QAAQ;CAC7E,IAAI,YAAY,KAAA,KAAa,MAAM,KAAK,MAAM,SAC7C,OAAO;CAER,OAAO;EAAE;EAAM;EAAO;CAAI;AAC3B;;;;;;;;;;AAkBA,MAAa,qBAAqB,KAAa,SAAiC;CAC/E,IAAI,UAAU,KAAK,GAAG,GAAG;EACxB,MAAM,MAAM,cAAc,GAAG;EAC7B,IAAI,CAAC,KACJ,OAAO;EAER,MAAM,WAAW,uBAAuB,KAAK,KAAK,QAAQ;EAC1D,OAAO,KAAK,SAAS,UAClB,2BACA,IAAI,KAAK,YAAY,UAAU,GAAG,KAAK,QAAQ,EAAE,QAAQ,IAAI,CAAC;CAClE;CACA,MAAM,WAAW,UAAU,KAAK,GAAG,IAAI;CACvC,IAAI,aAAa,KAAA,KAAa,CAAC,cAAc,QAAQ,GACpD,OAAO;CAER,MAAM,SAAS,IAAI,KAAK,GAAG;CAC3B,OAAO,OAAO,MAAM,OAAO,QAAQ,CAAC,IAAI,OAAO;AAChD"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
//#region src/query/errors.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* The query endpoint's whole error vocabulary. The parameter parser raises only the
|
|
4
|
+
* `400` codes; the handler raises the rest: `unauthorized` (`401`), `forbidden` (`403`,
|
|
5
|
+
* `access.read` or a cross-scope read the caller may not make), `unknown_source`
|
|
6
|
+
* (`404`), `untrusted_scope` (`400`), `unavailable` (`503`) and `internal` (`500`).
|
|
7
|
+
*/
|
|
8
|
+
type QueryErrorCode = 'invalid_param' | 'unsupported_metric' | 'unsupported_dimension' | 'unsupported_filter' | 'unsupported_operator' | 'unsupported_granularity' | 'range_too_long' | 'unknown_source' | 'untrusted_scope' | 'unauthorized' | 'forbidden' | 'unavailable' | 'internal';
|
|
9
|
+
/** Wire shape of a rejected read: `param` names the query parameter at fault. */
|
|
10
|
+
interface QueryError {
|
|
11
|
+
code: QueryErrorCode;
|
|
12
|
+
message: string;
|
|
13
|
+
param?: string;
|
|
14
|
+
}
|
|
15
|
+
//#endregion
|
|
16
|
+
export { QueryError, QueryErrorCode };
|
|
17
|
+
//# sourceMappingURL=errors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","names":[],"sources":["../../src/query/errors.ts"],"sourcesContent":["/**\n * The query endpoint's whole error vocabulary. The parameter parser raises only the\n * `400` codes; the handler raises the rest: `unauthorized` (`401`), `forbidden` (`403`,\n * `access.read` or a cross-scope read the caller may not make), `unknown_source`\n * (`404`), `untrusted_scope` (`400`), `unavailable` (`503`) and `internal` (`500`).\n */\nexport type QueryErrorCode =\n\t| 'invalid_param'\n\t| 'unsupported_metric'\n\t| 'unsupported_dimension'\n\t| 'unsupported_filter'\n\t| 'unsupported_operator'\n\t| 'unsupported_granularity'\n\t| 'range_too_long'\n\t| 'unknown_source'\n\t| 'untrusted_scope'\n\t| 'unauthorized'\n\t| 'forbidden'\n\t| 'unavailable'\n\t| 'internal'\n\n/** Wire shape of a rejected read: `param` names the query parameter at fault. */\nexport interface QueryError {\n\tcode: QueryErrorCode\n\tmessage: string\n\tparam?: string\n}\n\nexport const queryError = (code: QueryErrorCode, message: string, param?: string): QueryError => ({\n\tcode,\n\tmessage,\n\t...(param === undefined ? {} : { param }),\n})\n"],"mappings":";AA4BA,MAAa,cAAc,MAAsB,SAAiB,WAAgC;CACjG;CACA;CACA,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;AACxC"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from "../core/contract.js";
|
|
2
|
+
import { QueryError } from "./errors.js";
|
|
3
|
+
import { QueryResponse } from "./response.js";
|
|
4
|
+
|
|
5
|
+
//#region src/query/fetchQuery.d.ts
|
|
6
|
+
/** A client-side mirror of the parameters `parseQueryParams` reads off the request. */
|
|
7
|
+
interface QueryRequest {
|
|
8
|
+
metrics: MetricKey[];
|
|
9
|
+
dimensions?: DimensionKey[];
|
|
10
|
+
from: string;
|
|
11
|
+
to: string;
|
|
12
|
+
granularity?: Granularity;
|
|
13
|
+
filters?: AnalyticsFilter[];
|
|
14
|
+
limit?: number;
|
|
15
|
+
order?: {
|
|
16
|
+
metric: MetricKey;
|
|
17
|
+
direction: 'asc' | 'desc';
|
|
18
|
+
};
|
|
19
|
+
compare?: 'previous';
|
|
20
|
+
source?: string;
|
|
21
|
+
/**
|
|
22
|
+
* Read another scope's data. Platform readers only: the endpoint answers
|
|
23
|
+
* `400 untrusted_scope` for any caller that may not read across scopes.
|
|
24
|
+
*/
|
|
25
|
+
scope?: string;
|
|
26
|
+
path?: string;
|
|
27
|
+
hostname?: string;
|
|
28
|
+
timezone?: string;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Builds the query endpoint URL from a fixed field order (not object insertion order),
|
|
32
|
+
* so two `QueryRequest`s with the same values always produce the same URL string. That
|
|
33
|
+
* determinism is what `fetchQuery`'s in-flight dedupe keys on.
|
|
34
|
+
*/
|
|
35
|
+
declare const buildQueryUrl: (apiRoute: string, request: QueryRequest) => string;
|
|
36
|
+
/** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */
|
|
37
|
+
declare class QueryFetchError extends Error {
|
|
38
|
+
readonly status: number;
|
|
39
|
+
readonly error?: QueryError;
|
|
40
|
+
readonly retryAfter?: number;
|
|
41
|
+
constructor(status: number, error?: QueryError, retryAfter?: number);
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into
|
|
45
|
+
* one underlying fetch; the entry clears on settle (success or failure), so a later call
|
|
46
|
+
* always sees fresh data and a failed one retries instead of pinning the error.
|
|
47
|
+
*
|
|
48
|
+
* Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since
|
|
49
|
+
* aborting it would also cancel every other caller sharing that in-flight request.
|
|
50
|
+
* `init.signal` instead races the caller's own promise against the abort: aborting
|
|
51
|
+
* rejects that caller without touching the shared fetch. Use distinct requests (varying
|
|
52
|
+
* a param) when one caller's cancellation must actually stop the network call.
|
|
53
|
+
*/
|
|
54
|
+
declare const fetchQuery: (apiRoute: string, request: QueryRequest, init?: {
|
|
55
|
+
signal?: AbortSignal;
|
|
56
|
+
}) => Promise<QueryResponse>;
|
|
57
|
+
//#endregion
|
|
58
|
+
export { QueryFetchError, QueryRequest, buildQueryUrl, fetchQuery };
|
|
59
|
+
//# sourceMappingURL=fetchQuery.d.ts.map
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { QUERY_PATH } from "../plugin/paths.js";
|
|
2
|
+
//#region src/query/fetchQuery.ts
|
|
3
|
+
/**
|
|
4
|
+
* Builds the query endpoint URL from a fixed field order (not object insertion order),
|
|
5
|
+
* so two `QueryRequest`s with the same values always produce the same URL string. That
|
|
6
|
+
* determinism is what `fetchQuery`'s in-flight dedupe keys on.
|
|
7
|
+
*/
|
|
8
|
+
const buildQueryUrl = (apiRoute, request) => {
|
|
9
|
+
const params = new URLSearchParams();
|
|
10
|
+
params.set("metrics", request.metrics.join(","));
|
|
11
|
+
if (request.dimensions && request.dimensions.length > 0) params.set("dimensions", request.dimensions.join(","));
|
|
12
|
+
params.set("from", request.from);
|
|
13
|
+
params.set("to", request.to);
|
|
14
|
+
if (request.granularity !== void 0) params.set("granularity", request.granularity);
|
|
15
|
+
if (request.filters && request.filters.length > 0) params.set("filters", JSON.stringify(request.filters));
|
|
16
|
+
if (request.limit !== void 0) params.set("limit", String(request.limit));
|
|
17
|
+
if (request.order !== void 0) params.set("order", `${request.order.metric}:${request.order.direction}`);
|
|
18
|
+
if (request.compare !== void 0) params.set("compare", request.compare);
|
|
19
|
+
if (request.source !== void 0) params.set("source", request.source);
|
|
20
|
+
if (request.scope !== void 0) params.set("scope", request.scope);
|
|
21
|
+
if (request.path !== void 0) params.set("path", request.path);
|
|
22
|
+
if (request.hostname !== void 0) params.set("hostname", request.hostname);
|
|
23
|
+
if (request.timezone !== void 0) params.set("timezone", request.timezone);
|
|
24
|
+
return `${apiRoute.endsWith("/") ? apiRoute.slice(0, -1) : apiRoute}${QUERY_PATH}?${params.toString()}`;
|
|
25
|
+
};
|
|
26
|
+
const isRecord = (value) => typeof value === "object" && value !== null;
|
|
27
|
+
/**
|
|
28
|
+
* Only the query endpoint's structured body counts. The plugin's other read endpoints
|
|
29
|
+
* answer a flat `{ "error": "forbidden" }`, which must not land in `QueryFetchError.error`
|
|
30
|
+
* as a string where a `QueryError` is declared.
|
|
31
|
+
*/
|
|
32
|
+
const isQueryErrorResponse = (value) => {
|
|
33
|
+
if (!isRecord(value)) return false;
|
|
34
|
+
const error = value.error;
|
|
35
|
+
return isRecord(error) && typeof error.code === "string" && typeof error.message === "string";
|
|
36
|
+
};
|
|
37
|
+
/** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */
|
|
38
|
+
var QueryFetchError = class extends Error {
|
|
39
|
+
status;
|
|
40
|
+
error;
|
|
41
|
+
retryAfter;
|
|
42
|
+
constructor(status, error, retryAfter) {
|
|
43
|
+
super(error?.message ?? `analytics query request failed with status ${status}`);
|
|
44
|
+
this.name = "QueryFetchError";
|
|
45
|
+
this.status = status;
|
|
46
|
+
if (error !== void 0) this.error = error;
|
|
47
|
+
if (retryAfter !== void 0) this.retryAfter = retryAfter;
|
|
48
|
+
}
|
|
49
|
+
};
|
|
50
|
+
const readRetryAfter = (res) => {
|
|
51
|
+
const header = res.headers.get("Retry-After");
|
|
52
|
+
if (header === null) return void 0;
|
|
53
|
+
const seconds = Number(header);
|
|
54
|
+
return Number.isFinite(seconds) ? Math.floor(seconds) : void 0;
|
|
55
|
+
};
|
|
56
|
+
const runFetch = async (url) => {
|
|
57
|
+
const res = await fetch(url, {
|
|
58
|
+
credentials: "include",
|
|
59
|
+
headers: { Accept: "application/json" }
|
|
60
|
+
});
|
|
61
|
+
if (!res.ok) {
|
|
62
|
+
let error;
|
|
63
|
+
try {
|
|
64
|
+
const body = await res.json();
|
|
65
|
+
if (isQueryErrorResponse(body)) error = body.error;
|
|
66
|
+
} catch {}
|
|
67
|
+
throw new QueryFetchError(res.status, error, readRetryAfter(res));
|
|
68
|
+
}
|
|
69
|
+
return await res.json();
|
|
70
|
+
};
|
|
71
|
+
const inFlight = /* @__PURE__ */ new Map();
|
|
72
|
+
/**
|
|
73
|
+
* Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into
|
|
74
|
+
* one underlying fetch; the entry clears on settle (success or failure), so a later call
|
|
75
|
+
* always sees fresh data and a failed one retries instead of pinning the error.
|
|
76
|
+
*
|
|
77
|
+
* Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since
|
|
78
|
+
* aborting it would also cancel every other caller sharing that in-flight request.
|
|
79
|
+
* `init.signal` instead races the caller's own promise against the abort: aborting
|
|
80
|
+
* rejects that caller without touching the shared fetch. Use distinct requests (varying
|
|
81
|
+
* a param) when one caller's cancellation must actually stop the network call.
|
|
82
|
+
*/
|
|
83
|
+
const fetchQuery = (apiRoute, request, init) => {
|
|
84
|
+
const url = buildQueryUrl(apiRoute, request);
|
|
85
|
+
let pending = inFlight.get(url);
|
|
86
|
+
if (!pending) {
|
|
87
|
+
pending = runFetch(url).finally(() => {
|
|
88
|
+
inFlight.delete(url);
|
|
89
|
+
});
|
|
90
|
+
inFlight.set(url, pending);
|
|
91
|
+
}
|
|
92
|
+
const signal = init?.signal;
|
|
93
|
+
if (!signal) return pending;
|
|
94
|
+
if (signal.aborted) return Promise.reject(signal.reason);
|
|
95
|
+
return new Promise((resolve, reject) => {
|
|
96
|
+
const onAbort = () => reject(signal.reason);
|
|
97
|
+
signal.addEventListener("abort", onAbort, { once: true });
|
|
98
|
+
pending.then((value) => {
|
|
99
|
+
signal.removeEventListener("abort", onAbort);
|
|
100
|
+
resolve(value);
|
|
101
|
+
}, (err) => {
|
|
102
|
+
signal.removeEventListener("abort", onAbort);
|
|
103
|
+
reject(err);
|
|
104
|
+
});
|
|
105
|
+
});
|
|
106
|
+
};
|
|
107
|
+
//#endregion
|
|
108
|
+
export { QueryFetchError, buildQueryUrl, fetchQuery };
|
|
109
|
+
|
|
110
|
+
//# sourceMappingURL=fetchQuery.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fetchQuery.js","names":[],"sources":["../../src/query/fetchQuery.ts"],"sourcesContent":["import type { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from '../core/contract'\nimport { QUERY_PATH } from '../plugin/paths'\nimport type { QueryError } from './errors'\nimport type { QueryErrorResponse, QueryResponse } from './response'\n\n/** A client-side mirror of the parameters `parseQueryParams` reads off the request. */\nexport interface QueryRequest {\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfrom: string\n\tto: string\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\tcompare?: 'previous'\n\tsource?: string\n\t/**\n\t * Read another scope's data. Platform readers only: the endpoint answers\n\t * `400 untrusted_scope` for any caller that may not read across scopes.\n\t */\n\tscope?: string\n\tpath?: string\n\thostname?: string\n\ttimezone?: string\n}\n\n/**\n * Builds the query endpoint URL from a fixed field order (not object insertion order),\n * so two `QueryRequest`s with the same values always produce the same URL string. That\n * determinism is what `fetchQuery`'s in-flight dedupe keys on.\n */\nexport const buildQueryUrl = (apiRoute: string, request: QueryRequest): string => {\n\tconst params = new URLSearchParams()\n\tparams.set('metrics', request.metrics.join(','))\n\tif (request.dimensions && request.dimensions.length > 0) {\n\t\tparams.set('dimensions', request.dimensions.join(','))\n\t}\n\tparams.set('from', request.from)\n\tparams.set('to', request.to)\n\tif (request.granularity !== undefined) {\n\t\tparams.set('granularity', request.granularity)\n\t}\n\tif (request.filters && request.filters.length > 0) {\n\t\tparams.set('filters', JSON.stringify(request.filters))\n\t}\n\tif (request.limit !== undefined) {\n\t\tparams.set('limit', String(request.limit))\n\t}\n\tif (request.order !== undefined) {\n\t\tparams.set('order', `${request.order.metric}:${request.order.direction}`)\n\t}\n\tif (request.compare !== undefined) {\n\t\tparams.set('compare', request.compare)\n\t}\n\tif (request.source !== undefined) {\n\t\tparams.set('source', request.source)\n\t}\n\tif (request.scope !== undefined) {\n\t\tparams.set('scope', request.scope)\n\t}\n\tif (request.path !== undefined) {\n\t\tparams.set('path', request.path)\n\t}\n\tif (request.hostname !== undefined) {\n\t\tparams.set('hostname', request.hostname)\n\t}\n\tif (request.timezone !== undefined) {\n\t\tparams.set('timezone', request.timezone)\n\t}\n\tconst base = apiRoute.endsWith('/') ? apiRoute.slice(0, -1) : apiRoute\n\treturn `${base}${QUERY_PATH}?${params.toString()}`\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null\n\n/**\n * Only the query endpoint's structured body counts. The plugin's other read endpoints\n * answer a flat `{ \"error\": \"forbidden\" }`, which must not land in `QueryFetchError.error`\n * as a string where a `QueryError` is declared.\n */\nconst isQueryErrorResponse = (value: unknown): value is QueryErrorResponse => {\n\tif (!isRecord(value)) return false\n\tconst error = value.error\n\treturn isRecord(error) && typeof error.code === 'string' && typeof error.message === 'string'\n}\n\n/** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */\nexport class QueryFetchError extends Error {\n\treadonly status: number\n\treadonly error?: QueryError\n\treadonly retryAfter?: number\n\n\tconstructor(status: number, error?: QueryError, retryAfter?: number) {\n\t\tsuper(error?.message ?? `analytics query request failed with status ${status}`)\n\t\tthis.name = 'QueryFetchError'\n\t\tthis.status = status\n\t\tif (error !== undefined) this.error = error\n\t\tif (retryAfter !== undefined) this.retryAfter = retryAfter\n\t}\n}\n\nconst readRetryAfter = (res: Response): number | undefined => {\n\tconst header = res.headers.get('Retry-After')\n\tif (header === null) return undefined\n\t// The HTTP-date form is not a number, so it yields no delay rather than a bogus one;\n\t// a fractional delay floors, since callers schedule in whole seconds.\n\tconst seconds = Number(header)\n\treturn Number.isFinite(seconds) ? Math.floor(seconds) : undefined\n}\n\nconst runFetch = async (url: string): Promise<QueryResponse> => {\n\tconst res = await fetch(url, {\n\t\tcredentials: 'include',\n\t\theaders: { Accept: 'application/json' },\n\t})\n\tif (!res.ok) {\n\t\tlet error: QueryError | undefined\n\t\ttry {\n\t\t\tconst body: unknown = await res.json()\n\t\t\tif (isQueryErrorResponse(body)) error = body.error\n\t\t} catch {\n\t\t\t// Body wasn't JSON; error stays undefined and the status still carries the failure.\n\t\t}\n\t\tthrow new QueryFetchError(res.status, error, readRetryAfter(res))\n\t}\n\treturn (await res.json()) as QueryResponse\n}\n\nconst inFlight = new Map<string, Promise<QueryResponse>>()\n\n/**\n * Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into\n * one underlying fetch; the entry clears on settle (success or failure), so a later call\n * always sees fresh data and a failed one retries instead of pinning the error.\n *\n * Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since\n * aborting it would also cancel every other caller sharing that in-flight request.\n * `init.signal` instead races the caller's own promise against the abort: aborting\n * rejects that caller without touching the shared fetch. Use distinct requests (varying\n * a param) when one caller's cancellation must actually stop the network call.\n */\nexport const fetchQuery = (\n\tapiRoute: string,\n\trequest: QueryRequest,\n\tinit?: { signal?: AbortSignal }\n): Promise<QueryResponse> => {\n\tconst url = buildQueryUrl(apiRoute, request)\n\tlet pending = inFlight.get(url)\n\tif (!pending) {\n\t\tpending = runFetch(url).finally(() => {\n\t\t\tinFlight.delete(url)\n\t\t})\n\t\tinFlight.set(url, pending)\n\t}\n\n\tconst signal = init?.signal\n\tif (!signal) return pending\n\tif (signal.aborted) return Promise.reject(signal.reason)\n\n\treturn new Promise<QueryResponse>((resolve, reject) => {\n\t\tconst onAbort = () => reject(signal.reason)\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t\tpending.then(\n\t\t\t(value) => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\tresolve(value)\n\t\t\t},\n\t\t\t(err: unknown) => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\treject(err)\n\t\t\t}\n\t\t)\n\t})\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { AnalyticsQuery } from "../core/contract.js";
|
|
2
|
+
import { QueryError } from "./errors.js";
|
|
3
|
+
|
|
4
|
+
//#region src/query/parse.d.ts
|
|
5
|
+
/**
|
|
6
|
+
* A validated read request. `source` and `scope` are absent by design: the handler must
|
|
7
|
+
* resolve both before the parser can run, and reads them itself through {@link readParam}.
|
|
8
|
+
*/
|
|
9
|
+
interface ParsedQuery {
|
|
10
|
+
query: AnalyticsQuery;
|
|
11
|
+
compare: 'previous' | null;
|
|
12
|
+
}
|
|
13
|
+
type ParseResult = {
|
|
14
|
+
ok: true;
|
|
15
|
+
value: ParsedQuery;
|
|
16
|
+
} | {
|
|
17
|
+
ok: false;
|
|
18
|
+
error: QueryError;
|
|
19
|
+
};
|
|
20
|
+
//#endregion
|
|
21
|
+
export { ParseResult, ParsedQuery };
|
|
22
|
+
//# sourceMappingURL=parse.d.ts.map
|