Scrum4Me/__tests__/stores/sprint-workspace/store.test.ts
Janpeter Visser 98ee05d458
feat(PBI-74): sprint-workspace-store (Story 9) (#181)
* feat(PBI-74): sprint-workspace-store skelet (Story 9 / T-879)

- stores/sprint-workspace/{types,store,selectors,restore}.ts conform
  product-workspace blueprint
- ContextSlice: activeProduct, activeSprintId, activeStoryId, activeTaskId
- EntitiesSlice: sprintsById, storiesById, tasksById
- RelationsSlice: sprintIdsByProduct, storyIdsBySprint, taskIdsByStory
- LoadingSlice met activeRequestId voor race-safe ensure*Loaded
- SyncSlice: realtimeStatus, lastResyncAt, resyncReason
- Realtime applyRealtimeEvent voor sprint/story/task entities + unknown-event
  fallback, parent-move handling, child-cleanup bij D op sprint/story
- Optimistic mutations: sprint-story-order, sprint-task-order, entity-patch
- LocalStorage hints (storage key sprint-workspace-hints) per product/sprint
- 45 unit-tests groen — verplicht 13 cases uit workspace-store.md §Tests

* feat(PBI-74): sprint hydratie + realtime SSE (Story 9 / T-880)

- app/api/realtime/sprint/route.ts: SSE-stream LISTEN/NOTIFY op
  scrum4me_changes, filter entity ∈ {sprint, story, task} per product_id;
  ready-event, heartbeat 25s, hard-close 240s
- lib/realtime/use-sprint-realtime.ts: client-hook met backoff-reconnect;
  ready-cycle telt; geen close op hidden; setRealtimeStatus
- lib/realtime/use-sprint-workspace-resync.ts: visibility + online triggers
  resyncActiveScopes('visible' | 'reconnect')
- components/sprint/sprint-hydration-wrapper.tsx: hydrateSnapshot via
  useEffect met fingerprint-check; mount realtime + resync
- app/(app)/products/[id]/sprint/[sprintId]/page.tsx: wrap SprintBoardClient
  in SprintHydrationWrapper; bouw SprintWorkspaceTask-shape voor
  tasksByStoryWorkspace en SprintHydrationData voor de wrapper

Schaduw-fase: useSprintStore blijft parallel werken in board components
totdat T-881 die migreert en T-883 de oude store opruimt.

* feat(PBI-74): migreer sprint-board componenten naar workspace-store (Story 9 / T-881)

- TaskList: leest tasks via selectTasksForStory met useShallow; DnD via
  applyOptimisticMutation('sprint-task-order') + settle/rollback
- SprintBacklogLeft: leest stories via selectStoriesForActiveSprint met
  useShallow; props 'stories' verwijderd
- SprintBoardClient: leest sprintStories uit selector i.p.v. lokale state;
  add/remove via direct setState met manuele snapshot-rollback;
  reorder via applyOptimisticMutation('sprint-story-order'); assignee-
  change via store entity-mutation; tasksByStory en sprintStoryIdList
  props weg
- app/(app)/.../sprint/[sprintId]/page.tsx: bouwt SprintHydrationData voor
  wrapper; geeft alleen non-store props door aan SprintBoardClient

useSprintStore wordt nergens meer geïmporteerd — alleen comment-referentie
in SprintHydrationWrapper. Cleanup van het bestand zelf in T-883.

Verify groen (671 tests, typecheck, lint clean).

* feat(PBI-74): read-routes voor sprint-workspace + cache-headers (Story 9 / T-882)

- GET /api/products/[id]/sprints — lijst sprints per product
  (ensureProductSprintsLoaded). force-dynamic, productAccessFilter,
  start_date/end_date naar ISO-date string.
- GET /api/sprints/[id]/workspace — sprint snapshot met sprint-meta,
  stories (incl. taskCount/doneCount/assignee), tasks gegroepeerd per
  story (ensureSprintLoaded). force-dynamic, productAccessFilter via
  product, status-vertaling via taskStatusToApi/storyStatusToApi.

Race-safe loaders (activeRequestId-guard), restore-flow (cascade-restore
via writeProductHint/writeSprintHint/writeStoryHint/writeTaskHint),
resync-laag (useSprintWorkspaceResync visibility + online), unknown-event
filter (isUnknownEntityEvent → resyncActiveScopes('unknown-event')) zijn
allemaal in T-879/T-880 al ingebouwd; T-882 sluit het loop met de
ontbrekende API-endpoints + cache-headers (cache: 'no-store' op fetches,
force-dynamic op routes).

* feat(PBI-74): cleanup oude sprint-store (Story 9 / T-883)

- rm stores/sprint-store.ts — alle componenten lezen nu via
  useSprintWorkspaceStore (T-881 voltooide imports-migratie)
- update SprintHydrationWrapper-comment: schaduw-fase referenties
  verwijderd

Verify: 671 tests groen, typecheck clean, build groen.
Grep useSprintStore = 0.

* docs(PBI-74): update Story 9 status in implementatieplan (T-884)

- Frontmatter: ready-to-execute → in-progress; revision 1 → 2;
  last_updated 2026-05-09 → 2026-05-10
- Stories-tabel: kolom Status toegevoegd (Stories 1-8 DONE via PR #180,
  Story 9 met T-884 op review)
- §Story 9: per-taak status + acceptatie-checklist voor T-884 manuele
  staging-checks
- Aanbeveling-blokje: noteert dat Story 9 vroeger gestart is dan het
  ontwerpdoc adviseerde
2026-05-10 06:53:04 +02:00

910 lines
32 KiB
TypeScript

import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import { useSprintWorkspaceStore } from '@/stores/sprint-workspace/store'
import type {
SprintWorkspaceSnapshot,
SprintWorkspaceSprint,
SprintWorkspaceStory,
SprintWorkspaceTask,
SprintWorkspaceTaskDetail,
} from '@/stores/sprint-workspace/types'
// G5: snapshot original actions on module-load; restore in beforeEach.
const originalActions = (() => {
const s = useSprintWorkspaceStore.getState()
return {
hydrateSnapshot: s.hydrateSnapshot,
hydrateProductSprints: s.hydrateProductSprints,
setActiveProduct: s.setActiveProduct,
setActiveSprint: s.setActiveSprint,
setActiveStory: s.setActiveStory,
setActiveTask: s.setActiveTask,
ensureProductSprintsLoaded: s.ensureProductSprintsLoaded,
ensureSprintLoaded: s.ensureSprintLoaded,
ensureStoryLoaded: s.ensureStoryLoaded,
ensureTaskLoaded: s.ensureTaskLoaded,
applyRealtimeEvent: s.applyRealtimeEvent,
resyncActiveScopes: s.resyncActiveScopes,
resyncLoadedScopes: s.resyncLoadedScopes,
applyOptimisticMutation: s.applyOptimisticMutation,
rollbackMutation: s.rollbackMutation,
settleMutation: s.settleMutation,
setRealtimeStatus: s.setRealtimeStatus,
}
})()
function resetStore() {
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = null
s.context.activeSprintId = null
s.context.activeStoryId = null
s.context.activeTaskId = null
s.entities.sprintsById = {}
s.entities.storiesById = {}
s.entities.tasksById = {}
s.relations.sprintIdsByProduct = {}
s.relations.storyIdsBySprint = {}
s.relations.taskIdsByStory = {}
s.loading.loadedProductSprintsIds = {}
s.loading.loadingProductId = null
s.loading.loadedSprintIds = {}
s.loading.loadingSprintId = null
s.loading.loadedStoryIds = {}
s.loading.loadedTaskIds = {}
s.loading.activeRequestId = null
s.sync.realtimeStatus = 'connecting'
s.sync.lastEventAt = null
s.sync.lastResyncAt = null
s.sync.resyncReason = null
s.pendingMutations = {}
Object.assign(s, originalActions)
})
}
beforeEach(() => {
resetStore()
})
afterEach(() => {
vi.restoreAllMocks()
})
function makeSprint(
overrides: Partial<SprintWorkspaceSprint> & { id: string; product_id: string },
): SprintWorkspaceSprint {
return {
id: overrides.id,
product_id: overrides.product_id,
code: overrides.code ?? `S-${overrides.id}`,
sprint_goal: overrides.sprint_goal ?? `Goal ${overrides.id}`,
status: overrides.status ?? 'OPEN',
start_date: overrides.start_date ?? '2026-04-01',
end_date: overrides.end_date ?? '2026-04-14',
created_at: overrides.created_at ?? new Date('2026-03-15'),
completed_at: overrides.completed_at ?? null,
}
}
function makeStory(
overrides: Partial<SprintWorkspaceStory> & { id: string; pbi_id: string },
): SprintWorkspaceStory {
return {
id: overrides.id,
code: overrides.code ?? overrides.id,
title: overrides.title ?? `Story ${overrides.id}`,
description: overrides.description ?? null,
acceptance_criteria: overrides.acceptance_criteria ?? null,
priority: overrides.priority ?? 2,
sort_order: overrides.sort_order ?? 1,
status: overrides.status ?? 'open',
pbi_id: overrides.pbi_id,
sprint_id: overrides.sprint_id ?? null,
created_at: overrides.created_at ?? new Date('2026-01-01'),
}
}
function makeTask(
overrides: Partial<SprintWorkspaceTask> & { id: string; story_id: string },
): SprintWorkspaceTask {
return {
id: overrides.id,
code: overrides.code ?? null,
title: overrides.title ?? `Task ${overrides.id}`,
description: overrides.description ?? null,
priority: overrides.priority ?? 2,
sort_order: overrides.sort_order ?? 1,
status: overrides.status ?? 'todo',
story_id: overrides.story_id,
sprint_id: overrides.sprint_id ?? null,
created_at: overrides.created_at ?? new Date('2026-01-01'),
}
}
function snapshotWith(
sprint: SprintWorkspaceSprint | undefined,
stories: SprintWorkspaceStory[] = [],
tasksByStory: Record<string, SprintWorkspaceTask[]> = {},
product?: { id: string; name: string },
): SprintWorkspaceSnapshot {
return { product, sprint, stories, tasksByStory }
}
// G7/G8: mock fetch via mockImplementation (vers Response per call)
function mockFetchSequence(
responses: Array<unknown | ((url: string, init?: RequestInit) => unknown)>,
) {
let i = 0
return vi.spyOn(globalThis, 'fetch').mockImplementation((async (url: string, init?: RequestInit) => {
const r = responses[Math.min(i, responses.length - 1)]
i += 1
const body = typeof r === 'function' ? (r as (u: string, i?: RequestInit) => unknown)(url, init) : r
return new Response(JSON.stringify(body ?? null), { status: 200 })
}) as unknown as typeof fetch)
}
// ─────────────────────────────────────────────────────────────────────────
// hydrateSnapshot
// ─────────────────────────────────────────────────────────────────────────
describe('hydrateSnapshot', () => {
it('vult entities, relations en loaded-marker', () => {
const sprint = makeSprint({ id: 'sp-1', product_id: 'prod-1' })
const storyA = makeStory({ id: 's-a', pbi_id: 'pbi-1', sprint_id: 'sp-1', sort_order: 2 })
const storyB = makeStory({ id: 's-b', pbi_id: 'pbi-1', sprint_id: 'sp-1', sort_order: 1 })
const taskA = makeTask({ id: 't-a', story_id: 's-a', sort_order: 2 })
const taskB = makeTask({ id: 't-b', story_id: 's-a', sort_order: 1 })
useSprintWorkspaceStore.getState().hydrateSnapshot(
snapshotWith(
sprint,
[storyA, storyB],
{ 's-a': [taskA, taskB] },
{ id: 'prod-1', name: 'Product 1' },
),
)
const s = useSprintWorkspaceStore.getState()
expect(s.entities.sprintsById['sp-1']).toEqual(sprint)
expect(s.entities.storiesById['s-a']).toEqual(storyA)
expect(s.entities.storiesById['s-b']).toEqual(storyB)
// sort_order: storyB (1) before storyA (2)
expect(s.relations.storyIdsBySprint['sp-1']).toEqual(['s-b', 's-a'])
// sort_order: taskB (1) before taskA (2)
expect(s.relations.taskIdsByStory['s-a']).toEqual(['t-b', 't-a'])
expect(s.context.activeProduct).toEqual({ id: 'prod-1', name: 'Product 1' })
expect(s.loading.loadedSprintIds['sp-1']).toBe(true)
})
})
describe('hydrateProductSprints', () => {
it('sorteert OPEN voor CLOSED, dan op start_date desc', () => {
const closedOld = makeSprint({
id: 'sp-closed-old',
product_id: 'prod-1',
status: 'CLOSED',
start_date: '2026-01-01',
})
const openNew = makeSprint({
id: 'sp-open-new',
product_id: 'prod-1',
status: 'OPEN',
start_date: '2026-04-01',
})
const openOld = makeSprint({
id: 'sp-open-old',
product_id: 'prod-1',
status: 'OPEN',
start_date: '2026-02-01',
})
useSprintWorkspaceStore
.getState()
.hydrateProductSprints('prod-1', [closedOld, openOld, openNew])
const s = useSprintWorkspaceStore.getState()
expect(s.relations.sprintIdsByProduct['prod-1']).toEqual([
'sp-open-new',
'sp-open-old',
'sp-closed-old',
])
expect(s.loading.loadedProductSprintsIds['prod-1']).toBe(true)
})
})
// ─────────────────────────────────────────────────────────────────────────
// Selection cascade
// ─────────────────────────────────────────────────────────────────────────
describe('selection cascade', () => {
it('setActiveSprint reset story+task; setActiveStory reset task', () => {
useSprintWorkspaceStore.setState((s) => {
s.context.activeSprintId = 'sp-old'
s.context.activeStoryId = 's-old'
s.context.activeTaskId = 't-old'
})
useSprintWorkspaceStore.getState().setActiveSprint('sp-new')
let s = useSprintWorkspaceStore.getState()
expect(s.context.activeSprintId).toBe('sp-new')
expect(s.context.activeStoryId).toBeNull()
expect(s.context.activeTaskId).toBeNull()
useSprintWorkspaceStore.setState((draft) => {
draft.context.activeStoryId = 's-old'
draft.context.activeTaskId = 't-old'
})
useSprintWorkspaceStore.getState().setActiveStory('s-new')
s = useSprintWorkspaceStore.getState()
expect(s.context.activeStoryId).toBe('s-new')
expect(s.context.activeTaskId).toBeNull()
})
it('setActiveProduct(null) ruimt entities en relations op', () => {
useSprintWorkspaceStore.getState().hydrateSnapshot(
snapshotWith(
makeSprint({ id: 'sp-1', product_id: 'prod-1' }),
[makeStory({ id: 's-1', pbi_id: 'pbi-1', sprint_id: 'sp-1' })],
{ 's-1': [makeTask({ id: 't-1', story_id: 's-1' })] },
{ id: 'prod-1', name: 'Product 1' },
),
)
useSprintWorkspaceStore.getState().setActiveProduct(null)
const s = useSprintWorkspaceStore.getState()
expect(s.context.activeProduct).toBeNull()
expect(s.context.activeSprintId).toBeNull()
expect(s.entities.sprintsById).toEqual({})
expect(s.entities.storiesById).toEqual({})
expect(s.entities.tasksById).toEqual({})
expect(s.relations.sprintIdsByProduct).toEqual({})
expect(s.relations.storyIdsBySprint).toEqual({})
expect(s.relations.taskIdsByStory).toEqual({})
})
})
// ─────────────────────────────────────────────────────────────────────────
// applyRealtimeEvent
// ─────────────────────────────────────────────────────────────────────────
describe('applyRealtimeEvent — sprint', () => {
beforeEach(() => {
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = { id: 'prod-1', name: 'Product 1' }
})
})
it('I — voegt sprint toe aan product-lijst', () => {
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'sprint',
op: 'I',
id: 'sp-new',
product_id: 'prod-1',
code: 'S-1',
sprint_goal: 'New Sprint',
status: 'OPEN',
start_date: '2026-05-01',
end_date: '2026-05-14',
created_at: new Date('2026-04-15').toISOString(),
})
const s = useSprintWorkspaceStore.getState()
expect(s.entities.sprintsById['sp-new']).toBeDefined()
expect(s.relations.sprintIdsByProduct['prod-1']).toContain('sp-new')
})
it('I — idempotent voor bestaande id', () => {
useSprintWorkspaceStore
.getState()
.hydrateProductSprints('prod-1', [
makeSprint({ id: 'sp-1', product_id: 'prod-1', sprint_goal: 'Origineel' }),
])
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'sprint',
op: 'I',
id: 'sp-1',
product_id: 'prod-1',
sprint_goal: 'echo',
})
expect(useSprintWorkspaceStore.getState().entities.sprintsById['sp-1'].sprint_goal).toBe(
'Origineel',
)
})
it('U — patch + her-sorteert', () => {
useSprintWorkspaceStore
.getState()
.hydrateProductSprints('prod-1', [
makeSprint({
id: 'sp-a',
product_id: 'prod-1',
status: 'OPEN',
start_date: '2026-04-01',
}),
makeSprint({
id: 'sp-b',
product_id: 'prod-1',
status: 'OPEN',
start_date: '2026-03-01',
}),
])
// sp-a (newer) komt eerst
expect(
useSprintWorkspaceStore.getState().relations.sprintIdsByProduct['prod-1'],
).toEqual(['sp-a', 'sp-b'])
// Sluit sp-a → moet naar achteren
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'sprint',
op: 'U',
id: 'sp-a',
product_id: 'prod-1',
status: 'CLOSED',
})
expect(
useSprintWorkspaceStore.getState().relations.sprintIdsByProduct['prod-1'],
).toEqual(['sp-b', 'sp-a'])
})
it('D — verwijdert sprint inclusief child stories en tasks', () => {
useSprintWorkspaceStore.getState().hydrateSnapshot(
snapshotWith(
makeSprint({ id: 'sp-1', product_id: 'prod-1' }),
[makeStory({ id: 's-1', pbi_id: 'pbi-1', sprint_id: 'sp-1' })],
{ 's-1': [makeTask({ id: 't-1', story_id: 's-1' })] },
{ id: 'prod-1', name: 'Product 1' },
),
)
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'sprint',
op: 'D',
id: 'sp-1',
product_id: 'prod-1',
})
const s = useSprintWorkspaceStore.getState()
expect(s.entities.sprintsById['sp-1']).toBeUndefined()
expect(s.entities.storiesById['s-1']).toBeUndefined()
expect(s.entities.tasksById['t-1']).toBeUndefined()
expect(s.relations.storyIdsBySprint['sp-1']).toBeUndefined()
expect(s.relations.taskIdsByStory['s-1']).toBeUndefined()
})
it('D — clear actieve sprint selectie als die de verwijderde sprint was', () => {
useSprintWorkspaceStore.getState().hydrateSnapshot(
snapshotWith(makeSprint({ id: 'sp-1', product_id: 'prod-1' }), []),
)
useSprintWorkspaceStore.setState((s) => {
s.context.activeSprintId = 'sp-1'
s.context.activeStoryId = 's-x'
s.context.activeTaskId = 't-x'
})
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'sprint',
op: 'D',
id: 'sp-1',
product_id: 'prod-1',
})
const s = useSprintWorkspaceStore.getState()
expect(s.context.activeSprintId).toBeNull()
expect(s.context.activeStoryId).toBeNull()
expect(s.context.activeTaskId).toBeNull()
})
})
describe('applyRealtimeEvent — story sprint-move', () => {
beforeEach(() => {
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = { id: 'prod-1', name: 'Product 1' }
})
useSprintWorkspaceStore.getState().hydrateSnapshot(
snapshotWith(
makeSprint({ id: 'sp-1', product_id: 'prod-1' }),
[makeStory({ id: 's-1', pbi_id: 'pbi-1', sprint_id: 'sp-1' })],
),
)
})
it('U met andere sprint_id verplaatst story uit sprint-relatie', () => {
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'story',
op: 'U',
id: 's-1',
product_id: 'prod-1',
pbi_id: 'pbi-1',
sprint_id: 'sp-other',
})
const s = useSprintWorkspaceStore.getState()
expect(s.relations.storyIdsBySprint['sp-1']).toEqual([])
expect(s.relations.storyIdsBySprint['sp-other']).toEqual(['s-1'])
expect(s.entities.storiesById['s-1'].sprint_id).toBe('sp-other')
})
it('U met sprint_id=null haalt story uit sprint-relatie', () => {
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'story',
op: 'U',
id: 's-1',
product_id: 'prod-1',
pbi_id: 'pbi-1',
sprint_id: null,
})
expect(useSprintWorkspaceStore.getState().relations.storyIdsBySprint['sp-1']).toEqual([])
expect(useSprintWorkspaceStore.getState().entities.storiesById['s-1'].sprint_id).toBeNull()
})
})
describe('applyRealtimeEvent — task parent-move', () => {
beforeEach(() => {
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = { id: 'prod-1', name: 'Product 1' }
})
useSprintWorkspaceStore.getState().hydrateSnapshot(
snapshotWith(
makeSprint({ id: 'sp-1', product_id: 'prod-1' }),
[
makeStory({ id: 's-1', pbi_id: 'pbi-1', sprint_id: 'sp-1' }),
makeStory({ id: 's-2', pbi_id: 'pbi-1', sprint_id: 'sp-1' }),
],
{
's-1': [makeTask({ id: 't-1', story_id: 's-1' })],
's-2': [],
},
),
)
})
it('U met andere story_id verplaatst task naar nieuwe parent', () => {
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'task',
op: 'U',
id: 't-1',
product_id: 'prod-1',
story_id: 's-2',
})
const s = useSprintWorkspaceStore.getState()
expect(s.relations.taskIdsByStory['s-1']).toEqual([])
expect(s.relations.taskIdsByStory['s-2']).toEqual(['t-1'])
expect(s.entities.tasksById['t-1'].story_id).toBe('s-2')
})
})
describe('applyRealtimeEvent — andere product genegeerd', () => {
it('event met ander product_id raakt de store niet', () => {
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = { id: 'prod-1', name: 'Product 1' }
})
useSprintWorkspaceStore
.getState()
.hydrateProductSprints('prod-1', [makeSprint({ id: 'sp-1', product_id: 'prod-1' })])
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'sprint',
op: 'I',
id: 'sp-other',
product_id: 'prod-2',
code: 'X',
})
const s = useSprintWorkspaceStore.getState()
expect(s.entities.sprintsById['sp-other']).toBeUndefined()
})
})
describe('applyRealtimeEvent — unknown entity → resync trigger', () => {
function withSpy(): ReturnType<typeof vi.fn> {
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = { id: 'prod-1', name: 'Product 1' }
})
const spy = vi.fn().mockResolvedValue(undefined)
useSprintWorkspaceStore.setState((s) => {
s.resyncActiveScopes = spy as unknown as typeof s.resyncActiveScopes
})
return spy
}
it('unknown entity met matching product triggert resync', () => {
const spy = withSpy()
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'comment',
op: 'I',
id: 'cm-1',
product_id: 'prod-1',
})
expect(spy).toHaveBeenCalledWith('unknown-event')
})
it('unknown entity met ander product_id triggert geen resync', () => {
const spy = withSpy()
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'comment',
op: 'I',
id: 'cm-1',
product_id: 'prod-2',
})
expect(spy).not.toHaveBeenCalled()
})
it('claude_job_status (type-veld) triggert geen resync', () => {
const spy = withSpy()
useSprintWorkspaceStore.getState().applyRealtimeEvent({
type: 'claude_job_status',
job_id: 'job-1',
product_id: 'prod-1',
status: 'queued',
})
expect(spy).not.toHaveBeenCalled()
})
it('worker_heartbeat (type-veld) triggert geen resync', () => {
const spy = withSpy()
useSprintWorkspaceStore.getState().applyRealtimeEvent({
type: 'worker_heartbeat',
worker_id: 'w-1',
product_id: 'prod-1',
})
expect(spy).not.toHaveBeenCalled()
})
it('payload zonder entity en zonder type wordt genegeerd', () => {
const spy = withSpy()
useSprintWorkspaceStore.getState().applyRealtimeEvent({
product_id: 'prod-1',
something: 'else',
})
expect(spy).not.toHaveBeenCalled()
})
})
// ─────────────────────────────────────────────────────────────────────────
// ensure*Loaded
// ─────────────────────────────────────────────────────────────────────────
describe('ensureProductSprintsLoaded', () => {
it('fetcht sprint-list en hydreert met sortering', async () => {
const sprints = [
makeSprint({
id: 'sp-old',
product_id: 'prod-1',
status: 'CLOSED',
start_date: '2026-01-01',
}),
makeSprint({
id: 'sp-new',
product_id: 'prod-1',
status: 'OPEN',
start_date: '2026-04-01',
}),
]
const fetchSpy = mockFetchSequence([sprints])
await useSprintWorkspaceStore.getState().ensureProductSprintsLoaded('prod-1')
expect(fetchSpy).toHaveBeenCalledWith(
'/api/products/prod-1/sprints',
expect.objectContaining({ cache: 'no-store' }),
)
const s = useSprintWorkspaceStore.getState()
expect(s.relations.sprintIdsByProduct['prod-1']).toEqual(['sp-new', 'sp-old'])
expect(s.loading.loadedProductSprintsIds['prod-1']).toBe(true)
})
})
describe('ensureSprintLoaded', () => {
it('fetcht sprint-snapshot en hydreert', async () => {
const sprint = makeSprint({ id: 'sp-1', product_id: 'prod-1' })
const snapshot: SprintWorkspaceSnapshot = {
product: { id: 'prod-1', name: 'P1' },
sprint,
stories: [makeStory({ id: 's-1', pbi_id: 'pbi-1', sprint_id: 'sp-1' })],
tasksByStory: {
's-1': [makeTask({ id: 't-1', story_id: 's-1' })],
},
}
const fetchSpy = mockFetchSequence([snapshot])
await useSprintWorkspaceStore.getState().ensureSprintLoaded('sp-1')
expect(fetchSpy).toHaveBeenCalledWith(
'/api/sprints/sp-1/workspace',
expect.objectContaining({ cache: 'no-store' }),
)
const s = useSprintWorkspaceStore.getState()
expect(s.entities.sprintsById['sp-1']).toBeDefined()
expect(s.relations.storyIdsBySprint['sp-1']).toEqual(['s-1'])
expect(s.relations.taskIdsByStory['s-1']).toEqual(['t-1'])
expect(s.loading.loadedSprintIds['sp-1']).toBe(true)
})
})
describe('race-safe ensure*Loaded — activeRequestId guard', () => {
it('oudere in-flight ensureSprintLoaded mag nieuwere selectie niet overschrijven', async () => {
let resolveOld: ((snap: SprintWorkspaceSnapshot) => void) | null = null
vi.spyOn(globalThis, 'fetch').mockImplementation((async (url: string) => {
if (url === '/api/sprints/sp-old/workspace') {
const snap = await new Promise<SprintWorkspaceSnapshot>((resolve) => {
resolveOld = resolve
})
return new Response(JSON.stringify(snap), { status: 200 })
}
if (url === '/api/sprints/sp-new/workspace') {
return new Response(
JSON.stringify({
sprint: makeSprint({ id: 'sp-new', product_id: 'prod-1' }),
stories: [makeStory({ id: 'new-st', pbi_id: 'p', sprint_id: 'sp-new' })],
tasksByStory: {},
}),
{ status: 200 },
)
}
return new Response('null', { status: 200 })
}) as unknown as typeof fetch)
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = { id: 'prod-1', name: 'Product 1' }
s.context.activeSprintId = 'sp-old'
s.loading.activeRequestId = 'req-old'
})
const oldPromise = useSprintWorkspaceStore
.getState()
.ensureSprintLoaded('sp-old', 'req-old')
useSprintWorkspaceStore.setState((s) => {
s.context.activeSprintId = 'sp-new'
s.loading.activeRequestId = 'req-new'
})
await useSprintWorkspaceStore
.getState()
.ensureSprintLoaded('sp-new', 'req-new')
expect(useSprintWorkspaceStore.getState().entities.storiesById['new-st']).toBeDefined()
resolveOld!({
sprint: makeSprint({ id: 'sp-old', product_id: 'prod-1' }),
stories: [makeStory({ id: 'old-st', pbi_id: 'p', sprint_id: 'sp-old' })],
tasksByStory: {},
})
await oldPromise
const s = useSprintWorkspaceStore.getState()
expect(s.context.activeSprintId).toBe('sp-new')
expect(s.entities.storiesById['old-st']).toBeUndefined()
expect(s.entities.storiesById['new-st']).toBeDefined()
})
})
describe('ensureTaskLoaded — zet detail-flag', () => {
it('verrijkt task naar TaskDetail met _detail: true', async () => {
mockFetchSequence([
{
id: 't-1',
code: 'C1',
title: 'Task 1',
description: 'desc',
priority: 1,
sort_order: 1,
status: 'todo',
story_id: 's-1',
sprint_id: 'sp-1',
created_at: new Date('2026-02-01').toISOString(),
implementation_plan: 'detailed plan here',
},
])
await useSprintWorkspaceStore.getState().ensureTaskLoaded('t-1')
const task = useSprintWorkspaceStore.getState().entities.tasksById[
't-1'
] as SprintWorkspaceTaskDetail
expect(task._detail).toBe(true)
expect(task.implementation_plan).toBe('detailed plan here')
expect(useSprintWorkspaceStore.getState().loading.loadedTaskIds['t-1']).toBe(true)
})
})
// ─────────────────────────────────────────────────────────────────────────
// resyncActiveScopes
// ─────────────────────────────────────────────────────────────────────────
describe('resyncActiveScopes', () => {
it('triggert ensure-keten voor alle actieve scopes en zet sync velden', async () => {
const fetchSpy = mockFetchSequence([
// ensureProductSprintsLoaded
[],
// ensureSprintLoaded
{
sprint: makeSprint({ id: 'sp-1', product_id: 'prod-1' }),
stories: [],
tasksByStory: {},
},
// ensureStoryLoaded
[],
// ensureTaskLoaded
{
id: 't-1',
title: 'T',
description: null,
priority: 1,
sort_order: 1,
status: 'todo',
story_id: 's-1',
sprint_id: 'sp-1',
created_at: '2026-02-01',
},
])
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = { id: 'prod-1', name: 'P' }
s.context.activeSprintId = 'sp-1'
s.context.activeStoryId = 's-1'
s.context.activeTaskId = 't-1'
})
await useSprintWorkspaceStore.getState().resyncActiveScopes('manual')
const calls = fetchSpy.mock.calls.map(([url]) => url)
expect(calls).toContain('/api/products/prod-1/sprints')
expect(calls).toContain('/api/sprints/sp-1/workspace')
expect(calls).toContain('/api/stories/s-1/tasks')
expect(calls).toContain('/api/tasks/t-1')
const s = useSprintWorkspaceStore.getState()
expect(s.sync.lastResyncAt).toBeTypeOf('number')
expect(s.sync.resyncReason).toBe('manual')
})
})
// ─────────────────────────────────────────────────────────────────────────
// Restore-hint flow
// ─────────────────────────────────────────────────────────────────────────
describe('restore-hint flow — setters persisteren hints', () => {
it('setActiveProduct schrijft lastActiveProductId', () => {
useSprintWorkspaceStore.getState().setActiveProduct({ id: 'prod-1', name: 'P1' })
const raw = localStorage.getItem('sprint-workspace-hints')
expect(raw).not.toBeNull()
const hints = JSON.parse(raw!)
expect(hints.lastActiveProductId).toBe('prod-1')
})
it('setActiveSprint schrijft lastActiveSprintId per product', () => {
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = { id: 'prod-1', name: 'P1' }
})
useSprintWorkspaceStore.getState().setActiveSprint('sp-a')
const hints = JSON.parse(localStorage.getItem('sprint-workspace-hints')!)
expect(hints.perProduct['prod-1'].lastActiveSprintId).toBe('sp-a')
})
it('setActiveStory schrijft lastActiveStoryId per sprint', () => {
useSprintWorkspaceStore.setState((s) => {
s.context.activeSprintId = 'sp-1'
})
useSprintWorkspaceStore.getState().setActiveStory('s-a')
const hints = JSON.parse(localStorage.getItem('sprint-workspace-hints')!)
expect(hints.perSprint['sp-1'].lastActiveStoryId).toBe('s-a')
})
it('setActiveTask schrijft lastActiveTaskId per sprint', () => {
useSprintWorkspaceStore.setState((s) => {
s.context.activeSprintId = 'sp-1'
})
useSprintWorkspaceStore.getState().setActiveTask('t-a')
const hints = JSON.parse(localStorage.getItem('sprint-workspace-hints')!)
expect(hints.perSprint['sp-1'].lastActiveTaskId).toBe('t-a')
})
})
describe('restore-hint flow — chain triggert na ensure*Loaded', () => {
it('hint die NIET in entities zit wordt genegeerd', async () => {
localStorage.setItem(
'sprint-workspace-hints',
JSON.stringify({
lastActiveProductId: 'prod-1',
perProduct: { 'prod-1': { lastActiveSprintId: 'ghost-sprint' } },
perSprint: {},
}),
)
mockFetchSequence([[]])
useSprintWorkspaceStore.getState().setActiveProduct({ id: 'prod-1', name: 'P1' })
await new Promise((r) => setTimeout(r, 20))
expect(useSprintWorkspaceStore.getState().context.activeSprintId).toBeNull()
})
it('hint die wel in entities zit wordt toegepast', async () => {
const validSprint = makeSprint({ id: 'sp-known', product_id: 'prod-1' })
localStorage.setItem(
'sprint-workspace-hints',
JSON.stringify({
lastActiveProductId: 'prod-1',
perProduct: { 'prod-1': { lastActiveSprintId: 'sp-known' } },
perSprint: {},
}),
)
mockFetchSequence([
// ensureProductSprintsLoaded — levert sp-known
[validSprint],
// ensureSprintLoaded triggered door setActiveSprint(hint)
{ sprint: validSprint, stories: [], tasksByStory: {} },
])
useSprintWorkspaceStore.getState().setActiveProduct({ id: 'prod-1', name: 'P1' })
await new Promise((r) => setTimeout(r, 30))
expect(useSprintWorkspaceStore.getState().context.activeSprintId).toBe('sp-known')
})
})
// ─────────────────────────────────────────────────────────────────────────
// Optimistic mutations
// ─────────────────────────────────────────────────────────────────────────
describe('optimistic mutations', () => {
it('rollback herstelt vorige sprint-story-order', () => {
useSprintWorkspaceStore.getState().hydrateSnapshot(
snapshotWith(
makeSprint({ id: 'sp-1', product_id: 'prod-1' }),
[
makeStory({ id: 'a', pbi_id: 'p', sprint_id: 'sp-1', sort_order: 1 }),
makeStory({ id: 'b', pbi_id: 'p', sprint_id: 'sp-1', sort_order: 2 }),
],
),
)
const prevOrder = [
...useSprintWorkspaceStore.getState().relations.storyIdsBySprint['sp-1'],
]
const id = useSprintWorkspaceStore.getState().applyOptimisticMutation({
kind: 'sprint-story-order',
sprintId: 'sp-1',
prevStoryIds: prevOrder,
})
useSprintWorkspaceStore.setState((s) => {
s.relations.storyIdsBySprint['sp-1'] = ['b', 'a']
})
useSprintWorkspaceStore.getState().rollbackMutation(id)
expect(useSprintWorkspaceStore.getState().relations.storyIdsBySprint['sp-1']).toEqual(
prevOrder,
)
expect(useSprintWorkspaceStore.getState().pendingMutations[id]).toBeUndefined()
})
it('settle ruimt pending op zonder state te wijzigen', () => {
useSprintWorkspaceStore.getState().hydrateSnapshot(
snapshotWith(makeSprint({ id: 'sp-1', product_id: 'prod-1' }), [
makeStory({ id: 'a', pbi_id: 'p', sprint_id: 'sp-1' }),
]),
)
const id = useSprintWorkspaceStore.getState().applyOptimisticMutation({
kind: 'sprint-story-order',
sprintId: 'sp-1',
prevStoryIds: ['a'],
})
expect(useSprintWorkspaceStore.getState().pendingMutations[id]).toBeDefined()
useSprintWorkspaceStore.getState().settleMutation(id)
expect(useSprintWorkspaceStore.getState().pendingMutations[id]).toBeUndefined()
expect(useSprintWorkspaceStore.getState().relations.storyIdsBySprint['sp-1']).toEqual([
'a',
])
})
it('SSE-echo van een al-bestaande sprint is idempotent', () => {
useSprintWorkspaceStore.setState((s) => {
s.context.activeProduct = { id: 'prod-1', name: 'P' }
})
useSprintWorkspaceStore
.getState()
.hydrateProductSprints('prod-1', [
makeSprint({ id: 'sp-1', product_id: 'prod-1', sprint_goal: 'Origineel' }),
])
useSprintWorkspaceStore.getState().applyRealtimeEvent({
entity: 'sprint',
op: 'I',
id: 'sp-1',
product_id: 'prod-1',
sprint_goal: 'echo',
})
expect(
useSprintWorkspaceStore.getState().entities.sprintsById['sp-1'].sprint_goal,
).toBe('Origineel')
})
})