response.go RawHistoryFolder

1package homepage
2
3import (
4	"encoding/json"
5)
6
7// Response represents the standard response format sent back to the frontend.
8// The frontend expects: { requestId, success, data?, error? }
9type Response struct {
10	RequestID string `json:"requestId"`
11	Success   bool   `json:"success"`
12	Data      any    `json:"data,omitempty"`
13	Error     string `json:"error,omitempty"`
14}
15
16// NewSuccessResponse creates a success response with data.
17func NewSuccessResponse(requestID string, data any) Response {
18	return Response{
19		RequestID: requestID,
20		Success:   true,
21		Data:      data,
22	}
23}
24
25// NewErrorResponse creates an error response.
26func NewErrorResponse(requestID string, err error) Response {
27	errMsg := "unknown error"
28	if err != nil {
29		errMsg = err.Error()
30	}
31	return Response{
32		RequestID: requestID,
33		Success:   false,
34		Error:     errMsg,
35	}
36}
37
38// baseRequest is used to extract the requestId from any payload.
39type baseRequest struct {
40	RequestID string `json:"requestId"`
41}
42
43// ParseRequestID extracts the requestId from a raw JSON payload.
44func ParseRequestID(payload json.RawMessage) string {
45	var base baseRequest
46	if err := json.Unmarshal(payload, &base); err != nil {
47		return ""
48	}
49	return base.RequestID
50}
51
52// ParsePayload extracts the requestId and unmarshals the payload into the target type.
53// Returns the requestId, the parsed payload, and any error.
54func ParsePayload[T any](payload json.RawMessage) (string, T, error) {
55	var base baseRequest
56	var target T
57
58	if err := json.Unmarshal(payload, &base); err != nil {
59		return "", target, err
60	}
61	if err := json.Unmarshal(payload, &target); err != nil {
62		return base.RequestID, target, err
63	}
64	return base.RequestID, target, nil
65}