import { beforeEach, describe, expect, it, vi } from 'vitest'
import { users } from './users'
const mockNotion = {
users: {
list: vi.fn(),
retrieve: vi.fn()
},
search: vi.fn()
}
describe('users', () => {
beforeEach(() => {
vi.clearAllMocks()
})
describe('list', () => {
it('should list all users', async () => {
mockNotion.users.list.mockResolvedValue({
results: [
{
id: 'user-1',
type: 'person',
name: 'Alice',
avatar_url: 'https://example.com/alice.png',
person: { email: 'alice@example.com' }
},
{
id: 'bot-1',
type: 'bot',
name: 'My Bot',
avatar_url: null
}
],
next_cursor: null,
has_more: false
})
const result = await users(mockNotion as any, { action: 'list' })
expect(result.action).toBe('list')
expect(result.total).toBe(2)
expect(result.users).toHaveLength(2)
expect(result.users[0]).toEqual({
id: 'user-1',
type: 'person',
name: 'Alice',
avatar_url: 'https://example.com/alice.png',
email: 'alice@example.com'
})
expect(result.users[1]).toEqual({
id: 'bot-1',
type: 'bot',
name: 'My Bot',
avatar_url: null,
email: undefined
})
})
it('should handle empty user list', async () => {
mockNotion.users.list.mockResolvedValue({
results: [],
next_cursor: null,
has_more: false
})
const result = await users(mockNotion as any, { action: 'list' })
expect(result.action).toBe('list')
expect(result.total).toBe(0)
expect(result.users).toEqual([])
})
it('should default name to Unknown when missing', async () => {
mockNotion.users.list.mockResolvedValue({
results: [{ id: 'user-1', type: 'person', avatar_url: null, person: {} }],
next_cursor: null,
has_more: false
})
const result = await users(mockNotion as any, { action: 'list' })
expect(result.users[0].name).toBe('Unknown')
})
})
describe('get', () => {
it('should retrieve a single user by id', async () => {
mockNotion.users.retrieve.mockResolvedValue({
id: 'user-1',
type: 'person',
name: 'Alice',
avatar_url: 'https://example.com/alice.png',
person: { email: 'alice@example.com' }
})
const result = await users(mockNotion as any, { action: 'get', user_id: 'user-1' })
expect(result.action).toBe('get')
expect(result.id).toBe('user-1')
expect(result.type).toBe('person')
expect(result.name).toBe('Alice')
expect(result.email).toBe('alice@example.com')
expect(mockNotion.users.retrieve).toHaveBeenCalledWith({ user_id: 'user-1' })
})
it('should return undefined email for bot users', async () => {
mockNotion.users.retrieve.mockResolvedValue({
id: 'bot-1',
type: 'bot',
name: 'Bot',
avatar_url: null
})
const result = await users(mockNotion as any, { action: 'get', user_id: 'bot-1' })
expect(result.email).toBeUndefined()
})
it('should throw without user_id', async () => {
await expect(users(mockNotion as any, { action: 'get' })).rejects.toMatchObject({
code: 'VALIDATION_ERROR',
message: 'user_id required for get action'
})
})
})
describe('me', () => {
it('should retrieve the bot user', async () => {
mockNotion.users.retrieve.mockResolvedValue({
id: 'bot-1',
type: 'bot',
name: 'My Integration',
bot: { owner: { type: 'workspace', workspace: true } }
})
const result = await users(mockNotion as any, { action: 'me' })
expect(result.action).toBe('me')
expect(result.id).toBe('bot-1')
expect(result.type).toBe('bot')
expect(result.name).toBe('My Integration')
expect(result.bot).toEqual({ owner: { type: 'workspace', workspace: true } })
expect(mockNotion.users.retrieve).toHaveBeenCalledWith({ user_id: 'me' })
})
it('should default name to Bot when missing', async () => {
mockNotion.users.retrieve.mockResolvedValue({
id: 'bot-1',
type: 'bot',
bot: {}
})
const result = await users(mockNotion as any, { action: 'me' })
expect(result.name).toBe('Bot')
})
})
describe('from_workspace', () => {
it('should extract users from page metadata', async () => {
mockNotion.search.mockResolvedValue({
results: [
{
created_by: { id: 'user-1', object: 'user' },
last_edited_by: { id: 'user-2', object: 'user' }
},
{
created_by: { id: 'user-1', object: 'user' },
last_edited_by: { id: 'user-3', object: 'user' }
}
],
next_cursor: null,
has_more: false
})
const result = await users(mockNotion as any, { action: 'from_workspace' })
expect(result.action).toBe('from_workspace')
expect(result.total).toBe(3)
expect(result.users).toHaveLength(3)
expect(result.note).toContain('extracted from accessible pages')
})
it('should deduplicate users by id', async () => {
mockNotion.search.mockResolvedValue({
results: [
{
created_by: { id: 'user-1', object: 'user' },
last_edited_by: { id: 'user-1', object: 'user' }
}
],
next_cursor: null,
has_more: false
})
const result = await users(mockNotion as any, { action: 'from_workspace' })
expect(result.total).toBe(1)
})
it('should handle pages without created_by or last_edited_by', async () => {
mockNotion.search.mockResolvedValue({
results: [{ created_by: { id: 'user-1', object: 'user' } }],
next_cursor: null,
has_more: false
})
const result = await users(mockNotion as any, { action: 'from_workspace' })
expect(result.total).toBe(1)
})
it('should handle empty search results', async () => {
mockNotion.search.mockResolvedValue({
results: [],
next_cursor: null,
has_more: false
})
const result = await users(mockNotion as any, { action: 'from_workspace' })
expect(result.total).toBe(0)
expect(result.users).toEqual([])
})
})
describe('unknown action', () => {
it('should throw on unsupported action', async () => {
await expect(users(mockNotion as any, { action: 'delete' as any })).rejects.toMatchObject({
code: 'VALIDATION_ERROR'
})
})
})
})
