import { AnalysisCleanupLease, AnalysisCleanupLeaseGroup, ArtifactReaderFailure, type ArtifactResourceScope, } from "../resources/index.js"; import type { WebScriptArtifactPort } from "../ports/WebScriptArtifactPort.js"; import { LocalWebScriptArtifacts } from "./assets/LocalWebScriptArtifacts.js"; import { AnalysisError } from "../domain/analysisErrorBase.js"; import { projectAnalysisError } from "../domain/analysisErrorProjection.js"; import { ProviderCleanupError } from "../domain/providerCleanupError.js"; import { errorMessage } from "../kernel/errorMessage.js"; type WebArtifactOwner = | "web-source-location-artifacts" | "web-module-artifacts"; const cleanupOwner = (resource: string, close: () => Promise) => { let retained: readonly string[] = [resource]; const lease = new AnalysisCleanupLease( async () => { try { await close(); } catch (cause: unknown) { if (cause instanceof AnalysisError) lease.bindCleanupError(cause); retained = cause instanceof AnalysisError && cause.cleanupResources.length > 0 ? cause.cleanupResources : ArtifactReaderFailure.cleanupObservation(cause, resource) .resources; throw cause; } }, { get cleanupResources() { return retained; }, }, ); return { resource, lease }; }; /** Retain each composed artifact owner's release across partial cleanup retries. */ export class WebArtifactCleanup { readonly #owners: readonly { readonly resource: string; readonly lease: AnalysisCleanupLease; }[]; readonly #operation: string; constructor( private readonly owner: WebArtifactOwner, resources: ArtifactResourceScope, scripts: WebScriptArtifactPort, ) { const sourceLocation = owner === "web-source-location-artifacts"; this.#operation = sourceLocation ? "trace_web_source_location" : "trace_web_module_imports"; const resource = sourceLocation ? "web source-location artifacts" : "web module artifacts"; const closeScript = scripts instanceof LocalWebScriptArtifacts && scripts.resources === resources ? undefined : scripts.close?.bind(scripts); this.#owners = [ cleanupOwner(resource, () => resources.close()), ...(closeScript === undefined ? [] : [cleanupOwner("web scripts", closeScript)]), ]; } async close(): Promise { const pending = this.#owners.filter(({ lease }) => !lease.released); const results = await Promise.allSettled( pending.map(({ lease }) => lease.release()), ); const failures = results.flatMap((result, index) => result.status === "rejected" ? [{ cause: result.reason as unknown, ...pending[index]! }] : [], ); const error = webArtifactCleanupFailures( this.owner, this.#operation, failures, ); if (error !== undefined) { new AnalysisCleanupLeaseGroup( error, failures.map(({ lease }) => lease), ); throw error; } } } const webArtifactCleanupFailures = ( owner: string, operation: string, failures: readonly { readonly resource: string; readonly cause: unknown }[], ): ProviderCleanupError | undefined => { if (failures.length === 0) return undefined; const normalized = failures.map(({ resource, cause }) => { if (cause instanceof AnalysisError) { const projection = projectAnalysisError(cause); return { cause, projection, observation: { reason: projection.message, resources: cause.cleanupResources.length === 0 ? [resource] : cause.cleanupResources, }, }; } return { cause, projection: undefined, observation: ArtifactReaderFailure.cleanupObservation(cause, resource), }; }); const recoveryActions = [ ...new Set( normalized.flatMap(({ projection }) => projection === undefined ? [] : [projection.remediation.action], ), ), ]; return new ProviderCleanupError( owner, [ ...new Set( normalized.flatMap(({ observation }) => observation.resources), ), ], { reason: normalized .map(({ observation }) => observation.reason) .join("; "), failures: normalized.map(({ cause, projection, observation }) => projection !== undefined ? projection : { name: cause instanceof Error ? cause.name : "UnknownError", message: errorMessage(cause), resource: [...observation.resources], }, ), }, { cause: normalized.length === 1 ? normalized[0]!.cause : new AggregateError( normalized.map(({ cause }) => cause), `${owner} cleanup failed`, ), operation, ...(recoveryActions.length === 0 ? {} : { remediationAction: recoveryActions.join("; ") }), }, ); };