import { describe, it, expect, jest, beforeEach } from '@jest/globals';
// Create the mock
const mockExecuteThingsJSON = jest.fn<() => Promise<void>>();
// Mock the urlscheme module
jest.unstable_mockModule('../../src/lib/urlscheme.js', () => ({
executeThingsJSON: mockExecuteThingsJSON
}));
// Dynamic imports after mocking
const { ThingsJSONBuilder } = await import('../../src/lib/json-builder.js');
describe('ThingsJSONBuilder', () => {
let builder: ThingsJSONBuilder;
beforeEach(() => {
builder = new ThingsJSONBuilder();
jest.clearAllMocks();
});
describe('createTodo', () => {
it('should create a simple to-do', async () => {
const params = { title: 'Test Todo' };
await builder.createTodo(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'to-do',
attributes: { title: 'Test Todo' }
}
]);
});
it('should create a to-do with all parameters', async () => {
const params = {
title: 'Complex Todo',
notes: 'Some notes',
when: 'today' as const,
deadline: '2025-01-15',
tags: ['work', 'urgent'],
checklist_items: ['Step 1', 'Step 2'],
list: 'inbox',
completed: false
};
await builder.createTodo(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'to-do',
attributes: {
title: 'Complex Todo',
notes: 'Some notes',
when: 'today',
deadline: '2025-01-15',
tags: ['work', 'urgent'],
'checklist-items': [
{
type: 'checklist-item',
attributes: {
title: 'Step 1',
completed: false
}
},
{
type: 'checklist-item',
attributes: {
title: 'Step 2',
completed: false
}
}
],
list: 'inbox',
completed: false
}
}
]);
});
});
describe('createProject', () => {
it('should create a simple project', async () => {
const params = { title: 'Test Project' };
const result = await builder.createProject(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'project',
attributes: { title: 'Test Project' }
}
]);
expect(result).toBe('✅ Project created successfully: "Test Project"');
});
it('should create a project with items (headings)', async () => {
const params = {
title: 'Project with Headings',
items: [
{ type: 'heading' as const, title: 'Planning', archived: false },
{ type: 'heading' as const, title: 'Execution', archived: false }
]
};
const result = await builder.createProject(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'project',
attributes: {
title: 'Project with Headings',
items: [
{
type: 'heading',
attributes: { title: 'Planning', archived: false }
},
{
type: 'heading',
attributes: { title: 'Execution', archived: false }
}
]
}
}
]);
expect(result).toBe('✅ Project created successfully: "Project with Headings" (2 items)');
});
it('should create a project with items (todos)', async () => {
const params = {
title: 'Project with Todos',
items: [
{ type: 'todo' as const, title: 'Task 1' },
{ type: 'todo' as const, title: 'Task 2' },
{ type: 'todo' as const, title: 'Task 3' }
]
};
const result = await builder.createProject(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'project',
attributes: {
title: 'Project with Todos',
items: [
{
type: 'to-do',
attributes: { title: 'Task 1' }
},
{
type: 'to-do',
attributes: { title: 'Task 2' }
},
{
type: 'to-do',
attributes: { title: 'Task 3' }
}
]
}
}
]);
expect(result).toBe('✅ Project created successfully: "Project with Todos" (3 items)');
});
it('should create a project with mixed items (headings and todos)', async () => {
const params = {
title: 'Complex Project',
items: [
{ type: 'heading' as const, title: 'Phase 1' },
{ type: 'todo' as const, title: 'Task A' },
{ type: 'todo' as const, title: 'Task B' }
],
area: 'Work',
tags: ['important', 'q1']
};
const result = await builder.createProject(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'project',
attributes: {
title: 'Complex Project',
area: 'Work',
tags: ['important', 'q1'],
items: [
{
type: 'heading',
attributes: { title: 'Phase 1', archived: false }
},
{
type: 'to-do',
attributes: { title: 'Task A' }
},
{
type: 'to-do',
attributes: { title: 'Task B' }
}
]
}
}
]);
expect(result).toBe('✅ Project created successfully: "Complex Project" (3 items)');
});
});
describe('parameter conversion', () => {
it('should omit undefined parameters', async () => {
const params = {
title: 'Test',
notes: undefined,
when: undefined,
tags: []
};
await builder.createTodo(params);
const call = mockExecuteThingsJSON.mock.calls[0]?.[0];
const attributes = call?.[0]?.attributes as Record<string, unknown>;
expect(attributes.notes).toBeUndefined();
expect(attributes.when).toBeUndefined();
expect(attributes.tags).toBeUndefined();
});
it('should convert tags array to comma-separated string', async () => {
const params = {
title: 'Test',
tags: ['tag1', 'tag2', 'tag3']
};
await builder.createProject(params);
const call = mockExecuteThingsJSON.mock.calls[0]?.[0];
const attributes = call?.[0]?.attributes as Record<string, unknown>;
expect(attributes.tags).toEqual(['tag1', 'tag2', 'tag3']);
});
});
describe('updateTodo', () => {
it('should update a to-do with operation field', async () => {
const params = {
id: 'todo-123',
title: 'Updated Todo',
notes: 'Updated notes'
};
const result = await builder.updateTodo(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'to-do',
operation: 'update',
id: 'todo-123',
attributes: {
title: 'Updated Todo',
notes: 'Updated notes'
}
}
]);
expect(result).toBe('✅ To-do updated successfully: "Updated Todo"');
});
it('should update a to-do without title', async () => {
const params = {
id: 'todo-123',
completed: true
};
const result = await builder.updateTodo(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'to-do',
operation: 'update',
id: 'todo-123',
attributes: {
completed: true
}
}
]);
expect(result).toBe('✅ To-do updated successfully: "Updated todo"');
});
});
describe('updateProject', () => {
it('should update a project', async () => {
const params = {
id: 'project-456',
title: 'Updated Project',
area: 'New Area'
};
const result = await builder.updateProject(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'project',
operation: 'update',
id: 'project-456',
attributes: {
title: 'Updated Project',
area: 'New Area'
}
}
]);
expect(result).toBe('✅ Project updated successfully: "Updated Project"');
});
});
describe('addItemsToProject', () => {
it('should add items to an existing project', async () => {
const params = {
id: 'project-789',
items: [
{ type: 'heading' as const, title: 'New Phase' },
{ type: 'todo' as const, title: 'New Task' }
]
};
const result = await builder.addItemsToProject(params);
// Should create todo individually with list-id (headings are skipped)
expect(mockExecuteThingsJSON).toHaveBeenCalledWith([
{
type: 'to-do',
attributes: {
title: 'New Task',
'list-id': 'project-789'
}
}
]);
expect(result).toBe('✅ Added 1 todo(s) to project\n⚠️ Skipped 1 heading(s) - headings cannot be added to existing projects');
});
it('should add complex items with proper flat structure', async () => {
const params = {
id: 'aBc123dEf456gHi789JkL',
items: [
{ type: 'heading' as const, title: 'Day 1' },
{ type: 'todo' as const, title: 'Morning activity', notes: 'Early start' },
{ type: 'todo' as const, title: 'Lunch at cafe' },
{ type: 'heading' as const, title: 'Day 2' },
{ type: 'todo' as const, title: 'Museum visit', when: 'tomorrow' as const }
]
};
const result = await builder.addItemsToProject(params);
// Should be called 3 times (once for each todo, headings are skipped)
expect(mockExecuteThingsJSON).toHaveBeenCalledTimes(3);
// First todo
expect(mockExecuteThingsJSON).toHaveBeenNthCalledWith(1, [
{
type: 'to-do',
attributes: {
title: 'Morning activity',
notes: 'Early start',
'list-id': 'aBc123dEf456gHi789JkL'
}
}
]);
// Second todo
expect(mockExecuteThingsJSON).toHaveBeenNthCalledWith(2, [
{
type: 'to-do',
attributes: {
title: 'Lunch at cafe',
'list-id': 'aBc123dEf456gHi789JkL'
}
}
]);
// Third todo
expect(mockExecuteThingsJSON).toHaveBeenNthCalledWith(3, [
{
type: 'to-do',
attributes: {
title: 'Museum visit',
when: 'tomorrow',
'list-id': 'aBc123dEf456gHi789JkL'
}
}
]);
expect(result).toBe('✅ Added 3 todo(s) to project\n⚠️ Skipped 2 heading(s) - headings cannot be added to existing projects');
});
it('should handle only headings', async () => {
const params = {
id: 'project-789',
items: [
{ type: 'heading' as const, title: 'Phase 1' },
{ type: 'heading' as const, title: 'Phase 2' }
]
};
const result = await builder.addItemsToProject(params);
expect(mockExecuteThingsJSON).not.toHaveBeenCalled();
expect(result).toBe('⚠️ Skipped 2 heading(s) - headings cannot be added to existing projects');
});
it('should handle errors gracefully', async () => {
mockExecuteThingsJSON.mockRejectedValueOnce(new Error('API Error'));
const params = {
id: 'project-789',
items: [
{ type: 'todo' as const, title: 'Task 1' },
{ type: 'todo' as const, title: 'Task 2' }
]
};
const result = await builder.addItemsToProject(params);
expect(mockExecuteThingsJSON).toHaveBeenCalledTimes(2);
expect(result).toBe('✅ Added 1 todo(s) to project\n❌ Failed to add: "Task 1"');
});
});
});
