import type { ConfluencePage, ConfluenceFolder, ConfluenceSpace, AdfDocument, AttachmentUploadResult } from "./types.js";
/** HTTP client for the Confluence Cloud REST API v2. */
export declare class ConfluenceClient {
    private apiBase;
    private v1ApiBase;
    private authHeader;
    constructor(baseUrl: string, email: string, token: string);
    private request;
    /** Verifies that the configured credentials can reach the Confluence API. */
    checkAccess(): Promise<void>;
    /** Fetches a page by its numeric ID, including ADF body. */
    getPage(pageId: string): Promise<ConfluencePage>;
    /** Fetches a folder by its numeric ID. */
    getFolder(folderId: string): Promise<ConfluenceFolder>;
    /** Fetches a space by its key (e.g. "ENG"). Throws if not found. */
    getSpace(spaceKey: string): Promise<ConfluenceSpace>;
    /** Searches for a page by title within a space. Returns null if not found. */
    findPageByTitle(spaceId: string, title: string): Promise<ConfluencePage | null>;
    /** Creates a new page in a space, optionally as a child of a parent page. */
    createPage(spaceId: string, title: string, adfBody: AdfDocument, parentId?: string): Promise<ConfluencePage>;
    /** Updates an existing page with new content, incrementing the version number. */
    updatePage(pageId: string, title: string, adfBody: AdfDocument, versionNumber: number, versionMessage?: string): Promise<ConfluencePage>;
    /** Lists child pages of a given parent page. */
    getPageChildren(pageId: string): Promise<ConfluencePage[]>;
    /** Gets the current version number for a page. */
    getPageVersion(pageId: string): Promise<number>;
    /**
     * Uploads a file attachment to a Confluence page via the REST API v1.
     * If the attachment already exists (HTTP 400), it updates the existing one.
     */
    uploadAttachment(pageId: string, filename: string, buffer: Buffer): Promise<AttachmentUploadResult>;
    private updateExistingAttachment;
}
//# sourceMappingURL=confluence.d.ts.map