@10x-media/analytics 1.0.0-beta.16 → 1.0.0-beta.17

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.
Files changed (157) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/dist/adapters/ga4/ga4.js +33 -2
  3. package/dist/adapters/ga4/ga4.js.map +1 -1
  4. package/dist/adapters/ga4/measurementId.js +4 -1
  5. package/dist/adapters/ga4/measurementId.js.map +1 -1
  6. package/dist/adapters/ga4/propertyId.js +17 -0
  7. package/dist/adapters/ga4/propertyId.js.map +1 -0
  8. package/dist/adapters/http/fetchJson.js +24 -1
  9. package/dist/adapters/http/fetchJson.js.map +1 -1
  10. package/dist/adapters/plausible/plausible.js +16 -1
  11. package/dist/adapters/plausible/plausible.js.map +1 -1
  12. package/dist/adapters/plausible/siteId.js +31 -0
  13. package/dist/adapters/plausible/siteId.js.map +1 -0
  14. package/dist/adapters/posthog/posthog.js +17 -3
  15. package/dist/adapters/posthog/posthog.js.map +1 -1
  16. package/dist/adapters/umami/umami.js +34 -7
  17. package/dist/adapters/umami/umami.js.map +1 -1
  18. package/dist/charts/series.js +1 -1
  19. package/dist/core/contract.d.ts +16 -1
  20. package/dist/core/contract.js.map +1 -1
  21. package/dist/core/options.d.ts +1 -1
  22. package/dist/core/options.js +1 -1
  23. package/dist/core/options.js.map +1 -1
  24. package/dist/core/scopedRead.js +62 -14
  25. package/dist/core/scopedRead.js.map +1 -1
  26. package/dist/core/sourceErrors.js +12 -1
  27. package/dist/core/sourceErrors.js.map +1 -1
  28. package/dist/core/sourceOptions.js +1 -1
  29. package/dist/core/sourceOptions.js.map +1 -1
  30. package/dist/core/sourcePolicy.d.ts +8 -1
  31. package/dist/core/sourcePolicy.js.map +1 -1
  32. package/dist/core/throttle.js +3 -1
  33. package/dist/core/throttle.js.map +1 -1
  34. package/dist/exports/adapters/contract.d.ts +1 -1
  35. package/dist/exports/adapters/ga4.d.ts +2 -2
  36. package/dist/exports/adapters/native.d.ts +2 -2
  37. package/dist/exports/adapters/plausible.d.ts +2 -2
  38. package/dist/exports/adapters/posthog.d.ts +2 -2
  39. package/dist/exports/adapters/umami.d.ts +2 -2
  40. package/dist/exports/client.d.ts +3 -1
  41. package/dist/exports/client.js +3 -1
  42. package/dist/exports/next.d.ts +2 -2
  43. package/dist/exports/testing.d.ts +2 -2
  44. package/dist/exports/types.d.ts +3 -3
  45. package/dist/fields/config/fetchSources.js +1 -1
  46. package/dist/fields/config/fetchSources.js.map +1 -1
  47. package/dist/goals/collection.js +3 -2
  48. package/dist/goals/collection.js.map +1 -1
  49. package/dist/goals/resolver.js +1 -1
  50. package/dist/index.d.ts +4 -3
  51. package/dist/index.js +50 -4
  52. package/dist/index.js.map +1 -1
  53. package/dist/native/geo/maxmindResolver.js +1 -1
  54. package/dist/native/nativeAdapter.js +1 -1
  55. package/dist/plugin/createRuntime.js +57 -13
  56. package/dist/plugin/createRuntime.js.map +1 -1
  57. package/dist/plugin/pluginCollections.js +4 -1
  58. package/dist/plugin/pluginCollections.js.map +1 -1
  59. package/dist/plugin/providerStatusEndpoint.js +80 -0
  60. package/dist/plugin/providerStatusEndpoint.js.map +1 -0
  61. package/dist/plugin/queryEndpoint.js +1 -1
  62. package/dist/plugin/queryEndpoint.js.map +1 -1
  63. package/dist/plugin/readContextForRequest.d.ts +4 -3
  64. package/dist/plugin/readContextForRequest.js +2 -2
  65. package/dist/plugin/readContextForRequest.js.map +1 -1
  66. package/dist/plugin/refreshEndpoint.js +1 -1
  67. package/dist/plugin/routes.d.ts +5 -0
  68. package/dist/plugin/routes.js +1 -0
  69. package/dist/plugin/routes.js.map +1 -1
  70. package/dist/plugin/runtime.js.map +1 -1
  71. package/dist/providers/ProviderConnection.d.ts +12 -0
  72. package/dist/providers/ProviderConnection.js +105 -0
  73. package/dist/providers/ProviderConnection.js.map +1 -0
  74. package/dist/providers/ProviderConnectionTest.d.ts +12 -0
  75. package/dist/providers/ProviderConnectionTest.js +55 -0
  76. package/dist/providers/ProviderConnectionTest.js.map +1 -0
  77. package/dist/providers/ProvidersListNotice.d.ts +1 -1
  78. package/dist/providers/ProvidersListNotice.js +3 -2
  79. package/dist/providers/ProvidersListNotice.js.map +1 -1
  80. package/dist/providers/collection.d.ts +1 -1
  81. package/dist/providers/collection.js +97 -38
  82. package/dist/providers/collection.js.map +1 -1
  83. package/dist/providers/connectionCheck.d.ts +1 -0
  84. package/dist/providers/connectionCheck.js +80 -0
  85. package/dist/providers/connectionCheck.js.map +1 -0
  86. package/dist/providers/connectionState.js +53 -0
  87. package/dist/providers/connectionState.js.map +1 -0
  88. package/dist/providers/factory.d.ts +1 -3
  89. package/dist/providers/factory.js +18 -21
  90. package/dist/providers/factory.js.map +1 -1
  91. package/dist/providers/hosts.js +20 -6
  92. package/dist/providers/hosts.js.map +1 -1
  93. package/dist/providers/ids.d.ts +6 -0
  94. package/dist/providers/ids.js +32 -0
  95. package/dist/providers/ids.js.map +1 -0
  96. package/dist/providers/providerStatusClient.js +60 -0
  97. package/dist/providers/providerStatusClient.js.map +1 -0
  98. package/dist/providers/registry.js +56 -20
  99. package/dist/providers/registry.js.map +1 -1
  100. package/dist/providers/retarget.js +39 -8
  101. package/dist/providers/retarget.js.map +1 -1
  102. package/dist/providers/secrets.d.ts +1 -1
  103. package/dist/providers/secrets.js.map +1 -1
  104. package/dist/providers/status.d.ts +1 -0
  105. package/dist/providers/status.js +181 -0
  106. package/dist/providers/status.js.map +1 -0
  107. package/dist/surfacing/classifyError.js +37 -5
  108. package/dist/surfacing/classifyError.js.map +1 -1
  109. package/dist/surfacing/engine.js +2 -2
  110. package/dist/surfacing/engine.js.map +1 -1
  111. package/dist/surfacing/lanes.js +29 -22
  112. package/dist/surfacing/lanes.js.map +1 -1
  113. package/dist/surfacing/rebucket.js +1 -1
  114. package/dist/testing/settle.d.ts +2 -1
  115. package/dist/testing/settle.js +6 -2
  116. package/dist/testing/settle.js.map +1 -1
  117. package/dist/tracker/sinks/ga4.js +2 -2
  118. package/dist/translations/ar.js +40 -8
  119. package/dist/translations/ar.js.map +1 -1
  120. package/dist/translations/de.js +40 -8
  121. package/dist/translations/de.js.map +1 -1
  122. package/dist/translations/en.js +40 -8
  123. package/dist/translations/en.js.map +1 -1
  124. package/dist/translations/es.js +40 -8
  125. package/dist/translations/es.js.map +1 -1
  126. package/dist/translations/fr.js +40 -8
  127. package/dist/translations/fr.js.map +1 -1
  128. package/dist/translations/id.js +40 -8
  129. package/dist/translations/id.js.map +1 -1
  130. package/dist/translations/keys.d.ts +32 -0
  131. package/dist/translations/keys.js +32 -0
  132. package/dist/translations/keys.js.map +1 -1
  133. package/dist/translations/ko.js +40 -8
  134. package/dist/translations/ko.js.map +1 -1
  135. package/dist/translations/pt.js +40 -8
  136. package/dist/translations/pt.js.map +1 -1
  137. package/dist/translations/ru.js +40 -8
  138. package/dist/translations/ru.js.map +1 -1
  139. package/dist/translations/uk.js +40 -8
  140. package/dist/translations/uk.js.map +1 -1
  141. package/dist/translations/zh.js +40 -8
  142. package/dist/translations/zh.js.map +1 -1
  143. package/dist/ui/analytics.css +63 -0
  144. package/dist/ui/components/SourcesNoticeBanner.js +4 -3
  145. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -1
  146. package/dist/view/ViewSections.js +9 -2
  147. package/dist/view/ViewSections.js.map +1 -1
  148. package/dist/view/sections/EmptyStates.js +5 -4
  149. package/dist/view/sections/EmptyStates.js.map +1 -1
  150. package/dist/view/sections/OverviewCards.js +6 -2
  151. package/dist/view/sections/OverviewCards.js.map +1 -1
  152. package/dist/view/sections/SourceConnectionNote.js +56 -0
  153. package/dist/view/sections/SourceConnectionNote.js.map +1 -0
  154. package/dist/view/viewProps.d.ts +2 -0
  155. package/dist/view/viewProps.js +2 -1
  156. package/dist/view/viewProps.js.map +1 -1
  157. package/package.json +1 -1
@@ -4,9 +4,9 @@ import { currentTime } from "../core/clock.js";
4
4
  import { recall, remember } from "../surfacing/bounded.js";
5
5
  import { createEpochFallback } from "../surfacing/epoch.js";
6
6
  import { asTranslate } from "../translations/server.js";
7
- import { GOAL_SLUG_PATTERN } from "./types.js";
8
7
  import { isCollectionSlug } from "../core/collectionSlug.js";
9
8
  import { PROBE_MEMO_MS, createCollectionProbe } from "../providers/probe.js";
9
+ import { GOAL_SLUG_PATTERN } from "./types.js";
10
10
  import "./constants.js";
11
11
  import { builtinPurchaseGoal } from "./builtin.js";
12
12
  //#region src/goals/resolver.ts
package/dist/index.d.ts CHANGED
@@ -15,7 +15,7 @@ import { AnalyticsAttributes } from "./exports/attributes.js";
15
15
  import { ItemSignatureMode, itemAttributesFor, signItemRef } from "./native/ingest/itemSignature.js";
16
16
  import { RawEventInput } from "./native/ingest/normalizeEvent.js";
17
17
  import { AnalyticsTrackError, IngestHostnameResolver, ServerEventInput, ServerTrack, ServerTrackIdentity, ServerTrackOptions } from "./core/serverEvent.js";
18
- import { AdapterContext, AdapterLabelArgs, AdapterRegisterContext, AdapterSchemaContext, AnalyticsAdapter, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DIMENSION_KEYS, DateRange, DimensionKey, FILTER_OPERATORS, FilterOperator, FilterOperatorMap, Granularity, MetricKey, MetricReach, MetricSemantics, MetricValue, MetricValues, PLATFORM_SCOPE, RateLimitDescriptor, SourceErrorKind, VisitorCounting } from "./core/contract.js";
18
+ import { AdapterContext, AdapterLabelArgs, AdapterRegisterContext, AdapterSchemaContext, AnalyticsAdapter, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, ConnectionCheckContext, DIMENSION_KEYS, DateRange, DimensionKey, FILTER_OPERATORS, FilterOperator, FilterOperatorMap, Granularity, MetricKey, MetricReach, MetricSemantics, MetricValue, MetricValues, PLATFORM_SCOPE, RateLimitDescriptor, SourceErrorKind, VisitorCounting } from "./core/contract.js";
19
19
  import { AnalyticsSourceOptions, DefaultSourceFunction, DefaultSourceRule, OwnSource, SourcePolicy, SourcePolicyFunction, SourceRef } from "./core/sourcePolicy.js";
20
20
  import { AdapterLabelOption } from "./core/sourceLabel.js";
21
21
  import { STATE_SLUG } from "./native/collections/slugs.js";
