notify

type ApprovalCardAction struct {
	Decision string `json:"decision"`
	Title    string `json:"title"`
}

type ApprovalCardFields struct {
	ActionType  string            `json:"action_type"`
	Title       string            `json:"title"`
	Description string            `json:"description"`
	Data        map[string]string `json:"data"`
	// Actions is optional. When omitted, octo-server renders the localized
	// approve/deny buttons (byte-compatible with the pre-http-actions release).
	// When present, it must contain 1..MaxApprovalCustomActions items; each
	// decision is a stable callback token and each title is display text.
	Actions []ApprovalCardAction `json:"actions,omitempty"`
}

type BatchNotifyReq struct {
	Notifications []NotifyReq `json:"notifications" binding:"required"`
}

type BatchNotifyResp struct {
	Results   []BatchNotifyResult `json:"results"`
	HasErrors bool                `json:"has_errors"`
}

type BatchNotifyResult struct {
	NotifyResp
	Error string `json:"error,omitempty"`
}

type DocsActionFinalizer struct {
	// contains filtered or unexported fields
}

type DocsCardFields struct {
	DocID     string `json:"doc_id"`     // maps to /d/{doc_id}?sp={space_id}
	RequestID string `json:"request_id"` // required by access_requested v2; docs domain idempotency/CAS key
	Kind      string `json:"kind"`       // "shared" | "commented" | "access_requested"
	Title     string `json:"title"`      // document title
	ActorName string `json:"actor_name"` // pre-resolved actor display name; empty allowed
	// ActorAvatarURL is an optional absolute https avatar for the requester,
	// surfaced on the access-request approval card. Additive & backward
	// compatible: empty (or omitted) renders no avatar; a non-https value fails
	// the card build (same positive allowlist as any rendered image URL). The
	// docs backend owns population; octo-server does not resolve it.
	ActorAvatarURL string `json:"actor_avatar_url"`
	Excerpt        string `json:"excerpt"`    // optional preview / comment / access reason
	UpdatedAt      string `json:"updated_at"` // pre-formatted timestamp; empty allowed
}

type Notify struct {
	log.Log
	// contains filtered or unexported fields
}

type NotifyReq struct {
	SpaceID      string                 `json:"space_id" binding:"required"`
	Service      string                 `json:"service" binding:"required"`
	Event        string                 `json:"event"`
	Targets      []string               `json:"targets" binding:"required"`
	ActorUID     string                 `json:"actor_uid"`
	Payload      map[string]interface{} `json:"payload"`
	Card         *SummaryCardFields     `json:"card"`
	DocsCard     *DocsCardFields        `json:"docs_card"`
	ApprovalCard *ApprovalCardFields    `json:"approval_card"`
}

type NotifyResp struct {
	Delivered []string          `json:"delivered"`
	Filtered  map[string]string `json:"filtered"`
}

type StandardActionFinalizer struct {
	// contains filtered or unexported fields
}

type SummaryCardFields struct {
	TaskNo      string `json:"task_no"`      // summary_task.task_no,用于 /s/{task_no}?sp={space_id}
	Kind        string `json:"kind"`         // "completed" | "failed"
	Title       string `json:"title"`        // 总结标题(服务端转义/截断)
	TimeRange   string `json:"time_range"`   // 已格式化的时间范围;空则省略
	Members     int    `json:"members"`      // 参与人数;<=0 省略
	MsgCount    int    `json:"msg_count"`    // 消息条数;<=0 省略
	GeneratedAt string `json:"generated_at"` // 已格式化的生成时间;空则省略
	Reason      string `json:"reason"`       // failed 的脱敏原因;completed 留空
}