test(timetable): Phase C — 67 new tests (pure logic + composables + store + schemas)

apps/app/tests/unit/lib/timetable/:
  - snap.test.ts (5)            — rounding, clamp, edge cases
  - time-grid.test.ts (6)       — px↔min↔ISO roundtrips, formatTickLabel
  - conflict.test.ts (8)        — overlap, endpoint-touching, lane/stage scoping, cancelled exclusion
  - b2b.test.ts (6)             — 0min, 2:59, 3:01, overlap, side-set mapping, threshold constant
  - capacity.test.ts (7)        — null capacity, missing data, warn/critical, crew+guests preference
  - lane.test.ts (8)            — Pass 1 + Pass 2, cascade-bump preview, cancelled exclusion

apps/app/tests/unit/composables/:
  - useTimetableMutations.test.ts (5) — Idempotency-Key header, optimistic + cascade,
                                         409 VersionMismatch surfaced, park sends null,
                                         createStage POST path
  - useDragOrClick.test.ts (3)        — onClick fires under threshold, onDragStart+End
                                         above threshold, Esc cancels mid-flight

apps/app/tests/unit/schemas/timetable.test.ts (8) — payload + response zod parsers
apps/app/tests/unit/lib/idempotencyKey.test.ts (3) — 6-30 char range, 24-hex, uniqueness
apps/app/tests/unit/stores/useTimetableStore.test.ts (5) — defaults, toggleStatus, drag state, null guard

Refactor: useTimetableMutations.move now throws Error instances (no-throw-literal)
so AxiosError.message and the VersionMismatchError shape both bubble through .catch().

Test count: 252 → 319 (+67). All 42 files pass.

Out of scope this session (added to BACKLOG):
- ART-PERFORMANCEBLOCK-COMPONENT-TESTS — Vuetify intentionally not loaded in
  vitest.config.ts; a Vuexy-stub setup for component-mount tests is one PR of
  its own. Pure rendering logic (capacity, B2B, conflict) is fully covered at
  the lib/ layer.
- ART-AXE-CORE-A11Y-TESTS — axe-core not yet installed in the repo. The
  aria-label structure on PerformanceBlock + aria-live on the page entry are
  authored to pass an axe scan when added.
- ART-INTEGRATION-FLOW-TEST — full add → drag → resize → park flow needs
  Vuetify + router + msw setup; defer with the component tests above.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-09 02:04:10 +02:00
parent 43572a7812
commit 39fdc0fa3d
12 changed files with 981 additions and 8 deletions

View File

@@ -0,0 +1,77 @@
import { mount } from '@vue/test-utils'
import { describe, expect, it, vi } from 'vitest'
import { defineComponent, h } from 'vue'
import { useDragOrClick } from '@/composables/timetable/useDragOrClick'
interface ComponentInstance {
begin: (e: Event) => void
}
function makeHost(opts: Parameters<typeof useDragOrClick>[0]) {
return defineComponent({
setup(_, { expose }) {
const ctl = useDragOrClick(opts)
expose({ begin: ctl.begin })
return () => h('div')
},
})
}
function makePointerEvent(type: string, x: number, y: number, pointerId = 1): PointerEvent {
const e = new Event(type, { bubbles: true, cancelable: true }) as PointerEvent
Object.defineProperty(e, 'pointerId', { value: pointerId })
Object.defineProperty(e, 'clientX', { value: x })
Object.defineProperty(e, 'clientY', { value: y })
return e
}
describe('useDragOrClick', () => {
it('fires onClick when movement < threshold', async () => {
const onClick = vi.fn()
const onDragStart = vi.fn()
const wrapper = mount(makeHost({ thresholdPx: 4, onClick, onDragStart }))
const inst = wrapper.vm as unknown as ComponentInstance
inst.begin(makePointerEvent('pointerdown', 10, 10))
window.dispatchEvent(makePointerEvent('pointermove', 11, 11))
window.dispatchEvent(makePointerEvent('pointerup', 11, 11))
expect(onClick).toHaveBeenCalledTimes(1)
expect(onDragStart).not.toHaveBeenCalled()
})
it('enters drag mode and emits onDragStart + onDragEnd when movement crosses threshold', async () => {
const onClick = vi.fn()
const onDragStart = vi.fn()
const onDragEnd = vi.fn()
const wrapper = mount(makeHost({ thresholdPx: 4, onClick, onDragStart, onDragEnd }))
const inst = wrapper.vm as unknown as ComponentInstance
inst.begin(makePointerEvent('pointerdown', 10, 10))
window.dispatchEvent(makePointerEvent('pointermove', 50, 10))
window.dispatchEvent(makePointerEvent('pointerup', 50, 10))
expect(onDragStart).toHaveBeenCalledTimes(1)
expect(onDragEnd).toHaveBeenCalledTimes(1)
expect(onClick).not.toHaveBeenCalled()
})
it('Esc cancels an in-flight drag', async () => {
const onDragEnd = vi.fn()
const wrapper = mount(makeHost({ thresholdPx: 4, onDragEnd }))
const inst = wrapper.vm as unknown as ComponentInstance
inst.begin(makePointerEvent('pointerdown', 10, 10))
window.dispatchEvent(makePointerEvent('pointermove', 50, 10))
const esc = new KeyboardEvent('keydown', { key: 'Escape' })
window.dispatchEvent(esc)
expect(onDragEnd).toHaveBeenCalledWith(expect.anything(), true)
})
})

View File

