Client API

interface Post {
    title: string;
    slug: string;                 // canonical React key — use post.slug, NOT post.id
    excerpt: string;
    content?: string;             // HTML (only on single post)
    publishedAt: string;          // ISO-8601
    seoTitle?: string;
    seoDescription?: string;
    featuredImageUrl?: string | null;
    category?: Category | null;
    tags?: Tag[];
    author?: Author | null;
    readingTime?: number;         // Estimated minutes; computed client-side if missing
}

interface Category {
    name: string;
    slug: string;
    postCount?: number;  // Number of published posts
}

interface Tag {
    name: string;
    slug: string;
    postCount?: number;  // Number of published posts
}

interface Author {
    name: string;            // Display name
    slug?: string;           // URL-safe identifier (for /authors/:slug pages)
    avatarUrl?: string;      // Absolute URL to a 1:1 avatar
    bio?: string;            // Short plain-text bio
    url?: string;            // Website or profile URL
}

interface ListParams {
    page?: number;                                  // default: 1
    limit?: number;                                 // default: 10, max: 100
    category?: string | string[];                   // slug, or array for OR-match
    tag?: string | string[];                        // slug, or array for OR-match
    search?: string;                                // search title & excerpt
    sort?: "publishedAt" | "title" | "createdAt";   // default: "publishedAt"
    order?: "asc" | "desc";                         // default: "desc"
}

interface ArchiveGroup {
    year: number;
    month: number;       // 1–12
    monthName: string;   // "January", "February", ...
    posts: Post[];
    count: number;
}

interface ArchiveResult {
    groups: ArchiveGroup[]; // Sorted newest first
    totalPosts: number;     // Across all groups
}

interface NeighborsResult {
    previous: Post | null; // Older adjacent post
    next:     Post | null; // Newer adjacent post
}

interface PaginatedResponse<T> {
    data: T[];
    meta: {
        page: number;
        limit: number;
        total: number;
        totalPages: number;
    };
}

interface VloziConfig {
    apiKey: string;   // Your public API key
    baseUrl: string;  // Your gateway URL
}