// SPDX-FileCopyrightText: Copyright The Miniflux Authors. All rights reserved. // SPDX-License-Identifier: Apache-2.0 package karakeep // import "miniflux.app/v2/internal/integration/karakeep" import ( "bytes" "encoding/json" "fmt" "io" "net/http" "strings" "time" "miniflux.app/v2/internal/version" ) const defaultClientTimeout = 10 * time.Second type Client struct { wrapped *http.Client apiEndpoint string apiToken string tags string } type tagItem struct { TagName string `json:"tagName"` } type saveURLPayload struct { Type string `json:"type"` URL string `json:"url"` } type saveURLResponse struct { ID string `json:"id"` } type attachTagsPayload struct { Tags []tagItem `json:"tags"` } type errorResponse struct { Code string `json:"code"` Error string `json:"error"` } func NewClient(apiToken string, apiEndpoint string, tags string) *Client { return &Client{wrapped: &http.Client{Timeout: defaultClientTimeout}, apiEndpoint: apiEndpoint, apiToken: apiToken, tags: tags} } func (c *Client) attachTags(entryID string) error { if c.tags == "" { return nil } tagItems := make([]tagItem, 0) for tag := range strings.SplitSeq(c.tags, ",") { if trimmedTag := strings.TrimSpace(tag); trimmedTag != "" { tagItems = append(tagItems, tagItem{TagName: trimmedTag}) } } if len(tagItems) == 0 { return nil } tagRequestBody, err := json.Marshal(&attachTagsPayload{ Tags: tagItems, }) if err != nil { return fmt.Errorf("karakeep: unable to encode tag request body: %v", err) } tagRequest, err := http.NewRequest(http.MethodPost, fmt.Sprintf("%s/%s/tags", c.apiEndpoint, entryID), bytes.NewReader(tagRequestBody)) if err != nil { return fmt.Errorf("karakeep: unable to create tag request: %v", err) } tagRequest.Header.Set("Authorization", "Bearer "+c.apiToken) tagRequest.Header.Set("Content-Type", "application/json") tagRequest.Header.Set("User-Agent", "Miniflux/"+version.Version) tagResponse, err := c.wrapped.Do(tagRequest) if err != nil { return fmt.Errorf("karakeep: unable to send tag request: %v", err) } defer tagResponse.Body.Close() if tagResponse.StatusCode != http.StatusOK && tagResponse.StatusCode != http.StatusCreated { tagResponseBody, err := io.ReadAll(tagResponse.Body) if err != nil { return fmt.Errorf("karakeep: failed to parse tag response: %s", err) } var errResponse errorResponse if err := json.Unmarshal(tagResponseBody, &errResponse); err != nil { return fmt.Errorf("karakeep: unable to parse tag error response: status=%d body=%s", tagResponse.StatusCode, string(tagResponseBody)) } return fmt.Errorf("karakeep: failed to attach tags: status=%d errorcode=%s %s", tagResponse.StatusCode, errResponse.Code, errResponse.Error) } return nil } func (c *Client) SaveURL(entryURL string) error { requestBody, err := json.Marshal(&saveURLPayload{ Type: "link", URL: entryURL, }) if err != nil { return fmt.Errorf("karakeep: unable to encode request body: %v", err) } req, err := http.NewRequest(http.MethodPost, c.apiEndpoint, bytes.NewReader(requestBody)) if err != nil { return fmt.Errorf("karakeep: unable to create request: %v", err) } req.Header.Set("Authorization", "Bearer "+c.apiToken) req.Header.Set("Content-Type", "application/json") req.Header.Set("User-Agent", "Miniflux/"+version.Version) resp, err := c.wrapped.Do(req) if err != nil { return fmt.Errorf("karakeep: unable to send request: %v", err) } defer resp.Body.Close() responseBody, err := io.ReadAll(resp.Body) if err != nil { return fmt.Errorf("karakeep: failed to parse response: %s", err) } if resp.Header.Get("Content-Type") != "application/json" { return fmt.Errorf("karakeep: unexpected content type response: %s", resp.Header.Get("Content-Type")) } if resp.StatusCode != http.StatusCreated { var errResponse errorResponse if err := json.Unmarshal(responseBody, &errResponse); err != nil { return fmt.Errorf("karakeep: unable to parse error response: status=%d body=%s", resp.StatusCode, string(responseBody)) } return fmt.Errorf("karakeep: failed to save URL: status=%d errorcode=%s %s", resp.StatusCode, errResponse.Code, errResponse.Error) } var response saveURLResponse if err := json.Unmarshal(responseBody, &response); err != nil { return fmt.Errorf("karakeep: unable to parse response: %v", err) } if response.ID == "" { return fmt.Errorf("karakeep: unable to get ID from response") } if err := c.attachTags(response.ID); err != nil { return fmt.Errorf("karakeep: unable to attach tags: %v", err) } return nil }