Struct ResourceCollection 

pub struct ResourceCollection<T: Resource> { /* private fields */ }

A collection of resources with optional pagination metadata.

Wraps Vec<T: Resource> and produces the standard JSON envelope:

• Without pagination: {"data": [...]}
• With pagination: {"data": [...], "meta": {...}, "links": {...}}

Example

use ferro::{Resource, ResourceCollection, PaginationMeta};

let resources: Vec<UserResource> = users.into_iter()
    .map(UserResource::from)
    .collect();

// Without pagination
let collection = ResourceCollection::new(resources);
Ok(collection.to_response(&req))

// With pagination
let meta = PaginationMeta::new(page, per_page, total);
let collection = ResourceCollection::paginated(resources, meta);
Ok(collection.to_response(&req))

Implementations

impl<T: Resource> ResourceCollection<T>

pub fn new(items: Vec<T>) -> Self

Create a collection without pagination.

pub fn paginated(items: Vec<T>, meta: PaginationMeta) -> Self

Create a collection with pagination metadata.

pub fn additional(self, value: Value) -> Self

Add extra top-level fields merged alongside data/meta/links.

pub fn to_response(&self, req: &Request) -> HttpResponse

Produce the JSON response.

• Without pagination: {"data": [...]}
• With pagination: {"data": [...], "meta": {...}, "links": {...}}
• With additional: merges additional fields at top level