51 lines
3.5 KiB
TypeScript
51 lines
3.5 KiB
TypeScript
/** Session-private composition of complete authority checks. Only immutable
|
|
* scope/deadline requirements are merged; EVERY invocation obtains a new grant.
|
|
* The WeakMap brand cannot be supplied by a request or copied across sessions. */
|
|
import type { ServerPollDependencies,ServerPollRequest } from "./server-poll-execution.js"
|
|
import { pollProblem } from "./server-poll-execution-model.js"
|
|
|
|
export interface PollBoundaryOptions {signal?:AbortSignal;deadlineAt:number}
|
|
export type PollBoundaryFence=()=>Promise<void>
|
|
export interface ServerPollBoundaryCoordinator {
|
|
fence(ids:readonly number[],expectedProof:string,options:PollBoundaryOptions,check?:()=>void):PollBoundaryFence
|
|
combine(fences:readonly PollBoundaryFence[],ids:readonly number[],options:PollBoundaryOptions):PollBoundaryFence|undefined
|
|
owns(fence:PollBoundaryFence):boolean
|
|
}
|
|
interface Requirement {ids:readonly number[];proof:string;options:PollBoundaryOptions;check?:()=>void}
|
|
export function createServerPollBoundaryCoordinator(provider:ServerPollDependencies["authorize"],rawRequest:ServerPollRequest,now=Date.now):ServerPollBoundaryCoordinator{
|
|
const request=Object.freeze(structuredClone(rawRequest)),authorize=provider,clock=now,owned=new WeakMap<PollBoundaryFence,readonly Requirement[]>()
|
|
const fail=(code:"PERMISSION_DENIED"|"STATE_CONFLICT"|"ABORTED"="STATE_CONFLICT"):never=>{throw pollProblem(code,"Допуск границы полного poll изменился или истёк")}
|
|
const ids=(values:readonly number[])=>{
|
|
const result=[...new Set([request.serverId,...values])].sort((a,b)=>a-b)
|
|
if(result.length>1000||result.some(id=>!Number.isSafeInteger(id)||id<=0))fail()
|
|
return Object.freeze(result)
|
|
}
|
|
const local=(requirements:readonly Requirement[])=>{for(const item of requirements){item.options.signal?.throwIfAborted();if(clock()>=item.options.deadlineAt)fail("ABORTED");if(item.check?.()!==undefined)fail()}}
|
|
const create=(requirements:readonly Requirement[]):PollBoundaryFence=>{
|
|
if(!requirements.length||requirements.some(item=>!Number.isSafeInteger(item.options.deadlineAt)||!/^[a-f0-9]{64}$/.test(item.proof)))fail()
|
|
const captured=Object.freeze(requirements.map(item=>Object.freeze({ids:ids(item.ids),proof:item.proof,check:item.check,options:Object.freeze({signal:item.options.signal,deadlineAt:item.options.deadlineAt})})))
|
|
if(new Set(captured.map(item=>item.proof)).size!==1)fail()
|
|
const required=ids(captured.flatMap(item=>[...item.ids]))
|
|
const signals=[...new Set(captured.flatMap(item=>item.options.signal?[item.options.signal]:[]))]
|
|
const signal=signals.length?AbortSignal.any(signals):undefined
|
|
const fence:PollBoundaryFence=async()=>{
|
|
local(captured)
|
|
const grant=await authorize({...request},[...required],signal)
|
|
local(captured)
|
|
if(!grant.global||!Array.isArray(grant.serverIds)||required.some(id=>!grant.serverIds.includes(id)))fail("PERMISSION_DENIED")
|
|
if(grant.authorityProof!==captured[0].proof)fail()
|
|
}
|
|
owned.set(fence,captured);return fence
|
|
}
|
|
const coordinator:ServerPollBoundaryCoordinator={
|
|
fence:(selected,proof,options,check)=>create([{ids:ids(selected),proof,options,check}]),
|
|
combine(fences,selected,options){
|
|
if(!fences.length||fences.some(fence=>!owned.has(fence)))return undefined
|
|
const requirements=fences.flatMap(fence=>[...owned.get(fence)!])
|
|
return create([...requirements,{ids:ids(selected),proof:requirements[0].proof,options}])
|
|
},
|
|
owns:fence=>owned.has(fence),
|
|
}
|
|
return Object.freeze(coordinator)
|
|
}
|