xpeditis2.0/apps/backend/src/domain/ports/out/blog-post.repository.ts

import { BlogPost, BlogPostCategory, BlogPostStatus } from '@domain/entities/blog-post.entity';

export const BLOG_POST_REPOSITORY = 'BlogPostRepository';

export interface BlogPostFilters {
  status?: BlogPostStatus;
  category?: BlogPostCategory;
  search?: string;
  isFeatured?: boolean;
  limit?: number;
  offset?: number;
  /** When true, also include SCHEDULED posts whose publishedAt <= now */
  includeScheduled?: boolean;
  /** When true, return only trashed posts; otherwise trashed posts are excluded. */
  trashed?: boolean;
}

export interface BlogPostRepository {
  save(post: BlogPost): Promise<BlogPost>;
  findById(id: string): Promise<BlogPost | null>;
  findBySlug(slug: string): Promise<BlogPost | null>;
  findByFilters(filters: BlogPostFilters): Promise<BlogPost[]>;
  count(filters: BlogPostFilters): Promise<number>;
  delete(id: string): Promise<void>;
  slugExists(slug: string, excludeId?: string): Promise<boolean>;
}