Files
Enterprise-Knowledge-Base/frontend/src/stores/versionedRequest.ts
T
2026-07-24 10:40:33 +08:00

91 lines
2.4 KiB
TypeScript

export interface VersionedRequestCoordinator<T> {
fetch: (force?: boolean) => Promise<void>
invalidate: () => void
hasInFlightRequest: () => boolean
}
/**
* Coordinates cached reads that also need a reliable "force refresh" mode.
*
* A forced read requested while another read is running is queued after the
* current request. Invalidating the coordinator also prevents an older
* response from overwriting state changed by a newer write.
*/
export function createVersionedRequestCoordinator<T>(
request: () => Promise<T>,
apply: (value: T) => void
): VersionedRequestCoordinator<T> {
let revision = 0
let startedSequence = 0
let completedSequence = 0
let forceTargetSequence = 0
let inFlight: Promise<void> | null = null
let forceQueue: Promise<void> | null = null
const start = (): Promise<void> => {
const requestRevision = revision
const sequence = ++startedSequence
const current = (async () => {
const value = await request()
if (requestRevision === revision) {
apply(value)
}
})()
inFlight = current
void current.then(
() => {
completedSequence = Math.max(completedSequence, sequence)
if (inFlight === current) inFlight = null
},
() => {
completedSequence = Math.max(completedSequence, sequence)
if (inFlight === current) inFlight = null
}
)
return current
}
const fetch = (force = false): Promise<void> => {
if (!inFlight) return start()
if (!force) return inFlight
// A force call always requires at least one request newer than the one
// that was in flight when force was requested.
forceTargetSequence = Math.max(forceTargetSequence, startedSequence + 1)
if (!forceQueue) {
const queued = (async () => {
while (completedSequence < forceTargetSequence) {
if (inFlight) {
try {
await inFlight
} catch {
// The queued forced request must still run after a failed read.
}
} else {
await start()
}
}
})()
forceQueue = queued
void queued.then(
() => {
if (forceQueue === queued) forceQueue = null
},
() => {
if (forceQueue === queued) forceQueue = null
}
)
}
return forceQueue
}
return {
fetch,
invalidate: () => {
revision += 1
},
hasInFlightRequest: () => inFlight !== null
}
}