@mastra/react 1.7.3-alpha.3 → 1.8.0-alpha.5

package/dist/hooks/scores/index.cjs

@@ -0,0 +1,339 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mastra_client_context = require("../../mastra-client-context-DzX3f0RF.cjs");
+const require_use_in_view = require("../../use-in-view-B6eJO9Zi.cjs");
+const require_query_utils = require("../../query-utils-CcrChYgz.cjs");
+let react = require("react");
+let _tanstack_react_query = require("@tanstack/react-query");
+//#region src/hooks/scores/use-scorers.ts
+const SCORES_PER_PAGE = 25;
+const SCORES_REFETCH_INTERVAL_MS = 15e3;
+function getScoresRefetchInterval(query) {
+	if (require_query_utils.isUnsupportedObservabilityOperationError(query.state.error, "scores") || require_query_utils.isObservabilityUnavailableError(query.state.error)) return false;
+	return SCORES_REFETCH_INTERVAL_MS;
+}
+function getScoresNextPageParam(lastPage, _allPages, lastPageParam) {
+	if (lastPage?.pagination?.hasMore) return lastPageParam + 1;
+}
+function selectFlatScores(data) {
+	const seen = /* @__PURE__ */ new Set();
+	return data.pages.flatMap((page) => page.scores ?? []).filter((score) => {
+		if (seen.has(score.id)) return false;
+		seen.add(score.id);
+		return true;
+	});
+}
+const useScoresByScorerId = ({ scorerId, entityId, entityType, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const { inView: isEndOfListInView, setRef: setEndOfListElement } = require_use_in_view.useInView();
+	const query = (0, _tanstack_react_query.useInfiniteQuery)({
+		queryKey: [
+			"scores",
+			scorerId,
+			entityId,
+			entityType
+		],
+		queryFn: ({ pageParam }) => client.listScoresByScorerId({
+			scorerId,
+			page: pageParam,
+			perPage: SCORES_PER_PAGE,
+			entityId,
+			entityType
+		}),
+		initialPageParam: 0,
+		getNextPageParam: getScoresNextPageParam,
+		select: (data) => selectFlatScores(data),
+		refetchInterval: getScoresRefetchInterval,
+		...queryOptions
+	});
+	const { hasNextPage, isFetchingNextPage, fetchNextPage } = query;
+	(0, react.useEffect)(() => {
+		if (isEndOfListInView && hasNextPage && !isFetchingNextPage) fetchNextPage();
+	}, [
+		isEndOfListInView,
+		hasNextPage,
+		isFetchingNextPage,
+		fetchNextPage
+	]);
+	return {
+		...query,
+		setEndOfListElement
+	};
+};
+const useScorer = (scorerId) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const [scorer, setScorer] = (0, react.useState)(null);
+	const [isLoading, setIsLoading] = (0, react.useState)(true);
+	const [error, setError] = (0, react.useState)(null);
+	(0, react.useEffect)(() => {
+		const fetchScorer = async () => {
+			setIsLoading(true);
+			setError(null);
+			try {
+				const res = await client.getScorer(scorerId);
+				setScorer(res);
+			} catch (error) {
+				setScorer(null);
+				const errorObj = error instanceof Error ? error : /* @__PURE__ */ new Error("Error fetching scorer");
+				setError(errorObj);
+				console.error("Error fetching scorer", error);
+			} finally {
+				setIsLoading(false);
+			}
+		};
+		fetchScorer();
+	}, [scorerId, client]);
+	return {
+		scorer,
+		isLoading,
+		error
+	};
+};
+const useScorers = ({ requestContext, queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["scorers", requestContext],
+		queryFn: () => client.listScorers(requestContext),
+		staleTime: 0,
+		gcTime: 0,
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/scores/use-trace-span-scores.ts
+const TRACE_SPAN_SCORES_REFETCH_INTERVAL_MS = 15e3;
+function getTraceSpanScoresRefetchInterval(query) {
+	if (require_query_utils.isUnsupportedObservabilityOperationError(query.state.error, "scores") || require_query_utils.isObservabilityUnavailableError(query.state.error)) return false;
+	return TRACE_SPAN_SCORES_REFETCH_INTERVAL_MS;
+}
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useTraceSpanScores = ({ traceId = "", spanId = "", page, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: [
+			"trace-span-scores",
+			traceId,
+			spanId,
+			page
+		],
+		queryFn: () => client.listScoresBySpan({
+			traceId,
+			spanId,
+			page: page || 0,
+			perPage: 10
+		}),
+		refetchInterval: getTraceSpanScoresRefetchInterval,
+		gcTime: 0,
+		staleTime: 0,
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/scores/use-trigger-scorer.ts
+const useTriggerScorer = ({ queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: async ({ scorerName, traceId, spanId }) => {
+			return await client.score({
+				scorerName,
+				targets: [{
+					traceId,
+					spanId
+				}]
+			});
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/scores/use-stored-scorers.ts
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useStoredScorer = ({ scorerId, status, requestContext, queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: [
+			"stored-scorer",
+			scorerId,
+			status,
+			requestContext
+		],
+		queryFn: () => scorerId ? client.getStoredScorer(scorerId).details(requestContext, { status }) : null,
+		...queryOptions
+	});
+};
+const useStoredScorerMutations = ({ scorerId, requestContext, queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const queryClient = (0, _tanstack_react_query.useQueryClient)();
+	return {
+		createStoredScorer: (0, _tanstack_react_query.useMutation)({
+			mutationFn: (params) => client.createStoredScorer(params),
+			onSuccess: () => {
+				queryClient.invalidateQueries({ queryKey: ["stored-scorers"] });
+				queryClient.invalidateQueries({ queryKey: ["scorers"] });
+			},
+			...queryOptions?.createStoredScorer
+		}),
+		updateStoredScorer: (0, _tanstack_react_query.useMutation)({
+			mutationFn: (params) => {
+				if (!scorerId) throw new Error("scorerId is required for update");
+				return client.getStoredScorer(scorerId).update(params, requestContext);
+			},
+			onSuccess: () => {
+				queryClient.invalidateQueries({ queryKey: ["stored-scorers"] });
+				queryClient.invalidateQueries({ queryKey: ["scorers"] });
+				if (scorerId) queryClient.invalidateQueries({ queryKey: ["stored-scorer", scorerId] });
+			},
+			...queryOptions?.updateStoredScorer
+		}),
+		deleteStoredScorer: (0, _tanstack_react_query.useMutation)({
+			mutationFn: () => {
+				if (!scorerId) throw new Error("scorerId is required for delete");
+				return client.getStoredScorer(scorerId).delete(requestContext);
+			},
+			onSuccess: () => {
+				queryClient.invalidateQueries({ queryKey: ["stored-scorers"] });
+				queryClient.invalidateQueries({ queryKey: ["scorers"] });
+				if (scorerId) queryClient.invalidateQueries({ queryKey: ["stored-scorer", scorerId] });
+			},
+			...queryOptions?.deleteStoredScorer
+		})
+	};
+};
+//#endregion
+//#region src/hooks/scores/use-scorer-versions.ts
+/**
+* Hook to list versions of a stored scorer
+*
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useScorerVersions = ({ scorerId, params, requestContext, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: [
+			"scorer-versions",
+			scorerId,
+			params,
+			requestContext
+		],
+		queryFn: () => client.getStoredScorer(scorerId).listVersions(params, requestContext),
+		...queryOptions
+	});
+};
+/**
+* Hook to get a single version of a stored scorer
+*
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useScorerVersion = ({ scorerId, versionId, requestContext, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: [
+			"scorer-version",
+			scorerId,
+			versionId,
+			requestContext
+		],
+		queryFn: () => client.getStoredScorer(scorerId).getVersion(versionId, requestContext),
+		...queryOptions
+	});
+};
+/**
+* Hook to create a new version of a stored scorer
+*/
+const useCreateScorerVersion = ({ scorerId, requestContext, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const queryClient = (0, _tanstack_react_query.useQueryClient)();
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: (params) => client.getStoredScorer(scorerId).createVersion(params, requestContext),
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: ["scorer-versions", scorerId] });
+			queryClient.invalidateQueries({ queryKey: ["stored-scorer", scorerId] });
+		},
+		...queryOptions
+	});
+};
+/**
+* Hook to activate a specific version of a stored scorer
+*/
+const useActivateScorerVersion = ({ scorerId, requestContext, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const queryClient = (0, _tanstack_react_query.useQueryClient)();
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: (versionId) => client.getStoredScorer(scorerId).activateVersion(versionId, requestContext),
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: ["scorer-versions", scorerId] });
+			queryClient.invalidateQueries({ queryKey: ["stored-scorer", scorerId] });
+		},
+		...queryOptions
+	});
+};
+/**
+* Hook to restore a specific version of a stored scorer (creates a new version from an old one)
+*/
+const useRestoreScorerVersion = ({ scorerId, requestContext, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const queryClient = (0, _tanstack_react_query.useQueryClient)();
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: (versionId) => client.getStoredScorer(scorerId).restoreVersion(versionId, requestContext),
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: ["scorer-versions", scorerId] });
+			queryClient.invalidateQueries({ queryKey: ["stored-scorer", scorerId] });
+		},
+		...queryOptions
+	});
+};
+/**
+* Hook to delete a specific version of a stored scorer
+*/
+const useDeleteScorerVersion = ({ scorerId, requestContext, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const queryClient = (0, _tanstack_react_query.useQueryClient)();
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: (versionId) => client.getStoredScorer(scorerId).deleteVersion(versionId, requestContext),
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: ["scorer-versions", scorerId] });
+		},
+		...queryOptions
+	});
+};
+/**
+* Hook to compare two versions of a stored scorer
+*
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useCompareScorerVersions = ({ scorerId, fromVersionId, toVersionId, requestContext, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: [
+			"scorer-versions-compare",
+			scorerId,
+			fromVersionId,
+			toVersionId,
+			requestContext
+		],
+		queryFn: () => client.getStoredScorer(scorerId).compareVersions(fromVersionId, toVersionId, requestContext),
+		...queryOptions
+	});
+};
+//#endregion
+exports.getScoresRefetchInterval = getScoresRefetchInterval;
+exports.getTraceSpanScoresRefetchInterval = getTraceSpanScoresRefetchInterval;
+exports.useActivateScorerVersion = useActivateScorerVersion;
+exports.useCompareScorerVersions = useCompareScorerVersions;
+exports.useCreateScorerVersion = useCreateScorerVersion;
+exports.useDeleteScorerVersion = useDeleteScorerVersion;
+exports.useRestoreScorerVersion = useRestoreScorerVersion;
+exports.useScorer = useScorer;
+exports.useScorerVersion = useScorerVersion;
+exports.useScorerVersions = useScorerVersions;
+exports.useScorers = useScorers;
+exports.useScoresByScorerId = useScoresByScorerId;
+exports.useStoredScorer = useStoredScorer;
+exports.useStoredScorerMutations = useStoredScorerMutations;
+exports.useTraceSpanScores = useTraceSpanScores;
+exports.useTriggerScorer = useTriggerScorer;
+
+//# sourceMappingURL=index.cjs.map

package/dist/hooks/scores/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["isUnsupportedObservabilityOperationError","isObservabilityUnavailableError","useMastraClient","useInView","isUnsupportedObservabilityOperationError","isObservabilityUnavailableError","useMastraClient","useMastraClient","useMastraClient","useMastraClient"],"sources":["../../../src/hooks/scores/use-scorers.ts","../../../src/hooks/scores/use-trace-span-scores.ts","../../../src/hooks/scores/use-trigger-scorer.ts","../../../src/hooks/scores/use-stored-scorers.ts","../../../src/hooks/scores/use-scorer-versions.ts"],"sourcesContent":["import type { MastraClient, GetScorerResponse, ListScoresResponse } from '@mastra/client-js';\nimport type { UseInfiniteQueryResult, UseQueryResult } from '@tanstack/react-query';\nimport { useInfiniteQuery, useQuery } from '@tanstack/react-query';\nimport { useEffect, useState } from 'react';\nimport { useMastraClient } from '../../mastra-client-context';\nimport { isObservabilityUnavailableError, isUnsupportedObservabilityOperationError } from '../query/query-utils';\nimport type { MastraInfiniteQueryOptions, MastraQueryOptions } from '../shared/query-options';\nimport { useInView } from '../shared/use-in-view';\n\nconst SCORES_PER_PAGE = 25;\nconst SCORES_REFETCH_INTERVAL_MS = 15_000;\n\nexport function getScoresRefetchInterval(query: { state: { error: unknown } }) {\n  if (\n    isUnsupportedObservabilityOperationError(query.state.error, 'scores') ||\n    isObservabilityUnavailableError(query.state.error)\n  ) {\n    return false;\n  }\n  return SCORES_REFETCH_INTERVAL_MS;\n}\n\ntype UseScoresByScorerIdProps<TData> = {\n  scorerId: string;\n  entityId?: string;\n  entityType?: string;\n  /** TanStack overrides spread last; `select` defaults to the flattened, de-duplicated score list. */\n  queryOptions?: MastraInfiniteQueryOptions<ListScoresResponse, TData, readonly unknown[], number>;\n};\n\nfunction getScoresNextPageParam(lastPage: ListScoresResponse | undefined, _allPages: unknown, lastPageParam: number) {\n  if (lastPage?.pagination?.hasMore) {\n    return lastPageParam + 1;\n  }\n  return undefined;\n}\n\nfunction selectFlatScores(data: { pages: ListScoresResponse[] }) {\n  const seen = new Set<string>();\n  const scores = data.pages\n    .flatMap(page => page.scores ?? [])\n    .filter(score => {\n      if (seen.has(score.id)) return false;\n      seen.add(score.id);\n      return true;\n    });\n  return scores;\n}\n\nexport const useScoresByScorerId = <TData = ReturnType<typeof selectFlatScores>>({\n  scorerId,\n  entityId,\n  entityType,\n  queryOptions,\n}: UseScoresByScorerIdProps<TData>): UseInfiniteQueryResult<TData, Error> & {\n  setEndOfListElement: ReturnType<typeof useInView>['setRef'];\n} => {\n  const client = useMastraClient();\n  const { inView: isEndOfListInView, setRef: setEndOfListElement } = useInView();\n\n  const query = useInfiniteQuery<ListScoresResponse, Error, TData, readonly unknown[], number>({\n    queryKey: ['scores', scorerId, entityId, entityType],\n    queryFn: ({ pageParam }) =>\n      client.listScoresByScorerId({ scorerId, page: pageParam, perPage: SCORES_PER_PAGE, entityId, entityType }),\n    initialPageParam: 0,\n    getNextPageParam: getScoresNextPageParam,\n    select: data => selectFlatScores(data) as TData,\n    refetchInterval: getScoresRefetchInterval,\n    ...queryOptions,\n  });\n\n  const { hasNextPage, isFetchingNextPage, fetchNextPage } = query;\n\n  useEffect(() => {\n    if (isEndOfListInView && hasNextPage && !isFetchingNextPage) {\n      void fetchNextPage();\n    }\n  }, [isEndOfListInView, hasNextPage, isFetchingNextPage, fetchNextPage]);\n\n  return { ...query, setEndOfListElement };\n};\n\nexport const useScorer = (scorerId: string) => {\n  const client = useMastraClient();\n  const [scorer, setScorer] = useState<GetScorerResponse | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    const fetchScorer = async () => {\n      setIsLoading(true);\n      setError(null);\n      try {\n        const res = await client.getScorer(scorerId);\n        setScorer(res);\n      } catch (error) {\n        setScorer(null);\n        const errorObj = error instanceof Error ? error : new Error('Error fetching scorer');\n        setError(errorObj);\n        console.error('Error fetching scorer', error);\n      } finally {\n        setIsLoading(false);\n      }\n    };\n\n    void fetchScorer();\n  }, [scorerId, client]);\n\n  return { scorer, isLoading, error };\n};\n\ntype ListScorersResponse = Awaited<ReturnType<MastraClient['listScorers']>>;\n\nexport const useScorers = <TData = ListScorersResponse>({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, unknown>;\n  queryOptions?: MastraQueryOptions<ListScorersResponse, TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery<ListScorersResponse, Error, TData>({\n    queryKey: ['scorers', requestContext],\n    queryFn: () => client.listScorers(requestContext),\n    staleTime: 0,\n    gcTime: 0,\n    ...queryOptions,\n  });\n};\n","import type { ListScoresResponse } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport { isObservabilityUnavailableError, isUnsupportedObservabilityOperationError } from '../query/query-utils';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nconst TRACE_SPAN_SCORES_REFETCH_INTERVAL_MS = 15_000;\n\nexport function getTraceSpanScoresRefetchInterval(query: { state: { error: unknown } }) {\n  if (\n    isUnsupportedObservabilityOperationError(query.state.error, 'scores') ||\n    isObservabilityUnavailableError(query.state.error)\n  ) {\n    return false;\n  }\n  return TRACE_SPAN_SCORES_REFETCH_INTERVAL_MS;\n}\n\ntype useTraceSpanScoresProps<TData> = {\n  traceId?: string;\n  spanId?: string;\n  page?: number;\n  queryOptions?: MastraQueryOptions<ListScoresResponse, TData>;\n};\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useTraceSpanScores = <TData = ListScoresResponse>({\n  traceId = '',\n  spanId = '',\n  page,\n  queryOptions,\n}: useTraceSpanScoresProps<TData>): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n  return useQuery<ListScoresResponse, Error, TData>({\n    queryKey: ['trace-span-scores', traceId, spanId, page],\n    queryFn: () => client.listScoresBySpan({ traceId, spanId, page: page || 0, perPage: 10 }),\n    refetchInterval: getTraceSpanScoresRefetchInterval,\n    gcTime: 0,\n    staleTime: 0,\n    ...queryOptions,\n  });\n};\n","import type { MastraClient } from '@mastra/client-js';\nimport { useMutation } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions } from '../shared/query-options';\n\ninterface TriggerScoreArgs {\n  scorerName: string;\n  traceId: string;\n  spanId?: string;\n}\n\ntype TriggerScorerResponse = Awaited<ReturnType<MastraClient['score']>>;\n\nexport const useTriggerScorer = ({\n  queryOptions,\n}: { queryOptions?: MastraMutationOptions<TriggerScorerResponse, TriggerScoreArgs> } = {}) => {\n  const client = useMastraClient();\n\n  return useMutation({\n    mutationFn: async ({ scorerName, traceId, spanId }: TriggerScoreArgs) => {\n      const response = await client.score({\n        scorerName,\n        targets: [{ traceId, spanId }],\n      });\n\n      return response;\n    },\n    ...queryOptions,\n  });\n};\n","import type { MastraClient, CreateStoredScorerParams, UpdateStoredScorerParams } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\n\ntype StoredScorerResponse = Awaited<ReturnType<ReturnType<MastraClient['getStoredScorer']>['details']>>;\ntype DeleteStoredScorerResponse = Awaited<ReturnType<ReturnType<MastraClient['getStoredScorer']>['delete']>>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useStoredScorer = <TData = StoredScorerResponse | null>({\n  scorerId,\n  status,\n  requestContext,\n  queryOptions,\n}: {\n  scorerId?: string;\n  status?: 'draft' | 'published';\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<StoredScorerResponse | null, TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery<StoredScorerResponse | null, Error, TData>({\n    queryKey: ['stored-scorer', scorerId, status, requestContext],\n    queryFn: () => (scorerId ? client.getStoredScorer(scorerId).details(requestContext, { status }) : null),\n    ...queryOptions,\n  });\n};\n\nexport const useStoredScorerMutations = ({\n  scorerId,\n  requestContext,\n  queryOptions,\n}: {\n  scorerId?: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: {\n    createStoredScorer?: MastraMutationOptions<StoredScorerResponse, CreateStoredScorerParams>;\n    updateStoredScorer?: MastraMutationOptions<StoredScorerResponse, UpdateStoredScorerParams>;\n    deleteStoredScorer?: MastraMutationOptions<DeleteStoredScorerResponse, void>;\n  };\n} = {}) => {\n  const client = useMastraClient();\n  const queryClient = useQueryClient();\n\n  const createMutation = useMutation({\n    mutationFn: (params: CreateStoredScorerParams) => client.createStoredScorer(params),\n    onSuccess: () => {\n      void queryClient.invalidateQueries({ queryKey: ['stored-scorers'] });\n      void queryClient.invalidateQueries({ queryKey: ['scorers'] });\n    },\n    ...queryOptions?.createStoredScorer,\n  });\n\n  const updateMutation = useMutation({\n    mutationFn: (params: UpdateStoredScorerParams) => {\n      if (!scorerId) throw new Error('scorerId is required for update');\n      return client.getStoredScorer(scorerId).update(params, requestContext);\n    },\n    onSuccess: () => {\n      void queryClient.invalidateQueries({ queryKey: ['stored-scorers'] });\n      void queryClient.invalidateQueries({ queryKey: ['scorers'] });\n      if (scorerId) {\n        void queryClient.invalidateQueries({ queryKey: ['stored-scorer', scorerId] });\n      }\n    },\n    ...queryOptions?.updateStoredScorer,\n  });\n\n  const deleteMutation = useMutation({\n    mutationFn: () => {\n      if (!scorerId) throw new Error('scorerId is required for delete');\n      return client.getStoredScorer(scorerId).delete(requestContext);\n    },\n    onSuccess: () => {\n      void queryClient.invalidateQueries({ queryKey: ['stored-scorers'] });\n      void queryClient.invalidateQueries({ queryKey: ['scorers'] });\n      if (scorerId) {\n        void queryClient.invalidateQueries({ queryKey: ['stored-scorer', scorerId] });\n      }\n    },\n    ...queryOptions?.deleteStoredScorer,\n  });\n\n  return {\n    createStoredScorer: createMutation,\n    updateStoredScorer: updateMutation,\n    deleteStoredScorer: deleteMutation,\n  };\n};\n","import type {\n  ListScorerVersionsParams,\n  CreateScorerVersionParams,\n  ListScorerVersionsResponse,\n  ScorerVersionResponse,\n  CompareScorerVersionsResponse,\n  ActivateScorerVersionResponse,\n  DeleteScorerVersionResponse,\n} from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\n\nexport type { ListScorerVersionsParams, CreateScorerVersionParams };\n\n/**\n * Hook to list versions of a stored scorer\n *\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useScorerVersions = <TData = ListScorerVersionsResponse>({\n  scorerId,\n  params,\n  requestContext,\n  queryOptions,\n}: {\n  scorerId: string;\n  params?: ListScorerVersionsParams;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<ListScorerVersionsResponse, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery<ListScorerVersionsResponse, Error, TData>({\n    queryKey: ['scorer-versions', scorerId, params, requestContext],\n    queryFn: () => client.getStoredScorer(scorerId).listVersions(params, requestContext),\n    ...queryOptions,\n  });\n};\n\n/**\n * Hook to get a single version of a stored scorer\n *\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useScorerVersion = <TData = ScorerVersionResponse>({\n  scorerId,\n  versionId,\n  requestContext,\n  queryOptions,\n}: {\n  scorerId: string;\n  versionId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<ScorerVersionResponse, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery<ScorerVersionResponse, Error, TData>({\n    queryKey: ['scorer-version', scorerId, versionId, requestContext],\n    queryFn: () => client.getStoredScorer(scorerId).getVersion(versionId, requestContext),\n    ...queryOptions,\n  });\n};\n\n/**\n * Hook to create a new version of a stored scorer\n */\nexport const useCreateScorerVersion = ({\n  scorerId,\n  requestContext,\n  queryOptions,\n}: {\n  scorerId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraMutationOptions<ScorerVersionResponse, CreateScorerVersionParams | undefined>;\n}) => {\n  const client = useMastraClient();\n  const queryClient = useQueryClient();\n\n  return useMutation<ScorerVersionResponse, Error, CreateScorerVersionParams | undefined>({\n    mutationFn: (params?: CreateScorerVersionParams) =>\n      client.getStoredScorer(scorerId).createVersion(params, requestContext),\n    onSuccess: () => {\n      void queryClient.invalidateQueries({ queryKey: ['scorer-versions', scorerId] });\n      void queryClient.invalidateQueries({ queryKey: ['stored-scorer', scorerId] });\n    },\n    ...queryOptions,\n  });\n};\n\n/**\n * Hook to activate a specific version of a stored scorer\n */\nexport const useActivateScorerVersion = ({\n  scorerId,\n  requestContext,\n  queryOptions,\n}: {\n  scorerId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraMutationOptions<ActivateScorerVersionResponse, string>;\n}) => {\n  const client = useMastraClient();\n  const queryClient = useQueryClient();\n\n  return useMutation<ActivateScorerVersionResponse, Error, string>({\n    mutationFn: (versionId: string) => client.getStoredScorer(scorerId).activateVersion(versionId, requestContext),\n    onSuccess: () => {\n      void queryClient.invalidateQueries({ queryKey: ['scorer-versions', scorerId] });\n      void queryClient.invalidateQueries({ queryKey: ['stored-scorer', scorerId] });\n    },\n    ...queryOptions,\n  });\n};\n\n/**\n * Hook to restore a specific version of a stored scorer (creates a new version from an old one)\n */\nexport const useRestoreScorerVersion = ({\n  scorerId,\n  requestContext,\n  queryOptions,\n}: {\n  scorerId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraMutationOptions<ScorerVersionResponse, string>;\n}) => {\n  const client = useMastraClient();\n  const queryClient = useQueryClient();\n\n  return useMutation<ScorerVersionResponse, Error, string>({\n    mutationFn: (versionId: string) => client.getStoredScorer(scorerId).restoreVersion(versionId, requestContext),\n    onSuccess: () => {\n      void queryClient.invalidateQueries({ queryKey: ['scorer-versions', scorerId] });\n      void queryClient.invalidateQueries({ queryKey: ['stored-scorer', scorerId] });\n    },\n    ...queryOptions,\n  });\n};\n\n/**\n * Hook to delete a specific version of a stored scorer\n */\nexport const useDeleteScorerVersion = ({\n  scorerId,\n  requestContext,\n  queryOptions,\n}: {\n  scorerId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraMutationOptions<DeleteScorerVersionResponse, string>;\n}) => {\n  const client = useMastraClient();\n  const queryClient = useQueryClient();\n\n  return useMutation<DeleteScorerVersionResponse, Error, string>({\n    mutationFn: (versionId: string) => client.getStoredScorer(scorerId).deleteVersion(versionId, requestContext),\n    onSuccess: () => {\n      void queryClient.invalidateQueries({ queryKey: ['scorer-versions', scorerId] });\n    },\n    ...queryOptions,\n  });\n};\n\n/**\n * Hook to compare two versions of a stored scorer\n *\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useCompareScorerVersions = <TData = CompareScorerVersionsResponse>({\n  scorerId,\n  fromVersionId,\n  toVersionId,\n  requestContext,\n  queryOptions,\n}: {\n  scorerId: string;\n  fromVersionId: string;\n  toVersionId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<CompareScorerVersionsResponse, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery<CompareScorerVersionsResponse, Error, TData>({\n    queryKey: ['scorer-versions-compare', scorerId, fromVersionId, toVersionId, requestContext],\n    queryFn: () => client.getStoredScorer(scorerId).compareVersions(fromVersionId, toVersionId, requestContext),\n    ...queryOptions,\n  });\n};\n"],"mappings":"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"}

package/dist/hooks/scores/index.d.ts

@@ -0,0 +1,6 @@
+export { useScorers, useScorer, useScoresByScorerId, getScoresRefetchInterval } from './use-scorers.js';
+export { useTraceSpanScores, getTraceSpanScoresRefetchInterval } from './use-trace-span-scores.js';
+export { useTriggerScorer } from './use-trigger-scorer.js';
+export * from './use-stored-scorers.js';
+export * from './use-scorer-versions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/scores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/scores/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,kBAAkB,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}