import { z } from "zod";
import type { StorageClient } from "../storage/client.js";
export declare function versionPath(name: string, ts: string): string;
/**
 * Saves a snapshot before overwrite. Fire-and-forget — never throws.
 *
 * @param authorSubject Actor performing the write that triggered this
 *   snapshot (GH #498) — recorded in the snapshot's frontmatter so
 *   read_page_version can report who was responsible for this version.
 */
export declare function snapshotPage(drive: StorageClient, name: string, content: string, authorSubject?: string): Promise<void>;
export declare const listPageHistoryInputSchema: z.ZodObject<{
    name: z.ZodString;
}, "strip", z.ZodTypeAny, {
    name: string;
}, {
    name: string;
}>;
export type ListPageHistoryInput = z.infer<typeof listPageHistoryInputSchema>;
export interface VersionEntry {
    path: string;
    timestamp: string;
    size: number;
    modifiedTime: string;
}
export declare function listPageHistory(drive: StorageClient, input: ListPageHistoryInput): Promise<{
    name: string;
    versions: VersionEntry[];
}>;
export declare const readPageVersionInputSchema: z.ZodObject<{
    name: z.ZodString;
    timestamp: z.ZodString;
}, "strip", z.ZodTypeAny, {
    name: string;
    timestamp: string;
}, {
    name: string;
    timestamp: string;
}>;
export type ReadPageVersionInput = z.infer<typeof readPageVersionInputSchema>;
export declare function readPageVersion(drive: StorageClient, input: ReadPageVersionInput): Promise<object>;
//# sourceMappingURL=pageHistory.d.ts.map