@10x-media/analytics 0.1.0-beta.0 → 0.1.0-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +71 -0
- package/README.md +37 -357
- package/dist/adapters/ga4/ga4.d.ts +20 -0
- package/dist/adapters/ga4/ga4.js +177 -0
- package/dist/{fetchJson-DZb2_Puj.js → adapters/http/fetchJson.js} +2 -2
- package/dist/adapters/http/fetchJson.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +15 -0
- package/dist/adapters/plausible/plausible.js +143 -0
- package/dist/adapters/posthog/posthog.d.ts +23 -0
- package/dist/adapters/posthog/posthog.js +121 -0
- package/dist/adapters/posthog/posthog.js.map +1 -0
- package/dist/{series-zytbzPoc.js → adapters/series.js} +2 -2
- package/dist/adapters/series.js.map +1 -0
- package/dist/adapters/umami/umami.d.ts +18 -0
- package/dist/adapters/umami/umami.js +139 -0
- package/dist/binding/resolvePath.js +61 -0
- package/dist/binding/resolvePath.js.map +1 -0
- package/dist/binding/types.d.ts +53 -0
- package/dist/charts/BarList.d.ts +20 -0
- package/dist/charts/BarList.js +73 -0
- package/dist/charts/BarList.js.map +1 -0
- package/dist/charts/TrendChart.d.ts +25 -0
- package/dist/charts/TrendChart.js +186 -0
- package/dist/charts/TrendChart.js.map +1 -0
- package/dist/charts/bars.d.ts +9 -0
- package/dist/charts/bars.js +19 -0
- package/dist/charts/bars.js.map +1 -0
- package/dist/charts/bucket.js +79 -0
- package/dist/charts/bucket.js.map +1 -0
- package/dist/charts/spline.js +84 -0
- package/dist/charts/spline.js.map +1 -0
- package/dist/charts/styles.js +42 -0
- package/dist/charts/styles.js.map +1 -0
- package/dist/core/cacheKey.js +31 -0
- package/dist/core/cacheKey.js.map +1 -0
- package/dist/core/capabilities.d.ts +12 -0
- package/dist/core/capabilities.js +12 -0
- package/dist/core/capabilities.js.map +1 -0
- package/dist/{contract-CWZPKWuR.d.ts → core/contract.d.ts} +30 -4
- package/dist/core/contract.js +10 -0
- package/dist/core/contract.js.map +1 -0
- package/dist/core/granularity.js +17 -0
- package/dist/core/granularity.js.map +1 -0
- package/dist/core/options.d.ts +115 -0
- package/dist/core/options.js +107 -0
- package/dist/core/options.js.map +1 -0
- package/dist/core/registry.js +24 -0
- package/dist/core/registry.js.map +1 -0
- package/dist/core/scopedRead.js +57 -0
- package/dist/core/scopedRead.js.map +1 -0
- package/dist/exports/adapters/ga4.d.ts +2 -20
- package/dist/exports/adapters/ga4.js +1 -176
- package/dist/exports/adapters/native.d.ts +2 -22
- package/dist/exports/adapters/native.js +1 -848
- package/dist/exports/adapters/plausible.d.ts +2 -15
- package/dist/exports/adapters/plausible.js +1 -142
- package/dist/exports/adapters/posthog.d.ts +2 -17
- package/dist/exports/adapters/posthog.js +1 -118
- package/dist/exports/adapters/umami.d.ts +2 -18
- package/dist/exports/adapters/umami.js +1 -138
- package/dist/exports/client.d.ts +5 -77
- package/dist/exports/client.js +4 -386
- package/dist/exports/geo.d.ts +4 -19
- package/dist/exports/geo.js +3 -1
- package/dist/exports/i18n.d.ts +3 -63
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/next.d.ts +2 -0
- package/dist/exports/next.js +2 -0
- package/dist/exports/rsc.d.ts +13 -120
- package/dist/exports/rsc.js +10 -597
- package/dist/exports/types.d.ts +6 -4
- package/dist/exports/types.js +2 -1
- package/dist/fields/AnalyticsStatField.d.ts +31 -0
- package/dist/fields/AnalyticsStatField.js +93 -0
- package/dist/fields/AnalyticsStatField.js.map +1 -0
- package/dist/fields/dateRange/field.js +55 -0
- package/dist/fields/dateRange/field.js.map +1 -0
- package/dist/fields/dateRange/styles.js +23 -0
- package/dist/fields/dateRange/styles.js.map +1 -0
- package/dist/fields/dateRange/types.d.ts +11 -0
- package/dist/fields/dateRange/ui.d.ts +9 -0
- package/dist/fields/dateRange/ui.js +373 -0
- package/dist/fields/dateRange/ui.js.map +1 -0
- package/dist/fields/factories.d.ts +52 -0
- package/dist/fields/factories.js +65 -0
- package/dist/fields/factories.js.map +1 -0
- package/dist/fields/format.d.ts +7 -0
- package/dist/fields/format.js +22 -0
- package/dist/fields/format.js.map +1 -0
- package/dist/fields/readForDocument.js +107 -0
- package/dist/fields/readForDocument.js.map +1 -0
- package/dist/index.d.ts +18 -3
- package/dist/index.js +55 -1025
- package/dist/index.js.map +1 -1
- package/dist/native/collections/events.js +101 -0
- package/dist/native/collections/events.js.map +1 -0
- package/dist/native/collections/rollups.js +115 -0
- package/dist/native/collections/rollups.js.map +1 -0
- package/dist/native/collections/seen.js +47 -0
- package/dist/native/collections/seen.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +7 -0
- package/dist/native/geo/composeGeoResolvers.js +14 -0
- package/dist/native/geo/composeGeoResolvers.js.map +1 -0
- package/dist/{geoResolver-CasIa4T9.d.ts → native/geo/geoResolver.d.ts} +2 -2
- package/dist/native/geo/geoResolver.js +11 -0
- package/dist/native/geo/geoResolver.js.map +1 -0
- package/dist/native/geo/maxmindResolver.d.ts +16 -0
- package/dist/native/geo/maxmindResolver.js +55 -0
- package/dist/native/geo/maxmindResolver.js.map +1 -0
- package/dist/native/ingest/device.js +15 -0
- package/dist/native/ingest/device.js.map +1 -0
- package/dist/native/ingest/endpoint.js +27 -0
- package/dist/native/ingest/endpoint.js.map +1 -0
- package/dist/native/ingest/flushBatch.js +69 -0
- package/dist/native/ingest/flushBatch.js.map +1 -0
- package/dist/native/ingest/normalizeEvent.js +38 -0
- package/dist/native/ingest/normalizeEvent.js.map +1 -0
- package/dist/native/ingest/salt.js +14 -0
- package/dist/native/ingest/salt.js.map +1 -0
- package/dist/native/ingest/source.js +22 -0
- package/dist/native/ingest/source.js.map +1 -0
- package/dist/native/ingest/visitorHash.js +12 -0
- package/dist/native/ingest/visitorHash.js.map +1 -0
- package/dist/native/ingest/writeBuffer.js +55 -0
- package/dist/native/ingest/writeBuffer.js.map +1 -0
- package/dist/native/ingest/writeEvent.js +13 -0
- package/dist/native/ingest/writeEvent.js.map +1 -0
- package/dist/native/nativeAdapter.d.ts +22 -0
- package/dist/native/nativeAdapter.js +213 -0
- package/dist/native/nativeAdapter.js.map +1 -0
- package/dist/native/realtime/buildRealtime.js +53 -0
- package/dist/native/realtime/buildRealtime.js.map +1 -0
- package/dist/native/retention/pruneTask.js +29 -0
- package/dist/native/retention/pruneTask.js.map +1 -0
- package/dist/native/rollupAcc.js +50 -0
- package/dist/native/rollupAcc.js.map +1 -0
- package/dist/native/rollups/applyDistinctDeltas.js +9 -0
- package/dist/native/rollups/applyDistinctDeltas.js.map +1 -0
- package/dist/native/rollups/bumpRollup.js +52 -0
- package/dist/native/rollups/bumpRollup.js.map +1 -0
- package/dist/native/rollups/deltas.js +31 -0
- package/dist/native/rollups/deltas.js.map +1 -0
- package/dist/native/rollups/insertIfNew.js +19 -0
- package/dist/native/rollups/insertIfNew.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +36 -0
- package/dist/next/posthogProxyRewrites.js +50 -0
- package/dist/next/posthogProxyRewrites.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +36 -0
- package/dist/plugin/realtimeEndpoint.js.map +1 -0
- package/dist/plugin/registerTranslations.js +19 -0
- package/dist/plugin/registerTranslations.js.map +1 -0
- package/dist/plugin/runtime.js +20 -0
- package/dist/plugin/runtime.js.map +1 -0
- package/dist/plugin/warmTask.js +165 -0
- package/dist/plugin/warmTask.js.map +1 -0
- package/dist/providers/collection.js +159 -0
- package/dist/providers/collection.js.map +1 -0
- package/dist/providers/factory.js +62 -0
- package/dist/providers/factory.js.map +1 -0
- package/dist/providers/resolver.js +67 -0
- package/dist/providers/resolver.js.map +1 -0
- package/dist/providers/secrets.js +27 -0
- package/dist/providers/secrets.js.map +1 -0
- package/dist/surfacing/cacheStore.js +26 -0
- package/dist/surfacing/cacheStore.js.map +1 -0
- package/dist/surfacing/coalesce.js +15 -0
- package/dist/surfacing/coalesce.js.map +1 -0
- package/dist/surfacing/engine.js +63 -0
- package/dist/surfacing/engine.js.map +1 -0
- package/dist/surfacing/queue.js +44 -0
- package/dist/surfacing/queue.js.map +1 -0
- package/dist/sync/collection.js +65 -0
- package/dist/sync/collection.js.map +1 -0
- package/dist/sync/syncTask.js +123 -0
- package/dist/sync/syncTask.js.map +1 -0
- package/dist/testing/memoryAdapter.d.ts +1 -1
- package/dist/timeframe/presets.d.ts +6 -0
- package/dist/timeframe/presets.js +63 -0
- package/dist/timeframe/presets.js.map +1 -0
- package/dist/{translations-keiKtSjF.js → translations/en.js} +25 -23
- package/dist/translations/en.js.map +1 -0
- package/dist/translations/index.d.ts +14 -0
- package/dist/translations/index.js +26 -0
- package/dist/translations/index.js.map +1 -0
- package/dist/translations/keys.d.ts +78 -0
- package/dist/{keys-DEqL4LOT.js → translations/keys.js} +24 -3
- package/dist/translations/keys.js.map +1 -0
- package/dist/translations/metricKeys.js +30 -0
- package/dist/translations/metricKeys.js.map +1 -0
- package/dist/translations/server.js +13 -0
- package/dist/translations/server.js.map +1 -0
- package/dist/translations/useTranslation.js +12 -0
- package/dist/translations/useTranslation.js.map +1 -0
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -0
- package/dist/widgets/AnalyticsBreakdownWidget.js +85 -0
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -0
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -0
- package/dist/widgets/AnalyticsMetricWidget.js +81 -0
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -0
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -0
- package/dist/widgets/AnalyticsRealtimeWidget.js +64 -0
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -0
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -0
- package/dist/widgets/AnalyticsTrendWidget.js +91 -0
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -0
- package/dist/widgets/RealtimeCounter.d.ts +19 -0
- package/dist/widgets/RealtimeCounter.js +76 -0
- package/dist/widgets/RealtimeCounter.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +29 -0
- package/dist/widgets/breakdownTypes.js.map +1 -0
- package/dist/widgets/cardChrome.js +22 -0
- package/dist/widgets/cardChrome.js.map +1 -0
- package/dist/widgets/customWidget.d.ts +20 -0
- package/dist/widgets/customWidget.js +30 -0
- package/dist/widgets/customWidget.js.map +1 -0
- package/dist/widgets/defaults.d.ts +12 -0
- package/dist/widgets/defaults.js +72 -0
- package/dist/widgets/defaults.js.map +1 -0
- package/dist/widgets/range.js +28 -0
- package/dist/widgets/range.js.map +1 -0
- package/dist/widgets/readForWidget.d.ts +27 -0
- package/dist/widgets/readForWidget.js +57 -0
- package/dist/widgets/readForWidget.js.map +1 -0
- package/dist/widgets/readForWidgetBreakdown.d.ts +38 -0
- package/dist/widgets/readForWidgetBreakdown.js +75 -0
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -0
- package/dist/{readForWidgetRealtime-D1BD37ST.d.ts → widgets/readForWidgetRealtime.d.ts} +5 -3
- package/dist/widgets/readForWidgetRealtime.js +63 -0
- package/dist/widgets/readForWidgetRealtime.js.map +1 -0
- package/dist/widgets/readForWidgetSeries.d.ts +38 -0
- package/dist/widgets/readForWidgetSeries.js +97 -0
- package/dist/widgets/readForWidgetSeries.js.map +1 -0
- package/dist/widgets/realtimePoll.js +26 -0
- package/dist/widgets/realtimePoll.js.map +1 -0
- package/dist/widgets/registerWidgets.js +249 -0
- package/dist/widgets/registerWidgets.js.map +1 -0
- package/dist/widgets/types.js +13 -0
- package/dist/widgets/types.js.map +1 -0
- package/package.json +16 -2
- package/dist/RealtimeCounter-BJrjMPSa.js +0 -473
- package/dist/RealtimeCounter-BJrjMPSa.js.map +0 -1
- package/dist/dist-B6HruP5v.js +0 -4731
- package/dist/dist-B6HruP5v.js.map +0 -1
- package/dist/exports/adapters/native.js.map +0 -1
- package/dist/exports/adapters/posthog.js.map +0 -1
- package/dist/exports/client.js.map +0 -1
- package/dist/exports/rsc.js.map +0 -1
- package/dist/fetchJson-DZb2_Puj.js.map +0 -1
- package/dist/index-CZdCT0WJ.d.ts +0 -98
- package/dist/keys-DEqL4LOT.js.map +0 -1
- package/dist/lib-CE5x1zLQ.js +0 -1058
- package/dist/lib-CE5x1zLQ.js.map +0 -1
- package/dist/maxmindResolver-CXYXXdul.js +0 -99
- package/dist/maxmindResolver-CXYXXdul.js.map +0 -1
- package/dist/presets-CBfq_uJX.d.ts +0 -38
- package/dist/series-zytbzPoc.js.map +0 -1
- package/dist/server-Cuvhgz-S.js +0 -492
- package/dist/server-Cuvhgz-S.js.map +0 -1
- package/dist/translations-keiKtSjF.js.map +0 -1
- /package/dist/{exports/adapters → adapters/ga4}/ga4.js.map +0 -0
- /package/dist/{exports/adapters → adapters/plausible}/plausible.js.map +0 -0
- /package/dist/{exports/adapters → adapters/umami}/umami.js.map +0 -0
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
//#region src/widgets/defaults.ts
|
|
2
|
+
/**
|
|
3
|
+
* Default analytics widget instances to spread into an app's own
|
|
4
|
+
* `admin.dashboard.defaultLayout`. A plugin must never set `defaultLayout` itself
|
|
5
|
+
* (Payload applies it with `??=`, so any setter would clobber the app's layout).
|
|
6
|
+
*/
|
|
7
|
+
const analyticsDefaultWidgets = () => [
|
|
8
|
+
{
|
|
9
|
+
widgetSlug: "analytics-trend",
|
|
10
|
+
width: "large",
|
|
11
|
+
data: {
|
|
12
|
+
metric: "pageviews",
|
|
13
|
+
timeframe: "last30days"
|
|
14
|
+
}
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
widgetSlug: "analytics-metric",
|
|
18
|
+
width: "small",
|
|
19
|
+
data: {
|
|
20
|
+
metric: "pageviews",
|
|
21
|
+
timeframe: "last30days"
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
widgetSlug: "analytics-metric",
|
|
26
|
+
width: "small",
|
|
27
|
+
data: {
|
|
28
|
+
metric: "visitors",
|
|
29
|
+
timeframe: "last30days"
|
|
30
|
+
}
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
widgetSlug: "analytics-breakdown-pages",
|
|
34
|
+
width: "medium",
|
|
35
|
+
data: {
|
|
36
|
+
metric: "pageviews",
|
|
37
|
+
timeframe: "last30days",
|
|
38
|
+
limit: 5
|
|
39
|
+
}
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
widgetSlug: "analytics-breakdown-sources",
|
|
43
|
+
width: "medium",
|
|
44
|
+
data: {
|
|
45
|
+
metric: "pageviews",
|
|
46
|
+
timeframe: "last30days",
|
|
47
|
+
limit: 5
|
|
48
|
+
}
|
|
49
|
+
},
|
|
50
|
+
{
|
|
51
|
+
widgetSlug: "analytics-breakdown-devices",
|
|
52
|
+
width: "medium",
|
|
53
|
+
data: {
|
|
54
|
+
metric: "pageviews",
|
|
55
|
+
timeframe: "last30days",
|
|
56
|
+
limit: 5
|
|
57
|
+
}
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
widgetSlug: "analytics-breakdown-countries",
|
|
61
|
+
width: "medium",
|
|
62
|
+
data: {
|
|
63
|
+
metric: "pageviews",
|
|
64
|
+
timeframe: "last30days",
|
|
65
|
+
limit: 5
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
];
|
|
69
|
+
//#endregion
|
|
70
|
+
export { analyticsDefaultWidgets };
|
|
71
|
+
|
|
72
|
+
//# sourceMappingURL=defaults.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defaults.js","names":[],"sources":["../../src/widgets/defaults.ts"],"sourcesContent":["import type { WidgetInstance } from 'payload'\n\n/**\n * Default analytics widget instances to spread into an app's own\n * `admin.dashboard.defaultLayout`. A plugin must never set `defaultLayout` itself\n * (Payload applies it with `??=`, so any setter would clobber the app's layout).\n */\nexport const analyticsDefaultWidgets = (): WidgetInstance[] => [\n\t{\n\t\twidgetSlug: 'analytics-trend',\n\t\twidth: 'large',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days' },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-metric',\n\t\twidth: 'small',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days' },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-metric',\n\t\twidth: 'small',\n\t\tdata: { metric: 'visitors', timeframe: 'last30days' },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-breakdown-pages',\n\t\twidth: 'medium',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days', limit: 5 },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-breakdown-sources',\n\t\twidth: 'medium',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days', limit: 5 },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-breakdown-devices',\n\t\twidth: 'medium',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days', limit: 5 },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-breakdown-countries',\n\t\twidth: 'medium',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days', limit: 5 },\n\t},\n]\n"],"mappings":";;;;;;AAOA,MAAa,gCAAkD;CAC9D;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;EAAa;CACtD;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;EAAa;CACtD;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAY,WAAW;EAAa;CACrD;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;GAAc,OAAO;EAAE;CAChE;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;GAAc,OAAO;EAAE;CAChE;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;GAAc,OAAO;EAAE;CAChE;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;GAAc,OAAO;EAAE;CAChE;AACD"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
//#region src/widgets/range.ts
|
|
2
|
+
/**
|
|
3
|
+
* Resolve a widget's explicit custom range to a concrete DateRange, or undefined when
|
|
4
|
+
* the widget is on a relative preset, the custom range is incomplete, or either bound
|
|
5
|
+
* is an unparseable date (a corrupt or hand-set widgetData would otherwise reach the
|
|
6
|
+
* cache key and throw on `toISOString`).
|
|
7
|
+
*/
|
|
8
|
+
const resolveCustomRange = (timeframe, range) => {
|
|
9
|
+
if (timeframe !== "custom" || !range?.from || !range?.to) return;
|
|
10
|
+
const start = new Date(range.from);
|
|
11
|
+
const end = new Date(range.to);
|
|
12
|
+
if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) return;
|
|
13
|
+
return {
|
|
14
|
+
start,
|
|
15
|
+
end
|
|
16
|
+
};
|
|
17
|
+
};
|
|
18
|
+
const formatDay = (d, locale) => d.toLocaleDateString(locale, {
|
|
19
|
+
month: "short",
|
|
20
|
+
day: "numeric",
|
|
21
|
+
year: "numeric"
|
|
22
|
+
});
|
|
23
|
+
/** Server-side caption for a custom range, e.g. "Jun 1, 2026 - Jun 23, 2026". */
|
|
24
|
+
const formatRangeCaption = (range, locale) => `${formatDay(range.start, locale)} - ${formatDay(range.end, locale)}`;
|
|
25
|
+
//#endregion
|
|
26
|
+
export { formatRangeCaption, resolveCustomRange };
|
|
27
|
+
|
|
28
|
+
//# sourceMappingURL=range.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"range.js","names":[],"sources":["../../src/widgets/range.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport type { WidgetRange } from './types'\n\n/**\n * Resolve a widget's explicit custom range to a concrete DateRange, or undefined when\n * the widget is on a relative preset, the custom range is incomplete, or either bound\n * is an unparseable date (a corrupt or hand-set widgetData would otherwise reach the\n * cache key and throw on `toISOString`).\n */\nexport const resolveCustomRange = (\n\ttimeframe: string | undefined,\n\trange: WidgetRange | undefined\n): DateRange | undefined => {\n\tif (timeframe !== 'custom' || !range?.from || !range?.to) {\n\t\treturn undefined\n\t}\n\tconst start = new Date(range.from)\n\tconst end = new Date(range.to)\n\tif (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) {\n\t\treturn undefined\n\t}\n\treturn { start, end }\n}\n\nconst formatDay = (d: Date, locale: string): string =>\n\td.toLocaleDateString(locale, { month: 'short', day: 'numeric', year: 'numeric' })\n\n/** Server-side caption for a custom range, e.g. \"Jun 1, 2026 - Jun 23, 2026\". */\nexport const formatRangeCaption = (range: DateRange, locale: string): string =>\n\t`${formatDay(range.start, locale)} - ${formatDay(range.end, locale)}`\n"],"mappings":";;;;;;;AASA,MAAa,sBACZ,WACA,UAC2B;CAC3B,IAAI,cAAc,YAAY,CAAC,OAAO,QAAQ,CAAC,OAAO,IACrD;CAED,MAAM,QAAQ,IAAI,KAAK,MAAM,IAAI;CACjC,MAAM,MAAM,IAAI,KAAK,MAAM,EAAE;CAC7B,IAAI,OAAO,MAAM,MAAM,QAAQ,CAAC,KAAK,OAAO,MAAM,IAAI,QAAQ,CAAC,GAC9D;CAED,OAAO;EAAE;EAAO;CAAI;AACrB;AAEA,MAAM,aAAa,GAAS,WAC3B,EAAE,mBAAmB,QAAQ;CAAE,OAAO;CAAS,KAAK;CAAW,MAAM;AAAU,CAAC;;AAGjF,MAAa,sBAAsB,OAAkB,WACpD,GAAG,UAAU,MAAM,OAAO,MAAM,EAAE,KAAK,UAAU,MAAM,KAAK,MAAM"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { DateRange, MetricKey } from "../core/contract.js";
|
|
2
|
+
import { TimeframePreset } from "../timeframe/presets.js";
|
|
3
|
+
import { PayloadRequest } from "payload";
|
|
4
|
+
|
|
5
|
+
//#region src/widgets/readForWidget.d.ts
|
|
6
|
+
type WidgetReadStatus = 'ok' | 'not-configured' | 'unavailable';
|
|
7
|
+
interface WidgetReadResult {
|
|
8
|
+
status: WidgetReadStatus;
|
|
9
|
+
adapterId: string;
|
|
10
|
+
dateRange: DateRange;
|
|
11
|
+
metrics: Partial<Record<MetricKey, number>>;
|
|
12
|
+
clamped?: boolean;
|
|
13
|
+
}
|
|
14
|
+
interface ReadForWidgetArgs {
|
|
15
|
+
req: PayloadRequest;
|
|
16
|
+
metrics: MetricKey[];
|
|
17
|
+
timeframe: TimeframePreset;
|
|
18
|
+
adapterId?: string;
|
|
19
|
+
now: Date;
|
|
20
|
+
range?: DateRange;
|
|
21
|
+
/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
|
|
22
|
+
scope?: string | null;
|
|
23
|
+
}
|
|
24
|
+
declare const readForWidget: (args: ReadForWidgetArgs) => Promise<WidgetReadResult>;
|
|
25
|
+
//#endregion
|
|
26
|
+
export { ReadForWidgetArgs, WidgetReadResult, WidgetReadStatus, readForWidget };
|
|
27
|
+
//# sourceMappingURL=readForWidget.d.ts.map
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { satisfiesCapabilities } from "../core/capabilities.js";
|
|
2
|
+
import { getRuntime } from "../plugin/runtime.js";
|
|
3
|
+
import { resolveReadContext } from "../core/scopedRead.js";
|
|
4
|
+
import { resolveTimeframe } from "../timeframe/presets.js";
|
|
5
|
+
//#region src/widgets/readForWidget.ts
|
|
6
|
+
const readForWidget = async (args) => {
|
|
7
|
+
const { req, metrics, timeframe, adapterId, now, range } = args;
|
|
8
|
+
const dateRange = range ?? resolveTimeframe(timeframe, now);
|
|
9
|
+
const base = {
|
|
10
|
+
dateRange,
|
|
11
|
+
metrics: {}
|
|
12
|
+
};
|
|
13
|
+
const runtime = getRuntime(req.payload);
|
|
14
|
+
if (!runtime) return {
|
|
15
|
+
status: "unavailable",
|
|
16
|
+
adapterId: adapterId ?? "",
|
|
17
|
+
...base
|
|
18
|
+
};
|
|
19
|
+
const ctx = await resolveReadContext({
|
|
20
|
+
runtime,
|
|
21
|
+
req,
|
|
22
|
+
adapterId,
|
|
23
|
+
scope: args.scope
|
|
24
|
+
});
|
|
25
|
+
if (!ctx.ok) return {
|
|
26
|
+
status: "unavailable",
|
|
27
|
+
adapterId: adapterId ?? "",
|
|
28
|
+
...base
|
|
29
|
+
};
|
|
30
|
+
const adapter = ctx.adapter;
|
|
31
|
+
if (!adapter.isConfigured()) return {
|
|
32
|
+
status: "not-configured",
|
|
33
|
+
adapterId: adapter.id,
|
|
34
|
+
...base
|
|
35
|
+
};
|
|
36
|
+
if (!satisfiesCapabilities(adapter.capabilities, { metrics })) return {
|
|
37
|
+
status: "unavailable",
|
|
38
|
+
adapterId: adapter.id,
|
|
39
|
+
...base
|
|
40
|
+
};
|
|
41
|
+
const result = await runtime.engine.read(adapter, {
|
|
42
|
+
metrics,
|
|
43
|
+
dateRange,
|
|
44
|
+
scope: ctx.queryScope
|
|
45
|
+
});
|
|
46
|
+
return {
|
|
47
|
+
status: "ok",
|
|
48
|
+
adapterId: adapter.id,
|
|
49
|
+
dateRange,
|
|
50
|
+
metrics: result.totals ?? {},
|
|
51
|
+
clamped: result.meta.clamped ?? false
|
|
52
|
+
};
|
|
53
|
+
};
|
|
54
|
+
//#endregion
|
|
55
|
+
export { readForWidget };
|
|
56
|
+
|
|
57
|
+
//# sourceMappingURL=readForWidget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"readForWidget.js","names":[],"sources":["../../src/widgets/readForWidget.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { satisfiesCapabilities } from '../core/capabilities'\nimport type { AnalyticsAdapter, DateRange, MetricKey } from '../core/contract'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { getRuntime } from '../plugin/runtime'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\n\nexport type WidgetReadStatus = 'ok' | 'not-configured' | 'unavailable'\n\nexport interface WidgetReadResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\tmetrics: Partial<Record<MetricKey, number>>\n\tclamped?: boolean\n}\n\nexport interface ReadForWidgetArgs {\n\treq: PayloadRequest\n\tmetrics: MetricKey[]\n\ttimeframe: TimeframePreset\n\tadapterId?: string\n\tnow: Date\n\trange?: DateRange\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n}\n\nexport const readForWidget = async (args: ReadForWidgetArgs): Promise<WidgetReadResult> => {\n\tconst { req, metrics, timeframe, adapterId, now, range } = args\n\tconst dateRange = range ?? resolveTimeframe(timeframe, now)\n\tconst base = { dateRange, metrics: {} as Partial<Record<MetricKey, number>> }\n\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn { status: 'unavailable', adapterId: adapterId ?? '', ...base }\n\t}\n\tconst ctx = await resolveReadContext({ runtime, req, adapterId, scope: args.scope })\n\tif (!ctx.ok) {\n\t\treturn { status: 'unavailable', adapterId: adapterId ?? '', ...base }\n\t}\n\tconst adapter: AnalyticsAdapter = ctx.adapter\n\tif (!adapter.isConfigured()) {\n\t\treturn { status: 'not-configured', adapterId: adapter.id, ...base }\n\t}\n\tif (!satisfiesCapabilities(adapter.capabilities, { metrics })) {\n\t\treturn { status: 'unavailable', adapterId: adapter.id, ...base }\n\t}\n\tconst result = await runtime.engine.read(adapter, { metrics, dateRange, scope: ctx.queryScope })\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\tmetrics: result.totals ?? {},\n\t\tclamped: result.meta.clamped ?? false,\n\t}\n}\n"],"mappings":";;;;;AA4BA,MAAa,gBAAgB,OAAO,SAAuD;CAC1F,MAAM,EAAE,KAAK,SAAS,WAAW,WAAW,KAAK,UAAU;CAC3D,MAAM,YAAY,SAAS,iBAAiB,WAAW,GAAG;CAC1D,MAAM,OAAO;EAAE;EAAW,SAAS,CAAC;CAAwC;CAE5E,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO;EAAE,QAAQ;EAAe,WAAW,aAAa;EAAI,GAAG;CAAK;CAErE,MAAM,MAAM,MAAM,mBAAmB;EAAE;EAAS;EAAK;EAAW,OAAO,KAAK;CAAM,CAAC;CACnF,IAAI,CAAC,IAAI,IACR,OAAO;EAAE,QAAQ;EAAe,WAAW,aAAa;EAAI,GAAG;CAAK;CAErE,MAAM,UAA4B,IAAI;CACtC,IAAI,CAAC,QAAQ,aAAa,GACzB,OAAO;EAAE,QAAQ;EAAkB,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEnE,IAAI,CAAC,sBAAsB,QAAQ,cAAc,EAAE,QAAQ,CAAC,GAC3D,OAAO;EAAE,QAAQ;EAAe,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEhE,MAAM,SAAS,MAAM,QAAQ,OAAO,KAAK,SAAS;EAAE;EAAS;EAAW,OAAO,IAAI;CAAW,CAAC;CAC/F,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB;EACA,SAAS,OAAO,UAAU,CAAC;EAC3B,SAAS,OAAO,KAAK,WAAW;CACjC;AACD"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { DateRange, DimensionKey, MetricKey } from "../core/contract.js";
|
|
2
|
+
import { TimeframePreset } from "../timeframe/presets.js";
|
|
3
|
+
import { WidgetReadStatus } from "./readForWidget.js";
|
|
4
|
+
import { PayloadRequest } from "payload";
|
|
5
|
+
|
|
6
|
+
//#region src/widgets/readForWidgetBreakdown.d.ts
|
|
7
|
+
interface BreakdownRow {
|
|
8
|
+
label: string;
|
|
9
|
+
value: number;
|
|
10
|
+
}
|
|
11
|
+
interface WidgetBreakdownResult {
|
|
12
|
+
status: WidgetReadStatus;
|
|
13
|
+
adapterId: string;
|
|
14
|
+
dateRange: DateRange;
|
|
15
|
+
rows: BreakdownRow[];
|
|
16
|
+
clamped?: boolean;
|
|
17
|
+
}
|
|
18
|
+
interface ReadForWidgetBreakdownArgs {
|
|
19
|
+
req: PayloadRequest;
|
|
20
|
+
metric: MetricKey;
|
|
21
|
+
dimension: DimensionKey;
|
|
22
|
+
timeframe: TimeframePreset;
|
|
23
|
+
limit: number;
|
|
24
|
+
adapterId?: string;
|
|
25
|
+
now: Date;
|
|
26
|
+
range?: DateRange;
|
|
27
|
+
/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
|
|
28
|
+
scope?: string | null;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Site-wide ranked breakdown of one metric by one dimension, read through the engine.
|
|
32
|
+
* Mirrors `readForWidget` but gates on the dimension too and maps each result row to a
|
|
33
|
+
* `{ label, value }` pair the bar list renders. The adapter owns sorting and limiting.
|
|
34
|
+
*/
|
|
35
|
+
declare const readForWidgetBreakdown: (args: ReadForWidgetBreakdownArgs) => Promise<WidgetBreakdownResult>;
|
|
36
|
+
//#endregion
|
|
37
|
+
export { BreakdownRow, ReadForWidgetBreakdownArgs, WidgetBreakdownResult, readForWidgetBreakdown };
|
|
38
|
+
//# sourceMappingURL=readForWidgetBreakdown.d.ts.map
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { satisfiesCapabilities } from "../core/capabilities.js";
|
|
2
|
+
import { getRuntime } from "../plugin/runtime.js";
|
|
3
|
+
import { resolveReadContext } from "../core/scopedRead.js";
|
|
4
|
+
import { resolveTimeframe } from "../timeframe/presets.js";
|
|
5
|
+
//#region src/widgets/readForWidgetBreakdown.ts
|
|
6
|
+
/**
|
|
7
|
+
* Site-wide ranked breakdown of one metric by one dimension, read through the engine.
|
|
8
|
+
* Mirrors `readForWidget` but gates on the dimension too and maps each result row to a
|
|
9
|
+
* `{ label, value }` pair the bar list renders. The adapter owns sorting and limiting.
|
|
10
|
+
*/
|
|
11
|
+
const readForWidgetBreakdown = async (args) => {
|
|
12
|
+
const { req, metric, dimension, timeframe, limit, adapterId, now, range } = args;
|
|
13
|
+
const dateRange = range ?? resolveTimeframe(timeframe, now);
|
|
14
|
+
const base = {
|
|
15
|
+
dateRange,
|
|
16
|
+
rows: []
|
|
17
|
+
};
|
|
18
|
+
const runtime = getRuntime(req.payload);
|
|
19
|
+
if (!runtime) return {
|
|
20
|
+
status: "unavailable",
|
|
21
|
+
adapterId: adapterId ?? "",
|
|
22
|
+
...base
|
|
23
|
+
};
|
|
24
|
+
const ctx = await resolveReadContext({
|
|
25
|
+
runtime,
|
|
26
|
+
req,
|
|
27
|
+
adapterId,
|
|
28
|
+
scope: args.scope
|
|
29
|
+
});
|
|
30
|
+
if (!ctx.ok) return {
|
|
31
|
+
status: "unavailable",
|
|
32
|
+
adapterId: adapterId ?? "",
|
|
33
|
+
...base
|
|
34
|
+
};
|
|
35
|
+
const adapter = ctx.adapter;
|
|
36
|
+
if (!adapter.isConfigured()) return {
|
|
37
|
+
status: "not-configured",
|
|
38
|
+
adapterId: adapter.id,
|
|
39
|
+
...base
|
|
40
|
+
};
|
|
41
|
+
if (!satisfiesCapabilities(adapter.capabilities, {
|
|
42
|
+
metrics: [metric],
|
|
43
|
+
dimensions: [dimension]
|
|
44
|
+
})) return {
|
|
45
|
+
status: "unavailable",
|
|
46
|
+
adapterId: adapter.id,
|
|
47
|
+
...base
|
|
48
|
+
};
|
|
49
|
+
const result = await runtime.engine.read(adapter, {
|
|
50
|
+
metrics: [metric],
|
|
51
|
+
dimensions: [dimension],
|
|
52
|
+
dateRange,
|
|
53
|
+
limit,
|
|
54
|
+
order: {
|
|
55
|
+
metric,
|
|
56
|
+
direction: "desc"
|
|
57
|
+
},
|
|
58
|
+
scope: ctx.queryScope
|
|
59
|
+
});
|
|
60
|
+
const rows = result.rows.map((row) => ({
|
|
61
|
+
label: row.dimensions?.[dimension] ?? "(none)",
|
|
62
|
+
value: row.metrics[metric] ?? 0
|
|
63
|
+
}));
|
|
64
|
+
return {
|
|
65
|
+
status: "ok",
|
|
66
|
+
adapterId: adapter.id,
|
|
67
|
+
dateRange,
|
|
68
|
+
rows,
|
|
69
|
+
clamped: result.meta.clamped ?? false
|
|
70
|
+
};
|
|
71
|
+
};
|
|
72
|
+
//#endregion
|
|
73
|
+
export { readForWidgetBreakdown };
|
|
74
|
+
|
|
75
|
+
//# sourceMappingURL=readForWidgetBreakdown.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"readForWidgetBreakdown.js","names":[],"sources":["../../src/widgets/readForWidgetBreakdown.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { satisfiesCapabilities } from '../core/capabilities'\nimport type { AnalyticsAdapter, DateRange, DimensionKey, MetricKey } from '../core/contract'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { getRuntime } from '../plugin/runtime'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport type { WidgetReadStatus } from './readForWidget'\n\nexport interface BreakdownRow {\n\tlabel: string\n\tvalue: number\n}\n\nexport interface WidgetBreakdownResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\trows: BreakdownRow[]\n\tclamped?: boolean\n}\n\nexport interface ReadForWidgetBreakdownArgs {\n\treq: PayloadRequest\n\tmetric: MetricKey\n\tdimension: DimensionKey\n\ttimeframe: TimeframePreset\n\tlimit: number\n\tadapterId?: string\n\tnow: Date\n\trange?: DateRange\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n}\n\n/**\n * Site-wide ranked breakdown of one metric by one dimension, read through the engine.\n * Mirrors `readForWidget` but gates on the dimension too and maps each result row to a\n * `{ label, value }` pair the bar list renders. The adapter owns sorting and limiting.\n */\nexport const readForWidgetBreakdown = async (\n\targs: ReadForWidgetBreakdownArgs\n): Promise<WidgetBreakdownResult> => {\n\tconst { req, metric, dimension, timeframe, limit, adapterId, now, range } = args\n\tconst dateRange = range ?? resolveTimeframe(timeframe, now)\n\tconst base = { dateRange, rows: [] as BreakdownRow[] }\n\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn { status: 'unavailable', adapterId: adapterId ?? '', ...base }\n\t}\n\tconst ctx = await resolveReadContext({ runtime, req, adapterId, scope: args.scope })\n\tif (!ctx.ok) {\n\t\treturn { status: 'unavailable', adapterId: adapterId ?? '', ...base }\n\t}\n\tconst adapter: AnalyticsAdapter = ctx.adapter\n\tif (!adapter.isConfigured()) {\n\t\treturn { status: 'not-configured', adapterId: adapter.id, ...base }\n\t}\n\tif (\n\t\t!satisfiesCapabilities(adapter.capabilities, { metrics: [metric], dimensions: [dimension] })\n\t) {\n\t\treturn { status: 'unavailable', adapterId: adapter.id, ...base }\n\t}\n\tconst result = await runtime.engine.read(adapter, {\n\t\tmetrics: [metric],\n\t\tdimensions: [dimension],\n\t\tdateRange,\n\t\tlimit,\n\t\torder: { metric, direction: 'desc' },\n\t\tscope: ctx.queryScope,\n\t})\n\tconst rows = result.rows.map((row) => ({\n\t\tlabel: row.dimensions?.[dimension] ?? '(none)',\n\t\tvalue: row.metrics[metric] ?? 0,\n\t}))\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\trows,\n\t\tclamped: result.meta.clamped ?? false,\n\t}\n}\n"],"mappings":";;;;;;;;;;AAuCA,MAAa,yBAAyB,OACrC,SACoC;CACpC,MAAM,EAAE,KAAK,QAAQ,WAAW,WAAW,OAAO,WAAW,KAAK,UAAU;CAC5E,MAAM,YAAY,SAAS,iBAAiB,WAAW,GAAG;CAC1D,MAAM,OAAO;EAAE;EAAW,MAAM,CAAC;CAAoB;CAErD,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO;EAAE,QAAQ;EAAe,WAAW,aAAa;EAAI,GAAG;CAAK;CAErE,MAAM,MAAM,MAAM,mBAAmB;EAAE;EAAS;EAAK;EAAW,OAAO,KAAK;CAAM,CAAC;CACnF,IAAI,CAAC,IAAI,IACR,OAAO;EAAE,QAAQ;EAAe,WAAW,aAAa;EAAI,GAAG;CAAK;CAErE,MAAM,UAA4B,IAAI;CACtC,IAAI,CAAC,QAAQ,aAAa,GACzB,OAAO;EAAE,QAAQ;EAAkB,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEnE,IACC,CAAC,sBAAsB,QAAQ,cAAc;EAAE,SAAS,CAAC,MAAM;EAAG,YAAY,CAAC,SAAS;CAAE,CAAC,GAE3F,OAAO;EAAE,QAAQ;EAAe,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEhE,MAAM,SAAS,MAAM,QAAQ,OAAO,KAAK,SAAS;EACjD,SAAS,CAAC,MAAM;EAChB,YAAY,CAAC,SAAS;EACtB;EACA;EACA,OAAO;GAAE;GAAQ,WAAW;EAAO;EACnC,OAAO,IAAI;CACZ,CAAC;CACD,MAAM,OAAO,OAAO,KAAK,KAAK,SAAS;EACtC,OAAO,IAAI,aAAa,cAAc;EACtC,OAAO,IAAI,QAAQ,WAAW;CAC/B,EAAE;CACF,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB;EACA;EACA,SAAS,OAAO,KAAK,WAAW;CACjC;AACD"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { MetricKey } from "../core/contract.js";
|
|
2
2
|
import { PayloadRequest } from "payload";
|
|
3
3
|
|
|
4
4
|
//#region src/widgets/readForWidgetRealtime.d.ts
|
|
@@ -19,6 +19,8 @@ interface ReadForWidgetRealtimeArgs {
|
|
|
19
19
|
windowMinutes: number;
|
|
20
20
|
adapterId?: string;
|
|
21
21
|
now: Date;
|
|
22
|
+
/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
|
|
23
|
+
scope?: string | null;
|
|
22
24
|
}
|
|
23
25
|
/**
|
|
24
26
|
* Site-wide realtime read for the "active now" widget. The window arrives as a
|
|
@@ -28,5 +30,5 @@ interface ReadForWidgetRealtimeArgs {
|
|
|
28
30
|
*/
|
|
29
31
|
declare const readForWidgetRealtime: (args: ReadForWidgetRealtimeArgs) => Promise<WidgetRealtimeResult>;
|
|
30
32
|
//#endregion
|
|
31
|
-
export {
|
|
32
|
-
//# sourceMappingURL=readForWidgetRealtime
|
|
33
|
+
export { ReadForWidgetRealtimeArgs, RealtimePoint, WidgetRealtimeResult, WidgetRealtimeStatus, readForWidgetRealtime };
|
|
34
|
+
//# sourceMappingURL=readForWidgetRealtime.d.ts.map
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { satisfiesCapabilities } from "../core/capabilities.js";
|
|
2
|
+
import { getRuntime } from "../plugin/runtime.js";
|
|
3
|
+
import { resolveReadContext } from "../core/scopedRead.js";
|
|
4
|
+
import { kvCacheStore } from "../surfacing/cacheStore.js";
|
|
5
|
+
//#region src/widgets/readForWidgetRealtime.ts
|
|
6
|
+
const empty = (status, adapterId) => ({
|
|
7
|
+
status,
|
|
8
|
+
adapterId,
|
|
9
|
+
activeNow: 0,
|
|
10
|
+
series: []
|
|
11
|
+
});
|
|
12
|
+
/**
|
|
13
|
+
* Site-wide realtime read for the "active now" widget. The window arrives as a
|
|
14
|
+
* dateRange (now - windowMinutes -> now). Cached under a realtime-specific key bucketed
|
|
15
|
+
* to the realtime TTL: it is deliberately NOT routed through the engine, whose key
|
|
16
|
+
* day-snaps the range (so a "last 30 min" read would collide with a "today" aggregate).
|
|
17
|
+
*/
|
|
18
|
+
const readForWidgetRealtime = async (args) => {
|
|
19
|
+
const { req, metric, windowMinutes, adapterId, now } = args;
|
|
20
|
+
const runtime = getRuntime(req.payload);
|
|
21
|
+
if (!runtime) return empty("unavailable", adapterId ?? "");
|
|
22
|
+
const ctx = await resolveReadContext({
|
|
23
|
+
runtime,
|
|
24
|
+
req,
|
|
25
|
+
adapterId,
|
|
26
|
+
scope: args.scope
|
|
27
|
+
});
|
|
28
|
+
if (!ctx.ok) return empty("unavailable", adapterId ?? "");
|
|
29
|
+
const adapter = ctx.adapter;
|
|
30
|
+
if (!adapter.isConfigured()) return empty("not-configured", adapter.id);
|
|
31
|
+
if (!adapter.realtime || !satisfiesCapabilities(adapter.capabilities, { realtime: true })) return empty("unavailable", adapter.id);
|
|
32
|
+
const ttlSeconds = adapter.capabilities.recommendedTtl.realtime || runtime.ttl.realtime;
|
|
33
|
+
const bucket = Math.floor(now.getTime() / 1e3 / Math.max(1, ttlSeconds));
|
|
34
|
+
const scopeKey = ctx.queryScope === void 0 ? "" : `:${encodeURIComponent(ctx.queryScope)}`;
|
|
35
|
+
const key = `rt:${adapter.id}:${metric}:${windowMinutes}:${bucket}${scopeKey}`;
|
|
36
|
+
const store = kvCacheStore(req.payload.kv);
|
|
37
|
+
const cached = await store.get(key);
|
|
38
|
+
if (cached) return cached;
|
|
39
|
+
const dateRange = {
|
|
40
|
+
start: /* @__PURE__ */ new Date(now.getTime() - windowMinutes * 6e4),
|
|
41
|
+
end: now
|
|
42
|
+
};
|
|
43
|
+
const result = await adapter.realtime({
|
|
44
|
+
metrics: [metric],
|
|
45
|
+
dateRange,
|
|
46
|
+
scope: ctx.queryScope
|
|
47
|
+
}, {});
|
|
48
|
+
const out = {
|
|
49
|
+
status: "ok",
|
|
50
|
+
adapterId: adapter.id,
|
|
51
|
+
activeNow: result.totals?.[metric] ?? 0,
|
|
52
|
+
series: result.rows.map((r) => ({
|
|
53
|
+
date: r.timestamp ?? "",
|
|
54
|
+
value: r.metrics[metric] ?? 0
|
|
55
|
+
}))
|
|
56
|
+
};
|
|
57
|
+
await store.set(key, out, ttlSeconds);
|
|
58
|
+
return out;
|
|
59
|
+
};
|
|
60
|
+
//#endregion
|
|
61
|
+
export { readForWidgetRealtime };
|
|
62
|
+
|
|
63
|
+
//# sourceMappingURL=readForWidgetRealtime.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"readForWidgetRealtime.js","names":[],"sources":["../../src/widgets/readForWidgetRealtime.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { satisfiesCapabilities } from '../core/capabilities'\nimport type { AnalyticsAdapter, MetricKey } from '../core/contract'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { getRuntime } from '../plugin/runtime'\nimport { kvCacheStore } from '../surfacing/cacheStore'\n\nexport type WidgetRealtimeStatus = 'ok' | 'not-configured' | 'unavailable'\n\nexport interface RealtimePoint {\n\tdate: string\n\tvalue: number\n}\n\nexport interface WidgetRealtimeResult {\n\tstatus: WidgetRealtimeStatus\n\tadapterId: string\n\tactiveNow: number\n\tseries: RealtimePoint[]\n}\n\nexport interface ReadForWidgetRealtimeArgs {\n\treq: PayloadRequest\n\tmetric: MetricKey\n\twindowMinutes: number\n\tadapterId?: string\n\tnow: Date\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n}\n\nconst empty = (status: WidgetRealtimeStatus, adapterId: string): WidgetRealtimeResult => ({\n\tstatus,\n\tadapterId,\n\tactiveNow: 0,\n\tseries: [],\n})\n\n/**\n * Site-wide realtime read for the \"active now\" widget. The window arrives as a\n * dateRange (now - windowMinutes -> now). Cached under a realtime-specific key bucketed\n * to the realtime TTL: it is deliberately NOT routed through the engine, whose key\n * day-snaps the range (so a \"last 30 min\" read would collide with a \"today\" aggregate).\n */\nexport const readForWidgetRealtime = async (\n\targs: ReadForWidgetRealtimeArgs\n): Promise<WidgetRealtimeResult> => {\n\tconst { req, metric, windowMinutes, adapterId, now } = args\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn empty('unavailable', adapterId ?? '')\n\t}\n\tconst ctx = await resolveReadContext({ runtime, req, adapterId, scope: args.scope })\n\tif (!ctx.ok) {\n\t\treturn empty('unavailable', adapterId ?? '')\n\t}\n\tconst adapter: AnalyticsAdapter = ctx.adapter\n\tif (!adapter.isConfigured()) {\n\t\treturn empty('not-configured', adapter.id)\n\t}\n\tif (!adapter.realtime || !satisfiesCapabilities(adapter.capabilities, { realtime: true })) {\n\t\treturn empty('unavailable', adapter.id)\n\t}\n\n\tconst ttlSeconds = adapter.capabilities.recommendedTtl.realtime || runtime.ttl.realtime\n\tconst bucket = Math.floor(now.getTime() / 1000 / Math.max(1, ttlSeconds))\n\tconst scopeKey = ctx.queryScope === undefined ? '' : `:${encodeURIComponent(ctx.queryScope)}`\n\tconst key = `rt:${adapter.id}:${metric}:${windowMinutes}:${bucket}${scopeKey}`\n\tconst store = kvCacheStore(req.payload.kv)\n\tconst cached = await store.get<WidgetRealtimeResult>(key)\n\tif (cached) {\n\t\treturn cached\n\t}\n\n\tconst dateRange = { start: new Date(now.getTime() - windowMinutes * 60_000), end: now }\n\tconst result = await adapter.realtime({ metrics: [metric], dateRange, scope: ctx.queryScope }, {})\n\tconst out: WidgetRealtimeResult = {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tactiveNow: result.totals?.[metric] ?? 0,\n\t\tseries: result.rows.map((r) => ({ date: r.timestamp ?? '', value: r.metrics[metric] ?? 0 })),\n\t}\n\tawait store.set(key, out, ttlSeconds)\n\treturn out\n}\n"],"mappings":";;;;;AA+BA,MAAM,SAAS,QAA8B,eAA6C;CACzF;CACA;CACA,WAAW;CACX,QAAQ,CAAC;AACV;;;;;;;AAQA,MAAa,wBAAwB,OACpC,SACmC;CACnC,MAAM,EAAE,KAAK,QAAQ,eAAe,WAAW,QAAQ;CACvD,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,MAAM,eAAe,aAAa,EAAE;CAE5C,MAAM,MAAM,MAAM,mBAAmB;EAAE;EAAS;EAAK;EAAW,OAAO,KAAK;CAAM,CAAC;CACnF,IAAI,CAAC,IAAI,IACR,OAAO,MAAM,eAAe,aAAa,EAAE;CAE5C,MAAM,UAA4B,IAAI;CACtC,IAAI,CAAC,QAAQ,aAAa,GACzB,OAAO,MAAM,kBAAkB,QAAQ,EAAE;CAE1C,IAAI,CAAC,QAAQ,YAAY,CAAC,sBAAsB,QAAQ,cAAc,EAAE,UAAU,KAAK,CAAC,GACvF,OAAO,MAAM,eAAe,QAAQ,EAAE;CAGvC,MAAM,aAAa,QAAQ,aAAa,eAAe,YAAY,QAAQ,IAAI;CAC/E,MAAM,SAAS,KAAK,MAAM,IAAI,QAAQ,IAAI,MAAO,KAAK,IAAI,GAAG,UAAU,CAAC;CACxE,MAAM,WAAW,IAAI,eAAe,KAAA,IAAY,KAAK,IAAI,mBAAmB,IAAI,UAAU;CAC1F,MAAM,MAAM,MAAM,QAAQ,GAAG,GAAG,OAAO,GAAG,cAAc,GAAG,SAAS;CACpE,MAAM,QAAQ,aAAa,IAAI,QAAQ,EAAE;CACzC,MAAM,SAAS,MAAM,MAAM,IAA0B,GAAG;CACxD,IAAI,QACH,OAAO;CAGR,MAAM,YAAY;EAAE,uBAAO,IAAI,KAAK,IAAI,QAAQ,IAAI,gBAAgB,GAAM;EAAG,KAAK;CAAI;CACtF,MAAM,SAAS,MAAM,QAAQ,SAAS;EAAE,SAAS,CAAC,MAAM;EAAG;EAAW,OAAO,IAAI;CAAW,GAAG,CAAC,CAAC;CACjG,MAAM,MAA4B;EACjC,QAAQ;EACR,WAAW,QAAQ;EACnB,WAAW,OAAO,SAAS,WAAW;EACtC,QAAQ,OAAO,KAAK,KAAK,OAAO;GAAE,MAAM,EAAE,aAAa;GAAI,OAAO,EAAE,QAAQ,WAAW;EAAE,EAAE;CAC5F;CACA,MAAM,MAAM,IAAI,KAAK,KAAK,UAAU;CACpC,OAAO;AACR"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { DateRange, MetricKey } from "../core/contract.js";
|
|
2
|
+
import { TimeframePreset } from "../timeframe/presets.js";
|
|
3
|
+
import { WidgetReadStatus } from "./readForWidget.js";
|
|
4
|
+
import { PayloadRequest } from "payload";
|
|
5
|
+
|
|
6
|
+
//#region src/widgets/readForWidgetSeries.d.ts
|
|
7
|
+
interface SeriesPoint {
|
|
8
|
+
date: string;
|
|
9
|
+
value: number;
|
|
10
|
+
}
|
|
11
|
+
interface WidgetSeriesResult {
|
|
12
|
+
status: WidgetReadStatus;
|
|
13
|
+
adapterId: string;
|
|
14
|
+
dateRange: DateRange;
|
|
15
|
+
points: SeriesPoint[];
|
|
16
|
+
total: number;
|
|
17
|
+
clamped?: boolean;
|
|
18
|
+
}
|
|
19
|
+
interface ReadForWidgetSeriesArgs {
|
|
20
|
+
req: PayloadRequest;
|
|
21
|
+
metric: MetricKey;
|
|
22
|
+
timeframe: TimeframePreset;
|
|
23
|
+
adapterId?: string;
|
|
24
|
+
now: Date;
|
|
25
|
+
range?: DateRange;
|
|
26
|
+
/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
|
|
27
|
+
scope?: string | null;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Site-wide time-series read for a trend widget: resolve the timeframe, pick the
|
|
31
|
+
* adapter, gate on the metric and day-granularity support, read through the engine,
|
|
32
|
+
* then return a zero-filled daily series plus the headline total. Mirrors
|
|
33
|
+
* `readForWidget` but yields points instead of a single value.
|
|
34
|
+
*/
|
|
35
|
+
declare const readForWidgetSeries: (args: ReadForWidgetSeriesArgs) => Promise<WidgetSeriesResult>;
|
|
36
|
+
//#endregion
|
|
37
|
+
export { ReadForWidgetSeriesArgs, SeriesPoint, WidgetSeriesResult, readForWidgetSeries };
|
|
38
|
+
//# sourceMappingURL=readForWidgetSeries.d.ts.map
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { satisfiesCapabilities } from "../core/capabilities.js";
|
|
2
|
+
import { getRuntime } from "../plugin/runtime.js";
|
|
3
|
+
import { resolveReadContext } from "../core/scopedRead.js";
|
|
4
|
+
import { resolveTimeframe } from "../timeframe/presets.js";
|
|
5
|
+
import { supportsGranularity } from "../core/granularity.js";
|
|
6
|
+
//#region src/widgets/readForWidgetSeries.ts
|
|
7
|
+
const DAY_MS = 864e5;
|
|
8
|
+
const MAX_SERIES_DAYS = 366;
|
|
9
|
+
const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
|
|
10
|
+
/**
|
|
11
|
+
* Project time-series rows onto a contiguous daily axis, zero-filling gaps. The axis
|
|
12
|
+
* is capped at the most recent `MAX_SERIES_DAYS` so an unbounded range (all time)
|
|
13
|
+
* stays a bounded, drawable sparkline; the headline total still reflects the full
|
|
14
|
+
* range.
|
|
15
|
+
*/
|
|
16
|
+
const fillDailySeries = (rows, dateRange, metric) => {
|
|
17
|
+
const lastDay = startOfUtcDay(dateRange.end);
|
|
18
|
+
const requestedStart = startOfUtcDay(dateRange.start);
|
|
19
|
+
const floor = /* @__PURE__ */ new Date(lastDay.getTime() - (MAX_SERIES_DAYS - 1) * DAY_MS);
|
|
20
|
+
const firstDay = requestedStart.getTime() > floor.getTime() ? requestedStart : floor;
|
|
21
|
+
const byDay = /* @__PURE__ */ new Map();
|
|
22
|
+
for (const row of rows) {
|
|
23
|
+
if (!row.timestamp) continue;
|
|
24
|
+
const day = startOfUtcDay(new Date(row.timestamp)).toISOString();
|
|
25
|
+
byDay.set(day, (byDay.get(day) ?? 0) + (row.metrics[metric] ?? 0));
|
|
26
|
+
}
|
|
27
|
+
const points = [];
|
|
28
|
+
for (let t = firstDay.getTime(); t <= lastDay.getTime(); t += DAY_MS) {
|
|
29
|
+
const date = new Date(t).toISOString();
|
|
30
|
+
points.push({
|
|
31
|
+
date,
|
|
32
|
+
value: byDay.get(date) ?? 0
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
return points;
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
* Site-wide time-series read for a trend widget: resolve the timeframe, pick the
|
|
39
|
+
* adapter, gate on the metric and day-granularity support, read through the engine,
|
|
40
|
+
* then return a zero-filled daily series plus the headline total. Mirrors
|
|
41
|
+
* `readForWidget` but yields points instead of a single value.
|
|
42
|
+
*/
|
|
43
|
+
const readForWidgetSeries = async (args) => {
|
|
44
|
+
const { req, metric, timeframe, adapterId, now, range } = args;
|
|
45
|
+
const dateRange = range ?? resolveTimeframe(timeframe, now);
|
|
46
|
+
const base = {
|
|
47
|
+
dateRange,
|
|
48
|
+
points: [],
|
|
49
|
+
total: 0
|
|
50
|
+
};
|
|
51
|
+
const runtime = getRuntime(req.payload);
|
|
52
|
+
if (!runtime) return {
|
|
53
|
+
status: "unavailable",
|
|
54
|
+
adapterId: adapterId ?? "",
|
|
55
|
+
...base
|
|
56
|
+
};
|
|
57
|
+
const ctx = await resolveReadContext({
|
|
58
|
+
runtime,
|
|
59
|
+
req,
|
|
60
|
+
adapterId,
|
|
61
|
+
scope: args.scope
|
|
62
|
+
});
|
|
63
|
+
if (!ctx.ok) return {
|
|
64
|
+
status: "unavailable",
|
|
65
|
+
adapterId: adapterId ?? "",
|
|
66
|
+
...base
|
|
67
|
+
};
|
|
68
|
+
const adapter = ctx.adapter;
|
|
69
|
+
if (!adapter.isConfigured()) return {
|
|
70
|
+
status: "not-configured",
|
|
71
|
+
adapterId: adapter.id,
|
|
72
|
+
...base
|
|
73
|
+
};
|
|
74
|
+
if (!satisfiesCapabilities(adapter.capabilities, { metrics: [metric] }) || !supportsGranularity(adapter.capabilities, "day")) return {
|
|
75
|
+
status: "unavailable",
|
|
76
|
+
adapterId: adapter.id,
|
|
77
|
+
...base
|
|
78
|
+
};
|
|
79
|
+
const result = await runtime.engine.read(adapter, {
|
|
80
|
+
metrics: [metric],
|
|
81
|
+
dateRange,
|
|
82
|
+
granularity: "day",
|
|
83
|
+
scope: ctx.queryScope
|
|
84
|
+
});
|
|
85
|
+
return {
|
|
86
|
+
status: "ok",
|
|
87
|
+
adapterId: adapter.id,
|
|
88
|
+
dateRange,
|
|
89
|
+
points: fillDailySeries(result.rows, dateRange, metric),
|
|
90
|
+
total: result.totals?.[metric] ?? 0,
|
|
91
|
+
clamped: result.meta.clamped ?? false
|
|
92
|
+
};
|
|
93
|
+
};
|
|
94
|
+
//#endregion
|
|
95
|
+
export { readForWidgetSeries };
|
|
96
|
+
|
|
97
|
+
//# sourceMappingURL=readForWidgetSeries.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"readForWidgetSeries.js","names":[],"sources":["../../src/widgets/readForWidgetSeries.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { satisfiesCapabilities } from '../core/capabilities'\nimport type { AnalyticsAdapter, AnalyticsRow, DateRange, MetricKey } from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { getRuntime } from '../plugin/runtime'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport type { WidgetReadStatus } from './readForWidget'\n\nexport interface SeriesPoint {\n\tdate: string\n\tvalue: number\n}\n\nexport interface WidgetSeriesResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\tpoints: SeriesPoint[]\n\ttotal: number\n\tclamped?: boolean\n}\n\nexport interface ReadForWidgetSeriesArgs {\n\treq: PayloadRequest\n\tmetric: MetricKey\n\ttimeframe: TimeframePreset\n\tadapterId?: string\n\tnow: Date\n\trange?: DateRange\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n}\n\nconst DAY_MS = 86_400_000\nconst MAX_SERIES_DAYS = 366\n\nconst startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\n/**\n * Project time-series rows onto a contiguous daily axis, zero-filling gaps. The axis\n * is capped at the most recent `MAX_SERIES_DAYS` so an unbounded range (all time)\n * stays a bounded, drawable sparkline; the headline total still reflects the full\n * range.\n */\nexport const fillDailySeries = (\n\trows: AnalyticsRow[],\n\tdateRange: DateRange,\n\tmetric: MetricKey\n): SeriesPoint[] => {\n\tconst lastDay = startOfUtcDay(dateRange.end)\n\tconst requestedStart = startOfUtcDay(dateRange.start)\n\tconst floor = new Date(lastDay.getTime() - (MAX_SERIES_DAYS - 1) * DAY_MS)\n\tconst firstDay = requestedStart.getTime() > floor.getTime() ? requestedStart : floor\n\tconst byDay = new Map<string, number>()\n\tfor (const row of rows) {\n\t\tif (!row.timestamp) {\n\t\t\tcontinue\n\t\t}\n\t\tconst day = startOfUtcDay(new Date(row.timestamp)).toISOString()\n\t\tbyDay.set(day, (byDay.get(day) ?? 0) + (row.metrics[metric] ?? 0))\n\t}\n\tconst points: SeriesPoint[] = []\n\tfor (let t = firstDay.getTime(); t <= lastDay.getTime(); t += DAY_MS) {\n\t\tconst date = new Date(t).toISOString()\n\t\tpoints.push({ date, value: byDay.get(date) ?? 0 })\n\t}\n\treturn points\n}\n\n/**\n * Site-wide time-series read for a trend widget: resolve the timeframe, pick the\n * adapter, gate on the metric and day-granularity support, read through the engine,\n * then return a zero-filled daily series plus the headline total. Mirrors\n * `readForWidget` but yields points instead of a single value.\n */\nexport const readForWidgetSeries = async (\n\targs: ReadForWidgetSeriesArgs\n): Promise<WidgetSeriesResult> => {\n\tconst { req, metric, timeframe, adapterId, now, range } = args\n\tconst dateRange = range ?? resolveTimeframe(timeframe, now)\n\tconst base = { dateRange, points: [] as SeriesPoint[], total: 0 }\n\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn { status: 'unavailable', adapterId: adapterId ?? '', ...base }\n\t}\n\tconst ctx = await resolveReadContext({ runtime, req, adapterId, scope: args.scope })\n\tif (!ctx.ok) {\n\t\treturn { status: 'unavailable', adapterId: adapterId ?? '', ...base }\n\t}\n\tconst adapter: AnalyticsAdapter = ctx.adapter\n\tif (!adapter.isConfigured()) {\n\t\treturn { status: 'not-configured', adapterId: adapter.id, ...base }\n\t}\n\tif (\n\t\t!satisfiesCapabilities(adapter.capabilities, { metrics: [metric] }) ||\n\t\t!supportsGranularity(adapter.capabilities, 'day')\n\t) {\n\t\treturn { status: 'unavailable', adapterId: adapter.id, ...base }\n\t}\n\tconst result = await runtime.engine.read(adapter, {\n\t\tmetrics: [metric],\n\t\tdateRange,\n\t\tgranularity: 'day',\n\t\tscope: ctx.queryScope,\n\t})\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\tpoints: fillDailySeries(result.rows, dateRange, metric),\n\t\ttotal: result.totals?.[metric] ?? 0,\n\t\tclamped: result.meta.clamped ?? false,\n\t}\n}\n"],"mappings":";;;;;;AAkCA,MAAM,SAAS;AACf,MAAM,kBAAkB;AAExB,MAAM,iBAAiB,MACtB,IAAI,KAAK,KAAK,IAAI,EAAE,eAAe,GAAG,EAAE,YAAY,GAAG,EAAE,WAAW,CAAC,CAAC;;;;;;;AAQvE,MAAa,mBACZ,MACA,WACA,WACmB;CACnB,MAAM,UAAU,cAAc,UAAU,GAAG;CAC3C,MAAM,iBAAiB,cAAc,UAAU,KAAK;CACpD,MAAM,wBAAQ,IAAI,KAAK,QAAQ,QAAQ,KAAK,kBAAkB,KAAK,MAAM;CACzE,MAAM,WAAW,eAAe,QAAQ,IAAI,MAAM,QAAQ,IAAI,iBAAiB;CAC/E,MAAM,wBAAQ,IAAI,IAAoB;CACtC,KAAK,MAAM,OAAO,MAAM;EACvB,IAAI,CAAC,IAAI,WACR;EAED,MAAM,MAAM,cAAc,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,YAAY;EAC/D,MAAM,IAAI,MAAM,MAAM,IAAI,GAAG,KAAK,MAAM,IAAI,QAAQ,WAAW,EAAE;CAClE;CACA,MAAM,SAAwB,CAAC;CAC/B,KAAK,IAAI,IAAI,SAAS,QAAQ,GAAG,KAAK,QAAQ,QAAQ,GAAG,KAAK,QAAQ;EACrE,MAAM,OAAO,IAAI,KAAK,CAAC,EAAE,YAAY;EACrC,OAAO,KAAK;GAAE;GAAM,OAAO,MAAM,IAAI,IAAI,KAAK;EAAE,CAAC;CAClD;CACA,OAAO;AACR;;;;;;;AAQA,MAAa,sBAAsB,OAClC,SACiC;CACjC,MAAM,EAAE,KAAK,QAAQ,WAAW,WAAW,KAAK,UAAU;CAC1D,MAAM,YAAY,SAAS,iBAAiB,WAAW,GAAG;CAC1D,MAAM,OAAO;EAAE;EAAW,QAAQ,CAAC;EAAoB,OAAO;CAAE;CAEhE,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO;EAAE,QAAQ;EAAe,WAAW,aAAa;EAAI,GAAG;CAAK;CAErE,MAAM,MAAM,MAAM,mBAAmB;EAAE;EAAS;EAAK;EAAW,OAAO,KAAK;CAAM,CAAC;CACnF,IAAI,CAAC,IAAI,IACR,OAAO;EAAE,QAAQ;EAAe,WAAW,aAAa;EAAI,GAAG;CAAK;CAErE,MAAM,UAA4B,IAAI;CACtC,IAAI,CAAC,QAAQ,aAAa,GACzB,OAAO;EAAE,QAAQ;EAAkB,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEnE,IACC,CAAC,sBAAsB,QAAQ,cAAc,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,KAClE,CAAC,oBAAoB,QAAQ,cAAc,KAAK,GAEhD,OAAO;EAAE,QAAQ;EAAe,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEhE,MAAM,SAAS,MAAM,QAAQ,OAAO,KAAK,SAAS;EACjD,SAAS,CAAC,MAAM;EAChB;EACA,aAAa;EACb,OAAO,IAAI;CACZ,CAAC;CACD,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB;EACA,QAAQ,gBAAgB,OAAO,MAAM,WAAW,MAAM;EACtD,OAAO,OAAO,SAAS,WAAW;EAClC,SAAS,OAAO,KAAK,WAAW;CACjC;AACD"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
//#region src/widgets/realtimePoll.ts
|
|
2
|
+
/** Build the realtime endpoint path + query string for a poll. */
|
|
3
|
+
const buildPollPath = (endpoint, config) => {
|
|
4
|
+
const params = new URLSearchParams({
|
|
5
|
+
metric: config.metric,
|
|
6
|
+
windowMinutes: String(config.windowMinutes)
|
|
7
|
+
});
|
|
8
|
+
if (config.dataSource) params.set("dataSource", config.dataSource);
|
|
9
|
+
return `${endpoint}?${params.toString()}`;
|
|
10
|
+
};
|
|
11
|
+
/** Map a minute series to TrendChart points (HH:MM labels, locale-formatted values). */
|
|
12
|
+
const toRealtimePoints = (series, locale) => {
|
|
13
|
+
const nf = new Intl.NumberFormat(locale);
|
|
14
|
+
return series.map((p) => ({
|
|
15
|
+
label: new Date(p.date).toLocaleTimeString(locale, {
|
|
16
|
+
hour: "2-digit",
|
|
17
|
+
minute: "2-digit"
|
|
18
|
+
}),
|
|
19
|
+
value: p.value,
|
|
20
|
+
display: nf.format(p.value)
|
|
21
|
+
}));
|
|
22
|
+
};
|
|
23
|
+
//#endregion
|
|
24
|
+
export { buildPollPath, toRealtimePoints };
|
|
25
|
+
|
|
26
|
+
//# sourceMappingURL=realtimePoll.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"realtimePoll.js","names":[],"sources":["../../src/widgets/realtimePoll.ts"],"sourcesContent":["import type { RealtimePoint } from './readForWidgetRealtime'\n\nexport interface PollConfig {\n\tmetric: string\n\twindowMinutes: number\n\tdataSource?: string\n}\n\nexport interface RealtimeChartPoint {\n\tlabel: string\n\tvalue: number\n\tdisplay: string\n}\n\n/** Build the realtime endpoint path + query string for a poll. */\nexport const buildPollPath = (endpoint: string, config: PollConfig): string => {\n\tconst params = new URLSearchParams({\n\t\tmetric: config.metric,\n\t\twindowMinutes: String(config.windowMinutes),\n\t})\n\tif (config.dataSource) {\n\t\tparams.set('dataSource', config.dataSource)\n\t}\n\treturn `${endpoint}?${params.toString()}`\n}\n\n/** Map a minute series to TrendChart points (HH:MM labels, locale-formatted values). */\nexport const toRealtimePoints = (series: RealtimePoint[], locale: string): RealtimeChartPoint[] => {\n\tconst nf = new Intl.NumberFormat(locale)\n\treturn series.map((p) => ({\n\t\tlabel: new Date(p.date).toLocaleTimeString(locale, { hour: '2-digit', minute: '2-digit' }),\n\t\tvalue: p.value,\n\t\tdisplay: nf.format(p.value),\n\t}))\n}\n"],"mappings":";;AAeA,MAAa,iBAAiB,UAAkB,WAA+B;CAC9E,MAAM,SAAS,IAAI,gBAAgB;EAClC,QAAQ,OAAO;EACf,eAAe,OAAO,OAAO,aAAa;CAC3C,CAAC;CACD,IAAI,OAAO,YACV,OAAO,IAAI,cAAc,OAAO,UAAU;CAE3C,OAAO,GAAG,SAAS,GAAG,OAAO,SAAS;AACvC;;AAGA,MAAa,oBAAoB,QAAyB,WAAyC;CAClG,MAAM,KAAK,IAAI,KAAK,aAAa,MAAM;CACvC,OAAO,OAAO,KAAK,OAAO;EACzB,OAAO,IAAI,KAAK,EAAE,IAAI,EAAE,mBAAmB,QAAQ;GAAE,MAAM;GAAW,QAAQ;EAAU,CAAC;EACzF,OAAO,EAAE;EACT,SAAS,GAAG,OAAO,EAAE,KAAK;CAC3B,EAAE;AACH"}
|