dify/web/app/(commonLayout)/datasets/layout.spec.tsx

import type { ReactNode } from 'react'
import { screen, waitFor } from '@testing-library/react'
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { render } from '@/test/console/render'
import DatasetsLayout from './layout'

const mockReplace = vi.fn()
const mockConsoleStateReader = vi.fn()
let mockPathname = '/datasets'
let mockExternalKnowledgeApiProviderEnabled: boolean | undefined

vi.mock('@/next/navigation', () => ({
  useRouter: () => ({
    replace: mockReplace,
  }),
  usePathname: () => mockPathname,
}))

vi.mock('@/context/workspace-state', async () => {
  const { createWorkspaceStateModuleMock } = await import('@/test/console/state-fixture')

  return createWorkspaceStateModuleMock(() => mockConsoleStateReader())
})
vi.mock('@/context/permission-state', async () => {
  const { createPermissionStateModuleMock } = await import('@/test/console/state-fixture')

  return createPermissionStateModuleMock(() => mockConsoleStateReader())
})

vi.mock('@/context/external-api-panel-context', () => ({
  ExternalApiPanelProvider: ({ children }: { children: ReactNode }) => <>{children}</>,
}))

vi.mock('@/context/external-knowledge-api-context', () => ({
  ExternalKnowledgeApiProvider: ({
    children,
    enabled,
  }: {
    children: ReactNode
    enabled?: boolean
  }) => {
    mockExternalKnowledgeApiProviderEnabled = enabled
    return <>{children}</>
  },
}))

type ConsoleStateFixture = {
  isCurrentWorkspaceEditor: boolean
  isCurrentWorkspaceDatasetOperator: boolean
  isLoadingCurrentWorkspace: boolean
  isLoadingWorkspacePermissionKeys: boolean
  workspacePermissionKeys: string[]
  currentWorkspace: {
    id: string
  }
}

const baseContext: ConsoleStateFixture = {
  isCurrentWorkspaceEditor: true,
  isCurrentWorkspaceDatasetOperator: false,
  isLoadingCurrentWorkspace: false,
  isLoadingWorkspacePermissionKeys: false,
  workspacePermissionKeys: [],
  currentWorkspace: {
    id: 'workspace-1',
  },
}

const setConsoleState = (overrides: Partial<ConsoleStateFixture> = {}) => {
  mockConsoleStateReader.mockReturnValue({
    ...baseContext,
    ...overrides,
  })
}

