feat(adoptions): implement adoption listing and application flow with state management (#8)

Adds the complete adoption flow backend including:
- AdoptionListing and AdoptionApplication entities with full state machines
- Listing lifecycle: DRAFT -> ACTIVE -> PAUSED -> ADOPTED/WITHDRAWN
- Application lifecycle: SUBMITTED -> IN_REVIEW -> VISIT_SCHEDULED -> VISIT_COMPLETED -> APPROVED/REJECTED
- Publisher validation, max 3 active applications per user, cascading close on approval
- Push notifications via NotificationService for key events
- GraphQL resolvers, DTOs with class-validator, cursor pagination for listings
- New animal fields (size, ageCategory, isSterilized) and READY_FOR_ADOPTION status
- Unit tests for both services covering state transitions, validations, and cascades

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: lapc506

apps/backend/package.json

@@ -112,6 +112,9 @@
     ],
     "coverageDirectory": "../coverage",
     "testEnvironment": "node",
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.js$": "$1"
+    },
     "setupFilesAfterEnv": [
       "<rootDir>/../jest.setup.js"
     ]

apps/backend/src/adoptions/adoption-applications.resolver.ts

@@ -0,0 +1,99 @@
+import { Resolver, Query, Mutation, Args, ID } from '@nestjs/graphql';
+import { UseGuards } from '@nestjs/common';
+import { AdoptionApplication } from './entities/adoption-application.entity';
+import { AdoptionApplicationsService } from './adoption-applications.service';
+import { SubmitAdoptionApplicationInput } from './dto/submit-adoption-application.input';
+import { ApplicationStatus } from './enums/application-status.enum';
+import { JwtAuthGuard } from '../auth/jwt-auth.guard';
+import { GqlUser } from '../auth/gql-user.decorator';
+import { User } from '../users/entities/user.entity';
+
+@Resolver(() => AdoptionApplication)
+export class AdoptionApplicationsResolver {
+  constructor(
+    private readonly applicationsService: AdoptionApplicationsService,
+  ) {}
+
+  @Query(() => [AdoptionApplication], { name: 'adoptionApplications' })
+  @UseGuards(JwtAuthGuard)
+  async getAdoptionApplications(
+    @Args('listingId', { type: () => ID }) listingId: string,
+    @Args('status', { type: () => ApplicationStatus, nullable: true })
+    status?: ApplicationStatus,
+  ): Promise<AdoptionApplication[]> {
+    return this.applicationsService.findByListing(listingId, status);
+  }
+
+  @Query(() => [AdoptionApplication], { name: 'myAdoptionApplications' })
+  @UseGuards(JwtAuthGuard)
+  async getMyAdoptionApplications(
+    @GqlUser() user: User,
+  ): Promise<AdoptionApplication[]> {
+    return this.applicationsService.findMyApplications(user.id);
+  }
+
+  @Mutation(() => AdoptionApplication)
+  @UseGuards(JwtAuthGuard)
+  async submitAdoptionApplication(
+    @GqlUser() user: User,
+    @Args('input') input: SubmitAdoptionApplicationInput,
+  ): Promise<AdoptionApplication> {
+    return this.applicationsService.submit(input, user.id);
+  }
+
+  @Mutation(() => AdoptionApplication)
+  @UseGuards(JwtAuthGuard)
+  async reviewAdoptionApplication(
+    @GqlUser() user: User,
+    @Args('applicationId', { type: () => ID }) applicationId: string,
+  ): Promise<AdoptionApplication> {
+    return this.applicationsService.review(applicationId, user.id);
+  }
+
+  @Mutation(() => AdoptionApplication)
+  @UseGuards(JwtAuthGuard)
+  async scheduleVisit(
+    @GqlUser() user: User,
+    @Args('applicationId', { type: () => ID }) applicationId: string,
+    @Args('scheduledDate') scheduledDate: Date,
+  ): Promise<AdoptionApplication> {
+    return this.applicationsService.scheduleVisit(
+      applicationId,
+      user.id,
+      scheduledDate,
+    );
+  }
+
+  @Mutation(() => AdoptionApplication)
+  @UseGuards(JwtAuthGuard)
+  async completeVisit(
+    @GqlUser() user: User,
+    @Args('applicationId', { type: () => ID }) applicationId: string,
+    @Args('notes') notes: string,
+  ): Promise<AdoptionApplication> {
+    return this.applicationsService.completeVisit(
+      applicationId,
+      user.id,
+      notes,
+    );
+  }
+
+  @Mutation(() => AdoptionApplication)
+  @UseGuards(JwtAuthGuard)
+  async approveAdoptionApplication(
+    @GqlUser() user: User,
+    @Args('applicationId', { type: () => ID }) applicationId: string,
+  ): Promise<AdoptionApplication> {
+    return this.applicationsService.approve(applicationId, user.id);
+  }
+
+  @Mutation(() => AdoptionApplication)
+  @UseGuards(JwtAuthGuard)
+  async rejectAdoptionApplication(
+    @GqlUser() user: User,
+    @Args('applicationId', { type: () => ID }) applicationId: string,
+    @Args('reason') reason: string,
+  ): Promise<AdoptionApplication> {
+    return this.applicationsService.reject(applicationId, user.id, reason);
+  }
+}