@mastra/playground-ui 66.1.0-alpha.2 → 67.0.0

package/dist/domains/dashboards/lib/requests.cjs.js

@@ -0,0 +1,279 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_domains_metrics_lib_request_limiter = require("../../metrics/lib/request-limiter.cjs.js");
+const require_domains_metrics_lib_metrics_buckets = require("../../metrics/lib/metrics-buckets.cjs.js");
+const require_domains_metrics_lib_trace_aggregate = require("../../metrics/lib/trace-aggregate.cjs.js");
+const require_domains_metrics_lib_time_window = require("../../metrics/lib/time-window.cjs.js");
+const require_domains_dashboards_lib_filters = require("./filters.cjs.js");
+// src/domains/dashboards/lib/requests.ts
+/** The widget's predicate and the page's, both required; the widget's comes first. */
+function andTrace(widget, page) {
+	return widget && page ? {
+		op: "and",
+		args: [widget, page]
+	} : widget ?? page;
+}
+function andSpan(widget, page) {
+	return widget && page ? {
+		op: "and",
+		args: [widget, page]
+	} : widget ?? page;
+}
+/**
+* A metrics or scores query's args, the page's filters intersected with its own, over `window`;
+* `unsatisfiable` when they contradict.
+*/
+function valuesArgs(query, page, window) {
+	const { source: _source, id: _id, request, compare, filters, ...rest } = query;
+	const combined = require_domains_dashboards_lib_filters.intersectFilters(page.filters, filters);
+	return {
+		unsatisfiable: combined === void 0 ? true : void 0,
+		args: {
+			...rest,
+			filters: {
+				...combined ?? page.filters,
+				timestamp: window
+			},
+			comparePeriod: request === "aggregate" && compare === "previousWindow" ? "previous_period" : void 0
+		}
+	};
+}
+/** A bucketed request's interval: its own, else the kind's, else the bar charts' for `window`. */
+function bucketOf(own, interval, window) {
+	return own ?? interval ?? require_domains_metrics_lib_metrics_buckets.bucketPlan(window.start, window.end).interval;
+}
+/**
+* The request a query sends over `window`, the page's filters ANDed with the widget's: trace and span
+* predicates are joined with `and`; metrics and scores filters intersect (`intersectFilters`), and a
+* contradiction marks the request unsatisfiable. A scores query without a scorer sends nothing: the
+* `scores` kind expands it per scorer first.
+*/
+function buildRequest(query, page, { interval }, window = page.window, priority) {
+	if (query.source === "traceAggregate") {
+		const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;
+		return {
+			method: "aggregateTraces",
+			args: {
+				timeRange: require_domains_metrics_lib_trace_aggregate.toTraceAggregateTimeRange(window),
+				...rest,
+				interval: own ?? interval,
+				where: andTrace(where, page.traceWhere)
+			},
+			priority
+		};
+	}
+	if (query.source === "spanAggregate") {
+		const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;
+		return {
+			method: "aggregateSpans",
+			args: {
+				timeRange: require_domains_metrics_lib_trace_aggregate.toTraceAggregateTimeRange(window),
+				...rest,
+				interval: own ?? interval,
+				where: andSpan(where, page.spanWhere)
+			},
+			priority
+		};
+	}
+	if (query.source === "metrics") switch (query.request) {
+		case "aggregate": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getMetricAggregate",
+				args,
+				unsatisfiable
+			};
+		}
+		case "breakdown": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getMetricBreakdown",
+				args,
+				unsatisfiable
+			};
+		}
+		case "timeSeries": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getMetricTimeSeries",
+				args: {
+					...args,
+					interval: bucketOf(query.interval, interval, window)
+				},
+				unsatisfiable
+			};
+		}
+		case "percentiles": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getMetricPercentiles",
+				args: {
+					...args,
+					interval: bucketOf(query.interval, interval, window)
+				},
+				unsatisfiable
+			};
+		}
+	}
+	const { scorerId } = query;
+	if (scorerId === void 0) return void 0;
+	switch (query.request) {
+		case "aggregate": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getScoreAggregate",
+				args: {
+					...args,
+					scorerId
+				},
+				unsatisfiable
+			};
+		}
+		case "breakdown": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getScoreBreakdown",
+				args: {
+					...args,
+					scorerId
+				},
+				unsatisfiable
+			};
+		}
+		case "timeSeries": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getScoreTimeSeries",
+				args: {
+					...args,
+					scorerId,
+					interval: bucketOf(query.interval, interval, window)
+				},
+				unsatisfiable
+			};
+		}
+		case "percentiles": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getScorePercentiles",
+				args: {
+					...args,
+					scorerId,
+					interval: bucketOf(query.interval, interval, window)
+				},
+				unsatisfiable
+			};
+		}
+	}
+}
+/** Whether a query asks for the previous window as a request of its own. */
+function sendsPreviousRequest(query) {
+	if (query.compare !== "previousWindow") return false;
+	return !((query.source === "metrics" || query.source === "scores") && query.request === "aggregate");
+}
+/** The previous window's request, sent last so the widget never waits on it. */
+function buildPreviousRequest(query, page, options) {
+	if (!sendsPreviousRequest(query)) return void 0;
+	return buildRequest(query, page, options, require_domains_metrics_lib_time_window.previousWindow(page.window), require_domains_metrics_lib_request_limiter.AGGREGATE_PRIORITY.last);
+}
+/** What an unsatisfiable request answers: nothing matched. */
+function emptyAnswer(method) {
+	switch (method) {
+		case "aggregateTraces":
+		case "aggregateSpans": return {
+			method,
+			data: {
+				rows: [],
+				truncated: false
+			}
+		};
+		case "getMetricAggregate":
+		case "getScoreAggregate": return {
+			method,
+			data: { value: null }
+		};
+		case "getMetricBreakdown":
+		case "getScoreBreakdown": return {
+			method,
+			data: { groups: [] }
+		};
+		case "getMetricTimeSeries":
+		case "getMetricPercentiles":
+		case "getScoreTimeSeries":
+		case "getScorePercentiles": return {
+			method,
+			data: { series: [] }
+		};
+	}
+}
+/** Runs a request on the client; an unsatisfiable one answers empty without a call. */
+async function sendRequest(client, request) {
+	if (request.unsatisfiable) return emptyAnswer(request.method);
+	switch (request.method) {
+		case "aggregateTraces": return {
+			method: request.method,
+			data: await client.aggregateTraces(request.args)
+		};
+		case "aggregateSpans": return {
+			method: request.method,
+			data: await client.aggregateSpans(request.args)
+		};
+		case "getMetricAggregate": return {
+			method: request.method,
+			data: await client.getMetricAggregate(request.args)
+		};
+		case "getMetricBreakdown": return {
+			method: request.method,
+			data: await client.getMetricBreakdown(request.args)
+		};
+		case "getMetricTimeSeries": return {
+			method: request.method,
+			data: await client.getMetricTimeSeries(request.args)
+		};
+		case "getMetricPercentiles": return {
+			method: request.method,
+			data: await client.getMetricPercentiles(request.args)
+		};
+		case "getScoreAggregate": return {
+			method: request.method,
+			data: await client.getScoreAggregate(request.args)
+		};
+		case "getScoreBreakdown": return {
+			method: request.method,
+			data: await client.getScoreBreakdown(request.args)
+		};
+		case "getScoreTimeSeries": return {
+			method: request.method,
+			data: await client.getScoreTimeSeries(request.args)
+		};
+		case "getScorePercentiles": return {
+			method: request.method,
+			data: await client.getScorePercentiles(request.args)
+		};
+	}
+}
+/**
+* The React Query key. Answers are cached tagged with their method, so they live under the dashboards'
+* own keys rather than `useTraceAggregate`'s, whose entries hold the bare response.
+*/
+function requestKey(request) {
+	if (request.unsatisfiable) return [
+		"dashboards",
+		"unsatisfiable",
+		request.method
+	];
+	return [
+		"dashboards",
+		request.method,
+		request.args
+	];
+}
+/** Whether a query needs the trace or span aggregate gate. */
+var aggregateSource = (query) => query.source === "traceAggregate" ? "trace" : query.source === "spanAggregate" ? "span" : void 0;
+exports.aggregateSource = aggregateSource;
+exports.buildPreviousRequest = buildPreviousRequest;
+exports.buildRequest = buildRequest;
+exports.requestKey = requestKey;
+exports.sendRequest = sendRequest;
+exports.sendsPreviousRequest = sendsPreviousRequest;
+
+//# sourceMappingURL=requests.cjs.js.map

