feat(adoptions): add role-based adoption listing endpoint

[anoncon]

Description

Implements GET /adoptions with role-based visibility and optional filters.

• USER sees only their own adoption requests (adopterId = currentUserId)
• SHELTER sees requests for pets they own (pet.currentOwnerId = currentUserId)
• ADMIN sees all adoption requests
• Supports optional query filters:
  • status (e.g. PENDING)
  • petId
• Orders results by newest first (createdAt desc)
• Returns response as { data: [...] } with:
  • adoption fields (id, status, reason, createdAt)
  • pet fields (id, name, species, imageUrl, images)
  • user fields (id, name, email) without sensitive fields
• Added Swagger docs for auth + query params
• Added unit tests for role filtering, optional filters, empty result, and invalid role handling

Files Changed

• src/adoption/adoption.controller.ts
• src/adoption/adoption.module.ts
• src/adoption/adoption.service.ts
• src/adoption/dto/filter-adoptions.dto.ts
• src/adoption/adoption.service.spec.ts

Notes

• GET /adoptions is protected by JwtAuthGuard
• Empty results return [] inside data (not 404)

Closes #21

[anoncon]

@amina69 please review my PR

[amina69]

@anoncon , kindly resolve the little conflict

[anoncon]

@amina69 it is possible to merge it i resolve the conflicts

[amina69]

@anoncon , yes no conflict, but the cicd pipeline failed, i cant merge, kindly check