describe('DatasetsLayout', () => {
  beforeEach(() => {
    vi.clearAllMocks()
    mockPathname = '/datasets'
    mockExternalKnowledgeApiProviderEnabled = undefined
    setConsoleState()
  })

  it('should render loading when workspace is still loading', () => {
    setConsoleState({
      isLoadingCurrentWorkspace: true,
      currentWorkspace: { id: '' },
    })

    render(
      <DatasetsLayout>
        <div>datasets</div>
      </DatasetsLayout>,
    )

    expect(screen.getByRole('status')).toBeInTheDocument()
    expect(screen.queryByText('datasets')).not.toBeInTheDocument()
    expect(mockReplace).not.toHaveBeenCalled()
  })

  it('should render loading while workspace permission keys are loading', () => {
    setConsoleState({
      isLoadingWorkspacePermissionKeys: true,
      workspacePermissionKeys: [],
    })

    render(
      <DatasetsLayout>
        <div>datasets</div>
      </DatasetsLayout>,
    )

    expect(screen.getByRole('status')).toBeInTheDocument()
    expect(screen.queryByText('datasets')).not.toBeInTheDocument()
    expect(mockReplace).not.toHaveBeenCalled()
  })

  it('should render children without a page-level dataset permission', () => {
    setConsoleState({
      isCurrentWorkspaceEditor: true,
      isCurrentWorkspaceDatasetOperator: true,
      workspacePermissionKeys: ['dataset.create_and_management', 'dataset.external.connect'],
    })

    render(
      <DatasetsLayout>
        <div>datasets</div>
      </DatasetsLayout>,
    )

    expect(screen.getByText('datasets')).toBeInTheDocument()
    expect(mockReplace).not.toHaveBeenCalled()
  })

  it('should render children on the dataset list route without dataset permissions', () => {
    setConsoleState({
      isCurrentWorkspaceEditor: false,
      isCurrentWorkspaceDatasetOperator: false,
      workspacePermissionKeys: [],
    })

    render(
      <DatasetsLayout>
        <div>datasets</div>
      </DatasetsLayout>,
    )

    expect(screen.getByText('datasets')).toBeInTheDocument()
    expect(mockReplace).not.toHaveBeenCalled()
  })

  it.each(['/datasets/create', '/datasets/create-from-pipeline', '/datasets/new/create'])(
    'should redirect direct dataset creation route to /datasets without dataset.create_and_management: %s',
    async (pathname) => {
      mockPathname = pathname
      setConsoleState({
        workspacePermissionKeys: [],
      })

      render(
        <DatasetsLayout>
          <div>datasets</div>
        </DatasetsLayout>,
      )

      expect(screen.queryByText('datasets')).not.toBeInTheDocument()
      await waitFor(() => {
        expect(mockReplace).toHaveBeenCalledWith('/datasets')
      })
    },
  )

  it('should render direct dataset creation route when workspace has dataset.create_and_management', () => {
    mockPathname = '/datasets/create'
    setConsoleState({
      workspacePermissionKeys: ['dataset.create_and_management'],
    })

    render(
      <DatasetsLayout>
        <div>datasets</div>
      </DatasetsLayout>,
    )

    expect(screen.getByText('datasets')).toBeInTheDocument()
    expect(mockReplace).not.toHaveBeenCalled()
  })

  it('should render direct new knowledge creation route when workspace has dataset.create_and_management', () => {
    mockPathname = '/datasets/new/create'
    setConsoleState({
      workspacePermissionKeys: ['dataset.create_and_management'],
    })

    render(
      <DatasetsLayout>
        <div>datasets</div>
      </DatasetsLayout>,
    )

    expect(screen.getByText('datasets')).toBeInTheDocument()
    expect(mockReplace).not.toHaveBeenCalled()
  })

  it.each(['/datasets/connect', '/datasets/new/space-1/sources/new'])(
    'should redirect direct external source route to /datasets without dataset.external.connect: %s',
    async (pathname) => {
      mockPathname = pathname
      setConsoleState({
        workspacePermissionKeys: [],
      })

      render(
        <DatasetsLayout>
          <div>datasets</div>
        </DatasetsLayout>,
      )

      expect(screen.queryByText('datasets')).not.toBeInTheDocument()
      await waitFor(() => {
        expect(mockReplace).toHaveBeenCalledWith('/datasets')
      })
    },
  )

  it.each(['/datasets/connect', '/datasets/new/space-1/sources/new'])(
    'should render direct external source route with dataset.external.connect: %s',
    (pathname) => {
      mockPathname = pathname
      setConsoleState({
        workspacePermissionKeys: ['dataset.external.connect'],
      })

      render(
        <DatasetsLayout>
          <div>datasets</div>
        </DatasetsLayout>,
      )

      expect(screen.getByText('datasets')).toBeInTheDocument()
      expect(mockReplace).not.toHaveBeenCalled()
    },
  )

  it('should disable external knowledge API queries without dataset.external.connect', () => {
    setConsoleState({
      workspacePermissionKeys: [],
    })

    render(
      <DatasetsLayout>
        <div>datasets</div>
      </DatasetsLayout>,
    )

    expect(mockExternalKnowledgeApiProviderEnabled).toBe(false)
  })

  it('should enable external knowledge API queries with dataset.external.connect', () => {
    setConsoleState({
      workspacePermissionKeys: ['dataset.external.connect'],
    })

    render(
      <DatasetsLayout>
        <div>datasets</div>
      </DatasetsLayout>,
    )

    expect(mockExternalKnowledgeApiProviderEnabled).toBe(true)
  })
})