package requests import ( "encoding/json" "strings" "time" "github.com/shopspring/decimal" ) // FlexibleDate handles both "2025-11-27" and "2025-11-27T00:00:00Z" formats type FlexibleDate struct { time.Time } func (fd *FlexibleDate) UnmarshalJSON(data []byte) error { // Remove quotes s := strings.Trim(string(data), "\"") if s == "" || s == "null" { return nil } // Try RFC3339 first (full datetime) t, err := time.Parse(time.RFC3339, s) if err == nil { fd.Time = t return nil } // Try date-only format t, err = time.Parse("2006-01-02", s) if err == nil { fd.Time = t return nil } return err } func (fd FlexibleDate) MarshalJSON() ([]byte, error) { if fd.Time.IsZero() { return json.Marshal(nil) } return json.Marshal(fd.Time.Format(time.RFC3339)) } // ToTimePtr returns a pointer to the underlying time, or nil if zero func (fd *FlexibleDate) ToTimePtr() *time.Time { if fd == nil || fd.Time.IsZero() { return nil } return &fd.Time } // BulkCreateTasksRequest represents a batch create. Used by onboarding to // insert 1-N selected tasks atomically in a single transaction so that a // failure halfway through doesn't leave a partial task list behind. // // ResidenceID is validated once at the service layer; individual task // entries must reference the same residence or be left empty (the service // overrides each entry's ResidenceID with the top-level value). type BulkCreateTasksRequest struct { ResidenceID uint `json:"residence_id" validate:"required"` Tasks []CreateTaskRequest `json:"tasks" validate:"required,min=1,max=50,dive"` } // CreateTaskRequest represents the request to create a task type CreateTaskRequest struct { ResidenceID uint `json:"residence_id" validate:"required"` Title string `json:"title" validate:"required,min=1,max=200"` Description string `json:"description" validate:"max=10000"` CategoryID *uint `json:"category_id"` PriorityID *uint `json:"priority_id"` FrequencyID *uint `json:"frequency_id"` CustomIntervalDays *int `json:"custom_interval_days" validate:"omitempty,min=1"` // For "Custom" frequency, user-specified days InProgress bool `json:"in_progress"` AssignedToID *uint `json:"assigned_to_id"` DueDate *FlexibleDate `json:"due_date"` EstimatedCost *decimal.Decimal `json:"estimated_cost"` ContractorID *uint `json:"contractor_id"` // TemplateID links the created task to the TaskTemplate it was spawned from // (e.g. onboarding suggestion or catalog pick). Optional — custom tasks // leave this nil. TemplateID *uint `json:"template_id"` } // UpdateTaskRequest represents the request to update a task type UpdateTaskRequest struct { Title *string `json:"title" validate:"omitempty,min=1,max=200"` Description *string `json:"description" validate:"omitempty,max=10000"` CategoryID *uint `json:"category_id"` PriorityID *uint `json:"priority_id"` FrequencyID *uint `json:"frequency_id"` CustomIntervalDays *int `json:"custom_interval_days" validate:"omitempty,min=1"` // For "Custom" frequency, user-specified days InProgress *bool `json:"in_progress"` AssignedToID *uint `json:"assigned_to_id"` DueDate *FlexibleDate `json:"due_date"` EstimatedCost *decimal.Decimal `json:"estimated_cost"` ActualCost *decimal.Decimal `json:"actual_cost"` ContractorID *uint `json:"contractor_id"` } // CreateTaskCompletionRequest represents the request to create a task completion type CreateTaskCompletionRequest struct { TaskID uint `json:"task_id" validate:"required"` CompletedAt *time.Time `json:"completed_at"` // Defaults to now Notes string `json:"notes" validate:"max=10000"` ActualCost *decimal.Decimal `json:"actual_cost"` Rating *int `json:"rating" validate:"omitempty,min=1,max=5"` // 1-5 star rating ImageURLs []string `json:"image_urls" validate:"omitempty,max=20,dive,max=500"` // Multiple image URLs } // UpdateTaskCompletionRequest represents the request to update a task completion type UpdateTaskCompletionRequest struct { Notes *string `json:"notes" validate:"omitempty,max=10000"` ActualCost *decimal.Decimal `json:"actual_cost"` Rating *int `json:"rating" validate:"omitempty,min=1,max=5"` ImageURLs []string `json:"image_urls" validate:"omitempty,max=20,dive,max=500"` } // CompletionImageInput represents an image to add to a completion type CompletionImageInput struct { ImageURL string `json:"image_url" validate:"required"` Caption string `json:"caption"` }