import type { ParsedDoc, NavItem, ResolvedHierarchy, DocSource } from './types.js';
type RemoteFolder = {
    id: string;
    name: string;
    slug: string;
    icon?: string;
    is_default?: boolean;
    display_order?: number;
};
type RemoteCategory = {
    id: string;
    name: string;
    icon?: string;
    description?: string;
    folder_id?: string;
    parent_category_id?: string;
    display_order?: number;
    slug?: string;
};
export declare class GatelyAPI {
    private readonly baseUrl;
    private readonly apiKey;
    private projectId?;
    constructor(baseUrl: string, apiKey: string);
    /**
     * Auto-detect project ID from API key via /api/cli/whoami.
     * Caches the result after first call.
     */
    getProjectId(): Promise<string>;
    private request;
    private foldersCache;
    listFolders(): Promise<RemoteFolder[]>;
    createFolder(item: NavItem): Promise<RemoteFolder>;
    updateFolder(id: string, item: Partial<NavItem>): Promise<void>;
    /**
     * Resolve a folder by name — create if missing, update fields if changed.
     * Returns the folder ID.
     */
    resolveFolder(raw: string | NavItem): Promise<string>;
    private categoriesCache;
    listCategories(): Promise<RemoteCategory[]>;
    private invalidateCategoriesCache;
    createCategory(item: NavItem, folderId?: string, parentCategoryId?: string): Promise<RemoteCategory>;
    updateCategory(id: string, item: Partial<NavItem>, folderId?: string, parentCategoryId?: string): Promise<void>;
    /**
     * Resolve the full Folder → Category → Subcategory hierarchy for a doc source.
     * Creates missing items, updates icons if changed.
     * Uses a per-push cache that is invalidated after any creation to avoid stale lookups.
     */
    resolveHierarchy(source: DocSource): Promise<ResolvedHierarchy>;
    listArticles(): Promise<Array<{
        id: string;
        slug: string;
        title: string;
        category_id?: string | null;
    }>>;
    getArticle(articleId: string): Promise<any>;
    createArticle(doc: ParsedDoc, categoryId?: string): Promise<{
        id: string;
        slug: string;
    }>;
    updateArticle(id: string, doc: ParsedDoc, categoryId?: string): Promise<void>;
    uploadOpenApi(specContent: string, filename: string): Promise<void>;
    syncDoc(doc: ParsedDoc, existing: Array<{
        id: string;
        slug: string;
    }>, categoryId?: string): Promise<{
        action: 'created' | 'updated';
        articleId: string;
        title: string;
        slug: string;
    }>;
    deleteCategory(id: string): Promise<void>;
    /**
     * Clean up categories that are no longer referenced in the config.
     * Only deletes categories with no articles.
     */
    cleanupUnusedCategories(usedCategoryNames: Set<string>): Promise<string[]>;
    deleteArticle(id: string): Promise<void>;
    uncategorizeArticle(id: string): Promise<void>;
    deleteArticlesBySlugs(slugs: string[]): Promise<{
        deleted: string[];
        notFound: string[];
    }>;
    uncategorizeArticlesBySlugs(slugs: string[]): Promise<{
        uncategorized: string[];
        notFound: string[];
    }>;
}
export {};