add web service

internal/memos/client.go

@@ -0,0 +1,80 @@
+package memos
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"net/url"
+	"strconv"
+)
+
+type Client struct {
+	baseURL    string
+	token      string
+	httpClient *http.Client
+}
+
+func NewClient(baseURL, token string) *Client {
+	return &Client{
+		baseURL:    baseURL,
+		token:      token,
+		httpClient: &http.Client{},
+	}
+}
+
+// ListMemos fetches memos from the API with the given CEL filter.
+func (c *Client) ListMemos(ctx context.Context, filter string, pageSize int, pageToken string) (*ListMemosResponse, error) {
+	u, err := url.Parse(c.baseURL + "/api/v1/memos")
+	if err != nil {
+		return nil, fmt.Errorf("parse url: %w", err)
+	}
+
+	q := u.Query()
+	if filter != "" {
+		q.Set("filter", filter)
+	}
+	if pageSize > 0 {
+		q.Set("pageSize", strconv.Itoa(pageSize))
+	}
+	if pageToken != "" {
+		q.Set("pageToken", pageToken)
+	}
+	u.RawQuery = q.Encode()
+
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, u.String(), nil)
+	if err != nil {
+		return nil, fmt.Errorf("create request: %w", err)
+	}
+	req.Header.Set("Authorization", "Bearer "+c.token)
+
+	resp, err := c.httpClient.Do(req)
+	if err != nil {
+		return nil, fmt.Errorf("do request: %w", err)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		body, _ := io.ReadAll(resp.Body)
+		return nil, fmt.Errorf("memos API returned %d: %s", resp.StatusCode, body)
+	}
+
+	var result ListMemosResponse
+	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
+		return nil, fmt.Errorf("decode response: %w", err)
+	}
+	return &result, nil
+}
+
+// GetRandomMemo fetches a single memo without any filter (for full fallback).
+func (c *Client) GetRandomMemo(ctx context.Context) (*Memo, error) {
+	resp, err := c.ListMemos(ctx, "", 1, "")
+	if err != nil {
+		return nil, err
+	}
+	if len(resp.Memos) == 0 {
+		return nil, nil
+	}
+	return resp.Memos[0], nil
+}

internal/memos/types.go

@@ -0,0 +1,32 @@
+package memos
+
+import "time"
+
+// Memo represents a memo from the Memos API.
+// JSON field names follow protojson camelCase convention.
+type Memo struct {
+	Name        string    `json:"name"`
+	State       string    `json:"state"`
+	Creator     string    `json:"creator"`
+	CreateTime  time.Time `json:"createTime"`
+	UpdateTime  time.Time `json:"updateTime"`
+	DisplayTime time.Time `json:"displayTime"`
+	Content     string    `json:"content"`
+	Visibility  string    `json:"visibility"`
+	Tags        []string  `json:"tags"`
+	Pinned      bool      `json:"pinned"`
+	Snippet     string    `json:"snippet"`
+}
+
+// ListMemosResponse is the response from GET /api/v1/memos.
+type ListMemosResponse struct {
+	Memos         []*Memo `json:"memos"`
+	NextPageToken string  `json:"nextPageToken"`
+}
+
+func (r *ListMemosResponse) GetMemos() []*Memo {
+	if r == nil {
+		return nil
+	}
+	return r.Memos
+}