Leave Types API Documentation

// GetLeaveTypes retrieves all active leave types for an organization
GetLeaveTypes(ctx context.Context, orgID string) ([]*domain.LeaveType, error)

type LeaveQueryService struct {
    requestQueryRepo ports.LeaveQueryRepository
    balanceQueryRepo ports.LeaveBalanceQueryRepository
    leaveTypeRepo    ports.LeaveTypeRepository  // NEW
    logger           *logger.Logger
}

func (s *LeaveQueryService) GetLeaveTypes(ctx context.Context, orgID string) ([]*domain.LeaveType, error) {
    // Try to get organization-specific leave types first
    leaveTypes, err := s.leaveTypeRepo.FindByOrganization(ctx, orgID)
    if err != nil {
        s.logger.Error("failed to get leave types by organization", zap.Error(err), zap.String("org_id", orgID))
        return nil, err
    }

    // If no organization-specific types found, fall back to all active types
    // This is useful for testing or default organizations
    if len(leaveTypes) == 0 {
        s.logger.Info("no organization-specific leave types found, fetching all active types", zap.String("org_id", orgID))
        leaveTypes, err = s.leaveTypeRepo.FindAllActive(ctx)
        if err != nil {
            s.logger.Error("failed to get all active leave types", zap.Error(err))
            return nil, err
        }
    }

    return leaveTypes, nil
}

leaveQueryService := services.NewLeaveQueryService(
    leaveRequestQueryRepo,
    leaveBalanceQueryRepo,
    leaveTypeRepo,  // NEW
    c.Logger,
)

// GetLeaveTypes handles GET /v1/leave/types
func (h *LeaveHandler) GetLeaveTypes(c echo.Context) error {
    orgID := "org_default" // TODO: Get from context when multi-tenant is implemented

    // Use Query Service for consistent business logic
    leaveTypes, err := h.queryService.GetLeaveTypes(c.Request().Context(), orgID)
    if err != nil {
        return echo.NewHTTPError(http.StatusInternalServerError, err.Error())
    }

    return c.JSON(http.StatusOK, leaveTypes)
}

leave.GET("/types", h.GetLeaveTypes)

async getLeaveTypes(token: string) {
  return this.fetch<LeaveType[]>(`/leave/types`, {
    headers: { Authorization: `Bearer ${token}` },
  });
}

useVisibleTask$(async () => {
  try {
    const data = await api.getLeaveTypes(token);
    leaveTypes.value = data ?? [];
    isLoading.value = false;
  } catch (err) {
    error.value = "Failed to load leave types";
    isLoading.value = false;
  }
});

GET /v1/leave/types
Authorization: Bearer <better-auth_token>

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Annual Leave",
    "description": "Paid time off for vacation or personal matters",
    "max_days": 14,
    "requires_approval": true,
    "is_active": true,
    "created_at": "2025-12-23T02:19:04.149Z",
    "updated_at": "2025-12-23T02:19:04.149Z",
    "created_by": "system_seed",
    "updated_by": "system_seed"
  },
  {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "name": "Sick Leave",
    "description": "Leave for medical reasons or illness",
    "max_days": 14,
    "requires_approval": true,
    "is_active": true,
    "created_at": "2025-12-23T02:19:04.149Z",
    "updated_at": "2025-12-23T02:19:04.149Z",
    "created_by": "system_seed",
    "updated_by": "system_seed"
  }
]

{
  "message": "error message"
}

-- Connect to the database and check leave_types table
SELECT id, name, max_days, is_active FROM leave_types;

curl -X GET http://localhost:8080/v1/leave/types \
  -H "Authorization: Bearer <your_better-auth_token>"

type LeaveType struct {
    ID               string    `gorm:"primaryKey;type:uuid" json:"id"`
    OrganizationID   string    `gorm:"type:varchar(26)" json:"organization_id"`
    Name             string    `gorm:"type:varchar(255);not null" json:"name"`
    Description      string    `gorm:"type:text" json:"description"`
    Code             string    `gorm:"type:varchar(50)" json:"code"`
    MaxDays          float64   `gorm:"type:decimal(10,2);not null" json:"max_days"`
    RequiresApproval bool      `gorm:"not null;default:true" json:"requires_approval"`
    IsActive         bool      `gorm:"not null;default:true" json:"is_active"`
    CreatedAt        time.Time `gorm:"type:timestamptz" json:"created_at"`
    UpdatedAt        time.Time `gorm:"type:timestamptz" json:"updated_at"`
    CreatedBy        string    `gorm:"type:varchar(26)" json:"created_by"`
    UpdatedBy        string    `gorm:"type:varchar(26)" json:"updated_by"`
}

export interface LeaveType {
  id: string;
  name: string;
  description?: string;
  max_days: number;
  requires_approval: boolean;
  is_active: boolean;
}