Files
MikrotikManager/backend/src/services/server-poll-boundary.ts
T

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)
}