@@ -31,7 +31,7 @@ import { PluralCategory, PluralName, PluralVariant, SingularKey, TranslationKey,
31
31
  import { TranslationsOption } from "./translations/index.js";
32
32
  import { GOALS_SLUG, GoalCollectionFieldOverrides, GoalFieldOverride } from "./goals/collection.js";
33
33
  import { HostPattern, ProviderHostPolicy, resolveHostPolicy } from "./providers/hosts.js";
34
- import { PROVIDER_IDS, ProviderDoc, ProviderFactoryContext, ProviderId, adapterFromProviderDoc } from "./providers/factory.js";
34
+ import { PROVIDER_IDS, ProviderId } from "./providers/ids.js";
35
35
  import { BuildSecretField, ConnectionAccess, ConnectionFieldAccess, PROVIDERS_SLUG, ProviderCollectionFieldOverrides, ProviderFieldOverride, ProviderFieldsOptions, analyticsProviderFields } from "./providers/collection.js";
36
36
  import { AfterReadAnswer, AfterReadArgs, AfterReadHook, ReadOrigin } from "./surfacing/afterRead.js";
37
37
  import { TIMEFRAME_PRESETS, TimeframePreset } from "./timeframe/presets.js";
@@ -64,6 +64,7 @@ import { signOrderId } from "./native/ingest/orderSignature.js";
64
64
  import { trackServerEvent } from "./native/ingest/serverTrack.js";
65
65
  import { rebuildDays } from "./native/rebuildDays.js";
66
66
  import { GuardedFetch, GuardedFetchOptions, createGuardedFetch } from "./net/guardedFetch.js";
67
+ import { ProviderDoc, ProviderFactoryContext, adapterFromProviderDoc } from "./providers/factory.js";
67
68
  import { RefreshProvidersOptions, refreshProviders } from "./providers/refresh.js";
68
69
  import { CONNECTION_PATHS, SECRET_PATHS } from "./providers/secrets.js";
69
70
  import { CACHE_SLUG } from "./surfacing/cacheCollection.js";
@@ -80,5 +81,5 @@ declare module 'payload' {
80
81
  }
81
82
  declare const analytics: (options: AnalyticsPluginOptions) => import("payload").Plugin;
82
83
  //#endregion
83
- export { ANALYTICS_ERROR_CODES, type AdapterContext, type AdapterJobs, type AdapterLabelArgs, type AdapterLabelOption, type AdapterRegisterContext, type AdapterSchemaContext, type AfterReadAnswer, type AfterReadArgs, type AfterReadHook, type AnalyticsAccessOptions, type AnalyticsAdapter, type AnalyticsAttributes, type AnalyticsBinding, type AnalyticsCacheCollectionOptions, type AnalyticsCacheOptions, type AnalyticsCapabilities, type AnalyticsCaptureOptions, type AnalyticsCollectionOptions, type AnalyticsComponent, type AnalyticsConcurrencyOptions, type AnalyticsCountryFlags, type AnalyticsCrossScopeOptions, type AnalyticsDefaultLayoutOptions, type AnalyticsError, type AnalyticsErrorCode, type AnalyticsExclusionOptions, type AnalyticsFieldsOptions, type AnalyticsFilter, type AnalyticsGoalsCollectionOptions, type AnalyticsGoalsOptions, type AnalyticsHooksOptions, type AnalyticsJobsOptions, type AnalyticsLinkFieldsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsQuery, type AnalyticsReadAccess, type AnalyticsResult, type AnalyticsRevenueOptions, type AnalyticsRoutesOptions, type AnalyticsRow, type AnalyticsScopeOptions, type AnalyticsSdks, type AnalyticsSourceOptions, type AnalyticsStatBaseOptions, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsSyncCollectionOptions, type AnalyticsSyncOptions, type AnalyticsTabOptions, type AnalyticsTaskName, type AnalyticsTaskOptions, AnalyticsTrackError, type AnalyticsViewAccess, type AnalyticsViewOptions, type AnalyticsWarmOptions, type AnalyticsWidgetOverride, type AnalyticsWidgetOverrides, type AnalyticsWidgetsOptions, type AutoCaptureOptions, BUILT_IN_WIDGET_SLUGS, type BindingContext, type BindingDoc, type BreakdownRow, type BrowserAmounts, type BuildSecretField, type BuiltInWidgetSlug, CACHE_SLUG, CONNECTION_PATHS, CURRENCY_ATTRIBUTE, type CacheEntry, type CacheSetOptions, type CacheStore, type CapabilityRequirement, type CaptureClientKind, type CaptureGate, type CaptureGateArgs, type CaptureSlot, type CaptureSlotOption, type CaptureSnippet, type CaptureSupport, type CollectionFieldOverride, type CollectionOverrides, type ConnectionAccess, type ConnectionFieldAccess, type ConsentPhase, type CookielessSupport, type CrossScopeAccess, type CurrencyConverter, type CurrencyResolver, type CustomWidgetDef, DEFAULT_ROUTE_BASE, type DIMENSION_KEYS, type DateRange, type DefaultSourceFunction, type DefaultSourceRule, type DimensionKey, EVENT_ATTRIBUTE, EVENT_PROP_PREFIX, type ExclusionSitesResolver, type FILTER_OPERATORS, type FetchInit, type FetchLike, type FieldBreakdown, type FieldBreakdownRow, type FieldReadResult, type FieldReadStatus, type FilterOperator, type FilterOperatorMap, type FilterPair, GOALS_SLUG, GOAL_ACTION_TYPE, GOAL_ATTRIBUTE, type Ga4Client, type Ga4ClientOptions, type Ga4ReportResponse, type Ga4ReportRow, type Ga4Sdk, type GatedScope, type Goal, type GoalActionDefinition, type GoalActionRunArgs, type GoalCollectionFieldOverrides, type GoalFieldOptions, type GoalFieldOverride, type GoalMatch, type GoalRow, type GoalSource, type GoalsResponse, type Granularity, type GuardedFetch, type GuardedFetchOptions, type HeldSlotMode, type HitMode, type HitType, type HostPattern, type HostnameResolver, ITEM_ATTRIBUTE, ITEM_CLICK_EVENT, ITEM_NAME_ATTRIBUTE, type IngestHostnameResolver, type ItemCaptureOptions, type ItemLabels, type ItemSignatureMode, MAX_ITEMS_PER_BEACON, type MaxmindReader, type MaxmindSdk, type MetricKey, type MetricReach, type MetricSemantics, type MetricValue, type MetricValues, type OrderSignatureMode, type OwnSource, PLATFORM_SCOPE, PROVIDERS_SLUG, PROVIDER_IDS, PURCHASE_GOAL_SLUG, type PathResolver, type AnalyticsPluginOptions as PluginOptions, type PluralCategory, type PluralName, type PluralVariant, type ProviderCollectionFieldOverrides, type ProviderDoc, type ProviderFactoryContext, type ProviderFieldOverride, type ProviderFieldsOptions, type ProviderHostPolicy, type ProviderHostsOptions, ProviderHttpError, type ProviderId, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type ProvidersResolveArgs, type ProxyDescriptor, type ProxyRoute, type ProxyRouteKind, type QueryError, type QueryErrorCode, type QueryErrorResponse, type QueryResponse, type QuerySourceRef, type RateLimitDescriptor, type RawEventInput, type ReadForFieldArgs, type ReadForWidgetArgs, type ReadForWidgetBreakdownArgs, type ReadForWidgetGoalsArgs, type ReadForWidgetRealtimeArgs, type ReadForWidgetSeriesArgs, type ReadNotices, type ReadOrigin, type ReadPrincipal, type ReadRecipe, type RealtimePoint, type RebuildDaysInput, type RebuildDaysReport, type RecipeWindow, type RefreshProvidersOptions, type ReportMode, type ReportOption, type RevenueItem, type RouteBase, type RoutePaths, type RoutesConfigSource, SECRET_PATHS, STATE_SLUG, SYNC_SLUG, SYSTEM, type ScheduledTask, type ScopeCallSite, type ScopeLabelResolver, type ScopeListResolver, type ScopeMemberAccess, type ScopeResolver, type SerializedAnalyticsQuery, type SerializedCapabilities, type SeriesGranularity, type SeriesPoint, type ServerEventInput, type PurchaseInput as ServerPurchaseInput, type RefundInput as ServerRefundInput, type ServerTrack, type ServerTrackIdentity, type ServerTrackOptions, type SingularKey, type SlotMode, type SlotWithoutConsent, type SnippetArgs, type SnippetMode, type SnippetScript, type SourceErrorKind, type SourcePolicy, type SourcePolicyFunction, type SourceRef, type StoredSourceRead, type SubstitutedSource, type TASK_NAMES, TIMEFRAME_PRESETS, type TenantMembershipOptions, type TimeframePreset, type TimezoneResolver, type TrackGoalActionOptions, type TrackerGoal, type TrackerSlotConfig, type TranslationKey, type TranslationsOption, type TrustedPlatform, VALUE_ATTRIBUTE, type VisitorCounting, type WidgetBreakdownResult, type WidgetFilter, type WidgetGoalsResult, type WidgetReadResult, type WidgetReadStatus, type WidgetRealtimeResult, type WidgetRealtimeStatus, type WidgetSeriesResult, type WireGoal, type WithoutConsentArgs, type WithoutConsentFunction, type WithoutConsentLevel, type WithoutConsentOption, adapterFromProviderDoc, analytics, analyticsDefaultLayout, analyticsDefaultWidgets, analyticsError, analyticsFields, analyticsLinkFields, analyticsProviderFields, analyticsRoutes, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, createGuardedFetch, goalField, goalSlug, isAdminUser, itemAttributesFor, keys, parseRetryAfter, pluralKeys, purchase, readErrorCode, readForField, readForWidget, readForWidgetBreakdown, readForWidgetGoals, readForWidgetRealtime, readForWidgetSeries, rebuildDays, refreshProviders, refund, resolveHostPolicy, routePaths, signItemRef, signOrderId, tenantMembership, trackGoalAction, trackServerEvent, widgetFilters };
84
+ export { ANALYTICS_ERROR_CODES, type AdapterContext, type AdapterJobs, type AdapterLabelArgs, type AdapterLabelOption, type AdapterRegisterContext, type AdapterSchemaContext, type AfterReadAnswer, type AfterReadArgs, type AfterReadHook, type AnalyticsAccessOptions, type AnalyticsAdapter, type AnalyticsAttributes, type AnalyticsBinding, type AnalyticsCacheCollectionOptions, type AnalyticsCacheOptions, type AnalyticsCapabilities, type AnalyticsCaptureOptions, type AnalyticsCollectionOptions, type AnalyticsComponent, type AnalyticsConcurrencyOptions, type AnalyticsCountryFlags, type AnalyticsCrossScopeOptions, type AnalyticsDefaultLayoutOptions, type AnalyticsError, type AnalyticsErrorCode, type AnalyticsExclusionOptions, type AnalyticsFieldsOptions, type AnalyticsFilter, type AnalyticsGoalsCollectionOptions, type AnalyticsGoalsOptions, type AnalyticsHooksOptions, type AnalyticsJobsOptions, type AnalyticsLinkFieldsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsQuery, type AnalyticsReadAccess, type AnalyticsResult, type AnalyticsRevenueOptions, type AnalyticsRoutesOptions, type AnalyticsRow, type AnalyticsScopeOptions, type AnalyticsSdks, type AnalyticsSourceOptions, type AnalyticsStatBaseOptions, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsSyncCollectionOptions, type AnalyticsSyncOptions, type AnalyticsTabOptions, type AnalyticsTaskName, type AnalyticsTaskOptions, AnalyticsTrackError, type AnalyticsViewAccess, type AnalyticsViewOptions, type AnalyticsWarmOptions, type AnalyticsWidgetOverride, type AnalyticsWidgetOverrides, type AnalyticsWidgetsOptions, type AutoCaptureOptions, BUILT_IN_WIDGET_SLUGS, type BindingContext, type BindingDoc, type BreakdownRow, type BrowserAmounts, type BuildSecretField, type BuiltInWidgetSlug, CACHE_SLUG, CONNECTION_PATHS, CURRENCY_ATTRIBUTE, type CacheEntry, type CacheSetOptions, type CacheStore, type CapabilityRequirement, type CaptureClientKind, type CaptureGate, type CaptureGateArgs, type CaptureSlot, type CaptureSlotOption, type CaptureSnippet, type CaptureSupport, type CollectionFieldOverride, type CollectionOverrides, type ConnectionAccess, type ConnectionCheckContext, type ConnectionFieldAccess, type ConsentPhase, type CookielessSupport, type CrossScopeAccess, type CurrencyConverter, type CurrencyResolver, type CustomWidgetDef, DEFAULT_ROUTE_BASE, type DIMENSION_KEYS, type DateRange, type DefaultSourceFunction, type DefaultSourceRule, type DimensionKey, EVENT_ATTRIBUTE, EVENT_PROP_PREFIX, type ExclusionSitesResolver, type FILTER_OPERATORS, type FetchInit, type FetchLike, type FieldBreakdown, type FieldBreakdownRow, type FieldReadResult, type FieldReadStatus, type FilterOperator, type FilterOperatorMap, type FilterPair, GOALS_SLUG, GOAL_ACTION_TYPE, GOAL_ATTRIBUTE, type Ga4Client, type Ga4ClientOptions, type Ga4ReportResponse, type Ga4ReportRow, type Ga4Sdk, type GatedScope, type Goal, type GoalActionDefinition, type GoalActionRunArgs, type GoalCollectionFieldOverrides, type GoalFieldOptions, type GoalFieldOverride, type GoalMatch, type GoalRow, type GoalSource, type GoalsResponse, type Granularity, type GuardedFetch, type GuardedFetchOptions, type HeldSlotMode, type HitMode, type HitType, type HostPattern, type HostnameResolver, ITEM_ATTRIBUTE, ITEM_CLICK_EVENT, ITEM_NAME_ATTRIBUTE, type IngestHostnameResolver, type ItemCaptureOptions, type ItemLabels, type ItemSignatureMode, MAX_ITEMS_PER_BEACON, type MaxmindReader, type MaxmindSdk, type MetricKey, type MetricReach, type MetricSemantics, type MetricValue, type MetricValues, type OrderSignatureMode, type OwnSource, PLATFORM_SCOPE, PROVIDERS_SLUG, PROVIDER_IDS, PURCHASE_GOAL_SLUG, type PathResolver, type AnalyticsPluginOptions as PluginOptions, type PluralCategory, type PluralName, type PluralVariant, type ProviderCollectionFieldOverrides, type ProviderDoc, type ProviderFactoryContext, type ProviderFieldOverride, type ProviderFieldsOptions, type ProviderHostPolicy, type ProviderHostsOptions, ProviderHttpError, type ProviderId, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type ProvidersResolveArgs, type ProxyDescriptor, type ProxyRoute, type ProxyRouteKind, type QueryError, type QueryErrorCode, type QueryErrorResponse, type QueryResponse, type QuerySourceRef, type RateLimitDescriptor, type RawEventInput, type ReadForFieldArgs, type ReadForWidgetArgs, type ReadForWidgetBreakdownArgs, type ReadForWidgetGoalsArgs, type ReadForWidgetRealtimeArgs, type ReadForWidgetSeriesArgs, type ReadNotices, type ReadOrigin, type ReadPrincipal, type ReadRecipe, type RealtimePoint, type RebuildDaysInput, type RebuildDaysReport, type RecipeWindow, type RefreshProvidersOptions, type ReportMode, type ReportOption, type RevenueItem, type RouteBase, type RoutePaths, type RoutesConfigSource, SECRET_PATHS, STATE_SLUG, SYNC_SLUG, SYSTEM, type ScheduledTask, type ScopeCallSite, type ScopeLabelResolver, type ScopeListResolver, type ScopeMemberAccess, type ScopeResolver, type SerializedAnalyticsQuery, type SerializedCapabilities, type SeriesGranularity, type SeriesPoint, type ServerEventInput, type PurchaseInput as ServerPurchaseInput, type RefundInput as ServerRefundInput, type ServerTrack, type ServerTrackIdentity, type ServerTrackOptions, type SingularKey, type SlotMode, type SlotWithoutConsent, type SnippetArgs, type SnippetMode, type SnippetScript, type SourceErrorKind, type SourcePolicy, type SourcePolicyFunction, type SourceRef, type StoredSourceRead, type SubstitutedSource, type TASK_NAMES, TIMEFRAME_PRESETS, type TenantMembershipOptions, type TimeframePreset, type TimezoneResolver, type TrackGoalActionOptions, type TrackerGoal, type TrackerSlotConfig, type TranslationKey, type TranslationsOption, type TrustedPlatform, VALUE_ATTRIBUTE, type VisitorCounting, type WidgetBreakdownResult, type WidgetFilter, type WidgetGoalsResult, type WidgetReadResult, type WidgetReadStatus, type WidgetRealtimeResult, type WidgetRealtimeStatus, type WidgetSeriesResult, type WireGoal, type WithoutConsentArgs, type WithoutConsentFunction, type WithoutConsentLevel, type WithoutConsentOption, adapterFromProviderDoc, analytics, analyticsDefaultLayout, analyticsDefaultWidgets, analyticsError, analyticsFields, analyticsLinkFields, analyticsProviderFields, analyticsRoutes, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, createGuardedFetch, goalField, goalSlug, isAdminUser, itemAttributesFor, keys, parseRetryAfter, pluralKeys, purchase, readErrorCode, readForField, readForWidget, readForWidgetBreakdown, readForWidgetGoals, readForWidgetRealtime, readForWidgetSeries, rebuildDays, refreshProviders, refund, resolveHostPolicy, routePaths, signItemRef, signOrderId, tenantMembership, trackGoalAction, trackServerEvent, widgetFilters };
84
85
  //# sourceMappingURL=index.d.ts.map
package/dist/index.js CHANGED
@@ -8,6 +8,7 @@ import { createRegistry, withoutRevenue } from "./core/registry.js";
8
8
  import { keys, pluralKeys } from "./translations/keys.js";
9
9
  import { ANALYTICS_CONFIG_KEY, DEFAULT_ROUTE_BASE, analyticsRoutes, pluginEndpoint, routePaths } from "./plugin/routes.js";
10
10
  import { getRuntime, resolveGoalsFor, resolveRegistryFor, runtimeFactoryOf } from "./plugin/runtime.js";
11
+ import { PROVIDER_IDS } from "./providers/ids.js";
11
12
  import { ANALYTICS_ERROR_CODES, analyticsError, readErrorCode } from "./plugin/errors.js";
12
13
  import { makeExclusionHandler } from "./capture/exclusionEndpoint.js";
13
14
  import { proxyEndpoints } from "./capture/proxyEndpoint.js";
@@ -21,9 +22,8 @@ import { createStaticLabels } from "./translations/staticLabel.js";
21
22
  import { SYNC_SLUG } from "./sync/collection.js";
22
23
  import { CURRENCY_PATTERN } from "./goals/currency.js";
23
24
  import { changedScopes } from "./plugin/scopeChange.js";
24
- import { ProviderHttpError, parseRetryAfter } from "./adapters/http/fetchJson.js";
25
25
  import { resolveHostPolicy } from "./providers/hosts.js";
26
- import { PROVIDER_IDS, adapterFromProviderDoc } from "./providers/factory.js";
26
+ import { afterTransaction, openTransactionOf } from "./db/openTransaction.js";
27
27
  import { CONNECTION_PATHS, SECRET_PATHS } from "./providers/secrets.js";
28
28
  import { PROVIDERS_SLUG, analyticsProviderFields } from "./providers/collection.js";
29
29
  import { adapterCountsWithoutConsent } from "./core/captureOptions.js";
@@ -48,15 +48,18 @@ import { addTask, schemaOnly } from "./plugin/schemaOnly.js";
48
48
  import { signOrderId } from "./native/ingest/orderSignature.js";
49
49
  import { createGuardedFetch } from "./net/guardedFetch.js";
50
50
  import { refreshProviders } from "./providers/refresh.js";
51
+ import { ProviderHttpError, parseRetryAfter } from "./adapters/http/fetchJson.js";
52
+ import { adapterFromProviderDoc } from "./providers/factory.js";
51
53
  import { assertRoutesReachable } from "./plugin/routeChecks.js";
52
54
  import { createRuntimeFactory } from "./plugin/createRuntime.js";
53
55
  import { readForField } from "./fields/readForDocument.js";
54
56
  import { makeDocumentHandler } from "./plugin/documentEndpoint.js";
55
57
  import { makeFlagsHandler } from "./plugin/flagsEndpoint.js";
58
+ import { makeRefreshHandler } from "./plugin/refreshEndpoint.js";
59
+ import { makeProviderStatusHandler } from "./plugin/providerStatusEndpoint.js";
56
60
  import { makeQueryHandler } from "./plugin/queryEndpoint.js";
57
61
  import { readForWidgetRealtime } from "./widgets/readForWidgetRealtime.js";
58
62
  import { makeRealtimeHandler } from "./plugin/realtimeEndpoint.js";
59
- import { makeRefreshHandler } from "./plugin/refreshEndpoint.js";
60
63
  import { makeSourcesHandler } from "./plugin/sourcesEndpoint.js";
61
64
  import { warmTask } from "./plugin/warmTask.js";
62
65
  import { syncTask } from "./sync/syncTask.js";
@@ -84,6 +87,35 @@ import { definePlugin } from "payload";
84
87
  const configChanged = (collection) => (change, req) => {
85
88
  getRuntime(req.payload)?.configChanged?.(collection, changedScopes(change));
86
89
  };
90
+ /**
91
+ * Runs a status write of a saved or deleted provider document once the save's own transaction is
92
+ * over: a write outside it would wait on the locks it holds. The save goes on whatever happens
93
+ * here; the next read or check writes the row again.
94
+ */
95
+ const afterProviderSave = async (req, { docId, failed, write }) => {
96
+ const runtime = getRuntime(req.payload);
97
+ const store = runtime?.providerStatus;
98
+ if (!runtime || !store) return;
99
+ const run = () => write(store).catch((err) => {
100
+ runtime.providerStatusWarning?.(`analytics: the connection status of provider document "${docId}" could not be ${failed}: ${String(err)}`);
101
+ });
102
+ const open = await openTransactionOf(req.payload, req);
103
+ if (!open) {
104
+ await run();
105
+ return;
106
+ }
107
+ runtime.engine.keep?.(afterTransaction(open, run));
108
+ };
109
+ const forgetProviderStatus = (docId, req) => afterProviderSave(req, {
110
+ docId,
111
+ failed: "cleared",
112
+ write: (store) => store.forget(docId)
113
+ });
114
+ const carryProviderStatus = (docId, { from, to }, req) => afterProviderSave(req, {
115
+ docId,
116
+ failed: "kept",
117
+ write: (store) => store.carry(docId, from, to)
118
+ });
87
119
  const addEndpoints = (config, ...endpoints) => {
88
120
  config.endpoints = [...config.endpoints ?? [], ...endpoints];
89
121
  };
@@ -112,7 +144,9 @@ const analytics = definePlugin({
112
144
  };
113
145
  const collections = await configCollections(resolved, {
114
146
  resolveAdminScope,
115
- onChange: configChanged
147
+ onChange: configChanged,
148
+ forgetProviderStatus,
149
+ carryProviderStatus
116
150
  }, context);
117
151
  const sync = syncCollectionOf(resolved, resolveAdminScope, context);
118
152
  if (disabled) return schemaOnly(config, {
@@ -232,6 +266,18 @@ const analytics = definePlugin({
232
266
  path: routes.refresh,
233
267
  handler: makeRefreshHandler()
234
268
  });
269
+ if (resolved.providers.collection.enabled) {
270
+ const providerStatus = makeProviderStatusHandler();
271
+ addEndpoints(config, {
272
+ method: "get",
273
+ path: routes.providerStatus,
274
+ handler: providerStatus
275
+ }, {
276
+ method: "post",
277
+ path: routes.providerStatus,
278
+ handler: providerStatus
279
+ });
280
+ }
235
281
  if (resolved.capture.exclusion) addEndpoints(config, {
236
282
  method: "get",
237
283
  path: routes.exclusion,
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 Endpoint, type PayloadRequest } from 'payload'\n\nimport { itemCollectionsOf } from './binding/report'\nimport { captureRequest } from './capture/captureRequest'\nimport { makeExclusionHandler } from './capture/exclusionEndpoint'\nimport { proxyEndpoints } from './capture/proxyEndpoint'\nimport { trackerEndpoint } from './capture/trackerEndpoint'\nimport { assertMaintainRegistered, TASK_SLUGS } from './core/jobs'\nimport {\n\ttype AnalyticsPluginOptions,\n\tadapterCountsWithoutConsent,\n\tresolveOptions,\n\ttype ScopeCallSite,\n} from './core/options'\nimport { createRegistry, withoutRevenue } from './core/registry'\nimport { CURRENCY_PATTERN } from './goals/currency'\nimport { makeGoalsHandler } from './goals/goalsEndpoint'\nimport { applyConfigRevenueVisibility } from './goals/moneyFields'\nimport { configGoalsResolver } from './goals/resolver'\nimport type { Goal } from './goals/types'\nimport { addComponentDependency, FLAG_DEPENDENCY } from './plugin/adminDependencies'\nimport { expectedCollections } from './plugin/collectionChecks'\nimport { createRuntimeFactory } from './plugin/createRuntime'\nimport { makeDocumentHandler } from './plugin/documentEndpoint'\nimport { makeFlagsHandler } from './plugin/flagsEndpoint'\nimport { restrictJobControls } from './plugin/jobsAccess'\nimport {\n\taddStateCollection,\n\ttype CollectionContext,\n\tcacheCollectionOf,\n\tconfigCollections,\n\tsyncCollectionOf,\n} from './plugin/pluginCollections'\nimport { makeQueryHandler } from './plugin/queryEndpoint'\nimport { makeRealtimeHandler } from './plugin/realtimeEndpoint'\nimport { makeRefreshHandler } from './plugin/refreshEndpoint'\nimport { registerTranslations } from './plugin/registerTranslations'\nimport { relabelFactoryFields } from './plugin/relabelFields'\nimport { assertRoutesReachable } from './plugin/routeChecks'\nimport {\n\tANALYTICS_CONFIG_KEY,\n\ttype AnalyticsAdminCustom,\n\tpluginEndpoint,\n\troutePaths,\n} from './plugin/routes'\nimport { getRuntime, resolveGoalsFor, resolveRegistryFor, runtimeFactoryOf } from './plugin/runtime'\nimport { addTask, schemaOnly } from './plugin/schemaOnly'\nimport { changedScopes, type ScopeChange } from './plugin/scopeChange'\nimport { makeSourcesHandler } from './plugin/sourcesEndpoint'\nimport { fillUnbundledLanguages, unbundledLanguages } from './plugin/unbundledLanguages'\nimport { warmTask } from './plugin/warmTask'\nimport { syncTask } from './sync/syncTask'\nimport { createStrictTimezoneResolver, createTimezoneResolver } from './timeframe/reportingTimezone'\nimport { keys } from './translations/keys'\nimport { createStaticLabels } from './translations/staticLabel'\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/**\n * Rereads the scopes a providers or goals save touched, on the instance that wrote; every other\n * instance catches up through its own probe.\n */\nconst configChanged =\n\t(collection: 'providers' | 'goals') =>\n\t(change: ScopeChange, req: PayloadRequest): void => {\n\t\tgetRuntime(req.payload)?.configChanged?.(collection, changedScopes(change))\n\t}\n\nconst addEndpoints = (config: Config, ...endpoints: Endpoint[]): void => {\n\tconfig.endpoints = [...(config.endpoints ?? []), ...endpoints]\n}\n\nexport const analytics = definePlugin<AnalyticsPluginOptions>({\n\tslug: '@10x-media/analytics',\n\tplugin: async ({ config, plugins: _plugins, ...options }): Promise<Config> => {\n\t\tconst disabled = options.disabled === true\n\t\t// Switched off, nothing reads through the adapters: they are only asked for their schema.\n\t\tconst resolved = resolveOptions(options, { requireAdapters: !disabled })\n\t\tconst resolveScope = async (req: PayloadRequest, callSite: ScopeCallSite) =>\n\t\t\tresolved.scope.resolve({ req, callSite })\n\t\tconst resolveAdminScope = (req: PayloadRequest) => resolveScope(req, 'admin')\n\t\t// What the collection checks warn about waits for the instance's logger, at init.\n\t\tconst notices: string[] = []\n\t\t// Read before the plugin merges its own strings in, so the app's own still win.\n\t\tconst staticLabel = createStaticLabels({\n\t\t\tapp: config.i18n?.translations,\n\t\t\tplugin: options.translations,\n\t\t\tunbundled: unbundledLanguages(config),\n\t\t})\n\t\tconst context: CollectionContext = {\n\t\t\tdb: config.db?.name,\n\t\t\tnotice: (message) => {\n\t\t\t\tnotices.push(message)\n\t\t\t},\n\t\t\tstaticLabel,\n\t\t}\n\t\tconst collections = await configCollections(\n\t\t\tresolved,\n\t\t\t{ resolveAdminScope, onChange: configChanged },\n\t\t\tcontext\n\t\t)\n\t\tconst sync = syncCollectionOf(resolved, resolveAdminScope, context)\n\t\tif (disabled) {\n\t\t\treturn schemaOnly(config, {\n\t\t\t\tresolved,\n\t\t\t\tcollections,\n\t\t\t\tcontext,\n\t\t\t\t...(sync ? { sync } : {}),\n\t\t\t\t...(options.translations ? { translations: options.translations } : {}),\n\t\t\t})\n\t\t}\n\t\tconst routes = routePaths(resolved.routes.base)\n\t\t// Whatever is mounted before the plugin runs belongs to the host or an earlier plugin.\n\t\tconst earlierEndpoints = new Set(config.endpoints ?? [])\n\t\tconst money = resolved.revenue.enabled\n\t\t// A runtime provider's capabilities are unknown at config time, so providers open the\n\t\t// widget and endpoint gates that otherwise follow the config adapters' capabilities.\n\t\tconst providersEnabled =\n\t\t\tresolved.providers.collection.enabled || Boolean(resolved.providers.resolve)\n\t\t// Read before the adapters register: only a host that turned it on may carry concurrency keys.\n\t\tconst jobsConcurrency = config.jobs?.enableConcurrencyControl === true\n\t\tregisterTranslations(config, options.translations)\n\t\tfillUnbundledLanguages(config)\n\t\tconst registry = createRegistry(resolved.adapters, resolved.defaultAdapter)\n\t\t// Adapters ask for a scope to stamp a visitor's hit with, so theirs is the capture call\n\t\t// site, asked without the signed-in user or their cookies.\n\t\tconst resolveCaptureScope = (req: PayloadRequest) =>\n\t\t\tresolveScope(captureRequest(req), 'capture')\n\t\t/**\n\t\t * Whether a scope's own committed provider documents grant it this adapter (a beacon decrypts\n\t\t * nothing). Handed to adapters only when `scope.resolve` and the providers collection both run.\n\t\t */\n\t\tconst adapterGrantedForScope = async (\n\t\t\treq: PayloadRequest,\n\t\t\tscope: string | null,\n\t\t\tadapterId: string\n\t\t): Promise<boolean> => {\n\t\t\tconst runtime = getRuntime(req.payload)\n\t\t\tif (!runtime) {\n\t\t\t\treturn true\n\t\t\t}\n\t\t\tif (runtime.providerGranted) {\n\t\t\t\treturn runtime.providerGranted(scope, adapterId)\n\t\t\t}\n\t\t\tconst { grants } = await resolveRegistryFor(runtime, { payload: req.payload, req, scope })\n\t\t\treturn grants.has(adapterId)\n\t\t}\n\t\tconst configGoals = configGoalsResolver(resolved.goals, resolved.purchaseGoal)\n\t\t/** The goals of the instance a request reached, which adapters resolve at ingest. */\n\t\tconst resolveGoals = (req: PayloadRequest, scope?: string | null): Promise<Goal[]> => {\n\t\t\tconst runtime = getRuntime(req.payload)\n\t\t\treturn runtime ? resolveGoalsFor(runtime, req, scope) : configGoals.resolve(req, scope)\n\t\t}\n\t\tconfig.collections = [...(config.collections ?? []), ...collections]\n\t\tconst timezoneArgs = { option: resolved.reportingTimezone, resolveScope: resolveAdminScope }\n\t\tconst resolveTimezone = createTimezoneResolver(timezoneArgs)\n\t\tconst resolveTimezoneStrict = createStrictTimezoneResolver(timezoneArgs)\n\t\tconst resolveCurrency = async (\n\t\t\treq: PayloadRequest,\n\t\t\tscope?: string | null\n\t\t): Promise<string | undefined> => {\n\t\t\tconst opt = resolved.revenue.currency\n\t\t\tif (opt === undefined) {\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst code =\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 resolveAdminScope(req) })\n\t\t\t\treturn code && CURRENCY_PATTERN.test(code) ? code : undefined\n\t\t\t} catch (err) {\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: revenue.currency resolution failed, reporting revenue unformatted: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t}\n\t\tconst itemCollections = itemCollectionsOf(resolved.bindings)\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: resolveCaptureScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tresolveTimezoneStrict,\n\t\t\t\trevenue: {\n\t\t\t\t\tenabled: money,\n\t\t\t\t\tdimension: resolved.revenue.dimension,\n\t\t\t\t\tcurrency: resolveCurrency,\n\t\t\t\t\tconvert: resolved.revenue.convert,\n\t\t\t\t\tbrowserAmounts: resolved.revenue.browserAmounts,\n\t\t\t\t\torderSignature: resolved.revenue.orderSignature,\n\t\t\t\t},\n\t\t\t\tresolveGoals,\n\t\t\t\t...(resolved.scoped && resolved.providers.collection.enabled\n\t\t\t\t\t? { adapterGrantedForScope }\n\t\t\t\t\t: {}),\n\t\t\t\ttrustedProxyHops: resolved.trustedProxyHops,\n\t\t\t\ttrustedPlatform: resolved.trustedPlatform,\n\t\t\t\tallowedOrigins: resolved.capture.allowedOrigins,\n\t\t\t\tadapterCountsWithoutConsent: adapterCountsWithoutConsent(resolved, adapter),\n\t\t\t\t...(itemCollections.size > 0\n\t\t\t\t\t? {\n\t\t\t\t\t\t\titems: {\n\t\t\t\t\t\t\t\tcollections: itemCollections,\n\t\t\t\t\t\t\t\tpages: resolved.capture.autoCapture.items.pages,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t}\n\t\t\t\t\t: {}),\n\t\t\t\troutes,\n\t\t\t\tsdks: resolved.sdks,\n\t\t\t\tjobs: resolved.jobs,\n\t\t\t\tjobsConcurrency,\n\t\t\t\tnotice: context.notice,\n\t\t\t})\n\t\t}\n\t\tassertMaintainRegistered(\n\t\t\tresolved.jobs,\n\t\t\t(config.jobs?.tasks ?? []).some((task) => task.slug === TASK_SLUGS.maintain)\n\t\t)\n\t\t// After registration: an adapter declares what the install measures once it is registered,\n\t\t// and one that declares no revenue then is read as it is rather than as a copy.\n\t\tconst readRegistry = money ? registry : withoutRevenue(registry)\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\taddEndpoints(config, { method: 'get', path: routes.live, handler: makeRealtimeHandler() })\n\t\t}\n\t\tif (Object.keys(resolved.bindings).length > 0) {\n\t\t\taddEndpoints(config, { method: 'get', path: routes.document, handler: makeDocumentHandler() })\n\t\t}\n\t\taddEndpoints(\n\t\t\tconfig,\n\t\t\t{ method: 'get', path: routes.sources, handler: makeSourcesHandler() },\n\t\t\t{ method: 'get', path: routes.goals, handler: makeGoalsHandler() },\n\t\t\t{ method: 'get', path: routes.query, handler: makeQueryHandler() },\n\t\t\t{ method: 'post', path: routes.refresh, handler: makeRefreshHandler() }\n\t\t)\n\t\tif (resolved.capture.exclusion) {\n\t\t\taddEndpoints(config, {\n\t\t\t\tmethod: 'get',\n\t\t\t\tpath: routes.exclusion,\n\t\t\t\thandler: makeExclusionHandler(),\n\t\t\t})\n\t\t}\n\t\t// One answer serves the view, the widgets and the route, so the flags an install draws and\n\t\t// the route serving them cannot diverge. A host's own flag needs no route, only the import map.\n\t\tconst countryFlags = resolved.countryFlags\n\t\tif (countryFlags === true) {\n\t\t\taddEndpoints(config, {\n\t\t\t\tmethod: 'get',\n\t\t\t\tpath: routes.flagsPattern,\n\t\t\t\thandler: makeFlagsHandler(),\n\t\t\t})\n\t\t} else if (countryFlags !== false) {\n\t\t\taddComponentDependency(config, FLAG_DEPENDENCY, countryFlags.Component)\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\taddEndpoints(config, ...proxyEndpoints(routes), trackerEndpoint(routes))\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\trevenue: money,\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\tcountryFlags,\n\t\t\t\tstaticLabel,\n\t\t\t\toverrides: resolved.widgets.overrides,\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, title: staticLabel(keys.viewTitle) })\n\t\tconst { jobs } = resolved\n\t\tif (jobs !== false && resolved.cache.warm.enabled) {\n\t\t\taddTask(\n\t\t\t\tconfig,\n\t\t\t\twarmTask({\n\t\t\t\t\tschedule: jobs.warm,\n\t\t\t\t\twindowHours: resolved.cache.warm.windowHours,\n\t\t\t\t\tmaxReads: resolved.cache.warm.maxReads,\n\t\t\t\t\tconcurrency: jobsConcurrency,\n\t\t\t\t})\n\t\t\t)\n\t\t}\n\t\tif (sync) {\n\t\t\tconfig.collections = [...(config.collections ?? []), sync]\n\t\t\tif (jobs !== false) {\n\t\t\t\taddTask(\n\t\t\t\t\tconfig,\n\t\t\t\t\tsyncTask({\n\t\t\t\t\t\tschedule: jobs.sync,\n\t\t\t\t\t\tlookbackDays: resolved.sync.lookbackDays,\n\t\t\t\t\t\tcollectionSlug: resolved.sync.collection.slug,\n\t\t\t\t\t\tadapterIds: resolved.sync.adapters,\n\t\t\t\t\t\tscopes: resolved.scope.list,\n\t\t\t\t\t\tconcurrency: jobsConcurrency,\n\t\t\t\t\t})\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\tconst cache = cacheCollectionOf(resolved, context)\n\t\tif (cache) {\n\t\t\tconfig.collections = [...(config.collections ?? []), cache]\n\t\t}\n\t\taddStateCollection(config, resolved, context)\n\t\trestrictJobControls(config)\n\t\t// Hidden per config rather than per process, so two instances answer for themselves; a later\n\t\t// plugin's fields (form-builder's action blocks) take their factory's own `revenue` option.\n\t\tapplyConfigRevenueVisibility(config, money)\n\t\trelabelFactoryFields(config, staticLabel)\n\t\tconfig.endpoints = (config.endpoints ?? []).map((endpoint) =>\n\t\t\tearlierEndpoints.has(endpoint) ? endpoint : pluginEndpoint(endpoint)\n\t\t)\n\t\t// Checked against everything registered so far, the plugin's own collections included; what a\n\t\t// later plugin adds is caught when a runtime is built from the assembled config.\n\t\tassertRoutesReachable(resolved.routes.base, {\n\t\t\tcollections: config.collections ?? [],\n\t\t\tendpoints: config.endpoints,\n\t\t})\n\t\tconst factory = createRuntimeFactory({\n\t\t\tresolved,\n\t\t\tnotices,\n\t\t\tcollections: expectedCollections(config.collections),\n\t\t\tregistry: readRegistry,\n\t\t\tresolveScope,\n\t\t\tresolveTimezone,\n\t\t\tresolveCurrency,\n\t\t})\n\t\tconst adminCustom: AnalyticsAdminCustom = { routes: { base: resolved.routes.base } }\n\t\tconfig.custom = { ...config.custom, [ANALYTICS_CONFIG_KEY]: factory }\n\t\tconfig.admin = {\n\t\t\t...config.admin,\n\t\t\tcustom: { ...config.admin?.custom, [ANALYTICS_CONFIG_KEY]: adminCustom },\n\t\t}\n\t\tconst prevOnInit = config.onInit\n\t\t// Validation only: the runtime builds on first use either way, and is built here so consumer\n\t\t// init code (seeding, cache warming, sync passes) runs against a warm one.\n\t\tconfig.onInit = async (payload) => {\n\t\t\t// Without the factory every endpoint answers 503; a boot error names the cause instead.\n\t\t\tif (runtimeFactoryOf(payload.config) !== factory) {\n\t\t\t\tthrow new Error(RUNTIME_FACTORY_LOST)\n\t\t\t}\n\t\t\tawait factory.validate(payload)\n\t\t\tgetRuntime(payload)\n\t\t\tawait prevOnInit?.(payload)\n\t\t}\n\t\treturn config\n\t},\n})\n\n/** Said at boot when a step after the plugin dropped its runtime from `config.custom`. */\nconst RUNTIME_FACTORY_LOST = `analytics: config.custom[\"${ANALYTICS_CONFIG_KEY}\"] no longer holds the analytics runtime: a plugin or config step that runs after analytics replaced config.custom instead of spreading it. Spread the existing value there ({ ...config.custom, ... }), or list analytics after that plugin.`\n\nexport { isAdminUser } from './access/adminUser'\nexport { type TenantMembershipOptions, tenantMembership } from './access/membership'\nexport { type GatedScope, type ReadPrincipal, SYSTEM } from './access/principal'\nexport { ProviderHttpError, parseRetryAfter } from './adapters/http/fetchJson'\nexport type { ReportMode, ReportOption } from './binding/report'\nexport type {\n\tAnalyticsBinding,\n\tBindingContext,\n\tBindingDoc,\n\tHostnameResolver,\n\tPathResolver,\n} from './binding/types'\nexport type { CapabilityRequirement, FilterPair, SerializedCapabilities } from './core/capabilities'\nexport {\n\ttype AnalyticsQuery,\n\ttype AnalyticsResult,\n\tPLATFORM_SCOPE,\n} from './core/contract'\nexport type {\n\tAnalyticsAccessOptions,\n\tAnalyticsCacheCollectionOptions,\n\tAnalyticsCacheOptions,\n\tAnalyticsCaptureOptions,\n\tAnalyticsCollectionOptions,\n\tAnalyticsComponent,\n\tAnalyticsConcurrencyOptions,\n\tAnalyticsCountryFlags,\n\tAnalyticsCrossScopeOptions,\n\tAnalyticsExclusionOptions,\n\tAnalyticsGoalsCollectionOptions,\n\tAnalyticsGoalsOptions,\n\tAnalyticsHooksOptions,\n\tAnalyticsJobsOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsPluginOptions as PluginOptions,\n\tAnalyticsReadAccess,\n\tAnalyticsRevenueOptions,\n\tAnalyticsRoutesOptions,\n\tAnalyticsScopeOptions,\n\tAnalyticsSourceOptions,\n\tAnalyticsSyncCollectionOptions,\n\tAnalyticsSyncOptions,\n\tAnalyticsTaskOptions,\n\tAnalyticsViewAccess,\n\tAnalyticsViewOptions,\n\tAnalyticsWarmOptions,\n\tAnalyticsWidgetOverride,\n\tAnalyticsWidgetOverrides,\n\tAnalyticsWidgetsOptions,\n\tAutoCaptureOptions,\n\tCaptureGate,\n\tCaptureGateArgs,\n\tCaptureSlotOption,\n\tCollectionOverrides,\n\tCrossScopeAccess,\n\tCurrencyConverter,\n\tCurrencyResolver,\n\tDefaultSourceFunction,\n\tDefaultSourceRule,\n\tExclusionSitesResolver,\n\tItemCaptureOptions,\n\tOwnSource,\n\tProviderHostsOptions,\n\tProvidersCollectionOptions,\n\tProvidersOptions,\n\tProvidersResolve,\n\tProvidersResolveArgs,\n\tScopeCallSite,\n\tScopeLabelResolver,\n\tScopeListResolver,\n\tScopeMemberAccess,\n\tScopeResolver,\n\tSourcePolicy,\n\tSourcePolicyFunction,\n\tSourceRef,\n\tTimezoneResolver,\n\tWithoutConsentArgs,\n\tWithoutConsentFunction,\n\tWithoutConsentOption,\n} from './core/options'\nexport type {\n\tAnalyticsSdks,\n\tGa4Client,\n\tGa4ClientOptions,\n\tGa4ReportResponse,\n\tGa4ReportRow,\n\tGa4Sdk,\n\tMaxmindReader,\n\tMaxmindSdk,\n} from './core/sdks'\nexport type {\n\tServerEventInput,\n\tServerTrack,\n\tServerTrackIdentity,\n\tServerTrackOptions,\n} from './core/serverEvent'\nexport { AnalyticsTrackError } from './core/serverEvent'\nexport { BUILT_IN_WIDGET_SLUGS, type BuiltInWidgetSlug } from './core/widgetSlugs'\nexport type * from './exports/adapters/contract'\nexport type { AnalyticsAttributes } from './exports/attributes'\nexport type {\n\tAnalyticsFieldsOptions,\n\tAnalyticsMetricLabel,\n\tAnalyticsMetricLabels,\n\tAnalyticsStatBaseOptions,\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 {\n\tFieldBreakdown,\n\tFieldBreakdownRow,\n\tFieldReadResult,\n\tFieldReadStatus,\n\tReadForFieldArgs,\n} from './fields/readForDocument'\nexport { readForField } from './fields/readForDocument'\nexport type {\n\tGoalCollectionFieldOverrides,\n\tGoalFieldOverride,\n} from './goals/collection'\nexport { GOALS_SLUG } from './goals/collection'\nexport {\n\tCURRENCY_ATTRIBUTE,\n\tEVENT_ATTRIBUTE,\n\tEVENT_PROP_PREFIX,\n\tGOAL_ATTRIBUTE,\n\tITEM_ATTRIBUTE,\n\tITEM_CLICK_EVENT,\n\tITEM_NAME_ATTRIBUTE,\n\tMAX_ITEMS_PER_BEACON,\n\tPURCHASE_GOAL_SLUG,\n\tVALUE_ATTRIBUTE,\n} from './goals/constants'\nexport type { GoalFieldOptions } from './goals/goalField'\nexport { goalField, goalSlug } from './goals/goalField'\nexport type { GoalsResponse, WireGoal } from './goals/goalsEndpoint'\nexport type { AnalyticsLinkFieldsOptions } from './goals/linkFields'\nexport { analyticsLinkFields } from './goals/linkFields'\nexport type { BrowserAmounts, OrderSignatureMode } from './goals/match'\nexport type { GoalSource } from './goals/resolver'\nexport type {\n\tPurchaseInput as ServerPurchaseInput,\n\tRefundInput as ServerRefundInput,\n} from './goals/serverRevenue'\nexport { purchase, refund } from './goals/serverRevenue'\nexport type {\n\tGoalActionDefinition,\n\tGoalActionRunArgs,\n\tTrackGoalActionOptions,\n} from './goals/trackGoalAction'\nexport { GOAL_ACTION_TYPE, trackGoalAction } from './goals/trackGoalAction'\nexport type { Goal } from './goals/types'\nexport { STATE_SLUG } from './native/collections/slugs'\nexport type { RebuildDaysInput, RebuildDaysReport } from './native/engine/rebuild'\nexport {\n\ttype ItemSignatureMode,\n\titemAttributesFor,\n\tsignItemRef,\n} from './native/ingest/itemSignature'\nexport { signOrderId } from './native/ingest/orderSignature'\nexport { trackServerEvent } from './native/ingest/serverTrack'\nexport { rebuildDays } from './native/rebuildDays'\nexport {\n\tcreateGuardedFetch,\n\ttype GuardedFetch,\n\ttype GuardedFetchOptions,\n} from './net/guardedFetch'\nexport type { TrustedPlatform } from './net/platform'\nexport type { CollectionFieldOverride } from './plugin/collectionFields'\nexport {\n\tANALYTICS_ERROR_CODES,\n\ttype AnalyticsError,\n\ttype AnalyticsErrorCode,\n\tanalyticsError,\n\treadErrorCode,\n} from './plugin/errors'\nexport type { RoutesConfigSource } from './plugin/routes'\nexport {\n\tanalyticsRoutes,\n\tDEFAULT_ROUTE_BASE,\n\ttype RouteBase,\n\ttype RoutePaths,\n\troutePaths,\n} from './plugin/routes'\nexport type {\n\tBuildSecretField,\n\tConnectionAccess,\n\tConnectionFieldAccess,\n\tProviderCollectionFieldOverrides,\n\tProviderFieldOverride,\n\tProviderFieldsOptions,\n} from './providers/collection'\nexport { analyticsProviderFields, PROVIDERS_SLUG } from './providers/collection'\nexport type { ProviderDoc, ProviderFactoryContext, ProviderId } from './providers/factory'\nexport { adapterFromProviderDoc, PROVIDER_IDS } from './providers/factory'\nexport type { HostPattern } from './providers/hosts'\nexport { type ProviderHostPolicy, resolveHostPolicy } from './providers/hosts'\nexport { type RefreshProvidersOptions, refreshProviders } from './providers/refresh'\nexport { CONNECTION_PATHS, SECRET_PATHS } from './providers/secrets'\nexport type { QueryError, QueryErrorCode } from './query/errors'\nexport type {\n\tItemLabels,\n\tQueryErrorResponse,\n\tQueryResponse,\n\tQuerySourceRef,\n\tSerializedAnalyticsQuery,\n} from './query/response'\nexport type {\n\tAfterReadAnswer,\n\tAfterReadArgs,\n\tAfterReadHook,\n\tReadOrigin,\n} from './surfacing/afterRead'\nexport { CACHE_SLUG } from './surfacing/cacheCollection'\nexport type {\n\tCacheEntry,\n\tCacheSetOptions,\n\tCacheStore,\n\tReadRecipe,\n\tRecipeWindow,\n} from './surfacing/cacheStore'\nexport { SYNC_SLUG } from './sync/collection'\nexport { TIMEFRAME_PRESETS, type TimeframePreset } from './timeframe/presets'\nexport type { GoalMatch, RevenueItem, TrackerGoal } from './tracker/config'\nexport type { TranslationsOption } from './translations'\nexport {\n\tkeys,\n\ttype PluralCategory,\n\ttype PluralName,\n\ttype PluralVariant,\n\tpluralKeys,\n\ttype SingularKey,\n\ttype TranslationKey,\n} from './translations/keys'\nexport type { CustomWidgetDef } from './widgets/customWidget'\nexport {\n\ttype AnalyticsDefaultLayoutOptions,\n\tanalyticsDefaultLayout,\n} from './widgets/defaultLayout'\nexport { analyticsDefaultWidgets } from './widgets/defaults'\nexport { widgetFilters } from './widgets/filterField'\nexport type { StoredSourceRead, SubstitutedSource } from './widgets/prepareWidgetRead'\nexport type {\n\tReadForWidgetArgs,\n\tWidgetReadResult,\n\tWidgetReadStatus,\n} from './widgets/readForWidget'\nexport { readForWidget } from './widgets/readForWidget'\nexport type {\n\tBreakdownRow,\n\tReadForWidgetBreakdownArgs,\n\tWidgetBreakdownResult,\n} from './widgets/readForWidgetBreakdown'\nexport { readForWidgetBreakdown } from './widgets/readForWidgetBreakdown'\nexport type {\n\tGoalRow,\n\tReadForWidgetGoalsArgs,\n\tWidgetGoalsResult,\n} from './widgets/readForWidgetGoals'\nexport { readForWidgetGoals } from './widgets/readForWidgetGoals'\nexport type {\n\tReadForWidgetRealtimeArgs,\n\tRealtimePoint,\n\tWidgetRealtimeResult,\n\tWidgetRealtimeStatus,\n} from './widgets/readForWidgetRealtime'\nexport { readForWidgetRealtime } from './widgets/readForWidgetRealtime'\nexport type {\n\tReadForWidgetSeriesArgs,\n\tSeriesGranularity,\n\tSeriesPoint,\n\tWidgetSeriesResult,\n} from './widgets/readForWidgetSeries'\nexport { readForWidgetSeries } from './widgets/readForWidgetSeries'\nexport type { ReadNotices } from './widgets/readMeta'\nexport type { WidgetFilter } from './widgets/types'\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type Config, definePlugin, type Endpoint, type PayloadRequest } from 'payload'\n\nimport { itemCollectionsOf } from './binding/report'\nimport { captureRequest } from './capture/captureRequest'\nimport { makeExclusionHandler } from './capture/exclusionEndpoint'\nimport { proxyEndpoints } from './capture/proxyEndpoint'\nimport { trackerEndpoint } from './capture/trackerEndpoint'\nimport { assertMaintainRegistered, TASK_SLUGS } from './core/jobs'\nimport {\n\ttype AnalyticsPluginOptions,\n\tadapterCountsWithoutConsent,\n\tresolveOptions,\n\ttype ScopeCallSite,\n} from './core/options'\nimport { createRegistry, withoutRevenue } from './core/registry'\nimport { afterTransaction, openTransactionOf } from './db/openTransaction'\nimport { CURRENCY_PATTERN } from './goals/currency'\nimport { makeGoalsHandler } from './goals/goalsEndpoint'\nimport { applyConfigRevenueVisibility } from './goals/moneyFields'\nimport { configGoalsResolver } from './goals/resolver'\nimport type { Goal } from './goals/types'\nimport { addComponentDependency, FLAG_DEPENDENCY } from './plugin/adminDependencies'\nimport { expectedCollections } from './plugin/collectionChecks'\nimport { createRuntimeFactory } from './plugin/createRuntime'\nimport { makeDocumentHandler } from './plugin/documentEndpoint'\nimport { makeFlagsHandler } from './plugin/flagsEndpoint'\nimport { restrictJobControls } from './plugin/jobsAccess'\nimport {\n\taddStateCollection,\n\ttype CollectionContext,\n\tcacheCollectionOf,\n\tconfigCollections,\n\tsyncCollectionOf,\n} from './plugin/pluginCollections'\nimport { makeProviderStatusHandler } from './plugin/providerStatusEndpoint'\nimport { makeQueryHandler } from './plugin/queryEndpoint'\nimport { makeRealtimeHandler } from './plugin/realtimeEndpoint'\nimport { makeRefreshHandler } from './plugin/refreshEndpoint'\nimport { registerTranslations } from './plugin/registerTranslations'\nimport { relabelFactoryFields } from './plugin/relabelFields'\nimport { assertRoutesReachable } from './plugin/routeChecks'\nimport {\n\tANALYTICS_CONFIG_KEY,\n\ttype AnalyticsAdminCustom,\n\tpluginEndpoint,\n\troutePaths,\n} from './plugin/routes'\nimport { getRuntime, resolveGoalsFor, resolveRegistryFor, runtimeFactoryOf } from './plugin/runtime'\nimport { addTask, schemaOnly } from './plugin/schemaOnly'\nimport { changedScopes, type ScopeChange } from './plugin/scopeChange'\nimport { makeSourcesHandler } from './plugin/sourcesEndpoint'\nimport { fillUnbundledLanguages, unbundledLanguages } from './plugin/unbundledLanguages'\nimport { warmTask } from './plugin/warmTask'\nimport type { ProviderStatusStore } from './providers/status'\nimport { syncTask } from './sync/syncTask'\nimport { createStrictTimezoneResolver, createTimezoneResolver } from './timeframe/reportingTimezone'\nimport { keys } from './translations/keys'\nimport { createStaticLabels } from './translations/staticLabel'\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/**\n * Rereads the scopes a providers or goals save touched, on the instance that wrote; every other\n * instance catches up through its own probe.\n */\nconst configChanged =\n\t(collection: 'providers' | 'goals') =>\n\t(change: ScopeChange, req: PayloadRequest): void => {\n\t\tgetRuntime(req.payload)?.configChanged?.(collection, changedScopes(change))\n\t}\n\n/**\n * Runs a status write of a saved or deleted provider document once the save's own transaction is\n * over: a write outside it would wait on the locks it holds. The save goes on whatever happens\n * here; the next read or check writes the row again.\n */\nconst afterProviderSave = async (\n\treq: PayloadRequest,\n\t{\n\t\tdocId,\n\t\tfailed,\n\t\twrite,\n\t}: { docId: string; failed: string; write: (store: ProviderStatusStore) => Promise<void> }\n): Promise<void> => {\n\tconst runtime = getRuntime(req.payload)\n\tconst store = runtime?.providerStatus\n\tif (!runtime || !store) {\n\t\treturn\n\t}\n\tconst run = () =>\n\t\twrite(store).catch((err: unknown) => {\n\t\t\truntime.providerStatusWarning?.(\n\t\t\t\t`analytics: the connection status of provider document \"${docId}\" could not be ${failed}: ${String(err)}`\n\t\t\t)\n\t\t})\n\tconst open = await openTransactionOf(req.payload, req)\n\tif (!open) {\n\t\tawait run()\n\t\treturn\n\t}\n\truntime.engine.keep?.(afterTransaction(open, run))\n}\n\nconst forgetProviderStatus = (docId: string, req: PayloadRequest): Promise<void> =>\n\tafterProviderSave(req, { docId, failed: 'cleared', write: (store) => store.forget(docId) })\n\nconst carryProviderStatus = (\n\tdocId: string,\n\t{ from, to }: { from: string; to: string },\n\treq: PayloadRequest\n): Promise<void> =>\n\tafterProviderSave(req, { docId, failed: 'kept', write: (store) => store.carry(docId, from, to) })\n\nconst addEndpoints = (config: Config, ...endpoints: Endpoint[]): void => {\n\tconfig.endpoints = [...(config.endpoints ?? []), ...endpoints]\n}\n\nexport const analytics = definePlugin<AnalyticsPluginOptions>({\n\tslug: '@10x-media/analytics',\n\tplugin: async ({ config, plugins: _plugins, ...options }): Promise<Config> => {\n\t\tconst disabled = options.disabled === true\n\t\t// Switched off, nothing reads through the adapters: they are only asked for their schema.\n\t\tconst resolved = resolveOptions(options, { requireAdapters: !disabled })\n\t\tconst resolveScope = async (req: PayloadRequest, callSite: ScopeCallSite) =>\n\t\t\tresolved.scope.resolve({ req, callSite })\n\t\tconst resolveAdminScope = (req: PayloadRequest) => resolveScope(req, 'admin')\n\t\t// What the collection checks warn about waits for the instance's logger, at init.\n\t\tconst notices: string[] = []\n\t\t// Read before the plugin merges its own strings in, so the app's own still win.\n\t\tconst staticLabel = createStaticLabels({\n\t\t\tapp: config.i18n?.translations,\n\t\t\tplugin: options.translations,\n\t\t\tunbundled: unbundledLanguages(config),\n\t\t})\n\t\tconst context: CollectionContext = {\n\t\t\tdb: config.db?.name,\n\t\t\tnotice: (message) => {\n\t\t\t\tnotices.push(message)\n\t\t\t},\n\t\t\tstaticLabel,\n\t\t}\n\t\tconst collections = await configCollections(\n\t\t\tresolved,\n\t\t\t{ resolveAdminScope, onChange: configChanged, forgetProviderStatus, carryProviderStatus },\n\t\t\tcontext\n\t\t)\n\t\tconst sync = syncCollectionOf(resolved, resolveAdminScope, context)\n\t\tif (disabled) {\n\t\t\treturn schemaOnly(config, {\n\t\t\t\tresolved,\n\t\t\t\tcollections,\n\t\t\t\tcontext,\n\t\t\t\t...(sync ? { sync } : {}),\n\t\t\t\t...(options.translations ? { translations: options.translations } : {}),\n\t\t\t})\n\t\t}\n\t\tconst routes = routePaths(resolved.routes.base)\n\t\t// Whatever is mounted before the plugin runs belongs to the host or an earlier plugin.\n\t\tconst earlierEndpoints = new Set(config.endpoints ?? [])\n\t\tconst money = resolved.revenue.enabled\n\t\t// A runtime provider's capabilities are unknown at config time, so providers open the\n\t\t// widget and endpoint gates that otherwise follow the config adapters' capabilities.\n\t\tconst providersEnabled =\n\t\t\tresolved.providers.collection.enabled || Boolean(resolved.providers.resolve)\n\t\t// Read before the adapters register: only a host that turned it on may carry concurrency keys.\n\t\tconst jobsConcurrency = config.jobs?.enableConcurrencyControl === true\n\t\tregisterTranslations(config, options.translations)\n\t\tfillUnbundledLanguages(config)\n\t\tconst registry = createRegistry(resolved.adapters, resolved.defaultAdapter)\n\t\t// Adapters ask for a scope to stamp a visitor's hit with, so theirs is the capture call\n\t\t// site, asked without the signed-in user or their cookies.\n\t\tconst resolveCaptureScope = (req: PayloadRequest) =>\n\t\t\tresolveScope(captureRequest(req), 'capture')\n\t\t/**\n\t\t * Whether a scope's own committed provider documents grant it this adapter (a beacon decrypts\n\t\t * nothing). Handed to adapters only when `scope.resolve` and the providers collection both run.\n\t\t */\n\t\tconst adapterGrantedForScope = async (\n\t\t\treq: PayloadRequest,\n\t\t\tscope: string | null,\n\t\t\tadapterId: string\n\t\t): Promise<boolean> => {\n\t\t\tconst runtime = getRuntime(req.payload)\n\t\t\tif (!runtime) {\n\t\t\t\treturn true\n\t\t\t}\n\t\t\tif (runtime.providerGranted) {\n\t\t\t\treturn runtime.providerGranted(scope, adapterId)\n\t\t\t}\n\t\t\tconst { grants } = await resolveRegistryFor(runtime, { payload: req.payload, req, scope })\n\t\t\treturn grants.has(adapterId)\n\t\t}\n\t\tconst configGoals = configGoalsResolver(resolved.goals, resolved.purchaseGoal)\n\t\t/** The goals of the instance a request reached, which adapters resolve at ingest. */\n\t\tconst resolveGoals = (req: PayloadRequest, scope?: string | null): Promise<Goal[]> => {\n\t\t\tconst runtime = getRuntime(req.payload)\n\t\t\treturn runtime ? resolveGoalsFor(runtime, req, scope) : configGoals.resolve(req, scope)\n\t\t}\n\t\tconfig.collections = [...(config.collections ?? []), ...collections]\n\t\tconst timezoneArgs = { option: resolved.reportingTimezone, resolveScope: resolveAdminScope }\n\t\tconst resolveTimezone = createTimezoneResolver(timezoneArgs)\n\t\tconst resolveTimezoneStrict = createStrictTimezoneResolver(timezoneArgs)\n\t\tconst resolveCurrency = async (\n\t\t\treq: PayloadRequest,\n\t\t\tscope?: string | null\n\t\t): Promise<string | undefined> => {\n\t\t\tconst opt = resolved.revenue.currency\n\t\t\tif (opt === undefined) {\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst code =\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 resolveAdminScope(req) })\n\t\t\t\treturn code && CURRENCY_PATTERN.test(code) ? code : undefined\n\t\t\t} catch (err) {\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: revenue.currency resolution failed, reporting revenue unformatted: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t}\n\t\tconst itemCollections = itemCollectionsOf(resolved.bindings)\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: resolveCaptureScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tresolveTimezoneStrict,\n\t\t\t\trevenue: {\n\t\t\t\t\tenabled: money,\n\t\t\t\t\tdimension: resolved.revenue.dimension,\n\t\t\t\t\tcurrency: resolveCurrency,\n\t\t\t\t\tconvert: resolved.revenue.convert,\n\t\t\t\t\tbrowserAmounts: resolved.revenue.browserAmounts,\n\t\t\t\t\torderSignature: resolved.revenue.orderSignature,\n\t\t\t\t},\n\t\t\t\tresolveGoals,\n\t\t\t\t...(resolved.scoped && resolved.providers.collection.enabled\n\t\t\t\t\t? { adapterGrantedForScope }\n\t\t\t\t\t: {}),\n\t\t\t\ttrustedProxyHops: resolved.trustedProxyHops,\n\t\t\t\ttrustedPlatform: resolved.trustedPlatform,\n\t\t\t\tallowedOrigins: resolved.capture.allowedOrigins,\n\t\t\t\tadapterCountsWithoutConsent: adapterCountsWithoutConsent(resolved, adapter),\n\t\t\t\t...(itemCollections.size > 0\n\t\t\t\t\t? {\n\t\t\t\t\t\t\titems: {\n\t\t\t\t\t\t\t\tcollections: itemCollections,\n\t\t\t\t\t\t\t\tpages: resolved.capture.autoCapture.items.pages,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t}\n\t\t\t\t\t: {}),\n\t\t\t\troutes,\n\t\t\t\tsdks: resolved.sdks,\n\t\t\t\tjobs: resolved.jobs,\n\t\t\t\tjobsConcurrency,\n\t\t\t\tnotice: context.notice,\n\t\t\t})\n\t\t}\n\t\tassertMaintainRegistered(\n\t\t\tresolved.jobs,\n\t\t\t(config.jobs?.tasks ?? []).some((task) => task.slug === TASK_SLUGS.maintain)\n\t\t)\n\t\t// After registration: an adapter declares what the install measures once it is registered,\n\t\t// and one that declares no revenue then is read as it is rather than as a copy.\n\t\tconst readRegistry = money ? registry : withoutRevenue(registry)\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\taddEndpoints(config, { method: 'get', path: routes.live, handler: makeRealtimeHandler() })\n\t\t}\n\t\tif (Object.keys(resolved.bindings).length > 0) {\n\t\t\taddEndpoints(config, { method: 'get', path: routes.document, handler: makeDocumentHandler() })\n\t\t}\n\t\taddEndpoints(\n\t\t\tconfig,\n\t\t\t{ method: 'get', path: routes.sources, handler: makeSourcesHandler() },\n\t\t\t{ method: 'get', path: routes.goals, handler: makeGoalsHandler() },\n\t\t\t{ method: 'get', path: routes.query, handler: makeQueryHandler() },\n\t\t\t{ method: 'post', path: routes.refresh, handler: makeRefreshHandler() }\n\t\t)\n\t\tif (resolved.providers.collection.enabled) {\n\t\t\tconst providerStatus = makeProviderStatusHandler()\n\t\t\taddEndpoints(\n\t\t\t\tconfig,\n\t\t\t\t{ method: 'get', path: routes.providerStatus, handler: providerStatus },\n\t\t\t\t{ method: 'post', path: routes.providerStatus, handler: providerStatus }\n\t\t\t)\n\t\t}\n\t\tif (resolved.capture.exclusion) {\n\t\t\taddEndpoints(config, {\n\t\t\t\tmethod: 'get',\n\t\t\t\tpath: routes.exclusion,\n\t\t\t\thandler: makeExclusionHandler(),\n\t\t\t})\n\t\t}\n\t\t// One answer serves the view, the widgets and the route, so the flags an install draws and\n\t\t// the route serving them cannot diverge. A host's own flag needs no route, only the import map.\n\t\tconst countryFlags = resolved.countryFlags\n\t\tif (countryFlags === true) {\n\t\t\taddEndpoints(config, {\n\t\t\t\tmethod: 'get',\n\t\t\t\tpath: routes.flagsPattern,\n\t\t\t\thandler: makeFlagsHandler(),\n\t\t\t})\n\t\t} else if (countryFlags !== false) {\n\t\t\taddComponentDependency(config, FLAG_DEPENDENCY, countryFlags.Component)\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\taddEndpoints(config, ...proxyEndpoints(routes), trackerEndpoint(routes))\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\trevenue: money,\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\tcountryFlags,\n\t\t\t\tstaticLabel,\n\t\t\t\toverrides: resolved.widgets.overrides,\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, title: staticLabel(keys.viewTitle) })\n\t\tconst { jobs } = resolved\n\t\tif (jobs !== false && resolved.cache.warm.enabled) {\n\t\t\taddTask(\n\t\t\t\tconfig,\n\t\t\t\twarmTask({\n\t\t\t\t\tschedule: jobs.warm,\n\t\t\t\t\twindowHours: resolved.cache.warm.windowHours,\n\t\t\t\t\tmaxReads: resolved.cache.warm.maxReads,\n\t\t\t\t\tconcurrency: jobsConcurrency,\n\t\t\t\t})\n\t\t\t)\n\t\t}\n\t\tif (sync) {\n\t\t\tconfig.collections = [...(config.collections ?? []), sync]\n\t\t\tif (jobs !== false) {\n\t\t\t\taddTask(\n\t\t\t\t\tconfig,\n\t\t\t\t\tsyncTask({\n\t\t\t\t\t\tschedule: jobs.sync,\n\t\t\t\t\t\tlookbackDays: resolved.sync.lookbackDays,\n\t\t\t\t\t\tcollectionSlug: resolved.sync.collection.slug,\n\t\t\t\t\t\tadapterIds: resolved.sync.adapters,\n\t\t\t\t\t\tscopes: resolved.scope.list,\n\t\t\t\t\t\tconcurrency: jobsConcurrency,\n\t\t\t\t\t})\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\tconst cache = cacheCollectionOf(resolved, context)\n\t\tif (cache) {\n\t\t\tconfig.collections = [...(config.collections ?? []), cache]\n\t\t}\n\t\taddStateCollection(config, resolved, context)\n\t\trestrictJobControls(config)\n\t\t// Hidden per config rather than per process, so two instances answer for themselves; a later\n\t\t// plugin's fields (form-builder's action blocks) take their factory's own `revenue` option.\n\t\tapplyConfigRevenueVisibility(config, money)\n\t\trelabelFactoryFields(config, staticLabel)\n\t\tconfig.endpoints = (config.endpoints ?? []).map((endpoint) =>\n\t\t\tearlierEndpoints.has(endpoint) ? endpoint : pluginEndpoint(endpoint)\n\t\t)\n\t\t// Checked against everything registered so far, the plugin's own collections included; what a\n\t\t// later plugin adds is caught when a runtime is built from the assembled config.\n\t\tassertRoutesReachable(resolved.routes.base, {\n\t\t\tcollections: config.collections ?? [],\n\t\t\tendpoints: config.endpoints,\n\t\t})\n\t\tconst factory = createRuntimeFactory({\n\t\t\tresolved,\n\t\t\tnotices,\n\t\t\tcollections: expectedCollections(config.collections),\n\t\t\tregistry: readRegistry,\n\t\t\tresolveScope,\n\t\t\tresolveTimezone,\n\t\t\tresolveCurrency,\n\t\t})\n\t\tconst adminCustom: AnalyticsAdminCustom = { routes: { base: resolved.routes.base } }\n\t\tconfig.custom = { ...config.custom, [ANALYTICS_CONFIG_KEY]: factory }\n\t\tconfig.admin = {\n\t\t\t...config.admin,\n\t\t\tcustom: { ...config.admin?.custom, [ANALYTICS_CONFIG_KEY]: adminCustom },\n\t\t}\n\t\tconst prevOnInit = config.onInit\n\t\t// Validation only: the runtime builds on first use either way, and is built here so consumer\n\t\t// init code (seeding, cache warming, sync passes) runs against a warm one.\n\t\tconfig.onInit = async (payload) => {\n\t\t\t// Without the factory every endpoint answers 503; a boot error names the cause instead.\n\t\t\tif (runtimeFactoryOf(payload.config) !== factory) {\n\t\t\t\tthrow new Error(RUNTIME_FACTORY_LOST)\n\t\t\t}\n\t\t\tawait factory.validate(payload)\n\t\t\tgetRuntime(payload)\n\t\t\tawait prevOnInit?.(payload)\n\t\t}\n\t\treturn config\n\t},\n})\n\n/** Said at boot when a step after the plugin dropped its runtime from `config.custom`. */\nconst RUNTIME_FACTORY_LOST = `analytics: config.custom[\"${ANALYTICS_CONFIG_KEY}\"] no longer holds the analytics runtime: a plugin or config step that runs after analytics replaced config.custom instead of spreading it. Spread the existing value there ({ ...config.custom, ... }), or list analytics after that plugin.`\n\nexport { isAdminUser } from './access/adminUser'\nexport { type TenantMembershipOptions, tenantMembership } from './access/membership'\nexport { type GatedScope, type ReadPrincipal, SYSTEM } from './access/principal'\nexport { ProviderHttpError, parseRetryAfter } from './adapters/http/fetchJson'\nexport type { ReportMode, ReportOption } from './binding/report'\nexport type {\n\tAnalyticsBinding,\n\tBindingContext,\n\tBindingDoc,\n\tHostnameResolver,\n\tPathResolver,\n} from './binding/types'\nexport type { CapabilityRequirement, FilterPair, SerializedCapabilities } from './core/capabilities'\nexport {\n\ttype AnalyticsQuery,\n\ttype AnalyticsResult,\n\tPLATFORM_SCOPE,\n} from './core/contract'\nexport type {\n\tAnalyticsAccessOptions,\n\tAnalyticsCacheCollectionOptions,\n\tAnalyticsCacheOptions,\n\tAnalyticsCaptureOptions,\n\tAnalyticsCollectionOptions,\n\tAnalyticsComponent,\n\tAnalyticsConcurrencyOptions,\n\tAnalyticsCountryFlags,\n\tAnalyticsCrossScopeOptions,\n\tAnalyticsExclusionOptions,\n\tAnalyticsGoalsCollectionOptions,\n\tAnalyticsGoalsOptions,\n\tAnalyticsHooksOptions,\n\tAnalyticsJobsOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsPluginOptions as PluginOptions,\n\tAnalyticsReadAccess,\n\tAnalyticsRevenueOptions,\n\tAnalyticsRoutesOptions,\n\tAnalyticsScopeOptions,\n\tAnalyticsSourceOptions,\n\tAnalyticsSyncCollectionOptions,\n\tAnalyticsSyncOptions,\n\tAnalyticsTaskOptions,\n\tAnalyticsViewAccess,\n\tAnalyticsViewOptions,\n\tAnalyticsWarmOptions,\n\tAnalyticsWidgetOverride,\n\tAnalyticsWidgetOverrides,\n\tAnalyticsWidgetsOptions,\n\tAutoCaptureOptions,\n\tCaptureGate,\n\tCaptureGateArgs,\n\tCaptureSlotOption,\n\tCollectionOverrides,\n\tCrossScopeAccess,\n\tCurrencyConverter,\n\tCurrencyResolver,\n\tDefaultSourceFunction,\n\tDefaultSourceRule,\n\tExclusionSitesResolver,\n\tItemCaptureOptions,\n\tOwnSource,\n\tProviderHostsOptions,\n\tProvidersCollectionOptions,\n\tProvidersOptions,\n\tProvidersResolve,\n\tProvidersResolveArgs,\n\tScopeCallSite,\n\tScopeLabelResolver,\n\tScopeListResolver,\n\tScopeMemberAccess,\n\tScopeResolver,\n\tSourcePolicy,\n\tSourcePolicyFunction,\n\tSourceRef,\n\tTimezoneResolver,\n\tWithoutConsentArgs,\n\tWithoutConsentFunction,\n\tWithoutConsentOption,\n} from './core/options'\nexport type {\n\tAnalyticsSdks,\n\tGa4Client,\n\tGa4ClientOptions,\n\tGa4ReportResponse,\n\tGa4ReportRow,\n\tGa4Sdk,\n\tMaxmindReader,\n\tMaxmindSdk,\n} from './core/sdks'\nexport type {\n\tServerEventInput,\n\tServerTrack,\n\tServerTrackIdentity,\n\tServerTrackOptions,\n} from './core/serverEvent'\nexport { AnalyticsTrackError } from './core/serverEvent'\nexport { BUILT_IN_WIDGET_SLUGS, type BuiltInWidgetSlug } from './core/widgetSlugs'\nexport type * from './exports/adapters/contract'\nexport type { AnalyticsAttributes } from './exports/attributes'\nexport type {\n\tAnalyticsFieldsOptions,\n\tAnalyticsMetricLabel,\n\tAnalyticsMetricLabels,\n\tAnalyticsStatBaseOptions,\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 {\n\tFieldBreakdown,\n\tFieldBreakdownRow,\n\tFieldReadResult,\n\tFieldReadStatus,\n\tReadForFieldArgs,\n} from './fields/readForDocument'\nexport { readForField } from './fields/readForDocument'\nexport type {\n\tGoalCollectionFieldOverrides,\n\tGoalFieldOverride,\n} from './goals/collection'\nexport { GOALS_SLUG } from './goals/collection'\nexport {\n\tCURRENCY_ATTRIBUTE,\n\tEVENT_ATTRIBUTE,\n\tEVENT_PROP_PREFIX,\n\tGOAL_ATTRIBUTE,\n\tITEM_ATTRIBUTE,\n\tITEM_CLICK_EVENT,\n\tITEM_NAME_ATTRIBUTE,\n\tMAX_ITEMS_PER_BEACON,\n\tPURCHASE_GOAL_SLUG,\n\tVALUE_ATTRIBUTE,\n} from './goals/constants'\nexport type { GoalFieldOptions } from './goals/goalField'\nexport { goalField, goalSlug } from './goals/goalField'\nexport type { GoalsResponse, WireGoal } from './goals/goalsEndpoint'\nexport type { AnalyticsLinkFieldsOptions } from './goals/linkFields'\nexport { analyticsLinkFields } from './goals/linkFields'\nexport type { BrowserAmounts, OrderSignatureMode } from './goals/match'\nexport type { GoalSource } from './goals/resolver'\nexport type {\n\tPurchaseInput as ServerPurchaseInput,\n\tRefundInput as ServerRefundInput,\n} from './goals/serverRevenue'\nexport { purchase, refund } from './goals/serverRevenue'\nexport type {\n\tGoalActionDefinition,\n\tGoalActionRunArgs,\n\tTrackGoalActionOptions,\n} from './goals/trackGoalAction'\nexport { GOAL_ACTION_TYPE, trackGoalAction } from './goals/trackGoalAction'\nexport type { Goal } from './goals/types'\nexport { STATE_SLUG } from './native/collections/slugs'\nexport type { RebuildDaysInput, RebuildDaysReport } from './native/engine/rebuild'\nexport {\n\ttype ItemSignatureMode,\n\titemAttributesFor,\n\tsignItemRef,\n} from './native/ingest/itemSignature'\nexport { signOrderId } from './native/ingest/orderSignature'\nexport { trackServerEvent } from './native/ingest/serverTrack'\nexport { rebuildDays } from './native/rebuildDays'\nexport {\n\tcreateGuardedFetch,\n\ttype GuardedFetch,\n\ttype GuardedFetchOptions,\n} from './net/guardedFetch'\nexport type { TrustedPlatform } from './net/platform'\nexport type { CollectionFieldOverride } from './plugin/collectionFields'\nexport {\n\tANALYTICS_ERROR_CODES,\n\ttype AnalyticsError,\n\ttype AnalyticsErrorCode,\n\tanalyticsError,\n\treadErrorCode,\n} from './plugin/errors'\nexport type { RoutesConfigSource } from './plugin/routes'\nexport {\n\tanalyticsRoutes,\n\tDEFAULT_ROUTE_BASE,\n\ttype RouteBase,\n\ttype RoutePaths,\n\troutePaths,\n} from './plugin/routes'\nexport type {\n\tBuildSecretField,\n\tConnectionAccess,\n\tConnectionFieldAccess,\n\tProviderCollectionFieldOverrides,\n\tProviderFieldOverride,\n\tProviderFieldsOptions,\n} from './providers/collection'\nexport { analyticsProviderFields, PROVIDERS_SLUG } from './providers/collection'\nexport type { ProviderDoc, ProviderFactoryContext } from './providers/factory'\nexport { adapterFromProviderDoc } from './providers/factory'\nexport type { HostPattern } from './providers/hosts'\nexport { type ProviderHostPolicy, resolveHostPolicy } from './providers/hosts'\nexport { PROVIDER_IDS, type ProviderId } from './providers/ids'\nexport { type RefreshProvidersOptions, refreshProviders } from './providers/refresh'\nexport { CONNECTION_PATHS, SECRET_PATHS } from './providers/secrets'\nexport type { QueryError, QueryErrorCode } from './query/errors'\nexport type {\n\tItemLabels,\n\tQueryErrorResponse,\n\tQueryResponse,\n\tQuerySourceRef,\n\tSerializedAnalyticsQuery,\n} from './query/response'\nexport type {\n\tAfterReadAnswer,\n\tAfterReadArgs,\n\tAfterReadHook,\n\tReadOrigin,\n} from './surfacing/afterRead'\nexport { CACHE_SLUG } from './surfacing/cacheCollection'\nexport type {\n\tCacheEntry,\n\tCacheSetOptions,\n\tCacheStore,\n\tReadRecipe,\n\tRecipeWindow,\n} from './surfacing/cacheStore'\nexport { SYNC_SLUG } from './sync/collection'\nexport { TIMEFRAME_PRESETS, type TimeframePreset } from './timeframe/presets'\nexport type { GoalMatch, RevenueItem, TrackerGoal } from './tracker/config'\nexport type { TranslationsOption } from './translations'\nexport {\n\tkeys,\n\ttype PluralCategory,\n\ttype PluralName,\n\ttype PluralVariant,\n\tpluralKeys,\n\ttype SingularKey,\n\ttype TranslationKey,\n} from './translations/keys'\nexport type { CustomWidgetDef } from './widgets/customWidget'\nexport {\n\ttype AnalyticsDefaultLayoutOptions,\n\tanalyticsDefaultLayout,\n} from './widgets/defaultLayout'\nexport { analyticsDefaultWidgets } from './widgets/defaults'\nexport { widgetFilters } from './widgets/filterField'\nexport type { StoredSourceRead, SubstitutedSource } from './widgets/prepareWidgetRead'\nexport type {\n\tReadForWidgetArgs,\n\tWidgetReadResult,\n\tWidgetReadStatus,\n} from './widgets/readForWidget'\nexport { readForWidget } from './widgets/readForWidget'\nexport type {\n\tBreakdownRow,\n\tReadForWidgetBreakdownArgs,\n\tWidgetBreakdownResult,\n} from './widgets/readForWidgetBreakdown'\nexport { readForWidgetBreakdown } from './widgets/readForWidgetBreakdown'\nexport type {\n\tGoalRow,\n\tReadForWidgetGoalsArgs,\n\tWidgetGoalsResult,\n} from './widgets/readForWidgetGoals'\nexport { readForWidgetGoals } from './widgets/readForWidgetGoals'\nexport type {\n\tReadForWidgetRealtimeArgs,\n\tRealtimePoint,\n\tWidgetRealtimeResult,\n\tWidgetRealtimeStatus,\n} from './widgets/readForWidgetRealtime'\nexport { readForWidgetRealtime } from './widgets/readForWidgetRealtime'\nexport type {\n\tReadForWidgetSeriesArgs,\n\tSeriesGranularity,\n\tSeriesPoint,\n\tWidgetSeriesResult,\n} from './widgets/readForWidgetSeries'\nexport { readForWidgetSeries } from './widgets/readForWidgetSeries'\nexport type { ReadNotices } from './widgets/readMeta'\nexport type { WidgetFilter } from './widgets/types'\n"],"mappings":"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"}
@@ -1,7 +1,7 @@
1
1
  import { valueAt } from "../../core/values.js";
2
2
  import { clientIpFromHeaders } from "../ingest/clientIp.js";
3
- import { loadMaxmind } from "../../plugin/peers.js";
4
3
  import { geoOf, loadsMaxmindAtRuntime } from "./geoResolver.js";
4
+ import { loadMaxmind } from "../../plugin/peers.js";
5
5
  //#region src/native/geo/maxmindResolver.ts
6
6
  /**
7
7
  * MaxMind GeoLite2 resolver, opened on first use. Any failure degrades to empty geo after one
@@ -9,7 +9,6 @@ import { adapterWithoutConsent, cookielessCapture } from "../capture/withoutCons
9
9
  import { DEFAULT_STORE_SLUGS } from "./collections/slugs.js";
10
10
  import { resolveCollectionOption } from "../core/collectionOption.js";
11
11
  import { DEFAULT_JOBS } from "../core/jobs.js";
12
- import { MAXMIND_SDK_WARNING, isProductionBuild } from "../plugin/peers.js";
13
12
  import "../goals/match.js";
14
13
  import { LEGACY_NATIVE_OPTIONS, assertNoLegacyOptions } from "../core/legacyOptions.js";
15
14
  import { dbKind, isD1 } from "../db/kind.js";
@@ -30,6 +29,7 @@ import { itemIdTypes } from "../items/collectionIdType.js";
30
29
  import { itemRefKey } from "./ingest/itemSignature.js";
31
30
  import { makeServerTrack } from "./ingest/serverTrack.js";
32
31
  import { createKeepAlive } from "../plugin/keepAlive.js";
32
+ import { MAXMIND_SDK_WARNING, isProductionBuild } from "../plugin/peers.js";
33
33
  import { stateCollection } from "./collections/state.js";
34
34
  import { addTask, schemaOnlyTask } from "../plugin/schemaOnly.js";
35
35
  import { aggregatesCollection } from "./collections/aggregates.js";
@@ -5,39 +5,41 @@ import { describeWithCauses } from "../core/sourceErrors.js";
5
5
  import { currentDate, currentTime } from "../core/clock.js";
6
6
  import { createEpochStore } from "../surfacing/epoch.js";
7
7
  import { getRuntime } from "./runtime.js";
8
+ import { documentIdOf } from "../providers/ids.js";
9
+ import { BREAKER_MAX_MS } from "../surfacing/breaker.js";
8
10
  import { emptyTrackerConfig } from "../site/getTrackerConfig.js";
9
11
  import { resolveTrackerConfig } from "../capture/trackerConfig.js";
10
12
  import { TASK_SLUGS } from "../core/jobs.js";
11
13
  import { monotonicMs } from "../core/monotonic.js";
12
14
  import { ABANDON_AFTER_MS, createLanes, pooledConcurrency } from "../surfacing/lanes.js";
13
- import { collectingPageData } from "./buildPhase.js";
14
- import { isProductionBuild } from "./peers.js";
15
15
  import { cookielessTrustNotice, documentsFillHeldTenant, followingCountsWithoutConsent, trackerAutoCapture, untrustedAddressNotice, withoutConsentUnsetNotice } from "../core/captureOptions.js";
16
16
  import { revenueOffWarning } from "../core/goalOptions.js";
17
17
  import { DEFAULT_BINDING_SCOPE_FIELD } from "../core/options.js";
18
18
  import { configGoalsResolver, createGoalsResolver } from "../goals/resolver.js";
19
19
  import { recheckCollections } from "./collectionChecks.js";
20
- import { throttled } from "../core/throttle.js";
20
+ import { WARN_EVERY_MS, throttled } from "../core/throttle.js";
21
21
  import { hostHoldsWriteLock, sqliteTransactionsNotice } from "../db/detachedWrite.js";
22
22
  import { createHeartbeatWatch } from "../maintenance/heartbeat.js";
23
23
  import { stateLease, stateStoreOf } from "../maintenance/lease.js";
24
24
  import { trackServerEvent } from "../native/ingest/serverTrack.js";
25
25
  import { createKeepAlive } from "./keepAlive.js";
26
+ import { collectingPageData } from "./buildPhase.js";
27
+ import { isProductionBuild } from "./peers.js";
26
28
  import { narrowStatsGlobal } from "./jobsAccess.js";
27
29
  import { loadEncrypted } from "./encrypted.js";
28
30
  import { SWEEP_LEASE, SWEEP_LEASE_MS, createCacheSweeper } from "../surfacing/cacheSweep.js";
29
31
  import { NATIVE_ADAPTER_ID } from "../native/nativeAdapter.js";
30
32
  import { createGuardedFetch } from "../net/guardedFetch.js";
33
+ import { createConnectionRecheck } from "../providers/connectionCheck.js";
31
34
  import { configTokenBackend } from "../providers/refresh.js";
32
35
  import { createProviderRegistry } from "../providers/registry.js";
36
+ import { connectionOutcomeOf, providerStatusStore } from "../providers/status.js";
33
37
  import { collectionCacheStore } from "../surfacing/collectionCacheStore.js";
34
38
  import { createMemo } from "../surfacing/memo.js";
35
39
  import { createEngine } from "../surfacing/engine.js";
36
40
  import { assertRoutesReachable } from "./routeChecks.js";
37
41
  import { validateScopeField } from "./scopeFieldBoot.js";
38
42
  //#region src/plugin/createRuntime.ts
39
- /** How often a failing read cache, or a throwing `hooks.afterRead`, is reported, at most. */
40
- const CACHE_WARN_EVERY_MS = 6e4;
41
43
  /** node-postgres' own default for the pool's `max`. */
42
44
  const PG_DEFAULT_POOL_MAX = 10;
43
45
  /** The host's node-postgres pool size, or undefined on another database. */
@@ -80,9 +82,10 @@ const goalsResolverFor = (payload, resolved, now) => resolved.goalsCollection.en
80
82
  * Native reads stay out of the global cap, so a slow vendor never queues them; on a scoped install
81
83
  * every config adapter serves all scopes, so one scope holds at most half of its lane.
82
84
  */
83
- const lanesFor = (payload, resolved, plan) => {
85
+ const lanesFor = (payload, resolved, { plan, status, statusWarning, versionOf }) => {
84
86
  const { concurrency } = resolved.cache;
85
87
  const configAdapters = new Set(resolved.adapters);
88
+ const configIds = new Set(resolved.adapters.map((adapter) => adapter.id));
86
89
  const poolMax = postgresPoolMax(payload);
87
90
  return createLanes({
88
91
  global: concurrency.global,
@@ -93,7 +96,20 @@ const lanesFor = (payload, resolved, plan) => {
93
96
  },
94
97
  ...resolved.scoped ? { shared: (adapter) => configAdapters.has(adapter) } : {},
95
98
  ...plan.kind === "resolve" ? { rebuilt: (adapter) => !configAdapters.has(adapter) } : {},
96
- onAbandon: (adapter) => payload.logger?.warn(`analytics: a request to the "${adapter.id}" source ignored its abort signal and was still out ${ABANDON_AFTER_MS / 1e3} seconds after its read gave up, so its slot was given back and it counts as a timeout. An adapter must pass ctx.signal (or the signal ctx.upstream hands it) to every request it sends; this is said once per source.`)
99
+ onAbandon: (adapter) => payload.logger?.warn(`analytics: a request to the "${adapter.id}" source ignored its abort signal and was still out ${ABANDON_AFTER_MS / 1e3} seconds after its read gave up, so its slot was given back and it counts as a timeout. An adapter must pass ctx.signal (or the signal ctx.upstream hands it) to every request it sends; this is said once per source.`),
100
+ ...status ? { onOutcome: (adapter, outcome, health) => {
101
+ const docId = configIds.has(adapter.id) ? void 0 : documentIdOf(adapter.id);
102
+ const told = connectionOutcomeOf(outcome, health);
103
+ if (docId === void 0 || told === void 0) return;
104
+ const version = versionOf?.(adapter);
105
+ const options = version === void 0 ? { throttle: true } : {
106
+ throttle: true,
107
+ version
108
+ };
109
+ status.record(docId, told, options).catch((err) => {
110
+ statusWarning(`analytics: the connection status of provider document "${docId}" could not be saved, reads go on without it: ${String(err)}`);
111
+ });
112
+ } } : {}
97
113
  });
98
114
  };
99
115
  /** The runtime fields config time settled outright, alike for every instance. */
@@ -194,8 +210,13 @@ const createRuntimeFactory = (args) => {
194
210
  warn: (message) => payload.logger?.warn(message)
195
211
  }) : void 0;
196
212
  const epoch = createEpochStore(payload);
213
+ const providerStatus = plan.kind === "collection" ? providerStatusStore(payload) : void 0;
197
214
  const now = currentTime;
198
215
  const warn = (message) => payload.logger?.warn(message);
216
+ const providerStatusWarning = throttled(warn, {
217
+ now: monotonicMs,
218
+ intervalMs: WARN_EVERY_MS
219
+ });
199
220
  const registry = createProviderRegistry({
200
221
  payload,
201
222
  plan,
@@ -218,6 +239,15 @@ const createRuntimeFactory = (args) => {
218
239
  }) } : {},
219
240
  now
220
241
  });
242
+ const providerRecheck = providerStatus && registry.documentAdapter ? createConnectionRecheck({
243
+ payload,
244
+ store: providerStatus,
245
+ adapterFor: registry.documentAdapter,
246
+ ...registry.versionOf ? { versionOf: registry.versionOf } : {},
247
+ now: monotonicMs,
248
+ cooldownMs: BREAKER_MAX_MS,
249
+ warn
250
+ }) : void 0;
221
251
  const goals = goalsResolverFor(payload, resolved, now);
222
252
  const configEpoch = plan.kind === "static" && !resolved.goalsCollection.enabled ? void 0 : async (scope) => {
223
253
  const [providerEpoch, goalsEpoch] = await Promise.all([registry.epoch(scope ?? null), goals.epoch(scope)]);
@@ -242,7 +272,7 @@ const createRuntimeFactory = (args) => {
242
272
  }) : void 0;
243
273
  const cacheWarning = throttled(warn, {
244
274
  now: monotonicMs,
245
- intervalMs: CACHE_WARN_EVERY_MS
275
+ intervalMs: WARN_EVERY_MS
246
276
  });
247
277
  const onStoreError = (err, operation) => {
248
278
  cacheWarning(`analytics: the read cache failed to ${operation}, reads go on without it: ${String(err)}`);
@@ -254,21 +284,26 @@ const createRuntimeFactory = (args) => {
254
284
  const afterRead = resolved.hooks.afterRead;
255
285
  const hookWarning = throttled(warn, {
256
286
  now: monotonicMs,
257
- intervalMs: CACHE_WARN_EVERY_MS
287
+ intervalMs: WARN_EVERY_MS
258
288
  });
259
289
  const engine = createEngine({
260
290
  payload,
261
291
  store,
262
292
  memo,
263
- lanes: lanesFor(payload, resolved, plan),
293
+ lanes: lanesFor(payload, resolved, {
294
+ plan,
295
+ status: providerStatus,
296
+ statusWarning: providerStatusWarning,
297
+ versionOf: registry.versionOf
298
+ }),
264
299
  coldReadsPerScope: resolved.cache.concurrency.perScope,
265
300
  ttl: resolved.cache.ttl,
266
301
  timeoutMs: resolved.cache.timeoutMs,
267
302
  epoch,
268
303
  ...configEpoch ? { configEpoch } : {},
269
304
  now,
270
- onError: (err, adapterId) => {
271
- warn(`analytics: read failed for adapter "${adapterId}": ${describeWithCauses(err)}`);
305
+ onError: (err, adapterId, scope) => {
306
+ warn(`analytics: read failed for adapter "${adapterId}" (${scope === null ? "install-wide" : `scope "${scope}"`}): ${describeWithCauses(err)}`);
272
307
  },
273
308
  onStoreError,
274
309
  onWrite: () => sweeper.maybeSweep(),
@@ -291,12 +326,21 @@ const createRuntimeFactory = (args) => {
291
326
  listGoals: goals.listReadable,
292
327
  listGoalsAcross: goals.listAcross,
293
328
  ...providerConnections ? { providerFetch: providerConnections.fetch } : {},
329
+ ...providerStatus ? {
330
+ providerStatus,
331
+ providerStatusWarning
332
+ } : {},
333
+ ...registry.documentAdapter ? { providerAdapter: registry.documentAdapter } : {},
334
+ ...registry.versionOf ? { providerVersionOf: registry.versionOf } : {},
335
+ ...providerRecheck ? { providerRecheck } : {},
294
336
  close: async () => {
295
337
  await Promise.all([
296
338
  engine.close(),
297
339
  sweeper.idle(),
298
- syncWatch?.idle()
340
+ syncWatch?.idle(),
341
+ providerRecheck?.idle()
299
342
  ]);
343
+ await providerStatus?.idle();
300
344
  await registry.close();
301
345
  await providerConnections?.close();
302
346
  },