chore: import clean Agent Desk snapshot (2/7)

internal/handlers/api/conversation_handler.go

@@ -0,0 +1,176 @@
+package api
+
+import (
+	"agent-desk/internal/builders"
+	"agent-desk/internal/pkg/dto/request"
+	"agent-desk/internal/pkg/dto/response"
+	"agent-desk/internal/pkg/httpx"
+	"agent-desk/internal/pkg/i18nx"
+	"agent-desk/internal/services"
+
+	"agent-desk/internal/pkg/httpx/params"
+
+	"github.com/gin-gonic/gin"
+	"github.com/mlogclub/simple/web"
+)
+
+func ConversationGetBy(ctx *gin.Context) {
+	id, ok := httpx.GetPathInt64(ctx, "id")
+	if !ok {
+		return
+	}
+	if services.ChannelService.GetEnabledChannel(ctx) == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0211"))
+		return
+	}
+	external := httpx.GetExternalUser(ctx)
+	if external == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0150"))
+		return
+	}
+
+	item := services.ConversationService.Get(id)
+	if item == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0116"))
+		return
+	}
+	if !services.ConversationService.IsCustomerConversationOwner(item, *external) {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0222"))
+		return
+	}
+
+	detail := response.ConversationDetailResponse{
+		ConversationResponse: builders.BuildConversationWithLocale(item, i18nx.Locale(ctx)),
+		Participants:         builders.BuildParticipantResponses(id),
+	}
+	httpx.WriteJSON(ctx, detail)
+}
+
+func ConversationPostCreate_or_match(ctx *gin.Context) {
+	channel := services.ChannelService.GetEnabledChannel(ctx)
+	if channel == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0211"))
+		return
+	}
+	external := httpx.GetExternalUser(ctx)
+	if external == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0150"))
+		return
+	}
+
+	item, err := services.ConversationService.Create(*external, channel.ID, channel.AIAgentID)
+	if err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	httpx.WriteJSON(ctx, builders.BuildConversationWithLocale(item, i18nx.Locale(ctx)))
+}
+
+// ConversationPostCreate starts a brand new request instead of rejoining the
+// visitor's unfinished one, which is what the "new request" action needs.
+func ConversationPostCreate(ctx *gin.Context) {
+	channel := services.ChannelService.GetEnabledChannel(ctx)
+	if channel == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0211"))
+		return
+	}
+	external := httpx.GetExternalUser(ctx)
+	if external == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0150"))
+		return
+	}
+
+	// An absent body is valid: the subject is optional and the widget may post
+	// nothing at all when the visitor skips the prompt.
+	req := request.CreateCustomerConversationRequest{}
+	if ctx.Request.ContentLength > 0 {
+		if err := params.ReadJSON(ctx, &req); err != nil {
+			httpx.WriteJSON(ctx, err)
+			return
+		}
+	}
+
+	item, err := services.ConversationService.CreateNew(*external, channel.ID, channel.AIAgentID, req.Subject)
+	if err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	httpx.WriteJSON(ctx, builders.BuildConversationWithLocale(item, i18nx.Locale(ctx)))
+}
+
+// ConversationAnyList returns the visitor's own requests so the widget can offer
+// a request list. Scoping comes from the external identity, never from a
+// client-supplied customer id.
+func ConversationAnyList(ctx *gin.Context) {
+	if services.ChannelService.GetEnabledChannel(ctx) == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0211"))
+		return
+	}
+	external := httpx.GetExternalUser(ctx)
+	if external == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0150"))
+		return
+	}
+
+	cnd := params.NewPagedSqlCnd(ctx,
+		params.QueryFilter{ParamName: "status"},
+	)
+	list, paging, err := services.ConversationService.ListCustomerConversations(*external, cnd)
+	if err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	locale := i18nx.Locale(ctx)
+	results := make([]response.ConversationResponse, 0, len(list))
+	for i := range list {
+		results = append(results, builders.BuildConversationWithLocale(&list[i], locale))
+	}
+	httpx.WriteJSON(ctx, &web.PageResult{Results: results, Page: paging})
+}
+
+func ConversationPostClose(ctx *gin.Context) {
+	if services.ChannelService.GetEnabledChannel(ctx) == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0211"))
+		return
+	}
+	external := httpx.GetExternalUser(ctx)
+	if external == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0150"))
+		return
+	}
+
+	req := request.CloseConversationRequest{}
+	if err := params.ReadJSON(ctx, &req); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	if err := services.ConversationService.CloseCustomerConversation(req.ConversationID, *external); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	httpx.WriteJSON(ctx, nil)
+}
+
+func ConversationPostSatisfaction(ctx *gin.Context) {
+	if services.ChannelService.GetEnabledChannel(ctx) == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0211"))
+		return
+	}
+	external := httpx.GetExternalUser(ctx)
+	if external == nil {
+		httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0150"))
+		return
+	}
+
+	req := request.SubmitSatisfactionRequest{}
+	if err := params.ReadJSON(ctx, &req); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	item, err := services.ConversationSatisfactionService.SubmitSatisfaction(req.ConversationID, *external, req.Score, req.Feedback)
+	if err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	httpx.WriteJSON(ctx, builders.BuildSatisfactionResponse(item))
+}