Files
shumai/packages/api/src/versionStack.test.ts
T
Yiling-J b3cae4f2b0 feat: move MCP to /mcp and add teammate operations (#500)
* feat(operations): move MCP to /mcp and add search, comment, metadata, version, and upload operations

- Serve the MCP server at /mcp instead of /api/mcp
- Add search_assets, copy_assets, get_folder_instructions, list_comments,
  create_comment, resolve_comment, list_metadata_fields,
  update_asset_metadata, create_version_stack, list_versions, and
  remove_version on the agent, MCP, and CLI
- Add create_file and create_version (agent, MCP) with Creation Context
  metadata, and complete_upload (MCP) for presigned two-step uploads
- Replace the native agent create_file/create_version tools with
  Operation-backed ones
- Route the comment-complete, metadata, copy, version stack, and
  AGENTS.md read REST endpoints through their Operations

* docs(readme): add built-in MCP server and CLI to features list
2026-10-27 14:37:26 +08:00

177 lines
5.8 KiB
TypeScript

import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest'
import { Hono } from 'hono'
import versionStackRoute from './versionStack'
import { authMiddleware } from './middleware/auth'
import { versionStackService } from '@shumai/core/src/versionStack/versionStack'
import { assetService } from '@shumai/core/src/asset/asset'
import { authzService, ResourceType, Permission } from '@shumai/core/src/authz/authz'
import { createVersionStackOp, removeVersionOp, runOperation } from '@shumai/core/src/operations'
vi.mock('@shumai/core/src/operations', async (importOriginal) => ({
...(await importOriginal<typeof import('@shumai/core/src/operations')>()),
runOperation: vi.fn(),
}))
vi.mock('@shumai/core/src/authz/authz', () => ({
authzService: {
hasPermission: vi.fn().mockResolvedValue(undefined),
},
Permission: {
Read: 'Read',
Edit: 'Edit',
Admin: 'Admin',
},
ResourceType: {
Project: 'project',
Asset: 'asset',
},
}))
vi.mock('./middleware/auth', () => ({
// eslint-disable-next-line @typescript-eslint/no-explicit-any
authMiddleware: async (c: any, next: any) => {
c.set('user', { id: 'user1', name: 'Test User' })
await next()
},
}))
describe('versionStack api', () => {
let mockCreateVersionStack: any // eslint-disable-line @typescript-eslint/no-explicit-any
let mockChangeStackFileVersion: any // eslint-disable-line @typescript-eslint/no-explicit-any
let mockRemoveVersionFromStack: any // eslint-disable-line @typescript-eslint/no-explicit-any
let mockGetAsset: any // eslint-disable-line @typescript-eslint/no-explicit-any
let mockGetStackVersions: any // eslint-disable-line @typescript-eslint/no-explicit-any
beforeEach(() => {
mockCreateVersionStack = vi.spyOn(versionStackService, 'createVersionStack')
mockChangeStackFileVersion = vi.spyOn(versionStackService, 'changeStackFileVersion')
mockRemoveVersionFromStack = vi.spyOn(versionStackService, 'removeVersionFromStack')
mockGetAsset = vi.spyOn(assetService, 'getAsset')
mockGetStackVersions = vi.spyOn(assetService, 'getStackVersions')
vi.mocked(authzService.hasPermission).mockResolvedValue(undefined)
})
afterEach(() => {
vi.clearAllMocks()
})
describe('POST /projects/:projectID/version_stacks', () => {
it('runs create_version_stack and returns the stack asset info', async () => {
const mockAssetInfo = { id: 'stack1', type: 'version_stack', name: 'v1' }
vi.mocked(runOperation).mockResolvedValue({
id: 'stack1',
name: 'v1',
type: 'version_stack',
size: 0,
projectId: 'p1',
})
mockGetAsset.mockResolvedValue(mockAssetInfo)
const app = new Hono().use('*', authMiddleware).route('/', versionStackRoute)
const res = await app.request('/projects/p1/version_stacks', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ fileIds: ['f1', 'f2'] }),
})
expect(res.status).toBe(200)
const data = await res.json()
expect(data).toEqual(mockAssetInfo)
expect(runOperation).toHaveBeenCalledWith(
createVersionStackOp,
{ userId: 'user1', via: 'api' },
{ fileIds: ['f1', 'f2'] },
)
expect(mockCreateVersionStack).not.toHaveBeenCalled()
expect(mockGetAsset).toHaveBeenCalledWith({ assetId: 'stack1' })
})
})
describe('POST /version_stacks/:stackID/order', () => {
it('should change order and return 200', async () => {
mockChangeStackFileVersion.mockResolvedValue()
const app = new Hono().use('*', authMiddleware).route('/', versionStackRoute)
const res = await app.request('/version_stacks/stack1/order', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ fileId: 'f1', beforeId: 'f2' }),
})
expect(res.status).toBe(200)
expect(authzService.hasPermission).toHaveBeenCalledWith(
expect.objectContaining({
type: ResourceType.Asset,
id: 'stack1',
permission: Permission.Edit,
}),
)
expect(mockChangeStackFileVersion).toHaveBeenCalledWith({
stackId: 'stack1',
fileId: 'f1',
beforeId: 'f2',
})
})
})
describe('GET /version_stacks/:stackID/versions', () => {
it('should return stack versions', async () => {
const mockVersions = [
{
id: 'v1',
version: 1,
name: 'version1.png',
previewUrl: 'http://preview1',
creator: { id: 'u1', name: 'User 1' },
},
]
mockGetStackVersions.mockResolvedValue(mockVersions)
const app = new Hono().use('*', authMiddleware).route('/', versionStackRoute)
const res = await app.request('/version_stacks/stack1/versions', {
method: 'GET',
})
expect(res.status).toBe(200)
const data = await res.json()
expect(data).toEqual(mockVersions)
expect(authzService.hasPermission).toHaveBeenCalledWith(
expect.objectContaining({
type: ResourceType.Asset,
id: 'stack1',
permission: Permission.Read,
}),
)
expect(mockGetStackVersions).toHaveBeenCalledWith('stack1')
})
})
describe('DELETE /version_stacks/:stackId/versions/:versionId', () => {
it('runs remove_version and returns 200', async () => {
vi.mocked(runOperation).mockResolvedValue({ versionId: 'v1', stackId: 'stack1' })
const app = new Hono().use('*', authMiddleware).route('/', versionStackRoute)
const res = await app.request('/version_stacks/stack1/versions/v1', {
method: 'DELETE',
})
expect(res.status).toBe(200)
expect(runOperation).toHaveBeenCalledWith(
removeVersionOp,
{ userId: 'user1', via: 'api' },
{ versionId: 'v1' },
)
expect(mockRemoveVersionFromStack).not.toHaveBeenCalled()
})
})
})