feat(tests): add integration test runner with send and receive tests

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: AchoArnold

tests/go.mod

@@ -0,0 +1,11 @@
+module github.com/NdoleStudio/httpsms/tests
+
+go 1.25.0
+
+require github.com/stretchr/testify v1.11.1
+
+require (
+	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/pmezard/go-difflib v1.0.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)

tests/go.sum

@@ -0,0 +1,10 @@
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

tests/helpers_test.go

@@ -0,0 +1,65 @@
+package tests
+
+import (
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"testing"
+	"time"
+
+	"github.com/stretchr/testify/require"
+)
+
+const (
+	apiBaseURL  = "http://localhost:8000"
+	userAPIKey  = "test-user-api-key"
+	phoneAPIKey = "pk_test-phone-api-key"
+	testPhone   = "+18005550199"
+	testContact = "+18005550100"
+)
+
+func apiClient() *http.Client {
+	return &http.Client{Timeout: 10 * time.Second}
+}
+
+func doRequest(t *testing.T, method, url string, body io.Reader, apiKey string) *http.Response {
+	t.Helper()
+	req, err := http.NewRequest(method, url, body)
+	require.NoError(t, err)
+	req.Header.Set("Content-Type", "application/json")
+	req.Header.Set("x-api-key", apiKey)
+
+	resp, err := apiClient().Do(req)
+	require.NoError(t, err)
+	return resp
+}
+
+func pollMessageStatus(t *testing.T, messageID, targetStatus string, timeout time.Duration) map[string]interface{} {
+	t.Helper()
+	deadline := time.Now().Add(timeout)
+
+	for time.Now().Before(deadline) {
+		url := fmt.Sprintf("%s/v1/messages/%s", apiBaseURL, messageID)
+		resp := doRequest(t, "GET", url, nil, userAPIKey)
+
+		body, err := io.ReadAll(resp.Body)
+		resp.Body.Close()
+		require.NoError(t, err)
+
+		if resp.StatusCode == http.StatusOK {
+			var result map[string]interface{}
+			require.NoError(t, json.Unmarshal(body, &result))
+
+			data, ok := result["data"].(map[string]interface{})
+			if ok && data["status"] == targetStatus {
+				return data
+			}
+		}
+
+		time.Sleep(500 * time.Millisecond)
+	}
+
+	t.Fatalf("message %s did not reach status %q within %v", messageID, targetStatus, timeout)
+	return nil
+}

tests/integration_test.go

@@ -0,0 +1,91 @@
+package tests
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"testing"
+	"time"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestSendSMS_E2E(t *testing.T) {
+	sendPayload := map[string]interface{}{
+		"from":    testPhone,
+		"to":      testContact,
+		"content": "Hello from integration test",
+	}
+	body, _ := json.Marshal(sendPayload)
+
+	url := fmt.Sprintf("%s/v1/messages/send", apiBaseURL)
+	resp := doRequest(t, "POST", url, bytes.NewReader(body), userAPIKey)
+	defer resp.Body.Close()
+
+	respBody, err := io.ReadAll(resp.Body)
+	require.NoError(t, err)
+	require.Equal(t, http.StatusOK, resp.StatusCode, "send response: %s", string(respBody))
+
+	var sendResult map[string]interface{}
+	require.NoError(t, json.Unmarshal(respBody, &sendResult))
+	data := sendResult["data"].(map[string]interface{})
+	messageID := data["id"].(string)
+	require.NotEmpty(t, messageID)
+
+	t.Logf("sent message with ID: %s", messageID)
+
+	message := pollMessageStatus(t, messageID, "delivered", 30*time.Second)
+
+	assert.Equal(t, "delivered", message["status"])
+	assert.Equal(t, testPhone, message["owner"])
+	assert.Equal(t, testContact, message["contact"])
+	assert.Equal(t, "Hello from integration test", message["content"])
+}
+
+func TestReceiveSMS_E2E(t *testing.T) {
+	receivePayload := map[string]interface{}{
+		"from":      testContact,
+		"to":        testPhone,
+		"content":   "Hi there from integration test",
+		"encrypted": false,
+		"sim":       "SIM1",
+		"timestamp": time.Now().UTC().Format(time.RFC3339),
+	}
+	body, _ := json.Marshal(receivePayload)
+
+	url := fmt.Sprintf("%s/v1/messages/receive", apiBaseURL)
+	resp := doRequest(t, "POST", url, bytes.NewReader(body), phoneAPIKey)
+	defer resp.Body.Close()
+
+	respBody, err := io.ReadAll(resp.Body)
+	require.NoError(t, err)
+	require.Equal(t, http.StatusOK, resp.StatusCode, "receive response: %s", string(respBody))
+
+	var receiveResult map[string]interface{}
+	require.NoError(t, json.Unmarshal(respBody, &receiveResult))
+	data := receiveResult["data"].(map[string]interface{})
+	messageID := data["id"].(string)
+	require.NotEmpty(t, messageID)
+
+	t.Logf("received message with ID: %s", messageID)
+
+	getURL := fmt.Sprintf("%s/v1/messages/%s", apiBaseURL, messageID)
+	getResp := doRequest(t, "GET", getURL, nil, userAPIKey)
+	defer getResp.Body.Close()
+
+	getBody, err := io.ReadAll(getResp.Body)
+	require.NoError(t, err)
+	require.Equal(t, http.StatusOK, getResp.StatusCode)
+
+	var getMessage map[string]interface{}
+	require.NoError(t, json.Unmarshal(getBody, &getMessage))
+	messageData := getMessage["data"].(map[string]interface{})
+
+	assert.Equal(t, "received", messageData["status"])
+	assert.Equal(t, testPhone, messageData["owner"])
+	assert.Equal(t, testContact, messageData["contact"])
+	assert.Equal(t, "Hi there from integration test", messageData["content"])
+}