feat: add linkace service integration

internal/integration/integration.go

@@ -10,6 +10,7 @@ import (
 	"miniflux.app/v2/internal/integration/apprise"
 	"miniflux.app/v2/internal/integration/espial"
 	"miniflux.app/v2/internal/integration/instapaper"
+	"miniflux.app/v2/internal/integration/linkace"
 	"miniflux.app/v2/internal/integration/linkding"
 	"miniflux.app/v2/internal/integration/matrixbot"
 	"miniflux.app/v2/internal/integration/notion"
@@ -180,6 +181,30 @@ func SendEntry(entry *model.Entry, userIntegrations *model.Integration) {
 		}
 	}
 
+	if userIntegrations.LinkAceEnabled {
+		slog.Debug("Sending entry to LinkAce",
+			slog.Int64("user_id", userIntegrations.UserID),
+			slog.Int64("entry_id", entry.ID),
+			slog.String("entry_url", entry.URL),
+		)
+
+		client := linkace.NewClient(
+			userIntegrations.LinkAceURL,
+			userIntegrations.LinkAceAPIKey,
+			userIntegrations.LinkAceTags,
+			userIntegrations.LinkAcePrivate,
+			userIntegrations.LinkAceCheckDisabled,
+		)
+		if err := client.AddURL(entry.URL, entry.Title); err != nil {
+			slog.Error("Unable to send entry to LinkAce",
+				slog.Int64("user_id", userIntegrations.UserID),
+				slog.Int64("entry_id", entry.ID),
+				slog.String("entry_url", entry.URL),
+				slog.Any("error", err),
+			)
+		}
+	}
+
 	if userIntegrations.LinkdingEnabled {
 		slog.Debug("Sending entry to Linkding",
 			slog.Int64("user_id", userIntegrations.UserID),

internal/integration/linkace/linkace.go

@@ -0,0 +1,83 @@
+package linkace
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"strings"
+	"time"
+
+	"miniflux.app/v2/internal/urllib"
+	"miniflux.app/v2/internal/version"
+)
+
+const defaultClientTimeout = 10 * time.Second
+
+type Client struct {
+	baseURL       string
+	apiKey        string
+	tags          string
+	private       bool
+	checkDisabled bool
+}
+
+func NewClient(baseURL, apiKey, tags string, private bool, checkDisabled bool) *Client {
+	return &Client{baseURL: baseURL, apiKey: apiKey, tags: tags, private: private, checkDisabled: checkDisabled}
+}
+
+func (c *Client) AddURL(entryURL, entryTitle string) error {
+	if c.baseURL == "" || c.apiKey == "" {
+		return fmt.Errorf("linkace: missing base URL or API key")
+	}
+
+	tagsSplitFn := func(c rune) bool {
+		return c == ',' || c == ' '
+	}
+
+	apiEndpoint, err := urllib.JoinBaseURLAndPath(c.baseURL, "/api/v1/links")
+	if err != nil {
+		return fmt.Errorf("linkace: invalid API endpoint: %v", err)
+	}
+	requestBody, err := json.Marshal(&createItemRequest{
+		Url:           entryURL,
+		Title:         entryTitle,
+		Tags:          strings.FieldsFunc(c.tags, tagsSplitFn),
+		Private:       c.private,
+		CheckDisabled: c.checkDisabled,
+	})
+	if err != nil {
+		return fmt.Errorf("linkace: unable to encode request body: %v", err)
+	}
+
+	request, err := http.NewRequest(http.MethodPost, apiEndpoint, bytes.NewReader(requestBody))
+	if err != nil {
+		return fmt.Errorf("linkace: unable to create request: %v", err)
+	}
+
+	request.Header.Set("Content-Type", "application/json")
+	request.Header.Set("Accept", "application/json")
+	request.Header.Set("User-Agent", "Miniflux/"+version.Version)
+	request.Header.Set("Authorization", "Bearer "+c.apiKey)
+
+	httpClient := &http.Client{Timeout: defaultClientTimeout}
+	response, err := httpClient.Do(request)
+	if err != nil {
+		return fmt.Errorf("linkace: unable to send request: %v", err)
+	}
+	defer response.Body.Close()
+
+	if response.StatusCode >= 400 {
+		return fmt.Errorf("linkace: unable to create item: url=%s status=%d", apiEndpoint, response.StatusCode)
+	}
+
+	return nil
+}
+
+type createItemRequest struct {
+	Title         string   `json:"title,omitempty"`
+	Url           string   `json:"url"`
+	Tags          []string `json:"tags,omitempty"`
+	Private       bool     `json:"is_private,omitempty"`
+	CheckDisabled bool     `json:"check_disabled,omitempty"`
+}