package/dist/domains/dashboards/lib/requests.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.cjs.js","names":["intersectFilters","bucketPlan","toTraceAggregateTimeRange","previousWindow","AGGREGATE_PRIORITY"],"sources":["../../../../src/domains/dashboards/lib/requests.ts"],"sourcesContent":["import type { AggregateSpansArgs, AggregateTracesArgs, DashboardQuery, MastraClient } from '@mastra/client-js';\nimport type { MetricsQueryFilters } from '@mastra/react/hooks/metrics';\nimport { bucketPlan } from '../../metrics/lib/metrics-buckets';\nimport { AGGREGATE_PRIORITY } from '../../metrics/lib/request-limiter';\nimport type { AggregatePriority } from '../../metrics/lib/request-limiter';\nimport { previousWindow } from '../../metrics/lib/time-window';\nimport { toTraceAggregateTimeRange } from '../../metrics/lib/trace-aggregate';\nimport { intersectFilters } from './filters';\n\ntype Window = { start: Date; end: Date };\ntype Interval = '1h' | '1d';\ntype Args<M extends keyof MastraClient> = MastraClient[M] extends (args: infer A, ...rest: never[]) => unknown\n  ? A\n  : never;\n\ntype Call =\n  | { method: 'aggregateTraces'; args: AggregateTracesArgs; priority?: AggregatePriority }\n  | { method: 'aggregateSpans'; args: AggregateSpansArgs; priority?: AggregatePriority }\n  | { method: 'getMetricAggregate'; args: Args<'getMetricAggregate'> }\n  | { method: 'getMetricBreakdown'; args: Args<'getMetricBreakdown'> }\n  | { method: 'getMetricTimeSeries'; args: Args<'getMetricTimeSeries'> }\n  | { method: 'getMetricPercentiles'; args: Args<'getMetricPercentiles'> }\n  | { method: 'getScoreAggregate'; args: Args<'getScoreAggregate'> }\n  | { method: 'getScoreBreakdown'; args: Args<'getScoreBreakdown'> }\n  | { method: 'getScoreTimeSeries'; args: Args<'getScoreTimeSeries'> }\n  | { method: 'getScorePercentiles'; args: Args<'getScorePercentiles'> };\n\n/** One call a dashboard query makes, with the args it sends. */\nexport type DashboardRequest = Call & {\n  /** Its filters contradict the page's, so nothing can match: it isn't sent and answers empty. */\n  unsatisfiable?: true;\n};\n\nexport type DashboardRequestMethod = DashboardRequest['method'];\n\ntype Answers = { [M in DashboardRequestMethod]: Awaited<ReturnType<MastraClient[M]>> };\n\n/** A request's answer, tagged with the method that produced it so a widget narrows it by `method`. */\nexport type DashboardAnswer = {\n  [M in DashboardRequestMethod]: { method: M; data: Answers[M] };\n}[DashboardRequestMethod];\n\ntype TraceWhere = NonNullable<AggregateTracesArgs['where']>;\ntype SpanWhere = NonNullable<AggregateSpansArgs['where']>;\n\n/** What the page adds to every widget's query: its frozen window and its filter bar. */\nexport type DashboardPageContext = {\n  window: Window;\n  /** The page's metrics and scores filters, `timestamp` included. */\n  filters: MetricsQueryFilters['filters'];\n  /** The filter bar as trace and span predicates, from the aggregate gates. */\n  traceWhere?: TraceWhere;\n  spanWhere?: SpanWhere;\n};\n\n/** How the widget kind sends a query. */\nexport type DashboardRequestOptions = {\n  /** The bucket size, for a query that doesn't set its own. Unset sends the query as written. */\n  interval?: Interval;\n};\n\n/** The widget's predicate and the page's, both required; the widget's comes first. */\nfunction andTrace(widget: TraceWhere | undefined, page: TraceWhere | undefined): TraceWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\nfunction andSpan(widget: SpanWhere | undefined, page: SpanWhere | undefined): SpanWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\ntype ValuesQuery = Extract<DashboardQuery, { source: 'metrics' | 'scores' }>;\n\n/**\n * A metrics or scores query's args, the page's filters intersected with its own, over `window`;\n * `unsatisfiable` when they contradict.\n */\nfunction valuesArgs<Q extends ValuesQuery>(query: Q, page: DashboardPageContext, window: Window) {\n  const { source: _source, id: _id, request, compare, filters, ...rest } = query;\n  const combined = intersectFilters(page.filters, filters);\n  return {\n    unsatisfiable: combined === undefined ? (true as const) : undefined,\n    args: {\n      ...rest,\n      filters: { ...(combined ?? page.filters), timestamp: window },\n      // An aggregate compares in the same request; anything else sends a second one over `window`.\n      comparePeriod: request === 'aggregate' && compare === 'previousWindow' ? ('previous_period' as const) : undefined,\n    },\n  };\n}\n\n/** A bucketed request's interval: its own, else the kind's, else the bar charts' for `window`. */\nfunction bucketOf<I extends string>(own: I | undefined, interval: Interval | undefined, window: Window) {\n  return own ?? interval ?? bucketPlan(window.start, window.end).interval;\n}\n\n/**\n * The request a query sends over `window`, the page's filters ANDed with the widget's: trace and span\n * predicates are joined with `and`; metrics and scores filters intersect (`intersectFilters`), and a\n * contradiction marks the request unsatisfiable. A scores query without a scorer sends nothing: the\n * `scores` kind expands it per scorer first.\n */\nexport function buildRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  { interval }: DashboardRequestOptions,\n  window: Window = page.window,\n  priority?: AggregatePriority,\n): DashboardRequest | undefined {\n  if (query.source === 'traceAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateTraces',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andTrace(where, page.traceWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'spanAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateSpans',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andSpan(where, page.spanWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'metrics') {\n    switch (query.request) {\n      case 'aggregate': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricAggregate', args, unsatisfiable };\n      }\n      case 'breakdown': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricBreakdown', args, unsatisfiable };\n      }\n      case 'timeSeries': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricTimeSeries', args: bucketed, unsatisfiable };\n      }\n      case 'percentiles': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricPercentiles', args: bucketed, unsatisfiable };\n      }\n    }\n  }\n  const { scorerId } = query;\n  if (scorerId === undefined) return undefined;\n  switch (query.request) {\n    case 'aggregate': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreAggregate', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'breakdown': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreBreakdown', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'timeSeries': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScoreTimeSeries', args: bucketed, unsatisfiable };\n    }\n    case 'percentiles': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScorePercentiles', args: bucketed, unsatisfiable };\n    }\n  }\n}\n\n/** Whether a query asks for the previous window as a request of its own. */\nexport function sendsPreviousRequest(query: DashboardQuery) {\n  if (query.compare !== 'previousWindow') return false;\n  return !((query.source === 'metrics' || query.source === 'scores') && query.request === 'aggregate');\n}\n\n/** The previous window's request, sent last so the widget never waits on it. */\nexport function buildPreviousRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  options: DashboardRequestOptions,\n): DashboardRequest | undefined {\n  if (!sendsPreviousRequest(query)) return undefined;\n  return buildRequest(query, page, options, previousWindow(page.window), AGGREGATE_PRIORITY.last);\n}\n\n/** What an unsatisfiable request answers: nothing matched. */\nfunction emptyAnswer(method: DashboardRequestMethod): DashboardAnswer {\n  switch (method) {\n    case 'aggregateTraces':\n    case 'aggregateSpans':\n      return { method, data: { rows: [], truncated: false } };\n    case 'getMetricAggregate':\n    case 'getScoreAggregate':\n      return { method, data: { value: null } };\n    case 'getMetricBreakdown':\n    case 'getScoreBreakdown':\n      return { method, data: { groups: [] } };\n    case 'getMetricTimeSeries':\n    case 'getMetricPercentiles':\n    case 'getScoreTimeSeries':\n    case 'getScorePercentiles':\n      return { method, data: { series: [] } };\n  }\n}\n\n/** Runs a request on the client; an unsatisfiable one answers empty without a call. */\nexport async function sendRequest(client: MastraClient, request: DashboardRequest): Promise<DashboardAnswer> {\n  if (request.unsatisfiable) return emptyAnswer(request.method);\n  switch (request.method) {\n    case 'aggregateTraces':\n      return { method: request.method, data: await client.aggregateTraces(request.args) };\n    case 'aggregateSpans':\n      return { method: request.method, data: await client.aggregateSpans(request.args) };\n    case 'getMetricAggregate':\n      return { method: request.method, data: await client.getMetricAggregate(request.args) };\n    case 'getMetricBreakdown':\n      return { method: request.method, data: await client.getMetricBreakdown(request.args) };\n    case 'getMetricTimeSeries':\n      return { method: request.method, data: await client.getMetricTimeSeries(request.args) };\n    case 'getMetricPercentiles':\n      return { method: request.method, data: await client.getMetricPercentiles(request.args) };\n    case 'getScoreAggregate':\n      return { method: request.method, data: await client.getScoreAggregate(request.args) };\n    case 'getScoreBreakdown':\n      return { method: request.method, data: await client.getScoreBreakdown(request.args) };\n    case 'getScoreTimeSeries':\n      return { method: request.method, data: await client.getScoreTimeSeries(request.args) };\n    case 'getScorePercentiles':\n      return { method: request.method, data: await client.getScorePercentiles(request.args) };\n  }\n}\n\n/**\n * The React Query key. Answers are cached tagged with their method, so they live under the dashboards'\n * own keys rather than `useTraceAggregate`'s, whose entries hold the bare response.\n */\nexport function requestKey(request: DashboardRequest): readonly unknown[] {\n  if (request.unsatisfiable) return ['dashboards', 'unsatisfiable', request.method];\n  return ['dashboards', request.method, request.args];\n}\n\n/** Whether a query needs the trace or span aggregate gate. */\nexport const aggregateSource = (query: DashboardQuery) =>\n  query.source === 'traceAggregate' ? 'trace' : query.source === 'spanAggregate' ? 'span' : undefined;\n"],"mappings":"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"}

package/dist/domains/dashboards/lib/requests.d.ts

@@ -0,0 +1 @@
+export * from '../../../src/domains/dashboards/lib/requests';

package/dist/domains/dashboards/lib/requests.es.js

@@ -0,0 +1,273 @@
+import { AGGREGATE_PRIORITY } from "../../metrics/lib/request-limiter.es.js";
+import { bucketPlan } from "../../metrics/lib/metrics-buckets.es.js";
+import { toTraceAggregateTimeRange } from "../../metrics/lib/trace-aggregate.es.js";
+import { previousWindow } from "../../metrics/lib/time-window.es.js";
+import { intersectFilters } from "./filters.es.js";
+// src/domains/dashboards/lib/requests.ts
+/** The widget's predicate and the page's, both required; the widget's comes first. */
+function andTrace(widget, page) {
+	return widget && page ? {
+		op: "and",
+		args: [widget, page]
+	} : widget ?? page;
+}
+function andSpan(widget, page) {
+	return widget && page ? {
+		op: "and",
+		args: [widget, page]
+	} : widget ?? page;
+}
+/**
+* A metrics or scores query's args, the page's filters intersected with its own, over `window`;
+* `unsatisfiable` when they contradict.
+*/
+function valuesArgs(query, page, window) {
+	const { source: _source, id: _id, request, compare, filters, ...rest } = query;
+	const combined = intersectFilters(page.filters, filters);
+	return {
+		unsatisfiable: combined === void 0 ? true : void 0,
+		args: {
+			...rest,
+			filters: {
+				...combined ?? page.filters,
+				timestamp: window
+			},
+			comparePeriod: request === "aggregate" && compare === "previousWindow" ? "previous_period" : void 0
+		}
+	};
+}
+/** A bucketed request's interval: its own, else the kind's, else the bar charts' for `window`. */
+function bucketOf(own, interval, window) {
+	return own ?? interval ?? bucketPlan(window.start, window.end).interval;
+}
+/**
+* The request a query sends over `window`, the page's filters ANDed with the widget's: trace and span
+* predicates are joined with `and`; metrics and scores filters intersect (`intersectFilters`), and a
+* contradiction marks the request unsatisfiable. A scores query without a scorer sends nothing: the
+* `scores` kind expands it per scorer first.
+*/
+function buildRequest(query, page, { interval }, window = page.window, priority) {
+	if (query.source === "traceAggregate") {
+		const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;
+		return {
+			method: "aggregateTraces",
+			args: {
+				timeRange: toTraceAggregateTimeRange(window),
+				...rest,
+				interval: own ?? interval,
+				where: andTrace(where, page.traceWhere)
+			},
+			priority
+		};
+	}
+	if (query.source === "spanAggregate") {
+		const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;
+		return {
+			method: "aggregateSpans",
+			args: {
+				timeRange: toTraceAggregateTimeRange(window),
+				...rest,
+				interval: own ?? interval,
+				where: andSpan(where, page.spanWhere)
+			},
+			priority
+		};
+	}
+	if (query.source === "metrics") switch (query.request) {
+		case "aggregate": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getMetricAggregate",
+				args,
+				unsatisfiable
+			};
+		}
+		case "breakdown": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getMetricBreakdown",
+				args,
+				unsatisfiable
+			};
+		}
+		case "timeSeries": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getMetricTimeSeries",
+				args: {
+					...args,
+					interval: bucketOf(query.interval, interval, window)
+				},
+				unsatisfiable
+			};
+		}
+		case "percentiles": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getMetricPercentiles",
+				args: {
+					...args,
+					interval: bucketOf(query.interval, interval, window)
+				},
+				unsatisfiable
+			};
+		}
+	}
+	const { scorerId } = query;
+	if (scorerId === void 0) return void 0;
+	switch (query.request) {
+		case "aggregate": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getScoreAggregate",
+				args: {
+					...args,
+					scorerId
+				},
+				unsatisfiable
+			};
+		}
+		case "breakdown": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getScoreBreakdown",
+				args: {
+					...args,
+					scorerId
+				},
+				unsatisfiable
+			};
+		}
+		case "timeSeries": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getScoreTimeSeries",
+				args: {
+					...args,
+					scorerId,
+					interval: bucketOf(query.interval, interval, window)
+				},
+				unsatisfiable
+			};
+		}
+		case "percentiles": {
+			const { args, unsatisfiable } = valuesArgs(query, page, window);
+			return {
+				method: "getScorePercentiles",
+				args: {
+					...args,
+					scorerId,
+					interval: bucketOf(query.interval, interval, window)
+				},
+				unsatisfiable
+			};
+		}
+	}
+}
+/** Whether a query asks for the previous window as a request of its own. */
+function sendsPreviousRequest(query) {
+	if (query.compare !== "previousWindow") return false;
+	return !((query.source === "metrics" || query.source === "scores") && query.request === "aggregate");
+}
+/** The previous window's request, sent last so the widget never waits on it. */
+function buildPreviousRequest(query, page, options) {
+	if (!sendsPreviousRequest(query)) return void 0;
+	return buildRequest(query, page, options, previousWindow(page.window), AGGREGATE_PRIORITY.last);
+}
+/** What an unsatisfiable request answers: nothing matched. */
+function emptyAnswer(method) {
+	switch (method) {
+		case "aggregateTraces":
+		case "aggregateSpans": return {
+			method,
+			data: {
+				rows: [],
+				truncated: false
+			}
+		};
+		case "getMetricAggregate":
+		case "getScoreAggregate": return {
+			method,
+			data: { value: null }
+		};
+		case "getMetricBreakdown":
+		case "getScoreBreakdown": return {
+			method,
+			data: { groups: [] }
+		};
+		case "getMetricTimeSeries":
+		case "getMetricPercentiles":
+		case "getScoreTimeSeries":
+		case "getScorePercentiles": return {
+			method,
+			data: { series: [] }
+		};
+	}
+}
+/** Runs a request on the client; an unsatisfiable one answers empty without a call. */
+async function sendRequest(client, request) {
+	if (request.unsatisfiable) return emptyAnswer(request.method);
+	switch (request.method) {
+		case "aggregateTraces": return {
+			method: request.method,
+			data: await client.aggregateTraces(request.args)
+		};
+		case "aggregateSpans": return {
+			method: request.method,
+			data: await client.aggregateSpans(request.args)
+		};
+		case "getMetricAggregate": return {
+			method: request.method,
+			data: await client.getMetricAggregate(request.args)
+		};
+		case "getMetricBreakdown": return {
+			method: request.method,
+			data: await client.getMetricBreakdown(request.args)
+		};
+		case "getMetricTimeSeries": return {
+			method: request.method,
+			data: await client.getMetricTimeSeries(request.args)
+		};
+		case "getMetricPercentiles": return {
+			method: request.method,
+			data: await client.getMetricPercentiles(request.args)
+		};
+		case "getScoreAggregate": return {
+			method: request.method,
+			data: await client.getScoreAggregate(request.args)
+		};
+		case "getScoreBreakdown": return {
+			method: request.method,
+			data: await client.getScoreBreakdown(request.args)
+		};
+		case "getScoreTimeSeries": return {
+			method: request.method,
+			data: await client.getScoreTimeSeries(request.args)
+		};
+		case "getScorePercentiles": return {
+			method: request.method,
+			data: await client.getScorePercentiles(request.args)
+		};
+	}
+}
+/**
+* The React Query key. Answers are cached tagged with their method, so they live under the dashboards'
+* own keys rather than `useTraceAggregate`'s, whose entries hold the bare response.
+*/
+function requestKey(request) {
+	if (request.unsatisfiable) return [
+		"dashboards",
+		"unsatisfiable",
+		request.method
+	];
+	return [
+		"dashboards",
+		request.method,
+		request.args
+	];
+}
+/** Whether a query needs the trace or span aggregate gate. */
+var aggregateSource = (query) => query.source === "traceAggregate" ? "trace" : query.source === "spanAggregate" ? "span" : void 0;
+export { aggregateSource, buildPreviousRequest, buildRequest, requestKey, sendRequest, sendsPreviousRequest };
+
+//# sourceMappingURL=requests.es.js.map

