Add last message API

Author: AchoArnold

README.md

@@ -30,6 +30,7 @@ import "github.com/NdoleStudio/smsto-go"
 
 - [SMS](#sms)
     - `POST /sms/send`: Send single message to a number
+    - `GET /last/message`: Get the last message that you have sent
 
 ## Usage
 
@@ -65,7 +66,7 @@ if err != nil {
 #### `POST /sms/send`: Send single message to a number
 
 ```go
-status, response, err := client.SMS.SendSingle(context.Background(), &SmsSendSingleRequest{
+result, response, err := client.SMS.SendSingle(context.Background(), &SmsSendSingleRequest{
     Message: "This is test and \n this is a new line",
     To:      "+35799999999999",
 })
@@ -74,9 +75,23 @@ if err != nil {
     log.Fatal(err)
 }
 
-log.Println(status.Success) // true
+log.Println(result.Success) // true
 ```
 
+#### `GET /last/message`: Get the last message that you have sent
+
+```go
+message, response, err := client.SMS.LastMessage(context.Background())
+
+if err != nil {
+    log.Fatal(err)
+}
+
+log.Println(message.Id) // 302050741
+```
+
+
+
 ## Testing
 
 You can run the unit tests for this client from the root directory using the command below:

internal/stubs/sms.go

@@ -1,6 +1,6 @@
 package stubs
 
-// SmsSendSingle is a dummy json response for the `/api/airtime/v2/` endpoint with an error
+// SmsSendSingle is a dummy json response for the `/api/airtime/v2/` endpoint
 func SmsSendSingle() []byte {
 	return []byte(`
 		{
@@ -10,3 +10,35 @@ func SmsSendSingle() []byte {
 		}
 `)
 }
+
+// SmsLastMessage is a dummy JSON response for the `/last/message` endpoint
+func SmsLastMessage() []byte {
+	return []byte(`
+		{
+			"id": 302050741,
+			"_id": "11ec-8330-c25f5870-a614-02420a0002ab",
+			"campaign_id": null,
+			"user_id": 342847,
+			"sender_id": "SMSto",
+			"message": "This is a test message",
+			"to": "+35799999999999",
+			"status": "REJECTED",
+			"client_cost": 0,
+			"callback_url": "https://example.com/callback/handler",
+			"scheduled_for": null,
+			"timezone": null,
+			"created_at": "2022-02-01T07:29:59.000000Z",
+			"updated_at": "2022-02-01T07:30:07.000000Z",
+			"sent_at": "2022-02-01 07:30:07",
+			"message_id": null,
+			"sms_count": 1,
+			"final_callback_sent": 0,
+			"is_api": 1,
+			"a2_code": null,
+			"optout": null,
+			"failed_reason": "Invalid Number",
+			"campaign": null,
+			"provider": null
+		}
+`)
+}

sms.go

@@ -1,5 +1,7 @@
 package smsto
 
+import "time"
+
 // SmsSendSingleResponse is the response after sending a single SMS message
 type SmsSendSingleResponse struct {
 	Message   string `json:"message"`
@@ -15,3 +17,31 @@ type SmsSendSingleRequest struct {
 	SenderID     *string `json:"sender_id,omitempty"`
 	CallbackURL  *string `json:"callback_url,omitempty"`
 }
+
+// SmsMessage is the details of an SMS message that was sent out
+type SmsMessage struct {
+	ID                int         `json:"id"`
+	SecondaryID       string      `json:"_id"`
+	CampaignID        interface{} `json:"campaign_id"`
+	UserID            int         `json:"user_id"`
+	SenderID          string      `json:"sender_id"`
+	Message           string      `json:"message"`
+	To                string      `json:"to"`
+	Status            string      `json:"status"`
+	ClientCost        int         `json:"client_cost"`
+	CallbackURL       string      `json:"callback_url"`
+	ScheduledFor      interface{} `json:"scheduled_for"`
+	Timezone          interface{} `json:"timezone"`
+	CreatedAt         time.Time   `json:"created_at"`
+	UpdatedAt         time.Time   `json:"updated_at"`
+	SentAt            string      `json:"sent_at"`
+	MessageID         interface{} `json:"message_id"`
+	SmsCount          int         `json:"sms_count"`
+	FinalCallbackSent int         `json:"final_callback_sent"`
+	IsAPI             int         `json:"is_api"`
+	A2Code            interface{} `json:"a2_code"`
+	OptOut            interface{} `json:"optout"`
+	FailedReason      string      `json:"failed_reason"`
+	Campaign          interface{} `json:"campaign"`
+	Provider          interface{} `json:"provider"`
+}

sms_service.go

@@ -33,3 +33,25 @@ func (service *smsService) SendSingle(
 
 	return status, response, nil
 }
+
+// LastMessage Gets the last message that you have sent
+//
+// API Docs: https://developers.sms.to/#80f14590-14cd-4512-9c8c-cf8c7ef07f96
+func (service *smsService) LastMessage(ctx context.Context) (*SmsMessage, *Response, error) {
+	request, err := service.client.newRequest(ctx, http.MethodGet, "/last/message", nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	response, err := service.client.do(request)
+	if err != nil {
+		return nil, response, err
+	}
+
+	status := new(SmsMessage)
+	if err = json.Unmarshal(*response.Body, status); err != nil {
+		return nil, response, err
+	}
+
+	return status, response, nil
+}

sms_service_test.go

@@ -87,3 +87,49 @@ func TestSmsService_SendSingleResponse(t *testing.T) {
 	// Teardown
 	server.Close()
 }
+
+func TestSmsService_LastMessageRequest(t *testing.T) {
+	// Setup
+	t.Parallel()
+
+	// Arrange
+	requests := make([]*http.Request, 0)
+	apiKey := "apiKey"
+	server := helpers.MakeRequestCapturingTestServer(http.StatusOK, [][]byte{stubs.SmsLastMessage()}, &requests)
+	client := New(WithBaseURL(server.URL), WithAPIKey(apiKey))
+
+	// Act
+	_, _, err := client.SMS.LastMessage(context.Background())
+
+	// Assert
+	assert.Nil(t, err)
+
+	assert.Equal(t, 1, len(requests))
+
+	assert.Equal(t, "Bearer "+apiKey, requests[0].Header.Get("Authorization"))
+}
+
+func TestSmsService_LastMessageResponse(t *testing.T) {
+	// Setup
+	t.Parallel()
+
+	// Arrange
+	server := helpers.MakeTestServer(http.StatusOK, stubs.SmsLastMessage())
+	client := New(WithBaseURL(server.URL))
+
+	// Act
+	result, response, err := client.SMS.LastMessage(context.Background())
+
+	// Assert
+	assert.Nil(t, err)
+	assert.Equal(t, http.StatusOK, response.HTTPResponse.StatusCode)
+
+	var smsMessage SmsMessage
+	err = json.Unmarshal(stubs.SmsLastMessage(), &smsMessage)
+	assert.Nil(t, err)
+
+	assert.Equal(t, &smsMessage, result)
+
+	// Teardown
+	server.Close()
+}