feat: add location request message support

Signed-off-by: sarthakjdev <jsarthak448@gmail.com>

Author: sarthakjdev

docs/api-reference/manager.mdx

@@ -1450,7 +1450,7 @@ type ProductItem struct {
     Brand                                                 string        `json:"brand,omitempty"`
     CapabilityToReviewStatus                              []KeyValue    `json:"capability_to_review_status,omitempty"`
     Category                                              string        `json:"category,omitempty"`
-    CategorySpecificFields                                string        `json:"category_specific_fields,omitempty"`
+    CategorySpecificFields                                interface{}        `json:"category_specific_fields,omitempty"`
     Color                                                 string        `json:"color,omitempty"`
     CommerceInsights                                      string        `json:"commerce_insights,omitempty"`
     Condition                                             string        `json:"condition,omitempty"`

docs/api-reference/pkg/components.mdx

@@ -660,11 +660,12 @@ type InteractiveMessageType string
 
 ```go
 const (
-    InteractiveMessageTypeButton      InteractiveMessageType = "button"
-    InteractiveMessageTypeProduct     InteractiveMessageType = "product"
-    InteractiveMessageTypeProductList InteractiveMessageType = "product_list"
-    InteractiveMessageTypeList        InteractiveMessageType = "list"
-    InteractiveMessageTypeCatalog     InteractiveMessageType = "catalog_message"
+    InteractiveMessageTypeButton          InteractiveMessageType = "button"
+    InteractiveMessageTypeProduct         InteractiveMessageType = "product"
+    InteractiveMessageTypeProductList     InteractiveMessageType = "product_list"
+    InteractiveMessageTypeList            InteractiveMessageType = "list"
+    InteractiveMessageTypeCatalog         InteractiveMessageType = "catalog_message"
+    InteractiveMessageTypeLocationRequest InteractiveMessageType = "location_request_message"
 )
 ```
 
@@ -691,6 +692,29 @@ type ListMessageBody struct {
 }
 ```
 
+<a name="ListMessageFooter"></a>
+## type ListMessageFooter
+
+ListMessageFooter represents the footer of the list message.
+
+```go
+type ListMessageFooter struct {
+    Text string `json:"text" validate:"required"` // Text of the footer.
+}
+```
+
+<a name="ListMessageHeader"></a>
+## type ListMessageHeader
+
+
+
+```go
+type ListMessageHeader struct {
+    Type string `json:"type" validate:"required"` // Type of the header.
+    Text string `json:"text" validate:"required"` // Text of the header.
+}
+```
+
 <a name="ListMessageParams"></a>
 ## type ListMessageParams
 
@@ -804,6 +828,80 @@ type LocationMessageApiPayload struct {
 }
 ```
 
+<a name="LocationRequestMessage"></a>
+## type LocationRequestMessage
+
+
+
+```go
+type LocationRequestMessage struct {
+    Type   InteractiveMessageType     `json:"type" validate:"required"`   // Type of the message.
+    Action locationMessageAction      `json:"action" validate:"required"` // Action of the message.
+    Body   LocationRequestMessageBody `json:"body,omitempty"`             // Body of the message.
+}
+```
+
+<a name="NewLocationRequestMessage"></a>
+### func NewLocationRequestMessage
+
+```go
+func NewLocationRequestMessage(params LocationRequestMessageParams) (*LocationRequestMessage, error)
+```
+
+
+
+<a name="LocationRequestMessage.SetBodyText"></a>
+### func \(\*LocationRequestMessage\) SetBodyText
+
+```go
+func (m *LocationRequestMessage) SetBodyText(bodyText string)
+```
+
+SetBodyText sets the body text of the list message.
+
+<a name="LocationRequestMessage.ToJson"></a>
+### func \(\*LocationRequestMessage\) ToJson
+
+```go
+func (m *LocationRequestMessage) ToJson(configs ApiCompatibleJsonConverterConfigs) ([]byte, error)
+```
+
+ToJson converts the list message to JSON.
+
+<a name="LocationRequestMessageApiPayload"></a>
+## type LocationRequestMessageApiPayload
+
+
+
+```go
+type LocationRequestMessageApiPayload struct {
+    BaseMessagePayload
+    Interactive LocationRequestMessage `json:"interactive" validate:"required"` // Interactive message.
+}
+```
+
+<a name="LocationRequestMessageBody"></a>
+## type LocationRequestMessageBody
+
+
+
+```go
+type LocationRequestMessageBody struct {
+    Text string `json:"text" validate:"required"` // Text of the body.
+}
+```
+
+<a name="LocationRequestMessageParams"></a>
+## type LocationRequestMessageParams
+
+
+
+```go
+type LocationRequestMessageParams struct {
+    BodyText string `json:"-" validate:"required"` // Text of the body.
+}
+```
+
 <a name="MessageType"></a>
 ## type MessageType
 
@@ -840,7 +938,7 @@ Order represents an order in the system.
 type Order struct {
     CatalogID    string        `json:"catalog_id"`    // CatalogID is the ID of the catalog associated with the order.
     ProductItems []ProductItem `json:"product_items"` // ProductItems is a list of product items in the order.
-    Text         string        `json:"text"`          // Text is an additional text associated with the order.
+    Text         *string       `json:"text"`          // Text is an additional text associated with the order.
 }
 ```
 
@@ -892,10 +990,10 @@ ProductItem represents a product item in an order.
 
 ```go
 type ProductItem struct {
-    Currency          string `json:"currency"`            // Currency is the currency of the product item.
-    ItemPrice         string `json:"item_price"`          // ItemPrice is the price of the product item.
-    ProductRetailerID string `json:"product_retailer_id"` // ProductRetailerID is the ID of the retailer associated with the product item.
-    Quantity          string `json:"quantity"`            // Quantity is the quantity of the product item.
+    Currency          string  `json:"currency"`            // Currency is the currency of the product item.
+    ItemPrice         float64 `json:"item_price"`          // ItemPrice is the price of the product item.
+    ProductRetailerID string  `json:"product_retailer_id"` // ProductRetailerID is the ID of the retailer associated with the product item.
+    Quantity          int     `json:"quantity"`            // Quantity is the quantity of the product item.
 }
 ```
 
@@ -1258,9 +1356,11 @@ QuickReplyButtonMessage represents a quick reply button message.
 
 ```go
 type QuickReplyButtonMessage struct {
-    Type   InteractiveMessageType        `json:"type" validate:"required"`   // Type of the quick reply button message.
-    Body   QuickReplyButtonMessageBody   `json:"body" validate:"required"`   // Body of the quick reply button message.
-    Action QuickReplyButtonMessageAction `json:"action" validate:"required"` // Action of the quick reply button message.
+    Type   InteractiveMessageType         `json:"type" validate:"required"`   // Type of the quick reply button message.
+    Body   QuickReplyButtonMessageBody    `json:"body" validate:"required"`   // Body of the quick reply button message.
+    Action QuickReplyButtonMessageAction  `json:"action" validate:"required"` // Action of the quick reply button message.
+    Footer *QuickReplyButtonMessageFooter `json:"footer,omitempty"`           // Footer of the quick reply button message.
+    Header *QuickReplyButtonMessageHeader `json:"header,omitempty"`           // Header of the quick reply button message.
 }
 ```
 
@@ -1282,6 +1382,24 @@ func (m *QuickReplyButtonMessage) AddButton(id, title string) error
 
 
 
+<a name="QuickReplyButtonMessage.SetFooter"></a>
+### func \(\*QuickReplyButtonMessage\) SetFooter
+
+```go
+func (m *QuickReplyButtonMessage) SetFooter(text string)
+```
+
+
+
+<a name="QuickReplyButtonMessage.SetHeader"></a>
+### func \(\*QuickReplyButtonMessage\) SetHeader
+
+```go
+func (m *QuickReplyButtonMessage) SetHeader(text string)
+```
+
+
+
 <a name="QuickReplyButtonMessage.ToJson"></a>
 ### func \(\*QuickReplyButtonMessage\) ToJson
 
@@ -1325,6 +1443,29 @@ type QuickReplyButtonMessageBody struct {
 }
 ```
 
+<a name="QuickReplyButtonMessageFooter"></a>
+## type QuickReplyButtonMessageFooter
+
+QuickReplyButtonMessageFooter represents the footer of a quick reply button message.
+
+```go
+type QuickReplyButtonMessageFooter struct {
+    Text string `json:"text" validate:"required"` // Text of the quick reply button message footer.
+}
+```
+
+<a name="QuickReplyButtonMessageHeader"></a>
+## type QuickReplyButtonMessageHeader
+
+
+
+```go
+type QuickReplyButtonMessageHeader struct {
+    Type string `json:"type" validate:"required"` // Type of the quick reply button message header.
+    Text string `json:"text" validate:"required"` // Text of the quick reply button message header.
+}
+```
+
 <a name="ReactionMessage"></a>
 ## type ReactionMessage
 
@@ -2023,6 +2164,8 @@ type listMessage struct {
     Type   InteractiveMessageType `json:"type" validate:"required"`   // Type of the message.
     Action listMessageAction      `json:"action" validate:"required"` // Action of the message.
     Body   ListMessageBody        `json:"body,omitempty"`             // Body of the message.
+    Footer *ListMessageFooter     `json:"footer,omitempty"`           // Footer of the message.
+    Header *ListMessageHeader     `json:"header,omitempty"`           // Header of the message.
 }
 ```
 
@@ -2053,6 +2196,24 @@ func (m *listMessage) SetBodyText(section *ListSection)
 
 SetBodyText sets the body text of the list message.
 
+<a name="listMessage.SetFooterText"></a>
+### func \(\*listMessage\) SetFooterText
+
+```go
+func (m *listMessage) SetFooterText(footerText string)
+```
+
+
+
+<a name="listMessage.SetHeaderText"></a>
+### func \(\*listMessage\) SetHeaderText
+
+```go
+func (m *listMessage) SetHeaderText(headerText string)
+```
+
+
+
 <a name="listMessage.ToJson"></a>
 ### func \(\*listMessage\) ToJson
 
@@ -2123,6 +2284,17 @@ func (row *listSectionRow) SetTitle(title string)
 
 SetTitle sets the title of the list section row.
 
+<a name="locationMessageAction"></a>
+## type locationMessageAction
+
+
+
+```go
+type locationMessageAction struct {
+    Name string `json:"name" validate:"required"` // Name of the action.
+}
+```
+
 <a name="productMessageAction"></a>
 ## type productMessageAction
 

manager/catalog_manager.go

@@ -83,7 +83,7 @@ type ProductItem struct {
 	Brand                                                 string         `json:"brand,omitempty"`
 	CapabilityToReviewStatus                              []KeyValue     `json:"capability_to_review_status,omitempty"`
 	Category                                              string         `json:"category,omitempty"`
-	CategorySpecificFields                                string         `json:"category_specific_fields,omitempty"`
+	CategorySpecificFields                                interface{}    `json:"category_specific_fields,omitempty"`
 	Color                                                 string         `json:"color,omitempty"`
 	CommerceInsights                                      string         `json:"commerce_insights,omitempty"`
 	Condition                                             string         `json:"condition,omitempty"`

pkg/components/interactive_message.go

@@ -3,9 +3,10 @@ package components
 type InteractiveMessageType string
 
 const (
-	InteractiveMessageTypeButton      InteractiveMessageType = "button"
-	InteractiveMessageTypeProduct     InteractiveMessageType = "product"
-	InteractiveMessageTypeProductList InteractiveMessageType = "product_list"
-	InteractiveMessageTypeList        InteractiveMessageType = "list"
-	InteractiveMessageTypeCatalog     InteractiveMessageType = "catalog_message"
+	InteractiveMessageTypeButton          InteractiveMessageType = "button"
+	InteractiveMessageTypeProduct         InteractiveMessageType = "product"
+	InteractiveMessageTypeProductList     InteractiveMessageType = "product_list"
+	InteractiveMessageTypeList            InteractiveMessageType = "list"
+	InteractiveMessageTypeCatalog         InteractiveMessageType = "catalog_message"
+	InteractiveMessageTypeLocationRequest InteractiveMessageType = "location_request_message"
 )

pkg/components/location_request_message.go

@@ -0,0 +1,78 @@
+package components
+
+import (
+	"encoding/json"
+	"fmt"
+
+	"github.com/wapikit/wapi.go/internal"
+)
+
+type locationMessageAction struct {
+	Name string `json:"name" validate:"required"` // Name of the action.
+}
+
+type LocationRequestMessageBody struct {
+	Text string `json:"text" validate:"required"` // Text of the body.
+}
+type LocationRequestMessage struct {
+	Type   InteractiveMessageType     `json:"type" validate:"required"`   // Type of the message.
+	Action locationMessageAction      `json:"action" validate:"required"` // Action of the message.
+	Body   LocationRequestMessageBody `json:"body,omitempty"`             // Body of the message.
+}
+
+type LocationRequestMessageParams struct {
+	BodyText string `json:"-" validate:"required"` // Text of the body.
+}
+
+func NewLocationRequestMessage(params LocationRequestMessageParams) (*LocationRequestMessage, error) {
+	if err := internal.GetValidator().Struct(params); err != nil {
+		return nil, fmt.Errorf("error validating configs: %v", err)
+	}
+
+	return &LocationRequestMessage{
+		Type: InteractiveMessageTypeLocationRequest,
+		Body: LocationRequestMessageBody{
+			Text: params.BodyText,
+		},
+		Action: locationMessageAction{
+			Name: "send_location",
+		},
+	}, nil
+}
+
+type LocationRequestMessageApiPayload struct {
+	BaseMessagePayload
+	Interactive LocationRequestMessage `json:"interactive" validate:"required"` // Interactive message.
+}
+
+// SetBodyText sets the body text of the list message.
+func (m *LocationRequestMessage) SetBodyText(bodyText string) {
+	m.Body.Text = bodyText
+
+}
+
+// ToJson converts the list message to JSON.
+func (m *LocationRequestMessage) ToJson(configs ApiCompatibleJsonConverterConfigs) ([]byte, error) {
+	if err := internal.GetValidator().Struct(configs); err != nil {
+		return nil, fmt.Errorf("error validating configs: %v", err)
+	}
+
+	jsonData := LocationRequestMessageApiPayload{
+		BaseMessagePayload: NewBaseMessagePayload(configs.SendToPhoneNumber, MessageTypeInteractive),
+		Interactive:        *m,
+	}
+
+	if configs.ReplyToMessageId != "" {
+		jsonData.Context = &Context{
+			MessageId: configs.ReplyToMessageId,
+		}
+	}
+
+	jsonToReturn, err := json.Marshal(jsonData)
+
+	if err != nil {
+		return nil, fmt.Errorf("error marshalling json: %v", err)
+	}
+
+	return jsonToReturn, nil
+}