@uipath/apollo-vertex 0.3.0 → 1.0.0

package/README.md

@@ -27,14 +27,14 @@ Everything, including the app shell, charts, feature flags, Solution Tests and A
 from the package root. Translation JSON files are available at `@uipath/apollo-vertex/locales/*`.
 
 npm 7+ and pnpm install the packages in `peerDependencies` automatically. Install these three
-yourself, because they are not on the public npm registry:
+yourself:
 
 - `@uipath/vs-core`
 - `@tanstack/react-db`
 - `@uipath/proteus-client`
 
 They are declared only in `peerDependenciesMeta` (as optional) so that pnpm does not try to install them
-in this workspace.
+in this workspace. The two `@uipath` packages are not on the public npm registry.
 
 ## Layout
 
@@ -60,6 +60,7 @@ pnpm build         # Generate theme.css, build dist/ with rslib, check every exp
 pnpm build:check   # List the external packages each public entry reaches
 pnpm lint          # oxlint (type-aware)
 pnpm lint:deps     # Check that registry files only import from registry/ and lib/
+pnpm -w knip       # Find unused files, exports and dependencies (both workspaces)
 pnpm typecheck     # tsc --noEmit
 pnpm format        # Biome
 ```

package/dist/entries/index.d.ts

@@ -58,7 +58,7 @@ export * from "../registry/toggle-group/toggle-group";
 export * from "../registry/tooltip/tooltip";
 export * from "../registry/confidence-signal/confidence-signal";
 export * from "../registry/data-table";
-export { CheckboxField, type CheckboxFieldProps, type FieldOption, RadioGroupField, type RadioGroupFieldProps, SelectField, type SelectFieldProps, SubmitButton, type SubmitButtonProps, SwitchField, type SwitchFieldProps, TextareaField, type TextareaFieldProps, TextField, type TextFieldProps, useAppForm, useFieldContext, useFormContext, useTranslatedErrors, withForm, } from "../registry/form";
+export { CheckboxField, type CheckboxFieldProps, FieldError as FormFieldError, type FieldErrorProps as FormFieldErrorProps, type FieldOption, RadioGroupField, type RadioGroupFieldProps, SelectField, type SelectFieldProps, SubmitButton, type SubmitButtonProps, SwitchField, type SwitchFieldProps, TextareaField, type TextareaFieldProps, TextField, type TextFieldProps, useAppForm, useFieldContext, useFormContext, useTranslatedErrors, withForm, } from "../registry/form";
 export * from "../registry/form-wizard";
 export * from "../registry/onboarding-tour-joyride";
 export * from "../registry/sidebar/sidebar";
@@ -67,6 +67,8 @@ export * from "../registry/timeline";
 export { useIsMobile } from "../registry/use-mobile/use-mobile";
 export { type UseDataTableOptions, useDataTable, } from "../registry/use-data-table/useDataTable";
 export { cn } from "../lib/utils";
+export { assertDateOrString } from "../lib/asserts/assert-date-or-string";
+export { assertString } from "../lib/asserts/assert-string";
 export { addVertexTranslations } from "../lib/i18n";
 export * from "../registry/chart/chart";
 export * from "../registry/bar-chart/bar-chart";
@@ -84,19 +86,20 @@ export { LocaleProvider } from "../registry/shell/shell-locale-provider";
 export { ThemeProvider } from "../registry/shell/shell-theme-provider";
 export { MembershipDenied, VerifyingMembership, type MembershipDeniedProps, } from "../registry/shell/group-membership-screens";
 export { Role } from "../registry/shell/shell-roles";
+export { STALE_TIME_MS } from "../registry/shell/shell-constants";
 export { useAccessToken } from "../registry/shell/shell-auth-provider";
 export { useTheme } from "../registry/shell/shell-theme-provider";
 export { ShellLogin } from "../registry/shell/shell-login";
 export { ShellLayout } from "../registry/shell/shell-layout";
 export { ShellSidebar } from "../registry/shell/shell-sidebar";
-export { ShellUserProvider } from "../registry/shell/shell-user-provider";
+export { ShellUserProvider, useUser, type User, } from "../registry/shell/shell-user-provider";
 export { SUPPORTED_LOCALES, configurei18n, type SupportedLocale, } from "../lib/i18n";
-export { STORAGE_KEYS, TOKEN_QUERY_KEY, ensureValidToken, login, logout, resolveReturnPath, toCodedAppFilePath, } from "../lib/auth";
-export { GroupMembershipGuard } from "../registry/shell/group-membership-guard";
-export { useGroupId } from "../registry/shell/use-group-id";
-export { useGroupMembers } from "../registry/shell/use-group-members";
+export { STORAGE_KEYS, TOKEN_QUERY_KEY, type TokenData, ensureValidToken, getStoredIdToken, getTokenQueryKey, login, logout, resolveReturnPath, toCodedAppFilePath, } from "../lib/auth";
+export { GroupMembershipGuard, type GroupMembershipGuardProps, } from "../registry/shell/group-membership-guard";
+export { useGroupId, type UseGroupIdOptions, type UseGroupIdResult, } from "../registry/shell/use-group-id";
+export { useGroupMembers, type UseGroupMembersOptions, type UseGroupMembersResult, } from "../registry/shell/use-group-members";
 export { useIsGroupMember } from "../registry/shell/use-is-group-member";
-export { useEntityDataTable } from "../registry/use-data-table/useEntityDataTable";
+export { useEntityDataTable, type UseEntityDataTableOptions, } from "../registry/use-data-table/useEntityDataTable";
 export { useEntityColumns } from "../registry/use-data-table/useEntityColumns";
 export { FeatureFlagContext, FeatureFlagProvider, useFeatureFlagProvider, } from "../registry/feature-flag-provider/feature-flag-provider";
 export { FeatureFlagGuard } from "../registry/feature-flag-guard/feature-flag-guard";
@@ -128,7 +131,7 @@ export { CaseEvaluationOutputSchema } from "../registry/solution-tests/outputs/c
 export type { CaseEvaluationOutput, EvaluationRecord, } from "../registry/solution-tests/outputs/case-evaluation/schema";
 export type { IxpOutput, IxpDocumentExtraction, IxpExtractionGroup, IxpFieldValue, } from "../registry/solution-tests/outputs/ixp-extraction/schema";
 export { SolutionTestStatus, RunStatus, RunResultStatus, JobRole, } from "../registry/solution-tests/types";
-export type { SolutionTest, SolutionTestJob, SolutionTestRun, SolutionTestBatchRun, SolutionTestRunResult, UserMessageItem, ResultAttachmentField, } from "../registry/solution-tests/types";
+export type { SolutionTest, SolutionTestJob, SolutionTestRun, SolutionTestBatchRun, SolutionTestRunResult, UserMessageItem, ResultAttachmentField, SolutionTestStatusValue, RunStatusValue, RunResultStatusValue, JobRoleValue, } from "../registry/solution-tests/types";
 export type { RunConfirmTarget } from "../registry/solution-tests/solution-tests-view";
 export { RunDetailsView } from "../registry/solution-tests/run-details-view";
 export type { BaselineJobMap, RunDetailsViewProps, } from "../registry/solution-tests/run-details-view";
@@ -152,9 +155,11 @@ export { createConversationalAgentConnection } from "../registry/ai-chat/adapter
 export type { ConversationalAgentAdapterConfig } from "../registry/ai-chat/adapters/conversational-agent/adapter";
 export { AiChat } from "../registry/ai-chat/components/ai-chat";
 export { AiChatEmptyState } from "../registry/ai-chat/components/ai-chat-empty-state";
+export { NoDataMessage } from "../registry/ai-chat/charts/no-data-message";
 export { AutopilotGradientIcon } from "../registry/ai-chat/components/icons/autopilot-gradient";
 export * from "../registry/ai-chat/tools/choices";
 export type { Entity } from "../registry/ai-chat/tools/data-fabric/util/entities";
+export type { JoinInput } from "../registry/ai-chat/tools/data-fabric/util/joins";
 export * from "../registry/ai-chat/tools/data-fabric-bar";
 export * from "../registry/ai-chat/tools/data-fabric-distribution";
 export * from "../registry/ai-chat/tools/data-fabric-kpi";

package/dist/entries/index.js

@@ -1,7 +1,9 @@
-import { CheckboxField, RadioGroupField, SelectField, SubmitButton, SwitchField, TextField, TextareaField, useAppForm, useFieldContext, useFormContext, useTranslatedErrors, withForm } from "../registry/form/index.js";
+import { CheckboxField, FieldError, RadioGroupField, SelectField, SubmitButton, SwitchField, TextField, TextareaField, useAppForm, useFieldContext, useFormContext, useTranslatedErrors, withForm } from "../registry/form/index.js";
 import { useIsMobile } from "../registry/use-mobile/use-mobile.js";
 import { useDataTable } from "../registry/use-data-table/useDataTable.js";
 import { cn } from "../lib/utils.js";
+import { assertDateOrString } from "../lib/asserts/assert-date-or-string.js";
+import { assertString } from "../lib/asserts/assert-string.js";
 import { SUPPORTED_LOCALES, addVertexTranslations, configurei18n } from "../lib/i18n.js";
 import { ApolloShell } from "../registry/shell/shell.js";
 import { AuthContext, ShellAuthProvider, useAccessToken, useAuth } from "../registry/shell/shell-auth-provider.js";
@@ -9,11 +11,12 @@ import { LocaleProvider } from "../registry/shell/shell-locale-provider.js";
 import { ThemeProvider, useTheme } from "../registry/shell/shell-theme-provider.js";
 import { MembershipDenied, VerifyingMembership } from "../registry/shell/group-membership-screens.js";
 import { Role } from "../registry/shell/shell-roles.js";
+import { STALE_TIME_MS } from "../registry/shell/shell-constants.js";
 import { ShellLogin } from "../registry/shell/shell-login.js";
 import { ShellLayout } from "../registry/shell/shell-layout.js";
 import { ShellSidebar } from "../registry/shell/shell-sidebar.js";
-import { ShellUserProvider } from "../registry/shell/shell-user-provider.js";
-import { STORAGE_KEYS, TOKEN_QUERY_KEY, ensureValidToken, login, logout, resolveReturnPath, toCodedAppFilePath } from "../lib/auth.js";
+import { ShellUserProvider, useUser } from "../registry/shell/shell-user-provider.js";
+import { STORAGE_KEYS, TOKEN_QUERY_KEY, ensureValidToken, getStoredIdToken, getTokenQueryKey, login, logout, resolveReturnPath, toCodedAppFilePath } from "../lib/auth.js";
 import { GroupMembershipGuard } from "../registry/shell/group-membership-guard.js";
 import { useGroupId } from "../registry/shell/use-group-id.js";
 import { useGroupMembers } from "../registry/shell/use-group-members.js";
@@ -54,6 +57,7 @@ import { createAgentHubConnection } from "../registry/ai-chat/adapters/agenthub/
 import { createConversationalAgentConnection } from "../registry/ai-chat/adapters/conversational-agent/adapter.js";
 import { AiChat } from "../registry/ai-chat/components/ai-chat.js";
 import { AiChatEmptyState } from "../registry/ai-chat/components/ai-chat-empty-state.js";
+import { NoDataMessage } from "../registry/ai-chat/charts/no-data-message.js";
 import { AutopilotGradientIcon } from "../registry/ai-chat/components/icons/autopilot-gradient.js";
 export * from "../registry/accordion/accordion.js";
 export * from "../registry/ai-caveat/ai-caveat.js";
@@ -138,4 +142,4 @@ export * from "../registry/ai-chat/tools/data-fabric-line/index.js";
 export * from "../registry/ai-chat/tools/data-fabric-multi-line/index.js";
 export * from "../registry/ai-chat/tools/data-fabric-table/index.js";
 export * from "../registry/ai-chat/tools/data-fabric/index.js";
-export { AiChat, AiChatEmptyState, ApolloShell, AuthContext, AutopilotGradientIcon, BaselineCompare, CASE_EVALUATION_EVALUATOR_ID, CASE_EVALUATION_OUTPUT_RENDERER, CaseEvaluationDetailsSchema, CaseEvaluationOutputResult, CaseEvaluationOutputSchema, CheckboxField, EvaluationPairStatus, ExpandedAgents, ExpandedAgentsView, ExpandedRunTests, ExpandedRunTestsView, FeatureFlagContext, FeatureFlagGuard, FeatureFlagProvider, GENERIC_RENDERER, GroupMembershipGuard, IXP_EXTRACTION_EVALUATOR_ID, IXP_OUTPUT_RENDERER, IxpDetailsSchema, IxpDocStatus, IxpOutputResult, IxpOutputSchema, IxpVerdict, JSON_SIMILARITY_EVALUATOR_ID, JobRole, LLM_JUDGE_EVALUATOR_ID, LocaleProvider, MembershipDenied, ProcessOutputView, ProtectedFeatureRoute, RadioGroupField, Role, RunDetails, RunDetailsView, RunResultStatus, RunStatus, STORAGE_KEYS, SUPPORTED_LOCALES, SaveAsTestButton, SelectField, ShellAuthProvider, ShellLayout, ShellLogin, ShellSidebar, ShellUserProvider, SolutionTestActionError, SolutionTestStatus, SolutionTests, SolutionTestsProvider, SolutionTestsView, SubmitButton, SummaryVerdict, SwitchField, TOKEN_QUERY_KEY, TextField, TextareaField, ThemeProvider, VerifyingMembership, VersionDeltaGlyph, addVertexTranslations, cn, configurei18n, createAgentHubConnection, createConversationalAgentConnection, createProteusProvider, ensureValidToken, genericRenderer, login, logout, makeProcessOutputRenderer, makeRenderer, resolveEvaluatorRenderer, resolveProcessOutputRenderer, resolveReturnPath, toCodedAppFilePath, useAccessToken, useAdoptJob, useAppForm, useAuth, useBaselineJobs, useCreateTest, useDataTable, useDeleteTest, useEntityColumns, useEntityDataTable, useFeatureFlag, useFeatureFlagProvider, useFieldContext, useForceStopBatch, useForceStopRun, useFormContext, useGroupId, useGroupMembers, useIsGroupMember, useIsMobile, useJobExpectedOutput, useRemoveJobBaseline, useResultAttachment, useRunResults, useRunTests, useSolutionTestBatchRuns, useSolutionTestRuns, useSolutionTests, useSolutionTestsConfig, useSolutionTestsContext, useTheme, useToggleTestActive, useTranslatedErrors, useUpdateBaseline, versionDelta, withForm };
+export { AiChat, AiChatEmptyState, ApolloShell, AuthContext, AutopilotGradientIcon, BaselineCompare, CASE_EVALUATION_EVALUATOR_ID, CASE_EVALUATION_OUTPUT_RENDERER, CaseEvaluationDetailsSchema, CaseEvaluationOutputResult, CaseEvaluationOutputSchema, CheckboxField, EvaluationPairStatus, ExpandedAgents, ExpandedAgentsView, ExpandedRunTests, ExpandedRunTestsView, FeatureFlagContext, FeatureFlagGuard, FeatureFlagProvider, FieldError as FormFieldError, GENERIC_RENDERER, GroupMembershipGuard, IXP_EXTRACTION_EVALUATOR_ID, IXP_OUTPUT_RENDERER, IxpDetailsSchema, IxpDocStatus, IxpOutputResult, IxpOutputSchema, IxpVerdict, JSON_SIMILARITY_EVALUATOR_ID, JobRole, LLM_JUDGE_EVALUATOR_ID, LocaleProvider, MembershipDenied, NoDataMessage, ProcessOutputView, ProtectedFeatureRoute, RadioGroupField, Role, RunDetails, RunDetailsView, RunResultStatus, RunStatus, STALE_TIME_MS, STORAGE_KEYS, SUPPORTED_LOCALES, SaveAsTestButton, SelectField, ShellAuthProvider, ShellLayout, ShellLogin, ShellSidebar, ShellUserProvider, SolutionTestActionError, SolutionTestStatus, SolutionTests, SolutionTestsProvider, SolutionTestsView, SubmitButton, SummaryVerdict, SwitchField, TOKEN_QUERY_KEY, TextField, TextareaField, ThemeProvider, VerifyingMembership, VersionDeltaGlyph, addVertexTranslations, assertDateOrString, assertString, cn, configurei18n, createAgentHubConnection, createConversationalAgentConnection, createProteusProvider, ensureValidToken, genericRenderer, getStoredIdToken, getTokenQueryKey, login, logout, makeProcessOutputRenderer, makeRenderer, resolveEvaluatorRenderer, resolveProcessOutputRenderer, resolveReturnPath, toCodedAppFilePath, useAccessToken, useAdoptJob, useAppForm, useAuth, useBaselineJobs, useCreateTest, useDataTable, useDeleteTest, useEntityColumns, useEntityDataTable, useFeatureFlag, useFeatureFlagProvider, useFieldContext, useForceStopBatch, useForceStopRun, useFormContext, useGroupId, useGroupMembers, useIsGroupMember, useIsMobile, useJobExpectedOutput, useRemoveJobBaseline, useResultAttachment, useRunResults, useRunTests, useSolutionTestBatchRuns, useSolutionTestRuns, useSolutionTests, useSolutionTestsConfig, useSolutionTestsContext, useTheme, useToggleTestActive, useTranslatedErrors, useUpdateBaseline, useUser, versionDelta, withForm };

package/dist/lib/auth.d.ts

@@ -5,6 +5,7 @@ export declare const STORAGE_KEYS: {
     readonly TOKEN: "uipath_token";
     readonly CODE_VERIFIER: "uipath_code_verifier";
     readonly STATE: "uipath_state";
+    readonly REQUESTED_SCOPE: "uipath_requested_scope";
     readonly AUTH_RETURN_TO: "auth_return_to";
     readonly LOGOUT_RETURN_TO: "logout_return_to";
 };
@@ -19,7 +20,9 @@ declare const TokenDataSchema: z.ZodObject<{
     expiresAt: z.ZodNumber;
 }, z.core.$strip>;
 export type TokenData = z.infer<typeof TokenDataSchema>;
-export declare const ensureValidToken: (queryClient: ReturnType<typeof useQueryClient>, clientId: string, baseUrl: string, redirectPath?: string) => Promise<string | null>;
+export declare const getTokenQueryKey: (clientId: string, scope: string) => readonly ["auth", "token", string, string];
+export declare const getStoredIdToken: (clientId: string, scope: string) => string | null;
+export declare const ensureValidToken: (clientId: string, scope: string, baseUrl: string, redirectPath?: string) => Promise<string | null>;
 export declare const login: (clientId: string, scope: string, baseUrl: string, redirectPath?: string) => Promise<void>;
-export declare const logout: (queryClient: ReturnType<typeof useQueryClient>) => void;
+export declare const logout: (queryClient: ReturnType<typeof useQueryClient>, clientId: string) => void;
 export {};

package/dist/lib/auth.js

@@ -1,3 +1,4 @@
+import { jwtDecode } from "jwt-decode";
 import pkce_challenge from "pkce-challenge";
 import { toast } from "sonner";
 import { z } from "zod";
@@ -15,6 +16,7 @@ const STORAGE_KEYS = {
     TOKEN: "uipath_token",
     CODE_VERIFIER: "uipath_code_verifier",
     STATE: "uipath_state",
+    REQUESTED_SCOPE: "uipath_requested_scope",
     AUTH_RETURN_TO: "auth_return_to",
     LOGOUT_RETURN_TO: "logout_return_to"
 };
@@ -56,11 +58,35 @@ const shouldRefreshToken = (tokenData)=>{
     const timeUntilExpiry = tokenData.expiresAt - Date.now();
     return timeUntilExpiry < REFRESH_THRESHOLD_MS;
 };
-const saveTokenData = (tokenData)=>{
-    localStorage.setItem(STORAGE_KEYS.TOKEN, JSON.stringify(tokenData));
+const normalizeScope = (scope)=>[
+        ...new Set(scope.split(/\s+/).filter(Boolean))
+    ].toSorted().join(" ");
+const getTokenStorageKey = (clientId, scope)=>`${STORAGE_KEYS.TOKEN}:${clientId}:${normalizeScope(scope)}`;
+const getTokenQueryKey = (clientId, scope)=>[
+        ...TOKEN_QUERY_KEY,
+        clientId,
+        normalizeScope(scope)
+    ];
+const readTokenData = (storageKey)=>{
+    try {
+        const { data, success } = TokenDataSchema.safeParse(JSON.parse(localStorage.getItem(storageKey) ?? "null"));
+        return success ? data : null;
+    } catch  {
+        return null;
+    }
+};
+const getStoredIdToken = (clientId, scope)=>readTokenData(getTokenStorageKey(clientId, scope))?.id_token ?? null;
+const saveTokenData = (storageKey, tokenData)=>{
+    localStorage.setItem(storageKey, JSON.stringify(tokenData));
 };
-const clearTokenData = ()=>{
-    localStorage.removeItem(STORAGE_KEYS.TOKEN);
+const clearTokenData = (storageKey)=>{
+    localStorage.removeItem(storageKey);
+};
+const clearPendingLogin = ()=>{
+    sessionStorage.removeItem(STORAGE_KEYS.CODE_VERIFIER);
+    sessionStorage.removeItem(STORAGE_KEYS.STATE);
+    sessionStorage.removeItem(STORAGE_KEYS.REQUESTED_SCOPE);
+    sessionStorage.removeItem(STORAGE_KEYS.AUTH_RETURN_TO);
 };
 const fetchTokenData = async (baseUrl, body)=>{
     const response = await fetch(getTokenEndpoint(baseUrl), {
@@ -88,14 +114,14 @@ const refreshAccessToken = (refreshToken, clientId, baseUrl)=>{
     });
     return fetchTokenData(baseUrl, body);
 };
-const refreshTokenIfNeeded = async (tokenData, clientId, baseUrl)=>{
+const refreshTokenIfNeeded = async (tokenData, clientId, baseUrl, storageKey)=>{
     if (!tokenData.refresh_token) return null;
     try {
         const newTokenData = await refreshAccessToken(tokenData.refresh_token, clientId, baseUrl);
-        saveTokenData(newTokenData);
+        saveTokenData(storageKey, newTokenData);
         return newTokenData.access_token;
     } catch  {
-        clearTokenData();
+        clearTokenData(storageKey);
         return null;
     }
 };
@@ -109,59 +135,50 @@ const exchangeCodeForToken = (code, codeVerifier, clientId, baseUrl, redirectPat
     });
     return fetchTokenData(baseUrl, body);
 };
-const handleOAuthCallback = async (clientId, baseUrl, redirectPath)=>{
+const handleOAuthCallback = async (clientId, scope, baseUrl, redirectPath)=>{
     const params = new URLSearchParams(window.location.search);
     const code = params.get("code");
     const state = params.get("state");
     const error = params.get("error");
-    if (error) throw new Error(`OAuth error: ${error}`);
-    if (!code || !state) return;
+    if (!state || !code && !error) return;
     const storedState = sessionStorage.getItem(STORAGE_KEYS.STATE);
-    if (state !== storedState) throw new Error("State mismatch");
     const codeVerifier = sessionStorage.getItem(STORAGE_KEYS.CODE_VERIFIER);
-    if (!codeVerifier) throw new Error("Code verifier not found");
+    const requestedScope = sessionStorage.getItem(STORAGE_KEYS.REQUESTED_SCOPE);
+    const returnTo = sessionStorage.getItem(STORAGE_KEYS.AUTH_RETURN_TO) ?? window.location.pathname;
+    clearPendingLogin();
     try {
+        if (null !== error || null === code) throw new Error(`OAuth error: ${error ?? "no code returned"}`);
+        if (state !== storedState) throw new Error("State mismatch");
+        if (!codeVerifier) throw new Error("Code verifier not found");
+        const loginUsedCurrentScope = null !== requestedScope && normalizeScope(requestedScope) === normalizeScope(scope);
+        if (!loginUsedCurrentScope) return void toast.info("Your sign-in settings changed. Please sign in again.");
         const tokenData = await exchangeCodeForToken(code, codeVerifier, clientId, baseUrl, redirectPath);
-        sessionStorage.removeItem(STORAGE_KEYS.CODE_VERIFIER);
-        sessionStorage.removeItem(STORAGE_KEYS.STATE);
-        saveTokenData(tokenData);
-        const returnTo = sessionStorage.getItem(STORAGE_KEYS.AUTH_RETURN_TO);
-        sessionStorage.removeItem(STORAGE_KEYS.AUTH_RETURN_TO);
-        const targetPath = returnTo ?? window.location.pathname;
-        window.history.replaceState({}, document.title, targetPath);
+        saveTokenData(getTokenStorageKey(clientId, scope), tokenData);
     } catch (authError) {
-        clearTokenData();
-        sessionStorage.removeItem(STORAGE_KEYS.AUTH_RETURN_TO);
         const message = authError instanceof Error ? authError.message : "Unknown error";
         toast.error(`Authentication failed: ${message}`);
-        throw authError;
+    } finally{
+        window.history.replaceState({}, document.title, returnTo);
     }
 };
-const ensureValidToken = async (queryClient, clientId, baseUrl, redirectPath)=>{
-    const params = new URLSearchParams(window.location.search);
-    const isInOAuthCallback = params.has("code") && params.has("state");
-    if (isInOAuthCallback) try {
-        await handleOAuthCallback(clientId, baseUrl, redirectPath);
-    } catch  {
-        queryClient.resetQueries({
-            queryKey: TOKEN_QUERY_KEY
-        });
-    }
-    const tokenDataStr = localStorage.getItem(STORAGE_KEYS.TOKEN);
+const ensureValidToken = async (clientId, scope, baseUrl, redirectPath)=>{
+    await handleOAuthCallback(clientId, scope, baseUrl, redirectPath);
+    const storageKey = getTokenStorageKey(clientId, scope);
+    const tokenDataStr = localStorage.getItem(storageKey);
     if (!tokenDataStr) return null;
     let parsed;
     try {
         parsed = JSON.parse(tokenDataStr);
     } catch  {
-        clearTokenData();
+        clearTokenData(storageKey);
         return null;
     }
     const { data: tokenData, success } = TokenDataSchema.safeParse(parsed);
     if (!success) {
-        clearTokenData();
+        clearTokenData(storageKey);
         return null;
     }
-    if (isTokenExpired(tokenData) || shouldRefreshToken(tokenData)) return refreshTokenIfNeeded(tokenData, clientId, baseUrl);
+    if (isTokenExpired(tokenData) || shouldRefreshToken(tokenData)) return refreshTokenIfNeeded(tokenData, clientId, baseUrl, storageKey);
     return tokenData.access_token;
 };
 const login = async (clientId, scope, baseUrl, redirectPath)=>{
@@ -169,6 +186,7 @@ const login = async (clientId, scope, baseUrl, redirectPath)=>{
     const state = generateRandomString(32);
     sessionStorage.setItem(STORAGE_KEYS.CODE_VERIFIER, pkce.code_verifier);
     sessionStorage.setItem(STORAGE_KEYS.STATE, state);
+    sessionStorage.setItem(STORAGE_KEYS.REQUESTED_SCOPE, scope);
     if (redirectPath && window.location.pathname !== redirectPath) sessionStorage.setItem(STORAGE_KEYS.AUTH_RETURN_TO, window.location.pathname);
     const params = new URLSearchParams({
         client_id: clientId,
@@ -181,13 +199,28 @@ const login = async (clientId, scope, baseUrl, redirectPath)=>{
     });
     window.location.href = `${getAuthorizationEndpoint(baseUrl)}?${params.toString()}`;
 };
-const logout = (queryClient)=>{
-    clearTokenData();
-    sessionStorage.removeItem(STORAGE_KEYS.CODE_VERIFIER);
-    sessionStorage.removeItem(STORAGE_KEYS.STATE);
-    sessionStorage.removeItem(STORAGE_KEYS.AUTH_RETURN_TO);
+const isUnscopedSessionOf = (clientId)=>{
+    const tokenData = readTokenData(STORAGE_KEYS.TOKEN);
+    if (null === tokenData) return true;
+    try {
+        const { aud } = jwtDecode(tokenData.id_token);
+        return Array.isArray(aud) ? aud.includes(clientId) : aud === clientId;
+    } catch  {
+        return true;
+    }
+};
+const logout = (queryClient, clientId)=>{
+    const clientPrefix = `${STORAGE_KEYS.TOKEN}:${clientId}:`;
+    const sessionKeys = Array.from({
+        length: localStorage.length
+    }, (_, index)=>localStorage.key(index)).filter((key)=>key === STORAGE_KEYS.TOKEN ? isUnscopedSessionOf(clientId) : key?.startsWith(clientPrefix) === true);
+    for (const key of sessionKeys)clearTokenData(key);
+    clearPendingLogin();
     queryClient.resetQueries({
-        queryKey: TOKEN_QUERY_KEY
+        queryKey: [
+            ...TOKEN_QUERY_KEY,
+            clientId
+        ]
     });
 };
-export { STORAGE_KEYS, TOKEN_QUERY_KEY, ensureValidToken, login, logout, resolveReturnPath, toCodedAppFilePath };
+export { STORAGE_KEYS, TOKEN_QUERY_KEY, ensureValidToken, getStoredIdToken, getTokenQueryKey, login, logout, resolveReturnPath, toCodedAppFilePath };

package/dist/registry/card/card.d.ts

@@ -7,8 +7,10 @@ declare const cardVariants: (props?: ({
 interface CardProps extends React.ComponentProps<"div">, VariantProps<typeof cardVariants> {
     selectable?: "standard" | "ai";
     selected?: boolean;
+    /** Classes for the outermost element, e.g. `col-span-*`. When `selectable` is set, `className` and all other props go to the inner button. */
+    wrapperClassName?: string;
 }
-declare function Card({ className, variant, selectable, selected, children, ...props }: CardProps): import("react/jsx-runtime").JSX.Element;
+declare function Card({ className, wrapperClassName, variant, selectable, selected, children, ...props }: CardProps): import("react/jsx-runtime").JSX.Element;
 declare function CardHeader({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
 declare function CardTitle({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
 declare function CardDescription({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;

package/dist/registry/card/card.js

@@ -24,11 +24,11 @@ const cardVariants = cva("flex flex-col gap-6 py-6 text-card-foreground", {
         variant: "default"
     }
 });
-function Card({ className, variant, selectable, selected = false, children, ...props }) {
+function Card({ className, wrapperClassName, variant, selectable, selected = false, children, ...props }) {
     if (selectable) {
         const isAi = "ai" === selectable;
         return /*#__PURE__*/ jsxs("div", {
-            className: "relative group/card h-full",
+            className: cn("relative group/card h-full", wrapperClassName),
             "data-slot": "card",
             "data-variant": variant,
             "data-selectable": selectable,
@@ -58,9 +58,8 @@ function Card({ className, variant, selectable, selected = false, children, ...p
         "data-slot": "card",
         "data-variant": variant,
         className: cn(cardVariants({
-            variant,
-            className
-        })),
+            variant
+        }), className, wrapperClassName),
         ...props,
         children: children
     });

package/dist/registry/charts-core/charts-core.d.ts

@@ -15,8 +15,8 @@ export { type LineChartConfiguration, LineChartConfigurationSchema, } from "./mo
 export { type MultiLineChartConfiguration, MultiLineChartConfigurationSchema, } from "./models/configurations/multi-line-chart-configuration";
 export { type TableChartConfiguration, TableChartConfigurationSchema, } from "./models/configurations/table-chart-configuration";
 export type { DataModelAggregate, AggregationKind, MetricExpression, } from "./models/expression";
-export type { ListFilter } from "./models/filter";
-export type { FilterValues } from "./models/filter-values";
+export type { ListFilter, PeriodFilter } from "./models/filter";
+export type { BooleanListFilterValues, FilterValues, ListFilterValues, NumberListFilterValues, NumberRangeFilterValues, PeriodFilterValues, StringListFilterValues, StringSearchFilterValues, } from "./models/filter-values";
 export { type FromConfig, FromConfigSchema, type JoinConfig, JoinConfigSchema, } from "./models/join-schema";
 export type { PrimitiveValue } from "./models/primitive-value";
 export { SpinnerWithChildren } from "./spinner-with-children";

package/dist/registry/data-table/data-table.d.ts

@@ -45,4 +45,5 @@ interface DataTableProps<TData, TValue> {
 declare function DataTable<TData, TValue>({ columns, data, className, isLoading, onRowClick, sorting, onSortingChange, columnFilters, onColumnFiltersChange, columnVisibility, onColumnVisibilityChange, columnOrder, onColumnOrderChange, rowSelection, onRowSelectionChange, globalFilter, onGlobalFilterChange, pagination, onPaginationChange, getRowId, globalFilterFn, enableSearch, enableViewOptions, enableColumnResizing, toolbarContent, noResultsMessage, stickyHeader, expanded, onExpandedChange, renderExpandedRow, getRowClassName, skeletonColumnWidths, plain, }: DataTableProps<TData, TValue>): import("react/jsx-runtime").JSX.Element;
 export { DataTable };
 export type { DataTableProps };
+/** @public */
 export { DataTableColumnHeader } from "./data-table-column-header";

package/dist/registry/shell/shell-auth-provider.d.ts

@@ -18,8 +18,9 @@ interface UseAccessTokenProps {
     clientId: string;
     baseUrl: string;
     redirectPath?: string;
+    scope: string;
 }
-export declare const useAccessToken: ({ clientId, baseUrl, redirectPath, }: UseAccessTokenProps) => {
+export declare const useAccessToken: ({ clientId, baseUrl, redirectPath, scope, }: UseAccessTokenProps) => {
     accessToken: string | null;
     isLoading: boolean;
 };

package/dist/registry/shell/shell-auth-provider.js

@@ -4,7 +4,7 @@ import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { jwtDecode } from "jwt-decode";
 import { createContext, useContext } from "react";
 import { z } from "zod";
-import { TOKEN_QUERY_KEY, ensureValidToken, login, logout } from "../../lib/auth.js";
+import { ensureValidToken, getTokenQueryKey, login, logout } from "../../lib/auth.js";
 const JwtPayloadSchema = z.object({
     email: z.email(),
     first_name: z.string(),
@@ -36,11 +36,10 @@ const useAuth = ()=>{
     const context = useContext(AuthContext);
     return context ?? noAuthDefaults;
 };
-const useAccessToken = ({ clientId, baseUrl, redirectPath })=>{
-    const queryClient = useQueryClient();
+const useAccessToken = ({ clientId, baseUrl, redirectPath, scope })=>{
     const { data: token, isLoading } = useQuery({
-        queryKey: TOKEN_QUERY_KEY,
-        queryFn: ()=>ensureValidToken(queryClient, clientId, baseUrl, redirectPath),
+        queryKey: getTokenQueryKey(clientId, scope),
+        queryFn: ()=>ensureValidToken(clientId, scope, baseUrl, redirectPath),
         refetchInterval: 60000,
         enabled: "u" > typeof window
     });
@@ -54,7 +53,8 @@ const ShellAuthProvider = ({ children, clientId, scope, baseUrl, redirectPath })
     const { accessToken, isLoading } = useAccessToken({
         clientId,
         baseUrl,
-        redirectPath
+        redirectPath,
+        scope
     });
     const user = accessToken ? decodeJWT(accessToken) : null;
     const isAuthenticated = null != accessToken;
@@ -63,7 +63,7 @@ const ShellAuthProvider = ({ children, clientId, scope, baseUrl, redirectPath })
         isAuthenticated,
         isLoading,
         login: ()=>login(clientId, scope, baseUrl, redirectPath),
-        logout: ()=>logout(queryClient),
+        logout: ()=>logout(queryClient, clientId),
         accessToken
     };
     return /*#__PURE__*/ jsx(AuthContext.Provider, {

package/dist/registry/solution-tests/hooks.d.ts

@@ -26,4 +26,3 @@ export { useRunResults, useAdoptJob, useUpdateBaseline, useResultAttachment, } f
 export type { UseRunResultsResult } from "./use-run-results";
 export { useForceStopBatch, useForceStopRun } from "./use-force-stop";
 export type { MutationHook, AttachmentFetcher } from "./mutations";
-export type { ResultAttachmentField } from "./types";

package/dist/registry/stepper/index.d.ts

@@ -1,7 +1 @@
-export { Stepper, type StepperProps, stepperVariants } from "./stepper";
-export { StepperContent, StepperDescription, StepperTitle, } from "./stepper-content";
-export type { StepperItemState, StepperOrientation, } from "./stepper-context";
-export { StepperIndicator } from "./stepper-indicator";
-export { StepperItem, type StepperItemProps, stepperItemVariants, } from "./stepper-item";
-export { StepperSeparator } from "./stepper-separator";
-export { StepperTrigger } from "./stepper-trigger";
+export { Stepper, StepperContent, StepperDescription, StepperIndicator, StepperItem, type StepperItemProps, type StepperItemState, type StepperOrientation, type StepperProps, StepperSeparator, StepperTitle, StepperTrigger, stepperItemVariants, stepperVariants, } from "./stepper";

package/dist/registry/stepper/index.js

@@ -1,7 +1,2 @@
-import { Stepper, stepperVariants } from "./stepper.js";
-import { StepperContent, StepperDescription, StepperTitle } from "./stepper-content.js";
-import { StepperIndicator } from "./stepper-indicator.js";
-import { StepperItem, stepperItemVariants } from "./stepper-item.js";
-import { StepperSeparator } from "./stepper-separator.js";
-import { StepperTrigger } from "./stepper-trigger.js";
+import { Stepper, StepperContent, StepperDescription, StepperIndicator, StepperItem, StepperSeparator, StepperTitle, StepperTrigger, stepperItemVariants, stepperVariants } from "./stepper.js";
 export { Stepper, StepperContent, StepperDescription, StepperIndicator, StepperItem, StepperSeparator, StepperTitle, StepperTrigger, stepperItemVariants, stepperVariants };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/apollo-vertex",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "description": "UiPath Apollo Vertex design system components",
   "license": "MIT",
   "keywords": [
@@ -120,16 +120,20 @@
     "@tanstack/intent": "0.4.0",
     "@tanstack/react-query": "^5.104.0",
     "@tanstack/react-router": "^1.170.40",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.0",
     "@ts-rest/core": "^3.53.0-rc.1",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.6",
     "@types/react-dom": "^19.2.2",
     "@uipath/uipath-typescript": "^1.8.0",
+    "@vitest/coverage-v8": "^4.1.5",
     "dependency-cruiser": "^17.3.6",
     "eslint-plugin-react": "^7.37.5",
     "eventsource-parser": "^3.0.6",
     "highlight.js": "^11.11.1",
     "i18next": "^26.4.2",
+    "jsdom": "^27.2.0",
     "jwt-decode": "^4.0.0",
     "oxlint": "^1.38.0",
     "oxlint-tsgolint": "^0.18.1",
@@ -142,7 +146,9 @@
     "recharts": "2.15.4",
     "remark-breaks": "^4.0.0",
     "remark-gfm": "^4.0.1",
-    "tailwindcss": "^4.1.17"
+    "tailwindcss": "^4.1.17",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
   },
   "publishConfig": {
     "access": "public"
@@ -164,6 +170,8 @@
     "lint:fix": "oxlint --fix --type-aware",
     "lint:deps": "depcruise registry --config .dependency-cruiser.cjs",
     "typecheck": "tsc --noEmit",
-    "lint:skills": "intent validate skills"
+    "lint:skills": "intent validate skills",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
   }
 }