REST API Layer

// lib/apps/blog/views.dart - DRF-style ViewSet
import 'package:bloom_cache/bloom_cache.dart';
import 'package:bloom_db/bloom_db.dart';
import 'package:bloom_framework/bloom_server.dart';
import 'package:bloom_rest/bloom_rest.dart';
import 'models.dart';

void registerBlogApi(BloomApiRouter router, DbExecutor db, BloomCache cache) {
  // 1. Configure Model Serializer with FieldSet visibility rules
  final serializer = BloomModelSerializer<Article>(
    meta: Article.meta,
    fields: BloomFieldSet.all().withReadOnly(['id', 'createdAt']),
  );

  // 2. Configure ViewSet options
  final options = BloomViewSetOptions<Article>(
    serializer: serializer,
    config: const BloomViewSetConfig(
      filterableFields: ['status'],
      orderableFields: ['createdAt', 'title', 'id'],
      defaultPageSize: 20,
    ),
    pagination: const PageNumberPagination(
      defaultPageSize: 20,
      maxPageSize: 100,
    ),
    // Composed permissions
    permission: const IsAuthenticated().and(const IsStaff()),
    // Cache-backed throttling
    throttle: BloomThrottle.fromRate(
      scope: 'articles_api',
      rate: '100/hour',
      cache: cache,
    ),
    filterBackends: [
      const BloomSearchFilter<Article>(['title', 'content']),
      const BloomOrderingFilter<Article>(['createdAt', 'title']),
    ],
  );

  // 3. Mount CRUD routes onto BloomApiRouter in a single call
  mountViewSet<Article>(
    router: router,
    basePath: '/api/articles',
    meta: Article.meta,
    fromRow: Article.fromRow,
    getDb: (req) => db,
    options: options,
  );
}