export function settings( lab: number, env: Record = {}, ) { if (lab !== 3 && lab !== 4) throw new Error("Only labs3 and4 use this runtime"); const cluster = env.VP_CLUSTER ?? `vp-lab${lab}-medvedev`, port = Number(env.PUBLIC_PORT ?? 28200 + lab); if (!new RegExp(`^vp-lab${lab}-(medvedev|r-[a-f0-9]{8})$`).test(cluster)) throw new Error("Unapproved cluster name"); if (!Number.isInteger(port) || port < 1024 || port > 65535) throw new Error("Invalid public port"); return { lab, cluster, port, namespace: "messenger" }; } export function assertOwned(receipt: any, actual: any, expected: any): void { if ( !receipt || receipt.lab !== expected.lab || receipt.cluster !== expected.cluster || !receipt.container || receipt.container !== actual.container || !receipt.namespaceUID || receipt.namespaceUID !== actual.namespaceUID ) throw new Error("Cluster or namespace ownership guard failed"); } export function guardedOperator( expected: any, ports: { receipt: () => Promise; actual: () => Promise; dispatch: (action: string) => Promise; }, ) { return { async run(action: string) { const [receipt, actual] = await Promise.all([ ports.receipt(), ports.actual(), ]); assertOwned(receipt, actual, expected); return ports.dispatch(action); }, }; } export function pinnedConfigID(image: any, source: string): string { const [tagged, digest] = source.split("@"); const repository = tagged.replace(/:[^/:]+$/, ""); if ( !digest || !image?.Id || !image.RepoDigests?.some( (ref: string) => ref.replace(/^docker\.io\//, "").replace(/^library\//, "") === repository + "@" + digest, ) ) throw new Error("Pinned manifest identity differs"); return image.Id; } export function assertScopedArgs(args: string[]): void { const end = args.indexOf("--"), flags = end < 0 ? args : args.slice(0, end); if (end >= 0 && args[0] !== "exec") throw new Error("Only exec accepts an application command delimiter"); if ( flags.some((x) => /^(-A$|-n|-s|--(?:all-namespaces|namespace|context|kubeconfig|server|token|user|cluster|as|as-group|raw)(?:=|$))/.test( x, ), ) ) throw new Error("Target override rejected"); const allowed = /^(pods?|deployments?|deploy|jobs?|services?|svc|persistentvolumeclaims?|pvc|configmaps?|events?)(\/[^,]+)?$/; if ( ![ "get", "exec", "logs", "rollout", "scale", "annotate", "wait", "top", ].includes(args[0]) ) throw new Error("Unsupported scoped verb"); const resource = args[0] === "rollout" ? args[2] : ["wait", "exec"].includes(args[0]) ? flags.find((x) => allowed.test(x)) : args[1]; if (!resource || !resource.split(",").every((x) => allowed.test(x))) throw new Error("Only approved namespaced resources are supported"); if ( flags.some( (x) => (!x.startsWith("-") && x.includes("/") && !allowed.test(x)) || /^(?:-f|--filename|-k|--kustomize)(?:=|$)/.test(x), ) ) throw new Error("Additional resource override rejected"); } export function assertNoGame(code: number) { if (code !== 1) throw new Error( "Measurement requires an inactive game with confirmed status", ); } export function assertPartialClaim(receipt: any, server: any, expected: any) { if ( receipt?.state !== "claimed" || receipt.lab !== expected.lab || receipt.cluster !== expected.cluster || !receipt.nonce || server.owner !== receipt.nonce || !server.container || (receipt.container && receipt.container !== server.container) ) throw new Error("Partial cluster claim differs"); } export function assertNoRunningContainers( containers: any[], podUID: string, ): void { if (containers.some((c) => c.labels?.["io.kubernetes.pod.uid"] === podUID)) throw new Error("A victim Pod process is still running"); } export async function withCleanup(ports: { perform: () => Promise; cleanup: () => Promise; }): Promise { let result!: T; let failure: unknown; let failed = false; try { result = await ports.perform(); } catch (error) { failure = error; failed = true; } try { await ports.cleanup(); } catch (error) { if (failed) throw new AggregateError( [failure, error], (failure instanceof Error ? failure.message : "Operation failed") + "; cleanup failed", { cause: failure }, ); throw error; } if (failed) throw failure; return result; } export function assertImageBudget( lab: number, mib: number, soft: string, ): void { if (lab === 4 && (mib !== 2048 || soft !== "1536MiB")) throw new Error("Lab4 requires its verified 2Gi/1536MiB decoder budget"); }