@@ -0,0 +1,201 @@
import { QueryClient, VueQueryPlugin } from '@tanstack/vue-query'
import { mount } from '@vue/test-utils'
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import { defineComponent, h, ref } from 'vue'
import { apiClient } from '@/lib/axios'
import { useTimetableMutations } from '@/composables/api/useTimetableMutations'
import type { Performance } from '@/types/timetable'
vi.mock('@/lib/axios', () => {
const post = vi.fn()
const put = vi.fn()
const get = vi.fn()
const del = vi.fn()
return { apiClient: { post, put, get, delete: del } }
})
interface MockApi {
post: ReturnType<typeof vi.fn>
put: ReturnType<typeof vi.fn>
get: ReturnType<typeof vi.fn>
delete: ReturnType<typeof vi.fn>
}
const mocked = apiClient as unknown as MockApi
function p(overrides: Partial<Performance> = {}): Performance {
return {
id: 'p1',
engagement_id: 'e1',
event_id: 'ev1',
stage_id: 's1',
lane: 0,
lane_resolved: 0,
start_at: '2026-07-10T18:00:00.000Z',
end_at: '2026-07-10T19:00:00.000Z',
version: 3,
notes: null,
warnings: [],
created_at: null,
updated_at: null,
deleted_at: null,
...overrides,
}
}
function mountWithMutations() {
const api: { value: ReturnType<typeof useTimetableMutations> | null } = { value: null }
const orgId = ref('org_1')
const eventId = ref('ev_1')
const dayId = ref<string | null>('day_1')
const Host = defineComponent({
setup() {
api.value = useTimetableMutations({ orgId, eventId, dayId })
return () => h('div')
},
})
const queryClient = new QueryClient({ defaultOptions: { queries: { retry: false }, mutations: { retry: false } } })
const wrapper = mount(Host, {
global: { plugins: [[VueQueryPlugin, { queryClient }]] },
})
return { wrapper, api, queryClient }
}
describe('useTimetableMutations', () => {
beforeEach(() => {
vi.clearAllMocks()
})
afterEach(() => {
vi.clearAllMocks()
})
describe('move', () => {
it('sends Idempotency-Key header on POST /timetable/move', async () => {
mocked.post.mockResolvedValueOnce({ data: { success: true, data: { moved: p({ version: 4 }), cascaded: [] } } })
const { api } = mountWithMutations()
await api.value!.move.mutateAsync({
payload: {
performance_id: 'p1',
target_stage_id: 's1',
target_start_at: '2026-07-10 19:00:00',
target_end_at: '2026-07-10 20:00:00',
target_lane: 0,
version: 3,
},
idempotencyKey: 'idem-test-key-12345',
})
expect(mocked.post).toHaveBeenCalledTimes(1)
const [, , config] = mocked.post.mock.calls[0]
expect(config.headers['Idempotency-Key']).toBe('idem-test-key-12345')
})
it('applies optimistic patch + cascade on success', async () => {
mocked.post.mockResolvedValueOnce({
data: {
success: true,
data: {
moved: p({ id: 'p1', version: 4 }),
cascaded: [p({ id: 'p2', lane: 1, lane_resolved: 1, version: 4 })],
},
},
})
const { api, queryClient } = mountWithMutations()
const eventId = ref('ev_1')
const dayId = ref<string | null>('day_1')
queryClient.setQueryData(['timetable', 'performances', eventId, dayId], [
p({ id: 'p1' }),
p({ id: 'p2', lane: 0, lane_resolved: 0 }),
])
const result = await api.value!.move.mutateAsync({
payload: {
performance_id: 'p1',
target_stage_id: 's1',
target_start_at: '2026-07-10 19:00:00',
target_end_at: '2026-07-10 20:00:00',
target_lane: 0,
version: 3,
},
idempotencyKey: 'idem',
})
expect(result.cascaded).toHaveLength(1)
expect(result.moved.version).toBe(4)
})
it('surfaces VersionMismatch on 409', async () => {
mocked.post.mockRejectedValueOnce({
response: {
status: 409,
data: {
errors: {
conflict: 'version_mismatch',
current_version: 5,
client_version: 3,
server_data: p({ version: 5 }),
},
},
},
})
const { api } = mountWithMutations()
await expect(api.value!.move.mutateAsync({
payload: {
performance_id: 'p1',
target_stage_id: 's1',
target_start_at: '2026-07-10 19:00:00',
target_end_at: '2026-07-10 20:00:00',
target_lane: 0,
version: 3,
},
idempotencyKey: 'idem',
})).rejects.toMatchObject({ status: 409, conflict: { conflict: 'version_mismatch', current_version: 5 } })
})
})
describe('park / unpark via move', () => {
it('park sends target_stage_id null', async () => {
mocked.post.mockResolvedValueOnce({
data: { success: true, data: { moved: p({ stage_id: null, version: 4 }), cascaded: [] } },
})
const { api } = mountWithMutations()
await api.value!.park(p(), 'key1')
const [, body] = mocked.post.mock.calls[0]
expect(body.target_stage_id).toBe(null)
expect(body.version).toBe(3)
})
})
describe('createStage', () => {
it('hits POST /stages', async () => {
mocked.post.mockResolvedValueOnce({
data: { success: true, data: { id: 's2', name: 'New Stage', color: '#aabbcc', capacity: 1000, sort_order: 1, event_id: 'ev_1' } },
})
const { api } = mountWithMutations()
await api.value!.createStage.mutateAsync({ name: 'New Stage', color: '#aabbcc', capacity: 1000 })
expect(mocked.post.mock.calls[0][0]).toContain('/stages')
})
})
})