freshyo/apps/admin-ui/tests/pages/user-management.test.tsx
2026-10-20 00:31:05 +05:30

325 lines
10 KiB
TypeScript

/* eslint-disable @typescript-eslint/no-explicit-any */
/**
* Catalogue section 14.3 — User management (`tests/pages/user-management.test.tsx`).
*
* Harness workaround (reported): the shared trpc mock pins `hasNextPage=false`
* and returns a throw-away `fetchNextPage`/`refetch`, so the pagination/footer
* rows cannot be observed. This file wraps the same procedure registry locally
* (no harness file is modified).
*/
import React from 'react'
import { ActivityIndicator, RefreshControl, StyleSheet } from 'react-native'
import { act, fireEvent } from '@testing-library/react-native'
import { tw } from 'common-ui'
import UserManagement from '@/app/(drawer)/dashboard/user-management/index'
import { renderWithProviders, flush } from '../helpers/test-utils'
import { resetAllMocks } from '../helpers/reset'
import { procedureQueryCalls, setProcedure } from '../mocks/trpc-client'
import { router } from '../mocks/expo-router-mock'
import { USER_1, USER_NO_NAME, USER_SUSPENDED } from '../fixtures'
jest.mock('../mocks/trpc-client', () => {
const actual = jest.requireActual('../mocks/trpc-client')
const paginationState = { fetchingNextPage: false }
const fetchNextPage = jest.fn()
const refetch = jest.fn(async () => ({ data: undefined }))
const nodeFor = (path: string) =>
path.split('.').reduce((node: any, key: string) => node[key], actual.trpc)
const wrap = (path: string): any =>
new Proxy(
{},
{
get(_target, prop) {
if (typeof prop !== 'string') return undefined
if (
!path &&
(prop === 'Provider' || prop === 'createClient' || prop === 'useUtils' || prop === 'useContext')
) {
return actual.trpc[prop]
}
if (prop === 'useInfiniteQuery' && path === 'admin.user.getAllUsers') {
return (input: any, options: any) => {
const result = nodeFor(path).useInfiniteQuery(input, options)
const pages = result.data?.pages ?? []
const lastPage = pages[pages.length - 1]
return {
...result,
refetch,
fetchNextPage,
hasNextPage: Boolean(lastPage?.nextCursor),
isFetchingNextPage: paginationState.fetchingNextPage,
}
}
}
if (prop === 'useQuery' || prop === 'useMutation' || prop === 'useInfiniteQuery') {
return nodeFor(path)[prop]
}
return wrap(path ? `${path}.${prop}` : prop)
},
}
)
return {
...actual,
trpc: wrap(''),
__paginationState: paginationState,
__fetchNextPage: fetchNextPage,
__refetch: refetch,
}
})
const trpcMock = require('../mocks/trpc-client') as any
function setUsersPages(pages: Array<{ users: any[]; nextCursor?: number }>) {
setProcedure('admin.user.getAllUsers', { data: { pages } })
}
function renderUsers() {
return renderWithProviders(<UserManagement />, { auth: 'in' })
}
describe('User management (AUM-01..18)', () => {
beforeEach(() => resetAllMocks())
it('AUM-01: shows "Loading users..." while the first page is pending', () => {
setProcedure('admin.user.getAllUsers', { mode: 'pending' })
const view = renderUsers()
expect(view.getByText('Loading users...')).toBeTruthy()
})
it('AUM-02: a failed query shows Error + Retry and Retry refetches', async () => {
setProcedure('admin.user.getAllUsers', { mode: 'error', error: new Error('boom') })
const view = renderUsers()
await flush()
expect(view.getByText('Error')).toBeTruthy()
expect(view.getByText('boom')).toBeTruthy()
fireEvent.press(view.getByText('Retry'))
expect(trpcMock.__refetch).toHaveBeenCalled()
})
it('AUM-03: an empty list shows "No users found"', async () => {
setUsersPages([{ users: [] }])
const view = renderUsers()
await flush()
expect(view.getByText('No users found')).toBeTruthy()
expect(view.queryByText('Try adjusting your search')).toBeNull()
})
it('AUM-04: a search with no results shows the adjust-search hint', async () => {
setUsersPages([{ users: [] }])
const view = renderUsers()
await flush()
fireEvent.changeText(view.getByPlaceholderText('Search by mobile number...'), '999')
await flush()
expect(view.getByText('No users found')).toBeTruthy()
expect(view.getByText('Try adjusting your search')).toBeTruthy()
})
it('AUM-05: a row shows mobile, name, registration, order count and last order', async () => {
setUsersPages([{ users: [USER_1] }])
const view = renderUsers()
await flush()
expect(view.getByText('9876543210')).toBeTruthy()
expect(view.getByText('Test User')).toBeTruthy()
expect(view.getByText(/^Registered: /)).toBeTruthy()
expect(view.getByText('3 orders')).toBeTruthy()
expect(view.getByText(/^Last: /)).toBeTruthy()
expect(view.getByText('Showing 1 users')).toBeTruthy()
})
it('AUM-06: a user without a name falls back to "Unnamed User"', async () => {
setUsersPages([{ users: [USER_NO_NAME] }])
const view = renderUsers()
await flush()
expect(view.getByText('Unnamed User')).toBeTruthy()
})
it('AUM-07: a user without a mobile falls back to "No Mobile"', async () => {
setUsersPages([{ users: [USER_NO_NAME] }])
const view = renderUsers()
await flush()
expect(view.getByText('No Mobile')).toBeTruthy()
})
it('AUM-08: a suspended user gets the Suspended badge', async () => {
setUsersPages([{ users: [{ ...USER_SUSPENDED, name: 'Blocked User' }] }])
const view = renderUsers()
await flush()
expect(view.getByText('Suspended')).toBeTruthy()
})
it('AUM-09: zero orders renders a gray "0 orders" label', async () => {
setUsersPages([{ users: [USER_SUSPENDED] }])
const view = renderUsers()
await flush()
const label = view.getByText('0 orders')
expect(StyleSheet.flatten(label.props.style).color).toBe((tw`text-gray-400` as any).color)
})
it('AUM-10: the search box feeds the query (untrimmed value, undefined when empty)', async () => {
setUsersPages([{ users: [USER_1] }])
const view = renderUsers()
await flush()
const input = view.getByPlaceholderText('Search by mobile number...')
fireEvent.changeText(input, ' 987 ')
await flush()
// Current page code uses `searchTerm || undefined` — no trim is applied.
expect(procedureQueryCalls('admin.user.getAllUsers').pop()).toEqual({
limit: 30,
search: ' 987 ',
})
fireEvent.changeText(input, '')
await flush()
expect(procedureQueryCalls('admin.user.getAllUsers').pop()).toEqual({
limit: 30,
search: undefined,
})
})
it('AUM-11: end of list calls fetchNextPage and the appended page is rendered', async () => {
setUsersPages([{ users: [USER_1, USER_SUSPENDED], nextCursor: 6 }])
const view = renderUsers()
await flush()
expect(view.getByText('9876543210')).toBeTruthy()
expect(view.queryByText('No Mobile')).toBeNull()
const list = view.UNSAFE_getAllByType(require('react-native').FlatList)[0]
await act(async () => {
list.props.onEndReached?.({ distanceFromEnd: 0 })
})
expect(trpcMock.__fetchNextPage).toHaveBeenCalled()
await act(async () => {
setUsersPages([{ users: [USER_1, USER_SUSPENDED, USER_NO_NAME], nextCursor: undefined }])
})
await flush()
expect(view.getByText('No Mobile')).toBeTruthy()
})
it('AUM-12: duplicate users across pages are deduped by id', async () => {
setUsersPages([
{ users: [USER_1, USER_SUSPENDED] },
{ users: [USER_1] },
])
const view = renderUsers()
await flush()
expect(view.getAllByText('9876543210')).toHaveLength(1)
expect(view.getByText('Showing 2 users')).toBeTruthy()
})
it('AUM-13: pull-to-refresh runs the shared refresh (MyFlatList shadows the page handler)', async () => {
setUsersPages([{ users: [USER_1] }])
const view = renderUsers()
await flush()
// MyFlatList always injects its own RefreshControl (refreshAll) after
// `{...restProps}`, so the page's refetch handler never runs — current gap.
const clearSpy = jest.spyOn(view.queryClient, 'clear')
const control = view.UNSAFE_getByType(RefreshControl)
await act(async () => {
control.props.onRefresh?.()
})
await flush()
expect(clearSpy).toHaveBeenCalled()
expect(trpcMock.__refetch).not.toHaveBeenCalled()
})
it('AUM-14: the footer spinner shows while the next page is fetching', async () => {
setUsersPages([{ users: [USER_1], nextCursor: 5 }])
trpcMock.__paginationState.fetchingNextPage = true
const view = renderUsers()
await flush()
expect(view.UNSAFE_getAllByType(ActivityIndicator).length).toBeGreaterThanOrEqual(1)
trpcMock.__paginationState.fetchingNextPage = false
})
it('AUM-15: tapping a user opens their detail route', async () => {
setUsersPages([{ users: [USER_1] }])
const view = renderUsers()
await flush()
fireEvent.press(view.getByText('9876543210'))
expect(router.push).toHaveBeenCalledWith('/(drawer)/dashboard/user-management/5')
})
it('AUM-16: a load-more failure keeps the list (no full-screen spinner after first load)', async () => {
setUsersPages([{ users: [USER_1], nextCursor: 5 }])
const view = renderUsers()
await flush()
await act(async () => {
setProcedure('admin.user.getAllUsers', { mode: 'pending' })
})
await flush()
expect(view.queryByText('Loading users...')).toBeNull()
})
it('AUM-17: a new search starts a fresh query without a cursor', async () => {
setUsersPages([{ users: [USER_1], nextCursor: 5 }])
const view = renderUsers()
await flush()
fireEvent.changeText(view.getByPlaceholderText('Search by mobile number...'), '5')
await flush()
const searches = procedureQueryCalls('admin.user.getAllUsers').filter(
(input) => input?.search === '5'
)
expect(searches).toHaveLength(1)
expect(searches[0]).toEqual({ limit: 30, search: '5' })
})
it('AUM-18: an empty search result has no Clear button (current UI)', async () => {
setUsersPages([{ users: [] }])
const view = renderUsers()
await flush()
fireEvent.changeText(view.getByPlaceholderText('Search by mobile number...'), 'zzz')
await flush()
expect(view.getByText('No users found')).toBeTruthy()
expect(view.getByText('Try adjusting your search')).toBeTruthy()
expect(view.queryByText('Clear')).toBeNull()
})
})