🧺 perf: Batch Prompt Group Permission Checks in the Sidebar (#16710)

* perf: Batch Prompt Group Permissions in the Sidebar

* perf: Skip the Prompt Permission Batch When the List Is Empty

Add scenario coverage for batched prompt row permissions.

* test: Retry Opening Prompt Row Menus Until Their Items Render
This commit is contained in:
Marco Beretta 2026-10-03 23:27:01 +02:00 • committed by GitHub
parent 46d73974b8
commit fc89ba168e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 231 additions and 7 deletions

View file

@ -1,7 +1,8 @@
import { useState, memo, useRef, useCallback, useId, useMemo } from 'react';
import * as Ariakit from '@ariakit/react';
import { PermissionBits } from 'librechat-data-provider';
import { useNavigate, useParams } from 'react-router-dom';
import { PermissionBits, ResourceType } from 'librechat-data-provider';
import { hasPermissions } from 'librechat-data-provider/react-query';
import { Ellipsis, Eye, SquarePen, Trash, EarthIcon, User } from 'lucide-react';
import {
Label,
@ -14,9 +15,9 @@ import {
useToastContext,
} from '@librechat/client';
import type { TPromptGroup } from 'librechat-data-provider';
import { useLocalize, useAuthContext, useSubmitMessage, useResourcePermissions } from '~/hooks';
import { detectVariables, cn, rowActionClasses, rowActionSlotClasses } from '~/utils';
import { useRecordPromptUsage, useDeletePromptGroup } from '~/data-provider';
import { useLocalize, useAuthContext, useSubmitMessage } from '~/hooks';
import VariableDialog from '../dialogs/VariableDialog';
import PreviewPrompt from '../dialogs/PreviewPrompt';
import CategoryIcon from '../utils/CategoryIcon';
@ -27,9 +28,11 @@ const PROMPT_PATH = '/prompts';
function ChatGroupItem({
group,
isChatRoute = true,
permissionBits = 0,
}: {
group: TPromptGroup;
isChatRoute?: boolean;
permissionBits?: number;
}) {
const localize = useLocalize();
const navigate = useNavigate();
@ -49,9 +52,8 @@ function ChatGroupItem({
const groupIsGlobal = group.isPublic === true;
const { hasPermission } = useResourcePermissions(ResourceType.PROMPTGROUP, group._id || '');
const canEdit = hasPermission(PermissionBits.EDIT);
const canDelete = hasPermission(PermissionBits.DELETE);
const canEdit = hasPermissions(permissionBits, PermissionBits.EDIT);
const canDelete = hasPermissions(permissionBits, PermissionBits.DELETE);
const menuButtonRef = useRef<HTMLButtonElement | null>(null);

View file

@ -1,5 +1,7 @@
import { FileText } from 'lucide-react';
import { EmptyState } from '@librechat/client';
import { ResourceType } from 'librechat-data-provider';
import { useGetAllEffectivePermissionsQuery } from 'librechat-data-provider/react-query';
import type { TPromptGroup } from 'librechat-data-provider';
import ChatGroupItem from './ChatGroupItem';
import { useLocalize } from '~/hooks';
@ -12,6 +14,9 @@ export default function List({
isChatRoute?: boolean;
}) {
const localize = useLocalize();
const { data: permissionsMap } = useGetAllEffectivePermissionsQuery(ResourceType.PROMPTGROUP, {
enabled: groups.length > 0,
});
const renderContent = () => {
if (groups.length === 0) {
@ -26,7 +31,12 @@ export default function List({
}
return groups.map((group) => (
<ChatGroupItem key={group._id} group={group} isChatRoute={isChatRoute} />
<ChatGroupItem
key={group._id}
group={group}
isChatRoute={isChatRoute}
permissionBits={group._id ? permissionsMap?.[group._id] : 0}
/>
));
};

View file

@ -1,6 +1,6 @@
import { useRecoilValue } from 'recoil';
import { useMutation, useQueryClient } from '@tanstack/react-query';
import { dataService, QueryKeys } from 'librechat-data-provider';
import { dataService, QueryKeys, ResourceType } from 'librechat-data-provider';
import type { UseMutationResult } from '@tanstack/react-query';
import type t from 'librechat-data-provider';
import {
@ -126,6 +126,12 @@ export const useCreatePrompt = (
);
addGroupToAll(queryClient, group);
/** The sidebar reads row permissions from the batch map, which lacks the new group */
queryClient.invalidateQueries([
QueryKeys.effectivePermissions,
'all',
ResourceType.PROMPTGROUP,
]);
}
if (onSuccess) {

View file

@ -0,0 +1,202 @@
import { randomUUID } from 'crypto';
import { expect, test } from '@playwright/test';
import type { Page, Request } from '@playwright/test';
import { getAccessToken, requestJson } from '../helpers';
import { openPanel } from './panels';
/**
* The prompts sidebar reads each row's Edit and Delete actions from one batch
* permissions request instead of one request per row. These pin what a user
* sees in the row menu and how many permission requests the panel issues.
*/
const BATCH_PATH = '/api/permissions/promptGroup/effective/all';
const PER_ROW_PATH = /^\/api\/permissions\/promptGroup\/[^/]+\/effective$/;
type CreatedGroup = { group?: { _id: string; name: string } };
const uniqueName = (label: string) => `Row perms ${label} ${randomUUID().slice(0, 8)}`;
async function createGroup(page: Page, name: string): Promise<string> {
const token = await getAccessToken(page);
const body = await requestJson<CreatedGroup>(page, {
path: '/api/prompts',
token,
method: 'POST',
body: { prompt: { prompt: `Text for ${name}`, type: 'text' }, group: { name } },
});
const id = body.group?._id ?? '';
expect(id).not.toBe('');
return id;
}
async function deleteGroups(page: Page, ids: string[]) {
const token = await getAccessToken(page);
for (const id of ids) {
await requestJson<{ message?: string }>(page, {
path: `/api/prompts/groups/${encodeURIComponent(id)}`,
token,
method: 'DELETE',
});
}
}
/** Collect the prompt-group permission requests the page issues from now on. */
function trackPermissionRequests(page: Page) {
const batch: Request[] = [];
const perRow: Request[] = [];
page.on('request', (request) => {
const path = new URL(request.url()).pathname;
if (path === BATCH_PATH) {
batch.push(request);
} else if (PER_ROW_PATH.test(path)) {
perRow.push(request);
}
});
return { batch, perRow };
}
/** Open a row's menu and return the names of the actions it offers. */
async function rowActions(page: Page, name: string): Promise<string[]> {
const row = page
.locator('#prompts-panel')
.getByRole('button', { name: new RegExp(`^${name} prompt`) })
.locator('..');
await expect(row).toBeVisible({ timeout: 20000 });
const menu = page.getByRole('menu');
/** Preview is always offered, so it marks a menu whose items have rendered. A click
* that lands while the previous row's menu is still closing opens nothing. */
await expect(async () => {
if (!(await menu.isVisible())) {
await row.hover();
await row.getByRole('button', { name: 'Conversation Menu Options' }).click();
}
await expect(menu.getByRole('menuitem', { name: 'Preview' })).toBeVisible({ timeout: 2000 });
}).toPass({ timeout: 15000 });
const items = await menu.getByRole('menuitem').allInnerTexts();
await page.keyboard.press('Escape');
await expect(menu).toBeHidden();
return items.map((item) => item.trim());
}
async function filterPanel(page: Page, name: string) {
const search = page.locator('#prompts-panel').getByRole('search').getByRole('textbox');
await search.fill(name);
}
test.describe('prompt row permissions', () => {
test('owned prompt rows offer Edit and Delete from one batch request @scenario:owned-prompt-rows-offer-edit-delete-from-one-request', async ({
page,
}) => {
await page.goto('/c/new', { timeout: 10000 });
const prefix = uniqueName('owned');
const names = [`${prefix} A`, `${prefix} B`];
const ids: string[] = [];
try {
for (const name of names) {
ids.push(await createGroup(page, name));
}
await page.goto('/c/new', { timeout: 10000 });
const tracked = trackPermissionRequests(page);
await openPanel(page, 'prompts', 'Prompts');
await filterPanel(page, prefix);
for (const name of names) {
expect(await rowActions(page, name)).toEqual(['Preview', 'Edit', 'Delete']);
}
expect(tracked.batch.length).toBeGreaterThanOrEqual(1);
expect(tracked.perRow).toHaveLength(0);
} finally {
await deleteGroups(page, ids);
}
});
test('a view-only prompt row offers Preview only @scenario:view-only-prompt-row-hides-edit-delete', async ({
page,
}) => {
await page.goto('/c/new', { timeout: 10000 });
const name = uniqueName('viewer');
const ids: string[] = [];
try {
const id = await createGroup(page, name);
ids.push(id);
/** A group shared with VIEW only: the batch answers bit 1 for this row */
await page.route(`**${BATCH_PATH}`, async (route) => {
const response = await route.fetch();
const map = (await response.json()) as Record<string, number>;
await route.fulfill({ response, json: { ...map, [id]: 1 } });
});
await page.goto('/c/new', { timeout: 10000 });
await openPanel(page, 'prompts', 'Prompts');
await filterPanel(page, name);
expect(await rowActions(page, name)).toEqual(['Preview']);
} finally {
await page.unroute(`**${BATCH_PATH}`);
await deleteGroups(page, ids);
}
});
test('a prompt created in the session offers Edit and Delete in the sidebar @scenario:new-prompt-row-offers-edit-delete', async ({
page,
}) => {
const name = uniqueName('created');
const ids: string[] = [];
try {
await page.goto('/c/new', { timeout: 10000 });
await openPanel(page, 'prompts', 'Prompts');
await expect(page.locator('#prompts-panel')).toBeVisible({ timeout: 20000 });
await page.getByRole('button', { name: 'Create Prompt' }).click();
const dialog = page.getByRole('dialog');
await expect(dialog).toBeVisible();
await dialog.getByRole('textbox', { name: 'Prompt Name' }).fill(name);
await dialog.getByRole('textbox', { name: 'Prompt text input field' }).fill('Say hello.');
const [created] = await Promise.all([
page.waitForResponse(
(response) =>
response.request().method() === 'POST' &&
new URL(response.url()).pathname === '/api/prompts' &&
response.ok(),
{ timeout: 30000 },
),
dialog.getByRole('button', { name: 'Create Prompt' }).click(),
]);
const body = (await created.json()) as CreatedGroup;
ids.push(body.group?._id ?? '');
await expect(page).toHaveURL(/\/prompts\//);
/** Same session, no reload: the batch map must already include the new group */
await page.goBack();
await openPanel(page, 'prompts', 'Prompts');
await filterPanel(page, name);
await expect(async () => {
expect(await rowActions(page, name)).toEqual(['Preview', 'Edit', 'Delete']);
}).toPass({ timeout: 30000 });
} finally {
await deleteGroups(page, ids.filter(Boolean));
}
});
test('an empty prompts list issues no permission request @scenario:empty-prompt-list-skips-permission-request', async ({
page,
}) => {
await page.route('**/api/prompts/groups?**', (route) =>
route.fulfill({
json: { promptGroups: [], pageNumber: '1', pageSize: '10', pages: 0, has_more: false },
}),
);
const tracked = trackPermissionRequests(page);
await page.goto('/c/new', { timeout: 10000 });
await openPanel(page, 'prompts', 'Prompts');
await expect(page.getByText('No prompts yet', { exact: true }).first()).toBeVisible({
timeout: 20000,
});
expect(tracked.batch).toHaveLength(0);
expect(tracked.perRow).toHaveLength(0);
});
});

View file

@ -475,6 +475,10 @@ export const useUpdateResourcePermissionsMutation = (): UseMutationResult<
queryClient.invalidateQueries({
queryKey: [QueryKeys.effectivePermissions, variables.resourceType, variables.resourceId],
});
queryClient.invalidateQueries({
queryKey: [QueryKeys.effectivePermissions, 'all', variables.resourceType],
});
},
});
};