import type { PreparedMetalProject } from "./prepare-project.js"; import { type InterruptedMetalPublication, type MetalPublicationPlan } from "./publication-recovery.js"; type ArtifactRole = "package-manifest" | "swift-source" | "metal-library" | "output-record"; export interface MetalPublicationStagedFile { readonly role: ArtifactRole; readonly path: string; readonly length: number; readonly sha256: string; } export interface PreparedMetalPublicationStage { readonly schemaVersion: 1; readonly kind: "prepared"; readonly transactionId: string; readonly parent: { readonly device: string; readonly inode: string; }; readonly destinationName: string; readonly moduleName: string; readonly stage: { readonly name: string; readonly device: string; readonly inode: string; }; readonly recordSHA256: string; readonly files: readonly MetalPublicationStagedFile[]; /** Inspection-only nominal path valid while the callback and helper remain active. */ readonly stagePath: string; /** Inspection-only nominal path valid while the callback and helper remain active. */ readonly journalPath: string; } export interface PreparedMetalPublicationStageInput { readonly prepared: PreparedMetalProject; readonly environment?: NodeJS.ProcessEnv; readonly signal?: AbortSignal; } export declare class MetalPublicationStagingError extends Error { readonly code: "invalid-preparation" | "busy" | "conflict" | "interrupted-transaction" | "unsafe-parent" | "unsafe-name" | "unsupported-filesystem" | "parent-changed" | "helper-failed" | "cancelled" | "cleanup-failed"; /** Nominal locations that may require inspection; never cleanup authority. */ readonly recoveryPaths: readonly string[]; constructor(code: "invalid-preparation" | "busy" | "conflict" | "interrupted-transaction" | "unsafe-parent" | "unsafe-name" | "unsupported-filesystem" | "parent-changed" | "helper-failed" | "cancelled" | "cleanup-failed", message: string, options?: ErrorOptions & { readonly recoveryPaths?: readonly string[]; }); } export declare class MetalPublicationInterruptedError extends MetalPublicationStagingError { readonly transaction: InterruptedMetalPublication; constructor(transaction: InterruptedMetalPublication, recoveryPaths: readonly string[]); } export declare class MetalPublicationStagingCleanupError extends MetalPublicationStagingError { readonly errors: readonly unknown[]; constructor(errors: readonly unknown[], recoveryPaths: readonly string[]); } export type MetalPublicationOutcome = "not-published" | "unknown" | "published"; export interface PublishedMetalPublication { readonly schemaVersion: 1; readonly kind: "published"; readonly outcome: "published"; readonly confirmation: "acknowledged" | "reconciled"; readonly transactionId: string; readonly parent: PreparedMetalPublicationStage["parent"]; readonly destinationName: string; readonly output: PreparedMetalPublicationStage["parent"]; readonly recordSHA256: string; readonly outputPath: string; } interface PublicationState { outcome: MetalPublicationOutcome; prepared?: PreparedMetalPublicationStage; publication?: MetalPublicationPlan; receipt?: PublishedMetalPublication; finalized: boolean; recoveryPaths?: readonly string[]; } export declare class MetalPublicationError extends MetalPublicationStagingError { readonly outcome: MetalPublicationOutcome; readonly receipt?: PublishedMetalPublication; constructor(state: PublicationState, cause: unknown); } /** * Materialize and verify one prepared generation without publishing it. * Mutable prepared bytes and caller options are copied and validated synchronously. * The callback must cooperate with input.signal and settle before the lock is released. */ export declare function withPreparedMetalPublicationStage(input: PreparedMetalPublicationStageInput, callback: (receipt: PreparedMetalPublicationStage) => Promise): Promise; /** Private publisher for missing, ordinary empty, or verified same-owner outputs. */ export declare function publishPreparedMetalOutput(input: PreparedMetalPublicationStageInput): Promise; export {}; //# sourceMappingURL=publication-staging.d.ts.map