import { type BlogsConfigType } from './blog_config.js';
import type { BlogPost, FetchPostOptions, FetchPostsOptions, BlogApiResponse, DocsResponse } from '../types/types.js';
/**
 * Primary API client for fetching blog content from LeafPad.
 *
 * Handles HTTP requests with timeout, automatic retries (exponential backoff),
 * and structured error reporting via `BlogApiError`.
 *
 * @example
 * ```ts
 * const blogs = new BlogsService('my-org-slug');
 * const { posts } = await blogs.fetchPosts({ limit: 10 });
 * const post = await blogs.fetchBlog('my-post-slug');
 * const { items } = await blogs.fetchDocs();
 * ```
 */
export declare class BlogsService {
    private config;
    /**
     * @param organizationSlug - Your organization's unique slug from LeafPad.
     * @param blogsConfig - Optional overrides for default configuration values.
     */
    constructor(organizationSlug: string, blogsConfig?: BlogsConfigType);
    /**
     * Build the API URL for blog posts
     */
    private buildUrl;
    private makeRequest;
    private fetchItems;
    /**
     * Fetch documentation posts structured as a hierarchical tree.
     *
     * Posts with a `parentId` are nested inside their parent's `children` array.
     * All levels are sorted by the `position` field (string compare), falling back to `id`.
     *
     * @param options - Same options as fetchPosts (excluding `docs`, which is forced to `true`)
     * @returns Hierarchical `DocItem[]` tree suitable for sidebar rendering
     */
    fetchDocs(options?: FetchPostsOptions): Promise<DocsResponse>;
    /**
     * Fetch a paginated list of published blog posts.
     *
     * @param options.page - Page number (default: 1)
     * @param options.limit - Posts per page (default: config.defaultLimit)
     * @param options.includeHtml - Include pre-rendered HTML content (default: true)
     * @param options.md - Include raw Markdown content (default: false)
     * @param options.tags - Filter by tag names
     * @param options.search - Full-text search query
     * @returns posts[], pagination metadata, and organization info
     */
    fetchPosts(options?: FetchPostsOptions): Promise<BlogApiResponse>;
    /**
     * Fetch a single blog post by its URL slug.
     *
     * @param slug - The post's URL slug (e.g. 'getting-started')
     * @param options.includeHtml - Include pre-rendered HTML content (default: true)
     * @param options.md - Include raw Markdown content (default: false)
     * @returns The `BlogPost` object, or `null` if not found (404)
     * @throws {BlogApiError} On network errors, timeouts, or non-404 HTTP errors
     */
    fetchBlog(slug: string, options?: FetchPostOptions): Promise<BlogPost | null>;
}
//# sourceMappingURL=blogs.d.ts.map