import { type ConfigurationDocument } from "./configuration-document.js";
export interface ConfigurationFileSnapshot {
    revision: string;
    document: ConfigurationDocument;
}
export interface ConfigurationRawSnapshot {
    revision: string;
    bytes: Buffer;
}
export type ConfigurationFileInspection = ({
    state: "ready";
} & ConfigurationFileSnapshot) | {
    state: "damaged";
    revision: string;
    reason: "INVALID_YAML";
};
/** 管理域唯一配置文件写入器。replace/replaceRaw 必须持有工作区锁及生命周期串行入口。 */
export declare class ConfigurationFile {
    private readonly file;
    constructor(file: string);
    inspect(): ConfigurationFileInspection;
    read(): ConfigurationFileSnapshot;
    /** 仅管理域读取；不得把这个返回值作为 Web 快照。 */
    readRaw(): ConfigurationRawSnapshot;
    serialize(document: unknown): Buffer;
    replace(expectedRevision: string, document: unknown): ConfigurationFileSnapshot;
    /** 恢复原始坏 YAML 使用此入口；不解析或重写原始字节，不绕过 CAS。 */
    replaceRaw(expectedRevision: string, bytes: Uint8Array): ConfigurationRawSnapshot;
}
//# sourceMappingURL=configuration-file.d.ts.map