package/dist/domains/dashboards/lib/requests.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.es.js","names":[],"sources":["../../../../src/domains/dashboards/lib/requests.ts"],"sourcesContent":["import type { AggregateSpansArgs, AggregateTracesArgs, DashboardQuery, MastraClient } from '@mastra/client-js';\nimport type { MetricsQueryFilters } from '@mastra/react/hooks/metrics';\nimport { bucketPlan } from '../../metrics/lib/metrics-buckets';\nimport { AGGREGATE_PRIORITY } from '../../metrics/lib/request-limiter';\nimport type { AggregatePriority } from '../../metrics/lib/request-limiter';\nimport { previousWindow } from '../../metrics/lib/time-window';\nimport { toTraceAggregateTimeRange } from '../../metrics/lib/trace-aggregate';\nimport { intersectFilters } from './filters';\n\ntype Window = { start: Date; end: Date };\ntype Interval = '1h' | '1d';\ntype Args<M extends keyof MastraClient> = MastraClient[M] extends (args: infer A, ...rest: never[]) => unknown\n  ? A\n  : never;\n\ntype Call =\n  | { method: 'aggregateTraces'; args: AggregateTracesArgs; priority?: AggregatePriority }\n  | { method: 'aggregateSpans'; args: AggregateSpansArgs; priority?: AggregatePriority }\n  | { method: 'getMetricAggregate'; args: Args<'getMetricAggregate'> }\n  | { method: 'getMetricBreakdown'; args: Args<'getMetricBreakdown'> }\n  | { method: 'getMetricTimeSeries'; args: Args<'getMetricTimeSeries'> }\n  | { method: 'getMetricPercentiles'; args: Args<'getMetricPercentiles'> }\n  | { method: 'getScoreAggregate'; args: Args<'getScoreAggregate'> }\n  | { method: 'getScoreBreakdown'; args: Args<'getScoreBreakdown'> }\n  | { method: 'getScoreTimeSeries'; args: Args<'getScoreTimeSeries'> }\n  | { method: 'getScorePercentiles'; args: Args<'getScorePercentiles'> };\n\n/** One call a dashboard query makes, with the args it sends. */\nexport type DashboardRequest = Call & {\n  /** Its filters contradict the page's, so nothing can match: it isn't sent and answers empty. */\n  unsatisfiable?: true;\n};\n\nexport type DashboardRequestMethod = DashboardRequest['method'];\n\ntype Answers = { [M in DashboardRequestMethod]: Awaited<ReturnType<MastraClient[M]>> };\n\n/** A request's answer, tagged with the method that produced it so a widget narrows it by `method`. */\nexport type DashboardAnswer = {\n  [M in DashboardRequestMethod]: { method: M; data: Answers[M] };\n}[DashboardRequestMethod];\n\ntype TraceWhere = NonNullable<AggregateTracesArgs['where']>;\ntype SpanWhere = NonNullable<AggregateSpansArgs['where']>;\n\n/** What the page adds to every widget's query: its frozen window and its filter bar. */\nexport type DashboardPageContext = {\n  window: Window;\n  /** The page's metrics and scores filters, `timestamp` included. */\n  filters: MetricsQueryFilters['filters'];\n  /** The filter bar as trace and span predicates, from the aggregate gates. */\n  traceWhere?: TraceWhere;\n  spanWhere?: SpanWhere;\n};\n\n/** How the widget kind sends a query. */\nexport type DashboardRequestOptions = {\n  /** The bucket size, for a query that doesn't set its own. Unset sends the query as written. */\n  interval?: Interval;\n};\n\n/** The widget's predicate and the page's, both required; the widget's comes first. */\nfunction andTrace(widget: TraceWhere | undefined, page: TraceWhere | undefined): TraceWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\nfunction andSpan(widget: SpanWhere | undefined, page: SpanWhere | undefined): SpanWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\ntype ValuesQuery = Extract<DashboardQuery, { source: 'metrics' | 'scores' }>;\n\n/**\n * A metrics or scores query's args, the page's filters intersected with its own, over `window`;\n * `unsatisfiable` when they contradict.\n */\nfunction valuesArgs<Q extends ValuesQuery>(query: Q, page: DashboardPageContext, window: Window) {\n  const { source: _source, id: _id, request, compare, filters, ...rest } = query;\n  const combined = intersectFilters(page.filters, filters);\n  return {\n    unsatisfiable: combined === undefined ? (true as const) : undefined,\n    args: {\n      ...rest,\n      filters: { ...(combined ?? page.filters), timestamp: window },\n      // An aggregate compares in the same request; anything else sends a second one over `window`.\n      comparePeriod: request === 'aggregate' && compare === 'previousWindow' ? ('previous_period' as const) : undefined,\n    },\n  };\n}\n\n/** A bucketed request's interval: its own, else the kind's, else the bar charts' for `window`. */\nfunction bucketOf<I extends string>(own: I | undefined, interval: Interval | undefined, window: Window) {\n  return own ?? interval ?? bucketPlan(window.start, window.end).interval;\n}\n\n/**\n * The request a query sends over `window`, the page's filters ANDed with the widget's: trace and span\n * predicates are joined with `and`; metrics and scores filters intersect (`intersectFilters`), and a\n * contradiction marks the request unsatisfiable. A scores query without a scorer sends nothing: the\n * `scores` kind expands it per scorer first.\n */\nexport function buildRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  { interval }: DashboardRequestOptions,\n  window: Window = page.window,\n  priority?: AggregatePriority,\n): DashboardRequest | undefined {\n  if (query.source === 'traceAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateTraces',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andTrace(where, page.traceWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'spanAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateSpans',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andSpan(where, page.spanWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'metrics') {\n    switch (query.request) {\n      case 'aggregate': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricAggregate', args, unsatisfiable };\n      }\n      case 'breakdown': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricBreakdown', args, unsatisfiable };\n      }\n      case 'timeSeries': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricTimeSeries', args: bucketed, unsatisfiable };\n      }\n      case 'percentiles': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricPercentiles', args: bucketed, unsatisfiable };\n      }\n    }\n  }\n  const { scorerId } = query;\n  if (scorerId === undefined) return undefined;\n  switch (query.request) {\n    case 'aggregate': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreAggregate', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'breakdown': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreBreakdown', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'timeSeries': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScoreTimeSeries', args: bucketed, unsatisfiable };\n    }\n    case 'percentiles': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScorePercentiles', args: bucketed, unsatisfiable };\n    }\n  }\n}\n\n/** Whether a query asks for the previous window as a request of its own. */\nexport function sendsPreviousRequest(query: DashboardQuery) {\n  if (query.compare !== 'previousWindow') return false;\n  return !((query.source === 'metrics' || query.source === 'scores') && query.request === 'aggregate');\n}\n\n/** The previous window's request, sent last so the widget never waits on it. */\nexport function buildPreviousRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  options: DashboardRequestOptions,\n): DashboardRequest | undefined {\n  if (!sendsPreviousRequest(query)) return undefined;\n  return buildRequest(query, page, options, previousWindow(page.window), AGGREGATE_PRIORITY.last);\n}\n\n/** What an unsatisfiable request answers: nothing matched. */\nfunction emptyAnswer(method: DashboardRequestMethod): DashboardAnswer {\n  switch (method) {\n    case 'aggregateTraces':\n    case 'aggregateSpans':\n      return { method, data: { rows: [], truncated: false } };\n    case 'getMetricAggregate':\n    case 'getScoreAggregate':\n      return { method, data: { value: null } };\n    case 'getMetricBreakdown':\n    case 'getScoreBreakdown':\n      return { method, data: { groups: [] } };\n    case 'getMetricTimeSeries':\n    case 'getMetricPercentiles':\n    case 'getScoreTimeSeries':\n    case 'getScorePercentiles':\n      return { method, data: { series: [] } };\n  }\n}\n\n/** Runs a request on the client; an unsatisfiable one answers empty without a call. */\nexport async function sendRequest(client: MastraClient, request: DashboardRequest): Promise<DashboardAnswer> {\n  if (request.unsatisfiable) return emptyAnswer(request.method);\n  switch (request.method) {\n    case 'aggregateTraces':\n      return { method: request.method, data: await client.aggregateTraces(request.args) };\n    case 'aggregateSpans':\n      return { method: request.method, data: await client.aggregateSpans(request.args) };\n    case 'getMetricAggregate':\n      return { method: request.method, data: await client.getMetricAggregate(request.args) };\n    case 'getMetricBreakdown':\n      return { method: request.method, data: await client.getMetricBreakdown(request.args) };\n    case 'getMetricTimeSeries':\n      return { method: request.method, data: await client.getMetricTimeSeries(request.args) };\n    case 'getMetricPercentiles':\n      return { method: request.method, data: await client.getMetricPercentiles(request.args) };\n    case 'getScoreAggregate':\n      return { method: request.method, data: await client.getScoreAggregate(request.args) };\n    case 'getScoreBreakdown':\n      return { method: request.method, data: await client.getScoreBreakdown(request.args) };\n    case 'getScoreTimeSeries':\n      return { method: request.method, data: await client.getScoreTimeSeries(request.args) };\n    case 'getScorePercentiles':\n      return { method: request.method, data: await client.getScorePercentiles(request.args) };\n  }\n}\n\n/**\n * The React Query key. Answers are cached tagged with their method, so they live under the dashboards'\n * own keys rather than `useTraceAggregate`'s, whose entries hold the bare response.\n */\nexport function requestKey(request: DashboardRequest): readonly unknown[] {\n  if (request.unsatisfiable) return ['dashboards', 'unsatisfiable', request.method];\n  return ['dashboards', request.method, request.args];\n}\n\n/** Whether a query needs the trace or span aggregate gate. */\nexport const aggregateSource = (query: DashboardQuery) =>\n  query.source === 'traceAggregate' ? 'trace' : query.source === 'spanAggregate' ? 'span' : undefined;\n"],"mappings":"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"}