Files
hapi/web/scripts/fixtures/sse/apply.ts
T
weishu e1bfdd6265 feat(fixtures): SSE patch + pagination scenario fixtures (K7)
Two new golden-fixture suites, expectations machine-generated from the web
implementation (same source-of-truth principle as the chat suite):

- shared/fixtures/sse/ (12 cases): session-updated versioned-patch
  application via applySessionDetailPatch — strict version gates for
  metadata/agentState/todos/teamState, out-of-order arrival, teamState:null
  clear, max-monotonic updatedAt, flat last-write-wins fields, sub-minute
  activeAt keep-alive drop, scratchlistUpdatedAt trigger, and the pinned
  actual behavior that activeTurnStartedAt is NOT applied by the patch path.
  Inputs are stored schema-normalized and validated against SessionSchema /
  strict SessionPatchSchema at generation time; per-patch applied/unchanged
  verdicts are part of the contract.

- shared/fixtures/pagination/ (11 cases): op scripts driving the real
  message-window store with a scripted ApiClient — latest page + SSE ingest,
  before-cursor older pages, epoch-mismatch reset (window discard + recorded
  internal latest request), reset:true replace preserving optimistic rows,
  localId echo reconciliation, messages-consumed invokedAt stamping (no
  cursor advance), message-cancelled removal, cancel-too-late invoked-row
  ingest, hidden-row cursor advance, 400-row trim preserving queued rows,
  and queued-state gap recovery. Documents pin the exact requests the store
  issued, older-load outcomes, reconcile candidates, and a minimal window
  projection (ids/order, queued/optimistic flags, hasMore, epoch, viewMode,
  compound cursors).

Generator: web/scripts/fixtures/{sse,pagination}/ extend the K5 framework
(canonical serialization reused; suites pruned of stale files). Web
self-conformance tests replay every fixture against the real implementation
in bun run test:web. README documents schemas, projections, replay
contracts, and native consumption for both suites.

No time injection needed: the store's only Date.now() reads gate
notification throttling, which never reaches persisted or projected state.
2026-08-17 12:06:57 +08:00

24 lines
1018 B
TypeScript

import { applySessionDetailPatch } from '@/lib/sessionPatch'
import type { Session, SessionPatch } from '@/types/api'
import type { SessionPatchResult } from './types'
/**
* The exact fold a client must implement for `session-updated` patches on a
* detail session cache: apply patches in arrival order; a `null` return means
* "nothing changed, keep the previous object". Shared by the fixture
* generator and the self-conformance vitest so the two can never diverge.
*/
export function runSessionPatchScript(
initialSession: Session,
patches: SessionPatch[]
): { expectedPatchResults: SessionPatchResult[]; expectedSession: Session } {
let session = initialSession
const expectedPatchResults: SessionPatchResult[] = []
for (const patch of patches) {
const next = applySessionDetailPatch(session, patch)
expectedPatchResults.push(next === null ? 'unchanged' : 'applied')
session = next ?? session
}
return { expectedPatchResults, expectedSession: session }
}