Nazim Api Domain Types

Domain Types (types/domain/{resource}.ts)

• camelCase for all fields
• Nested structures (Address, Guardian[], etc.)
• Date objects for dates (not strings)
• Business logic types (Status enums)

export interface Student {
  id: string;
  organizationId: string;
  schoolId: string | null;
  admissionNumber: string;
  fullName: string;
  address: Address;
  guardians: Guardian[];
  createdAt: Date;
  updatedAt: Date;
}

Mapper (mappers/{resource}Mapper.ts)

• mapResourceApiToDomain(api: Api.Student): Student
• mapResourceDomainToInsert(domain: Partial<Student>): StudentInsert
• mapResourceDomainToUpdate(domain: Partial<Student>): StudentUpdate
• Handle nested: flatten for API, nest for Domain
• Convert dates: string ↔ Date

import type * as StudentApi from '@/types/api/student';
import type { Student } from '@/types/domain/student';

export function mapStudentApiToDomain(api: StudentApi.Student): Student { /* ... */ }
export function mapStudentDomainToInsert(domain: Partial<Student>): StudentApi.StudentInsert { /* ... */ }

Hooks

• Import API types: import type * as ResourceApi from '@/types/api/resource'
• Import Domain: import type { Resource } from '@/types/domain/resource'
• In queryFn: map API → Domain with mapResourceApiToDomain
• In mutations: map Domain → API with mapResourceDomainToInsert
• Re-export domain types: export type { Resource } from '@/types/domain/resource'

Components

• Use domain types only; never import API types
• Use camelCase properties: student.fullName, student.address.city
• Use Date objects for dates

New Module Checklist

1. Create types/api/{resource}.ts (snake_case, match Laravel)
2. Create types/domain/{resource}.ts (camelCase, nested)
3. Create mappers/{resource}Mapper.ts (bidirectional conversion)
4. Create hooks: map in queryFn, map in mutations, re-export domain
5. Components: import domain types only

Additional Resources

• Full mapper, hook, and component examples: examples.md