fix(api): keep milestone due date when it is omitted in edit request (#39869)

`PATCH /repos/{owner}/{repo}/milestones/{id}` always overwrote the due
date with `due_on`, so a request that only changed other fields, such as
`{"state": "closed"}`, silently removed it.

The due date is now kept when `due_on` is omitted, and `"due_on": null`
or `"due_on": ""` remove it.

---------

Co-authored-by: wxiaoguang <wxiaoguang@gmail.com>

modules/structs/issue.go

@@ -10,6 +10,8 @@ import (
 	"strings"
 	"time"
 
+	"gitea.dev/modules/optional"
+
 	"go.yaml.in/yaml/v4"
 )
 
@@ -96,7 +98,7 @@ type CreateIssueOption struct {
 	Assignee  string   `json:"assignee"`
 	Assignees []string `json:"assignees"`
 	// swagger:strfmt date-time
-	Deadline *time.Time `json:"due_date"`
+	Deadline optional.Option[*string] `json:"due_date,omitzero"`
 	// milestone id
 	Milestone int64 `json:"milestone"`
 	// list of label ids
@@ -118,9 +120,10 @@ type EditIssueOption struct {
 	// list of project ids to set (replaces existing projects)
 	Projects *[]int64 `json:"projects"`
 	State    *string  `json:"state"`
+	// Deadline is the updated due date for the issue, use null or empty string to remove the deadline
 	// swagger:strfmt date-time
-	Deadline       *time.Time `json:"due_date"`
-	RemoveDeadline *bool      `json:"unset_due_date"`
+	Deadline       optional.Option[*string] `json:"due_date,omitzero"`
+	RemoveDeadline *bool                    `json:"unset_due_date"`
 	// The current version of the issue content to detect conflicts during editing
 	ContentVersion *int `json:"content_version"`
 }
@@ -130,10 +133,11 @@ type IssueAssigneesOption struct {
 	Assignees []string `json:"assignees"`
 }
 
-// EditDeadlineOption options for creating a deadline
+// EditDeadlineOption options for editing a deadline
 type EditDeadlineOption struct {
-	// required:true
-	Deadline *time.Time `json:"due_date"`
+	// Deadline is the updated due date for the issue or pull request, use null or empty string to remove the deadline
+	// swagger:strfmt date-time
+	Deadline optional.Option[*string] `json:"due_date,omitzero"`
 }
 
 // IssueDeadline represents an issue deadline

modules/structs/issue_milestone.go

@@ -5,9 +5,11 @@ package structs
 
 import (
 	"time"
+
+	"gitea.dev/modules/optional"
 )
 
-// Milestone milestone is a collection of issues on one repository
+// Milestone is a collection of issues on one repository
 type Milestone struct {
 	// ID is the unique identifier for the milestone
 	ID int64 `json:"id"`
@@ -39,7 +41,7 @@ type CreateMilestoneOption struct {
 	Description string `json:"description"`
 	// swagger:strfmt date-time
 	// Deadline is the due date for the milestone
-	Deadline *time.Time `json:"due_on"`
+	Deadline optional.Option[*string] `json:"due_on,omitzero"`
 	// enum: ["open","closed"]
 	// State indicates the initial state of the milestone
 	State string `json:"state"`
@@ -54,6 +56,7 @@ type EditMilestoneOption struct {
 	// State indicates the updated state of the milestone
 	// enum: ["open","closed"]
 	State *string `json:"state"`
-	// Deadline is the updated due date for the milestone
-	Deadline *time.Time `json:"due_on"`
+	// Deadline is the due date for the milestone, use null or empty string to remove the deadline
+	// swagger:strfmt date-time
+	Deadline optional.Option[*string] `json:"due_on,omitzero"`
 }

modules/structs/pull.go

@@ -5,6 +5,8 @@ package structs
 
 import (
 	"time"
+
+	"gitea.dev/modules/optional"
 )
 
 // PullRequest represents a pull request
@@ -137,7 +139,7 @@ type CreatePullRequestOption struct {
 	// The list of label IDs to assign to the pull request
 	Labels []int64 `json:"labels"`
 	// swagger:strfmt date-time
-	Deadline *time.Time `json:"due_date"`
+	Deadline optional.Option[*string] `json:"due_date,omitzero"`
 	// The list of reviewer usernames
 	Reviewers []string `json:"reviewers"`
 	// The list of team reviewer names
@@ -164,8 +166,9 @@ type EditPullRequestOption struct {
 	Labels []int64 `json:"labels"`
 	// The new state for the pull request
 	State *string `json:"state"`
+	// Deadline is the updated due date for the pull request, use null or empty string to remove the deadline
 	// swagger:strfmt date-time
-	Deadline *time.Time `json:"due_date"`
+	Deadline optional.Option[*string] `json:"due_date,omitzero"`
 	// Whether to remove the current deadline
 	RemoveDeadline *bool `json:"unset_due_date"`
 	// Whether to allow maintainer edits