Skip to content

armgit / memos

Public Imported from GitHub
0

Memos is an open-source, self-hosted note-taking app that brings your everyday thoughts together in a personal timeline. Your data stays yours, and you choose what to keep private or share.

2.4 KB
Raw Blame
package api

import (
	"context"
	"strings"

	"google.golang.org/grpc/codes"
	"google.golang.org/grpc/status"

	"github.com/usememos/memos/internal/linkmeta"
	"github.com/usememos/memos/internal/ratelimit"
	apipb "github.com/usememos/memos/proto/gen/api"
)

type linkMetadataFetcher interface {
	Get(context.Context, string) (*linkmeta.HTMLMeta, error)
}

// GetLinkMetadata gets metadata for a link.
func (s *APIService) GetLinkMetadata(ctx context.Context, request *apipb.GetLinkMetadataRequest) (*apipb.LinkMetadata, error) {
	if err := s.throttleLinkMetadata(ctx, 1); err != nil {
		return nil, err
	}
	return s.buildLinkMetadata(ctx, request.GetUrl())
}

// throttleLinkMetadata bounds outbound fetches per caller. Cached results
// still cost, since the point is to bound how often a caller can ask.
func (s *APIService) throttleLinkMetadata(ctx context.Context, urls int) error {
	_, key := callerBudget(ctx)
	return s.throttleAndCharge(ratelimit.ScopeLinkMetadata, key, urls)
}

// BatchGetLinkMetadata gets metadata for links.
func (s *APIService) BatchGetLinkMetadata(ctx context.Context, request *apipb.BatchGetLinkMetadataRequest) (*apipb.BatchGetLinkMetadataResponse, error) {
	if len(request.Urls) == 0 {
		return nil, status.Errorf(codes.InvalidArgument, "urls are required")
	}
	if len(request.Urls) > maxBatchGetLinkMetadata {
		return nil, status.Errorf(codes.InvalidArgument, "too many urls (max %d)", maxBatchGetLinkMetadata)
	}
	if err := s.throttleLinkMetadata(ctx, len(request.Urls)); err != nil {
		return nil, err
	}
	s.chargeBatch(ctx, len(request.Urls))

	linkMetadata := make([]*apipb.LinkMetadata, 0, len(request.Urls))
	for _, url := range request.Urls {
		metadata, err := s.buildLinkMetadata(ctx, url)
		if err != nil {
			return nil, err
		}
		linkMetadata = append(linkMetadata, metadata)
	}

	return &apipb.BatchGetLinkMetadataResponse{
		LinkMetadata: linkMetadata,
	}, nil
}

func (s *APIService) buildLinkMetadata(ctx context.Context, inputURL string) (*apipb.LinkMetadata, error) {
	url := strings.TrimSpace(inputURL)
	if url == "" {
		return nil, status.Errorf(codes.InvalidArgument, "url is required")
	}
	htmlMeta, err := s.linkMetadataFetcher.Get(ctx, url)
	if err != nil {
		return nil, status.Errorf(codes.InvalidArgument, "failed to fetch link metadata: %v", err)
	}

	return &apipb.LinkMetadata{
		Url:         inputURL,
		Title:       htmlMeta.Title,
		Description: htmlMeta.Description,
		Image:       htmlMeta.Image,
	}, nil
}